@rydr/game-sdk 1.7.0

package/dist/client/PlatformClient.js

@@ -0,0 +1,374 @@
+/**
+ * The game-side entry point to the RYDR platform.
+ *
+ * `connectToPlatform()` performs the handshake with the embedding shell and
+ * resolves to a {@link PlatformSession}: a reactive hardware store, the scoped
+ * identity, and trainer-control commands. A game uses only this — it never
+ * touches `postMessage`, BLE, or PII directly.
+ */
+import { RYDR_PROTOCOL_VERSION, RYDR_SDK_VERSION } from "../protocol/version";
+import { ALL_CAPABILITIES } from "../protocol/capabilities";
+import { decodeReplay, encodeReplay } from "./replayCodec";
+import { isPlatformToGameMessage } from "../protocol/guards";
+import { HardwareStore } from "./HardwareStore";
+import { createRelayRoom, createLoopbackRoom } from "./Room";
+function emit(set, value) {
+    for (const cb of set)
+        cb(value);
+}
+/**
+ * Connect to the embedding platform shell.
+ *
+ * Sends `hello` (retrying until the shell answers, to survive a not-yet-ready
+ * parent) and resolves once `welcome` arrives, or rejects on `reject`/timeout.
+ */
+export function connectToPlatform(options) {
+    const { gameId, capabilities = [...ALL_CAPABILITIES], platformOrigin = "*", target = window.parent, handshakeTimeoutMs = 15_000, } = options;
+    const hardware = new HardwareStore();
+    const buttonListeners = new Set();
+    const pauseListeners = new Set();
+    const resumeListeners = new Set();
+    const identityListeners = new Set();
+    // Generic request/response over postMessage: each request carries a `nonce`;
+    // the shell replies with a `*Result` message carrying the same nonce, which
+    // resolves the pending promise. Shared by submitScore + getLeaderboard.
+    const pending = new Map();
+    // Active relayed rooms keyed by roomId; the shell forwards room events which we route to dispatch.
+    const rooms = new Map();
+    let nextNonce = 1;
+    const REQUEST_TIMEOUT_MS = 10_000;
+    const request = (send) => {
+        const nonce = nextNonce++;
+        return new Promise((resolveReq, rejectReq) => {
+            const timer = setTimeout(() => {
+                pending.delete(nonce);
+                rejectReq(new Error("Platform request timed out"));
+            }, REQUEST_TIMEOUT_MS);
+            pending.set(nonce, (value) => {
+                clearTimeout(timer);
+                pending.delete(nonce);
+                resolveReq(value);
+            });
+            send(nonce);
+        });
+    };
+    const post = (message) => {
+        target.postMessage(message, platformOrigin);
+    };
+    // gamedata helpers (relayed req/res). The shell replies with one GameDataResultMessage;
+    // get→doc, list→docs, save/delete→ok, and `error` rejects.
+    const throwIfError = (r) => {
+        if (r.error)
+            throw new Error(`[rydr-sdk] gamedata: ${r.error}`);
+        return r;
+    };
+    const gamedataGet = (scope, collection, id) => request((nonce) => post({ rydr: true, type: "rydr/gamedata.get", nonce, scope, collection, id })).then(throwIfError).then((r) => r.doc ?? null);
+    const gamedataList = (scope, collection) => request((nonce) => post({ rydr: true, type: "rydr/gamedata.list", nonce, scope, collection })).then(throwIfError).then((r) => r.docs ?? []);
+    // replay helper (relayed req/res). save→ok, get→blob+meta; `error` rejects.
+    const replayGet = (runId) => request((nonce) => post({ rydr: true, type: "rydr/replay.get", nonce, runId })).then((r) => {
+        if (r.error)
+            throw new Error(`[rydr-sdk] getReplay: ${r.error}`);
+        return r.blob ? { blob: r.blob, meta: r.meta ?? null } : null;
+    });
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        let identity = null;
+        let grantedCapabilities = [];
+        let initialPath;
+        let boards = [];
+        let runId = "";
+        let dataHost = "";
+        const knownBoard = (boardId) => {
+            const ok = boards.some((b) => b.id === boardId);
+            if (!ok)
+                console.warn(`[rydr-sdk] unknown boardId "${boardId}" — not in the game's manifest boards`);
+            return ok;
+        };
+        const onMessage = (event) => {
+            if (platformOrigin !== "*" && event.origin !== platformOrigin)
+                return;
+            const msg = event.data;
+            if (!isPlatformToGameMessage(msg))
+                return;
+            switch (msg.type) {
+                case "rydr/welcome": {
+                    if (settled)
+                        return;
+                    settled = true;
+                    clearInterval(helloTimer);
+                    clearTimeout(timeoutTimer);
+                    const welcome = msg;
+                    identity = welcome.identity;
+                    grantedCapabilities = welcome.grantedCapabilities;
+                    initialPath = welcome.initialPath;
+                    boards = welcome.boards ?? [];
+                    runId = welcome.runId ?? "";
+                    dataHost = welcome.dataHost ?? "";
+                    resolve(session);
+                    break;
+                }
+                case "rydr/reject": {
+                    if (settled)
+                        return;
+                    settled = true;
+                    clearInterval(helloTimer);
+                    clearTimeout(timeoutTimer);
+                    window.removeEventListener("message", onMessage);
+                    reject(new Error(`Platform rejected handshake: ${msg.reason}`));
+                    break;
+                }
+                case "rydr/hw.power":
+                    hardware._patch({ power: msg.watts, updatedAt: msg.t });
+                    break;
+                case "rydr/hw.cadence":
+                    hardware._patch({ cadence: msg.rpm, updatedAt: msg.t });
+                    break;
+                case "rydr/hw.heartRate":
+                    hardware._patch({ heartRate: msg.bpm, updatedAt: msg.t });
+                    break;
+                case "rydr/hw.speed":
+                    hardware._patch({ speed: msg.mps, updatedAt: msg.t });
+                    break;
+                case "rydr/hw.powerBuffer": {
+                    const last = msg.samples[msg.samples.length - 1];
+                    if (last)
+                        hardware._patch({ power: last.watts, cadence: last.cadence ?? hardware.current.cadence, updatedAt: last.t });
+                    break;
+                }
+                case "rydr/input.button":
+                    emit(buttonListeners, { name: msg.name, edge: msg.edge });
+                    break;
+                case "rydr/identity.update":
+                    identity = msg.identity;
+                    emit(identityListeners, msg.identity);
+                    break;
+                case "rydr/trainer.status":
+                    hardware._patch({ trainerConnected: msg.connected, ergSupported: msg.ergSupported });
+                    break;
+                case "rydr/lifecycle.pause":
+                    emit(pauseListeners, undefined);
+                    break;
+                case "rydr/lifecycle.resume":
+                    emit(resumeListeners, undefined);
+                    break;
+                case "rydr/ping":
+                    post({ rydr: true, type: "rydr/pong", nonce: msg.nonce });
+                    break;
+                case "rydr/leaderboard.submitResult":
+                    pending.get(msg.nonce)?.(msg.result);
+                    break;
+                case "rydr/leaderboard.queryResult":
+                    pending.get(msg.nonce)?.({ entries: msg.entries, you: msg.you });
+                    break;
+                case "rydr/gamedata.result":
+                    pending.get(msg.nonce)?.(msg);
+                    break;
+                case "rydr/asset.uploadUrlResult":
+                    pending.get(msg.nonce)?.(msg);
+                    break;
+                case "rydr/replay.result":
+                    pending.get(msg.nonce)?.(msg);
+                    break;
+                case "rydr/run.result":
+                    pending.get(msg.nonce)?.(msg);
+                    break;
+                case "rydr/room.opened":
+                    rooms.get(msg.roomId)?.({ type: "rydr/room.opened" });
+                    break;
+                case "rydr/room.closed":
+                    rooms.get(msg.roomId)?.({ type: "rydr/room.closed" });
+                    rooms.delete(msg.roomId);
+                    break;
+                case "rydr/room.presence":
+                    rooms.get(msg.roomId)?.({ type: "rydr/room.presence", members: msg.members });
+                    break;
+                case "rydr/room.state":
+                    rooms.get(msg.roomId)?.({ type: "rydr/room.state", state: msg.state });
+                    break;
+                case "rydr/room.message":
+                    rooms.get(msg.roomId)?.({ type: "rydr/room.message", from: msg.from, data: msg.data });
+                    break;
+                case "rydr/room.telemetry":
+                    rooms.get(msg.roomId)?.({
+                        type: "rydr/room.telemetry",
+                        from: msg.from,
+                        power: msg.power,
+                        cadence: msg.cadence,
+                        heartRate: msg.heartRate,
+                        t: msg.t,
+                    });
+                    break;
+                case "rydr/room.event":
+                    rooms.get(msg.roomId)?.({
+                        type: "rydr/room.event",
+                        name: msg.name,
+                        payload: msg.payload,
+                        at: msg.at,
+                        from: msg.from,
+                    });
+                    break;
+            }
+        };
+        window.addEventListener("message", onMessage);
+        const sendHello = () => {
+            post({
+                rydr: true,
+                type: "rydr/hello",
+                gameId,
+                sdkVersion: RYDR_SDK_VERSION,
+                protocolVersion: RYDR_PROTOCOL_VERSION,
+                capabilities,
+            });
+        };
+        // Retry hello until the shell answers (it may not be listening on the first tick).
+        sendHello();
+        const helloTimer = setInterval(sendHello, 250);
+        const timeoutTimer = setTimeout(() => {
+            if (settled)
+                return;
+            settled = true;
+            clearInterval(helloTimer);
+            window.removeEventListener("message", onMessage);
+            reject(new Error("Platform handshake timed out"));
+        }, handshakeTimeoutMs);
+        const session = {
+            get identity() {
+                if (!identity)
+                    throw new Error("Session not established");
+                return identity;
+            },
+            get grantedCapabilities() {
+                return grantedCapabilities;
+            },
+            get initialPath() {
+                return initialPath;
+            },
+            get boards() {
+                return boards;
+            },
+            get runId() {
+                return runId;
+            },
+            get dataHost() {
+                return dataHost;
+            },
+            hardware,
+            ready: () => post({ rydr: true, type: "rydr/ready" }),
+            reportLoadProgress: (progress) => post({ rydr: true, type: "rydr/loadProgress", progress }),
+            setSimulation: (gradePercent) => post({ rydr: true, type: "rydr/trainer.setSimulation", gradePercent }),
+            setTargetPower: (watts) => post({ rydr: true, type: "rydr/trainer.setTargetPower", watts }),
+            setErgMode: (enabled) => post({ rydr: true, type: "rydr/trainer.setErgMode", enabled }),
+            submitScore: (boardId, value, opts) => {
+                knownBoard(boardId);
+                return request((nonce) => post({ rydr: true, type: "rydr/leaderboard.submit", nonce, boardId, value, key: opts?.key }));
+            },
+            getLeaderboard: (boardId, opts) => {
+                knownBoard(boardId);
+                return request((nonce) => post({ rydr: true, type: "rydr/leaderboard.query", nonce, boardId, key: opts?.key, limit: opts?.limit }));
+            },
+            saveRun: (breakdown) => post({ rydr: true, type: "rydr/run.save", breakdown }),
+            getRun: (runId) => request((nonce) => post({ rydr: true, type: "rydr/run.get", nonce, runId })).then((r) => {
+                if (r.error)
+                    throw new Error(`[rydr-sdk] getRun: ${r.error}`);
+                return r.breakdown ?? null;
+            }),
+            saveReplay: async (runId, frames, opts) => {
+                const { blob, meta } = await encodeReplay(frames, opts?.version ?? 1);
+                const r = await request((nonce) => post({ rydr: true, type: "rydr/replay.save", nonce, runId, blob, meta }));
+                if (r.error)
+                    throw new Error(`[rydr-sdk] saveReplay: ${r.error}`);
+            },
+            getReplay: async (runId) => {
+                const stored = await replayGet(runId);
+                if (!stored)
+                    return null;
+                const body = await decodeReplay(stored.blob);
+                if (!body)
+                    return null;
+                return { body, meta: stored.meta };
+            },
+            getReplays: async (boardId, opts) => {
+                knownBoard(boardId);
+                const page = await request((nonce) => post({ rydr: true, type: "rydr/leaderboard.query", nonce, boardId, key: opts?.key, limit: opts?.top ?? 10 }));
+                // Each ranked entry that carries a runId maps to a (possibly absent) stored replay.
+                const ranked = page.entries.filter((e) => !!e.runId);
+                return Promise.all(ranked.map(async (e) => {
+                    const stored = await replayGet(e.runId);
+                    return {
+                        runId: e.runId,
+                        rank: e.rank,
+                        displayName: e.displayName,
+                        value: e.value,
+                        blob: stored?.blob ?? null,
+                        meta: stored?.meta ?? null,
+                    };
+                }));
+            },
+            getContent: (collection, id) => gamedataGet("shared", collection, id),
+            listContent: (collection) => gamedataList("shared", collection),
+            getData: (collection, id, opts) => gamedataGet(opts?.scope ?? "player", collection, id),
+            listData: (collection, opts) => gamedataList(opts?.scope ?? "player", collection),
+            saveData: (collection, id, value, opts) => request((nonce) => post({ rydr: true, type: "rydr/gamedata.save", nonce, scope: opts?.scope ?? "player", collection, id, data: value })).then(throwIfError).then(() => undefined),
+            deleteData: (collection, id, opts) => request((nonce) => post({ rydr: true, type: "rydr/gamedata.delete", nonce, scope: opts?.scope ?? "player", collection, id })).then(throwIfError).then(() => undefined),
+            saveContent: (collection, id, value) => request((nonce) => post({ rydr: true, type: "rydr/gamedata.save", nonce, scope: "shared", collection, id, data: value })).then(throwIfError).then(() => undefined),
+            deleteContent: (collection, id) => request((nonce) => post({ rydr: true, type: "rydr/gamedata.delete", nonce, scope: "shared", collection, id })).then(throwIfError).then(() => undefined),
+            getUploadUrl: (opts) => request((nonce) => post({ rydr: true, type: "rydr/asset.uploadUrl", nonce, collection: opts.collection, filename: opts.filename, contentType: opts.contentType })).then((r) => {
+                if (r.error || !r.uploadUrl || !r.url)
+                    throw new Error(`[rydr-sdk] getUploadUrl: ${r.error ?? "no url"}`);
+                return { uploadUrl: r.uploadUrl, url: r.url };
+            }),
+            joinRoom: (roomId) => {
+                if (!identity)
+                    throw new Error("[rydr-sdk] joinRoom: session not established");
+                // No shell-backed rooms (standalone dev / shell didn't advertise a backend) → loopback.
+                if (!dataHost)
+                    return createLoopbackRoom(identity.playerId, identity.displayName);
+                // Shell-relayed room: the shell owns the socket (trusted identity + telemetry).
+                const existing = rooms.get(roomId);
+                if (existing)
+                    console.warn(`[rydr-sdk] joinRoom("${roomId}") called twice — re-joining`);
+                const { handle, dispatch } = createRelayRoom({
+                    roomId,
+                    post,
+                    onLeave: () => rooms.delete(roomId),
+                });
+                rooms.set(roomId, dispatch);
+                return handle;
+            },
+            setRoute: (path) => post({ rydr: true, type: "rydr/route.changed", path }),
+            setChrome: (visible) => post({ rydr: true, type: "rydr/ui.setChrome", visible }),
+            setPowerBar: (visible) => post({ rydr: true, type: "rydr/ui.setPowerBar", visible }),
+            requestExit: () => post({ rydr: true, type: "rydr/exitRequest" }),
+            requestHardwareModal: () => post({ rydr: true, type: "rydr/ui.requestHardwareModal" }),
+            reportError: (message) => post({ rydr: true, type: "rydr/error", message }),
+            onButton: (cb) => {
+                buttonListeners.add(cb);
+                return () => buttonListeners.delete(cb);
+            },
+            onPause: (cb) => {
+                pauseListeners.add(cb);
+                return () => pauseListeners.delete(cb);
+            },
+            onResume: (cb) => {
+                resumeListeners.add(cb);
+                return () => resumeListeners.delete(cb);
+            },
+            onIdentityChange: (cb) => {
+                identityListeners.add(cb);
+                return () => identityListeners.delete(cb);
+            },
+            dispose: () => {
+                clearInterval(helloTimer);
+                clearTimeout(timeoutTimer);
+                window.removeEventListener("message", onMessage);
+                buttonListeners.clear();
+                pauseListeners.clear();
+                resumeListeners.clear();
+                identityListeners.clear();
+                pending.clear();
+                rooms.clear();
+            },
+        };
+    });
+}
+//# sourceMappingURL=PlatformClient.js.map

