@thegeem/protocol 0.1.17 → 0.1.18

package/dist/index.cjs

@@ -41,12 +41,14 @@ var LIMITS = {
   MAX_PLAYERS: 12,
   MAX_MSG_PER_SEC: 8
 };
-var PROTOCOL_VERSION = 2;
+var PROTOCOL_VERSION = 3;
 var MIN_SUPPORTED_PV = 1;
-var GAME_IDS = ["seedha", "snag", "trivia"];
+var GAME_IDS = ["seedha", "snag", "trivia", "dama"];
 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: "trivia", label: "Trivia", minPv: 1, deprecated: true }
 ];
 var gamesForPv = (pv) => GAMES.filter((g) => !g.deprecated && g.minPv <= pv);
@@ -116,7 +118,8 @@ var ClientMsg = import_zod.z.discriminatedUnion("t", [
     game: import_zod.z.enum(GAME_IDS).optional(),
     // which game to play; defaults to 'trivia'
     totalRounds: import_zod.z.number().int().min(1).max(50),
-    categoryIds: import_zod.z.array(import_zod.z.string().max(60)).min(1).max(12),
+    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
     // 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(),
@@ -153,7 +156,19 @@ var ClientMsg = import_zod.z.discriminatedUnion("t", [
   // Report the CURRENT question as bad (wrong answer / typo / offensive). The relay resolves WHICH
   // question from its authoritative room state — the client never sees the question id (anti-cheat),
   // so it only sends an optional `reason`. Only meaningful while a question is on screen.
-  import_zod.z.object({ t: import_zod.z.literal("reportQuestion"), reason: import_zod.z.string().max(500).optional() })
+  import_zod.z.object({ t: import_zod.z.literal("reportQuestion"), reason: import_zod.z.string().max(500).optional() }),
+  // ── Dama slice (gameId 'dama', engine #2 — D-027) ──
+  // Make a Dama move: from → to (board coords, 0–7). The relay validates legality against the engine
+  // (Shape B) and rejects anything not in legalMoves. If two capture chains share from+to (rare), the
+  // relay picks the max-capture one; a client MAY send the full landing `path` to disambiguate.
+  import_zod.z.object({
+    t: import_zod.z.literal("damaMove"),
+    from: import_zod.z.object({ r: import_zod.z.number().int().min(0).max(7), c: import_zod.z.number().int().min(0).max(7) }),
+    to: import_zod.z.object({ r: import_zod.z.number().int().min(0).max(7), c: import_zod.z.number().int().min(0).max(7) }),
+    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") })
 ]);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/index.d.cts

@@ -33,7 +33,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 = 2;
+declare const PROTOCOL_VERSION = 3;
 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 +42,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"];
+declare const GAME_IDS: readonly ["seedha", "snag", "trivia", "dama"];
 type GameId = (typeof GAME_IDS)[number];
 /**
  * The GAME REGISTRY — player-facing games + the version gating (D-024/D-025). A client renders a tile
@@ -286,7 +286,7 @@ 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"]>>;
+    game: z.ZodOptional<z.ZodEnum<["seedha", "snag", "trivia", "dama"]>>;
     totalRounds: z.ZodNumber;
     categoryIds: z.ZodArray<z.ZodString, "many">;
     modeId: z.ZodOptional<z.ZodEnum<["solo", "oneDevice", "snag", "multiplayer"]>>;
@@ -297,7 +297,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     categoryIds: string[];
     totalRounds: number;
     modeId?: "snag" | "solo" | "oneDevice" | "multiplayer" | undefined;
-    game?: "seedha" | "snag" | "trivia" | undefined;
+    game?: "seedha" | "snag" | "trivia" | "dama" | undefined;
     buzzerMode?: "solo" | "off" | "race" | "controller" | undefined;
     noHost?: boolean | undefined;
 }, {
@@ -305,7 +305,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     categoryIds: string[];
     totalRounds: number;
     modeId?: "snag" | "solo" | "oneDevice" | "multiplayer" | undefined;
-    game?: "seedha" | "snag" | "trivia" | undefined;
+    game?: "seedha" | "snag" | "trivia" | "dama" | undefined;
     buzzerMode?: "solo" | "off" | "race" | "controller" | undefined;
     noHost?: boolean | undefined;
 }>, z.ZodObject<{
@@ -419,6 +419,72 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
 }, {
     t: "reportQuestion";
     reason?: string | undefined;
+}>, z.ZodObject<{
+    t: z.ZodLiteral<"damaMove">;
+    from: z.ZodObject<{
+        r: z.ZodNumber;
+        c: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        r: number;
+        c: number;
+    }, {
+        r: number;
+        c: number;
+    }>;
+    to: z.ZodObject<{
+        r: z.ZodNumber;
+        c: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        r: number;
+        c: number;
+    }, {
+        r: number;
+        c: number;
+    }>;
+    path: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        r: z.ZodNumber;
+        c: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        r: number;
+        c: number;
+    }, {
+        r: number;
+        c: number;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    t: "damaMove";
+    from: {
+        r: number;
+        c: number;
+    };
+    to: {
+        r: number;
+        c: number;
+    };
+    path?: {
+        r: number;
+        c: number;
+    }[] | undefined;
+}, {
+    t: "damaMove";
+    from: {
+        r: number;
+        c: number;
+    };
+    to: {
+        r: number;
+        c: number;
+    };
+    path?: {
+        r: number;
+        c: number;
+    }[] | undefined;
+}>, z.ZodObject<{
+    t: z.ZodLiteral<"damaResign">;
+}, "strip", z.ZodTypeAny, {
+    t: "damaResign";
+}, {
+    t: "damaResign";
 }>]>;
 type ClientMsg = z.infer<typeof ClientMsg>;
 /** A player's privacy-safe avatar (emoji + circle color) for in-room display. */
@@ -574,6 +640,36 @@ type Effect = {
 } | {
     t: 'endGame';
 };
+/** A Dama piece as clients see it. */
+interface DamaPieceView {
+    color: 'black' | 'white';
+    king: boolean;
+}
+/** A legal Dama move offered to the player to move (for highlighting). `captures` = pieces it takes. */
+interface DamaMoveView {
+    from: {
+        r: number;
+        c: number;
+    };
+    to: {
+        r: number;
+        c: number;
+    };
+    captures: number;
+    path: {
+        r: number;
+        c: number;
+    }[];
+}
+/** The authoritative Dama board pushed to a client. `board[r][c]` is null on empty/light squares; r=0 is the top. */
+interface DamaStateView {
+    board: (DamaPieceView | null)[][];
+    turn: 'black' | 'white';
+    winner: 'black' | 'white' | null;
+    yourColor: 'black' | 'white' | null;
+    legalMoves: DamaMoveView[];
+    moveCount: number;
+}
 type ServerMsg = {
     t: 'roomCreated';
     code: string;
@@ -618,6 +714,11 @@ type ServerMsg = {
     view: GameStateView;
     you: YouContext;
     teamConnected: boolean[];
+} | {
+    t: 'damaState';
+    gameId: 'dama';
+    view: DamaStateView;
+    you: YouContext;
 } | {
     t: 'fx';
     effects: Effect[];
@@ -634,4 +735,4 @@ type ServerMsg = {
     message: string;
 };
 
-export { type AvatarView, type BuzzerGameMode, type CategoryView, ClientMsg, 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, 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

@@ -33,7 +33,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 = 2;
+declare const PROTOCOL_VERSION = 3;
 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 +42,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"];
+declare const GAME_IDS: readonly ["seedha", "snag", "trivia", "dama"];
 type GameId = (typeof GAME_IDS)[number];
 /**
  * The GAME REGISTRY — player-facing games + the version gating (D-024/D-025). A client renders a tile
@@ -286,7 +286,7 @@ 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"]>>;
+    game: z.ZodOptional<z.ZodEnum<["seedha", "snag", "trivia", "dama"]>>;
     totalRounds: z.ZodNumber;
     categoryIds: z.ZodArray<z.ZodString, "many">;
     modeId: z.ZodOptional<z.ZodEnum<["solo", "oneDevice", "snag", "multiplayer"]>>;
@@ -297,7 +297,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     categoryIds: string[];
     totalRounds: number;
     modeId?: "snag" | "solo" | "oneDevice" | "multiplayer" | undefined;
-    game?: "seedha" | "snag" | "trivia" | undefined;
+    game?: "seedha" | "snag" | "trivia" | "dama" | undefined;
     buzzerMode?: "solo" | "off" | "race" | "controller" | undefined;
     noHost?: boolean | undefined;
 }, {
@@ -305,7 +305,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     categoryIds: string[];
     totalRounds: number;
     modeId?: "snag" | "solo" | "oneDevice" | "multiplayer" | undefined;
-    game?: "seedha" | "snag" | "trivia" | undefined;
+    game?: "seedha" | "snag" | "trivia" | "dama" | undefined;
     buzzerMode?: "solo" | "off" | "race" | "controller" | undefined;
     noHost?: boolean | undefined;
 }>, z.ZodObject<{
@@ -419,6 +419,72 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
 }, {
     t: "reportQuestion";
     reason?: string | undefined;
+}>, z.ZodObject<{
+    t: z.ZodLiteral<"damaMove">;
+    from: z.ZodObject<{
+        r: z.ZodNumber;
+        c: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        r: number;
+        c: number;
+    }, {
+        r: number;
+        c: number;
+    }>;
+    to: z.ZodObject<{
+        r: z.ZodNumber;
+        c: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        r: number;
+        c: number;
+    }, {
+        r: number;
+        c: number;
+    }>;
+    path: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        r: z.ZodNumber;
+        c: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        r: number;
+        c: number;
+    }, {
+        r: number;
+        c: number;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    t: "damaMove";
+    from: {
+        r: number;
+        c: number;
+    };
+    to: {
+        r: number;
+        c: number;
+    };
+    path?: {
+        r: number;
+        c: number;
+    }[] | undefined;
+}, {
+    t: "damaMove";
+    from: {
+        r: number;
+        c: number;
+    };
+    to: {
+        r: number;
+        c: number;
+    };
+    path?: {
+        r: number;
+        c: number;
+    }[] | undefined;
+}>, z.ZodObject<{
+    t: z.ZodLiteral<"damaResign">;
+}, "strip", z.ZodTypeAny, {
+    t: "damaResign";
+}, {
+    t: "damaResign";
 }>]>;
 type ClientMsg = z.infer<typeof ClientMsg>;
 /** A player's privacy-safe avatar (emoji + circle color) for in-room display. */
@@ -574,6 +640,36 @@ type Effect = {
 } | {
     t: 'endGame';
 };
+/** A Dama piece as clients see it. */
+interface DamaPieceView {
+    color: 'black' | 'white';
+    king: boolean;
+}
+/** A legal Dama move offered to the player to move (for highlighting). `captures` = pieces it takes. */
+interface DamaMoveView {
+    from: {
+        r: number;
+        c: number;
+    };
+    to: {
+        r: number;
+        c: number;
+    };
+    captures: number;
+    path: {
+        r: number;
+        c: number;
+    }[];
+}
+/** The authoritative Dama board pushed to a client. `board[r][c]` is null on empty/light squares; r=0 is the top. */
+interface DamaStateView {
+    board: (DamaPieceView | null)[][];
+    turn: 'black' | 'white';
+    winner: 'black' | 'white' | null;
+    yourColor: 'black' | 'white' | null;
+    legalMoves: DamaMoveView[];
+    moveCount: number;
+}
 type ServerMsg = {
     t: 'roomCreated';
     code: string;
@@ -618,6 +714,11 @@ type ServerMsg = {
     view: GameStateView;
     you: YouContext;
     teamConnected: boolean[];
+} | {
+    t: 'damaState';
+    gameId: 'dama';
+    view: DamaStateView;
+    you: YouContext;
 } | {
     t: 'fx';
     effects: Effect[];
@@ -634,4 +735,4 @@ type ServerMsg = {
     message: string;
 };
 
-export { type AvatarView, type BuzzerGameMode, type CategoryView, ClientMsg, 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, 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

@@ -6,12 +6,14 @@ var LIMITS = {
   MAX_PLAYERS: 12,
   MAX_MSG_PER_SEC: 8
 };
-var PROTOCOL_VERSION = 2;
+var PROTOCOL_VERSION = 3;
 var MIN_SUPPORTED_PV = 1;
-var GAME_IDS = ["seedha", "snag", "trivia"];
+var GAME_IDS = ["seedha", "snag", "trivia", "dama"];
 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: "trivia", label: "Trivia", minPv: 1, deprecated: true }
 ];
 var gamesForPv = (pv) => GAMES.filter((g) => !g.deprecated && g.minPv <= pv);
@@ -81,7 +83,8 @@ var ClientMsg = z.discriminatedUnion("t", [
     game: z.enum(GAME_IDS).optional(),
     // which game to play; defaults to 'trivia'
     totalRounds: z.number().int().min(1).max(50),
-    categoryIds: z.array(z.string().max(60)).min(1).max(12),
+    categoryIds: z.array(z.string().max(60)).min(0).max(12),
+    // empty for games without categories (Dama); trivia rejects empty in-handler
     // 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(),
@@ -118,7 +121,19 @@ var ClientMsg = z.discriminatedUnion("t", [
   // Report the CURRENT question as bad (wrong answer / typo / offensive). The relay resolves WHICH
   // question from its authoritative room state — the client never sees the question id (anti-cheat),
   // so it only sends an optional `reason`. Only meaningful while a question is on screen.
-  z.object({ t: z.literal("reportQuestion"), reason: z.string().max(500).optional() })
+  z.object({ t: z.literal("reportQuestion"), reason: z.string().max(500).optional() }),
+  // ── Dama slice (gameId 'dama', engine #2 — D-027) ──
+  // Make a Dama move: from → to (board coords, 0–7). The relay validates legality against the engine
+  // (Shape B) and rejects anything not in legalMoves. If two capture chains share from+to (rare), the
+  // relay picks the max-capture one; a client MAY send the full landing `path` to disambiguate.
+  z.object({
+    t: z.literal("damaMove"),
+    from: z.object({ r: z.number().int().min(0).max(7), c: z.number().int().min(0).max(7) }),
+    to: z.object({ r: z.number().int().min(0).max(7), c: z.number().int().min(0).max(7) }),
+    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") })
 ]);
 export {
   ClientMsg,

package/package.json

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