@rydr/game-sdk 1.7.0

package/dist/host/PlatformHost.d.ts

@@ -0,0 +1,169 @@
+/**
+ * The platform-side counterpart to {@link connectToPlatform}.
+ *
+ * `createPlatformHost()` binds one embedded game iframe to the shell: it answers
+ * the game's `hello` with a `welcome` (granting capabilities and a scoped,
+ * PII-free identity), streams hardware from a pluggable {@link HardwareSource},
+ * relays trainer-control commands back to it, and surfaces lifecycle/route/exit
+ * events as callbacks. The shell supplies the real hardware + identity; this
+ * host owns none of it — it only mediates the protocol.
+ */
+import type { Capability } from "../protocol/capabilities";
+import type { ScopedIdentity } from "../protocol/identity";
+import type { ButtonName, ButtonEdge } from "../protocol/buttons";
+import type { BoardDefinition, LeaderboardPage, SubmitScoreResult } from "../protocol/boards";
+import type { GameDataScope, GameDoc } from "../protocol/gamedata";
+import type { ReplayMeta } from "../protocol/replays";
+import type { RoomMember, RoomTelemetry, RoomEvent } from "../protocol/room";
+/** A generic game-data operation the host relays to the shell's data service. */
+export interface GameDataOp {
+    kind: "get" | "list" | "save" | "delete";
+    scope: GameDataScope;
+    collection: string;
+    id?: string;
+    data?: unknown;
+}
+/** Result the shell returns for a {@link GameDataOp}. `get`→doc, `list`→docs, `save`/`delete`→ok. */
+export interface GameDataResult {
+    doc?: GameDoc | null;
+    docs?: GameDoc[];
+    ok?: boolean;
+    error?: string;
+}
+/**
+ * How the shell pushes room events back to the embedded game. The host gives one of these to the
+ * shell when the game joins a room; the shell calls it as its room socket produces events. The
+ * host turns each call into the matching `rydr/room.*` frame to the iframe.
+ */
+export interface RoomEventSink {
+    opened(): void;
+    closed(): void;
+    presence(members: RoomMember[]): void;
+    state(state: Record<string, unknown>): void;
+    message(from: string, data: unknown): void;
+    /** A trusted, shell-stamped telemetry reading for one room member. */
+    telemetry(reading: RoomTelemetry): void;
+    /** A server-stamped orchestration event broadcast to the room. */
+    event(e: RoomEvent): void;
+}
+/** What the shell returns to the host to drive a joined room on the game's behalf. */
+export interface RoomController {
+    send(data: unknown): void;
+    setState(patch: Record<string, unknown>): void;
+    scheduleEvent(name: string, payload?: unknown, at?: number): void;
+    leave(): void;
+}
+/** A point-in-time hardware reading pushed to connected games. Omitted fields are unchanged. */
+export interface HardwareSample {
+    power?: number;
+    cadence?: number;
+    heartRate?: number;
+    speed?: number;
+    /** ms timestamp from the platform clock. */
+    t: number;
+}
+/** The shell's hardware, adapted to what the host needs. The shell implements this over its HardwareManager. */
+export interface HardwareSource {
+    /** Subscribe to live readings. Returns an unsubscribe fn. */
+    subscribe(listener: (sample: HardwareSample) => void): () => void;
+    /** Current trainer connection / ERG status. */
+    getStatus(): {
+        connected: boolean;
+        ergSupported: boolean;
+    };
+    /** Apply grade-based resistance. */
+    setSimulation(gradePercent: number): void;
+    /** Apply power-based (ERG) target. */
+    setTargetPower(watts: number): void;
+    /** Toggle ERG mode. */
+    setErgMode(enabled: boolean): void;
+}
+export interface PlatformHostOptions {
+    /** The embedded game iframe. */
+    iframe: HTMLIFrameElement;
+    /** Origin the game is served from. Messages from any other origin are ignored. Default `"*"` (dev only). */
+    gameOrigin?: string;
+    /** The shell's hardware. */
+    hardware: HardwareSource;
+    /** Produce the scoped identity granted to this game. */
+    identityFor(gameId: string): ScopedIdentity;
+    /** Decide which requested capabilities to grant. Default: grant all requested. */
+    grantFor?(gameId: string, requested: Capability[]): Capability[];
+    /** Initial deep-link path to hand the game. */
+    initialPath?: string;
+    /** The game's declared leaderboard boards (from its manifest), handed over in `welcome`. */
+    boards?: BoardDefinition[];
+    /** The run id this session is recorded under, handed over in `welcome`. */
+    runId?: string;
+    /** The `rydr` backend host, handed over in `welcome` so the game can open realtime rooms. */
+    dataHost?: string;
+    onReady?(): void;
+    onLoadProgress?(progress: number): void;
+    onExitRequest?(): void;
+    onRouteChanged?(path: string): void;
+    /** The game asked to show/hide shell chrome (navbar). */
+    onChromeRequest?(visible: boolean): void;
+    /** The game asked to show/hide the trainerless power bar. */
+    onPowerBarRequest?(visible: boolean): void;
+    onRequestHardwareModal?(): void;
+    onError?(message: string): void;
+    /** The game submitted a score; perform the authenticated write and return the rank/PB. */
+    onSubmitScore?(boardId: string, value: number, key?: string): Promise<SubmitScoreResult>;
+    /** The game requested a leaderboard page; fetch and return it. */
+    onGetLeaderboard?(boardId: string, opts: {
+        key?: string;
+        limit?: number;
+    }): Promise<LeaderboardPage>;
+    /** The game saved an opaque run breakdown; persist it against the run id. */
+    onSaveRun?(breakdown: unknown): void;
+    /** The game read/wrote the generic game-data store; perform it and return the result. */
+    onGameData?(op: GameDataOp): Promise<GameDataResult>;
+    /** The game requested a presigned upload URL for a binary asset; mint and return it. */
+    onGetUploadUrl?(req: {
+        collection: string;
+        filename: string;
+        contentType?: string;
+    }): Promise<{
+        uploadUrl?: string;
+        url?: string;
+        error?: string;
+    }>;
+    /** The game saved a replay/ghost blob (base64) + derived {@link ReplayMeta} keyed by `runId`;
+     *  persist both. */
+    onSaveReplay?(runId: string, blob: string, meta: ReplayMeta): Promise<{
+        ok?: boolean;
+        error?: string;
+    }>;
+    /** The game requested a stored replay by `runId`; fetch and return its blob + meta (`null` if absent). */
+    onGetReplay?(runId: string): Promise<{
+        blob?: string | null;
+        meta?: ReplayMeta | null;
+        error?: string;
+    }>;
+    /** The game requested a stored run breakdown by `runId`; fetch and return it. */
+    onGetRun?(runId: string): Promise<{
+        breakdown?: unknown;
+        error?: string;
+    }>;
+    /**
+     * The game joined a realtime room. The shell opens/owns the socket, injects trusted telemetry,
+     * and pushes events back through `sink`; it returns a {@link RoomController} the host uses to
+     * relay the game's `send`/`setState`/`leave`. Return `undefined` if the shell can't host rooms.
+     */
+    onRoomJoin?(roomId: string, sink: RoomEventSink): RoomController | undefined;
+}
+export interface PlatformHost {
+    /** Tell the game to pause (e.g. a shell modal opened). */
+    pause(): void;
+    /** Tell the game to resume. */
+    resume(): void;
+    /** Push a controller button to the game (if it was granted `buttons`). */
+    sendButton(name: ButtonName, edge: ButtonEdge): void;
+    /** Push an updated scoped identity (e.g. after a profile edit). */
+    updateIdentity(identity: ScopedIdentity): void;
+    /** Tear down listeners and stop streaming. */
+    dispose(): void;
+}
+/** Bind a game iframe to the shell over the wire protocol. */
+export declare function createPlatformHost(options: PlatformHostOptions): PlatformHost;
+//# sourceMappingURL=PlatformHost.d.ts.map

