@superbee/core 0.2.0-pre.3 → 0.2.0-pre.30

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

@@ -0,0 +1,95 @@
+/**
+ * The fixture harness: replay a profile's scripted provider answers through the engine, map and
+ * write each committed page through record-overlay over a MemoryBackend bundle, and check each
+ * required scenario's outcome rule. The rules are profile-independent, so one list holds every
+ * profile, generic or extension, to the same behaviour.
+ */
+import { type Connector } from "../connectors.js";
+import type { OverlayReceipt, RecordChange } from "../record-overlay/types.js";
+import { type SourceState } from "../source-engine/machine-state.js";
+import { type FetchIdentity } from "../source-engine/robots.js";
+import type { SourceBudget, SourceProfile, SourceRunReceipt } from "../source-engine/types.js";
+import type { ConceptId, Frontmatter, OkfDocument } from "../types.js";
+import { type PeerRequest, type ScriptedExchange, type TransportCredential } from "./peer.js";
+/** Every profile's fixture includes these; a name may add a variant after a dot (`cursor.resume.page-number`). */
+export declare const REQUIRED_SCENARIOS: readonly ["errors.auth", "errors.rate-limit", "errors.server", "errors.malformed", "page.incomplete", "cursor.resume", "cursor.hostile", "complete.disappear", "fields.owned-conflict", "fields.unmapped", "fields.null", "identity.missing", "hosts.redirect", "hosts.undeclared"];
+export type RequiredScenario = (typeof REQUIRED_SCENARIOS)[number];
+/** The required scenario a name counts toward, or undefined. */
+export declare function scenarioBase(name: string): RequiredScenario | undefined;
+/** Required scenarios no name covers. */
+export declare function missingScenarios(names: Iterable<string>): RequiredScenario[];
+export interface SourceFixture {
+    connector: Connector;
+    profile: SourceProfile<any, any>;
+    spec: unknown;
+    /**
+     * The bundle's starting documents: Conventions for the target Kind, `Signal` and `Source Feed`,
+     * the Source Feed, and any overlay documents.
+     */
+    documents: readonly OkfDocument[];
+    feed: ConceptId;
+    identity?: FetchIdentity;
+    credential?: TransportCredential;
+}
+export interface SourceRunScript {
+    mode?: "incremental" | "complete";
+    /** The run's observation time; runs default to one hour apart. */
+    at?: string;
+    exchanges: readonly ScriptedExchange[];
+    /** Editor edits applied before the run. */
+    edits?: ReadonlyArray<{
+        id: ConceptId;
+        set: Record<string, unknown>;
+    }>;
+    budget?: Partial<SourceBudget>;
+}
+export interface SourceScenario {
+    name: string;
+    /** Replaces the fixture's spec for this scenario. */
+    spec?: unknown;
+    runs: readonly SourceRunScript[];
+}
+export interface ScenarioRun {
+    receipt: SourceRunReceipt;
+    /** Every change a commit carried, replays of pending changes included. */
+    changes: RecordChange[];
+    /** One record-overlay receipt per committed page. */
+    overlay: OverlayReceipt[];
+    /** The run's findings, written. */
+    findings: OverlayReceipt;
+    /** Requests that reached the provider. */
+    received: PeerRequest[];
+    unscripted: string[];
+    unused: ScriptedExchange[];
+    stateBefore: SourceState | null;
+    state: SourceState | null;
+    /** Every document's frontmatter after the run. */
+    documents: Record<string, Frontmatter>;
+}
+export interface ScenarioResult {
+    name: string;
+    base: RequiredScenario | undefined;
+    /** The declared hosts the scenario's spec may reach. */
+    hosts: string[];
+    threshold: number;
+    edits: Array<{
+        run: number;
+        id: ConceptId;
+        set: Record<string, unknown>;
+    }>;
+    runs: ScenarioRun[];
+}
+/** Run one scenario's runs in order over one fresh bundle and one machine state. */
+export declare function runSourceScenario(fixture: SourceFixture, scenario: SourceScenario): Promise<ScenarioResult>;
+/**
+ * The problems with one scenario's result: its required outcome rule, plus for every scenario no
+ * request to a host outside the declared set and no request the fixture did not script.
+ */
+export declare function checkScenario(result: ScenarioResult): string[];
+/** Run every scenario of a fixture, check each, and list the required scenarios it lacks. */
+export declare function runSourceFixture(fixture: SourceFixture, scenarios: readonly SourceScenario[]): Promise<{
+    results: ScenarioResult[];
+    problems: Record<string, string[]>;
+    missing: RequiredScenario[];
+}>;
+//# sourceMappingURL=fixture.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fixture.d.ts","sourceRoot":"","sources":["../../src/source-harness/fixture.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAmD,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAMnG,OAAO,KAAK,EAAiB,cAAc,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC9F,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAEzF,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC/F,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAA+B,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAE3H,kHAAkH;AAClH,eAAO,MAAM,kBAAkB,qRAepB,CAAC;AACZ,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnE,gEAAgE;AAChE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAEvE;AAED,yCAAyC;AACzC,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,gBAAgB,EAAE,CAO5E;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACjC,IAAI,EAAE,OAAO,CAAC;IACd;;;OAGG;IACH,SAAS,EAAE,SAAS,WAAW,EAAE,CAAC;IAClC,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,aAAa,GAAG,UAAU,CAAC;IAClC,kEAAkE;IAClE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACvC,2CAA2C;IAC3C,KAAK,CAAC,EAAE,aAAa,CAAC;QAAE,EAAE,EAAE,SAAS,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IACvE,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,SAAS,eAAe,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,0EAA0E;IAC1E,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,qDAAqD;IACrD,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,mCAAmC;IACnC,QAAQ,EAAE,cAAc,CAAC;IACzB,0CAA0C;IAC1C,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1B,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACnC,wDAAwD;IACxD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,SAAS,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IAC3E,IAAI,EAAE,WAAW,EAAE,CAAC;CACrB;AAkBD,oFAAoF;AACpF,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAqEjH;AAkHD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,EAAE,CAY9D;AAED,6FAA6F;AAC7F,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,cAAc,EAAE,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,cAAc,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAAC,OAAO,EAAE,gBAAgB,EAAE,CAAA;CAAE,CAAC,CAU5M"}

