@lumencast/server 0.1.0

package/dist/cli.js

@@ -0,0 +1,154 @@
+#!/usr/bin/env node
+// lumencast-js server CLI.
+//
+// Subcommands:
+//   serve-scenario --ws-port N --test-control-port M [--host H]
+//     Boots the LSDP/1 server with the interop test control plane on a
+//     separate port. Prints exactly one JSON discovery line on stdout :
+//     {"control_url":"http://...","ws_url":"ws://.../lsdp/v1"}
+//     before any other output, then stays silent on stdout (logs go to stderr).
+import { parseArgs } from "node:util";
+import { createScene } from "./scene.js";
+import { startServer } from "./server.js";
+import { StaticTokens } from "./auth.js";
+import { startTestControl } from "./test-control.js";
+async function main(argv) {
+    const sub = argv[0];
+    if (!sub || sub === "--help" || sub === "-h") {
+        printUsage();
+        return sub ? 0 : 2;
+    }
+    if (sub === "serve-scenario")
+        return cmdServeScenario(argv.slice(1));
+    process.stderr.write(`lumencast-js: unknown subcommand "${sub}"\n`);
+    printUsage();
+    return 2;
+}
+function printUsage() {
+    process.stderr.write([
+        "usage: lumencast-js <subcommand> [flags]",
+        "",
+        "subcommands:",
+        "  serve-scenario --ws-port N --test-control-port M [--host H]",
+        "    Boot LSDP/1 server + interop test control plane (separate ports).",
+        "",
+    ].join("\n"));
+}
+async function cmdServeScenario(args) {
+    let parsed;
+    try {
+        parsed = parseArgs({
+            args,
+            options: {
+                "ws-port": { type: "string" },
+                "test-control-port": { type: "string" },
+                host: { type: "string", default: "127.0.0.1" },
+                help: { type: "boolean", short: "h" },
+            },
+            strict: true,
+            allowPositionals: false,
+        });
+    }
+    catch (err) {
+        process.stderr.write(`serve-scenario: ${err.message}\n`);
+        return 2;
+    }
+    if (parsed.values["help"]) {
+        process.stderr.write("serve-scenario --ws-port N --test-control-port M [--host H]\n");
+        return 0;
+    }
+    const wsPort = parseIntFlag(parsed.values["ws-port"], "--ws-port");
+    const controlPort = parseIntFlag(parsed.values["test-control-port"], "--test-control-port");
+    if (wsPort === null || controlPort === null)
+        return 2;
+    const host = parsed.values["host"] ?? "127.0.0.1";
+    // Bootstrap a synthetic scene + empty bundle provider. Both are immediately
+    // overridden by the first POST /test/setup.
+    const initialScene = createScene({
+        sceneId: "__interop_initial__",
+        sceneVersion: "sha256:" + "0".repeat(64),
+        initialState: {},
+    });
+    const auth = new StaticTokens();
+    let server;
+    let control;
+    try {
+        server = await startServer({
+            port: wsPort,
+            host,
+            scene: initialScene,
+            bundleProvider: () => undefined,
+            authenticate: auth.authenticate,
+        });
+    }
+    catch (err) {
+        process.stderr.write(`serve-scenario: bind ws: ${err.message}\n`);
+        return 1;
+    }
+    try {
+        control = await startTestControl({
+            port: controlPort,
+            host,
+            server,
+            auth,
+        });
+    }
+    catch (err) {
+        await server.close();
+        process.stderr.write(`serve-scenario: bind control: ${err.message}\n`);
+        return 1;
+    }
+    // Discovery line — written before any other stdout output. The matrix
+    // driver greps for "control_url" to know we're ready.
+    process.stdout.write(JSON.stringify({
+        control_url: control.url,
+        ws_url: server.wsUrl,
+    }) + "\n");
+    let shutdown = async () => {
+        shutdown = null;
+        process.stderr.write("[lumencast-js] shutting down\n");
+        try {
+            await control.close();
+        }
+        catch {
+            // ignore
+        }
+        try {
+            await server.close();
+        }
+        catch {
+            // ignore
+        }
+    };
+    process.on("SIGINT", () => void shutdown?.());
+    process.on("SIGTERM", () => void shutdown?.());
+    await new Promise((resolve) => {
+        const tick = () => {
+            if (shutdown === null)
+                resolve();
+            else
+                setTimeout(tick, 100);
+        };
+        tick();
+    });
+    return 0;
+}
+function parseIntFlag(raw, name) {
+    if (typeof raw !== "string") {
+        process.stderr.write(`${name} required\n`);
+        return null;
+    }
+    const n = Number.parseInt(raw, 10);
+    if (!Number.isFinite(n) || n < 0 || n > 65535) {
+        process.stderr.write(`${name}: invalid port\n`);
+        return null;
+    }
+    return n;
+}
+main(process.argv.slice(2)).then((code) => {
+    process.exitCode = code;
+}, (err) => {
+    process.stderr.write(`lumencast-js: ${err.stack ?? String(err)}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { startServer, type ServerConfig, type ServerHandle } from "./server.js";
+export { createScene, type Scene, type SceneInit } from "./scene.js";
+export { LeafStore, type LeafStoreListener } from "./store.js";
+export { defaultAuthenticate, canWritePath, StaticTokens, type Authenticate, type AuthDecision, type Role, } from "./auth.js";
+export { startHttpPoll, type HttpPollOptions } from "./adapters/http-poll.js";
+export { startTestControl, installTokens, type TestControlOptions, type TestControlHandle, } from "./test-control.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,KAAK,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,IAAI,GACV,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,aAAa,EAAE,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,GACvB,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+// Public surface of @lumencast/server.
+export { startServer } from "./server.js";
+export { createScene } from "./scene.js";
+export { LeafStore } from "./store.js";
+export { defaultAuthenticate, canWritePath, StaticTokens, } from "./auth.js";
+export { startHttpPoll } from "./adapters/http-poll.js";
+export { startTestControl, installTokens, } from "./test-control.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AAEvC,OAAO,EAAE,WAAW,EAAwC,MAAM,aAAa,CAAC;AAChF,OAAO,EAAE,WAAW,EAA8B,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,SAAS,EAA0B,MAAM,YAAY,CAAC;AAC/D,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,YAAY,GAIb,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,aAAa,EAAwB,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EACL,gBAAgB,EAChB,aAAa,GAGd,MAAM,mBAAmB,CAAC"}

package/dist/replay-buffer.d.ts

@@ -0,0 +1,32 @@
+import type { Cause, Patch } from "@lumencast/protocol";
+export interface ReplayRecord {
+    readonly seq: number;
+    readonly patches: Patch[];
+    readonly cause?: Cause;
+}
+/** Default capacity (LSDP/1.1 §18.1 SHOULD ≥ 256). */
+export declare const DEFAULT_REPLAY_BUFFER_SIZE = 256;
+export declare class ReplayBuffer {
+    private readonly cap;
+    private readonly records;
+    private head;
+    private size;
+    constructor(capacity?: number);
+    /** Record one emission. Caller is responsible for monotonic seq. */
+    push(record: ReplayRecord): void;
+    /**
+     * Return every record with seq > sinceSeq, in monotonic order.
+     *
+     * The boolean is `false` when sinceSeq is older than the buffer's
+     * earliest retained entry — the caller MUST then fall back to a
+     * fresh snapshot per LSDP/1.1 §18.1.
+     */
+    since(sinceSeq: number): {
+        records: ReplayRecord[];
+        covered: boolean;
+    };
+    /** Clear the buffer. Used on scene_changed. */
+    reset(): void;
+    get length(): number;
+}
+//# sourceMappingURL=replay-buffer.d.ts.map

package/dist/replay-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay-buffer.d.ts","sourceRoot":"","sources":["../src/replay-buffer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;CACxB;AAED,sDAAsD;AACtD,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAE9C,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IACvD,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,IAAI,CAAK;gBAEL,QAAQ,SAA6B;IAKjD,oEAAoE;IACpE,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAMhC;;;;;;OAMG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,YAAY,EAAE,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE;IAoBtE,+CAA+C;IAC/C,KAAK,IAAI,IAAI;IAMb,IAAI,MAAM,IAAI,MAAM,CAEnB;CACF"}

package/dist/replay-buffer.js

@@ -0,0 +1,60 @@
+// Per-scene replay buffer (LSDP/1.1 §18.1).
+// Bounded ring of recent (seq, patches, cause) emissions so a 1.1
+// client reconnecting with `since_sequence` can resume without a fresh
+// snapshot.
+/** Default capacity (LSDP/1.1 §18.1 SHOULD ≥ 256). */
+export const DEFAULT_REPLAY_BUFFER_SIZE = 256;
+export class ReplayBuffer {
+    cap;
+    records;
+    head = 0;
+    size = 0;
+    constructor(capacity = DEFAULT_REPLAY_BUFFER_SIZE) {
+        this.cap = capacity > 0 ? capacity : DEFAULT_REPLAY_BUFFER_SIZE;
+        this.records = new Array(this.cap);
+    }
+    /** Record one emission. Caller is responsible for monotonic seq. */
+    push(record) {
+        this.records[this.head] = record;
+        this.head = (this.head + 1) % this.cap;
+        if (this.size < this.cap)
+            this.size++;
+    }
+    /**
+     * Return every record with seq > sinceSeq, in monotonic order.
+     *
+     * The boolean is `false` when sinceSeq is older than the buffer's
+     * earliest retained entry — the caller MUST then fall back to a
+     * fresh snapshot per LSDP/1.1 §18.1.
+     */
+    since(sinceSeq) {
+        if (this.size === 0) {
+            // Empty buffer — caller decides whether sinceSeq matches the
+            // current scene seq (caught up) or warrants a snapshot.
+            return { records: [], covered: true };
+        }
+        const tail = (this.head - this.size + this.cap) % this.cap;
+        const earliest = this.records[tail].seq;
+        if (sinceSeq + 1 < earliest) {
+            return { records: [], covered: false };
+        }
+        const out = [];
+        for (let i = 0; i < this.size; i++) {
+            const idx = (tail + i) % this.cap;
+            const r = this.records[idx];
+            if (r.seq > sinceSeq)
+                out.push(r);
+        }
+        return { records: out, covered: true };
+    }
+    /** Clear the buffer. Used on scene_changed. */
+    reset() {
+        this.head = 0;
+        this.size = 0;
+        this.records.fill(undefined);
+    }
+    get length() {
+        return this.size;
+    }
+}
+//# sourceMappingURL=replay-buffer.js.map

package/dist/replay-buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay-buffer.js","sourceRoot":"","sources":["../src/replay-buffer.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,kEAAkE;AAClE,uEAAuE;AACvE,YAAY;AAUZ,sDAAsD;AACtD,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,CAAC;AAE9C,MAAM,OAAO,YAAY;IACN,GAAG,CAAS;IACZ,OAAO,CAA+B;IAC/C,IAAI,GAAG,CAAC,CAAC;IACT,IAAI,GAAG,CAAC,CAAC;IAEjB,YAAY,QAAQ,GAAG,0BAA0B;QAC/C,IAAI,CAAC,GAAG,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,0BAA0B,CAAC;QAChE,IAAI,CAAC,OAAO,GAAG,IAAI,KAAK,CAA2B,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/D,CAAC;IAED,oEAAoE;IACpE,IAAI,CAAC,MAAoB;QACvB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC;QACvC,IAAI,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG;YAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IACxC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,QAAgB;QACpB,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACpB,6DAA6D;YAC7D,wDAAwD;YACxD,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACxC,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC;QAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAE,CAAC,GAAG,CAAC;QACzC,IAAI,QAAQ,GAAG,CAAC,GAAG,QAAQ,EAAE,CAAC;YAC5B,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACzC,CAAC;QACD,MAAM,GAAG,GAAmB,EAAE,CAAC;QAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;YACnC,MAAM,GAAG,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC;YAClC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAE,CAAC;YAC7B,IAAI,CAAC,CAAC,GAAG,GAAG,QAAQ;gBAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACzC,CAAC;IAED,+CAA+C;IAC/C,KAAK;QACH,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACd,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACd,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/scene.d.ts

@@ -0,0 +1,67 @@
+import type { Cause, LeafPath, LeafValue, Patch, SceneId, SceneVersion } from "@lumencast/protocol";
+import { LeafStore } from "./store.js";
+import { type ReplayRecord } from "./replay-buffer.js";
+export interface OperatorInputDecl {
+    path: LeafPath;
+    /** "string" | "number" | "boolean" | "enum" | ... — see LSML 1.0 §8. */
+    type: string;
+    /** Type-specific constraints — currently maxLength, minLength, min, max, pattern. */
+    constraints?: {
+        maxLength?: number;
+        minLength?: number;
+        min?: number;
+        max?: number;
+        pattern?: string;
+    };
+    values?: unknown[];
+    writable_by?: string[];
+    [extra: string]: unknown;
+}
+export interface SceneInit {
+    sceneId: SceneId;
+    sceneVersion: SceneVersion;
+    initialState?: Record<LeafPath, LeafValue>;
+    /** Declared operator inputs. When set, `validateInput` enforces the schema. */
+    operatorInputs?: OperatorInputDecl[];
+}
+export type ValidationError = {
+    code: "UNKNOWN_PATH";
+    path: LeafPath;
+    message: string;
+} | {
+    code: "INVALID_VALUE";
+    path: LeafPath;
+    message: string;
+};
+export interface Scene {
+    readonly sceneId: SceneId;
+    readonly sceneVersion: SceneVersion;
+    readonly store: LeafStore;
+    readonly operatorInputs: OperatorInputDecl[];
+    /** Update one or more leaves. Atomic per call. Optional `cause` propagates
+     * to subscribers as the resulting Delta.cause (LSDP/1.1 §3.2.3). */
+    update(patches: Patch[] | Record<LeafPath, LeafValue>, cause?: Cause): void;
+    /** Subscribe to all patches emitted by this scene. The listener receives
+     * the per-scene `seq` (LSDP/1.1 §18.1.1) — the same value across all
+     * concurrent listeners on a given delta. */
+    onPatches(listener: (seq: number, patches: Patch[], cause?: Cause) => void): () => void;
+    /** Current per-scene seq counter (LSDP/1.1 §18.1.1). 1 on a fresh
+     * scene ; increments on every emit. Late-joining subscribers ship
+     * snapshot at this value. */
+    currentSeq(): number;
+    /** Replay records strictly after `sinceSeq` for §18.1 resume.
+     * Returns `covered: false` when sinceSeq is older than the buffer's
+     * earliest entry — the caller MUST fall back to a fresh snapshot. */
+    replaySince(sinceSeq: number): {
+        records: ReplayRecord[];
+        covered: boolean;
+    };
+    /**
+     * Validate input patches against the declared operator_inputs schema.
+     * Returns the first error or null. The reserved `__test.*` namespace is
+     * always permitted (test sessions own that namespace per LSDP/1 §10).
+     */
+    validateInput(patches: Patch[]): ValidationError | null;
+}
+export declare function createScene(init: SceneInit): Scene;
+//# sourceMappingURL=scene.d.ts.map

package/dist/scene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../src/scene.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACpG,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAA4C,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEjG,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,QAAQ,CAAC;IACf,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,WAAW,CAAC,EAAE;QACZ,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,YAAY,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC3C,+EAA+E;IAC/E,cAAc,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACtC;AAED,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/D,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,iBAAiB,EAAE,CAAC;IAC7C;wEACoE;IACpE,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IAC5E;;gDAE4C;IAC5C,SAAS,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACxF;;iCAE6B;IAC7B,UAAU,IAAI,MAAM,CAAC;IACrB;;yEAEqE;IACrE,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,YAAY,EAAE,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAC7E;;;;OAIG;IACH,aAAa,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,eAAe,GAAG,IAAI,CAAC;CACzD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,KAAK,CAiElD"}

package/dist/scene.js

@@ -0,0 +1,109 @@
+// Scene — the server's authoritative view of one Lumencast scene.
+// Wraps a LeafStore + identity (sceneId, sceneVersion) and an optional
+// operator_inputs schema used by the server to validate `input` frames.
+import { LeafStore } from "./store.js";
+import { DEFAULT_REPLAY_BUFFER_SIZE, ReplayBuffer } from "./replay-buffer.js";
+export function createScene(init) {
+    const store = new LeafStore(init.initialState ?? {});
+    const operatorInputs = init.operatorInputs ?? [];
+    const inputsByPath = new Map();
+    for (const oi of operatorInputs)
+        inputsByPath.set(oi.path, oi);
+    // LSDP/1.1 §18.1.1 — per-scene monotonic seq. Pre-seeded to 1 so the
+    // very first subscriber's snapshot ships at seq=1 (matches every
+    // existing 1.0 conformance scenario). Subsequent emits increment.
+    let seq = 1;
+    const replay = new ReplayBuffer(DEFAULT_REPLAY_BUFFER_SIZE);
+    const sceneListeners = new Set();
+    // Bridge LeafStore.onPatches → scene listeners. Single store listener
+    // increments `seq`, records to the buffer, fans out to scene listeners.
+    store.onPatches((patches, cause) => {
+        seq += 1;
+        replay.push({ seq, patches: patches.slice(), cause });
+        for (const l of sceneListeners)
+            l(seq, patches, cause);
+    });
+    function update(input, cause) {
+        const patches = Array.isArray(input)
+            ? input
+            : Object.entries(input).map(([path, value]) => ({ path, value }));
+        store.apply(patches, cause);
+    }
+    function validateInput(patches) {
+        // No declared schema → server accepts any path (legacy / dev-mode behavior).
+        if (operatorInputs.length === 0)
+            return null;
+        for (const p of patches) {
+            if (p.path.startsWith("__test."))
+                continue; // test namespace bypass
+            const decl = inputsByPath.get(p.path);
+            if (!decl) {
+                return {
+                    code: "UNKNOWN_PATH",
+                    path: p.path,
+                    message: `path ${p.path} not declared in operator_inputs`,
+                };
+            }
+            const err = checkConstraint(decl, p.value);
+            if (err)
+                return { code: "INVALID_VALUE", path: p.path, message: err };
+        }
+        return null;
+    }
+    return {
+        sceneId: init.sceneId,
+        sceneVersion: init.sceneVersion,
+        store,
+        operatorInputs,
+        update,
+        onPatches: (listener) => {
+            sceneListeners.add(listener);
+            return () => {
+                sceneListeners.delete(listener);
+            };
+        },
+        currentSeq: () => seq,
+        replaySince: (sinceSeq) => replay.since(sinceSeq),
+        validateInput,
+    };
+}
+function checkConstraint(decl, value) {
+    switch (decl.type) {
+        case "string":
+        case "text":
+            if (typeof value !== "string")
+                return `expected string, got ${typeof value}`;
+            if (decl.constraints?.maxLength !== undefined && value.length > decl.constraints.maxLength) {
+                return `exceeds maxLength ${decl.constraints.maxLength}`;
+            }
+            if (decl.constraints?.minLength !== undefined && value.length < decl.constraints.minLength) {
+                return `below minLength ${decl.constraints.minLength}`;
+            }
+            if (decl.constraints?.pattern && !new RegExp(decl.constraints.pattern).test(value)) {
+                return `does not match pattern`;
+            }
+            return null;
+        case "number":
+            if (typeof value !== "number")
+                return `expected number, got ${typeof value}`;
+            if (decl.constraints?.min !== undefined && value < decl.constraints.min) {
+                return `below min ${decl.constraints.min}`;
+            }
+            if (decl.constraints?.max !== undefined && value > decl.constraints.max) {
+                return `above max ${decl.constraints.max}`;
+            }
+            return null;
+        case "boolean":
+            if (typeof value !== "boolean")
+                return `expected boolean, got ${typeof value}`;
+            return null;
+        case "enum":
+            if (decl.values && !decl.values.includes(value)) {
+                return `not in enum`;
+            }
+            return null;
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=scene.js.map

package/dist/scene.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene.js","sourceRoot":"","sources":["../src/scene.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,uEAAuE;AACvE,wEAAwE;AAGxE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,0BAA0B,EAAE,YAAY,EAAqB,MAAM,oBAAoB,CAAC;AA2DjG,MAAM,UAAU,WAAW,CAAC,IAAe;IACzC,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;IACrD,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,IAAI,EAAE,CAAC;IACjD,MAAM,YAAY,GAAG,IAAI,GAAG,EAA+B,CAAC;IAC5D,KAAK,MAAM,EAAE,IAAI,cAAc;QAAE,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAE/D,qEAAqE;IACrE,iEAAiE;IACjE,kEAAkE;IAClE,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,0BAA0B,CAAC,CAAC;IAE5D,MAAM,cAAc,GAAG,IAAI,GAAG,EAAiB,CAAC;IAEhD,sEAAsE;IACtE,wEAAwE;IACxE,KAAK,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;QACjC,GAAG,IAAI,CAAC,CAAC;QACT,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACtD,KAAK,MAAM,CAAC,IAAI,cAAc;YAAE,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,SAAS,MAAM,CAAC,KAA4C,EAAE,KAAa;QACzE,MAAM,OAAO,GAAY,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAC3C,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QACpE,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,SAAS,aAAa,CAAC,OAAgB;QACrC,6EAA6E;QAC7E,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAE7C,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;gBAAE,SAAS,CAAC,wBAAwB;YACpE,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACtC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO;oBACL,IAAI,EAAE,cAAc;oBACpB,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,OAAO,EAAE,QAAQ,CAAC,CAAC,IAAI,kCAAkC;iBAC1D,CAAC;YACJ,CAAC;YACD,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;YAC3C,IAAI,GAAG;gBAAE,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;QACxE,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,KAAK;QACL,cAAc;QACd,MAAM;QACN,SAAS,EAAE,CAAC,QAAQ,EAAE,EAAE;YACtB,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC7B,OAAO,GAAG,EAAE;gBACV,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAClC,CAAC,CAAC;QACJ,CAAC;QACD,UAAU,EAAE,GAAG,EAAE,CAAC,GAAG;QACrB,WAAW,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC;QACjD,aAAa;KACd,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,IAAuB,EAAE,KAAc;IAC9D,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,QAAQ,CAAC;QACd,KAAK,MAAM;YACT,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,wBAAwB,OAAO,KAAK,EAAE,CAAC;YAC7E,IAAI,IAAI,CAAC,WAAW,EAAE,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC;gBAC3F,OAAO,qBAAqB,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC;YAC3D,CAAC;YACD,IAAI,IAAI,CAAC,WAAW,EAAE,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC;gBAC3F,OAAO,mBAAmB,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC;YACzD,CAAC;YACD,IAAI,IAAI,CAAC,WAAW,EAAE,OAAO,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBACnF,OAAO,wBAAwB,CAAC;YAClC,CAAC;YACD,OAAO,IAAI,CAAC;QACd,KAAK,QAAQ;YACX,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,wBAAwB,OAAO,KAAK,EAAE,CAAC;YAC7E,IAAI,IAAI,CAAC,WAAW,EAAE,GAAG,KAAK,SAAS,IAAI,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC;gBACxE,OAAO,aAAa,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC;YAC7C,CAAC;YACD,IAAI,IAAI,CAAC,WAAW,EAAE,GAAG,KAAK,SAAS,IAAI,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC;gBACxE,OAAO,aAAa,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC;YAC7C,CAAC;YACD,OAAO,IAAI,CAAC;QACd,KAAK,SAAS;YACZ,IAAI,OAAO,KAAK,KAAK,SAAS;gBAAE,OAAO,yBAAyB,OAAO,KAAK,EAAE,CAAC;YAC/E,OAAO,IAAI,CAAC;QACd,KAAK,MAAM;YACT,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAChD,OAAO,aAAa,CAAC;YACvB,CAAC;YACD,OAAO,IAAI,CAAC;QACd;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,38 @@
+import { type SceneVersion } from "@lumencast/protocol";
+import { type Authenticate } from "./auth.js";
+import type { Scene } from "./scene.js";
+export interface ServerConfig {
+    /** TCP port to listen on. 0 = random. */
+    port?: number;
+    /** Hostname to bind. Defaults to 127.0.0.1. */
+    host?: string;
+    /** The initial scene this server serves. May be swapped via setActiveScene(). */
+    scene: Scene;
+    /** Resolves a SceneVersion to its LSML bundle JSON. May be swapped. */
+    bundleProvider: (version: SceneVersion) => Promise<unknown> | unknown;
+    /** Authenticate every subscribe; default accepts everything as `viewer`. */
+    authenticate?: Authenticate;
+    /** Optional ws path. Defaults to `/lsdp/v1`. */
+    wsPath?: string;
+    /** Optional bundle path prefix. Defaults to `/lsdp/v1/scenes`. */
+    bundlePathPrefix?: string;
+}
+export interface ServerHandle {
+    readonly wsUrl: string;
+    readonly httpUrl: string;
+    /**
+     * Replace the active scene. Detaches every subscriber (they receive a 1012
+     * "service restart" close so well-behaved clients reconnect cleanly).
+     * Test/interop only — production code should never call this.
+     */
+    setActiveScene(scene: Scene): void;
+    /** Replace the bundle provider. Test/interop only. */
+    setBundleProvider(fn: (version: SceneVersion) => Promise<unknown> | unknown): void;
+    /** Read the current active scene. */
+    activeScene(): Scene;
+    /** Drop all subscribers without replacing the scene. Test/interop only. */
+    reset(): void;
+    close(): Promise<void>;
+}
+export declare function startServer(config: ServerConfig): Promise<ServerHandle>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAeA,OAAO,EAcL,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAqC,KAAK,YAAY,EAAqB,MAAM,WAAW,CAAC;AACpG,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,WAAW,YAAY;IAC3B,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,KAAK,EAAE,KAAK,CAAC;IACb,uEAAuE;IACvE,cAAc,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IACtE,4EAA4E;IAC5E,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACnC,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,IAAI,CAAC;IACnF,qCAAqC;IACrC,WAAW,IAAI,KAAK,CAAC;IACrB,2EAA2E;IAC3E,KAAK,IAAI,IAAI,CAAC;IACd,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAUD,wBAAsB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CA8S7E"}