@lumencast/protocol 0.1.0

package/dist/conformance/harness.js

@@ -0,0 +1,441 @@
+// Conformance harness — drives a server through a YAML scenario via the
+// LSDP/1 wire protocol + the HTTP test control plane.
+//
+// One harness per run; each scenario is fully isolated:
+//   1. Hash inline bundles
+//   2. POST /test/setup with tokens + bundles + initial_state
+//   3. Open WebSocket to the URL returned by setup (subprotocol lsdp.v1)
+//   4. Walk steps, sending/expecting frames + control-plane introspection
+//   5. POST /test/reset before the next scenario
+import { WebSocket } from "ws";
+import { WS_SUBPROTOCOL } from "../types.js";
+import { hashInlineBundle } from "./bundle-hash.js";
+import { ControlClient } from "./control-client.js";
+import { matchFrame } from "./match.js";
+import { substitute } from "./placeholders.js";
+const DEFAULT_TOKENS = {
+    $TOKEN_OPERATOR: "interop-tok-operator-7f3a",
+    $TOKEN_VIEWER: "interop-tok-viewer-7f3a",
+    $TOKEN_SERVICE: "interop-tok-service-7f3a",
+    $TOKEN_TEST: "interop-tok-test-7f3a",
+    $TOKEN_INVALID: "interop-tok-invalid-7f3a",
+};
+export class Harness {
+    opts;
+    control;
+    tokens;
+    stepTimeoutMs;
+    constructor(opts) {
+        this.opts = opts;
+        this.control = new ControlClient(opts.controlUrl);
+        this.tokens = opts.tokens ?? DEFAULT_TOKENS;
+        this.stepTimeoutMs = opts.stepTimeoutMs ?? 2000;
+    }
+    /** Run a single scenario. */
+    async runScenario(scenario) {
+        const base = { name: scenario.name, tag: scenario.tag, target: scenario.target };
+        // Skip runtime-targeted scenarios — this harness drives a server.
+        if (scenario.target === "runtime") {
+            return {
+                ...base,
+                outcome: "SKIP",
+                reason: "runtime-targeted scenario, harness drives a server",
+            };
+        }
+        let bundleHashes = {};
+        if (scenario.bundles && scenario.bundles.length > 0) {
+            bundleHashes = await this.computeBundleHashes(scenario.bundles);
+        }
+        // Build the /test/setup payload. The control plane requires at least one
+        // bundle; if the scenario doesn't declare any, infer scene_id +
+        // scene_version + initial state from the first server-sends snapshot step.
+        const setupBundles = buildSetupBundles(scenario, bundleHashes);
+        const initialState = setupBundles.initialState;
+        let setupResponse;
+        try {
+            setupResponse = await this.control.setup({
+                scenario: scenario.name,
+                tokens: this.tokens,
+                bundles: setupBundles.bundles,
+                initial_state: initialState,
+            });
+        }
+        catch (err) {
+            return { ...base, outcome: "FAIL", reason: `setup: ${err.message}` };
+        }
+        void setupResponse;
+        const wsUrl = this.opts.serverUrl ?? setupResponse.ws_url;
+        let ws;
+        try {
+            ws = await openSocket(wsUrl);
+        }
+        catch (err) {
+            await this.control.reset().catch(() => undefined);
+            return { ...base, outcome: "FAIL", reason: `dial: ${err.message}` };
+        }
+        const exec = new Exec(ws, this.tokens, bundleHashes, this.control, this.stepTimeoutMs);
+        let result = { ...base, outcome: "PASS" };
+        for (let i = 0; i < scenario.steps.length; i++) {
+            const step = scenario.steps[i];
+            try {
+                await exec.runStep(step);
+            }
+            catch (err) {
+                result = {
+                    ...base,
+                    outcome: "FAIL",
+                    reason: `step ${i + 1} (${step.kind}): ${err.message}`,
+                };
+                break;
+            }
+        }
+        try {
+            ws.close(1000, "scenario done");
+        }
+        catch {
+            // ignore
+        }
+        await this.control.reset().catch(() => undefined);
+        return result;
+    }
+    /** Run every scenario in `scenarios` matching the tag filter (default required). */
+    async runAll(scenarios, tagFilter = "required") {
+        const rep = { total: 0, passed: 0, failed: 0, skipped: 0, results: [] };
+        for (const sc of scenarios) {
+            rep.total++;
+            if (sc.tag !== tagFilter) {
+                rep.skipped++;
+                rep.results.push({
+                    name: sc.name,
+                    tag: sc.tag,
+                    target: sc.target,
+                    outcome: "SKIP",
+                    reason: `tag ${sc.tag} != filter ${tagFilter}`,
+                });
+                continue;
+            }
+            const r = await this.runScenario(sc);
+            rep.results.push(r);
+            if (r.outcome === "PASS")
+                rep.passed++;
+            else if (r.outcome === "FAIL")
+                rep.failed++;
+            else
+                rep.skipped++;
+        }
+        return rep;
+    }
+    async computeBundleHashes(bundles) {
+        const out = {};
+        for (const b of bundles) {
+            const h = await hashInlineBundle(b.inline);
+            b.hash = h;
+            out[b.id] = h;
+        }
+        return out;
+    }
+}
+class Exec {
+    ws;
+    tokens;
+    bundleHashes;
+    control;
+    stepTimeoutMs;
+    shadowState = {};
+    inbox = [];
+    waiters = [];
+    closed = false;
+    /** WebSocket close code (RFC 6455). Set on the `close` event ; used
+     * by `expect-no-frame-for` to distinguish clean shutdown (1000/1001/
+     * 1005) from abnormal closures. */
+    closeCode = null;
+    constructor(ws, tokens, bundleHashes, control, stepTimeoutMs) {
+        this.ws = ws;
+        this.tokens = tokens;
+        this.bundleHashes = bundleHashes;
+        this.control = control;
+        this.stepTimeoutMs = stepTimeoutMs;
+        // Queue messages so frames that arrive between recv() calls aren't lost.
+        this.ws.on("message", (data) => {
+            const s = String(data);
+            const w = this.waiters.shift();
+            if (w)
+                w(s);
+            else
+                this.inbox.push(s);
+        });
+        this.ws.on("close", (code) => {
+            this.closed = true;
+            this.closeCode = code;
+            // Wake every waiter so they reject promptly.
+            while (this.waiters.length > 0)
+                this.waiters.shift()(""); // signal close
+        });
+    }
+    async runStep(step) {
+        switch (step.kind) {
+            case "client-sends":
+                return this.send(step.frame ?? {});
+            case "server-sends":
+                return this.expectServerFrame(step.frame ?? {});
+            case "server-emits":
+                return this.serverEmits(step.frame ?? {});
+            case "expect-runtime-state":
+                return this.expectRuntimeState(step.state ?? {});
+            case "expect-server-state":
+                return this.expectServerState(step.state ?? {});
+            case "expect-no-frame-for":
+                return this.expectQuiet(step.duration_ms ?? 0);
+            case "expect-client-action":
+                return this.expectClientAction(step.action, step.reason);
+            default:
+                throw new Error(`unsupported step kind ${step.kind}`);
+        }
+    }
+    /**
+     * `server-emits` (SCENARIO-FORMAT.md) — harness orchestrates a
+     * server-driven frame via the test control plane, then validates
+     * the wire form. Only `frame.type === "delta"` is currently
+     * supported (POST /test/emit).
+     */
+    async serverEmits(expected) {
+        if (expected["type"] !== "delta" || !Array.isArray(expected["patches"])) {
+            throw new Error(`server-emits only supports type=delta today, got ${String(expected["type"])}`);
+        }
+        const patches = expected["patches"];
+        const resolved = patches.map((p) => ({
+            path: p.path,
+            value: substitute(p.value, this.tokens, this.bundleHashes),
+        }));
+        await this.control.emit(resolved);
+        return this.expectServerFrame(expected);
+    }
+    send(frame) {
+        const resolved = substitute(frame, this.tokens, this.bundleHashes);
+        return new Promise((resolve, reject) => {
+            this.ws.send(JSON.stringify(resolved), (err) => {
+                if (err)
+                    reject(err);
+                else
+                    resolve();
+            });
+        });
+    }
+    async expectServerFrame(expected) {
+        // Try to read what's already in flight first (snapshots, error frames, and
+        // operator-input echoes arrive without prompting). Only fall back to
+        // /test/emit when nothing arrives within a short window AND the expected
+        // frame is a delta — that's the case where the server needs nudging.
+        const want = substitute(expected, this.tokens, this.bundleHashes);
+        let actual = null;
+        try {
+            const raw = await this.recv(150);
+            actual = JSON.parse(raw);
+        }
+        catch {
+            // No frame yet — if the expected is a delta, drive it via /test/emit.
+            if (expected["type"] === "delta" && Array.isArray(expected["patches"])) {
+                const patches = expected["patches"];
+                const resolved = patches.map((p) => ({
+                    path: p.path,
+                    value: substitute(p.value, this.tokens, this.bundleHashes),
+                }));
+                try {
+                    await this.control.emit(resolved);
+                }
+                catch {
+                    // Swallow — the matcher will report any actual mismatch.
+                }
+            }
+            const raw = await this.recv(this.stepTimeoutMs);
+            actual = JSON.parse(raw);
+        }
+        const err = matchFrame(want, actual);
+        if (err) {
+            throw new Error(`frame mismatch at ${err.path}: ${err.reason} (got ${JSON.stringify(actual)})`);
+        }
+        this.absorb(actual);
+    }
+    absorb(frame) {
+        if (frame["type"] === "snapshot") {
+            const state = frame["state"] ?? {};
+            this.shadowState = { ...state };
+        }
+        else if (frame["type"] === "delta") {
+            const patches = frame["patches"] ?? [];
+            for (const p of patches)
+                this.shadowState[p.path] = p.value;
+        }
+    }
+    expectRuntimeState(want) {
+        for (const [k, v] of Object.entries(want)) {
+            if (!(k in this.shadowState)) {
+                throw new Error(`runtime state missing ${k}`);
+            }
+            const got = this.shadowState[k];
+            if (JSON.stringify(got) !== JSON.stringify(v)) {
+                throw new Error(`runtime state ${k}: want ${JSON.stringify(v)}, got ${JSON.stringify(got)}`);
+            }
+        }
+    }
+    async expectServerState(want) {
+        const snap = await this.control.state();
+        for (const [k, v] of Object.entries(want)) {
+            if (!(k in snap.state)) {
+                throw new Error(`server state missing ${k}`);
+            }
+            const got = snap.state[k];
+            if (JSON.stringify(got) !== JSON.stringify(v)) {
+                throw new Error(`server state ${k}: want ${JSON.stringify(v)}, got ${JSON.stringify(got)}`);
+            }
+        }
+    }
+    async expectQuiet(durationMs) {
+        try {
+            const raw = await this.recv(durationMs);
+            throw new Error(`expected silence for ${durationMs}ms, got frame: ${raw}`);
+        }
+        catch (err) {
+            const msg = err.message;
+            if (msg === "recv timeout")
+                return;
+            // SCENARIO-FORMAT.md `expect-no-frame-for` § Connection-close
+            // semantics : clean WS close (1000/1001/1005) within the duration
+            // counts as success — no data flowed. Abnormal closures still
+            // surface as errors.
+            if (msg === "connection closed") {
+                const code = this.closeCode;
+                if (code === 1000 || code === 1001 || code === 1005)
+                    return;
+            }
+            throw err;
+        }
+    }
+    async expectClientAction(action, _reason) {
+        if (!action)
+            throw new Error("expect-client-action: action required");
+        if (action === "close-with-reason" || action === "reconnect") {
+            // Read should reject (connection closed or no further frames).
+            try {
+                await this.recv(this.stepTimeoutMs);
+            }
+            catch (err) {
+                if (err.message === "recv timeout")
+                    return;
+                // close → recv rejects, that's the success path.
+                return;
+            }
+            throw new Error(`expected connection close or no frame, got data`);
+        }
+        throw new Error(`unknown client action ${action}`);
+    }
+    recv(timeoutMs) {
+        return new Promise((resolve, reject) => {
+            const queued = this.inbox.shift();
+            if (queued !== undefined) {
+                resolve(queued);
+                return;
+            }
+            if (this.closed) {
+                reject(new Error("connection closed"));
+                return;
+            }
+            const t = setTimeout(() => {
+                const i = this.waiters.indexOf(resolveAndDispatch);
+                if (i >= 0)
+                    this.waiters.splice(i, 1);
+                reject(new Error("recv timeout"));
+            }, timeoutMs);
+            const resolveAndDispatch = (v) => {
+                clearTimeout(t);
+                if (v === "" && this.closed)
+                    reject(new Error("connection closed"));
+                else
+                    resolve(v);
+            };
+            this.waiters.push(resolveAndDispatch);
+        });
+    }
+}
+function openSocket(url) {
+    return new Promise((resolve, reject) => {
+        const ws = new WebSocket(url, [WS_SUBPROTOCOL]);
+        ws.once("open", () => resolve(ws));
+        ws.once("error", reject);
+    });
+}
+function extractInitialState(bundles) {
+    // The Go reference reads `initial_state` from the scenario top-level when
+    // present. Our scenarios encode it inside each bundle's `defaults` field
+    // (LSML 1.0 §10). Pull from the first bundle's defaults if any.
+    const primary = bundles[0];
+    if (primary && typeof primary.inline === "object" && primary.inline !== null) {
+        const defaults = primary.inline.defaults;
+        if (defaults && typeof defaults === "object")
+            return defaults;
+    }
+    return {};
+}
+/** Build the bundles + initial_state payload for /test/setup.
+ *  When the scenario declares bundles, use them verbatim. Otherwise, infer
+ *  scene_id + scene_version + initial state from the first server-sends
+ *  snapshot step in the scenario — the same shape the harness will later
+ *  expect on the wire. */
+function buildSetupBundles(scenario, bundleHashes) {
+    if (scenario.bundles && scenario.bundles.length > 0) {
+        return {
+            bundles: scenario.bundles.map((b) => ({
+                id: b.id,
+                hash: bundleHashes[b.id] ?? "",
+                inline: b.inline,
+            })),
+            initialState: extractInitialState(scenario.bundles),
+        };
+    }
+    // Look for the first `server-sends snapshot` step.
+    let sceneId = "t";
+    let sceneVersion = "sha256:" + "f".repeat(64);
+    let initialState = {};
+    for (const step of scenario.steps) {
+        if (step.kind !== "server-sends" || !step.frame || step.frame["type"] !== "snapshot") {
+            continue;
+        }
+        const snap = step.frame;
+        if (typeof snap["scene_id"] === "string" && snap["scene_id"] !== "$ANY") {
+            sceneId = snap["scene_id"];
+        }
+        if (typeof snap["scene_version"] === "string" && snap["scene_version"] !== "$ANY_HASH") {
+            sceneVersion = snap["scene_version"];
+        }
+        if (snap["state"] && typeof snap["state"] === "object") {
+            initialState = snap["state"];
+        }
+        break;
+    }
+    // Synthesize an `operator_inputs` schema declaring every __inputs.* path
+    // present in the initial state. This makes the server reject UNKNOWN_PATH
+    // for inputs on undeclared paths, mirroring real-server semantics.
+    const operatorInputs = Object.keys(initialState)
+        .filter((p) => p.startsWith("__inputs."))
+        .map((p) => ({
+        path: p,
+        label: p,
+        type: typeof initialState[p] === "number" ? "number" : "string",
+        writable_by: ["operator"],
+    }));
+    return {
+        bundles: [
+            {
+                id: sceneId,
+                hash: sceneVersion,
+                inline: {
+                    scene_id: sceneId,
+                    synthetic: true,
+                    ...(operatorInputs.length > 0 ? { operator_inputs: operatorInputs } : {}),
+                },
+            },
+        ],
+        initialState,
+    };
+}
+//# sourceMappingURL=harness.js.map

