@thegeem/protocol 0.1.24 → 0.1.26

package/dist/index.cjs

@@ -20,7 +20,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  CHARACTER_IDS: () => CHARACTER_IDS,
   ClientMsg: () => ClientMsg,
+  EMOTE_IDS: () => EMOTE_IDS,
   GAMES: () => GAMES,
   GAME_IDS: () => GAME_IDS,
   LIMITS: () => LIMITS,
@@ -69,6 +71,8 @@ var MODES = [
   { id: "snag", gameId: "snag", label: "Snag", onlineEligible: true }
 ];
 var modesForGame = (gameId) => MODES.filter((m) => m.gameId === gameId);
+var EMOTE_IDS = ["laugh", "wow", "think", "gg"];
+var CHARACTER_IDS = ["m", "f"];
 var ROOM_ALPHABET = "ACDEFGHJKMNPQRTUVWXY2346789";
 var UNSAFE_CHARS = /[\p{Cc}<>]/gu;
 var DisplayName = import_zod.z.string().trim().min(1).max(LIMITS.MAX_NAME_LEN).transform((s) => s.replace(UNSAFE_CHARS, "").trim()).refine((s) => s.length >= 1, "name is empty after sanitizing");
@@ -90,9 +94,10 @@ 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 Character = import_zod.z.enum(CHARACTER_IDS);
 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(), game: import_zod.z.enum(GAME_IDS).optional(), pv: Pv, idToken: IdToken, platform: Platform }),