package/dist/source-harness/fixture.js

@@ -0,0 +1,273 @@
+/**
+ * The fixture harness: replay a profile's scripted provider answers through the engine, map and
+ * write each committed page through record-overlay over a MemoryBackend bundle, and check each
+ * required scenario's outcome rule. The rules are profile-independent, so one list holds every
+ * profile, generic or extension, to the same behaviour.
+ */
+import { bindSourceFeed, credentialHosts } from "../connectors.js";
+import { mutateDocument } from "../document-mutation.js";
+import { loadKinds } from "../kinds-load.js";
+import { MemoryBackend } from "../memory-backend.js";
+import { buildSourceIndex } from "../record-overlay/source-index.js";
+import { createSourceOverlayAdapter } from "../source-engine/overlay.js";
+import { MemoryMachineState } from "../source-engine/machine-state.js";
+import { observeSource } from "../source-engine/observe.js";
+import { fetchIdentity } from "../source-engine/robots.js";
+import { ExchangePeer, peerTransport } from "./peer.js";
+/** Every profile's fixture includes these; a name may add a variant after a dot (`cursor.resume.page-number`). */
+export const REQUIRED_SCENARIOS = Object.freeze([
+    "errors.auth",
+    "errors.rate-limit",
+    "errors.server",
+    "errors.malformed",
+    "page.incomplete",
+    "cursor.resume",
+    "cursor.hostile",
+    "complete.disappear",
+    "fields.owned-conflict",
+    "fields.unmapped",
+    "fields.null",
+    "identity.missing",
+    "hosts.redirect",
+    "hosts.undeclared",
+]);
+/** The required scenario a name counts toward, or undefined. */
+export function scenarioBase(name) {
+    return REQUIRED_SCENARIOS.find((base) => name === base || name.startsWith(`${base}.`));
+}
+/** Required scenarios no name covers. */
+export function missingScenarios(names) {
+    const covered = new Set();
+    for (const name of names) {
+        const base = scenarioBase(name);
+        if (base)
+            covered.add(base);
+    }
+    return REQUIRED_SCENARIOS.filter((base) => !covered.has(base));
+}
+const FIXTURE_IDENTITY = fetchIdentity("SuperbeeSourceFixture/1 (+https://superbee.example.org/source-fixture)");
+const SOURCE_ACTOR = "process:source-fixture";
+const EDITOR = "human:fixture-editor";
+const START = Date.parse("2026-01-01T00:00:00.000Z");
+function declaredHosts(fixture, spec, bound) {
+    try {
+        const checked = fixture.profile.validateSpec(spec);
+        if (!checked.ok)
+            return [];
+        const reach = new Set([...credentialHosts(fixture.connector.auth), ...fixture.connector.domains]);
+        return [...new Set(fixture.profile.hostsFor(checked.spec, bound))].filter((host) => reach.has(host)).sort();
+    }
+    catch {
+        return [];
+    }
+}
+/** Run one scenario's runs in order over one fresh bundle and one machine state. */
+export async function runSourceScenario(fixture, scenario) {
+    const backend = new MemoryBackend();
+    await backend.writeReserved("", "index.md", "---\nokf_version: '0.2'\n---\n# Source fixture\n");
+    const bundle = { root: "memory://source-fixture", backend };
+    for (const doc of fixture.documents)
+        await backend.write(doc.id, { id: doc.id, frontmatter: structuredClone(doc.frontmatter), body: doc.body });
+    const registry = await loadKinds(bundle);
+    const overlay = { bundle, registry, okfVersion: "0.2" };
+    const bound = bindSourceFeed(fixture.connector, (await backend.read(fixture.feed)).doc, registry, { okfVersion: "0.2" });
+    const state = new MemoryMachineState();
+    let accepted = { v: 1, entries: [] };
+    const spec = scenario.spec !== undefined ? scenario.spec : fixture.spec;
+    const slug = `${fixture.feed.split("/").pop().replace(/[^a-z0-9-]+/gi, "-").toLowerCase()}-source`;
+    const result = {
+        name: scenario.name, base: scenarioBase(scenario.name), hosts: declaredHosts(fixture, spec, bound),
+        threshold: bound.policy.missing_threshold ?? 2, edits: [], runs: [],
+    };
+    for (const [index, script] of scenario.runs.entries()) {
+        for (const edit of script.edits ?? []) {
+            result.edits.push({ run: index, id: edit.id, set: { ...edit.set } });
+            await mutateDocument({
+                bundle, id: edit.id, mode: "patch", registry, strict: false, actor: EDITOR,
+                buildCandidate: (existing) => ({ frontmatter: { ...existing.frontmatter, ...edit.set }, body: existing.body }),
+            });
+        }
+        const controller = new AbortController();
+        const peer = new ExchangePeer(script.exchanges, { onHang: () => controller.abort() });
+        const at = script.at ?? new Date(START + index * 3_600_000).toISOString();
+        const stateBefore = (await state.read(fixture.feed))?.state ?? null;
+        const changes = [];
+        const overlayReceipts = [];
+        const adapter = createSourceOverlayAdapter({ content: overlay, policy: bound.policy, actor: SOURCE_ACTOR,
+            overlays: await buildSourceIndex(bundle), accepted, slug });
+        if (stateBefore) {
+            await adapter.reconcile(stateBefore, at);
+            accepted = adapter.stagedSnapshot();
+            adapter.consume();
+        }
+        const jointState = {
+            read: state.read.bind(state),
+            async write(key, value, expected) {
+                try {
+                    const version = await state.write(key, value, expected);
+                    accepted = adapter.stagedSnapshot() ?? adapter.snapshot();
+                    adapter.consume();
+                    return version;
+                }
+                catch (error) {
+                    adapter.discard();
+                    throw error;
+                }
+            },
+        };
+        const receipt = await observeSource({
+            connector: fixture.connector, bound, profile: fixture.profile, spec, state: jointState, identity: fixture.identity ?? FIXTURE_IDENTITY,
+            transport: peerTransport(peer, fixture.credential ? { credential: fixture.credential } : {}),
+            mode: script.mode ?? "incremental", signal: controller.signal, now: () => new Date(at),
+            ...(script.budget ? { budget: script.budget } : {}),
+            commit: async (page) => {
+                const applied = await adapter.commit(page);
+                changes.push(...page.changes);
+                overlayReceipts.push(applied.receipt);
+                return applied;
+            },
+        });
+        const findings = await adapter.applyFindings(receipt.findings, at);
+        const documents = {};
+        for (const id of await backend.list())
+            documents[id] = (await backend.read(id)).doc.frontmatter;
+        result.runs.push({
+            receipt, changes, overlay: overlayReceipts, findings, received: [...peer.received], unscripted: [...peer.unscripted], unused: peer.unused(),
+            stateBefore, state: (await state.read(fixture.feed))?.state ?? null, documents,
+        });
+    }
+    return result;
+}
+const json = (value) => JSON.stringify(value ?? null);
+const outcomeFindings = (run) => run.receipt.findings.filter((finding) => finding.key.startsWith("source:"));
+const hasCode = (run, ...codes) => run.receipt.diagnostics.some((d) => codes.includes(d.code));
+const writesNothing = (run) => run.receipt.pages === 0 && run.changes.length === 0;
+const cursorKept = (run) => json(run.state?.cursor) === json(run.stateBefore?.cursor);
+const hostOf = (url) => {
+    try {
+        return new URL(url).hostname;
+    }
+    catch {
+        return undefined;
+    }
+};
+const reachedHost = (run, url) => run.received.some((request) => hostOf(request.url) === hostOf(url));
+/** At least one run satisfies `predicate`, or the scenario fails with `missing`. */
+function some(result, missing, predicate) {
+    return result.runs.some(predicate) ? [] : [missing];
+}
+const CHECKS = {
+    "errors.auth": (r) => some(r, "no run ends credential_refused with nothing written, no retry, the cursor kept and one finding", (run) => run.receipt.outcome === "credential_refused" && !run.receipt.retry && writesNothing(run) && cursorKept(run) && outcomeFindings(run).length === 1),
+    "errors.rate-limit": (r) => some(r, "no run commits a page and then ends deferred on 429 with a Retry-After, the cursor at its last committed page", (run) => run.receipt.outcome === "deferred" && run.receipt.status === 429 && run.receipt.pages >= 1 && run.receipt.retry_after !== undefined
+        && run.state?.open === true && json(run.state.cursor) === json(run.receipt.cursor)),
+    "errors.server": (r) => some(r, "no run ends provider_unavailable on a 5xx with nothing written and one finding", (run) => run.receipt.outcome === "provider_unavailable" && (run.receipt.status ?? 0) >= 500 && writesNothing(run) && outcomeFindings(run).length === 1),
+    "errors.malformed": (r) => [
+        ...some(r, "no run ends unsupported_content with nothing written and one finding", (run) => run.receipt.outcome === "unsupported_content" && writesNothing(run) && outcomeFindings(run).length === 1),
+        ...some(r, "no run ends too_large with nothing written and one finding", (run) => run.receipt.outcome === "too_large" && writesNothing(run) && outcomeFindings(run).length === 1),
+    ],
+    "page.incomplete": (r) => some(r, "no run commits a page, stops before the pass ends and stores the cursor of its last committed page as a partial observation", (run) => run.receipt.pages >= 1 && !run.receipt.pass.ended && !run.receipt.pass.complete && run.receipt.outcome !== "observed"
+        && run.state?.open === true && json(run.state.cursor) === json(run.receipt.cursor) && run.receipt.changes.disappeared === 0),
+    "cursor.resume": (r) => {
+        const resumed = r.runs.map((run, index) => ({ run, index })).filter(({ run, index }) => index > 0 && run.receipt.pass.resumed && r.runs[index - 1].state?.open === true);
+        if (!resumed.length)
+            return ["no run resumes a pass an earlier run left open"];
+        const problems = [];
+        for (const { run, index } of resumed) {
+            if (run.receipt.pass.complete)
+                problems.push(`run ${index + 1} resumed a pass and counted it complete`);
+            const known = run.stateBefore?.records ?? {};
+            for (const change of run.changes) {
+                if (change.change_kind === "new" && Object.hasOwn(known, change.external_id) && !known[change.external_id].gone)
+                    problems.push(`run ${index + 1} reported ${change.external_id} as new after resuming`);
+                if (change.change_kind === "changed" && known[change.external_id]?.digest === change.content_digest)
+                    problems.push(`run ${index + 1} reported an overlap record ${change.external_id} as changed`);
+            }
+        }
+        return problems;
+    },
+    "cursor.hostile": (r) => some(r, "no run refuses a provider-steered request (a host, redirect, address, scheme or url refusal) after a committed page", (run) => run.receipt.pages >= 1 && run.receipt.outcome === "refused"
+        && run.receipt.requests.some((row) => row.purpose === "page" && row.refused !== undefined && /^(host|redirect|address|scheme|url)_/.test(row.refused))),
+    "complete.disappear": (r) => {
+        const problems = [];
+        let disappeared = 0;
+        let completeSeen = false;
+        let partialBetween = false;
+        r.runs.forEach((run, index) => {
+            const before = run.stateBefore?.records ?? {};
+            const after = run.state?.records ?? {};
+            for (const [id, entry] of Object.entries(after)) {
+                const grew = entry.missing - (before[id]?.missing ?? 0);
+                if (!run.receipt.pass.complete && grew > 0)
+                    problems.push(`run ${index + 1} is not complete and counted ${id} missing`);
+                if (grew > 1)
+                    problems.push(`run ${index + 1} counted ${id} missing more than once`);
+            }
+            for (const change of run.changes.filter((c) => c.change_kind === "disappeared")) {
+                disappeared += 1;
+                if (!run.receipt.pass.complete)
+                    problems.push(`run ${index + 1} reported ${change.external_id} disappeared without a complete observation`);
+                if (change.missing_count !== r.threshold)
+                    problems.push(`${change.external_id} disappeared after ${change.missing_count} complete observations, not ${r.threshold}`);
+            }
+            if (run.receipt.pass.complete)
+                completeSeen = true;
+            else if (completeSeen && run.receipt.pages >= 1)
+                partialBetween = true;
+        });
+        if (!disappeared)
+            problems.push("no record disappeared");
+        if (!partialBetween)
+            problems.push("no partial or resumed pass ran between complete observations");
+        return problems;
+    },
+    "fields.owned-conflict": (r) => some(r, "no run refuses an owned field the editor changed, keeps the editor's value and raises a Signal", (run, index) => run.overlay.some((receipt) => receipt.refusals.some((refusal) => refusal.code === "OVERLAY_DOC_CONFLICT" && refusal.target !== undefined && refusal.field !== undefined
+        && r.edits.some((edit) => edit.run <= index && edit.id === refusal.target && Object.hasOwn(edit.set, refusal.field) && json(run.documents[refusal.target]?.[refusal.field]) === json(edit.set[refusal.field])))
+        && receipt.results.some((step) => (step.op === "create-signal" || step.op === "collapse-signal") && step.outcome === "applied"))),
+    "fields.unmapped": (r) => some(r, "no run keeps or refuses a value outside the values table with a mapping finding and no write of that field", (run) => run.receipt.diagnostics.some((d) => (d.code === "VALUE_UNMAPPED" || d.code === "RECORD_REFUSED")
+        && run.receipt.findings.some((f) => f.key.startsWith("mapping:") && f.facts?.code === d.code)
+        && !run.changes.some((c) => c.external_id === d.external_id && c.changed_fields.includes(d.field)))),
+    "fields.null": (r) => [
+        ...some(r, "no committed change removes an optional field the provider sent empty", (run) => run.changes.some((c) => c.before !== null && c.after !== null && Object.keys(c.before).some((field) => !Object.hasOwn(c.after, field) && c.changed_fields.includes(field)))),
+        ...some(r, "no run keeps a required field the provider sent empty (VALUE_MISSING)", (run) => hasCode(run, "VALUE_MISSING")),
+    ],
+    "identity.missing": (r) => some(r, "no run skips a record without an identity and raises a finding", (run) => hasCode(run, "IDENTITY_MISSING") && run.receipt.findings.some((f) => f.key.endsWith(":IDENTITY_MISSING"))),
+    "hosts.redirect": (r) => some(r, "no run refuses a redirect to another host before requesting it", (run) => run.receipt.outcome === "refused" && (run.receipt.reason === "host_refused" || run.receipt.reason === "redirect_refused")
+        && run.receipt.requests.some((row) => row.refused === run.receipt.reason && !reachedHost(run, row.url))),
+    "hosts.undeclared": (r) => some(r, "no run refuses an undeclared host or method with no request to it", (run) => run.receipt.outcome === "refused" && ((run.receipt.reason === "hosts_undeclared" && run.received.length === 0)
+        || (run.receipt.reason === "host_refused" && run.receipt.requests.some((row) => row.refused === "host_refused" && !reachedHost(run, row.url)))
+        || (run.receipt.reason === "method_refused" && run.receipt.requests.some((row) => row.refused === "method_refused" && !run.received.some((request) => request.method === row.method && request.url === row.url))))),
+};
+/**
+ * The problems with one scenario's result: its required outcome rule, plus for every scenario no
+ * request to a host outside the declared set and no request the fixture did not script.
+ */
+export function checkScenario(result) {
+    const problems = [];
+    const allowed = new Set(result.hosts);
+    result.runs.forEach((run, index) => {
+        for (const request of run.received) {
+            const host = new URL(request.url).hostname;
+            if (!allowed.has(host))
+                problems.push(`run ${index + 1} reached undeclared host ${host}`);
+        }
+        for (const request of run.unscripted)
+            problems.push(`run ${index + 1} made an unscripted request: ${request}`);
+    });
+    if (result.base)
+        problems.push(...CHECKS[result.base](result));
+    return problems;
+}
+/** Run every scenario of a fixture, check each, and list the required scenarios it lacks. */
+export async function runSourceFixture(fixture, scenarios) {
+    const results = [];
+    const problems = {};
+    for (const scenario of scenarios) {
+        const result = await runSourceScenario(fixture, scenario);
+        results.push(result);
+        const found = checkScenario(result);
+        if (found.length)
+            problems[scenario.name] = found;
+    }
+    return { results, problems, missing: missingScenarios(scenarios.map((s) => s.name)) };
+}
+//# sourceMappingURL=fixture.js.map