package/dist/client/PlatformClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlatformClient.js","sourceRoot":"","sources":["../../src/client/PlatformClient.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAmB,MAAM,0BAA0B,CAAC;AAU7E,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAS3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAwC,MAAM,QAAQ,CAAC;AA+JnG,SAAS,IAAI,CAAI,GAAe,EAAE,KAAQ;IACxC,KAAK,MAAM,EAAE,IAAI,GAAG;QAAE,EAAE,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAuB;IACvD,MAAM,EACJ,MAAM,EACN,YAAY,GAAG,CAAC,GAAG,gBAAgB,CAAC,EACpC,cAAc,GAAG,GAAG,EACpB,MAAM,GAAG,MAAM,CAAC,MAAM,EACtB,kBAAkB,GAAG,MAAM,GAC5B,GAAG,OAAO,CAAC;IAEZ,MAAM,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;IACrC,MAAM,eAAe,GAAyB,IAAI,GAAG,EAAE,CAAC;IACxD,MAAM,cAAc,GAAkB,IAAI,GAAG,EAAE,CAAC;IAChD,MAAM,eAAe,GAAkB,IAAI,GAAG,EAAE,CAAC;IACjD,MAAM,iBAAiB,GAA4B,IAAI,GAAG,EAAE,CAAC;IAE7D,6EAA6E;IAC7E,4EAA4E;IAC5E,wEAAwE;IACxE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAoC,CAAC;IAC5D,mGAAmG;IACnG,MAAM,KAAK,GAAG,IAAI,GAAG,EAA2C,CAAC;IACjE,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,MAAM,kBAAkB,GAAG,MAAM,CAAC;IAClC,MAAM,OAAO,GAAG,CAAI,IAA6B,EAAc,EAAE;QAC/D,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;QAC1B,OAAO,IAAI,OAAO,CAAI,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE;YAC9C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACtB,SAAS,CAAC,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC,CAAC;YACrD,CAAC,EAAE,kBAAkB,CAAC,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE;gBAC3B,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACtB,UAAU,CAAC,KAAU,CAAC,CAAC;YACzB,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,KAAK,CAAC,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,MAAM,IAAI,GAAG,CAAC,OAA8B,EAAQ,EAAE;QACpD,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IAC9C,CAAC,CAAC;IAEF,wFAAwF;IACxF,2DAA2D;IAC3D,MAAM,YAAY,GAAG,CAAC,CAAwB,EAAyB,EAAE;QACvE,IAAI,CAAC,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAChE,OAAO,CAAC,CAAC;IACX,CAAC,CAAC;IACF,MAAM,WAAW,GAAG,CAAC,KAAoB,EAAE,UAAkB,EAAE,EAAU,EAA2B,EAAE,CACpG,OAAO,CAAwB,CAAC,KAAK,EAAE,EAAE,CACvC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAC9E,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;IAClD,MAAM,YAAY,GAAG,CAAC,KAAoB,EAAE,UAAkB,EAAsB,EAAE,CACpF,OAAO,CAAwB,CAAC,KAAK,EAAE,EAAE,CACvC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAC3E,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAEjD,4EAA4E;IAC5E,MAAM,SAAS,GAAG,CAAC,KAAa,EAA6D,EAAE,CAC7F,OAAO,CAAsB,CAAC,KAAK,EAAE,EAAE,CACrC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAC5D,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;QACX,IAAI,CAAC,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACjE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAChE,CAAC,CAAC,CAAC;IAEL,OAAO,IAAI,OAAO,CAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACtD,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,IAAI,QAAQ,GAA0B,IAAI,CAAC;QAC3C,IAAI,mBAAmB,GAA0B,EAAE,CAAC;QACpD,IAAI,WAA+B,CAAC;QACpC,IAAI,MAAM,GAA+B,EAAE,CAAC;QAC5C,IAAI,KAAK,GAAG,EAAE,CAAC;QACf,IAAI,QAAQ,GAAG,EAAE,CAAC;QAElB,MAAM,UAAU,GAAG,CAAC,OAAe,EAAW,EAAE;YAC9C,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;YAChD,IAAI,CAAC,EAAE;gBAAE,OAAO,CAAC,IAAI,CAAC,+BAA+B,OAAO,uCAAuC,CAAC,CAAC;YACrG,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QAEF,MAAM,SAAS,GAAG,CAAC,KAAmB,EAAQ,EAAE;YAC9C,IAAI,cAAc,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,KAAK,cAAc;gBAAE,OAAO;YACtE,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC;YACvB,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC;gBAAE,OAAO;YAE1C,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;gBACjB,KAAK,cAAc,CAAC,CAAC,CAAC;oBACpB,IAAI,OAAO;wBAAE,OAAO;oBACpB,OAAO,GAAG,IAAI,CAAC;oBACf,aAAa,CAAC,UAAU,CAAC,CAAC;oBAC1B,YAAY,CAAC,YAAY,CAAC,CAAC;oBAC3B,MAAM,OAAO,GAAG,GAAqB,CAAC;oBACtC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;oBAC5B,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC;oBAClD,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;oBAClC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;oBAC9B,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;oBAC5B,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;oBAClC,OAAO,CAAC,OAAO,CAAC,CAAC;oBACjB,MAAM;gBACR,CAAC;gBACD,KAAK,aAAa,CAAC,CAAC,CAAC;oBACnB,IAAI,OAAO;wBAAE,OAAO;oBACpB,OAAO,GAAG,IAAI,CAAC;oBACf,aAAa,CAAC,UAAU,CAAC,CAAC;oBAC1B,YAAY,CAAC,YAAY,CAAC,CAAC;oBAC3B,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;oBACjD,MAAM,CAAC,IAAI,KAAK,CAAC,gCAAgC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;oBAChE,MAAM;gBACR,CAAC;gBACD,KAAK,eAAe;oBAClB,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;oBACxD,MAAM;gBACR,KAAK,iBAAiB;oBACpB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;oBACxD,MAAM;gBACR,KAAK,mBAAmB;oBACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;oBAC1D,MAAM;gBACR,KAAK,eAAe;oBAClB,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;oBACtD,MAAM;gBACR,KAAK,qBAAqB,CAAC,CAAC,CAAC;oBAC3B,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;oBACjD,IAAI,IAAI;wBAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;oBACvH,MAAM;gBACR,CAAC;gBACD,KAAK,mBAAmB;oBACtB,IAAI,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;oBAC1D,MAAM;gBACR,KAAK,sBAAsB;oBACzB,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;oBACxB,IAAI,CAAC,iBAAiB,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;oBACtC,MAAM;gBACR,KAAK,qBAAqB;oBACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,EAAE,GAAG,CAAC,SAAS,EAAE,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC;oBACrF,MAAM;gBACR,KAAK,sBAAsB;oBACzB,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;oBAChC,MAAM;gBACR,KAAK,uBAAuB;oBAC1B,IAAI,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;oBACjC,MAAM;gBACR,KAAK,WAAW;oBACd,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;oBAC1D,MAAM;gBACR,KAAK,+BAA+B;oBAClC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;oBACrC,MAAM;gBACR,KAAK,8BAA8B;oBACjC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAqB,CAAC,CAAC;oBACpF,MAAM;gBACR,KAAK,sBAAsB;oBACzB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;oBAC9B,MAAM;gBACR,KAAK,4BAA4B;oBAC/B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;oBAC9B,MAAM;gBACR,KAAK,oBAAoB;oBACvB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;oBAC9B,MAAM;gBACR,KAAK,iBAAiB;oBACpB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;oBAC9B,MAAM;gBACR,KAAK,kBAAkB;oBACrB,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAC;oBACtD,MAAM;gBACR,KAAK,kBAAkB;oBACrB,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAC;oBACtD,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;oBACzB,MAAM;gBACR,KAAK,oBAAoB;oBACvB,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;oBAC9E,MAAM;gBACR,KAAK,iBAAiB;oBACpB,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;oBACvE,MAAM;gBACR,KAAK,mBAAmB;oBACtB,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;oBACvF,MAAM;gBACR,KAAK,qBAAqB;oBACxB,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;wBACtB,IAAI,EAAE,qBAAqB;wBAC3B,IAAI,EAAE,GAAG,CAAC,IAAI;wBACd,KAAK,EAAE,GAAG,CAAC,KAAK;wBAChB,OAAO,EAAE,GAAG,CAAC,OAAO;wBACpB,SAAS,EAAE,GAAG,CAAC,SAAS;wBACxB,CAAC,EAAE,GAAG,CAAC,CAAC;qBACT,CAAC,CAAC;oBACH,MAAM;gBACR,KAAK,iBAAiB;oBACpB,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;wBACtB,IAAI,EAAE,iBAAiB;wBACvB,IAAI,EAAE,GAAG,CAAC,IAAI;wBACd,OAAO,EAAE,GAAG,CAAC,OAAO;wBACpB,EAAE,EAAE,GAAG,CAAC,EAAE;wBACV,IAAI,EAAE,GAAG,CAAC,IAAI;qBACf,CAAC,CAAC;oBACH,MAAM;YACV,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAE9C,MAAM,SAAS,GAAG,GAAS,EAAE;YAC3B,IAAI,CAAC;gBACH,IAAI,EAAE,IAAI;gBACV,IAAI,EAAE,YAAY;gBAClB,MAAM;gBACN,UAAU,EAAE,gBAAgB;gBAC5B,eAAe,EAAE,qBAAqB;gBACtC,YAAY;aACb,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,mFAAmF;QACnF,SAAS,EAAE,CAAC;QACZ,MAAM,UAAU,GAAG,WAAW,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAC/C,MAAM,YAAY,GAAG,UAAU,CAAC,GAAG,EAAE;YACnC,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,aAAa,CAAC,UAAU,CAAC,CAAC;YAC1B,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YACjD,MAAM,CAAC,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC,CAAC;QACpD,CAAC,EAAE,kBAAkB,CAAC,CAAC;QAEvB,MAAM,OAAO,GAAoB;YAC/B,IAAI,QAAQ;gBACV,IAAI,CAAC,QAAQ;oBAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;gBAC1D,OAAO,QAAQ,CAAC;YAClB,CAAC;YACD,IAAI,mBAAmB;gBACrB,OAAO,mBAAmB,CAAC;YAC7B,CAAC;YACD,IAAI,WAAW;gBACb,OAAO,WAAW,CAAC;YACrB,CAAC;YACD,IAAI,MAAM;gBACR,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,IAAI,KAAK;gBACP,OAAO,KAAK,CAAC;YACf,CAAC;YACD,IAAI,QAAQ;gBACV,OAAO,QAAQ,CAAC;YAClB,CAAC;YACD,QAAQ;YACR,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;YACrD,kBAAkB,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,CAAC;YAC3F,aAAa,EAAE,CAAC,YAAY,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,4BAA4B,EAAE,YAAY,EAAE,CAAC;YACvG,cAAc,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,6BAA6B,EAAE,KAAK,EAAE,CAAC;YAC3F,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,yBAAyB,EAAE,OAAO,EAAE,CAAC;YACvF,WAAW,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACpC,UAAU,CAAC,OAAO,CAAC,CAAC;gBACpB,OAAO,OAAO,CAAoB,CAAC,KAAK,EAAE,EAAE,CAC1C,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,yBAAyB,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAC7F,CAAC;YACJ,CAAC;YACD,cAAc,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE;gBAChC,UAAU,CAAC,OAAO,CAAC,CAAC;gBACpB,OAAO,OAAO,CAAkB,CAAC,KAAK,EAAE,EAAE,CACxC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,wBAAwB,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CACzG,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC;YAC9E,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAChB,OAAO,CAAsB,CAAC,KAAK,EAAE,EAAE,CACrC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CACzD,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;gBACX,IAAI,CAAC,CAAC,KAAK;oBAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;gBAC9D,OAAO,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC;YAC7B,CAAC,CAAC;YACJ,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;gBACxC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,IAAI,CAAC,CAAC,CAAC;gBACtE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAsB,CAAC,KAAK,EAAE,EAAE,CACrD,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CACzE,CAAC;gBACF,IAAI,CAAC,CAAC,KAAK;oBAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YACpE,CAAC;YACD,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBACzB,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC;gBACtC,IAAI,CAAC,MAAM;oBAAE,OAAO,IAAI,CAAC;gBACzB,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBAC7C,IAAI,CAAC,IAAI;oBAAE,OAAO,IAAI,CAAC;gBACvB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;YACrC,CAAC;YACD,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;gBAClC,UAAU,CAAC,OAAO,CAAC,CAAC;gBACpB,MAAM,IAAI,GAAG,MAAM,OAAO,CAAkB,CAAC,KAAK,EAAE,EAAE,CACpD,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,wBAAwB,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC,CAC7G,CAAC;gBACF,oFAAoF;gBACpF,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAqC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;gBACxF,OAAO,OAAO,CAAC,GAAG,CAChB,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAsB,EAAE;oBACzC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;oBACxC,OAAO;wBACL,KAAK,EAAE,CAAC,CAAC,KAAK;wBACd,IAAI,EAAE,CAAC,CAAC,IAAI;wBACZ,WAAW,EAAE,CAAC,CAAC,WAAW;wBAC1B,KAAK,EAAE,CAAC,CAAC,KAAK;wBACd,IAAI,EAAE,MAAM,EAAE,IAAI,IAAI,IAAI;wBAC1B,IAAI,EAAE,MAAM,EAAE,IAAI,IAAI,IAAI;qBAC3B,CAAC;gBACJ,CAAC,CAAC,CACH,CAAC;YACJ,CAAC;YACD,UAAU,EAAE,CAAC,UAAU,EAAE,EAAE,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,CAAC;YACrE,WAAW,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,UAAU,CAAC;YAC/D,OAAO,EAAE,CAAC,UAAU,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,IAAI,QAAQ,EAAE,UAAU,EAAE,EAAE,CAAC;YACvF,QAAQ,EAAE,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,IAAI,QAAQ,EAAE,UAAU,CAAC;YACjF,QAAQ,EAAE,CAAC,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CACxC,OAAO,CAAwB,CAAC,KAAK,EAAE,EAAE,CACvC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CACrH,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;YAC5C,UAAU,EAAE,CAAC,UAAU,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,CACnC,OAAO,CAAwB,CAAC,KAAK,EAAE,EAAE,CACvC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,sBAAsB,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAC1G,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;YAC5C,WAAW,EAAE,CAAC,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,CACrC,OAAO,CAAwB,CAAC,KAAK,EAAE,EAAE,CACvC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CACtG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;YAC5C,aAAa,EAAE,CAAC,UAAU,EAAE,EAAE,EAAE,EAAE,CAChC,OAAO,CAAwB,CAAC,KAAK,EAAE,EAAE,CACvC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,sBAAsB,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAC3F,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;YAC5C,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CACrB,OAAO,CAA8B,CAAC,KAAK,EAAE,EAAE,CAC7C,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,sBAAsB,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAC/I,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;gBACX,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,GAAG;oBAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC,KAAK,IAAI,QAAQ,EAAE,CAAC,CAAC;gBAC1G,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;YAChD,CAAC,CAAC;YACJ,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE;gBACnB,IAAI,CAAC,QAAQ;oBAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;gBAC/E,wFAAwF;gBACxF,IAAI,CAAC,QAAQ;oBAAE,OAAO,kBAAkB,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;gBAClF,gFAAgF;gBAChF,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBACnC,IAAI,QAAQ;oBAAE,OAAO,CAAC,IAAI,CAAC,wBAAwB,MAAM,8BAA8B,CAAC,CAAC;gBACzF,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,eAAe,CAAC;oBAC3C,MAAM;oBACN,IAAI;oBACJ,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;iBACpC,CAAC,CAAC;gBACH,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;gBAC5B,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,CAAC;YAC1E,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,CAAC;YAChF,WAAW,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,CAAC;YACpF,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;YACjE,oBAAoB,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,8BAA8B,EAAE,CAAC;YACtF,WAAW,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;YAC3E,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE;gBACf,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACxB,OAAO,GAAG,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC1C,CAAC;YACD,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE;gBACd,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACvB,OAAO,GAAG,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACzC,CAAC;YACD,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE;gBACf,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACxB,OAAO,GAAG,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC1C,CAAC;YACD,gBAAgB,EAAE,CAAC,EAAE,EAAE,EAAE;gBACvB,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC1B,OAAO,GAAG,EAAE,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC5C,CAAC;YACD,OAAO,EAAE,GAAG,EAAE;gBACZ,aAAa,CAAC,UAAU,CAAC,CAAC;gBAC1B,YAAY,CAAC,YAAY,CAAC,CAAC;gBAC3B,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;gBACjD,eAAe,CAAC,KAAK,EAAE,CAAC;gBACxB,cAAc,CAAC,KAAK,EAAE,CAAC;gBACvB,eAAe,CAAC,KAAK,EAAE,CAAC;gBACxB,iBAAiB,CAAC,KAAK,EAAE,CAAC;gBAC1B,OAAO,CAAC,KAAK,EAAE,CAAC;gBAChB,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,CAAC;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/client/Room.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Client handle for a generic realtime {@link https://docs.partykit.io | PartyKit} `room`.
+ *
+ * Three transports, one {@link RoomHandle} shape:
+ * - **relay** ({@link createRelayRoom}) — the game side. The game iframe does NOT open a socket;
+ *   it drives the room through the shell over `rydr/room.*` postMessage frames, and the shell
+ *   (which owns the hardware + identity) is the sole socket writer. That's what makes presence and
+ *   {@link RoomTelemetry} trustworthy — a game can't forge another player's identity or wattage.
+ * - **direct WS** ({@link createRoom}) — the SHELL side. The shell opens the real socket to the
+ *   `room` party, relays the game's `send`/`setState`, and injects trusted telemetry.
+ * - **loopback** ({@link createLoopbackRoom}) — standalone dev with no shell/backend.
+ *
+ * Wire protocol (kept in sync with `party/room.ts`):
+ * - client→server: `{t:"msg", data}`, `{t:"state", patch}`, `{t:"telemetry", power?, cadence?,
+ *   heartRate?, ts?}` (shell only)
+ * - server→client: `{t:"hello", state, members}`, `{t:"presence", members}`, `{t:"msg", from, data}`,
+ *   `{t:"state", state}`, `{t:"telemetry", from, power?, cadence?, heartRate?, ts}`, `{t:"full", max}`
+ */
+import type { RoomMember, RoomTelemetry, RoomEvent } from "../protocol/room";
+import type { GameToPlatformMessage } from "../protocol/messages";
+export type { RoomMember, RoomTelemetry, RoomEvent };
+export interface RoomHandle {
+    /** Relay an opaque message to the other members. */
+    send(data: unknown): void;
+    /** Merge a patch into the shared opaque state (last-write-wins) and broadcast it. */
+    setState(patch: Record<string, unknown>): void;
+    /**
+     * Schedule a server-stamped orchestration event ({@link RoomEvent}) — the genre-neutral "referee
+     * whistle". Omit `at` for an immediate event, or pass a future server-clock instant for a fair,
+     * head-start-free transition (a countdown, a round timer, a grace window). The server stamps
+     * `from`/`at` and broadcasts to everyone, including the scheduler; clients self-schedule to `at`.
+     */
+    scheduleEvent(name: string, payload?: unknown, at?: number): void;
+    /** Current members (presence). */
+    readonly members: readonly RoomMember[];
+    /** Current shared opaque state. */
+    readonly state: Record<string, unknown>;
+    /** Subscribe to an event. Returns an unsubscribe fn.
+     *  - `message`: `(data, from)` — a relayed peer message.
+     *  - `presence`: `(members)` — membership changed.
+     *  - `state`: `(state)` — shared state changed.
+     *  - `telemetry`: `(reading)` — a peer's trusted, shell-stamped hardware reading.
+     *  - `event`: `(e)` — a server-stamped orchestration event (see {@link scheduleEvent}).
+     *  - `open`/`close`: connection lifecycle. */
+    on(event: "message", cb: (data: unknown, from: string) => void): () => void;
+    on(event: "presence", cb: (members: readonly RoomMember[]) => void): () => void;
+    on(event: "state", cb: (state: Record<string, unknown>) => void): () => void;
+    on(event: "telemetry", cb: (reading: RoomTelemetry) => void): () => void;
+    on(event: "event", cb: (e: RoomEvent) => void): () => void;
+    on(event: "open" | "close", cb: () => void): () => void;
+    /** Leave the room and close the socket. */
+    leave(): void;
+}
+/** Shell-only extension: inject a trusted hardware reading into the room. Games never see this. */
+export interface ShellRoomHandle extends RoomHandle {
+    sendTelemetry(reading: {
+        power?: number;
+        cadence?: number;
+        heartRate?: number;
+        t?: number;
+    }): void;
+}
+interface RoomOptions {
+    host: string;
+    gameId: string;
+    roomId: string;
+    playerId: string;
+    name?: string;
+    /** Max distinct players the room admits (passed to the server). */
+    max?: number;
+}
+/**
+ * Open a room WebSocket directly — used by the SHELL (the trusted socket owner). Returns a
+ * {@link ShellRoomHandle} so the shell can also inject telemetry. Games do NOT call this; they use
+ * `session.joinRoom()`, which relays through the shell.
+ */
+export declare function createRoom(opts: RoomOptions): ShellRoomHandle;
+/** A platform→game room message, already narrowed to one room by the SDK before dispatch into a
+ *  relay handle. (Distinct from {@link RoomEvent}, which is the game-facing orchestration event.) */
+export type RoomRelayEvent = {
+    type: "rydr/room.opened";
+} | {
+    type: "rydr/room.closed";
+} | {
+    type: "rydr/room.presence";
+    members: RoomMember[];
+} | {
+    type: "rydr/room.state";
+    state: Record<string, unknown>;
+} | {
+    type: "rydr/room.message";
+    from: string;
+    data: unknown;
+} | {
+    type: "rydr/room.telemetry";
+    from: string;
+    power?: number;
+    cadence?: number;
+    heartRate?: number;
+    t: number;
+} | {
+    type: "rydr/room.event";
+    name: string;
+    payload: unknown;
+    at: number;
+    from: string;
+};
+/**
+ * Game-side room over the shell relay. The handle posts `rydr/room.*` frames to the shell; incoming
+ * room events are fed in via the returned `dispatch` (the SDK routes them by `roomId`). This is what
+ * `session.joinRoom()` returns when embedded.
+ */
+export declare function createRelayRoom(opts: {
+    roomId: string;
+    post: (msg: GameToPlatformMessage) => void;
+    onLeave: () => void;
+}): {
+    handle: RoomHandle;
+    dispatch: (event: RoomRelayEvent) => void;
+};
+/**
+ * A backend-less loopback room for standalone dev (a session with no `dataHost`): a single local
+ * member that echoes `send` back as a `message` and reflects `setState`. Lets a game build its
+ * realtime UI with no shell/server. No telemetry is emitted (there are no peers).
+ */
+export declare function createLoopbackRoom(playerId: string, name?: string): RoomHandle;
+//# sourceMappingURL=Room.d.ts.map

package/dist/client/Room.d.ts.map

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