+  import_zod.z.object({ t: import_zod.z.literal("createRoom"), name: DisplayName.optional(), avatar: Avatar.optional(), game: import_zod.z.enum(GAME_IDS).optional(), character: Character.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).
@@ -105,9 +110,9 @@ var ClientMsg = import_zod.z.discriminatedUnion("t", [
   // 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("setProfile"), name: DisplayName.optional(), avatar: Avatar.optional(), character: Character.optional() }),
+  import_zod.z.object({ t: import_zod.z.literal("joinRoom"), code: RoomCode, name: DisplayName, avatar: Avatar.optional(), character: Character.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(), character: Character.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 }),
@@ -150,6 +155,12 @@ var ClientMsg = import_zod.z.discriminatedUnion("t", [
     //     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(),
+    // Name the seats explicitly instead of taking them by join order (gs#47 Ask 2, layered on per
+    // D-037). Exactly two DISTINCT ids, both approved members of the room (the host may be one):
+    // `players[0]` plays black and moves first, `players[1]` plays white; everyone else in the room
+    // spectates. When present this OVERRIDES `hostPlays` — an explicit seating beats an implicit one.
+    // Violations are rejected with `bad_players`. Consumed by دامة (the only fixed-seat game today).
+    players: import_zod.z.array(PlayerId).length(2).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(),
@@ -173,6 +184,11 @@ var ClientMsg = import_zod.z.discriminatedUnion("t", [
   import_zod.z.object({ t: import_zod.z.literal("noHostNobody") }),
   // player actions
   import_zod.z.object({ t: import_zod.z.literal("buzz") }),
+  // «طقطقة» (D-038): send one of the four closed emotes. Server-enforced 5s per-player throttle on
+  // its OWN rate lane — a client-side throttle is trivially bypassed, and this is a family app, so
+  // Shape B applies exactly as it does to buzz arrival order. Over-rate emotes are dropped silently.
+  // Ephemeral: relayed, never stored. Allowed only while a game whose driver permits emotes is running.
+  import_zod.z.object({ t: import_zod.z.literal("sendEmote"), emoteId: import_zod.z.enum(EMOTE_IDS) }),
   import_zod.z.object({ t: import_zod.z.literal("answer"), index: import_zod.z.number().int().min(0).max(3) }),
   // trivia is 4-option (0–3)
   import_zod.z.object({ t: import_zod.z.literal("useHelp"), helpType: HelpType }),
@@ -223,7 +239,9 @@ var ClientMsg = import_zod.z.discriminatedUnion("t", [
 ]);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  CHARACTER_IDS,
   ClientMsg,
+  EMOTE_IDS,
   GAMES,
   GAME_IDS,
   LIMITS,

package/dist/index.d.cts

@@ -83,6 +83,24 @@ interface ModeInfo {
 declare const MODES: readonly ModeInfo[];
 /** The modes available for a given game (for a client's mode picker). */
 declare const modesForGame: (gameId: GameId) => ModeInfo[];
+/**
+ * «طقطقة» (tagtaga) emotes — D-038 (filed as D-036 in gs#50), design `geem-design DESIGN.md § tagtaga`.
+ * A CLOSED, POSITIVE-ONLY set of exactly four: ههههه · يا سلام · قاعد أفكر · لعب زين. The ids match the
+ * art masters (`art/tagtaga/Tagtaga-<emoteId>-<character>.png`), so the wire addresses the sprite directly.
+ * ⚠ Never add hurry-up / gloat / crying / angry — that's a RULING, not an oversight: «think» exists so a
+ * slow player can speak about THEMSELVES rather than anyone pressuring anyone. A closed enum with no
+ * free-form payload is also what keeps emotes off the UGC/moderation surface entirely.
+ */
+declare const EMOTE_IDS: readonly ["laugh", "wow", "think", "gg"];
+type EmoteId = (typeof EMOTE_IDS)[number];
+/**
+ * Which character sprite a player is drawn as: `m` = ghutra, `f` = hijab (the `-m`/`-f` art suffix).
+ * Both carry the identical emote set. It's a display preference, not identity: set it on room entry
+ * or change it any time via `setProfile`, and the server stamps it on that player's outgoing emotes
+ * so receivers can pick the right sprite without a roster lookup.
+ */
+declare const CHARACTER_IDS: readonly ["m", "f"];
+type CharacterId = (typeof CHARACTER_IDS)[number];
 /** Unambiguous room-code alphabet — no 0/O, 1/I/L. */
 declare const ROOM_ALPHABET = "ACDEFGHJKMNPQRTUVWXY2346789";
 declare const HelpType: z.ZodEnum<["removeTwoAnswers", "changeQuestion", "extraTime", "doublePoints", "stealPoints", "restPlayer", "tripLevel"]>;
@@ -100,6 +118,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
         color: string;
     }>>;
     game: z.ZodOptional<z.ZodEnum<["seedha", "snag", "trivia", "dama", "ersimha"]>>;
+    character: z.ZodOptional<z.ZodEnum<["m", "f"]>>;
     pv: z.ZodOptional<z.ZodNumber>;
     idToken: z.ZodOptional<z.ZodString>;
     platform: z.ZodOptional<z.ZodEnum<["web", "ios", "android"]>>;
@@ -111,6 +130,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
         color: string;
     } | undefined;
     game?: "seedha" | "snag" | "trivia" | "dama" | "ersimha" | undefined;
+    character?: "m" | "f" | undefined;
     pv?: number | undefined;
     idToken?: string | undefined;
     platform?: "web" | "ios" | "android" | undefined;
@@ -122,6 +142,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
         color: string;
     } | undefined;
     game?: "seedha" | "snag" | "trivia" | "dama" | "ersimha" | undefined;
+    character?: "m" | "f" | undefined;
     pv?: number | undefined;
     idToken?: string | undefined;
     platform?: "web" | "ios" | "android" | undefined;
@@ -147,6 +168,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
         emoji: string;
         color: string;
     }>>;
+    character: z.ZodOptional<z.ZodEnum<["m", "f"]>>;
 }, "strip", z.ZodTypeAny, {
     t: "setProfile";
     name?: string | undefined;
@@ -154,6 +176,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
         emoji: string;
         color: string;
     } | undefined;
+    character?: "m" | "f" | undefined;
 }, {
     t: "setProfile";
     name?: string | undefined;
@@ -161,6 +184,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
         emoji: string;
         color: string;
     } | undefined;
+    character?: "m" | "f" | undefined;
 }>, z.ZodObject<{
     t: z.ZodLiteral<"joinRoom">;
     code: z.ZodString;
@@ -175,6 +199,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
         emoji: string;
         color: string;
     }>>;
+    character: z.ZodOptional<z.ZodEnum<["m", "f"]>>;
     pv: z.ZodOptional<z.ZodNumber>;
     idToken: z.ZodOptional<z.ZodString>;
     platform: z.ZodOptional<z.ZodEnum<["web", "ios", "android"]>>;
@@ -186,6 +211,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
         emoji: string;
         color: string;
     } | undefined;