package/dist/source-harness/fixture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture.js","sourceRoot":"","sources":["../../src/source-harness/fixture.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,cAAc,EAAE,eAAe,EAAkC,MAAM,kBAAkB,CAAC;AACnG,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,0BAA0B,EAA8B,MAAM,6BAA6B,CAAC;AAErG,OAAO,EAAE,kBAAkB,EAAoB,MAAM,mCAAmC,CAAC;AACzF,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAsB,MAAM,4BAA4B,CAAC;AAG/E,OAAO,EAAE,YAAY,EAAE,aAAa,EAAqE,MAAM,WAAW,CAAC;AAE3H,kHAAkH;AAClH,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC9C,aAAa;IACb,mBAAmB;IACnB,eAAe;IACf,kBAAkB;IAClB,iBAAiB;IACjB,eAAe;IACf,gBAAgB;IAChB,oBAAoB;IACpB,uBAAuB;IACvB,iBAAiB;IACjB,aAAa;IACb,kBAAkB;IAClB,gBAAgB;IAChB,kBAAkB;CACV,CAAC,CAAC;AAGZ,gEAAgE;AAChE,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC;AACzF,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,gBAAgB,CAAC,KAAuB;IACtD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,IAAI;YAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AACjE,CAAC;AA6DD,MAAM,gBAAgB,GAAG,aAAa,CAAC,wEAAwE,CAAkB,CAAC;AAClI,MAAM,YAAY,GAAG,wBAAwB,CAAC;AAC9C,MAAM,MAAM,GAAG,sBAAsB,CAAC;AACtC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;AAErD,SAAS,aAAa,CAAC,OAAsB,EAAE,IAAa,EAAE,KAAgB;IAC5E,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,OAAO,CAAC,EAAE;YAAE,OAAO,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,eAAe,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QAClG,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9G,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAsB,EAAE,QAAwB;IACtF,MAAM,OAAO,GAAG,IAAI,aAAa,EAAE,CAAC;IACpC,MAAM,OAAO,CAAC,aAAa,CAAC,EAAE,EAAE,UAAU,EAAE,kDAAkD,CAAC,CAAC;IAChG,MAAM,MAAM,GAAG,EAAE,IAAI,EAAE,yBAAyB,EAAE,OAAO,EAAE,CAAC;IAC5D,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,SAAS;QAAE,MAAM,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,WAAW,EAAE,eAAe,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAChJ,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,OAAO,GAAkB,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;IACvE,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;IACzH,MAAM,KAAK,GAAG,IAAI,kBAAkB,EAAE,CAAC;IACvC,IAAI,QAAQ,GAA0B,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC5D,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IACxE,MAAM,IAAI,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAG,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,SAAS,CAAC;IACpG,MAAM,MAAM,GAAmB;QAC7B,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC;QAClG,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,iBAAiB,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE;KACpE,CAAC;IACF,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;QACtD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;YACtC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACrE,MAAM,cAAc,CAAC;gBACnB,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM;gBAC1E,cAAc,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,EAAE,GAAG,QAAS,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,GAAG,EAAiB,EAAE,IAAI,EAAE,QAAS,CAAC,IAAI,EAAE,CAAC;aAChI,CAAC,CAAC;QACL,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACtF,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QAC1E,MAAM,WAAW,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC;QACpE,MAAM,OAAO,GAAmB,EAAE,CAAC;QACnC,MAAM,eAAe,GAAqB,EAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,0BAA0B,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,YAAY;YACtG,QAAQ,EAAE,MAAM,gBAAgB,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9D,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,OAAO,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YACzC,QAAQ,GAAG,OAAO,CAAC,cAAc,EAAG,CAAC;YACrC,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,CAAC;QACD,MAAM,UAAU,GAAG;YACjB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;YAC5B,KAAK,CAAC,KAAK,CAAC,GAAW,EAAE,KAAkB,EAAE,QAAuB;gBAClE,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;oBACxD,QAAQ,GAAG,OAAO,CAAC,cAAc,EAAE,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;oBAC1D,OAAO,CAAC,OAAO,EAAE,CAAC;oBAClB,OAAO,OAAO,CAAC;gBACjB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBAAC,OAAO,CAAC,OAAO,EAAE,CAAC;oBAAC,MAAM,KAAK,CAAC;gBAAC,CAAC;YACrD,CAAC;SACF,CAAC;QACF,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC;YAClC,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,gBAAgB;YACtI,SAAS,EAAE,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5F,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,aAAa,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC;YACtF,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACrB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBAC3C,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC9B,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBACtC,OAAO,OAAO,CAAC;YACjB,CAAC;SACF,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACnE,MAAM,SAAS,GAAgC,EAAE,CAAC;QAClD,KAAK,MAAM,EAAE,IAAI,MAAM,OAAO,CAAC,IAAI,EAAE;YAAE,SAAS,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC;QAChG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;YACf,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE;YAC3I,WAAW,EAAE,KAAK,EAAE,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,IAAI,IAAI,EAAE,SAAS;SAC/E,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,IAAI,GAAG,CAAC,KAAc,EAAU,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;AACvE,MAAM,eAAe,GAAG,CAAC,GAAgB,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;AAC1H,MAAM,OAAO,GAAG,CAAC,GAAgB,EAAE,GAAG,KAAe,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACtH,MAAM,aAAa,GAAG,CAAC,GAAgB,EAAW,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC;AACzG,MAAM,UAAU,GAAG,CAAC,GAAgB,EAAW,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AAC5G,MAAM,MAAM,GAAG,CAAC,GAAW,EAAsB,EAAE;IACjD,IAAI,CAAC;QAAC,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,SAAS,CAAC;IAAC,CAAC;AACnE,CAAC,CAAC;AACF,MAAM,WAAW,GAAG,CAAC,GAAgB,EAAE,GAAW,EAAW,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AAEpI,oFAAoF;AACpF,SAAS,IAAI,CAAC,MAAsB,EAAE,OAAe,EAAE,SAAuD;IAC5G,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,MAAM,GAAmE;IAC7E,aAAa,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,gGAAgG,EAC5H,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,oBAAoB,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,eAAe,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;IAE5J,mBAAmB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,+GAA+G,EACjJ,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,UAAU,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS;WACvI,GAAG,CAAC,KAAK,EAAE,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAEvF,eAAe,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,gFAAgF,EAC9G,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,sBAAsB,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,GAAG,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,eAAe,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;IAEzJ,kBAAkB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;QACzB,GAAG,IAAI,CAAC,CAAC,EAAE,sEAAsE,EAC/E,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,qBAAqB,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,eAAe,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;QACpH,GAAG,IAAI,CAAC,CAAC,EAAE,4DAA4D,EACrE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,WAAW,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,eAAe,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;KAC3G;IAED,iBAAiB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,6HAA6H,EAC7J,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,UAAU;WACzH,GAAG,CAAC,KAAK,EAAE,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,KAAK,CAAC,CAAC;IAEhI,eAAe,EAAE,CAAC,CAAC,EAAE,EAAE;QACrB,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAE,CAAC,KAAK,EAAE,IAAI,KAAK,IAAI,CAAC,CAAC;QAC1K,IAAI,CAAC,OAAO,CAAC,MAAM;YAAE,OAAO,CAAC,gDAAgD,CAAC,CAAC;QAC/E,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,KAAK,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,OAAO,EAAE,CAAC;YACrC,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ;gBAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,KAAK,GAAG,CAAC,yCAAyC,CAAC,CAAC;YACxG,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,OAAO,IAAI,EAAE,CAAC;YAC7C,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;gBACjC,IAAI,MAAM,CAAC,WAAW,KAAK,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAE,CAAC,IAAI;oBAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,KAAK,GAAG,CAAC,aAAa,MAAM,CAAC,WAAW,wBAAwB,CAAC,CAAC;gBACzM,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC,cAAc;oBAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,KAAK,GAAG,CAAC,+BAA+B,MAAM,CAAC,WAAW,aAAa,CAAC,CAAC;YACrM,CAAC;QACH,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,gBAAgB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,qHAAqH,EACpJ,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS;WAC/D,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,KAAK,MAAM,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,sCAAsC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IAE3J,oBAAoB,EAAE,CAAC,CAAC,EAAE,EAAE;QAC1B,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,IAAI,YAAY,GAAG,KAAK,CAAC;QACzB,IAAI,cAAc,GAAG,KAAK,CAAC;QAC3B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;YAC5B,MAAM,MAAM,GAAG,GAAG,CAAC,WAAW,EAAE,OAAO,IAAI,EAAE,CAAC;YAC9C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,EAAE,OAAO,IAAI,EAAE,CAAC;YACvC,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAChD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,OAAO,IAAI,CAAC,CAAC,CAAC;gBACxD,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,GAAG,CAAC;oBAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,KAAK,GAAG,CAAC,gCAAgC,EAAE,UAAU,CAAC,CAAC;gBACxH,IAAI,IAAI,GAAG,CAAC;oBAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,KAAK,GAAG,CAAC,YAAY,EAAE,yBAAyB,CAAC,CAAC;YACvF,CAAC;YACD,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,aAAa,CAAC,EAAE,CAAC;gBAChF,WAAW,IAAI,CAAC,CAAC;gBACjB,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ;oBAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,KAAK,GAAG,CAAC,aAAa,MAAM,CAAC,WAAW,6CAA6C,CAAC,CAAC;gBAC5I,IAAI,MAAM,CAAC,aAAa,KAAK,CAAC,CAAC,SAAS;oBAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,WAAW,sBAAsB,MAAM,CAAC,aAAa,+BAA+B,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;YACvK,CAAC;YACD,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ;gBAAE,YAAY,GAAG,IAAI,CAAC;iBAC9C,IAAI,YAAY,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;gBAAE,cAAc,GAAG,IAAI,CAAC;QACzE,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,WAAW;YAAE,QAAQ,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACzD,IAAI,CAAC,cAAc;YAAE,QAAQ,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;QACnG,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,uBAAuB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,gGAAgG,EACtI,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,sBAAsB,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;WAClL,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,IAAI,KAAK,IAAI,IAAI,CAAC,EAAE,KAAK,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,KAAM,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,MAAO,CAAC,EAAE,CAAC,OAAO,CAAC,KAAM,CAAC,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAM,CAAC,CAAC,CAAC,CAAC;WAChN,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,eAAe,IAAI,IAAI,CAAC,EAAE,KAAK,iBAAiB,CAAC,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC;IAErI,iBAAiB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,4GAA4G,EAC5I,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,gBAAgB,IAAI,CAAC,CAAC,IAAI,KAAK,gBAAgB,CAAC;WACpG,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,IAAK,CAAC,CAAC,KAAuC,EAAE,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC;WAC7H,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAExG,aAAa,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;QACpB,GAAG,IAAI,CAAC,CAAC,EAAE,uEAAuE,EAChF,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACxL,GAAG,IAAI,CAAC,CAAC,EAAE,uEAAuE,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;KAC5H;IAED,kBAAkB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,gEAAgE,EACjG,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,kBAAkB,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAErH,gBAAgB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,gEAAgE,EAC/F,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,cAAc,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,kBAAkB,CAAC;WAC7H,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,KAAK,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAE5G,kBAAkB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,mEAAmE,EACpG,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,CAC5C,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,kBAAkB,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC;WACrE,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,cAAc,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,KAAK,cAAc,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;WAC3I,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,gBAAgB,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,KAAK,gBAAgB,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;CACxN,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,MAAsB;IAClD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QACjC,KAAK,MAAM,OAAO,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;YAC3C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,KAAK,GAAG,CAAC,4BAA4B,IAAI,EAAE,CAAC,CAAC;QAC5F,CAAC;QACD,KAAK,MAAM,OAAO,IAAI,GAAG,CAAC,UAAU;YAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,KAAK,GAAG,CAAC,gCAAgC,OAAO,EAAE,CAAC,CAAC;IACjH,CAAC,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,IAAI;QAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/D,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,6FAA6F;AAC7F,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAsB,EAAE,SAAoC;IACjG,MAAM,OAAO,GAAqB,EAAE,CAAC;IACrC,MAAM,QAAQ,GAA6B,EAAE,CAAC;IAC9C,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC1D,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,KAAK,CAAC,MAAM;YAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IACpD,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;AACxF,CAAC"}

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

