@thegeem/protocol 0.1.19 → 0.1.21

package/dist/index.cjs

@@ -39,16 +39,21 @@ var LIMITS = {
   MAX_NAME_LEN: 20,
   ROOM_CODE_LEN: 4,
   MAX_PLAYERS: 12,
-  MAX_MSG_PER_SEC: 8
+  MAX_MSG_PER_SEC: 8,
+  /** Ersimha strokes ride a SEPARATE per-socket lane (general msgs keep MAX_MSG_PER_SEC).
+   *  Clients batch pen points to stay under this — ~150ms batching lands at ~7/sec. */
+  STROKE_BATCH_PER_SEC: 20
 };
-var PROTOCOL_VERSION = 3;
+var PROTOCOL_VERSION = 4;
 var MIN_SUPPORTED_PV = 1;
-var GAME_IDS = ["seedha", "snag", "trivia", "dama"];
+var GAME_IDS = ["seedha", "snag", "trivia", "dama", "ersimha"];
 var GAMES = [
   { id: "seedha", label: "Seedha", minPv: 2 },
   { id: "snag", label: "Snag", minPv: 2 },
   { id: "dama", label: "Dama", minPv: 3 },
   // engine #2 (D-027) — offered only to pv≥3 clients
+  { id: "ersimha", label: "Ersimha", minPv: 4 },
+  // engine #3 (D-030) draw-and-guess — offered only to pv≥4 clients
   { id: "trivia", label: "Trivia", minPv: 1, deprecated: true }
 ];
 var gamesForPv = (pv) => GAMES.filter((g) => !g.deprecated && g.minPv <= pv);
@@ -120,6 +125,10 @@ 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
+    // Ersimha (gs#45): include the HOST connection in the drawer rotation (host draws/buzzes like a
+    // player; first drawer, Dama-parity) — a pair plays with 2 devices, no separate TV connection.
+    // Omit/false = the host stays the room's TV/spectator (the D-030 MVP shape). Additive, no pv bump.
+    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(),
@@ -168,7 +177,28 @@ var ClientMsg = import_zod.z.discriminatedUnion("t", [
     path: import_zod.z.array(import_zod.z.object({ r: import_zod.z.number().int().min(0).max(7), c: import_zod.z.number().int().min(0).max(7) })).max(12).optional()
   }),
   // Resign the current Dama game (concede) → opponent wins.
-  import_zod.z.object({ t: import_zod.z.literal("damaResign") })
+  import_zod.z.object({ t: import_zod.z.literal("damaResign") }),
+  // ── Ersimha slice (gameId 'ersimha', engine #3 — D-030) ──
+  // Drawer streams stroke points as batches. Coordinates are NORMALIZED [0,1] floats (device-
+  // independent — every client and the TV scale to their own canvas). The relay is a pure
+  // PASSTHROUGH: strokes are validated, rate-limited, fanned out, and NEVER stored (ephemeral
+  // drawings, D-030). `seq` orders batches within one stroke; a new strokeId = pen-down.
+  import_zod.z.object({
+    t: import_zod.z.literal("strokeBatch"),
+    strokeId: import_zod.z.string().min(1).max(40),
+    seq: import_zod.z.number().int().min(0).max(1e4),
+    points: import_zod.z.array(import_zod.z.object({ x: import_zod.z.number().min(0).max(1), y: import_zod.z.number().min(0).max(1) })).min(1).max(128),
+    color: import_zod.z.string().regex(/^#[0-9a-fA-F]{6}$/),
+    width: import_zod.z.number().min(1).max(64)
+  }),
+  // Drawer wipes the canvas (relayed to everyone).
+  import_zod.z.object({ t: import_zod.z.literal("clearCanvas") }),
+  // Drawer removes one stroke — the given id, or their latest when omitted (relayed).
+  import_zod.z.object({ t: import_zod.z.literal("undoStroke"), strokeId: import_zod.z.string().min(1).max(40).optional() }),
+  // Drawer rules the CURRENT buzzer's spoken guess صح/خطأ (guessing is out loud — no text on the wire).
+  import_zod.z.object({ t: import_zod.z.literal("judgeGuess"), correct: import_zod.z.boolean() }),
+  // Drawer passes on the served word (capped per draw-turn; relay serves a fresh one).
+  import_zod.z.object({ t: import_zod.z.literal("skipWord") })
 ]);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/index.d.cts