+    character?: "m" | "f" | undefined;
     pv?: number | undefined;
     idToken?: string | undefined;
     platform?: "web" | "ios" | "android" | undefined;
@@ -197,6 +223,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
         emoji: string;
         color: string;
     } | undefined;
+    character?: "m" | "f" | undefined;
     pv?: number | undefined;
     idToken?: string | undefined;
     platform?: "web" | "ios" | "android" | undefined;
@@ -214,6 +241,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
         emoji: string;
         color: string;
     }>>;
+    character: z.ZodOptional<z.ZodEnum<["m", "f"]>>;
     pv: z.ZodOptional<z.ZodNumber>;
     idToken: z.ZodOptional<z.ZodString>;
     platform: z.ZodOptional<z.ZodEnum<["web", "ios", "android"]>>;
@@ -225,6 +253,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
         emoji: string;
         color: string;
     } | undefined;
+    character?: "m" | "f" | undefined;
     pv?: number | undefined;
     idToken?: string | undefined;
     platform?: "web" | "ios" | "android" | undefined;
@@ -236,6 +265,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
         emoji: string;
         color: string;
     } | undefined;
+    character?: "m" | "f" | undefined;
     pv?: number | undefined;
     idToken?: string | undefined;
     platform?: "web" | "ios" | "android" | undefined;
@@ -326,6 +356,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     totalRounds: z.ZodNumber;
     categoryIds: z.ZodArray<z.ZodString, "many">;
     hostPlays: z.ZodOptional<z.ZodBoolean>;
+    players: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     modeId: z.ZodOptional<z.ZodEnum<["solo", "oneDevice", "snag", "multiplayer"]>>;
     buzzerMode: z.ZodOptional<z.ZodEnum<["off", "solo", "race", "controller"]>>;
     noHost: z.ZodOptional<z.ZodBoolean>;
@@ -336,6 +367,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     game?: "seedha" | "snag" | "trivia" | "dama" | "ersimha" | undefined;
     modeId?: "snag" | "solo" | "oneDevice" | "multiplayer" | undefined;
     hostPlays?: boolean | undefined;