@@ -0,0 +1,22 @@
+/**
+ * `@superbee/core/source-harness`: how a profile and a transport prove the source engine's rules
+ * offline.
+ *
+ * {@link runSourceScenario} replays a profile's scripted provider answers through
+ * `observeSource`, writing each committed page through record-overlay over a MemoryBackend
+ * bundle, and {@link checkScenario} holds the result to the required scenario's outcome rule
+ * ({@link REQUIRED_SCENARIOS}). {@link runTransportConformance} is the suite every transport passes
+ * against a scripted peer: the credential only to its host (a custom header included), redirects
+ * returned unfollowed, a body over the bound refused, and behind the engine a cross-host or
+ * private-address redirect that reaches nothing. {@link peerTransport} is a memory transport that
+ * passes it. Results are rows, not assertions, so any test runner can use them.
+ *
+ * Storage-neutral: no Node globals or builtins, and nothing here calls `fetch`.
+ */
+export { ExchangePeer, peerTransport, ScriptedPeer } from "./peer.js";
+export type { PeerRequest, PeerResponse, ScriptedExchange, TransportCredential } from "./peer.js";
+export { CONFORMANCE_SCENARIOS, runTransportConformance } from "./conformance.js";
+export type { ConformanceRow, TransportConformanceTarget } from "./conformance.js";
+export { checkScenario, missingScenarios, REQUIRED_SCENARIOS, runSourceFixture, runSourceScenario, scenarioBase } from "./fixture.js";
+export type { RequiredScenario, ScenarioResult, ScenarioRun, SourceFixture, SourceRunScript, SourceScenario } from "./fixture.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/source-harness/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACtE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAClG,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAClF,YAAY,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AACnF,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACtI,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/source-harness/index.js