package/dist/host/PlatformHost.d.ts.map

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

package/dist/host/PlatformHost.js

@@ -0,0 +1,248 @@
+import { RYDR_PROTOCOL_VERSION } from "../protocol/version";
+import { isGameToPlatformMessage } from "../protocol/guards";
+/** Bind a game iframe to the shell over the wire protocol. */
+export function createPlatformHost(options) {
+    const { iframe, gameOrigin = "*", hardware, identityFor } = options;
+    const grantFor = options.grantFor ?? ((_id, requested) => requested);
+    let granted = [];
+    let unsubscribeHardware = null;
+    /** Rooms the game has joined this session, keyed by roomId. */
+    const roomControllers = new Map();
+    const post = (message) => {
+        iframe.contentWindow?.postMessage(message, gameOrigin);
+    };
+    const can = (capability) => granted.includes(capability);
+    const onHardware = (s) => {
+        if (s.power !== undefined && can("power"))
+            post({ rydr: true, type: "rydr/hw.power", watts: s.power, t: s.t });
+        if (s.cadence !== undefined && can("cadence"))
+            post({ rydr: true, type: "rydr/hw.cadence", rpm: s.cadence, t: s.t });
+        if (s.heartRate !== undefined && can("heartRate"))
+            post({ rydr: true, type: "rydr/hw.heartRate", bpm: s.heartRate, t: s.t });
+        if (s.speed !== undefined && can("speed"))
+            post({ rydr: true, type: "rydr/hw.speed", mps: s.speed, t: s.t });
+    };
+    const onMessage = (event) => {
+        if (event.source !== iframe.contentWindow)
+            return;
+        if (gameOrigin !== "*" && event.origin !== gameOrigin)
+            return;
+        const msg = event.data;
+        if (!isGameToPlatformMessage(msg))
+            return;
+        switch (msg.type) {
+            case "rydr/hello": {
+                granted = grantFor(msg.gameId, msg.capabilities);
+                post({
+                    rydr: true,
+                    type: "rydr/welcome",
+                    protocolVersion: RYDR_PROTOCOL_VERSION,
+                    grantedCapabilities: granted,
+                    identity: identityFor(msg.gameId),
+                    initialPath: options.initialPath,
+                    boards: options.boards,
+                    runId: options.runId,
+                    dataHost: options.dataHost,
+                });
+                const status = hardware.getStatus();
+                post({ rydr: true, type: "rydr/trainer.status", connected: status.connected, ergSupported: status.ergSupported });
+                unsubscribeHardware?.();
+                unsubscribeHardware = hardware.subscribe(onHardware);
+                break;
+            }
+            case "rydr/ready":
+                options.onReady?.();
+                break;
+            case "rydr/loadProgress":
+                options.onLoadProgress?.(msg.progress);
+                break;
+            case "rydr/trainer.setSimulation":
+                hardware.setSimulation(msg.gradePercent);
+                break;
+            case "rydr/trainer.setTargetPower":
+                hardware.setTargetPower(msg.watts);
+                break;
+            case "rydr/trainer.setErgMode":
+                hardware.setErgMode(msg.enabled);
+                break;
+            case "rydr/route.changed":
+                options.onRouteChanged?.(msg.path);
+                break;
+            case "rydr/ui.setChrome":
+                options.onChromeRequest?.(msg.visible);
+                break;
+            case "rydr/ui.setPowerBar":
+                options.onPowerBarRequest?.(msg.visible);
+                break;
+            case "rydr/exitRequest":
+                options.onExitRequest?.();
+                break;
+            case "rydr/ui.requestHardwareModal":
+                options.onRequestHardwareModal?.();
+                break;
+            case "rydr/pong":
+                // liveness reply — no-op for now
+                break;
+            case "rydr/error":
+                options.onError?.(msg.message);
+                break;
+            case "rydr/leaderboard.submit": {
+                const { nonce } = msg;
+                const handler = options.onSubmitScore ??
+                    (async () => ({ rank: 0, isPersonalBest: false, total: 0 }));
+                void handler(msg.boardId, msg.value, msg.key)
+                    .then((result) => post({ rydr: true, type: "rydr/leaderboard.submitResult", nonce, result }))
+                    .catch((err) => {
+                    console.error("[rydr-host] submitScore failed:", err);
+                    post({ rydr: true, type: "rydr/leaderboard.submitResult", nonce, result: { rank: 0, isPersonalBest: false, total: 0 } });
+                });
+                break;
+            }
+            case "rydr/leaderboard.query": {
+                const { nonce } = msg;
+                const handler = options.onGetLeaderboard ??
+                    (async () => ({ entries: [] }));
+                void handler(msg.boardId, { key: msg.key, limit: msg.limit })
+                    .then((page) => post({ rydr: true, type: "rydr/leaderboard.queryResult", nonce, entries: page.entries, you: page.you }))
+                    .catch((err) => {
+                    console.error("[rydr-host] getLeaderboard failed:", err);
+                    post({ rydr: true, type: "rydr/leaderboard.queryResult", nonce, entries: [] });
+                });
+                break;
+            }
+            case "rydr/run.save":
+                options.onSaveRun?.(msg.breakdown);
+                break;
+            case "rydr/gamedata.get":
+            case "rydr/gamedata.list":
+            case "rydr/gamedata.save":
+            case "rydr/gamedata.delete": {
+                const { nonce } = msg;
+                const kind = msg.type.slice("rydr/gamedata.".length);
+                const op = {
+                    kind,
+                    scope: msg.scope,
+                    collection: msg.collection,
+                    id: "id" in msg ? msg.id : undefined,
+                    data: "data" in msg ? msg.data : undefined,
+                };
+                const handler = options.onGameData ?? (async () => ({ error: "gamedata not supported" }));
+                void handler(op)
+                    .then((r) => post({ rydr: true, type: "rydr/gamedata.result", nonce, ...r }))
+                    .catch((err) => {
+                    console.error("[rydr-host] gamedata failed:", err);
+                    post({ rydr: true, type: "rydr/gamedata.result", nonce, error: String(err) });
+                });
+                break;
+            }
+            case "rydr/asset.uploadUrl": {
+                const { nonce } = msg;
+                const handler = options.onGetUploadUrl ?? (async () => ({ error: "asset upload not supported" }));
+                void handler({ collection: msg.collection, filename: msg.filename, contentType: msg.contentType })
+                    .then((r) => post({ rydr: true, type: "rydr/asset.uploadUrlResult", nonce, ...r }))
+                    .catch((err) => {
+                    console.error("[rydr-host] asset.uploadUrl failed:", err);
+                    post({ rydr: true, type: "rydr/asset.uploadUrlResult", nonce, error: String(err) });
+                });
+                break;
+            }
+            case "rydr/replay.save": {
+                const { nonce } = msg;
+                const handler = options.onSaveReplay ?? (async () => ({ error: "replays not supported" }));
+                void handler(msg.runId, msg.blob, msg.meta)
+                    .then((r) => post({ rydr: true, type: "rydr/replay.result", nonce, ...r }))
+                    .catch((err) => {
+                    console.error("[rydr-host] saveReplay failed:", err);
+                    post({ rydr: true, type: "rydr/replay.result", nonce, error: String(err) });
+                });
+                break;
+            }
+            case "rydr/replay.get": {
+                const { nonce } = msg;
+                const handler = options.onGetReplay ?? (async () => ({ error: "replays not supported" }));
+                void handler(msg.runId)
+                    .then((r) => post({ rydr: true, type: "rydr/replay.result", nonce, ...r }))
+                    .catch((err) => {
+                    console.error("[rydr-host] getReplay failed:", err);
+                    post({ rydr: true, type: "rydr/replay.result", nonce, error: String(err) });
+                });
+                break;
+            }
+            case "rydr/run.get": {
+                const { nonce } = msg;
+                const handler = options.onGetRun ?? (async () => ({ error: "run.get not supported" }));
+                void handler(msg.runId)
+                    .then((r) => post({ rydr: true, type: "rydr/run.result", nonce, ...r }))
+                    .catch((err) => {
+                    console.error("[rydr-host] getRun failed:", err);
+                    post({ rydr: true, type: "rydr/run.result", nonce, error: String(err) });
+                });
+                break;
+            }
+            case "rydr/room.join": {
+                const { roomId } = msg;
+                if (!options.onRoomJoin) {
+                    post({ rydr: true, type: "rydr/room.closed", roomId });
+                    break;
+                }
+                roomControllers.get(roomId)?.leave();
+                const sink = {
+                    opened: () => post({ rydr: true, type: "rydr/room.opened", roomId }),
+                    closed: () => post({ rydr: true, type: "rydr/room.closed", roomId }),
+                    presence: (members) => post({ rydr: true, type: "rydr/room.presence", roomId, members }),
+                    state: (state) => post({ rydr: true, type: "rydr/room.state", roomId, state }),
+                    message: (from, data) => post({ rydr: true, type: "rydr/room.message", roomId, from, data }),
+                    telemetry: (r) => post({
+                        rydr: true,
+                        type: "rydr/room.telemetry",
+                        roomId,
+                        from: r.playerId,
+                        power: r.power,
+                        cadence: r.cadence,
+                        heartRate: r.heartRate,
+                        t: r.t,
+                    }),
+                    event: (e) => post({ rydr: true, type: "rydr/room.event", roomId, name: e.name, payload: e.payload, at: e.at, from: e.from }),
+                };
+                const controller = options.onRoomJoin(roomId, sink);
+                if (controller)
+                    roomControllers.set(roomId, controller);
+                else
+                    post({ rydr: true, type: "rydr/room.closed", roomId });
+                break;
+            }
+            case "rydr/room.send":
+                roomControllers.get(msg.roomId)?.send(msg.data);
+                break;
+            case "rydr/room.setState":
+                roomControllers.get(msg.roomId)?.setState(msg.patch);
+                break;
+            case "rydr/room.scheduleEvent":
+                roomControllers.get(msg.roomId)?.scheduleEvent(msg.name, msg.payload, msg.at);
+                break;
+            case "rydr/room.leave":
+                roomControllers.get(msg.roomId)?.leave();
+                roomControllers.delete(msg.roomId);
+                break;
+        }
+    };
+    window.addEventListener("message", onMessage);
+    return {
+        pause: () => post({ rydr: true, type: "rydr/lifecycle.pause" }),
+        resume: () => post({ rydr: true, type: "rydr/lifecycle.resume" }),
+        sendButton: (name, edge) => {
+            if (can("buttons"))
+                post({ rydr: true, type: "rydr/input.button", name, edge });
+        },
+        updateIdentity: (identity) => post({ rydr: true, type: "rydr/identity.update", identity }),
+        dispose: () => {
+            unsubscribeHardware?.();
+            unsubscribeHardware = null;
+            for (const controller of roomControllers.values())
+                controller.leave();
+            roomControllers.clear();
+            window.removeEventListener("message", onMessage);
+        },
+    };
+}
+//# sourceMappingURL=PlatformHost.js.map