+    players?: string[] | undefined;
     buzzerMode?: "solo" | "off" | "race" | "controller" | undefined;
     noHost?: boolean | undefined;
 }, {
@@ -345,6 +377,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     game?: "seedha" | "snag" | "trivia" | "dama" | "ersimha" | undefined;
     modeId?: "snag" | "solo" | "oneDevice" | "multiplayer" | undefined;
     hostPlays?: boolean | undefined;
+    players?: string[] | undefined;
     buzzerMode?: "solo" | "off" | "race" | "controller" | undefined;
     noHost?: boolean | undefined;
 }>, z.ZodObject<{
@@ -407,6 +440,15 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     t: "buzz";
 }, {
     t: "buzz";
+}>, z.ZodObject<{
+    t: z.ZodLiteral<"sendEmote">;
+    emoteId: z.ZodEnum<["laugh", "wow", "think", "gg"]>;
+}, "strip", z.ZodTypeAny, {
+    t: "sendEmote";
+    emoteId: "laugh" | "wow" | "think" | "gg";
+}, {
+    t: "sendEmote";
+    emoteId: "laugh" | "wow" | "think" | "gg";
 }>, z.ZodObject<{
     t: z.ZodLiteral<"answer">;
     index: z.ZodNumber;
@@ -827,6 +869,11 @@ type ServerMsg = {
 } | {
     t: 'roomClosed';
     reason: string;
+} | {
+    t: 'emote';
+    from: string;
+    emoteId: EmoteId;
+    character: CharacterId;
 } | {
     t: 'lobby';
     code: string;
@@ -891,4 +938,4 @@ type ServerMsg = {
     message: string;
 };
 
-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 };
+export { type AvatarView, type BuzzerGameMode, CHARACTER_IDS, type CategoryView, type CharacterId, ClientMsg, type DamaMoveView, type DamaPieceView, type DamaStateView, EMOTE_IDS, type Effect, type EmoteId, 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

@@ -83,6 +83,24 @@ interface ModeInfo {
 declare const MODES: readonly ModeInfo[];
 /** The modes available for a given game (for a client's mode picker). */
 declare const modesForGame: (gameId: GameId) => ModeInfo[];
+/**
+ * «طقطقة» (tagtaga) emotes — D-038 (filed as D-036 in gs#50), design `geem-design DESIGN.md § tagtaga`.
+ * A CLOSED, POSITIVE-ONLY set of exactly four: ههههه · يا سلام · قاعد أفكر · لعب زين. The ids match the
+ * art masters (`art/tagtaga/Tagtaga-<emoteId>-<character>.png`), so the wire addresses the sprite directly.
+ * ⚠ Never add hurry-up / gloat / crying / angry — that's a RULING, not an oversight: «think» exists so a
+ * slow player can speak about THEMSELVES rather than anyone pressuring anyone. A closed enum with no
+ * free-form payload is also what keeps emotes off the UGC/moderation surface entirely.
+ */
+declare const EMOTE_IDS: readonly ["laugh", "wow", "think", "gg"];
+type EmoteId = (typeof EMOTE_IDS)[number];
+/**
+ * Which character sprite a player is drawn as: `m` = ghutra, `f` = hijab (the `-m`/`-f` art suffix).
+ * Both carry the identical emote set. It's a display preference, not identity: set it on room entry
+ * or change it any time via `setProfile`, and the server stamps it on that player's outgoing emotes
+ * so receivers can pick the right sprite without a roster lookup.
+ */
+declare const CHARACTER_IDS: readonly ["m", "f"];
+type CharacterId = (typeof CHARACTER_IDS)[number];
 /** Unambiguous room-code alphabet — no 0/O, 1/I/L. */
 declare const ROOM_ALPHABET = "ACDEFGHJKMNPQRTUVWXY2346789";
 declare const HelpType: z.ZodEnum<["removeTwoAnswers", "changeQuestion", "extraTime", "doublePoints", "stealPoints", "restPlayer", "tripLevel"]>;
@@ -100,6 +118,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
         color: string;
     }>>;
     game: z.ZodOptional<z.ZodEnum<["seedha", "snag", "trivia", "dama", "ersimha"]>>;
+    character: z.ZodOptional<z.ZodEnum<["m", "f"]>>;
     pv: z.ZodOptional<z.ZodNumber>;
     idToken: z.ZodOptional<z.ZodString>;
     platform: z.ZodOptional<z.ZodEnum<["web", "ios", "android"]>>;
@@ -111,6 +130,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
         color: string;
     } | undefined;
     game?: "seedha" | "snag" | "trivia" | "dama" | "ersimha" | undefined;
+    character?: "m" | "f" | undefined;
     pv?: number | undefined;
     idToken?: string | undefined;
     platform?: "web" | "ios" | "android" | undefined;
@@ -122,6 +142,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
         color: string;
     } | undefined;
     game?: "seedha" | "snag" | "trivia" | "dama" | "ersimha" | undefined;
+    character?: "m" | "f" | undefined;
     pv?: number | undefined;
     idToken?: string | undefined;
     platform?: "web" | "ios" | "android" | undefined;
@@ -147,6 +168,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
         emoji: string;
         color: string;
     }>>;
+    character: z.ZodOptional<z.ZodEnum<["m", "f"]>>;
 }, "strip", z.ZodTypeAny, {
     t: "setProfile";
     name?: string | undefined;
@@ -154,6 +176,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
         emoji: string;
         color: string;
     } | undefined;
+    character?: "m" | "f" | undefined;
 }, {
     t: "setProfile";
     name?: string | undefined;
@@ -161,6 +184,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
         emoji: string;
         color: string;
     } | undefined;
+    character?: "m" | "f" | undefined;
 }>, z.ZodObject<{
     t: z.ZodLiteral<"joinRoom">;
     code: z.ZodString;
@@ -175,6 +199,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
         emoji: string;
         color: string;
     }>>;