package/dist/conformance/harness.js.map

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

package/dist/conformance/index.d.ts

@@ -0,0 +1,8 @@
+export { parseScenario, type Scenario, type Step, type StepKind, type Tag, type Target, type ClientAction, type BundleDecl, } from "./scenario.js";
+export { loadScenarios, type LoadOptions } from "./loader.js";
+export { matchFrame, matchValue, type MatchError } from "./match.js";
+export { substitute } from "./placeholders.js";
+export { canonicalize, hashInlineBundle } from "./bundle-hash.js";
+export { ControlClient, type SetupRequest, type SetupResponse, type StateResponse, type HealthResponse, } from "./control-client.js";
+export { Harness, type HarnessOptions, type Outcome, type ScenarioResult, type Report, } from "./harness.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/conformance/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/conformance/index.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,aAAa,EACb,KAAK,QAAQ,EACb,KAAK,IAAI,EACT,KAAK,QAAQ,EACb,KAAK,GAAG,EACR,KAAK,MAAM,EACX,KAAK,YAAY,EACjB,KAAK,UAAU,GAChB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EACL,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,cAAc,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,OAAO,EACP,KAAK,cAAc,EACnB,KAAK,OAAO,EACZ,KAAK,cAAc,EACnB,KAAK,MAAM,GACZ,MAAM,cAAc,CAAC"}

