@thegeem/protocol 0.1.10 → 0.1.12

package/dist/index.cjs

@@ -63,18 +63,19 @@ var HelpType = import_zod.z.enum([
 ]);
 var Pv = import_zod.z.number().int().min(1).max(1e6).optional();
 var IdToken = import_zod.z.string().max(4096).optional();
+var Platform = import_zod.z.enum(["web", "ios", "android"]).optional();
 var Avatar = import_zod.z.object({
   emoji: import_zod.z.string().min(1).max(16).transform((s) => s.replace(UNSAFE_CHARS, "")).refine((s) => s.length >= 1, "empty emoji"),
   color: import_zod.z.string().regex(/^#[0-9a-fA-F]{6}$/, "color must be #rrggbb")
 });
 var ClientMsg = import_zod.z.discriminatedUnion("t", [
   // room / lobby
-  import_zod.z.object({ t: import_zod.z.literal("createRoom"), name: DisplayName.optional(), avatar: Avatar.optional(), pv: Pv, idToken: IdToken }),
+  import_zod.z.object({ t: import_zod.z.literal("createRoom"), name: DisplayName.optional(), avatar: Avatar.optional(), pv: Pv, idToken: IdToken, platform: Platform }),
   // Host sets/changes their display name AFTER createRoom (for anonymous one-tap
   // hosts who started nameless). Host-only; the relay re-broadcasts the lobby.
   import_zod.z.object({ t: import_zod.z.literal("renameHost"), name: DisplayName }),
-  import_zod.z.object({ t: import_zod.z.literal("joinRoom"), code: RoomCode, name: DisplayName, avatar: Avatar.optional(), pv: Pv, idToken: IdToken }),
-  import_zod.z.object({ t: import_zod.z.literal("resume"), code: RoomCode, token: import_zod.z.string().max(120), avatar: Avatar.optional(), pv: Pv, idToken: IdToken }),
+  import_zod.z.object({ t: import_zod.z.literal("joinRoom"), code: RoomCode, name: DisplayName, avatar: Avatar.optional(), pv: Pv, idToken: IdToken, platform: Platform }),
+  import_zod.z.object({ t: import_zod.z.literal("resume"), code: RoomCode, token: import_zod.z.string().max(120), avatar: Avatar.optional(), pv: Pv, idToken: IdToken, platform: Platform }),
   import_zod.z.object({ t: import_zod.z.literal("leaveRoom") }),
   import_zod.z.object({ t: import_zod.z.literal("approve"), playerId: PlayerId }),
   import_zod.z.object({ t: import_zod.z.literal("reject"), playerId: PlayerId }),
@@ -86,6 +87,10 @@ var ClientMsg = import_zod.z.discriminatedUnion("t", [
   import_zod.z.object({ t: import_zod.z.literal("setTeams"), teams: import_zod.z.array(DisplayName).min(1).max(LIMITS.MAX_PLAYERS) }),
   // A player joins team slot `teamIndex` (0-based, into the host's `setTeams` list).
   import_zod.z.object({ t: import_zod.z.literal("pickTeam"), teamIndex: import_zod.z.number().int().min(0).max(LIMITS.MAX_PLAYERS - 1) }),
+  // Host's IN-PROGRESS mode selection in the lobby — a live preview so waiting players see which mode
+  // is coming before start. Distinct from startGame.modeId (which commits it); the relay defaults
+  // startGame to this when modeId is omitted. Re-broadcasts the lobby.
+  import_zod.z.object({ t: import_zod.z.literal("setMode"), modeId: import_zod.z.enum(MODE_IDS) }),
   // Host signals it's busy configuring the game (categories/rounds/mode) so waiting players can show
   // a "host is setting up…" state instead of a frozen-looking lobby. 'idle' when the settings close.
   import_zod.z.object({ t: import_zod.z.literal("hostActivity"), activity: import_zod.z.enum(["configuring", "idle"]) }),

package/dist/index.d.cts

@@ -75,6 +75,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     }>>;
     pv: z.ZodOptional<z.ZodNumber>;
     idToken: z.ZodOptional<z.ZodString>;
+    platform: z.ZodOptional<z.ZodEnum<["web", "ios", "android"]>>;
 }, "strip", z.ZodTypeAny, {
     t: "createRoom";
     name?: string | undefined;
@@ -84,6 +85,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     } | undefined;
     pv?: number | undefined;
     idToken?: string | undefined;
+    platform?: "web" | "ios" | "android" | undefined;
 }, {
     t: "createRoom";
     name?: string | undefined;
@@ -93,6 +95,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     } | undefined;
     pv?: number | undefined;
     idToken?: string | undefined;
+    platform?: "web" | "ios" | "android" | undefined;
 }>, z.ZodObject<{
     t: z.ZodLiteral<"renameHost">;
     name: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
@@ -118,6 +121,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     }>>;
     pv: z.ZodOptional<z.ZodNumber>;
     idToken: z.ZodOptional<z.ZodString>;
+    platform: z.ZodOptional<z.ZodEnum<["web", "ios", "android"]>>;
 }, "strip", z.ZodTypeAny, {
     code: string;
     t: "joinRoom";
@@ -128,6 +132,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     } | undefined;
     pv?: number | undefined;
     idToken?: string | undefined;