+    character: z.ZodOptional<z.ZodEnum<["m", "f"]>>;
     pv: z.ZodOptional<z.ZodNumber>;
     idToken: z.ZodOptional<z.ZodString>;
     platform: z.ZodOptional<z.ZodEnum<["web", "ios", "android"]>>;
@@ -186,6 +211,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
         emoji: string;
         color: string;
     } | undefined;
+    character?: "m" | "f" | undefined;
     pv?: number | undefined;
     idToken?: string | undefined;
     platform?: "web" | "ios" | "android" | undefined;
@@ -197,6 +223,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
         emoji: string;
         color: string;
     } | undefined;
+    character?: "m" | "f" | undefined;
     pv?: number | undefined;
     idToken?: string | undefined;
     platform?: "web" | "ios" | "android" | undefined;
@@ -214,6 +241,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
         emoji: string;
         color: string;
     }>>;
+    character: z.ZodOptional<z.ZodEnum<["m", "f"]>>;
     pv: z.ZodOptional<z.ZodNumber>;
     idToken: z.ZodOptional<z.ZodString>;
     platform: z.ZodOptional<z.ZodEnum<["web", "ios", "android"]>>;
@@ -225,6 +253,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
         emoji: string;
         color: string;
     } | undefined;
+    character?: "m" | "f" | undefined;
     pv?: number | undefined;
     idToken?: string | undefined;
     platform?: "web" | "ios" | "android" | undefined;
@@ -236,6 +265,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
         emoji: string;
         color: string;
     } | undefined;
+    character?: "m" | "f" | undefined;
     pv?: number | undefined;
     idToken?: string | undefined;
     platform?: "web" | "ios" | "android" | undefined;
@@ -326,6 +356,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     totalRounds: z.ZodNumber;
     categoryIds: z.ZodArray<z.ZodString, "many">;
     hostPlays: z.ZodOptional<z.ZodBoolean>;
+    players: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     modeId: z.ZodOptional<z.ZodEnum<["solo", "oneDevice", "snag", "multiplayer"]>>;
     buzzerMode: z.ZodOptional<z.ZodEnum<["off", "solo", "race", "controller"]>>;
     noHost: z.ZodOptional<z.ZodBoolean>;
@@ -336,6 +367,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     game?: "seedha" | "snag" | "trivia" | "dama" | "ersimha" | undefined;
     modeId?: "snag" | "solo" | "oneDevice" | "multiplayer" | undefined;
     hostPlays?: boolean | undefined;
