@gatherround/sdk 0.4.1

package/dist/adapters/i-client-adapter.d.ts

@@ -0,0 +1,45 @@
+/**
+ * i-client-adapter.ts
+ *
+ * TV engine ↔ platform adapter for session lifecycle and messaging.
+ * The TV app uses this to create sessions, send display instructions
+ * to phone controllers, and receive controller messages.
+ */
+import type { ControllerMessage } from "../controller-message.js";
+import type { DisplayInstruction } from "../display-instruction.js";
+export interface GameSessionOptions {
+    /** Published episode ID to play. */
+    episodeId: string;
+    /** Published version ID (optional — uses latest if omitted). */
+    versionId?: string;
+    /** Maximum number of players (excluding the TV host). */
+    maxPlayers: number;
+}
+export interface GameSessionResult {
+    /** Unique session identifier. */
+    sessionId: string;
+    /** Short alphanumeric code for manual entry (e.g. "A3F9K2"). */
+    sessionCode: string;
+    /** Full URL for phone controller join (embedded in QR code). */
+    controllerUrl: string;
+}
+export interface PlayerSessionResult {
+    /** The player's unique ID within this session. */
+    playerId: string;
+    /** The session they joined. */
+    sessionId: string;
+}
+/**
+ * Engine-side adapter for session management and bidirectional messaging.
+ */
+export interface IClientAdapter {
+    createGameSession(options: GameSessionOptions): Promise<GameSessionResult>;
+    joinGameSession(sessionId: string): Promise<PlayerSessionResult>;
+    disconnect(): void;
+    sendToController(playerId: string, instruction: DisplayInstruction): Promise<void>;
+    broadcastToAll(instruction: DisplayInstruction): Promise<void>;
+    onControllerMessage(cb: (playerId: string, message: ControllerMessage) => void): void;
+    onPlayerConnected(cb: (playerId: string) => void): void;
+    onPlayerDisconnected(cb: (playerId: string) => void): void;
+}
+//# sourceMappingURL=i-client-adapter.d.ts.map

package/dist/adapters/i-client-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-client-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/i-client-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAIpE,MAAM,WAAW,kBAAkB;IACjC,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAID;;GAEG;AACH,MAAM,WAAW,cAAc;IAE7B,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC3E,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACjE,UAAU,IAAI,IAAI,CAAC;IAGnB,gBAAgB,CACd,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,kBAAkB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,cAAc,CAAC,WAAW,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAG/D,mBAAmB,CACjB,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,KAAK,IAAI,GACzD,IAAI,CAAC;IACR,iBAAiB,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IACxD,oBAAoB,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;CAC5D"}

package/dist/adapters/i-client-adapter.js

@@ -0,0 +1,9 @@
+/**
+ * i-client-adapter.ts
+ *
+ * TV engine ↔ platform adapter for session lifecycle and messaging.
+ * The TV app uses this to create sessions, send display instructions
+ * to phone controllers, and receive controller messages.
+ */
+export {};
+//# sourceMappingURL=i-client-adapter.js.map

package/dist/adapters/i-client-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-client-adapter.js","sourceRoot":"","sources":["../../src/adapters/i-client-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/adapters/i-content-adapter.d.ts

@@ -0,0 +1,23 @@
+/**
+ * i-content-adapter.ts
+ *
+ * TV engine ↔ episode content adapter.
+ * Resolves published episode JSON from whatever storage backend is active
+ * (Firestore registry → GCS for GRG, embedded build for Luna, etc.).
+ */
+import type { RuntimeEpisode } from "../runtime-episode.js";
+/**
+ * Adapter for loading published episode content at runtime.
+ */
+export interface IContentAdapter {
+    /**
+     * Fetch the latest published episode.
+     * Resolution: platform registry → storage path → parsed JSON.
+     */
+    loadEpisode(episodeId: string): Promise<RuntimeEpisode>;
+    /**
+     * Fetch a specific published version (for rollback / pinned builds).
+     */
+    loadEpisodeVersion(episodeId: string, versionId: string): Promise<RuntimeEpisode>;
+}
+//# sourceMappingURL=i-content-adapter.d.ts.map