@@ -14,6 +14,9 @@ declare const LIMITS: {
     readonly ROOM_CODE_LEN: 4;
     readonly MAX_PLAYERS: 12;
     readonly MAX_MSG_PER_SEC: 8;
+    /** Ersimha strokes ride a SEPARATE per-socket lane (general msgs keep MAX_MSG_PER_SEC).
+     *  Clients batch pen points to stay under this — ~150ms batching lands at ~7/sec. */
+    readonly STROKE_BATCH_PER_SEC: 20;
 };
 /**
  * Wire-format generation. **Bump ONLY on a breaking change** to ClientMsg /
@@ -33,7 +36,7 @@ declare const LIMITS: {
  *    `seedha`/`snag`). Raise the floor SLOWLY to retire ancient builds. Unversioned clients (no `pv`,
  *    e.g. the legacy web harness) are treated as the floor and never rejected.
  */
-declare const PROTOCOL_VERSION = 3;
+declare const PROTOCOL_VERSION = 4;
 declare const MIN_SUPPORTED_PV = 1;
 /**
  * Geem is a PLATFORM of GAMES (jackbox-style). The trivia board split (D-023) into TWO player-facing
@@ -42,7 +45,7 @@ declare const MIN_SUPPORTED_PV = 1;
  * pre-pv2 clients (they never saw seedha/snag), and what old clients send on startGame. Every room
  * runs one game, identified by `gameId`.
  */
-declare const GAME_IDS: readonly ["seedha", "snag", "trivia", "dama"];
+declare const GAME_IDS: readonly ["seedha", "snag", "trivia", "dama", "ersimha"];
 type GameId = (typeof GAME_IDS)[number];
 /**
  * The GAME REGISTRY — player-facing games + the version gating (D-024/D-025). A client renders a tile
@@ -96,7 +99,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
         emoji: string;
         color: string;
     }>>;
-    game: z.ZodOptional<z.ZodEnum<["seedha", "snag", "trivia", "dama"]>>;
+    game: z.ZodOptional<z.ZodEnum<["seedha", "snag", "trivia", "dama", "ersimha"]>>;
     pv: z.ZodOptional<z.ZodNumber>;
     idToken: z.ZodOptional<z.ZodString>;
     platform: z.ZodOptional<z.ZodEnum<["web", "ios", "android"]>>;
@@ -107,7 +110,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
         emoji: string;
         color: string;
     } | undefined;
-    game?: "seedha" | "snag" | "trivia" | "dama" | undefined;
+    game?: "seedha" | "snag" | "trivia" | "dama" | "ersimha" | undefined;
     pv?: number | undefined;
     idToken?: string | undefined;
     platform?: "web" | "ios" | "android" | undefined;
@@ -118,7 +121,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
         emoji: string;
         color: string;
     } | undefined;
-    game?: "seedha" | "snag" | "trivia" | "dama" | undefined;
+    game?: "seedha" | "snag" | "trivia" | "dama" | "ersimha" | undefined;
     pv?: number | undefined;
     idToken?: string | undefined;
     platform?: "web" | "ios" | "android" | undefined;
@@ -289,9 +292,10 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     activity: "configuring" | "idle";
 }>, z.ZodObject<{
     t: z.ZodLiteral<"startGame">;
-    game: z.ZodOptional<z.ZodEnum<["seedha", "snag", "trivia", "dama"]>>;
+    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>;
@@ -299,16 +303,18 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     t: "startGame";
     categoryIds: string[];
     totalRounds: number;
-    game?: "seedha" | "snag" | "trivia" | "dama" | undefined;
+    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;
 }, {
     t: "startGame";
     categoryIds: string[];
     totalRounds: number;
-    game?: "seedha" | "snag" | "trivia" | "dama" | undefined;
+    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<{
@@ -488,6 +494,72 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     t: "damaResign";
 }, {
     t: "damaResign";
+}>, z.ZodObject<{
+    t: z.ZodLiteral<"strokeBatch">;
+    strokeId: z.ZodString;
+    seq: z.ZodNumber;
+    points: z.ZodArray<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        x: number;
+        y: number;
+    }, {
+        x: number;
+        y: number;
+    }>, "many">;
+    color: z.ZodString;
+    width: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    color: string;
+    t: "strokeBatch";
+    strokeId: string;
+    seq: number;
+    points: {
+        x: number;
+        y: number;
+    }[];
+    width: number;
+}, {
+    color: string;
+    t: "strokeBatch";
+    strokeId: string;
+    seq: number;
+    points: {
+        x: number;
+        y: number;
+    }[];
+    width: number;
+}>, z.ZodObject<{
+    t: z.ZodLiteral<"clearCanvas">;
+}, "strip", z.ZodTypeAny, {
+    t: "clearCanvas";
+}, {
+    t: "clearCanvas";
+}>, z.ZodObject<{
+    t: z.ZodLiteral<"undoStroke">;
+    strokeId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    t: "undoStroke";
+    strokeId?: string | undefined;
+}, {
+    t: "undoStroke";
+    strokeId?: string | undefined;
+}>, z.ZodObject<{
+    t: z.ZodLiteral<"judgeGuess">;
+    correct: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    t: "judgeGuess";
+    correct: boolean;
+}, {
+    t: "judgeGuess";
+    correct: boolean;
+}>, z.ZodObject<{
+    t: z.ZodLiteral<"skipWord">;
+}, "strip", z.ZodTypeAny, {
+    t: "skipWord";
+}, {
+    t: "skipWord";
 }>]>;
 type ClientMsg = z.infer<typeof ClientMsg>;
 /** A player's privacy-safe avatar (emoji + circle color) for in-room display. */