package/dist/host/PlatformHost.js.map

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

package/dist/host/index.d.ts

@@ -0,0 +1,3 @@
+/** Platform-side host: bind a game iframe to the shell over the wire protocol. */
+export * from "./PlatformHost";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/host/index.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,cAAc,gBAAgB,CAAC"}

package/dist/host/index.js

@@ -0,0 +1,3 @@
+/** Platform-side host: bind a game iframe to the shell over the wire protocol. */
+export * from "./PlatformHost";
+//# sourceMappingURL=index.js.map

package/dist/host/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/host/index.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,cAAc,gBAAgB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @rydr/game-sdk — client SDK for building games on the RYDR indoor-cycling platform.
+ *
+ * - `protocol` — the versioned platform↔game wire contract (handshake, capabilities,
+ *   scoped identity, hardware/lifecycle messages, type guards).
+ * - `client` — `connectToPlatform()` → a `PlatformSession` (game side).
+ * - `host` — `createPlatformHost()` to embed a game from the shell (platform side).
+ */
+export * from "./protocol/index";
+export * from "./client/index";
+export * from "./host/index";
+//# 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":"AAAA;;;;;;;GAOG;AACH,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * @rydr/game-sdk — client SDK for building games on the RYDR indoor-cycling platform.
+ *
+ * - `protocol` — the versioned platform↔game wire contract (handshake, capabilities,
+ *   scoped identity, hardware/lifecycle messages, type guards).
+ * - `client` — `connectToPlatform()` → a `PlatformSession` (game side).
+ * - `host` — `createPlatformHost()` to embed a game from the shell (platform side).
+ */
+export * from "./protocol/index";
+export * from "./client/index";
+export * from "./host/index";
+//# 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;;;;;;;GAOG;AACH,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}