package/dist/adapters/i-content-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-content-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/i-content-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAExD;;OAEG;IACH,kBAAkB,CAChB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,cAAc,CAAC,CAAC;CAC5B"}

package/dist/adapters/i-content-adapter.js

@@ -0,0 +1,9 @@
+/**
+ * i-content-adapter.ts
+ *
+ * TV engine ↔ episode content adapter.
+ * Resolves published episode JSON from whatever storage backend is active
+ * (Firestore registry → GCS for GRG, embedded build for Luna, etc.).
+ */
+export {};
+//# sourceMappingURL=i-content-adapter.js.map

package/dist/adapters/i-content-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-content-adapter.js","sourceRoot":"","sources":["../../src/adapters/i-content-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/adapters/i-controller-transport.d.ts

@@ -0,0 +1,31 @@
+/**
+ * i-controller-transport.ts
+ *
+ * Controller-side transport interface.
+ * The phone controller app uses this to communicate with the TV game engine.
+ * GRG implements this over Firebase RTDB; Luna uses GameLift Realtime JS SDK.
+ */
+import type { ControllerMessage } from "../controller-message.js";
+import type { DisplayInstruction } from "../display-instruction.js";
+/**
+ * Transport layer for phone controller ↔ TV engine communication.
+ */
+export interface IControllerTransport {
+    /**
+     * Connect to an active session (called after scanning QR / reading URL param).
+     */
+    joinSession(sessionId: string): Promise<void>;
+    /**
+     * Send a player input event to the TV engine.
+     */
+    sendInput(message: ControllerMessage): Promise<void>;
+    /**
+     * Register a callback for display instructions from the TV engine.
+     */
+    onDisplayInstruction(cb: (instruction: DisplayInstruction) => void): void;
+    /**
+     * Tear down transport connection.
+     */
+    disconnect(): void;
+}
+//# sourceMappingURL=i-controller-transport.d.ts.map

package/dist/adapters/i-controller-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-controller-transport.d.ts","sourceRoot":"","sources":["../../src/adapters/i-controller-transport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErD;;OAEG;IACH,oBAAoB,CAAC,EAAE,EAAE,CAAC,WAAW,EAAE,kBAAkB,KAAK,IAAI,GAAG,IAAI,CAAC;IAE1E;;OAEG;IACH,UAAU,IAAI,IAAI,CAAC;CACpB"}

package/dist/adapters/i-controller-transport.js

@@ -0,0 +1,9 @@
+/**
+ * i-controller-transport.ts
+ *
+ * Controller-side transport interface.
+ * The phone controller app uses this to communicate with the TV game engine.
+ * GRG implements this over Firebase RTDB; Luna uses GameLift Realtime JS SDK.
+ */
+export {};
+//# sourceMappingURL=i-controller-transport.js.map

package/dist/adapters/i-controller-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-controller-transport.js","sourceRoot":"","sources":["../../src/adapters/i-controller-transport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/adapters/i-session-adapter.d.ts

@@ -0,0 +1,42 @@
+/**
+ * i-session-adapter.ts
+ *
+ * TV engine ↔ session persistence adapter.
+ * Manages game session state (variables, scene checkpoints) in whatever
+ * persistence layer the platform provides (RTDB for GRG, save system for Luna, etc.).
+ */
+export interface PlayerConfig {
+    /** Player's unique ID (e.g. Firebase UID). */
+    playerId: string;
+    /** Display name. */
+    name: string;
+    /** Assigned hero role slot (0 = host, 1–4 = players). */
+    role: number;
+}
+/**
+ * Runtime variable state for an episode session.
+ * Keys are variable names; values are their current runtime values.
+ */
+export type EpisodeVariables = Record<string, boolean | number | string>;
+/**
+ * Serializable checkpoint for a scene's execution state.
+ * Shape is intentionally loose — the engine defines what goes in here.
+ */
+export interface SceneCheckpoint {
+    /** Current node ID within the scene. */
+    currentNodeId: string;
+    /** Any additional engine state needed to resume. */
+    [key: string]: unknown;
+}
+/**
+ * Engine-side adapter for session state persistence.
+ */
+export interface ISessionAdapter {
+    createSession(episodeId: string, players: PlayerConfig[]): Promise<string>;
+    getSessionVariables(sessionId: string): Promise<EpisodeVariables>;
+    updateSessionVariables(sessionId: string, vars: Partial<EpisodeVariables>): Promise<void>;
+    saveSceneState(sessionId: string, sceneId: string, state: SceneCheckpoint): Promise<void>;
+    loadSceneState(sessionId: string, sceneId: string): Promise<SceneCheckpoint | null>;
+    advanceScene(sessionId: string, nextSceneId: string): Promise<void>;
+}
+//# sourceMappingURL=i-session-adapter.d.ts.map

