@superbee/core 0.2.0-pre.4 → 0.2.0-pre.40

package/dist/source-engine/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/source-engine/snapshot.ts"],"names":[],"mappings":"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"}

package/dist/source-engine/types.d.ts

@@ -0,0 +1,292 @@
+/** Types of `@superbee/core/source-engine`. */
+import type { BoundFeed, Connector, MappingDiagnostic } from "../connectors.js";
+import type { Finding, RecordChange } from "../record-overlay/types.js";
+import type { ConceptId } from "../types.js";
+import type { MachineState } from "./machine-state.js";
+import type { FetchIdentity } from "./robots.js";
+export type HttpMethod = "GET" | "POST";
+/** One record as a profile normalizes it: a JSON object the connector's mapping reads by dotted path. */
+export type NormalizedRecord = Readonly<Record<string, unknown>>;
+export type SpecResult<Spec> = {
+    ok: true;
+    spec: Spec;
+} | {
+    ok: false;
+    errors: Array<{
+        path: string;
+        message: string;
+    }>;
+};
+/** What the engine asks a transport for. A transport never follows a redirect itself. */
+export interface TransportRequest {
+    url: string;
+    method: HttpMethod;
+    headers: Readonly<Record<string, string>>;
+    body?: string;
+    /** The most response body bytes to read; a longer body is refused, never truncated. */
+    maxBytes: number;
+    /**
+     * The engine's own decision that `url` names one of the auth kind's credential hosts. A
+     * transport sends its credential only when this is true and its own exact host match agrees.
+     */
+    credentialHost: boolean;
+    /** Aborts the request: the run's deadline, or the per-request timeout. */
+    signal?: AbortSignal;
+}
+/**
+ * A response with lowercase header names and the body bytes read, or the refusal of a body over
+ * `maxBytes`. A network failure rejects.
+ */
+export type TransportResult = {
+    ok: true;
+    status: number;
+    headers: Readonly<Record<string, string>>;
+    body: string;
+    bytes: number;
+} | {
+    ok: false;
+    refused: "too_large";
+};
+/**
+ * The one network port. A credential-injecting transport adds a credential only toward the
+ * connector's credential hosts over https, decided per URL, and never forwards it to another host;
+ * `@superbee/core/source-harness` holds the conformance suite every transport passes.
+ */
+export interface Transport {
+    request(input: TransportRequest): Promise<TransportResult>;
+}
+/** A request as a profile makes it, through the engine's guarded transport. */
+export interface ProfileRequest {
+    url: string;
+    method?: HttpMethod;
+    headers?: Readonly<Record<string, string>>;
+    body?: string;
+    maxBytes?: number;
+}
+/** A success (2xx), or in incremental mode a not-modified (304) answer; `url` is the final URL after redirects. */
+export interface ProfileResponse {
+    status: number;
+    headers: Readonly<Record<string, string>>;
+    body: string;
+    url: string;
+}
+/**
+ * The transport a profile sees. Every other answer, and every refused request, stops the run: the
+ * call throws and the engine discards the page, whatever the profile does with the error.
+ */
+export interface ProfileTransport {
+    request(input: ProfileRequest): Promise<ProfileResponse>;
+}
+export interface ProfileDiagnostic {
+    code: string;
+    message: string;
+    count?: number;
+}
+export interface ObserveContext<Spec, Cursor> {
+    spec: Spec;
+    bound: BoundFeed;
+    /** The cursor the last committed page returned; null at the start of a pass. */
+    cursor: Cursor | null;
+    /** True on the first page of a run that continues a pass an earlier run left open. */
+    resumed: boolean;
+    mode: "incremental" | "complete";
+    transport: ProfileTransport;
+    /** Requests left in this run, and the byte bound per response. */
+    budget: {
+        requests: number;
+        maxBytes: number;
+    };
+    now: Date;
+    /** Validators the last committed page stored; always null in complete mode. */
+    validators: Readonly<Record<string, string>> | null;
+}
+/** One page of a pass. */
+export interface ObservePage<Cursor> {
+    records: readonly NormalizedRecord[];
+    /** Stored once this page commits; the next page or run receives it. JSON data. */
+    nextCursor: Cursor | null;
+    /** Another page of this pass follows. */
+    more: boolean;
+    /** With `more: false`, the profile's claim that the pass listed every record of the resource. */
+    complete: boolean;
+    diagnostics?: readonly ProfileDiagnostic[];
+    validators?: Readonly<Record<string, string>>;
+}
+/**
+ * A versioned, named module that turns a bound Source Feed, a cursor and a transport into pages of
+ * normalized records. It never opens a socket, never sees a credential, never names a Kind field
+ * and never writes.
+ */
+export interface SourceProfile<Spec = unknown, Cursor = unknown> {
+    readonly id: string;
+    readonly version: number;
+    readonly kind: "generic" | "extension";
+    /** Profile semantics only. */
+    validateSpec(spec: unknown): SpecResult<Spec>;
+    /** Every host a run may touch. */
+    hostsFor(spec: Spec, bound: BoundFeed): readonly string[];
+    observe(ctx: ObserveContext<Spec, Cursor>): Promise<ObservePage<Cursor>>;
+}
+/**
+ * Per-request hooks a declaration's provider rules feed. The engine's own rules hold whatever a
+ * hook says: `authorization`, `cookie`, `proxy-authorization`, `host`, `user-agent` and the
+ * method-override headers are never sent, and a POST is refused unless `post` admits it.
+ */
+export interface RequestRules {
+    /** The guard inspects a response before a profile receives it. */
+    response?(response: ProfileResponse): void;
+    /**
+     * A lowercase header name beyond `accept` toward `url`. The validators `if-none-match` and
+     * `if-modified-since` are the engine's: sent in incremental mode, never in complete mode.
+     */
+    header?(name: string, url: URL): boolean;
+    /** A POST toward `url` with `body`; absent, every POST is refused. */
+    post?(url: URL, body: string | undefined): boolean;
+    /** Every URL after the host guard admits it: the first request and each redirect hop. */
+    url?(url: URL, hop: {
+        method: HttpMethod;
+        redirect: boolean;
+    }): boolean;
+}
+/** Status sets: the declaration's `errors` rows. Any other status outside 2xx and 304 is `provider_unavailable`. */
+export interface StatusRules {
+    deferred: readonly number[];
+    credential_refused: readonly number[];
+    not_found: readonly number[];
+}
+export interface SourceBudget {
+    /** Transport calls per run, robots.txt reads and redirect hops included. */
+    requests: number;
+    /** Response body bytes per request. */
+    maxBytes: number;
+    /** Redirects followed per request. */
+    redirects: number;
+    /** Pages committed per run. */
+    pages: number;
+    /** The run's deadline when the caller passes no `signal`; with one, the caller owns the run's time. */
+    deadlineMs: number;
+    /** Each request's timeout, with or without the caller's `signal`. */
+    requestTimeoutMs: number;
+}
+export type SourceOutcome = 
+/** The pass reached its end in this run. */
+"observed"
+/** Stopped with work left (rate limit, budget, deadline); committed pages stay. */
+ | "deferred"
+/** The credential was refused; a retry needs a changed credential. */
+ | "credential_refused"
+/** A server error or a transport failure. */
+ | "provider_unavailable" | "not_found" | "unsupported_content" | "too_large"
+/** A guard refused the run or a request before it was sent. */
+ | "refused"
+/** The profile, the state store or the caller's commit failed. */
+ | "failed";
+export interface SourceRequestRow {
+    method: HttpMethod;
+    /** Redacted. */
+    url: string;
+    purpose: "page" | "robots";
+    status?: number;
+    /** A guard refusal (nothing was sent) or the transport's `too_large`. */
+    refused?: string;
+}
+/** What the caller writes for one page: the record-overlay changes, and whether the pass ended complete. */
+export interface PageCommit {
+    feed: ConceptId;
+    provider: string;
+    observed_at: string;
+    /** 1-based within the run; 0 for the replay of pending changes before the first request. */
+    page: number;
+    /** The changes were held by an earlier commit and are planned again. */
+    replay: boolean;
+    changes: readonly RecordChange[];
+    /** The record values the changes name, for titles. */
+    records: Readonly<Record<string, {
+        fields: Record<string, unknown>;
+    }>>;
+    /** No state was stored for this feed before this run. */
+    baseline: boolean;
+    /** This page ended a complete observation; disappearances are among the changes. */
+    complete: boolean;
+}
+/**
+ * External ids of changes the commit did not write. Either way the record's stored entry stays
+ * where it was. A `retry` change (a lost compare-and-swap, a claimed Signal) is kept pending in the
+ * machine state and planned again at the start of every run until it is written, refused for
+ * good, or superseded by a newer observation of the record. A `hold` change is not pending: the
+ * record is planned again when it is next observed.
+ */
+export interface CommitResult {
+    hold?: readonly string[];
+    retry?: readonly string[];
+}
+export interface SourceRunReceipt {
+    feed: ConceptId;
+    provider: string;
+    source: string;
+    profile: {
+        id: string;
+        version: number;
+    };
+    mode: "incremental" | "complete";
+    observed_at: string;
+    outcome: SourceOutcome;
+    reason?: string;
+    detail?: string;
+    status?: number;
+    /** Whether the same run may succeed later without a change to the credential or declaration. */
+    retry: boolean;
+    retry_after?: string;
+    /** Pages committed in this run. */
+    pages: number;
+    /** Changes this run's commits did not write (`hold` and `retry`), replays included. */
+    held: number;
+    /** Changes pending when the run ended. */
+    pending: number;
+    requests: SourceRequestRow[];
+    pass: {
+        resumed: boolean;
+        ended: boolean;
+        complete: boolean;
+    };
+    changes: {
+        new: number;
+        changed: number;
+        disappeared: number;
+    };
+    /** The cursor stored when the run ended. */
+    cursor: unknown;
+    cursor_reset?: "profile_version";
+    diagnostics: MappingDiagnostic[];
+    profile_diagnostics: ProfileDiagnostic[];
+    findings: Finding[];
+}
+export interface ObserveSourceOptions<Spec = unknown, Cursor = unknown> {
+    /** The declaration's credential kind and keyless domains: the only hosts a run may reach. */
+    connector: Pick<Connector, "auth" | "domains">;
+    bound: BoundFeed;
+    profile: SourceProfile<Spec, Cursor>;
+    spec: unknown;
+    transport: Transport;
+    state: MachineState;
+    identity: FetchIdentity;
+    mode?: "incremental" | "complete";
+    budget?: Partial<SourceBudget>;
+    /**
+     * The run's deadline: once aborted, no request starts, the one in flight and the profile's page
+     * are abandoned, and the run ends `deferred`. Without one the budget's `deadlineMs` applies. A
+     * commit or state write in progress is never abandoned, so a hung one holds the run.
+     */
+    signal?: AbortSignal;
+    now?: () => Date;
+    /** Explicit admission by the trusted embedding host for a new bound GET policy; absent denies. */
+    readPolicyApproval?: {
+        contract: 1;
+        digest: string;
+    };
+    rules?: RequestRules;
+    statuses?: Partial<StatusRules>;
+    /** Write one page's changes; the cursor and record state are stored only after this resolves. */
+    commit(page: PageCommit): Promise<CommitResult | void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/source-engine/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/source-engine/types.ts"],"names":[],"mappings":"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"}

package/dist/source-engine/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/source-engine/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/source-engine/types.ts"],"names":[],"mappings":""}

package/dist/source-harness/conformance.d.ts

@@ -0,0 +1,16 @@
+import type { Transport } from "../source-engine/types.js";
+import { ScriptedPeer, type TransportCredential } from "./peer.js";
+export interface TransportConformanceTarget {
+    name: string;
+    /** The transport under test, delivering its requests to `peer` and holding `credential`. */
+    create(peer: ScriptedPeer, credential: TransportCredential): Transport;
+}
+export interface ConformanceRow {
+    scenario: string;
+    ok: boolean;
+    detail?: string;
+}
+export declare const CONFORMANCE_SCENARIOS: readonly ["credential-reaches-its-host", "credential-stays-on-its-host", "redirect-returned-unfollowed", "cross-host-redirect-refused", "body-over-bound-refused", "private-redirect-refused"];
+/** Run every conformance scenario against one transport. */
+export declare function runTransportConformance(target: TransportConformanceTarget): Promise<ConformanceRow[]>;
+//# sourceMappingURL=conformance.d.ts.map

package/dist/source-harness/conformance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conformance.d.ts","sourceRoot":"","sources":["../../src/source-harness/conformance.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAmC,SAAS,EAAmB,MAAM,2BAA2B,CAAC;AAC7G,OAAO,EAAE,YAAY,EAAuC,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAExG,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,4FAA4F;IAC5F,MAAM,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,mBAAmB,GAAG,SAAS,CAAC;CACxE;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,qBAAqB,gMAOvB,CAAC;AAsOZ,4DAA4D;AAC5D,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,0BAA0B,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAW3G"}

package/dist/source-harness/conformance.js

@@ -0,0 +1,266 @@
+/**
+ * The transport conformance suite. The engine's guard cannot see headers a transport adds after
+ * it, so every transport proves against a scripted peer that it sends the credential only when the
+ * engine's `credentialHost` and its own exact host match agree (lookalike hosts included), returns
+ * redirects unfollowed and refuses a body over the bound, and, behind the engine, that a
+ * cross-host or private-address redirect reaches nothing. It returns rows rather than asserting,
+ * so it runs under any test runner.
+ */
+import { bindSourceFeed, credentialHosts, parseConnectorDoc } from "../connectors.js";
+import { buildKindRegistry } from "../kinds.js";
+import { MemoryMachineState } from "../source-engine/machine-state.js";
+import { observeSource } from "../source-engine/observe.js";
+import { fetchIdentity } from "../source-engine/robots.js";
+import { ScriptedPeer } from "./peer.js";
+export const CONFORMANCE_SCENARIOS = Object.freeze([
+    "credential-reaches-its-host",
+    "credential-stays-on-its-host",
+    "redirect-returned-unfollowed",
+    "cross-host-redirect-refused",
+    "body-over-bound-refused",
+    "private-redirect-refused",
+]);
+const CREDENTIAL_HOST = "api.github.com";
+const KEYLESS_HOST = "feeds.example.org";
+const OUTSIDE_HOST = "collector.example.net";
+const PROBE = "conformance-probe";
+const IDENTITY = fetchIdentity("SuperbeeConformance/1 (+https://superbee.example.org/conformance)");
+const PRIVATE_TARGETS = Object.freeze([
+    "https://127.0.0.1/latest",
+    "https://10.0.0.5/internal",
+    "https://[::1]/x",
+    "https://[::ffff:127.0.0.1]/x",
+    "https://169.254.169.254/latest/meta-data/",
+    "https://metadata.google.internal/computeMetadata/v1/",
+    "https://localhost/x",
+    "https://api.github.com:8443/x",
+    "http://api.github.com/x",
+]);
+/**
+ * Requests that must never carry the credential: hosts that only look like the credential host,
+ * whatever the engine says, and the credential host itself when the engine says it is not one.
+ */
+const CREDENTIAL_PROBES = Object.freeze([
+    { name: "a declared keyless host", url: `https://${KEYLESS_HOST}/feed.json`, credentialHost: true },
+    { name: "an undeclared host", url: `https://${OUTSIDE_HOST}/collect`, credentialHost: true },
+    { name: "the credential host over http", url: `http://${CREDENTIAL_HOST}/repos/octo/probe/issues`, credentialHost: true },
+    { name: "a host starting with the credential host", url: `https://${CREDENTIAL_HOST}.${OUTSIDE_HOST}/x`, credentialHost: true },
+    { name: "a host ending with the credential host without a dot", url: `https://evil${CREDENTIAL_HOST}/repos/octo/probe/issues`, credentialHost: true },
+    { name: "the credential host with a trailing dot", url: `https://${CREDENTIAL_HOST}./x`, credentialHost: true },
+    { name: "the credential host as userinfo", url: `https://${CREDENTIAL_HOST}@${OUTSIDE_HOST}/x`, credentialHost: true },
+    { name: "the credential host on another port", url: `https://${CREDENTIAL_HOST}:8443/x`, credentialHost: true },
+    { name: "the credential host when the engine says otherwise", url: `https://${CREDENTIAL_HOST}/repos/octo/probe/issues`, credentialHost: false },
+]);
+const record = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+/** Requests the probe profile makes: one GET of `spec.url`, its host and `spec.also` declared. */
+const probe = {
+    id: PROBE,
+    version: 1,
+    kind: "generic",
+    validateSpec(spec) {
+        if (!record(spec) || typeof spec.url !== "string")
+            return { ok: false, errors: [{ path: "/url", message: "is a URL" }] };
+        const also = Array.isArray(spec.also) ? spec.also.filter((host) => typeof host === "string") : [];
+        return { ok: true, spec: { url: spec.url, also } };
+    },
+    hostsFor: (spec) => [new URL(spec.url).hostname, ...spec.also],
+    async observe({ spec, transport }) {
+        await transport.request({ url: spec.url, headers: { accept: "application/json" } });
+        return { records: [], nextCursor: null, more: false, complete: false };
+    },
+};
+let world;
+function probeWorld() {
+    if (world)
+        return world;
+    const registry = buildKindRegistry([{ id: "conventions/probe", body: "", frontmatter: { type: "Convention", title: "Probe", governs: "Probe", fields: { required: ["title"] } } }], [], { okfVersion: "0.2" });
+    const parsed = parseConnectorDoc({ id: "connectors/conformance", body: "", frontmatter: {
+            type: "Connector", title: "Transport conformance probe", auth: { kind: "token", provider: "github" }, domains: [KEYLESS_HOST],
+            record_sources: [{ name: "probe", profile: PROBE, request: { host: CREDENTIAL_HOST, method: "GET", path: "/repos/{owner}/{repo}/issues", items: "" }, target_kind: "Probe", identity: { resource: `https://${CREDENTIAL_HOST}/repos/{owner}/{repo}`, id: "{id}" }, fields: { title: "title" }, completeness: "complete" }],
+        } }, { kinds: registry });
+    if (!parsed.ok)
+        throw new Error(`conformance connector refused: ${parsed.errors.map((e) => e.code).join(", ")}`);
+    const bound = bindSourceFeed(parsed.connector, { id: "source-feeds/conformance", frontmatter: {
+            type: "Source Feed", connector: parsed.connector.id, source: "probe", url: `https://${CREDENTIAL_HOST}/repos/octo/probe`, owned_fields: ["title"],
+        } }, registry, { okfVersion: "0.2" });
+    return (world = { connector: parsed.connector, bound });
+}
+const CREDENTIALS = () => [
+    { hosts: credentialHosts({ kind: "token", provider: "github" }), header: "authorization", value: "Bearer conformance-secret-1" },
+    // A provider's own header (Vagaro's `accessToken`), so a check on `authorization` alone cannot pass.
+    { hosts: credentialHosts({ kind: "token", provider: "github" }), header: "accessToken", value: "conformance-secret-2" },
+];
+/**
+ * Whether a request carries the credential anywhere: a header, the URL (decoded, so an encoded
+ * copy counts) or the body. The secret is the value's last word, so `Bearer x` is found as `x`.
+ */
+function carries(request, credential) {
+    const secret = credential.value.split(/\s+/).at(-1);
+    let url = request.url;
+    try {
+        url = decodeURIComponent(request.url.replaceAll("+", " "));
+    }
+    catch { /* keep the raw URL */ }
+    return [...Object.values(request.headers), url, request.url, request.body ?? ""].some((text) => text.includes(secret));
+}
+/** Every request that carried the credential's value toward a host it does not belong to. */
+function leaks(peer, credential) {
+    return peer.received.filter((request) => {
+        const url = new URL(request.url);
+        const allowed = url.protocol === "https:" && credential.hosts.includes(url.hostname);
+        return !allowed && carries(request, credential);
+    }).map((request) => `${request.method} ${request.url}`);
+}
+const answer = (routes) => (request) => {
+    const url = new URL(request.url);
+    if (url.pathname === "/robots.txt")
+        return { status: 404, body: "" };
+    return routes[`${url.origin}${url.pathname}`] ?? { status: 404, body: "" };
+};
+async function throughEngine(target, credential, routes, spec, maxBytes) {
+    const { connector, bound } = probeWorld();
+    const scopedBound = { ...bound, source: { ...bound.source, request: { ...bound.source.request, host: new URL(spec.url).hostname } } };
+    const peer = new ScriptedPeer(answer(routes));
+    const receipt = await observeSource({
+        connector, bound: scopedBound, profile: probe, spec, transport: target.create(peer, credential), state: new MemoryMachineState(), identity: IDENTITY,
+        mode: "complete", budget: { requests: 20, ...(maxBytes !== undefined ? { maxBytes } : {}) }, commit: async () => { },
+    });
+    return { receipt, peer };
+}
+async function direct(transport, url, options = {}) {
+    try {
+        return await transport.request({ url, method: "GET", headers: { accept: "application/json" }, maxBytes: options.maxBytes ?? 4096, credentialHost: options.credentialHost ?? false });
+    }
+    catch (error) {
+        return error instanceof Error ? error : new Error(String(error));
+    }
+}
+const CHECKS = {
+    async "credential-reaches-its-host"(target) {
+        const problems = [];
+        for (const credential of CREDENTIALS()) {
+            const peer = new ScriptedPeer(() => ({ status: 200, body: "[]" }));
+            await direct(target.create(peer, credential), `https://${CREDENTIAL_HOST}/repos/octo/probe/issues`, { credentialHost: true });
+            const sent = peer.received[0]?.headers[credential.header.toLowerCase()];
+            if (sent !== credential.value)
+                problems.push(`the ${credential.header} credential did not reach ${CREDENTIAL_HOST}`);
+            const { peer: engine } = await throughEngine(target, credential, { [`https://${CREDENTIAL_HOST}/repos/octo/probe/issues`]: { status: 200, body: "{}" } }, { url: `https://${CREDENTIAL_HOST}/repos/octo/probe/issues` });
+            if (engine.received[0]?.headers[credential.header.toLowerCase()] !== credential.value)
+                problems.push(`behind the engine the ${credential.header} credential did not reach ${CREDENTIAL_HOST}`);
+        }
+        return problems;
+    },
+    async "credential-stays-on-its-host"(target) {
+        const problems = [];
+        for (const credential of CREDENTIALS()) {
+            const peer = new ScriptedPeer(() => ({ status: 200, body: "[]" }));
+            const transport = target.create(peer, credential);
+            for (const probe of CREDENTIAL_PROBES) {
+                const before = peer.received.length;
+                await direct(transport, probe.url, { credentialHost: probe.credentialHost });
+                const carried = peer.received.slice(before).filter((request) => carries(request, credential));
+                if (carried.length)
+                    problems.push(`${credential.header} sent toward ${probe.name}`);
+            }
+        }
+        return problems;
+    },
+    async "redirect-returned-unfollowed"(target) {
+        const [credential] = CREDENTIALS();
+        const peer = new ScriptedPeer(answer({
+            [`https://${CREDENTIAL_HOST}/a`]: { status: 302, headers: { Location: `https://${CREDENTIAL_HOST}/b` }, body: "" },
+            [`https://${CREDENTIAL_HOST}/b`]: { status: 200, body: "{}" },
+        }));
+        const result = await direct(target.create(peer, credential), `https://${CREDENTIAL_HOST}/a`, { credentialHost: true });
+        const problems = [];
+        if (result instanceof Error || !result.ok || result.status !== 302)
+            problems.push("the 302 was not returned as the answer");
+        else if (result.headers.location !== `https://${CREDENTIAL_HOST}/b`)
+            problems.push("the 302's location header was not returned under a lowercase name");
+        if (peer.received.length !== 1)
+            problems.push(`the transport sent ${peer.received.length} requests for one call`);
+        return problems;
+    },
+    async "cross-host-redirect-refused"(target) {
+        const problems = [];
+        const cases = [
+            { name: "credential host to an undeclared host", from: `https://${CREDENTIAL_HOST}/repos/octo/probe/issues`, to: `https://${OUTSIDE_HOST}/steal` },
+            { name: "keyless host to an undeclared host", from: `https://${KEYLESS_HOST}/repos/octo/probe/issues`, to: `https://${OUTSIDE_HOST}/steal` },
+            { name: "credential host to a declared keyless host", from: `https://${CREDENTIAL_HOST}/repos/octo/probe/issues`, to: `https://${KEYLESS_HOST}/repos/octo/probe/issues`, also: [KEYLESS_HOST] },
+            { name: "declared keyless host to the credential host", from: `https://${KEYLESS_HOST}/repos/octo/probe/issues`, to: `https://${CREDENTIAL_HOST}/y`, also: [CREDENTIAL_HOST] },
+        ];
+        for (const credential of CREDENTIALS()) {
+            for (const c of cases) {
+                const toHost = new URL(c.to).hostname;
+                const { receipt, peer } = await throughEngine(target, credential, {
+                    [c.from]: { status: 302, headers: { location: c.to }, body: "" },
+                    [c.to]: { status: 200, body: "{}" },
+                }, { url: c.from, ...(c.also ? { also: c.also } : {}) });
+                const reached = peer.received.filter((request) => request.url.startsWith(c.to)).length;
+                if (receipt.outcome !== "refused")
+                    problems.push(`${c.name}: the run ended ${receipt.outcome}, not refused`);
+                if (reached)
+                    problems.push(`${c.name}: ${reached} request(s) reached ${toHost}`);
+                for (const leak of leaks(peer, credential))
+                    problems.push(`${c.name}: ${credential.header} sent with ${leak}`);
+            }
+        }
+        return problems;
+    },
+    async "body-over-bound-refused"(target) {
+        const [credential] = CREDENTIALS();
+        const problems = [];
+        // 600 characters, 1200 bytes: a bound read in characters would pass it.
+        const over = "é".repeat(600);
+        const exact = "a".repeat(1000);
+        const peer = new ScriptedPeer(answer({
+            [`https://${CREDENTIAL_HOST}/repos/octo/probe/issues`]: { status: 200, body: over },
+            [`https://${CREDENTIAL_HOST}/exact`]: { status: 200, body: exact },
+        }));
+        const transport = target.create(peer, credential);
+        const refused = await direct(transport, `https://${CREDENTIAL_HOST}/repos/octo/probe/issues`, { maxBytes: 1000, credentialHost: true });
+        if (refused instanceof Error || refused.ok || refused.refused !== "too_large")
+            problems.push("a 1200-byte body under a 1000-byte bound was not refused as too_large");
+        const admitted = await direct(transport, `https://${CREDENTIAL_HOST}/exact`, { maxBytes: 1000, credentialHost: true });
+        if (admitted instanceof Error || !admitted.ok || admitted.body !== exact || admitted.bytes !== 1000)
+            problems.push("a body exactly at the bound was not returned whole");
+        const { receipt } = await throughEngine(target, credential, { [`https://${CREDENTIAL_HOST}/repos/octo/probe/issues`]: { status: 200, body: over } }, { url: `https://${CREDENTIAL_HOST}/repos/octo/probe/issues` }, 1000);
+        if (receipt.outcome !== "too_large")
+            problems.push(`behind the engine the run ended ${receipt.outcome}, not too_large`);
+        return problems;
+    },
+    async "private-redirect-refused"(target) {
+        const [credential] = CREDENTIALS();
+        const problems = [];
+        for (const from of [`https://${CREDENTIAL_HOST}/repos/octo/probe/issues`, `https://${KEYLESS_HOST}/repos/octo/probe/issues`]) {
+            for (const to of PRIVATE_TARGETS) {
+                const { receipt, peer } = await throughEngine(target, credential, { [from]: { status: 302, headers: { location: to }, body: "" } }, { url: from });
+                const toUrl = new URL(to);
+                const reached = peer.received.filter((request) => {
+                    const url = new URL(request.url);
+                    return url.hostname === toUrl.hostname && url.port === toUrl.port && url.protocol === toUrl.protocol;
+                }).length;
+                if (receipt.outcome !== "refused")
+                    problems.push(`${from} to ${to}: the run ended ${receipt.outcome}, not refused`);
+                if (reached)
+                    problems.push(`${from} to ${to}: ${reached} request(s) reached it`);
+            }
+        }
+        return problems;
+    },
+};
+/** Run every conformance scenario against one transport. */
+export async function runTransportConformance(target) {
+    const rows = [];
+    for (const scenario of CONFORMANCE_SCENARIOS) {
+        try {
+            const problems = await CHECKS[scenario](target);
+            rows.push(problems.length ? { scenario, ok: false, detail: problems.join("; ") } : { scenario, ok: true });
+        }
+        catch (error) {
+            rows.push({ scenario, ok: false, detail: `threw: ${error instanceof Error ? error.message : String(error)}` });
+        }
+    }
+    return rows;
+}
+//# sourceMappingURL=conformance.js.map