package/dist/conformance/index.js

@@ -0,0 +1,12 @@
+// Public surface of @lumencast/protocol/conformance.
+//
+// Loaders + harness for the LSDP/1 conformance scenarios. Used by the
+// `lumencast-js conformance` CLI and by interop matrix runs.
+export { parseScenario, } from "./scenario.js";
+export { loadScenarios } from "./loader.js";
+export { matchFrame, matchValue } from "./match.js";
+export { substitute } from "./placeholders.js";
+export { canonicalize, hashInlineBundle } from "./bundle-hash.js";
+export { ControlClient, } from "./control-client.js";
+export { Harness, } from "./harness.js";
+//# sourceMappingURL=index.js.map

package/dist/conformance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/conformance/index.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,EAAE;AACF,sEAAsE;AACtE,6DAA6D;AAE7D,OAAO,EACL,aAAa,GAQd,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,aAAa,EAAoB,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,UAAU,EAAmB,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EACL,aAAa,GAKd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,OAAO,GAKR,MAAM,cAAc,CAAC"}

package/dist/conformance/loader.d.ts

@@ -0,0 +1,9 @@
+import { type Scenario } from "./scenario.js";
+export interface LoadOptions {
+    /** Directory containing the *.yaml scenarios. Required. */
+    scenariosDir: string;
+    /** When set, only load this single scenario (basename without .yaml). */
+    scenarioName?: string;
+}
+export declare function loadScenarios(opts: LoadOptions): Scenario[];
+//# sourceMappingURL=loader.d.ts.map