package/dist/adapters/i-session-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-session-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/i-session-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;AAEzE;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAID;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,aAAa,CACX,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,YAAY,EAAE,GACtB,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAElE,sBAAsB,CACpB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAC9B,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB,cAAc,CACZ,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB,cAAc,CACZ,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAEnC,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrE"}

package/dist/adapters/i-session-adapter.js

@@ -0,0 +1,9 @@
+/**
+ * i-session-adapter.ts
+ *
+ * TV engine ↔ session persistence adapter.
+ * Manages game session state (variables, scene checkpoints) in whatever
+ * persistence layer the platform provides (RTDB for GRG, save system for Luna, etc.).
+ */
+export {};
+//# sourceMappingURL=i-session-adapter.js.map

package/dist/adapters/i-session-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-session-adapter.js","sourceRoot":"","sources":["../../src/adapters/i-session-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/controller-message.d.ts

@@ -0,0 +1,59 @@
+/**
+ * controller-message.ts
+ *
+ * Phone → TV typed event union.
+ * Sent by the phone controller to the TV game engine via IControllerTransport.sendInput().
+ */
+export interface HeroSelected {
+    type: "HeroSelected";
+    /** The hero role slot chosen by this player. */
+    role: number;
+}
+export interface QTEResponse {
+    type: "QTEResponse";
+    /** Whether the player succeeded the QTE within the time limit. */
+    success: boolean;
+    /** Reaction time in milliseconds, or null if timed out. */
+    reactionTimeMs: number | null;
+}
+export interface ChoiceSelected {
+    type: "ChoiceSelected";
+    /** Index into the node's choices array. */
+    choiceIndex: number;
+}
+export interface VoteSubmitted {
+    type: "VoteSubmitted";
+    /** Index into the node's vote options array. */
+    optionIndex: number;
+}
+export interface ReadyConfirmed {
+    type: "ReadyConfirmed";
+}
+export interface ExploreOptionSelected {
+    type: "ExploreOptionSelected";
+    /** Index into the explore node's options array. */
+    optionIndex: number;
+}
+export interface ExploreExitSelected {
+    type: "ExploreExitSelected";
+    /** Index into the explore node's exits array. */
+    exitIndex: number;
+}
+export interface ExploreExitVote {
+    type: "ExploreExitVote";
+    /** Whether this player accepts the proposed exit. */
+    accepted: boolean;
+}
+export interface PlayerPing {
+    type: "PlayerPing";
+    /** ISO-8601 timestamp from the controller. */
+    timestamp: string;
+}
+/**
+ * Discriminated union of all messages a phone controller can send to the TV engine.
+ * Discriminant field: `type`.
+ */
+export type ControllerMessage = HeroSelected | QTEResponse | ChoiceSelected | VoteSubmitted | ExploreOptionSelected | ExploreExitSelected | ExploreExitVote | ReadyConfirmed | PlayerPing;
+/** All possible `type` values for ControllerMessage. */
+export type ControllerMessageType = ControllerMessage["type"];
+//# sourceMappingURL=controller-message.d.ts.map

