@thegeem/protocol 0.1.26 → 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 }),
@@ -157,9 +166,10 @@ var ClientMsg = import_zod.z.discriminatedUnion("t", [
     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).
+    // 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.

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, {
@@ -645,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, {
@@ -645,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 }),
@@ -120,9 +129,10 @@ var ClientMsg = z.discriminatedUnion("t", [
     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).
+    // 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.

package/package.json

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