@@ -0,0 +1,19 @@
+/**
+ * `@superbee/core/source-harness`: how a profile and a transport prove the source engine's rules
+ * offline.
+ *
+ * {@link runSourceScenario} replays a profile's scripted provider answers through
+ * `observeSource`, writing each committed page through record-overlay over a MemoryBackend
+ * bundle, and {@link checkScenario} holds the result to the required scenario's outcome rule
+ * ({@link REQUIRED_SCENARIOS}). {@link runTransportConformance} is the suite every transport passes
+ * against a scripted peer: the credential only to its host (a custom header included), redirects
+ * returned unfollowed, a body over the bound refused, and behind the engine a cross-host or
+ * private-address redirect that reaches nothing. {@link peerTransport} is a memory transport that
+ * passes it. Results are rows, not assertions, so any test runner can use them.
+ *
+ * Storage-neutral: no Node globals or builtins, and nothing here calls `fetch`.
+ */
+export { ExchangePeer, peerTransport, ScriptedPeer } from "./peer.js";
+export { CONFORMANCE_SCENARIOS, runTransportConformance } from "./conformance.js";
+export { checkScenario, missingScenarios, REQUIRED_SCENARIOS, runSourceFixture, runSourceScenario, scenarioBase } from "./fixture.js";
+//# sourceMappingURL=index.js.map