@@ -673,6 +745,33 @@ interface DamaStateView {
     legalMoves: DamaMoveView[];
     moveCount: number;
 }
+/**
+ * The authoritative Ersimha round state. Anti-cheat boundary (D-030): `word` is set ONLY in the
+ * payload sent to the DRAWER's connection — guessers and the TV get `maskedWord` (per-segment
+ * letter counts, «سيارة إسعاف» → [5,5]). Names/avatars come from the lobby roster (map by id),
+ * same as Dama. Strokes are NOT in the state — they stream as `strokeBatch` passthroughs and a
+ * late joiner simply starts from a blank canvas (ephemeral by design).
+ */
+interface ErsimhaStateView {
+    phase: 'choosing' | 'drawing' | 'judging' | 'roundEnd' | 'completed';
+    drawerId: string;
+    judgedId: string | null;
+    turn: number;
+    totalTurns: number;
+    scores: {
+        id: string;
+        score: number;
+    }[];
+    maskedWord: number[];
+    word: string | null;
+    buzzQueue: string[];
+    lockedOut: string[];
+    canBuzz: boolean;
+    skipsLeft: number;
+    lastWord: string | null;
+    lastWinnerId: string | null;
+    timerRemainingMs: number | null;
+}
 type ServerMsg = {
     t: 'roomCreated';
     code: string;
@@ -722,6 +821,29 @@ type ServerMsg = {
     gameId: 'dama';
     view: DamaStateView;
     you: YouContext;
+} | {
+    t: 'ersimhaState';
+    gameId: 'ersimha';
+    view: ErsimhaStateView;
+    you: YouContext;
+} | {
+    t: 'strokeBatch';
+    from: string;
+    strokeId: string;
+    seq: number;
+    points: {
+        x: number;
+        y: number;
+    }[];
+    color: string;
+    width: number;
+} | {
+    t: 'clearCanvas';
+    from: string;
+} | {
+    t: 'undoStroke';
+    from: string;
+    strokeId: string | null;
 } | {
     t: 'fx';
     effects: Effect[];
@@ -738,4 +860,4 @@ type ServerMsg = {
     message: string;
 };
 
-export { type AvatarView, type BuzzerGameMode, type CategoryView, ClientMsg, type DamaMoveView, type DamaPieceView, type DamaStateView, type Effect, GAMES, GAME_IDS, type GameId, type GameInfo, type GameStateView, type GameStatus, type GameplayFlow, type HelpName, LIMITS, type LobbyPlayer, MIN_SUPPORTED_PV, MODES, MODE_IDS, type ModeId, type ModeInfo, PROTOCOL_VERSION, type QuestionView, ROOM_ALPHABET, type ServerMsg, type SoundName, type TeamSlotView, type TeamView, type YouContext, gameIdForPv, gamesForPv, modesForGame };
+export { type AvatarView, type BuzzerGameMode, type CategoryView, ClientMsg, type DamaMoveView, type DamaPieceView, type DamaStateView, type Effect, type ErsimhaStateView, GAMES, GAME_IDS, type GameId, type GameInfo, type GameStateView, type GameStatus, type GameplayFlow, type HelpName, LIMITS, type LobbyPlayer, MIN_SUPPORTED_PV, MODES, MODE_IDS, type ModeId, type ModeInfo, PROTOCOL_VERSION, type QuestionView, ROOM_ALPHABET, type ServerMsg, type SoundName, type TeamSlotView, type TeamView, type YouContext, gameIdForPv, gamesForPv, modesForGame };

package/dist/index.d.ts

@@ -14,6 +14,9 @@ declare const LIMITS: {
     readonly ROOM_CODE_LEN: 4;
     readonly MAX_PLAYERS: 12;
     readonly MAX_MSG_PER_SEC: 8;
+    /** Ersimha strokes ride a SEPARATE per-socket lane (general msgs keep MAX_MSG_PER_SEC).
+     *  Clients batch pen points to stay under this — ~150ms batching lands at ~7/sec. */
+    readonly STROKE_BATCH_PER_SEC: 20;
 };
 /**
  * Wire-format generation. **Bump ONLY on a breaking change** to ClientMsg /
@@ -33,7 +36,7 @@ declare const LIMITS: {
  *    `seedha`/`snag`). Raise the floor SLOWLY to retire ancient builds. Unversioned clients (no `pv`,
  *    e.g. the legacy web harness) are treated as the floor and never rejected.
  */
-declare const PROTOCOL_VERSION = 3;
+declare const PROTOCOL_VERSION = 4;
 declare const MIN_SUPPORTED_PV = 1;
 /**
  * Geem is a PLATFORM of GAMES (jackbox-style). The trivia board split (D-023) into TWO player-facing
@@ -42,7 +45,7 @@ declare const MIN_SUPPORTED_PV = 1;
  * pre-pv2 clients (they never saw seedha/snag), and what old clients send on startGame. Every room
  * runs one game, identified by `gameId`.
  */
-declare const GAME_IDS: readonly ["seedha", "snag", "trivia", "dama"];
+declare const GAME_IDS: readonly ["seedha", "snag", "trivia", "dama", "ersimha"];
 type GameId = (typeof GAME_IDS)[number];
 /**
  * The GAME REGISTRY — player-facing games + the version gating (D-024/D-025). A client renders a tile
@@ -96,7 +99,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
         emoji: string;
         color: string;
     }>>;
-    game: z.ZodOptional<z.ZodEnum<["seedha", "snag", "trivia", "dama"]>>;
+    game: z.ZodOptional<z.ZodEnum<["seedha", "snag", "trivia", "dama", "ersimha"]>>;
     pv: z.ZodOptional<z.ZodNumber>;
     idToken: z.ZodOptional<z.ZodString>;
     platform: z.ZodOptional<z.ZodEnum<["web", "ios", "android"]>>;
@@ -107,7 +110,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
         emoji: string;
         color: string;
     } | undefined;
-    game?: "seedha" | "snag" | "trivia" | "dama" | undefined;
+    game?: "seedha" | "snag" | "trivia" | "dama" | "ersimha" | undefined;
     pv?: number | undefined;
     idToken?: string | undefined;
     platform?: "web" | "ios" | "android" | undefined;
@@ -118,7 +121,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
         emoji: string;
         color: string;
     } | undefined;
-    game?: "seedha" | "snag" | "trivia" | "dama" | undefined;
+    game?: "seedha" | "snag" | "trivia" | "dama" | "ersimha" | undefined;
     pv?: number | undefined;
     idToken?: string | undefined;
     platform?: "web" | "ios" | "android" | undefined;
@@ -289,9 +292,10 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     activity: "configuring" | "idle";
 }>, z.ZodObject<{
     t: z.ZodLiteral<"startGame">;
-    game: z.ZodOptional<z.ZodEnum<["seedha", "snag", "trivia", "dama"]>>;
+    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>;
@@ -299,16 +303,18 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     t: "startGame";
     categoryIds: string[];
     totalRounds: number;
-    game?: "seedha" | "snag" | "trivia" | "dama" | undefined;
+    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;
 }, {
     t: "startGame";
     categoryIds: string[];
     totalRounds: number;
-    game?: "seedha" | "snag" | "trivia" | "dama" | undefined;
+    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<{
@@ -488,6 +494,72 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     t: "damaResign";
 }, {
     t: "damaResign";
+}>, z.ZodObject<{
+    t: z.ZodLiteral<"strokeBatch">;
+    strokeId: z.ZodString;
+    seq: z.ZodNumber;
+    points: z.ZodArray<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        x: number;
+        y: number;
+    }, {
+        x: number;
+        y: number;
+    }>, "many">;
+    color: z.ZodString;
+    width: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    color: string;
+    t: "strokeBatch";
+    strokeId: string;
+    seq: number;
+    points: {
+        x: number;
+        y: number;
+    }[];
+    width: number;
+}, {
+    color: string;
+    t: "strokeBatch";
+    strokeId: string;
+    seq: number;
+    points: {
+        x: number;
+        y: number;
+    }[];
+    width: number;
+}>, z.ZodObject<{
+    t: z.ZodLiteral<"clearCanvas">;
+}, "strip", z.ZodTypeAny, {
+    t: "clearCanvas";
+}, {
+    t: "clearCanvas";
+}>, z.ZodObject<{
+    t: z.ZodLiteral<"undoStroke">;
+    strokeId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    t: "undoStroke";
+    strokeId?: string | undefined;
+}, {
+    t: "undoStroke";
+    strokeId?: string | undefined;
+}>, z.ZodObject<{
+    t: z.ZodLiteral<"judgeGuess">;
+    correct: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    t: "judgeGuess";
+    correct: boolean;
+}, {
+    t: "judgeGuess";
+    correct: boolean;
+}>, z.ZodObject<{
+    t: z.ZodLiteral<"skipWord">;
+}, "strip", z.ZodTypeAny, {
+    t: "skipWord";
+}, {
+    t: "skipWord";
 }>]>;
 type ClientMsg = z.infer<typeof ClientMsg>;
 /** A player's privacy-safe avatar (emoji + circle color) for in-room display. */
@@ -673,6 +745,33 @@ interface DamaStateView {
     legalMoves: DamaMoveView[];
     moveCount: number;
 }
+/**
+ * The authoritative Ersimha round state. Anti-cheat boundary (D-030): `word` is set ONLY in the
+ * payload sent to the DRAWER's connection — guessers and the TV get `maskedWord` (per-segment
+ * letter counts, «سيارة إسعاف» → [5,5]). Names/avatars come from the lobby roster (map by id),
+ * same as Dama. Strokes are NOT in the state — they stream as `strokeBatch` passthroughs and a
+ * late joiner simply starts from a blank canvas (ephemeral by design).
+ */
+interface ErsimhaStateView {
+    phase: 'choosing' | 'drawing' | 'judging' | 'roundEnd' | 'completed';
+    drawerId: string;
+    judgedId: string | null;
+    turn: number;
+    totalTurns: number;
+    scores: {
+        id: string;
+        score: number;
+    }[];
+    maskedWord: number[];
+    word: string | null;
+    buzzQueue: string[];
+    lockedOut: string[];
+    canBuzz: boolean;
+    skipsLeft: number;
+    lastWord: string | null;
+    lastWinnerId: string | null;
+    timerRemainingMs: number | null;
+}
 type ServerMsg = {
     t: 'roomCreated';
     code: string;
@@ -722,6 +821,29 @@ type ServerMsg = {
     gameId: 'dama';
     view: DamaStateView;
     you: YouContext;
+} | {
+    t: 'ersimhaState';
+    gameId: 'ersimha';
+    view: ErsimhaStateView;
+    you: YouContext;
+} | {
+    t: 'strokeBatch';
+    from: string;
+    strokeId: string;
+    seq: number;
+    points: {
+        x: number;
+        y: number;
+    }[];
+    color: string;
+    width: number;
+} | {
+    t: 'clearCanvas';
+    from: string;
+} | {
+    t: 'undoStroke';
+    from: string;
+    strokeId: string | null;
 } | {
     t: 'fx';
     effects: Effect[];
@@ -738,4 +860,4 @@ type ServerMsg = {
     message: string;
 };
 
-export { type AvatarView, type BuzzerGameMode, type CategoryView, ClientMsg, type DamaMoveView, type DamaPieceView, type DamaStateView, type Effect, GAMES, GAME_IDS, type GameId, type GameInfo, type GameStateView, type GameStatus, type GameplayFlow, type HelpName, LIMITS, type LobbyPlayer, MIN_SUPPORTED_PV, MODES, MODE_IDS, type ModeId, type ModeInfo, PROTOCOL_VERSION, type QuestionView, ROOM_ALPHABET, type ServerMsg, type SoundName, type TeamSlotView, type TeamView, type YouContext, gameIdForPv, gamesForPv, modesForGame };
+export { type AvatarView, type BuzzerGameMode, type CategoryView, ClientMsg, type DamaMoveView, type DamaPieceView, type DamaStateView, type Effect, type ErsimhaStateView, GAMES, GAME_IDS, type GameId, type GameInfo, type GameStateView, type GameStatus, type GameplayFlow, type HelpName, LIMITS, type LobbyPlayer, MIN_SUPPORTED_PV, MODES, MODE_IDS, type ModeId, type ModeInfo, PROTOCOL_VERSION, type QuestionView, ROOM_ALPHABET, type ServerMsg, type SoundName, type TeamSlotView, type TeamView, type YouContext, gameIdForPv, gamesForPv, modesForGame };

package/dist/index.js

@@ -4,16 +4,21 @@ var LIMITS = {
   MAX_NAME_LEN: 20,
   ROOM_CODE_LEN: 4,
   MAX_PLAYERS: 12,
-  MAX_MSG_PER_SEC: 8
+  MAX_MSG_PER_SEC: 8,
+  /** Ersimha strokes ride a SEPARATE per-socket lane (general msgs keep MAX_MSG_PER_SEC).
+   *  Clients batch pen points to stay under this — ~150ms batching lands at ~7/sec. */
+  STROKE_BATCH_PER_SEC: 20
 };
-var PROTOCOL_VERSION = 3;
+var PROTOCOL_VERSION = 4;
 var MIN_SUPPORTED_PV = 1;
-var GAME_IDS = ["seedha", "snag", "trivia", "dama"];
+var GAME_IDS = ["seedha", "snag", "trivia", "dama", "ersimha"];
 var GAMES = [
   { id: "seedha", label: "Seedha", minPv: 2 },
   { id: "snag", label: "Snag", minPv: 2 },
   { id: "dama", label: "Dama", minPv: 3 },
   // engine #2 (D-027) — offered only to pv≥3 clients
+  { id: "ersimha", label: "Ersimha", minPv: 4 },
+  // engine #3 (D-030) draw-and-guess — offered only to pv≥4 clients
   { id: "trivia", label: "Trivia", minPv: 1, deprecated: true }
 ];
 var gamesForPv = (pv) => GAMES.filter((g) => !g.deprecated && g.minPv <= pv);
@@ -85,6 +90,10 @@ 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
+    // Ersimha (gs#45): include the HOST connection in the drawer rotation (host draws/buzzes like a
+    // player; first drawer, Dama-parity) — a pair plays with 2 devices, no separate TV connection.
+    // Omit/false = the host stays the room's TV/spectator (the D-030 MVP shape). Additive, no pv bump.
+    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(),
@@ -133,7 +142,28 @@ var ClientMsg = z.discriminatedUnion("t", [
     path: z.array(z.object({ r: z.number().int().min(0).max(7), c: z.number().int().min(0).max(7) })).max(12).optional()
   }),
   // Resign the current Dama game (concede) → opponent wins.
-  z.object({ t: z.literal("damaResign") })
+  z.object({ t: z.literal("damaResign") }),
+  // ── Ersimha slice (gameId 'ersimha', engine #3 — D-030) ──
+  // Drawer streams stroke points as batches. Coordinates are NORMALIZED [0,1] floats (device-
+  // independent — every client and the TV scale to their own canvas). The relay is a pure
+  // PASSTHROUGH: strokes are validated, rate-limited, fanned out, and NEVER stored (ephemeral
+  // drawings, D-030). `seq` orders batches within one stroke; a new strokeId = pen-down.
+  z.object({
+    t: z.literal("strokeBatch"),
+    strokeId: z.string().min(1).max(40),
+    seq: z.number().int().min(0).max(1e4),
+    points: z.array(z.object({ x: z.number().min(0).max(1), y: z.number().min(0).max(1) })).min(1).max(128),
+    color: z.string().regex(/^#[0-9a-fA-F]{6}$/),
+    width: z.number().min(1).max(64)
+  }),
+  // Drawer wipes the canvas (relayed to everyone).
+  z.object({ t: z.literal("clearCanvas") }),
+  // Drawer removes one stroke — the given id, or their latest when omitted (relayed).
+  z.object({ t: z.literal("undoStroke"), strokeId: z.string().min(1).max(40).optional() }),
+  // Drawer rules the CURRENT buzzer's spoken guess صح/خطأ (guessing is out loud — no text on the wire).
+  z.object({ t: z.literal("judgeGuess"), correct: z.boolean() }),
+  // Drawer passes on the served word (capped per draw-turn; relay serves a fresh one).
+  z.object({ t: z.literal("skipWord") })
 ]);
 export {
   ClientMsg,

package/package.json

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