+    platform?: "web" | "ios" | "android" | undefined;
 }, {
     code: string;
     t: "joinRoom";
@@ -138,6 +143,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     } | undefined;
     pv?: number | undefined;
     idToken?: string | undefined;
+    platform?: "web" | "ios" | "android" | undefined;
 }>, z.ZodObject<{
     t: z.ZodLiteral<"resume">;
     code: z.ZodString;
@@ -154,6 +160,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     }>>;
     pv: z.ZodOptional<z.ZodNumber>;
     idToken: z.ZodOptional<z.ZodString>;
+    platform: z.ZodOptional<z.ZodEnum<["web", "ios", "android"]>>;
 }, "strip", z.ZodTypeAny, {
     code: string;
     t: "resume";
@@ -164,6 +171,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     } | undefined;
     pv?: number | undefined;
     idToken?: string | undefined;
+    platform?: "web" | "ios" | "android" | undefined;
 }, {
     code: string;
     t: "resume";
@@ -174,6 +182,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     } | undefined;
     pv?: number | undefined;
     idToken?: string | undefined;
+    platform?: "web" | "ios" | "android" | undefined;
 }>, z.ZodObject<{
     t: z.ZodLiteral<"leaveRoom">;
 }, "strip", z.ZodTypeAny, {
@@ -234,6 +243,15 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
 }, {
     t: "pickTeam";
     teamIndex: number;
+}>, z.ZodObject<{
+    t: z.ZodLiteral<"setMode">;
+    modeId: z.ZodEnum<["solo", "oneDevice", "snag", "multiplayer"]>;
+}, "strip", z.ZodTypeAny, {
+    t: "setMode";
+    modeId: "solo" | "oneDevice" | "snag" | "multiplayer";
+}, {
+    t: "setMode";
+    modeId: "solo" | "oneDevice" | "snag" | "multiplayer";
 }>, z.ZodObject<{
     t: z.ZodLiteral<"hostActivity">;
     activity: z.ZodEnum<["configuring", "idle"]>;
@@ -255,16 +273,16 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     t: "startGame";
     categoryIds: string[];
     totalRounds: number;
-    game?: "trivia" | undefined;
     modeId?: "solo" | "oneDevice" | "snag" | "multiplayer" | undefined;
+    game?: "trivia" | undefined;
     buzzerMode?: "solo" | "off" | "race" | "controller" | undefined;
     noHost?: boolean | undefined;
 }, {
     t: "startGame";
     categoryIds: string[];
     totalRounds: number;
-    game?: "trivia" | undefined;
     modeId?: "solo" | "oneDevice" | "snag" | "multiplayer" | undefined;
+    game?: "trivia" | undefined;
     buzzerMode?: "solo" | "off" | "race" | "controller" | undefined;
     noHost?: boolean | undefined;
 }>, z.ZodObject<{
@@ -406,6 +424,8 @@ interface CategoryView {
     packName: string;
     icon: string;
     hasImage: boolean;
+    /** Category's brand color (hex, e.g. '#E8473F') for board coloring; absent if the category has none. */
+    color?: string;
 }
 type GameStatus = 'setup' | 'categorySelection' | 'inProgress' | 'completed';
 type GameplayFlow = 'classic' | 'openJudged' | 'noHost' | 'buzzer';
@@ -425,11 +445,13 @@ interface TeamView {
         type: HelpName;
         isUsed: boolean;
     }[];
-    /** The team's players in rotation order. Empty for host-run single-device teams. */
+    /** The team's players in rotation order (`connected` = that player's socket is online right now).
+     *  Empty for host-run single-device teams. */
     players: {
         id: string;
         name: string;
         emoji: string;
+        connected: boolean;
     }[];
     /** The player on THIS team whose turn it is to answer (rotates each turn); null if the team has
      *  no seated players. In controller mode only this player may `answer` on the team's turn. */
@@ -554,6 +576,7 @@ type ServerMsg = {
     selectedCategoryIds: string[];
     teams: TeamSlotView[];
     hostActivity: 'configuring' | 'idle';
+    modeId: ModeId | null;
     you: YouContext;
 } | {
     t: 'state';
@@ -566,6 +589,10 @@ type ServerMsg = {
     effects: Effect[];
 } | {
     t: 'reported';
+} | {
+    t: 'serverNotice';
+    message: string;
+    restartInSec?: number;
 } | {
     t: 'error';
     code: string;

package/dist/index.d.ts

@@ -75,6 +75,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     }>>;
     pv: z.ZodOptional<z.ZodNumber>;
     idToken: z.ZodOptional<z.ZodString>;
+    platform: z.ZodOptional<z.ZodEnum<["web", "ios", "android"]>>;
 }, "strip", z.ZodTypeAny, {
     t: "createRoom";
     name?: string | undefined;
@@ -84,6 +85,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     } | undefined;
     pv?: number | undefined;
     idToken?: string | undefined;
+    platform?: "web" | "ios" | "android" | undefined;
 }, {
     t: "createRoom";
     name?: string | undefined;
@@ -93,6 +95,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     } | undefined;
     pv?: number | undefined;
     idToken?: string | undefined;