package/dist/controller-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller-message.d.ts","sourceRoot":"","sources":["../src/controller-message.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,cAAc,CAAC;IACrB,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,aAAa,CAAC;IACpB,kEAAkE;IAClE,OAAO,EAAE,OAAO,CAAC;IACjB,2DAA2D;IAC3D,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,gBAAgB,CAAC;IACvB,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,eAAe,CAAC;IACtB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,iBAAiB,CAAC;IACxB,qDAAqD;IACrD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,YAAY,CAAC;IACnB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;CACnB;AAID;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GACzB,YAAY,GACZ,WAAW,GACX,cAAc,GACd,aAAa,GACb,qBAAqB,GACrB,mBAAmB,GACnB,eAAe,GACf,cAAc,GACd,UAAU,CAAC;AAEf,wDAAwD;AACxD,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC"}

package/dist/controller-message.js

@@ -0,0 +1,8 @@
+/**
+ * controller-message.ts
+ *
+ * Phone → TV typed event union.
+ * Sent by the phone controller to the TV game engine via IControllerTransport.sendInput().
+ */
+export {};
+//# sourceMappingURL=controller-message.js.map

package/dist/controller-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller-message.js","sourceRoot":"","sources":["../src/controller-message.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/display-instruction.d.ts

@@ -0,0 +1,81 @@
+/**
+ * display-instruction.ts
+ *
+ * TV → Phone typed payload union.
+ * Sent by the TV game engine to phone controllers via IClientAdapter.sendToController().
+ */
+export interface RenderLayout {
+    type: "RenderLayout";
+    /** Layout template identifier (e.g. "choice_prompt", "qte_tap", "vote_grid"). */
+    template: string;
+    /** Template-specific data — shape varies by template. */
+    data: Record<string, unknown>;
+}
+export interface ShowPrompt {
+    type: "ShowPrompt";
+    /** Prompt text to display. */
+    text: string;
+    /** Optional choices for the player. */
+    choices?: string[];
+    /** Optional timer duration in seconds. */
+    timerSeconds?: number;
+    /** Hero profile image URL for the controller top bar, or null if unset. */
+    heroProfileImg?: string | null;
+}
+export interface ShowFeedback {
+    type: "ShowFeedback";
+    /** Feedback message (e.g. "Correct!", "Time's up!"). */
+    text: string;
+    /** Visual style hint. */
+    style: "success" | "failure" | "neutral";
+}
+export interface ApplyTheme {
+    type: "ApplyTheme";
+    /** CSS custom properties to apply on the controller. */
+    properties: Record<string, string>;
+}
+export interface ShowCountdown {
+    type: "ShowCountdown";
+    /** Duration in seconds. */
+    durationSeconds: number;
+    /** Optional label (e.g. "Get ready!"). */
+    label?: string;
+}
+export interface ClearScreen {
+    type: "ClearScreen";
+}
+export interface GameTerminated {
+    type: "GameTerminated";
+    /** Optional reason for termination. */
+    reason?: string;
+}
+export interface UpdateMeters {
+    type: "UpdateMeters";
+    /** Meter ID → current value. */
+    meters: Record<string, number>;
+}
+export interface ScheduledCue {
+    /** Milliseconds from playStartServerTime to show this QTE. */
+    atMs: number;
+    /** Cue index (matches the timeEvent index on the play_video node). */
+    cueIndex: number;
+    /** QTE template (e.g. "qte_tap"). */
+    template: string;
+    /** Template-specific data (text, timeLimit, difficulty, heroProfileImg). */
+    data: Record<string, unknown>;
+}
+export interface ScheduleQTE {
+    type: "ScheduleQTE";
+    /** Server timestamp (Date.now() on app) when the video started playing. */
+    playStartServerTime: number;
+    /** Cues to schedule, sorted by atMs ascending. */
+    cues: ScheduledCue[];
+}
+/**
+ * Discriminated union of all instructions the TV engine can send to phone controllers.
+ * Discriminant field: `type`.
+ */
+export type DisplayInstruction = RenderLayout | ShowPrompt | ShowFeedback | ApplyTheme | ShowCountdown | ClearScreen | GameTerminated | UpdateMeters | ScheduleQTE;
+/** All possible `type` values for DisplayInstruction. */
+export type DisplayInstructionType = DisplayInstruction["type"];
+//# sourceMappingURL=display-instruction.d.ts.map