package/dist/source-harness/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/source-harness/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEtE,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAElF,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

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

@@ -0,0 +1,74 @@
+/**
+ * A scripted provider and the memory transport that reaches it. The peer stands in for the
+ * network: it answers every request from a script and records exactly what arrived, headers
+ * included, so a test can see what a transport sent. The memory transport honours the transport
+ * contract (no redirect following, a refused rather than truncated body over the bound, the
+ * credential only toward its hosts over https), so it passes the conformance suite.
+ */
+import type { HttpMethod, Transport } from "../source-engine/types.js";
+/** A request as it reached the provider. */
+export interface PeerRequest {
+    url: string;
+    method: HttpMethod;
+    headers: Record<string, string>;
+    body?: string;
+}
+export type PeerResponse = {
+    status: number;
+    headers?: Readonly<Record<string, string>>;
+    body?: string;
+}
+/** Never answers: the request waits for the run's deadline. */
+ | {
+    hang: true;
+}
+/** The connection fails. */
+ | {
+    fail: true;
+};
+export interface ScriptedExchange {
+    request: {
+        method?: HttpMethod;
+        url: string;
+    };
+    response: PeerResponse;
+}
+/** The credential a transport under test holds: a header sent only toward `hosts` over https. */
+export interface TransportCredential {
+    hosts: readonly string[];
+    header: string;
+    value: string;
+}
+export declare class ScriptedPeer {
+    /** Every request that reached the provider, in order. */
+    readonly received: PeerRequest[];
+    private readonly handler;
+    private readonly onHang;
+    constructor(handler: (request: PeerRequest) => PeerResponse, options?: {
+        onHang?: () => void;
+    });
+    answer(request: PeerRequest): PeerResponse;
+    /** Requests received for one hostname. */
+    to(hostname: string): PeerRequest[];
+}
+/** A peer answering from exchanges, each used once, matched on method and URL in order. */
+export declare class ExchangePeer extends ScriptedPeer {
+    /** Requests no exchange matched (answered 404); robots.txt is answered 404 without being listed. */
+    readonly unscripted: string[];
+    private readonly pending;
+    constructor(exchanges: readonly ScriptedExchange[], options?: {
+        onHang?: () => void;
+    });
+    /** Exchanges no request used. */
+    unused(): ScriptedExchange[];
+}
+/**
+ * A transport over a scripted peer. It adds `credential` only when the engine marks the request
+ * as toward a credential host and the URL itself is https on the default port with a host exactly
+ * one of the credential's hosts. It returns redirects unfollowed, refuses a body over `maxBytes`
+ * and rejects when the request's signal aborts.
+ */
+export declare function peerTransport(peer: ScriptedPeer, options?: {
+    credential?: TransportCredential;
+}): Transport;
+//# sourceMappingURL=peer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"peer.d.ts","sourceRoot":"","sources":["../../src/source-harness/peer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAmB,MAAM,2BAA2B,CAAC;AAExF,4CAA4C;AAC5C,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;AAC/E,+DAA+D;GAC7D;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE;AAChB,4BAA4B;GAC1B;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC;AAEnB,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE;QAAE,MAAM,CAAC,EAAE,UAAU,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED,iGAAiG;AACjG,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,YAAY;IACvB,yDAAyD;IACzD,QAAQ,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAM;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyC;IACjE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;gBAEtC,OAAO,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,YAAY,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;KAAO;IAKlG,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,YAAY;IAQ1C,0CAA0C;IAC1C,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE;CAGpC;AAYD,2FAA2F;AAC3F,qBAAa,YAAa,SAAQ,YAAY;IAC5C,oGAAoG;IACpG,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;gBAEjC,SAAS,EAAE,SAAS,gBAAgB,EAAE,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;KAAO;IAgBzF,iCAAiC;IACjC,MAAM,IAAI,gBAAgB,EAAE;CAG7B;AAMD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,mBAAmB,CAAA;CAAO,GAAG,SAAS,CA6B/G"}