+    platform?: "web" | "ios" | "android" | undefined;
 }>, z.ZodObject<{
     t: z.ZodLiteral<"renameHost">;
     name: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
@@ -118,6 +121,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     }>>;
     pv: z.ZodOptional<z.ZodNumber>;
     idToken: z.ZodOptional<z.ZodString>;
+    platform: z.ZodOptional<z.ZodEnum<["web", "ios", "android"]>>;
 }, "strip", z.ZodTypeAny, {
     code: string;
     t: "joinRoom";
@@ -128,6 +132,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     } | undefined;
     pv?: number | undefined;
     idToken?: string | undefined;
+    platform?: "web" | "ios" | "android" | undefined;
 }, {
     code: string;
     t: "joinRoom";
@@ -138,6 +143,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     } | undefined;
     pv?: number | undefined;
     idToken?: string | undefined;
+    platform?: "web" | "ios" | "android" | undefined;
 }>, z.ZodObject<{
     t: z.ZodLiteral<"resume">;
     code: z.ZodString;
@@ -154,6 +160,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     }>>;
     pv: z.ZodOptional<z.ZodNumber>;
     idToken: z.ZodOptional<z.ZodString>;
+    platform: z.ZodOptional<z.ZodEnum<["web", "ios", "android"]>>;
 }, "strip", z.ZodTypeAny, {
     code: string;
     t: "resume";
@@ -164,6 +171,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     } | undefined;
     pv?: number | undefined;
     idToken?: string | undefined;
+    platform?: "web" | "ios" | "android" | undefined;
 }, {
     code: string;
     t: "resume";
@@ -174,6 +182,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     } | undefined;
     pv?: number | undefined;
     idToken?: string | undefined;