package/dist/display-instruction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-instruction.d.ts","sourceRoot":"","sources":["../src/display-instruction.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,cAAc,CAAC;IACrB,iFAAiF;IACjF,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,YAAY,CAAC;IACnB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,cAAc,CAAC;IACrB,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;CAC1C;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,YAAY,CAAC;IACnB,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,eAAe,CAAC;IACtB,2BAA2B;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,aAAa,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,gBAAgB,CAAC;IACvB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,cAAc,CAAC;IACrB,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,aAAa,CAAC;IACpB,2EAA2E;IAC3E,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kDAAkD;IAClD,IAAI,EAAE,YAAY,EAAE,CAAC;CACtB;AAID;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAC1B,YAAY,GACZ,UAAU,GACV,YAAY,GACZ,UAAU,GACV,aAAa,GACb,WAAW,GACX,cAAc,GACd,YAAY,GACZ,WAAW,CAAC;AAEhB,yDAAyD;AACzD,MAAM,MAAM,sBAAsB,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC"}

package/dist/display-instruction.js

@@ -0,0 +1,8 @@
+/**
+ * display-instruction.ts
+ *
+ * TV → Phone typed payload union.
+ * Sent by the TV game engine to phone controllers via IClientAdapter.sendToController().
+ */
+export {};
+//# sourceMappingURL=display-instruction.js.map

package/dist/display-instruction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-instruction.js","sourceRoot":"","sources":["../src/display-instruction.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @grg/sdk — Gather Round SDK
+ *
+ * Shared types, interfaces, and schemas for the Gather Round ecosystem.
+ * This package contains contracts only — no business logic, no platform
+ * imports, no React.
+ */
+export type { RuntimeEpisode, RuntimeHero, RuntimeHeroAttribute, RuntimeMeterDefinition, RuntimeVariable, RuntimeEpisodeAssets, } from "./runtime-episode.js";
+export type { RuntimeNode, RuntimeTransition, RuntimeCondition, RuntimeConditionGroup, RuntimeMutation, } from "./runtime-types.js";
+export type { RuntimeStrings } from "./runtime-strings.js";
+export type { AssetEntry, RuntimeAssetManifest } from "./runtime-assets.js";
+export type { ControllerMessage, ControllerMessageType, HeroSelected, QTEResponse, ChoiceSelected, VoteSubmitted, ExploreOptionSelected, ExploreExitSelected, ExploreExitVote, ReadyConfirmed, PlayerPing, } from "./controller-message.js";
+export type { DisplayInstruction, DisplayInstructionType, RenderLayout, ShowPrompt, ShowFeedback, ApplyTheme, ShowCountdown, ClearScreen, GameTerminated, UpdateMeters, ScheduledCue, ScheduleQTE, } from "./display-instruction.js";
+export type { IContentAdapter } from "./adapters/i-content-adapter.js";
+export type { IClientAdapter, GameSessionOptions, GameSessionResult, PlayerSessionResult, } from "./adapters/i-client-adapter.js";
+export type { ISessionAdapter, PlayerConfig, EpisodeVariables, SceneCheckpoint, } from "./adapters/i-session-adapter.js";
+export type { IControllerTransport } from "./adapters/i-controller-transport.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":"AAAA;;;;;;GAMG;AAIH,YAAY,EACV,cAAc,EACd,WAAW,EACX,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,EACf,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,YAAY,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAI5E,YAAY,EACV,iBAAiB,EACjB,qBAAqB,EACrB,YAAY,EACZ,WAAW,EACX,cAAc,EACd,aAAa,EACb,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,UAAU,GACX,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EACV,kBAAkB,EAClB,sBAAsB,EACtB,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,UAAU,EACV,aAAa,EACb,WAAW,EACX,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,WAAW,GACZ,MAAM,0BAA0B,CAAC;AAIlC,YAAY,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAEvE,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,gCAAgC,CAAC;AAExC,YAAY,EACV,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,eAAe,GAChB,MAAM,iCAAiC,CAAC;AAEzC,YAAY,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * @grg/sdk — Gather Round SDK
+ *
+ * Shared types, interfaces, and schemas for the Gather Round ecosystem.
+ * This package contains contracts only — no business logic, no platform
+ * imports, no React.
+ */
+export {};
+//# 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;;;;;;GAMG"}