package/dist/conformance/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/conformance/loader.ts"],"names":[],"mappings":"AAKA,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE7D,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,QAAQ,EAAE,CAwB3D"}

package/dist/conformance/loader.js

@@ -0,0 +1,27 @@
+// Filesystem loader for scenarios. Reads YAML files from disk by path. The
+// CLI uses this to find scenarios under `lumencast-protocol/conformance/v1/scenarios/`.
+import { readdirSync, readFileSync, statSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { parseScenario } from "./scenario.js";
+export function loadScenarios(opts) {
+    const dir = resolve(opts.scenariosDir);
+    const stat = statSync(dir, { throwIfNoEntry: false });
+    if (!stat || !stat.isDirectory()) {
+        throw new Error(`scenarios directory not found: ${dir}`);
+    }
+    let files = readdirSync(dir).filter((f) => f.endsWith(".yaml") || f.endsWith(".yml"));
+    if (opts.scenarioName) {
+        files = files.filter((f) => f === `${opts.scenarioName}.yaml` || f === `${opts.scenarioName}.yml`);
+        if (files.length === 0) {
+            throw new Error(`scenario not found in ${dir}: ${opts.scenarioName}`);
+        }
+    }
+    files.sort();
+    const out = [];
+    for (const f of files) {
+        const raw = readFileSync(join(dir, f), "utf8");
+        out.push(parseScenario(raw));
+    }
+    return out;
+}
+//# sourceMappingURL=loader.js.map

package/dist/conformance/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/conformance/loader.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,wFAAwF;AAExF,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAiB,MAAM,eAAe,CAAC;AAS7D,MAAM,UAAU,aAAa,CAAC,IAAiB;IAC7C,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,CAAC;IACtD,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,kCAAkC,GAAG,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IACtF,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,KAAK,GAAG,KAAK,CAAC,MAAM,CAClB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,YAAY,OAAO,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,YAAY,MAAM,CAC7E,CAAC;QACF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,yBAAyB,GAAG,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IACD,KAAK,CAAC,IAAI,EAAE,CAAC;IAEb,MAAM,GAAG,GAAe,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAC/C,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/conformance/match.d.ts

@@ -0,0 +1,7 @@
+export interface MatchError {
+    path: string;
+    reason: string;
+}
+export declare function matchFrame(expected: Record<string, unknown>, actual: Record<string, unknown>): MatchError | null;
+export declare function matchValue(expected: unknown, actual: unknown, path: string): MatchError | null;
+//# sourceMappingURL=match.d.ts.map

package/dist/conformance/match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"match.d.ts","sourceRoot":"","sources":["../../src/conformance/match.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,UAAU,GAAG,IAAI,CASnB;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAyC9F"}

package/dist/conformance/match.js

@@ -0,0 +1,82 @@
+// Frame matcher with $ANY / $ANY_HASH sentinels. Mirrors
+// lumencast-go/conformance/match.go.
+//
+// matchValue rules :
+//   - "$ANY"      → matches any present value
+//   - "$ANY_HASH" → matches a sha256:<hex64> string
+//   - object → recurse on each key in the expected template; extra fields in
+//     the actual object are tolerated (forward-compat)
+//   - array → length and element-wise match
+//   - scalar → strict equality (numeric tower normalized)
+const SHA256_RE = /^sha256:[0-9a-f]{64}$/;
+export function matchFrame(expected, actual) {
+    for (const [k, want] of Object.entries(expected)) {
+        if (!(k in actual)) {
+            return { path: k, reason: `missing field` };
+        }
+        const err = matchValue(want, actual[k], k);
+        if (err)
+            return err;
+    }
+    return null;
+}
+export function matchValue(expected, actual, path) {
+    if (typeof expected === "string") {
+        if (expected === "$ANY")
+            return null;
+        if (expected === "$ANY_HASH") {
+            if (typeof actual !== "string" || !SHA256_RE.test(actual)) {
+                return { path, reason: `not a sha256 hash: ${JSON.stringify(actual)}` };
+            }
+            return null;
+        }
+    }
+    if (Array.isArray(expected)) {
+        if (!Array.isArray(actual)) {
+            return { path, reason: `want array, got ${typeOf(actual)}` };
+        }
+        if (expected.length !== actual.length) {
+            return { path, reason: `length ${expected.length} != ${actual.length}` };
+        }
+        for (let i = 0; i < expected.length; i++) {
+            const err = matchValue(expected[i], actual[i], `${path}[${i}]`);
+            if (err)
+                return err;
+        }
+        return null;
+    }
+    if (typeof expected === "object" && expected !== null) {
+        if (typeof actual !== "object" || actual === null || Array.isArray(actual)) {
+            return { path, reason: `want object, got ${typeOf(actual)}` };
+        }
+        return matchFrame(expected, actual)
+            ? prefix(path, matchFrame(expected, actual))
+            : null;
+    }
+    if (!equalScalar(expected, actual)) {
+        return {
+            path,
+            reason: `want ${JSON.stringify(expected)}, got ${JSON.stringify(actual)}`,
+        };
+    }
+    return null;
+}
+function prefix(p, err) {
+    return { path: `${p}.${err.path}`, reason: err.reason };
+}
+function equalScalar(a, b) {
+    if (a === b)
+        return true;
+    if (typeof a === "number" && typeof b === "number") {
+        return a === b || (Number.isNaN(a) && Number.isNaN(b));
+    }
+    return false;
+}
+function typeOf(v) {
+    if (v === null)
+        return "null";
+    if (Array.isArray(v))
+        return "array";
+    return typeof v;
+}
+//# sourceMappingURL=match.js.map

package/dist/conformance/match.js.map

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

package/dist/conformance/placeholders.d.ts

@@ -0,0 +1,2 @@
+export declare function substitute(value: unknown, tokens: Record<string, string>, bundleHashes: Record<string, string>): unknown;
+//# sourceMappingURL=placeholders.d.ts.map

package/dist/conformance/placeholders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"placeholders.d.ts","sourceRoot":"","sources":["../../src/conformance/placeholders.ts"],"names":[],"mappings":"AAgBA,wBAAgB,UAAU,CACxB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,OAAO,CAwBT"}