@thegeem/protocol 0.1.20 → 0.1.22

package/dist/index.cjs

@@ -95,7 +95,17 @@ var ClientMsg = import_zod.z.discriminatedUnion("t", [
   import_zod.z.object({ t: import_zod.z.literal("createRoom"), name: DisplayName.optional(), avatar: Avatar.optional(), game: import_zod.z.enum(GAME_IDS).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.
+  // SUPERSEDED by setProfile (kept working for shipped builds).
   import_zod.z.object({ t: import_zod.z.literal("renameHost"), name: DisplayName }),
+  // ANY room member changes their OWN display identity mid-room (gs#48) — lobby or mid-game.
+  // One message for both fields because the client's picker edits them together: one atomic
+  // update, one re-broadcast, no half-changed roster. Send either field or both; sending
+  // neither is a no-op. SELF-ONLY by construction — the server always applies it to the
+  // SENDER's seat, so there is no playerId to spoof. Additive: no pv bump.
+  // Note: mid-game propagation depends on what the running game's state carries — trivia's
+  // view carries names+avatars so it updates live; dama/ersimha views are id-keyed (clients
+  // map ids→names from the lobby roster), so a change there lands on the next lobby.
+  import_zod.z.object({ t: import_zod.z.literal("setProfile"), name: DisplayName.optional(), avatar: Avatar.optional() }),
   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") }),
@@ -125,6 +135,14 @@ var ClientMsg = import_zod.z.discriminatedUnion("t", [
     totalRounds: import_zod.z.number().int().min(1).max(50),
     categoryIds: import_zod.z.array(import_zod.z.string().max(60)).min(0).max(12),
     // empty for games without categories (Dama); trivia rejects empty in-handler
+    // Is the HOST a participant, or just running the room on the TV? Additive, no pv bump.
+    // ⚠ The DEFAULT when omitted is PER-GAME (each game's shipped behavior is preserved):
+    //   • ersimha (gs#45): omit/false = host stays the TV/spectator (D-030 MVP shape);
+    //     true = host joins the drawer rotation as first drawer — a pair plays on 2 devices.
+    //   • dama (gs#47, D-037): omit/true = host plays black (the original 1v1 shape);
+    //     false = the first two approved joiners take the board and the host WATCHES
+    //     (yourColor:null) while keeping every host power. Needs 2 approved joiners.
+    hostPlays: import_zod.z.boolean().optional(),
     // PREFERRED: pick a mode from the registry (see MODES). The server maps it to the engine
     // rules. Send this and omit buzzerMode/noHost. Falls back to the legacy flags below if omitted.
     modeId: import_zod.z.enum(MODE_IDS).optional(),

package/dist/index.d.cts

@@ -134,6 +134,33 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
 }, {
     t: "renameHost";
     name: string;
+}>, z.ZodObject<{
+    t: z.ZodLiteral<"setProfile">;
+    name: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
+    avatar: z.ZodOptional<z.ZodObject<{
+        emoji: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+        color: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        emoji: string;
+        color: string;
+    }, {
+        emoji: string;
+        color: string;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    t: "setProfile";
+    name?: string | undefined;
+    avatar?: {
+        emoji: string;
+        color: string;
+    } | undefined;
+}, {
+    t: "setProfile";
+    name?: string | undefined;
+    avatar?: {
+        emoji: string;
+        color: string;
+    } | undefined;
 }>, z.ZodObject<{
     t: z.ZodLiteral<"joinRoom">;
     code: z.ZodString;
@@ -295,6 +322,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     game: z.ZodOptional<z.ZodEnum<["seedha", "snag", "trivia", "dama", "ersimha"]>>;
     totalRounds: z.ZodNumber;
     categoryIds: z.ZodArray<z.ZodString, "many">;
+    hostPlays: z.ZodOptional<z.ZodBoolean>;
     modeId: z.ZodOptional<z.ZodEnum<["solo", "oneDevice", "snag", "multiplayer"]>>;
     buzzerMode: z.ZodOptional<z.ZodEnum<["off", "solo", "race", "controller"]>>;
     noHost: z.ZodOptional<z.ZodBoolean>;
@@ -304,6 +332,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     totalRounds: number;
     game?: "seedha" | "snag" | "trivia" | "dama" | "ersimha" | undefined;
     modeId?: "snag" | "solo" | "oneDevice" | "multiplayer" | undefined;
+    hostPlays?: boolean | undefined;
     buzzerMode?: "solo" | "off" | "race" | "controller" | undefined;
     noHost?: boolean | undefined;
 }, {
@@ -312,6 +341,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     totalRounds: number;
     game?: "seedha" | "snag" | "trivia" | "dama" | "ersimha" | undefined;
     modeId?: "snag" | "solo" | "oneDevice" | "multiplayer" | undefined;
+    hostPlays?: boolean | undefined;
     buzzerMode?: "solo" | "off" | "race" | "controller" | undefined;
     noHost?: boolean | undefined;
 }>, z.ZodObject<{

package/dist/index.d.ts

@@ -134,6 +134,33 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
 }, {
     t: "renameHost";
     name: string;
+}>, z.ZodObject<{
+    t: z.ZodLiteral<"setProfile">;
+    name: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
+    avatar: z.ZodOptional<z.ZodObject<{
+        emoji: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+        color: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        emoji: string;
+        color: string;
+    }, {
+        emoji: string;
+        color: string;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    t: "setProfile";
+    name?: string | undefined;
+    avatar?: {
+        emoji: string;
+        color: string;
+    } | undefined;
+}, {
+    t: "setProfile";
+    name?: string | undefined;
+    avatar?: {
+        emoji: string;
+        color: string;
+    } | undefined;
 }>, z.ZodObject<{
     t: z.ZodLiteral<"joinRoom">;
     code: z.ZodString;
@@ -295,6 +322,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     game: z.ZodOptional<z.ZodEnum<["seedha", "snag", "trivia", "dama", "ersimha"]>>;
     totalRounds: z.ZodNumber;
     categoryIds: z.ZodArray<z.ZodString, "many">;
+    hostPlays: z.ZodOptional<z.ZodBoolean>;
     modeId: z.ZodOptional<z.ZodEnum<["solo", "oneDevice", "snag", "multiplayer"]>>;
     buzzerMode: z.ZodOptional<z.ZodEnum<["off", "solo", "race", "controller"]>>;
     noHost: z.ZodOptional<z.ZodBoolean>;
@@ -304,6 +332,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     totalRounds: number;
     game?: "seedha" | "snag" | "trivia" | "dama" | "ersimha" | undefined;
     modeId?: "snag" | "solo" | "oneDevice" | "multiplayer" | undefined;
+    hostPlays?: boolean | undefined;
     buzzerMode?: "solo" | "off" | "race" | "controller" | undefined;
     noHost?: boolean | undefined;
 }, {
@@ -312,6 +341,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     totalRounds: number;
     game?: "seedha" | "snag" | "trivia" | "dama" | "ersimha" | undefined;
     modeId?: "snag" | "solo" | "oneDevice" | "multiplayer" | undefined;
+    hostPlays?: boolean | undefined;
     buzzerMode?: "solo" | "off" | "race" | "controller" | undefined;
     noHost?: boolean | undefined;
 }>, z.ZodObject<{

package/dist/index.js

@@ -60,7 +60,17 @@ var ClientMsg = z.discriminatedUnion("t", [
   z.object({ t: z.literal("createRoom"), name: DisplayName.optional(), avatar: Avatar.optional(), game: z.enum(GAME_IDS).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.
+  // SUPERSEDED by setProfile (kept working for shipped builds).
   z.object({ t: z.literal("renameHost"), name: DisplayName }),
+  // ANY room member changes their OWN display identity mid-room (gs#48) — lobby or mid-game.
+  // One message for both fields because the client's picker edits them together: one atomic
+  // update, one re-broadcast, no half-changed roster. Send either field or both; sending
+  // neither is a no-op. SELF-ONLY by construction — the server always applies it to the
+  // SENDER's seat, so there is no playerId to spoof. Additive: no pv bump.
+  // Note: mid-game propagation depends on what the running game's state carries — trivia's
+  // view carries names+avatars so it updates live; dama/ersimha views are id-keyed (clients
+  // map ids→names from the lobby roster), so a change there lands on the next lobby.
+  z.object({ t: z.literal("setProfile"), name: DisplayName.optional(), avatar: Avatar.optional() }),
   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") }),
@@ -90,6 +100,14 @@ var ClientMsg = z.discriminatedUnion("t", [
     totalRounds: z.number().int().min(1).max(50),
     categoryIds: z.array(z.string().max(60)).min(0).max(12),
     // empty for games without categories (Dama); trivia rejects empty in-handler
+    // Is the HOST a participant, or just running the room on the TV? Additive, no pv bump.
+    // ⚠ The DEFAULT when omitted is PER-GAME (each game's shipped behavior is preserved):
+    //   • ersimha (gs#45): omit/false = host stays the TV/spectator (D-030 MVP shape);
+    //     true = host joins the drawer rotation as first drawer — a pair plays on 2 devices.
+    //   • dama (gs#47, D-037): omit/true = host plays black (the original 1v1 shape);
+    //     false = the first two approved joiners take the board and the host WATCHES
+    //     (yourColor:null) while keeping every host power. Needs 2 approved joiners.
+    hostPlays: z.boolean().optional(),
     // PREFERRED: pick a mode from the registry (see MODES). The server maps it to the engine
     // rules. Send this and omit buzzerMode/noHost. Falls back to the legacy flags below if omitted.
     modeId: z.enum(MODE_IDS).optional(),

package/package.json

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