package/dist/runtime-assets.d.ts

@@ -0,0 +1,17 @@
+/**
+ * runtime-assets.ts
+ *
+ * Asset manifest artifact (assets.json).
+ * Lists all media files referenced by the episode for pre-loading.
+ */
+export interface AssetEntry {
+    /** GCS bucket name. */
+    bucket: string;
+    /** Object path within the bucket. */
+    path: string;
+    /** Asset type for pre-loading strategy. */
+    type: "video" | "image" | "audio";
+}
+/** Keyed by a logical ID (e.g. "hero.1.cardImg", "node-abc.url"). */
+export type RuntimeAssetManifest = Record<string, AssetEntry>;
+//# sourceMappingURL=runtime-assets.d.ts.map

package/dist/runtime-assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-assets.d.ts","sourceRoot":"","sources":["../src/runtime-assets.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,UAAU;IACzB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;CACnC;AAED,qEAAqE;AACrE,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC"}

package/dist/runtime-assets.js

@@ -0,0 +1,8 @@
+/**
+ * runtime-assets.ts
+ *
+ * Asset manifest artifact (assets.json).
+ * Lists all media files referenced by the episode for pre-loading.
+ */
+export {};
+//# sourceMappingURL=runtime-assets.js.map

package/dist/runtime-assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-assets.js","sourceRoot":"","sources":["../src/runtime-assets.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/runtime-episode.d.ts

@@ -0,0 +1,84 @@
+/**
+ * runtime-episode.ts
+ *
+ * Top-level runtime episode type — the root of episode.json.
+ * Produced by the editor's publish pipeline, consumed by the game engine.
+ */
+import type { RuntimeNode } from "./runtime-types.js";
+export interface RuntimeHeroAttribute {
+    /** Stable key (e.g. "essence", "fear_meter"). */
+    id: string;
+    /** Display name (e.g. "Essence", "Fear Meter"). */
+    label: string;
+    /** Narrative descriptor value — always string. */
+    value: string;
+}
+export interface RuntimeMeterDefinition {
+    /** Stable key matching variable name (e.g. "alignment"). */
+    id: string;
+    /** Display label (e.g. "Alignment"). */
+    label: string;
+    /** Starting value (e.g. 10). */
+    defaultValue: number;
+    /** Range floor (e.g. 0). */
+    min: number;
+    /** Range ceiling (e.g. 20). */
+    max: number;
+    /** Optional CSS color for bar, null = theme default. */
+    color: string | null;
+}
+export interface RuntimeHero {
+    /** Role slot: 0 = TV Host, 1–4 = player heroes. */
+    role: number;
+    name: string;
+    description: string;
+    /** Self-describing attribute array — includes all designer-defined attributes. */
+    attributes: RuntimeHeroAttribute[];
+    /** Meter definitions for this hero's class (numeric bars with min/max range). */
+    meters: RuntimeMeterDefinition[];
+    /** GCS path to hero card image (lobby / character sheet), or null if unset. */
+    cardImg: string | null;
+    /** GCS path to profile image (thumbnail / PiP overlay), or null if unset. */
+    profileImg: string | null;
+}
+export interface RuntimeVariable {
+    /** Variable name (the target key used in mutations/conditions). */
+    name: string;
+    /** Data type — determines valid runtime operations. */
+    type: "boolean" | "number" | "string";
+    /** Starting value at episode begin. */
+    defaultValue: boolean | number | string;
+    /**
+     * When set, the engine creates one instance per entity of this type.
+     * null = plain global variable. "hero" = one instance per hero.
+     */
+    expandBy: "hero" | null;
+}
+export interface RuntimeEpisodeAssets {
+    logo: string | null;
+    thumbnail: string | null;
+    /** Full-screen image shown on the start/title screen. */
+    startBg: string | null;
+    /** Background image shown behind the lobby UI. */
+    lobbyBg: string | null;
+}
+export interface RuntimeEpisode {
+    /** Schema version — bumped on breaking changes to the runtime format. */
+    version: "2.0" | "2.1" | "2.2";
+    /** Firestore episode document ID. */
+    episodeId: string;
+    /** ISO-8601 timestamp of when this artifact was compiled. */
+    compiledAt: string;
+    /** Publish version ID (timestamp-based, e.g. "20260306T120000Z"). */
+    versionId: string;
+    title: string;
+    genre: string | null;
+    summary: string | null;
+    /** Node ID to begin execution from. */
+    startNodeId: string;
+    heroes: RuntimeHero[];
+    variables: RuntimeVariable[];
+    assets: RuntimeEpisodeAssets;
+    nodes: RuntimeNode[];
+}
+//# sourceMappingURL=runtime-episode.d.ts.map