+    platform?: "web" | "ios" | "android" | undefined;
 }>, z.ZodObject<{
     t: z.ZodLiteral<"leaveRoom">;
 }, "strip", z.ZodTypeAny, {
@@ -234,6 +243,15 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
 }, {
     t: "pickTeam";
     teamIndex: number;
+}>, z.ZodObject<{
+    t: z.ZodLiteral<"setMode">;
+    modeId: z.ZodEnum<["solo", "oneDevice", "snag", "multiplayer"]>;
+}, "strip", z.ZodTypeAny, {
+    t: "setMode";
+    modeId: "solo" | "oneDevice" | "snag" | "multiplayer";
+}, {
+    t: "setMode";
+    modeId: "solo" | "oneDevice" | "snag" | "multiplayer";
 }>, z.ZodObject<{
     t: z.ZodLiteral<"hostActivity">;
     activity: z.ZodEnum<["configuring", "idle"]>;
@@ -255,16 +273,16 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     t: "startGame";
     categoryIds: string[];
     totalRounds: number;
-    game?: "trivia" | undefined;
     modeId?: "solo" | "oneDevice" | "snag" | "multiplayer" | undefined;
+    game?: "trivia" | undefined;
     buzzerMode?: "solo" | "off" | "race" | "controller" | undefined;
     noHost?: boolean | undefined;
 }, {
     t: "startGame";
     categoryIds: string[];
     totalRounds: number;
-    game?: "trivia" | undefined;
     modeId?: "solo" | "oneDevice" | "snag" | "multiplayer" | undefined;
+    game?: "trivia" | undefined;
     buzzerMode?: "solo" | "off" | "race" | "controller" | undefined;
     noHost?: boolean | undefined;
 }>, z.ZodObject<{
@@ -406,6 +424,8 @@ interface CategoryView {
     packName: string;
     icon: string;
     hasImage: boolean;
+    /** Category's brand color (hex, e.g. '#E8473F') for board coloring; absent if the category has none. */
+    color?: string;
 }
 type GameStatus = 'setup' | 'categorySelection' | 'inProgress' | 'completed';
 type GameplayFlow = 'classic' | 'openJudged' | 'noHost' | 'buzzer';
@@ -425,11 +445,13 @@ interface TeamView {
         type: HelpName;
         isUsed: boolean;
     }[];
-    /** The team's players in rotation order. Empty for host-run single-device teams. */
+    /** The team's players in rotation order (`connected` = that player's socket is online right now).
+     *  Empty for host-run single-device teams. */
     players: {
         id: string;
         name: string;
         emoji: string;
+        connected: boolean;
     }[];
     /** The player on THIS team whose turn it is to answer (rotates each turn); null if the team has
      *  no seated players. In controller mode only this player may `answer` on the team's turn. */
@@ -554,6 +576,7 @@ type ServerMsg = {
     selectedCategoryIds: string[];
     teams: TeamSlotView[];
     hostActivity: 'configuring' | 'idle';
+    modeId: ModeId | null;
     you: YouContext;
 } | {
     t: 'state';
@@ -566,6 +589,10 @@ type ServerMsg = {
     effects: Effect[];
 } | {
     t: 'reported';
+} | {
+    t: 'serverNotice';
+    message: string;
+    restartInSec?: number;
 } | {
     t: 'error';
     code: string;

package/dist/index.js

@@ -32,18 +32,19 @@ var HelpType = z.enum([
 ]);
 var Pv = z.number().int().min(1).max(1e6).optional();
 var IdToken = z.string().max(4096).optional();
+var Platform = z.enum(["web", "ios", "android"]).optional();
 var Avatar = z.object({
   emoji: z.string().min(1).max(16).transform((s) => s.replace(UNSAFE_CHARS, "")).refine((s) => s.length >= 1, "empty emoji"),
   color: z.string().regex(/^#[0-9a-fA-F]{6}$/, "color must be #rrggbb")
 });
 var ClientMsg = z.discriminatedUnion("t", [
   // room / lobby
-  z.object({ t: z.literal("createRoom"), name: DisplayName.optional(), avatar: Avatar.optional(), pv: Pv, idToken: IdToken }),
+  z.object({ t: z.literal("createRoom"), name: DisplayName.optional(), avatar: Avatar.optional(), pv: Pv, idToken: IdToken, platform: Platform }),
   // Host sets/changes their display name AFTER createRoom (for anonymous one-tap
   // hosts who started nameless). Host-only; the relay re-broadcasts the lobby.
   z.object({ t: z.literal("renameHost"), name: DisplayName }),
-  z.object({ t: z.literal("joinRoom"), code: RoomCode, name: DisplayName, avatar: Avatar.optional(), pv: Pv, idToken: IdToken }),
-  z.object({ t: z.literal("resume"), code: RoomCode, token: z.string().max(120), avatar: Avatar.optional(), pv: Pv, idToken: IdToken }),
+  z.object({ t: z.literal("joinRoom"), code: RoomCode, name: DisplayName, avatar: Avatar.optional(), pv: Pv, idToken: IdToken, platform: Platform }),
+  z.object({ t: z.literal("resume"), code: RoomCode, token: z.string().max(120), avatar: Avatar.optional(), pv: Pv, idToken: IdToken, platform: Platform }),
   z.object({ t: z.literal("leaveRoom") }),
   z.object({ t: z.literal("approve"), playerId: PlayerId }),
   z.object({ t: z.literal("reject"), playerId: PlayerId }),
@@ -55,6 +56,10 @@ var ClientMsg = z.discriminatedUnion("t", [
   z.object({ t: z.literal("setTeams"), teams: z.array(DisplayName).min(1).max(LIMITS.MAX_PLAYERS) }),
   // A player joins team slot `teamIndex` (0-based, into the host's `setTeams` list).
   z.object({ t: z.literal("pickTeam"), teamIndex: z.number().int().min(0).max(LIMITS.MAX_PLAYERS - 1) }),
+  // Host's IN-PROGRESS mode selection in the lobby — a live preview so waiting players see which mode
+  // is coming before start. Distinct from startGame.modeId (which commits it); the relay defaults
+  // startGame to this when modeId is omitted. Re-broadcasts the lobby.
+  z.object({ t: z.literal("setMode"), modeId: z.enum(MODE_IDS) }),
   // Host signals it's busy configuring the game (categories/rounds/mode) so waiting players can show
   // a "host is setting up…" state instead of a frozen-looking lobby. 'idle' when the settings close.
   z.object({ t: z.literal("hostActivity"), activity: z.enum(["configuring", "idle"]) }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thegeem/protocol",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "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",