@lumencast/protocol 0.1.0

package/dist/codec.js

@@ -0,0 +1,328 @@
+// JSON envelope codec for LSDP/1 frames.
+// Hand-rolled type guards rather than a schema library — keeps the bundle
+// weight off the runtime hot path and the surface auditable.
+import { LumencastError } from "./errors.js";
+import { isProtocolErrorCode } from "./errors.js";
+import { PROTOCOL_VERSION, } from "./types.js";
+/** Encode any LSDP frame to its on-wire JSON string. */
+export function encodeFrame(frame) {
+    return JSON.stringify(frame);
+}
+/**
+ * Decode a JSON text frame into a typed `ServerFrame`.
+ *
+ * Throws `LumencastError` with `INTERNAL` if the bytes are not valid JSON,
+ * are not an object, or carry an unsupported `v`. Unknown `type` values
+ * resolve to `null` (forward-compatibility — receivers MUST ignore unknown
+ * frame types per LSDP/1 §13).
+ */
+export function decodeServerFrame(raw) {
+    const parsed = parseJsonObject(raw);
+    validateEnvelope(parsed);
+    switch (parsed["type"]) {
+        case "snapshot":
+            return decodeSnapshot(parsed);
+        case "delta":
+            return decodeDelta(parsed);
+        case "scene_changed":
+            return decodeSceneChanged(parsed);
+        case "error":
+            return decodeError(parsed);
+        case "pong":
+            return decodePong(parsed);
+        default:
+            return null;
+    }
+}
+/** Decode a JSON text frame into a typed `ClientFrame`. Same forward-compat rule. */
+export function decodeClientFrame(raw) {
+    const parsed = parseJsonObject(raw);
+    validateEnvelope(parsed);
+    switch (parsed["type"]) {
+        case "subscribe":
+            return decodeSubscribe(parsed);
+        case "input":
+            return decodeInput(parsed);
+        case "ping":
+            return decodePing(parsed);
+        case "unsubscribe":
+            return decodeUnsubscribe(parsed);
+        default:
+            return null;
+    }
+}
+// --- decoders ---------------------------------------------------------------
+function decodeSnapshot(o) {
+    requireFields(o, ["seq", "scene_id", "scene_version", "state"]);
+    const state = o["state"];
+    if (!isPlainObject(state)) {
+        throw protocolError(`snapshot.state must be an object`);
+    }
+    for (const [path, value] of Object.entries(state)) {
+        assertLeafValue(value, `snapshot.state[${path}]`);
+    }
+    return {
+        v: PROTOCOL_VERSION,
+        type: "snapshot",
+        seq: assertInt(o["seq"], "snapshot.seq"),
+        scene_id: assertString(o["scene_id"], "snapshot.scene_id"),
+        scene_version: assertString(o["scene_version"], "snapshot.scene_version"),
+        state: state,
+        ...optionalTs(o),
+    };
+}
+function decodeDelta(o) {
+    requireFields(o, ["seq", "patches"]);
+    const frame = {
+        v: PROTOCOL_VERSION,
+        type: "delta",
+        seq: assertInt(o["seq"], "delta.seq"),
+        patches: assertPatches(o["patches"], "delta.patches"),
+        ...optionalTs(o),
+    };
+    if (o["cause"] !== undefined) {
+        frame.cause = assertCause(o["cause"], "delta.cause");
+    }
+    return frame;
+}
+function decodeSceneChanged(o) {
+    requireFields(o, ["seq", "scene_id", "scene_version"]);
+    const frame = {
+        v: PROTOCOL_VERSION,
+        type: "scene_changed",
+        seq: assertInt(o["seq"], "scene_changed.seq"),
+        scene_id: assertString(o["scene_id"], "scene_changed.scene_id"),
+        scene_version: assertString(o["scene_version"], "scene_changed.scene_version"),
+        ...optionalTs(o),
+    };
+    if (typeof o["from_scene_id"] === "string") {
+        frame.from_scene_id = o["from_scene_id"];
+    }
+    if (o["transition"] !== undefined) {
+        frame.transition = assertSceneTransition(o["transition"], "scene_changed.transition");
+    }
+    return frame;
+}
+function decodeError(o) {
+    requireFields(o, ["seq", "code", "message", "recoverable"]);
+    const code = o["code"];
+    if (!isProtocolErrorCode(code)) {
+        throw protocolError(`error.code is not in the closed taxonomy: ${String(code)}`);
+    }
+    const message = assertString(o["message"], "error.message");
+    if (typeof o["recoverable"] !== "boolean") {
+        throw protocolError(`error.recoverable must be boolean`);
+    }
+    const frame = {
+        v: PROTOCOL_VERSION,
+        type: "error",
+        seq: assertInt(o["seq"], "error.seq"),
+        code,
+        message,
+        recoverable: o["recoverable"],
+        ...optionalTs(o),
+    };
+    if (o["retry_after_ms"] !== undefined) {
+        frame.retry_after_ms = assertInt(o["retry_after_ms"], "error.retry_after_ms");
+    }
+    return frame;
+}
+function decodePong(o) {
+    const frame = { v: PROTOCOL_VERSION, type: "pong" };
+    if (typeof o["nonce"] === "string") {
+        frame.nonce = o["nonce"];
+    }
+    return frame;
+}
+function decodeSubscribe(o) {
+    requireFields(o, ["token"]);
+    const frame = {
+        v: PROTOCOL_VERSION,
+        type: "subscribe",
+        token: assertString(o["token"], "subscribe.token"),
+    };
+    if (o["scene"] !== undefined && o["scene"] !== null) {
+        frame.scene = assertString(o["scene"], "subscribe.scene");
+    }
+    if (o["session"] !== undefined && o["session"] !== null) {
+        frame.session = assertString(o["session"], "subscribe.session");
+    }
+    if (o["since_sequence"] !== undefined) {
+        frame.since_sequence = assertInt(o["since_sequence"], "subscribe.since_sequence");
+    }
+    return frame;
+}
+function decodeInput(o) {
+    requireFields(o, ["patches"]);
+    const frame = {
+        v: PROTOCOL_VERSION,
+        type: "input",
+        patches: assertPatches(o["patches"], "input.patches"),
+    };
+    if (typeof o["client_msg_id"] === "string") {
+        frame.client_msg_id = o["client_msg_id"];
+    }
+    return frame;
+}
+function decodePing(o) {
+    const frame = { v: PROTOCOL_VERSION, type: "ping" };
+    if (typeof o["nonce"] === "string") {
+        frame.nonce = o["nonce"];
+    }
+    return frame;
+}
+function decodeUnsubscribe(_o) {
+    return { v: PROTOCOL_VERSION, type: "unsubscribe" };
+}
+// --- envelope validation ----------------------------------------------------
+function parseJsonObject(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw protocolError(`frame is not valid JSON`);
+    }
+    if (!isPlainObject(parsed)) {
+        throw protocolError(`frame is not a JSON object`);
+    }
+    return parsed;
+}
+function validateEnvelope(o) {
+    if (o["v"] !== PROTOCOL_VERSION) {
+        throw protocolError(`envelope.v must be ${PROTOCOL_VERSION}, got ${String(o["v"])}`);
+    }
+    if (typeof o["type"] !== "string") {
+        throw protocolError(`envelope.type must be a string`);
+    }
+}
+// --- assertion primitives ---------------------------------------------------
+function requireFields(o, fields) {
+    for (const f of fields) {
+        if (!(f in o)) {
+            throw protocolError(`missing required field: ${f}`);
+        }
+    }
+}
+function assertString(v, label) {
+    if (typeof v !== "string") {
+        throw protocolError(`${label} must be a string`);
+    }
+    return v;
+}
+function assertInt(v, label) {
+    if (typeof v !== "number" || !Number.isInteger(v)) {
+        throw protocolError(`${label} must be an integer`);
+    }
+    return v;
+}
+function assertPatches(v, label) {
+    if (!Array.isArray(v) || v.length === 0) {
+        throw protocolError(`${label} must be a non-empty array`);
+    }
+    return v.map((p, i) => {
+        if (!isPlainObject(p)) {
+            throw protocolError(`${label}[${i}] must be an object`);
+        }
+        if (typeof p["path"] !== "string") {
+            throw protocolError(`${label}[${i}].path must be a string`);
+        }
+        assertLeafValue(p["value"], `${label}[${i}].value`, p["path"]);
+        const patch = { path: p["path"], value: p["value"] };
+        if (p["transition"] !== undefined) {
+            patch.transition = assertTransitionSpec(p["transition"], `${label}[${i}].transition`);
+        }
+        return patch;
+    });
+}
+function assertTransitionSpec(v, label) {
+    if (!isPlainObject(v)) {
+        throw protocolError(`${label} must be an object`);
+    }
+    const kind = v["kind"];
+    if (kind !== "tween" && kind !== "spring" && kind !== "snap") {
+        throw protocolError(`${label}.kind must be one of "tween", "spring", "snap"`);
+    }
+    const spec = { kind };
+    if (v["duration_ms"] !== undefined) {
+        spec.duration_ms = assertInt(v["duration_ms"], `${label}.duration_ms`);
+    }
+    if (typeof v["easing"] === "string") {
+        const e = v["easing"];
+        if (e !== "linear" && e !== "ease-in" && e !== "ease-out" && e !== "ease-in-out") {
+            throw protocolError(`${label}.easing must be one of "linear", "ease-in", "ease-out", "ease-in-out"`);
+        }
+        spec.easing = e;
+    }
+    if (v["stiffness"] !== undefined) {
+        if (typeof v["stiffness"] !== "number") {
+            throw protocolError(`${label}.stiffness must be a number`);
+        }
+        spec.stiffness = v["stiffness"];
+    }
+    if (v["damping"] !== undefined) {
+        if (typeof v["damping"] !== "number") {
+            throw protocolError(`${label}.damping must be a number`);
+        }
+        spec.damping = v["damping"];
+    }
+    return spec;
+}
+function assertCause(v, label) {
+    if (!isPlainObject(v)) {
+        throw protocolError(`${label} must be an object`);
+    }
+    const source = v["source"];
+    if (typeof source !== "string") {
+        throw protocolError(`${label}.source must be a string`);
+    }
+    const cause = { source };
+    if (typeof v["input_id"] === "string") {
+        cause.input_id = v["input_id"];
+    }
+    return cause;
+}
+function assertSceneTransition(v, label) {
+    if (!isPlainObject(v)) {
+        throw protocolError(`${label} must be an object`);
+    }
+    if (typeof v["kind"] !== "string") {
+        throw protocolError(`${label}.kind must be a string`);
+    }
+    const t = { kind: v["kind"] };
+    if (v["duration_ms"] !== undefined) {
+        t.duration_ms = assertInt(v["duration_ms"], `${label}.duration_ms`);
+    }
+    return t;
+}
+function assertLeafValue(v, label, path) {
+    if (v === null)
+        return;
+    if (typeof v === "string" || typeof v === "number" || typeof v === "boolean")
+        return;
+    if (Array.isArray(v)) {
+        v.forEach((item, i) => assertLeafValue(item, `${label}[${i}]`, path));
+        return;
+    }
+    // Per LSDP/1.0.1 §3.2.1, objects are forbidden as patch values.
+    // The right error code is INVALID_VALUE (recoverable, path-scoped),
+    // not INTERNAL — see ERROR-CODES.md §1.4 + LSDP-1.md §3.4.1.
+    throw new LumencastError({
+        code: "INVALID_VALUE",
+        message: `${label}: objects are forbidden in patch values, push leaf-grain instead`,
+        recoverable: true,
+        ...(path !== undefined ? { path } : {}),
+    });
+}
+function isPlainObject(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function optionalTs(o) {
+    if (typeof o["ts"] === "string")
+        return { ts: o["ts"] };
+    return {};
+}
+function protocolError(message) {
+    return new LumencastError({ code: "INTERNAL", message, recoverable: false });
+}
+//# sourceMappingURL=codec.js.map

package/dist/codec.js.map

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

package/dist/conformance/bundle-hash.d.ts

@@ -0,0 +1,4 @@
+export declare function canonicalize(value: unknown): string;
+/** Hash an inline LSML bundle, returning the `sha256:<hex>` identity. */
+export declare function hashInlineBundle(inline: unknown): Promise<string>;
+//# sourceMappingURL=bundle-hash.d.ts.map

package/dist/conformance/bundle-hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-hash.d.ts","sourceRoot":"","sources":["../../src/conformance/bundle-hash.ts"],"names":[],"mappings":"AAMA,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD;AAED,yEAAyE;AACzE,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAWvE"}

package/dist/conformance/bundle-hash.js

@@ -0,0 +1,49 @@
+// Canonical sha256 hashing per LSML 1.0 §3.
+// Duplicated from @lumencast/compiler to avoid a circular workspace dep
+// (compiler depends on protocol). Keep the two in sync.
+const ZERO_HASH = "sha256:" + "0".repeat(64);
+export function canonicalize(value) {
+    return stringify(value);
+}
+/** Hash an inline LSML bundle, returning the `sha256:<hex>` identity. */
+export async function hashInlineBundle(inline) {
+    // Per spec: scene_version is set to all zeros during hashing.
+    const stub = typeof inline === "object" && inline !== null && !Array.isArray(inline)
+        ? { ...inline, scene_version: ZERO_HASH }
+        : inline;
+    const canonical = canonicalize(stub);
+    const bytes = new TextEncoder().encode(canonical);
+    const subtle = getSubtle();
+    const digest = await subtle.digest("SHA-256", bytes);
+    return "sha256:" + bytesToHex(new Uint8Array(digest));
+}
+function stringify(v) {
+    if (v === null)
+        return "null";
+    if (typeof v === "boolean" || typeof v === "number")
+        return JSON.stringify(v);
+    if (typeof v === "string")
+        return JSON.stringify(v);
+    if (Array.isArray(v))
+        return "[" + v.map(stringify).join(",") + "]";
+    if (typeof v === "object") {
+        const obj = v;
+        const keys = Object.keys(obj).sort();
+        return "{" + keys.map((k) => JSON.stringify(k) + ":" + stringify(obj[k])).join(",") + "}";
+    }
+    return "null";
+}
+function bytesToHex(bytes) {
+    let s = "";
+    for (const b of bytes)
+        s += b.toString(16).padStart(2, "0");
+    return s;
+}
+function getSubtle() {
+    const c = globalThis.crypto;
+    if (!c?.subtle) {
+        throw new Error("conformance: crypto.subtle not available — Node >= 18 or browser required");
+    }
+    return c.subtle;
+}
+//# sourceMappingURL=bundle-hash.js.map

package/dist/conformance/bundle-hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-hash.js","sourceRoot":"","sources":["../../src/conformance/bundle-hash.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,wEAAwE;AACxE,wDAAwD;AAExD,MAAM,SAAS,GAAG,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAE7C,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;AAC1B,CAAC;AAED,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAe;IACpD,8DAA8D;IAC9D,MAAM,IAAI,GACR,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QACrE,CAAC,CAAC,EAAE,GAAI,MAAkC,EAAE,aAAa,EAAE,SAAS,EAAE;QACtE,CAAC,CAAC,MAAM,CAAC;IACb,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACrD,OAAO,SAAS,GAAG,UAAU,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,SAAS,CAAC,CAAU;IAC3B,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAC9B,IAAI,OAAO,CAAC,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC9E,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACpD,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAAE,OAAO,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACpE,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,CAA4B,CAAC;QACzC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,OAAO,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IAC5F,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,UAAU,CAAC,KAAiB;IACnC,IAAI,CAAC,GAAG,EAAE,CAAC;IACX,KAAK,MAAM,CAAC,IAAI,KAAK;QAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5D,OAAO,CAAC,CAAC;AACX,CAAC;AAMD,SAAS,SAAS;IAChB,MAAM,CAAC,GAAI,UAA8D,CAAC,MAAM,CAAC;IACjF,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;IAC/F,CAAC;IACD,OAAO,CAAC,CAAC,MAAM,CAAC;AAClB,CAAC"}

package/dist/conformance/control-client.d.ts

@@ -0,0 +1,42 @@
+export interface SetupRequest {
+    scenario: string;
+    tokens: Record<string, string>;
+    bundles: Array<{
+        id: string;
+        hash: string;
+        inline: unknown;
+    }>;
+    initial_state: Record<string, unknown>;
+}
+export interface SetupResponse {
+    ws_url: string;
+    scene_id: string;
+    scene_version: string;
+}
+export interface StateResponse {
+    scene_id: string;
+    scene_version: string;
+    state: Record<string, unknown>;
+}
+export interface HealthResponse {
+    status: string;
+    control_plane_version: number;
+    server?: string;
+}
+export declare class ControlClient {
+    private readonly baseUrl;
+    constructor(baseUrl: string);
+    setup(req: SetupRequest): Promise<SetupResponse>;
+    reset(): Promise<void>;
+    state(): Promise<StateResponse>;
+    emit(patches: Array<{
+        path: string;
+        value: unknown;
+    }>): Promise<void>;
+    health(): Promise<HealthResponse>;
+    private postJson;
+    private postNoBody;
+    private getJson;
+    private toProblem;
+}
+//# sourceMappingURL=control-client.d.ts.map

package/dist/conformance/control-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-client.d.ts","sourceRoot":"","sources":["../../src/conformance/control-client.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC9D,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB,EAAE,MAAM,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,MAAM;IAEtC,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAIhD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC;IAI/B,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrE,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC;YAIzB,QAAQ;YAYR,UAAU;YAWV,OAAO;YAQP,SAAS;CAUxB"}

package/dist/conformance/control-client.js

@@ -0,0 +1,63 @@
+// HTTP client for the LSDP/1 interop test control plane.
+// Spec: lumencast-protocol/interop/CONTROL.md
+export class ControlClient {
+    baseUrl;
+    constructor(baseUrl) {
+        this.baseUrl = baseUrl;
+    }
+    async setup(req) {
+        return await this.postJson("/test/setup", req);
+    }
+    async reset() {
+        await this.postNoBody("/test/reset");
+    }
+    async state() {
+        return await this.getJson("/test/state");
+    }
+    async emit(patches) {
+        await this.postNoBody("/test/emit", { patches });
+    }
+    async health() {
+        return await this.getJson("/test/health");
+    }
+    async postJson(path, body) {
+        const res = await fetch(`${this.baseUrl}${path}`, {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify(body),
+        });
+        if (res.status >= 400) {
+            throw await this.toProblem(res, path);
+        }
+        return (await res.json());
+    }
+    async postNoBody(path, body) {
+        const res = await fetch(`${this.baseUrl}${path}`, {
+            method: "POST",
+            headers: body !== undefined ? { "content-type": "application/json" } : {},
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+        });
+        if (res.status >= 400) {
+            throw await this.toProblem(res, path);
+        }
+    }
+    async getJson(path) {
+        const res = await fetch(`${this.baseUrl}${path}`);
+        if (res.status >= 400) {
+            throw await this.toProblem(res, path);
+        }
+        return (await res.json());
+    }
+    async toProblem(res, path) {
+        let detail;
+        try {
+            const body = (await res.json());
+            detail = body.detail ?? body.title ?? `${res.status}`;
+        }
+        catch {
+            detail = `${res.status}`;
+        }
+        return new Error(`control: ${path} → ${res.status}: ${detail}`);
+    }
+}
+//# sourceMappingURL=control-client.js.map

package/dist/conformance/control-client.js.map

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

package/dist/conformance/harness.d.ts

@@ -0,0 +1,41 @@
+import type { Scenario, Tag, Target } from "./scenario.js";
+export interface HarnessOptions {
+    /** ws://host:port/lsdp/v1 — the WS endpoint the server returns from /test/setup,
+     *  OR (for servers that don't speak the control plane) the static endpoint. */
+    serverUrl?: string;
+    /** http://host:port — the test control plane root. Required for cross-language. */
+    controlUrl: string;
+    /** Token map used by /test/setup. Must include the canonical placeholders.
+     *  Default: the canonical interop tokens (matches lumencast-protocol/interop/fixtures/). */
+    tokens?: Record<string, string>;
+    /** Per-step read timeout. Default 2_000 ms. */
+    stepTimeoutMs?: number;
+}
+export type Outcome = "PASS" | "FAIL" | "SKIP";
+export interface ScenarioResult {
+    name: string;
+    tag: Tag;
+    target: Target;
+    outcome: Outcome;
+    reason?: string;
+}
+export interface Report {
+    total: number;
+    passed: number;
+    failed: number;
+    skipped: number;
+    results: ScenarioResult[];
+}
+export declare class Harness {
+    private readonly opts;
+    private readonly control;
+    private readonly tokens;
+    private readonly stepTimeoutMs;
+    constructor(opts: HarnessOptions);
+    /** Run a single scenario. */
+    runScenario(scenario: Scenario): Promise<ScenarioResult>;
+    /** Run every scenario in `scenarios` matching the tag filter (default required). */
+    runAll(scenarios: Scenario[], tagFilter?: Tag): Promise<Report>;
+    private computeBundleHashes;
+}
+//# sourceMappingURL=harness.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../../src/conformance/harness.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAA4B,QAAQ,EAAQ,GAAG,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE3F,MAAM,WAAW,cAAc;IAC7B;mFAC+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mFAAmF;IACnF,UAAU,EAAE,MAAM,CAAC;IACnB;gGAC4F;IAC5F,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,+CAA+C;IAC/C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAUD,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAE/C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,GAAG,CAAC;IACT,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED,qBAAa,OAAO;IAKN,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAEV,IAAI,EAAE,cAAc;IAMjD,6BAA6B;IACvB,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC;IAuE9D,oFAAoF;IAC9E,MAAM,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,SAAS,GAAE,GAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;YAwBnE,mBAAmB;CASlC"}