+    players?: string[] | undefined;
     buzzerMode?: "solo" | "off" | "race" | "controller" | undefined;
     noHost?: boolean | undefined;
 }, {
@@ -345,6 +377,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     game?: "seedha" | "snag" | "trivia" | "dama" | "ersimha" | undefined;
     modeId?: "snag" | "solo" | "oneDevice" | "multiplayer" | undefined;
     hostPlays?: boolean | undefined;
+    players?: string[] | undefined;
     buzzerMode?: "solo" | "off" | "race" | "controller" | undefined;
     noHost?: boolean | undefined;
 }>, z.ZodObject<{
@@ -407,6 +440,15 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     t: "buzz";
 }, {
     t: "buzz";
+}>, z.ZodObject<{
+    t: z.ZodLiteral<"sendEmote">;
+    emoteId: z.ZodEnum<["laugh", "wow", "think", "gg"]>;
+}, "strip", z.ZodTypeAny, {
+    t: "sendEmote";
+    emoteId: "laugh" | "wow" | "think" | "gg";
+}, {
+    t: "sendEmote";
+    emoteId: "laugh" | "wow" | "think" | "gg";
 }>, z.ZodObject<{
     t: z.ZodLiteral<"answer">;
     index: z.ZodNumber;
@@ -827,6 +869,11 @@ type ServerMsg = {
 } | {
     t: 'roomClosed';
     reason: string;
+} | {
+    t: 'emote';
+    from: string;
+    emoteId: EmoteId;
+    character: CharacterId;
 } | {
     t: 'lobby';
     code: string;
@@ -891,4 +938,4 @@ type ServerMsg = {
     message: string;
 };
 
-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 };
+export { type AvatarView, type BuzzerGameMode, CHARACTER_IDS, type CategoryView, type CharacterId, ClientMsg, type DamaMoveView, type DamaPieceView, type DamaStateView, EMOTE_IDS, type Effect, type EmoteId, 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

@@ -34,6 +34,8 @@ var MODES = [
   { id: "snag", gameId: "snag", label: "Snag", onlineEligible: true }
 ];
 var modesForGame = (gameId) => MODES.filter((m) => m.gameId === gameId);
+var EMOTE_IDS = ["laugh", "wow", "think", "gg"];
+var CHARACTER_IDS = ["m", "f"];
 var ROOM_ALPHABET = "ACDEFGHJKMNPQRTUVWXY2346789";
 var UNSAFE_CHARS = /[\p{Cc}<>]/gu;
 var DisplayName = z.string().trim().min(1).max(LIMITS.MAX_NAME_LEN).transform((s) => s.replace(UNSAFE_CHARS, "").trim()).refine((s) => s.length >= 1, "name is empty after sanitizing");
@@ -55,9 +57,10 @@ 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 Character = z.enum(CHARACTER_IDS);
 var ClientMsg = z.discriminatedUnion("t", [
   // room / lobby
-  z.object({ t: z.literal("createRoom"), name: DisplayName.optional(), avatar: Avatar.optional(), game: z.enum(GAME_IDS).optional(), pv: Pv, idToken: IdToken, platform: Platform }),
+  z.object({ t: z.literal("createRoom"), name: DisplayName.optional(), avatar: Avatar.optional(), game: z.enum(GAME_IDS).optional(), character: Character.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).
@@ -70,9 +73,9 @@ var ClientMsg = z.discriminatedUnion("t", [
   // 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("setProfile"), name: DisplayName.optional(), avatar: Avatar.optional(), character: Character.optional() }),
+  z.object({ t: z.literal("joinRoom"), code: RoomCode, name: DisplayName, avatar: Avatar.optional(), character: Character.optional(), pv: Pv, idToken: IdToken, platform: Platform }),
+  z.object({ t: z.literal("resume"), code: RoomCode, token: z.string().max(120), avatar: Avatar.optional(), character: Character.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 }),
@@ -115,6 +118,12 @@ var ClientMsg = z.discriminatedUnion("t", [
     //     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(),
+    // Name the seats explicitly instead of taking them by join order (gs#47 Ask 2, layered on per
+    // D-037). Exactly two DISTINCT ids, both approved members of the room (the host may be one):
+    // `players[0]` plays black and moves first, `players[1]` plays white; everyone else in the room
+    // spectates. When present this OVERRIDES `hostPlays` — an explicit seating beats an implicit one.
+    // Violations are rejected with `bad_players`. Consumed by دامة (the only fixed-seat game today).
+    players: z.array(PlayerId).length(2).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(),
@@ -138,6 +147,11 @@ var ClientMsg = z.discriminatedUnion("t", [
   z.object({ t: z.literal("noHostNobody") }),
   // player actions
   z.object({ t: z.literal("buzz") }),
+  // «طقطقة» (D-038): send one of the four closed emotes. Server-enforced 5s per-player throttle on
+  // its OWN rate lane — a client-side throttle is trivially bypassed, and this is a family app, so
+  // Shape B applies exactly as it does to buzz arrival order. Over-rate emotes are dropped silently.
+  // Ephemeral: relayed, never stored. Allowed only while a game whose driver permits emotes is running.
+  z.object({ t: z.literal("sendEmote"), emoteId: z.enum(EMOTE_IDS) }),
   z.object({ t: z.literal("answer"), index: z.number().int().min(0).max(3) }),
   // trivia is 4-option (0–3)
   z.object({ t: z.literal("useHelp"), helpType: HelpType }),
@@ -187,7 +201,9 @@ var ClientMsg = z.discriminatedUnion("t", [
   z.object({ t: z.literal("skipWord") })
 ]);
 export {
+  CHARACTER_IDS,
   ClientMsg,
+  EMOTE_IDS,
   GAMES,
   GAME_IDS,
   LIMITS,

package/package.json

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