package/dist/protocol/boards.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Leaderboard board definitions + value formatting — shared by the game manifest,
+ * a game's in-game results screen, and the platform's leaderboard hub.
+ *
+ * A board is declared ONCE (in the game's manifest, admin-managed) so every entry
+ * is comparable: `sort` answers "is more better?", `valueType` drives display
+ * formatting, `aggregate` collapses repeated submits. `submitScore(boardId, value)`
+ * sends a raw number in the board's unit; the platform ranks by `sort`, formats by
+ * `valueType` via {@link formatBoardValue}, and tie-breaks by earliest timestamp.
+ */
+/** Display/format hint for a board's raw numeric value. */
+export type BoardValueType = "time" | "score" | "distance" | "speed" | "percent" | "duration" | "count";
+/** Ranking direction. `asc` = lower wins (time); `desc` = higher wins (score). */
+export type BoardSort = "asc" | "desc";
+/** How repeated submits from the same player collapse. */
+export type BoardAggregate = "best" | "last" | "sum";
+/**
+ * A declarative leaderboard definition. Lives on the {@link GameManifest} (so the
+ * shell can render every game's boards with no game code) and is handed to the game
+ * at handshake as `session.boards`.
+ */
+export interface BoardDefinition {
+    /** Stable id; the `boardId` passed to `submitScore`/`getLeaderboard`. */
+    id: string;
+    /** Human label for the board (defaults to `id`). */
+    label?: string;
+    valueType: BoardValueType;
+    sort: BoardSort;
+    aggregate: BoardAggregate;
+}
+/** One ranked leaderboard row. */
+export interface BoardEntry {
+    /** 1-based rank within the board. */
+    rank: number;
+    playerId: string;
+    displayName: string;
+    /** Raw value in the board's unit (format with {@link formatBoardValue}). */
+    value: number;
+    /** The run this entry came from, if known (links to the FIT activity + run record). */
+    runId?: string;
+    /** ms timestamp the entry was recorded. */
+    ts: number;
+}
+/** Result of a `submitScore` — drives a post-game "you placed #N (new PB!)" screen. */
+export interface SubmitScoreResult {
+    /** The submitter's 1-based rank after this submit. */
+    rank: number;
+    /** Whether this submit improved the player's standing on the board. */
+    isPersonalBest: boolean;
+    /** Total entrants on the board. */
+    total: number;
+}
+/** A page of leaderboard rows, plus the requesting player's own row when off-page. */
+export interface LeaderboardPage {
+    entries: BoardEntry[];
+    /** The requester's own ranked row (may be outside `entries`). */
+    you?: BoardEntry;
+}
+/** Format a raw board value for display, per its {@link BoardValueType}. */
+export declare function formatBoardValue(valueType: BoardValueType, value: number): string;
+//# sourceMappingURL=boards.d.ts.map

package/dist/protocol/boards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boards.d.ts","sourceRoot":"","sources":["../../src/protocol/boards.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,2DAA2D;AAC3D,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,OAAO,GACP,UAAU,GACV,OAAO,GACP,SAAS,GACT,UAAU,GACV,OAAO,CAAC;AAEZ,kFAAkF;AAClF,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,MAAM,CAAC;AAEvC,0DAA0D;AAC1D,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,EAAE,EAAE,MAAM,CAAC;IACX,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,cAAc,CAAC;IAC1B,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,cAAc,CAAC;CAC3B;AAED,kCAAkC;AAClC,MAAM,WAAW,UAAU;IACzB,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAC;IACd,uFAAuF;IACvF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,uFAAuF;AACvF,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,cAAc,EAAE,OAAO,CAAC;IACxB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,sFAAsF;AACtF,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,iEAAiE;IACjE,GAAG,CAAC,EAAE,UAAU,CAAC;CAClB;AAED,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAkBjF"}

package/dist/protocol/boards.js

@@ -0,0 +1,53 @@
+/**
+ * Leaderboard board definitions + value formatting — shared by the game manifest,
+ * a game's in-game results screen, and the platform's leaderboard hub.
+ *
+ * A board is declared ONCE (in the game's manifest, admin-managed) so every entry
+ * is comparable: `sort` answers "is more better?", `valueType` drives display
+ * formatting, `aggregate` collapses repeated submits. `submitScore(boardId, value)`
+ * sends a raw number in the board's unit; the platform ranks by `sort`, formats by
+ * `valueType` via {@link formatBoardValue}, and tie-breaks by earliest timestamp.
+ */
+/** Format a raw board value for display, per its {@link BoardValueType}. */
+export function formatBoardValue(valueType, value) {
+    switch (valueType) {
+        case "time":
+            return formatClock(value, true);
+        case "duration":
+            return formatClock(value, false);
+        case "score":
+        case "count":
+            return Math.round(value).toLocaleString("en-US");
+        case "distance":
+            return value >= 1000
+                ? `${(value / 1000).toFixed(1)} km`
+                : `${Math.round(value)} m`;
+        case "speed":
+            return `${(value * 3.6).toFixed(1)} km/h`;
+        case "percent":
+            return `${value.toFixed(1)}%`;
+    }
+}
+/**
+ * Format milliseconds as a clock. `precise` (for `time` boards) appends hundredths
+ * and drops the hour unless needed: 83210 → "1:23.21". Coarse (for `duration`)
+ * rounds to whole seconds: 4985000 → "1:23:05".
+ */
+function formatClock(ms, precise) {
+    const totalMs = Math.max(0, ms);
+    const totalSeconds = Math.floor(totalMs / 1000);
+    const hours = Math.floor(totalSeconds / 3600);
+    const minutes = Math.floor((totalSeconds % 3600) / 60);
+    const seconds = totalSeconds % 60;
+    if (precise) {
+        const hundredths = Math.floor((totalMs % 1000) / 10);
+        const secs = `${String(seconds).padStart(2, "0")}.${String(hundredths).padStart(2, "0")}`;
+        return hours > 0
+            ? `${hours}:${String(minutes).padStart(2, "0")}:${secs}`
+            : `${minutes}:${secs}`;
+    }
+    return hours > 0
+        ? `${hours}:${String(minutes).padStart(2, "0")}:${String(seconds).padStart(2, "0")}`
+        : `${minutes}:${String(seconds).padStart(2, "0")}`;
+}
+//# sourceMappingURL=boards.js.map

package/dist/protocol/boards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boards.js","sourceRoot":"","sources":["../../src/protocol/boards.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAgEH,4EAA4E;AAC5E,MAAM,UAAU,gBAAgB,CAAC,SAAyB,EAAE,KAAa;IACvE,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,MAAM;YACT,OAAO,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAClC,KAAK,UAAU;YACb,OAAO,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACnC,KAAK,OAAO,CAAC;QACb,KAAK,OAAO;YACV,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QACnD,KAAK,UAAU;YACb,OAAO,KAAK,IAAI,IAAI;gBAClB,CAAC,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;gBACnC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;QAC/B,KAAK,OAAO;YACV,OAAO,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;QAC5C,KAAK,SAAS;YACZ,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAClC,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,WAAW,CAAC,EAAU,EAAE,OAAgB;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,YAAY,GAAG,EAAE,CAAC;IAElC,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACrD,MAAM,IAAI,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;QAC1F,OAAO,KAAK,GAAG,CAAC;YACd,CAAC,CAAC,GAAG,KAAK,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE;YACxD,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,OAAO,KAAK,GAAG,CAAC;QACd,CAAC,CAAC,GAAG,KAAK,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;QACpF,CAAC,CAAC,GAAG,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACvD,CAAC"}

package/dist/protocol/buttons.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Canonical, source-agnostic controller vocabulary.
+ *
+ * Every physical controller (phone, keyboard, Zwift Play) is normalised to
+ * these names by the platform before it reaches a game. The game never learns
+ * which device produced a press — only the canonical name and edge. This keeps
+ * games decoupled from hardware specifics and is the same vocabulary the
+ * platform's input layer already uses.
+ */
+export type ButtonName = "OK" | "UP" | "DOWN" | "LEFT" | "RIGHT" | "CANCEL";
+/** Press = "down", release = "up". A held button emits one of each. */
+export type ButtonEdge = "down" | "up";
+//# sourceMappingURL=buttons.d.ts.map