@thegeem/protocol 0.1.25 → 0.1.27

package/dist/index.cjs

@@ -113,6 +113,15 @@ var ClientMsg = import_zod.z.discriminatedUnion("t", [
   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 }),
+  // Participation (D-042): every person in a room is PLAYING or WATCHING, one model for every game.
+  // The badge means "I'm IN", NOT "I'm on the board" — the playing list is ORDERED and each game seats
+  // up to its own capacity (دامة 2; ارسمها/trivia everyone), so extras are WAITING rather than wearing a
+  // badge that lies. Omit `playerId` to change yourself. PERMISSIONS: the host may set anyone (and that
+  // seat is PINNED — a self-join can't displace it); a player may change only THEMSELVES, always allowed
+  // OUT (even if the host pinned them — nobody is forced to play) and back IN only if a seat is free.
+  // Lobby-only; the server re-broadcasts `lobby`. Everyone defaults to playing, so a normal room needs
+  // ZERO taps and behaves exactly as before.
+  import_zod.z.object({ t: import_zod.z.literal("setPlaying"), playerId: PlayerId.optional(), playing: import_zod.z.boolean() }),
   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 }),
@@ -155,6 +164,13 @@ 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):
+    // Order matters where a game seats a fixed number: دامة takes `players[0]` as black (moves first).
+    // Everyone not listed WATCHES. When present this OVERRIDES `hostPlays` and the lobby's playing list —
+    // an explicit seating beats an implicit one.
+    // Violations are rejected with `invalid_seat`. 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(),

package/dist/index.d.cts

@@ -269,6 +269,18 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     pv?: number | undefined;
     idToken?: string | undefined;
     platform?: "web" | "ios" | "android" | undefined;
+}>, z.ZodObject<{
+    t: z.ZodLiteral<"setPlaying">;
+    playerId: z.ZodOptional<z.ZodString>;
+    playing: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    t: "setPlaying";
+    playing: boolean;
+    playerId?: string | undefined;
+}, {
+    t: "setPlaying";
+    playing: boolean;
+    playerId?: string | undefined;
 }>, z.ZodObject<{
     t: z.ZodLiteral<"leaveRoom">;
 }, "strip", z.ZodTypeAny, {
@@ -356,6 +368,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>;
@@ -366,6 +379,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;
 }, {
@@ -375,6 +389,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<{
@@ -642,6 +657,10 @@ interface TeamSlotView {
     color: string;
 }
 interface LobbyPlayer {
+    /** D-042: is this person IN for the next game? (false = watching). Absent on pre-D-042 servers. */
+    playing?: boolean;
+    /** D-042: the HOST put them in, so a self-join can't displace them. Clients may mark it. */
+    pinned?: boolean;
     id: string;
     name: string;
     approved: boolean;

package/dist/index.d.ts

@@ -269,6 +269,18 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     pv?: number | undefined;
     idToken?: string | undefined;
     platform?: "web" | "ios" | "android" | undefined;
+}>, z.ZodObject<{
+    t: z.ZodLiteral<"setPlaying">;
+    playerId: z.ZodOptional<z.ZodString>;
+    playing: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    t: "setPlaying";
+    playing: boolean;
+    playerId?: string | undefined;
+}, {
+    t: "setPlaying";
+    playing: boolean;
+    playerId?: string | undefined;
 }>, z.ZodObject<{
     t: z.ZodLiteral<"leaveRoom">;
 }, "strip", z.ZodTypeAny, {
@@ -356,6 +368,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>;
@@ -366,6 +379,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;
 }, {
@@ -375,6 +389,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<{
@@ -642,6 +657,10 @@ interface TeamSlotView {
     color: string;
 }
 interface LobbyPlayer {
+    /** D-042: is this person IN for the next game? (false = watching). Absent on pre-D-042 servers. */
+    playing?: boolean;
+    /** D-042: the HOST put them in, so a self-join can't displace them. Clients may mark it. */
+    pinned?: boolean;
     id: string;
     name: string;
     approved: boolean;

package/dist/index.js

@@ -76,6 +76,15 @@ var ClientMsg = z.discriminatedUnion("t", [
   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 }),
+  // Participation (D-042): every person in a room is PLAYING or WATCHING, one model for every game.
+  // The badge means "I'm IN", NOT "I'm on the board" — the playing list is ORDERED and each game seats
+  // up to its own capacity (دامة 2; ارسمها/trivia everyone), so extras are WAITING rather than wearing a
+  // badge that lies. Omit `playerId` to change yourself. PERMISSIONS: the host may set anyone (and that
+  // seat is PINNED — a self-join can't displace it); a player may change only THEMSELVES, always allowed
+  // OUT (even if the host pinned them — nobody is forced to play) and back IN only if a seat is free.
+  // Lobby-only; the server re-broadcasts `lobby`. Everyone defaults to playing, so a normal room needs
+  // ZERO taps and behaves exactly as before.
+  z.object({ t: z.literal("setPlaying"), playerId: PlayerId.optional(), playing: z.boolean() }),
   z.object({ t: z.literal("leaveRoom") }),
   z.object({ t: z.literal("approve"), playerId: PlayerId }),
   z.object({ t: z.literal("reject"), playerId: PlayerId }),
@@ -118,6 +127,13 @@ 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):
+    // Order matters where a game seats a fixed number: دامة takes `players[0]` as black (moves first).
+    // Everyone not listed WATCHES. When present this OVERRIDES `hostPlays` and the lobby's playing list —
+    // an explicit seating beats an implicit one.
+    // Violations are rejected with `invalid_seat`. 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(),

package/package.json

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