@thegeem/protocol 0.1.3 → 0.1.5

package/dist/index.cjs

@@ -77,7 +77,14 @@ var ClientMsg = import_zod.z.discriminatedUnion("t", [
     game: import_zod.z.enum(GAME_IDS).optional(),
     // which game to play; defaults to 'trivia'
     totalRounds: import_zod.z.number().int().min(1).max(50),
-    categoryIds: import_zod.z.array(import_zod.z.string().max(60)).min(1).max(12)
+    categoryIds: import_zod.z.array(import_zod.z.string().max(60)).min(1).max(12),
+    // How to play (maps to the engine). Omit → controller (each player answers from
+    // their own device). 'off' = one device drives (Me-Controller); pair with noHost.
+    //   solo=Solo · race=Snag/buzz · controller=each-player-from-device · off=Me-Controller
+    buzzerMode: import_zod.z.enum(["off", "solo", "race", "controller"]).optional(),
+    // Only meaningful for 'off' (Me-Controller): false = a referee drives & sees answers
+    // (classic); true = the driver is a player, answers stay hidden + auto-reveal (noHost).
+    noHost: import_zod.z.boolean().optional()
   }),
   import_zod.z.object({ t: import_zod.z.literal("pickLevel"), categoryId: import_zod.z.string().max(60), level: import_zod.z.number().int().min(1).max(6) }),
   import_zod.z.object({ t: import_zod.z.literal("nextTurn") }),

package/dist/index.d.cts

@@ -201,16 +201,22 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     game: z.ZodOptional<z.ZodEnum<["trivia"]>>;
     totalRounds: z.ZodNumber;
     categoryIds: z.ZodArray<z.ZodString, "many">;
+    buzzerMode: z.ZodOptional<z.ZodEnum<["off", "solo", "race", "controller"]>>;
+    noHost: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     t: "startGame";
     categoryIds: string[];
     totalRounds: number;
     game?: "trivia" | undefined;
+    buzzerMode?: "off" | "solo" | "race" | "controller" | undefined;
+    noHost?: boolean | undefined;
 }, {
     t: "startGame";
     categoryIds: string[];
     totalRounds: number;
     game?: "trivia" | undefined;
+    buzzerMode?: "off" | "solo" | "race" | "controller" | undefined;
+    noHost?: boolean | undefined;
 }>, z.ZodObject<{
     t: z.ZodLiteral<"pickLevel">;
     categoryId: z.ZodString;
@@ -387,6 +393,11 @@ interface GameStateView {
     usedLevels: {
         [categoryId: string]: number[];
     };
+    /** Live question countdown: ms remaining while the timer is **ticking** (relay-
+     *  enriched from the server-authoritative timer). Absent between questions, while
+     *  paused (e.g. steal intro), or after time-up. Present ⇒ animate a countdown from
+     *  it; the server remains the authority on actual time-up. */
+    timerRemainingMs?: number;
 }
 /** Transient presentation effects the relay emits; clients play them once. */
 type Effect = {

package/dist/index.d.ts

@@ -201,16 +201,22 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     game: z.ZodOptional<z.ZodEnum<["trivia"]>>;
     totalRounds: z.ZodNumber;
     categoryIds: z.ZodArray<z.ZodString, "many">;
+    buzzerMode: z.ZodOptional<z.ZodEnum<["off", "solo", "race", "controller"]>>;
+    noHost: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     t: "startGame";
     categoryIds: string[];
     totalRounds: number;
     game?: "trivia" | undefined;
+    buzzerMode?: "off" | "solo" | "race" | "controller" | undefined;
+    noHost?: boolean | undefined;
 }, {
     t: "startGame";
     categoryIds: string[];
     totalRounds: number;
     game?: "trivia" | undefined;
+    buzzerMode?: "off" | "solo" | "race" | "controller" | undefined;
+    noHost?: boolean | undefined;
 }>, z.ZodObject<{
     t: z.ZodLiteral<"pickLevel">;
     categoryId: z.ZodString;
@@ -387,6 +393,11 @@ interface GameStateView {
     usedLevels: {
         [categoryId: string]: number[];
     };
+    /** Live question countdown: ms remaining while the timer is **ticking** (relay-
+     *  enriched from the server-authoritative timer). Absent between questions, while
+     *  paused (e.g. steal intro), or after time-up. Present ⇒ animate a countdown from
+     *  it; the server remains the authority on actual time-up. */
+    timerRemainingMs?: number;
 }
 /** Transient presentation effects the relay emits; clients play them once. */
 type Effect = {

package/dist/index.js

@@ -49,7 +49,14 @@ var ClientMsg = z.discriminatedUnion("t", [
     game: z.enum(GAME_IDS).optional(),
     // which game to play; defaults to 'trivia'
     totalRounds: z.number().int().min(1).max(50),
-    categoryIds: z.array(z.string().max(60)).min(1).max(12)
+    categoryIds: z.array(z.string().max(60)).min(1).max(12),
+    // How to play (maps to the engine). Omit → controller (each player answers from
+    // their own device). 'off' = one device drives (Me-Controller); pair with noHost.
+    //   solo=Solo · race=Snag/buzz · controller=each-player-from-device · off=Me-Controller
+    buzzerMode: z.enum(["off", "solo", "race", "controller"]).optional(),
+    // Only meaningful for 'off' (Me-Controller): false = a referee drives & sees answers
+    // (classic); true = the driver is a player, answers stay hidden + auto-reveal (noHost).
+    noHost: z.boolean().optional()
   }),
   z.object({ t: z.literal("pickLevel"), categoryId: z.string().max(60), level: z.number().int().min(1).max(6) }),
   z.object({ t: z.literal("nextTurn") }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thegeem/protocol",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Geem's wire protocol — shared zod schemas + TypeScript types for talking to the Geem game server over Socket.IO. The source of truth all clients implement against.",
   "license": "UNLICENSED",
   "homepage": "https://geem.tv",