package/dist/runtime-episode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-episode.d.ts","sourceRoot":"","sources":["../src/runtime-episode.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAItD,MAAM,WAAW,oBAAoB;IACnC,iDAAiD;IACjD,EAAE,EAAE,MAAM,CAAC;IACX,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,4DAA4D;IAC5D,EAAE,EAAE,MAAM,CAAC;IACX,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,+BAA+B;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,wDAAwD;IACxD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,UAAU,EAAE,oBAAoB,EAAE,CAAC;IACnC,iFAAiF;IACjF,MAAM,EAAE,sBAAsB,EAAE,CAAC;IACjC,+EAA+E;IAC/E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAID,MAAM,WAAW,eAAe;IAC9B,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACtC,uCAAuC;IACvC,YAAY,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IACxC;;;OAGG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAID,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,yDAAyD;IACzD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,kDAAkD;IAClD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAID,MAAM,WAAW,cAAc;IAC7B,yEAAyE;IACzE,OAAO,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;IAC/B,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;IAGlB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvB,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IAGpB,MAAM,EAAE,WAAW,EAAE,CAAC;IAGtB,SAAS,EAAE,eAAe,EAAE,CAAC;IAG7B,MAAM,EAAE,oBAAoB,CAAC;IAG7B,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB"}

package/dist/runtime-episode.js

@@ -0,0 +1,8 @@
+/**
+ * runtime-episode.ts
+ *
+ * Top-level runtime episode type — the root of episode.json.
+ * Produced by the editor's publish pipeline, consumed by the game engine.
+ */
+export {};
+//# sourceMappingURL=runtime-episode.js.map

package/dist/runtime-episode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-episode.js","sourceRoot":"","sources":["../src/runtime-episode.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/runtime-strings.d.ts

@@ -0,0 +1,12 @@
+/**
+ * runtime-strings.ts
+ *
+ * String extraction artifact (strings.en.json).
+ * Flat key-value map of all player-facing text, keyed by node + field path.
+ */
+/**
+ * Flat key-value map of all player-facing text.
+ * Keys follow the pattern: `{nodeId}.{field}` or `{nodeId}.{field}.{index}`
+ */
+export type RuntimeStrings = Record<string, string>;
+//# sourceMappingURL=runtime-strings.d.ts.map

package/dist/runtime-strings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-strings.d.ts","sourceRoot":"","sources":["../src/runtime-strings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC"}

package/dist/runtime-strings.js

@@ -0,0 +1,8 @@
+/**
+ * runtime-strings.ts
+ *
+ * String extraction artifact (strings.en.json).
+ * Flat key-value map of all player-facing text, keyed by node + field path.
+ */
+export {};
+//# sourceMappingURL=runtime-strings.js.map

package/dist/runtime-strings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-strings.js","sourceRoot":"","sources":["../src/runtime-strings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}