@thegeem/protocol 0.1.40 → 0.1.42

package/dist/index.cjs

@@ -22,7 +22,9 @@ var index_exports = {};
 __export(index_exports, {
   CHARACTER_IDS: () => CHARACTER_IDS,
   COMEBACK_BONUS_MIN_PV: () => COMEBACK_BONUS_MIN_PV,
+  COMEBACK_EFFECTS: () => COMEBACK_EFFECTS,
   ClientMsg: () => ClientMsg,
+  EFFECT_MIN_PV: () => EFFECT_MIN_PV,
   EMOTE_IDS: () => EMOTE_IDS,
   GAMES: () => GAMES,
   GAME_IDS: () => GAME_IDS,
@@ -33,15 +35,21 @@ __export(index_exports, {
   PROTOCOL_VERSION: () => PROTOCOL_VERSION,
   REJECT_REASONS: () => REJECT_REASONS,
   ROOM_ALPHABET: () => ROOM_ALPHABET,
+  SEEDHA_MODE_IDS: () => SEEDHA_MODE_IDS,
+  SNAG_MODES_MIN_PV: () => SNAG_MODES_MIN_PV,
+  SNAG_MODE_IDS: () => SNAG_MODE_IDS,
   SUBMISSION_KINDS: () => SUBMISSION_KINDS,
   SUBMISSION_STATUSES: () => SUBMISSION_STATUSES,
   effectsForPv: () => effectsForPv,
   gameIdForPv: () => gameIdForPv,
   gamesForPv: () => gamesForPv,
   hostActivityForPv: () => hostActivityForPv,
+  internalGameOf: () => internalGameOf,
   modesForGame: () => modesForGame,
+  modesOf: () => modesOf,
   normalizeWesternDigits: () => normalizeWesternDigits,
-  sanitizeName: () => sanitizeName
+  sanitizeName: () => sanitizeName,
+  wireShapeOf: () => wireShapeOf
 });
 module.exports = __toCommonJS(index_exports);
 var import_zod = require("zod");
@@ -54,7 +62,7 @@ var LIMITS = {
    *  Clients batch pen points to stay under this — ~150ms batching lands at ~7/sec. */
   STROKE_BATCH_PER_SEC: 20
 };
-var PROTOCOL_VERSION = 7;
+var PROTOCOL_VERSION = 8;
 var MIN_SUPPORTED_PV = 1;
 var GAME_IDS = ["seedha", "snag", "trivia", "dama", "ersimha", "sebaq"];
 var GAMES = [
@@ -86,20 +94,55 @@ var GAMES = [
 ];
 var hostActivityForPv = (activity, pv) => activity === "options" && (pv ?? MIN_SUPPORTED_PV) < 6 ? "configuring" : activity;
 var COMEBACK_BONUS_MIN_PV = 7;
-var COMEBACK_EFFECTS = /* @__PURE__ */ new Set(["comebackBonus", "comebackOffer", "comebackDeclined"]);
-var effectsForPv = (effects, pv) => (pv ?? MIN_SUPPORTED_PV) >= COMEBACK_BONUS_MIN_PV ? effects : effects.filter((e) => !COMEBACK_EFFECTS.has(e.t));
+var EFFECT_MIN_PV = {
+  comebackOffer: COMEBACK_BONUS_MIN_PV,
+  comebackBonus: COMEBACK_BONUS_MIN_PV,
+  comebackDeclined: COMEBACK_BONUS_MIN_PV
+};
+var COMEBACK_EFFECTS = ["comebackOffer", "comebackBonus", "comebackDeclined"];
+var effectsForPv = (effects, pv) => {
+  const have = pv ?? MIN_SUPPORTED_PV;
+  return effects.filter((e) => (EFFECT_MIN_PV[e.t] ?? MIN_SUPPORTED_PV) <= have);
+};
 var gamesForPv = (pv) => GAMES.filter((g) => !g.deprecated && g.minPv <= pv);
 var gameIdForPv = (gameId, pv) => {
   const g = GAMES.find((x) => x.id === gameId);
   return g && !g.deprecated && (pv ?? MIN_SUPPORTED_PV) >= g.minPv ? gameId : "trivia";
 };
-var MODE_IDS = ["solo", "oneDevice", "snag", "multiplayer"];
+var SEEDHA_MODE_IDS = ["solo", "oneDevice", "multiplayer"];
+var SNAG_MODE_IDS = ["normal", "sebaq"];
+var MODE_IDS = [...SEEDHA_MODE_IDS, ...SNAG_MODE_IDS, "snag"];
+var SNAG_MODES_MIN_PV = 8;
+function modesOf(gameId) {
+  return MODES.filter((m) => m.gameId === gameId && !m.legacyAlias);
+}
 var MODES = [
   { id: "solo", gameId: "seedha", label: "Training", onlineEligible: false },
   { id: "oneDevice", gameId: "seedha", label: "One Device", onlineEligible: false },
   { id: "multiplayer", gameId: "seedha", label: "Multiplayer", onlineEligible: true },
-  { id: "snag", gameId: "snag", label: "Snag", onlineEligible: true }
+  // D-102: today's buzz Snag, by its real name. OFF the boards (owner 2026-08-29): the host awards 1-answer
+  // questions and the Comeback +100, so its score is not the relay's alone.
+  { id: "normal", gameId: "snag", label: "Normal", onlineEligible: false },
+  { id: "sebaq", gameId: "snag", label: "Sebaq", onlineEligible: true },
+  // D-102: the race — relay-scored end to end; THE Snag board
+  // NOT a mode — the legacy spelling of «snag / normal» (see MODE_IDS). Kept so old clients' `MODES.find` still maps it.
+  { id: "snag", gameId: "snag", label: "Snag", onlineEligible: false, legacyAlias: true }
 ];
+function internalGameOf(game, modeId) {
+  if (modeId === "sebaq" || game === "sebaq") return { gameId: "sebaq", modeId: void 0 };
+  if (modeId === "snag") return { gameId: "snag", modeId: "normal" };
+  if (modeId === "normal") return { gameId: "snag", modeId: "normal" };
+  return { gameId: game, modeId };
+}
+function wireShapeOf(gameId, modeId, pv) {
+  const v = pv ?? MIN_SUPPORTED_PV;
+  if (gameId === "sebaq") return v >= SNAG_MODES_MIN_PV ? { gameId: "snag", modeId: "sebaq" } : { gameId: gameIdForPv("sebaq", pv), modeId: null };
+  if (gameId === "snag") {
+    const m = modeId === "normal" || modeId === "snag" ? v >= SNAG_MODES_MIN_PV ? "normal" : "snag" : modeId;
+    return { gameId: gameIdForPv("snag", pv), modeId: m };
+  }
+  return { gameId: gameIdForPv(gameId, pv), modeId };
+}
 var modesForGame = (gameId) => MODES.filter((m) => m.gameId === gameId);
 var EMOTE_IDS = ["laugh", "wow", "think", "gg"];
 var CHARACTER_IDS = ["m", "f"];
@@ -122,6 +165,7 @@ var HelpType = import_zod.z.enum([
 var Pv = import_zod.z.number().int().min(1).max(1e6).optional();
 var IdToken = import_zod.z.string().max(4096).optional();
 var Platform = import_zod.z.enum(["web", "ios", "android", "tv"]).optional();
+var Games = import_zod.z.array(import_zod.z.enum(GAME_IDS)).max(GAME_IDS.length).optional();
 var AppVersion = import_zod.z.string().trim().max(24).regex(/^[0-9]+(\.[0-9]+){0,3}([-+][0-9A-Za-z.-]+)?$/, "bad app version").optional();
 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"),
@@ -130,7 +174,7 @@ var Avatar = import_zod.z.object({
 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(), character: Character.optional(), pv: Pv, idToken: IdToken, platform: Platform, appVersion: AppVersion }),
+  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, games: Games, appVersion: AppVersion }),
   // 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).
@@ -144,8 +188,8 @@ var ClientMsg = import_zod.z.discriminatedUnion("t", [
   // 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(), 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, appVersion: AppVersion }),
-  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, appVersion: AppVersion }),
+  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, games: Games, appVersion: AppVersion }),
+  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, games: Games, appVersion: AppVersion }),
   // `tally` (gs#46) = wins per PLAYER across every game this room has played tonight — «نتيجة الليلة».
   // Keyed by playerId, NOT by team: team names are recycled each game, so a per-team count means nothing
   // across a night. Survives playAgain. A One Device game credits nobody (its team slots hold no players).
@@ -361,7 +405,9 @@ var REJECT_REASONS = ["duplicate", "unclear_answer", "not_family", "inaccurate",
 0 && (module.exports = {
   CHARACTER_IDS,
   COMEBACK_BONUS_MIN_PV,
+  COMEBACK_EFFECTS,
   ClientMsg,
+  EFFECT_MIN_PV,
   EMOTE_IDS,
   GAMES,
   GAME_IDS,
@@ -372,13 +418,19 @@ var REJECT_REASONS = ["duplicate", "unclear_answer", "not_family", "inaccurate",
   PROTOCOL_VERSION,
   REJECT_REASONS,
   ROOM_ALPHABET,
+  SEEDHA_MODE_IDS,
+  SNAG_MODES_MIN_PV,
+  SNAG_MODE_IDS,
   SUBMISSION_KINDS,
   SUBMISSION_STATUSES,
   effectsForPv,
   gameIdForPv,
   gamesForPv,
   hostActivityForPv,
+  internalGameOf,
   modesForGame,
+  modesOf,
   normalizeWesternDigits,
-  sanitizeName
+  sanitizeName,
+  wireShapeOf
 });

package/dist/index.d.cts

@@ -36,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 = 7;
+declare const PROTOCOL_VERSION = 8;
 declare const MIN_SUPPORTED_PV = 1;
 /**
  * Geem is a PLATFORM of GAMES (jackbox-style). The trivia board split (D-023) into TWO player-facing
@@ -96,6 +96,33 @@ declare const hostActivityForPv: (activity: "options" | "configuring" | "idle",
  * the honest degradation: the game stays correct, the animation is missing.
  */
 declare const COMEBACK_BONUS_MIN_PV = 7;
+/**
+ * The effects safe to send a client of version `pv`.
+ *
+ * ⚠️ WITHHOLDING IS THE ONLY OPTION FOR AN EFFECT, and it is why this is a filter rather than a
+ * mapper like `hostActivityForPv`. An unknown `hostActivity` string could be down-mapped to an older
+ * word that means nearly the same thing; an unknown effect VARIANT has no older equivalent, and
+ * inventing one (sending `scorePop` instead) would make the client animate a normal score change for
+ * an event that is not one.
+ */
+/**
+ * The pv each VERSION-GATED effect first became decodable at. Absent = decodable since the floor.
+ *
+ * ⚠️ ONE TABLE, THE SHAPE `GAMES` ALREADY USES (`minPv` per entry) — not one constant, one set and one
+ * `||` per feature. The comeback bonus was the first gated effect and arrived as three of each; the
+ * next would have added three more. ⚠️ The relay's `CLIENT_FX` spreads EVERY key of this table, whatever
+ * its pv — the gate withholds, the allow-list must never — so a gated effect cannot be forgotten in one
+ * of the two places. I re-typed that list once, listed one of three, and shipped a feature whose refusal
+ * rendered as silence on prod. A hand-list fails by OMISSION.
+ */
+declare const EFFECT_MIN_PV: Partial<Record<Effect['t'], number>>;
+/** The comeback FAMILY, explicit. ⚠️ Not «every effect whose minPv is 7» — that derivation would silently
+ *  drop a fourth comeback effect gated at pv8, and the test that checks this list would stay green because
+ *  it derives from the same list (code-review C7). Family membership is a fact about the feature; the pv is
+ *  a fact about the wire. Two tables, on purpose. */
+declare const COMEBACK_EFFECTS: readonly ["comebackOffer", "comebackBonus", "comebackDeclined"];
+/** The effects a client of version `pv` can decode. Withholding is the only option for an effect — an
+ *  unknown variant has no older equivalent, and a strict Swift enum drops the WHOLE frame on one. */
 declare const effectsForPv: (effects: Effect[], pv: number | undefined) => Effect[];
 declare const gamesForPv: (pv: number) => GameInfo[];
 /** The gameId to SEND a client of version `pv`: new games need pv >= their minPv; older clients see 'trivia'. */
@@ -109,15 +136,53 @@ declare const gameIdForPv: (gameId: GameId, pv: number | undefined) => GameId;
  * (only server-arbitrated, multi-device modes; single-device/solo are local-only — the host controls
  * input, so the server can't trust the score).
  */
-declare const MODE_IDS: readonly ["solo", "oneDevice", "snag", "multiplayer"];
+/** صيدها's modes — one name each, the ONLY name anything outside the engine uses (guide §9 item 1, owner «go» 2026-08-29). */
+declare const SEEDHA_MODE_IDS: readonly ["solo", "oneDevice", "multiplayer"];
+/** سناق (من سبق لبق)'s modes — D-102, owner 2026-08-29: `normal` = buzz-to-claim on ONE shared question (what
+ *  every shipped build calls «Snag»), `sebaq` = everyone races the SAME set on their own phone (D-099's rules).
+ *  ⚠️ The word ديوانية is RESERVED for a future «Group Diwaniya» — it names nothing today. */
+declare const SNAG_MODE_IDS: readonly ["normal", "sebaq"];
+/** The wire union. `'snag'` is NOT a mode: it is the LEGACY SPELLING of «game snag, mode normal» that every
+ *  shipped iOS and web build sends, and a frozen build must keep working — see internalGameOf(). The new ids
+ *  reach only pv ≥ SNAG_MODES_MIN_PV clients (`lobby.modeId` is a STRICT Swift enum: an unknown value drops
+ *  the whole frame) — wireShapeOf() down-maps for everyone else. */
+declare const MODE_IDS: readonly ["solo", "oneDevice", "multiplayer", "normal", "sebaq", "snag"];
+declare const SNAG_MODES_MIN_PV = 8;
+type SnagModeId = (typeof SNAG_MODE_IDS)[number];
 type ModeId = (typeof MODE_IDS)[number];
+type SeedhaModeId = (typeof SEEDHA_MODE_IDS)[number];
+/** The modes a game offers, from the registry. Games with no modes (دامة, ارسمها, سباق) → []. */
+declare function modesOf(gameId: GameId): ModeInfo[];
 interface ModeInfo {
     id: ModeId;
     gameId: GameId;
     label: string;
     onlineEligible: boolean;
+    /** A row kept only so `MODES.find(id)` keeps resolving for builds that send a game as a modeId. Not a mode:
+     *  never render it in a mode picker — `modesOf()` filters it out. */
+    legacyAlias?: true;
 }
 declare const MODES: readonly ModeInfo[];
+/**
+ * D-102 — the two directions between the PRODUCT shape (game Snag → mode normal | sebaq) and the ENGINE
+ * shape the relay runs (`gameId 'snag'` = the trivia engine in race flow; `gameId 'sebaq'` = its own
+ * engine/driver, D-026 tile-vs-engine). Both spellings stay on the wire forever: `game: 'sebaq'` and
+ * `modeId: 'snag'` are what every shipped build sends.
+ *
+ * INBOUND — `internalGameOf(game, modeId)`: what the client SAID → what the relay RUNS.
+ */
+declare function internalGameOf(game: GameId | undefined, modeId: ModeId | undefined): {
+    gameId: GameId | undefined;
+    modeId: ModeId | undefined;
+};
+/**
+ * OUTBOUND — `wireShapeOf(internalGameId, modeId, pv)`: what the relay RUNS → what THIS client can DECODE.
+ * pv ≥ 8 sees the product shape; below it, the pv7 shape it shipped with (`sebaq` as a game, `snag` as a mode).
+ */
+declare function wireShapeOf(gameId: GameId, modeId: ModeId | null, pv: number | undefined): {
+    gameId: GameId;
+    modeId: ModeId | null;
+};
 /** The modes available for a given game (for a client's mode picker). */
 declare const modesForGame: (gameId: GameId) => ModeInfo[];
 /**
@@ -176,6 +241,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     pv: z.ZodOptional<z.ZodNumber>;
     idToken: z.ZodOptional<z.ZodString>;
     platform: z.ZodOptional<z.ZodEnum<["web", "ios", "android", "tv"]>>;
+    games: z.ZodOptional<z.ZodArray<z.ZodEnum<["seedha", "snag", "trivia", "dama", "ersimha", "sebaq"]>, "many">>;
     appVersion: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     t: "createRoom";
@@ -189,6 +255,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     pv?: number | undefined;
     idToken?: string | undefined;
     platform?: "web" | "ios" | "android" | "tv" | undefined;
+    games?: ("seedha" | "snag" | "trivia" | "dama" | "ersimha" | "sebaq")[] | undefined;
     appVersion?: string | undefined;
 }, {
     t: "createRoom";
@@ -202,6 +269,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     pv?: number | undefined;
     idToken?: string | undefined;
     platform?: "web" | "ios" | "android" | "tv" | undefined;
+    games?: ("seedha" | "snag" | "trivia" | "dama" | "ersimha" | "sebaq")[] | undefined;
     appVersion?: string | undefined;
 }>, z.ZodObject<{
     t: z.ZodLiteral<"renameHost">;
@@ -260,10 +328,11 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     pv: z.ZodOptional<z.ZodNumber>;
     idToken: z.ZodOptional<z.ZodString>;
     platform: z.ZodOptional<z.ZodEnum<["web", "ios", "android", "tv"]>>;
+    games: z.ZodOptional<z.ZodArray<z.ZodEnum<["seedha", "snag", "trivia", "dama", "ersimha", "sebaq"]>, "many">>;
     appVersion: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    code: string;
     t: "joinRoom";
+    code: string;
     name: string;
     avatar?: {
         emoji: string;
@@ -273,10 +342,11 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     pv?: number | undefined;
     idToken?: string | undefined;
     platform?: "web" | "ios" | "android" | "tv" | undefined;
+    games?: ("seedha" | "snag" | "trivia" | "dama" | "ersimha" | "sebaq")[] | undefined;
     appVersion?: string | undefined;
 }, {
-    code: string;
     t: "joinRoom";
+    code: string;
     name: string;
     avatar?: {
         emoji: string;
@@ -286,6 +356,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     pv?: number | undefined;
     idToken?: string | undefined;
     platform?: "web" | "ios" | "android" | "tv" | undefined;
+    games?: ("seedha" | "snag" | "trivia" | "dama" | "ersimha" | "sebaq")[] | undefined;
     appVersion?: string | undefined;
 }>, z.ZodObject<{
     t: z.ZodLiteral<"resume">;
@@ -305,10 +376,11 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     pv: z.ZodOptional<z.ZodNumber>;
     idToken: z.ZodOptional<z.ZodString>;
     platform: z.ZodOptional<z.ZodEnum<["web", "ios", "android", "tv"]>>;
+    games: z.ZodOptional<z.ZodArray<z.ZodEnum<["seedha", "snag", "trivia", "dama", "ersimha", "sebaq"]>, "many">>;
     appVersion: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    code: string;
     t: "resume";
+    code: string;
     token: string;
     avatar?: {
         emoji: string;
@@ -318,10 +390,11 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     pv?: number | undefined;
     idToken?: string | undefined;
     platform?: "web" | "ios" | "android" | "tv" | undefined;
+    games?: ("seedha" | "snag" | "trivia" | "dama" | "ersimha" | "sebaq")[] | undefined;
     appVersion?: string | undefined;
 }, {
-    code: string;
     t: "resume";
+    code: string;
     token: string;
     avatar?: {
         emoji: string;
@@ -331,6 +404,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     pv?: number | undefined;
     idToken?: string | undefined;
     platform?: "web" | "ios" | "android" | "tv" | undefined;
+    games?: ("seedha" | "snag" | "trivia" | "dama" | "ersimha" | "sebaq")[] | undefined;
     appVersion?: string | undefined;
 }>, z.ZodObject<{
     t: z.ZodLiteral<"setPlaying">;
@@ -437,15 +511,15 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
 }>, z.ZodObject<{
     t: z.ZodLiteral<"setMode">;
     game: z.ZodOptional<z.ZodEnum<["seedha", "snag", "trivia", "dama", "ersimha", "sebaq"]>>;
-    modeId: z.ZodOptional<z.ZodEnum<["solo", "oneDevice", "snag", "multiplayer"]>>;
+    modeId: z.ZodOptional<z.ZodEnum<["solo", "oneDevice", "multiplayer", "normal", "sebaq", "snag"]>>;
 }, "strip", z.ZodTypeAny, {
     t: "setMode";
     game?: "seedha" | "snag" | "trivia" | "dama" | "ersimha" | "sebaq" | undefined;
-    modeId?: "snag" | "solo" | "oneDevice" | "multiplayer" | undefined;
+    modeId?: "snag" | "sebaq" | "solo" | "oneDevice" | "multiplayer" | "normal" | undefined;
 }, {
     t: "setMode";
     game?: "seedha" | "snag" | "trivia" | "dama" | "ersimha" | "sebaq" | undefined;
-    modeId?: "snag" | "solo" | "oneDevice" | "multiplayer" | undefined;
+    modeId?: "snag" | "sebaq" | "solo" | "oneDevice" | "multiplayer" | "normal" | undefined;
 }>, z.ZodObject<{
     t: z.ZodLiteral<"hostActivity">;
     activity: z.ZodEnum<["options", "configuring", "idle"]>;
@@ -469,7 +543,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     }, {
         difficulty?: "easy" | "medium" | "hard" | undefined;
     }>>;
-    modeId: z.ZodOptional<z.ZodEnum<["solo", "oneDevice", "snag", "multiplayer"]>>;
+    modeId: z.ZodOptional<z.ZodEnum<["solo", "oneDevice", "multiplayer", "normal", "sebaq", "snag"]>>;
     buzzerMode: z.ZodOptional<z.ZodEnum<["off", "solo", "race", "controller"]>>;
     noHost: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
@@ -477,7 +551,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     categoryIds: string[];
     totalRounds: number;
     game?: "seedha" | "snag" | "trivia" | "dama" | "ersimha" | "sebaq" | undefined;
-    modeId?: "snag" | "solo" | "oneDevice" | "multiplayer" | undefined;
+    modeId?: "snag" | "sebaq" | "solo" | "oneDevice" | "multiplayer" | "normal" | undefined;
     hostPlays?: boolean | undefined;
     players?: string[] | undefined;
     bot?: {
@@ -490,7 +564,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     categoryIds: string[];
     totalRounds: number;
     game?: "seedha" | "snag" | "trivia" | "dama" | "ersimha" | "sebaq" | undefined;
-    modeId?: "snag" | "solo" | "oneDevice" | "multiplayer" | undefined;
+    modeId?: "snag" | "sebaq" | "solo" | "oneDevice" | "multiplayer" | "normal" | undefined;
     hostPlays?: boolean | undefined;
     players?: string[] | undefined;
     bot?: {
@@ -704,8 +778,8 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     color: z.ZodString;
     width: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
-    color: string;
     t: "strokeBatch";
+    color: string;
     strokeId: string;
     seq: number;
     points: {
@@ -714,8 +788,8 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     }[];
     width: number;
 }, {
-    color: string;
     t: "strokeBatch";
+    color: string;
     strokeId: string;
     seq: number;
     points: {
@@ -874,7 +948,7 @@ interface PackView {
     hasImage?: boolean;
 }
 type GameStatus = 'setup' | 'categorySelection' | 'inProgress' | 'completed';
-type GameplayFlow = 'classic' | 'openJudged' | 'noHost' | 'buzzer';
+type GameplayFlow = 'classic' | 'noHost' | 'buzzer';
 type BuzzerGameMode = 'off' | 'solo' | 'race' | 'controller';
 /** The help/lifeline ids (same set as the inbound `HelpType` zod enum above). */
 type HelpName = z.infer<typeof HelpType>;
@@ -890,6 +964,7 @@ interface TeamView {
     helps: {
         type: HelpName;
         isUsed: boolean;
+        unusable?: true;
     }[];
     /** The team's players in rotation order (`connected` = that player's socket is online right now).
      *  Empty for host-run single-device teams. */
@@ -1229,6 +1304,7 @@ type ServerMsg = {
     hostFrame?: string;
     hostPlaying?: boolean;
     hostPinned?: boolean;
+    hostTeamIndex?: number | null;
     players: LobbyPlayer[];
     categories: CategoryView[];
     packs?: PackView[];
@@ -1340,4 +1416,4 @@ interface MyQuestionRow {
     };
 }
 
-export { type AvatarView, type BuzzerGameMode, CHARACTER_IDS, COMEBACK_BONUS_MIN_PV, 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, type MyQuestionRow, PROTOCOL_VERSION, type PackView, type QuestionView, REJECT_REASONS, ROOM_ALPHABET, type RejectReason, type RosterEntry, SUBMISSION_KINDS, SUBMISSION_STATUSES, type SebaqStandingRow, type SebaqStateView, type ServerMsg, type SoundName, type StrokePointView, type SubmissionKind, type SubmissionStatus, type TeamSlotView, type TeamView, type YouContext, effectsForPv, gameIdForPv, gamesForPv, hostActivityForPv, modesForGame, normalizeWesternDigits, sanitizeName };
+export { type AvatarView, type BuzzerGameMode, CHARACTER_IDS, COMEBACK_BONUS_MIN_PV, COMEBACK_EFFECTS, type CategoryView, type CharacterId, ClientMsg, type DamaMoveView, type DamaPieceView, type DamaStateView, EFFECT_MIN_PV, 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, type MyQuestionRow, PROTOCOL_VERSION, type PackView, type QuestionView, REJECT_REASONS, ROOM_ALPHABET, type RejectReason, type RosterEntry, SEEDHA_MODE_IDS, SNAG_MODES_MIN_PV, SNAG_MODE_IDS, SUBMISSION_KINDS, SUBMISSION_STATUSES, type SebaqStandingRow, type SebaqStateView, type SeedhaModeId, type ServerMsg, type SnagModeId, type SoundName, type StrokePointView, type SubmissionKind, type SubmissionStatus, type TeamSlotView, type TeamView, type YouContext, effectsForPv, gameIdForPv, gamesForPv, hostActivityForPv, internalGameOf, modesForGame, modesOf, normalizeWesternDigits, sanitizeName, wireShapeOf };

package/dist/index.d.ts

@@ -36,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 = 7;
+declare const PROTOCOL_VERSION = 8;
 declare const MIN_SUPPORTED_PV = 1;
 /**
  * Geem is a PLATFORM of GAMES (jackbox-style). The trivia board split (D-023) into TWO player-facing
@@ -96,6 +96,33 @@ declare const hostActivityForPv: (activity: "options" | "configuring" | "idle",
  * the honest degradation: the game stays correct, the animation is missing.
  */
 declare const COMEBACK_BONUS_MIN_PV = 7;
+/**
+ * The effects safe to send a client of version `pv`.
+ *
+ * ⚠️ WITHHOLDING IS THE ONLY OPTION FOR AN EFFECT, and it is why this is a filter rather than a
+ * mapper like `hostActivityForPv`. An unknown `hostActivity` string could be down-mapped to an older
+ * word that means nearly the same thing; an unknown effect VARIANT has no older equivalent, and
+ * inventing one (sending `scorePop` instead) would make the client animate a normal score change for
+ * an event that is not one.
+ */
+/**
+ * The pv each VERSION-GATED effect first became decodable at. Absent = decodable since the floor.
+ *
+ * ⚠️ ONE TABLE, THE SHAPE `GAMES` ALREADY USES (`minPv` per entry) — not one constant, one set and one
+ * `||` per feature. The comeback bonus was the first gated effect and arrived as three of each; the
+ * next would have added three more. ⚠️ The relay's `CLIENT_FX` spreads EVERY key of this table, whatever
+ * its pv — the gate withholds, the allow-list must never — so a gated effect cannot be forgotten in one
+ * of the two places. I re-typed that list once, listed one of three, and shipped a feature whose refusal
+ * rendered as silence on prod. A hand-list fails by OMISSION.
+ */
+declare const EFFECT_MIN_PV: Partial<Record<Effect['t'], number>>;
+/** The comeback FAMILY, explicit. ⚠️ Not «every effect whose minPv is 7» — that derivation would silently
+ *  drop a fourth comeback effect gated at pv8, and the test that checks this list would stay green because
+ *  it derives from the same list (code-review C7). Family membership is a fact about the feature; the pv is
+ *  a fact about the wire. Two tables, on purpose. */
+declare const COMEBACK_EFFECTS: readonly ["comebackOffer", "comebackBonus", "comebackDeclined"];
+/** The effects a client of version `pv` can decode. Withholding is the only option for an effect — an
+ *  unknown variant has no older equivalent, and a strict Swift enum drops the WHOLE frame on one. */
 declare const effectsForPv: (effects: Effect[], pv: number | undefined) => Effect[];
 declare const gamesForPv: (pv: number) => GameInfo[];
 /** The gameId to SEND a client of version `pv`: new games need pv >= their minPv; older clients see 'trivia'. */
@@ -109,15 +136,53 @@ declare const gameIdForPv: (gameId: GameId, pv: number | undefined) => GameId;
  * (only server-arbitrated, multi-device modes; single-device/solo are local-only — the host controls
  * input, so the server can't trust the score).
  */
-declare const MODE_IDS: readonly ["solo", "oneDevice", "snag", "multiplayer"];
+/** صيدها's modes — one name each, the ONLY name anything outside the engine uses (guide §9 item 1, owner «go» 2026-08-29). */
+declare const SEEDHA_MODE_IDS: readonly ["solo", "oneDevice", "multiplayer"];
+/** سناق (من سبق لبق)'s modes — D-102, owner 2026-08-29: `normal` = buzz-to-claim on ONE shared question (what
+ *  every shipped build calls «Snag»), `sebaq` = everyone races the SAME set on their own phone (D-099's rules).
+ *  ⚠️ The word ديوانية is RESERVED for a future «Group Diwaniya» — it names nothing today. */
+declare const SNAG_MODE_IDS: readonly ["normal", "sebaq"];
+/** The wire union. `'snag'` is NOT a mode: it is the LEGACY SPELLING of «game snag, mode normal» that every
+ *  shipped iOS and web build sends, and a frozen build must keep working — see internalGameOf(). The new ids
+ *  reach only pv ≥ SNAG_MODES_MIN_PV clients (`lobby.modeId` is a STRICT Swift enum: an unknown value drops
+ *  the whole frame) — wireShapeOf() down-maps for everyone else. */
+declare const MODE_IDS: readonly ["solo", "oneDevice", "multiplayer", "normal", "sebaq", "snag"];
+declare const SNAG_MODES_MIN_PV = 8;
+type SnagModeId = (typeof SNAG_MODE_IDS)[number];
 type ModeId = (typeof MODE_IDS)[number];
+type SeedhaModeId = (typeof SEEDHA_MODE_IDS)[number];
+/** The modes a game offers, from the registry. Games with no modes (دامة, ارسمها, سباق) → []. */
+declare function modesOf(gameId: GameId): ModeInfo[];
 interface ModeInfo {
     id: ModeId;
     gameId: GameId;
     label: string;
     onlineEligible: boolean;
+    /** A row kept only so `MODES.find(id)` keeps resolving for builds that send a game as a modeId. Not a mode:
+     *  never render it in a mode picker — `modesOf()` filters it out. */
+    legacyAlias?: true;
 }
 declare const MODES: readonly ModeInfo[];
+/**
+ * D-102 — the two directions between the PRODUCT shape (game Snag → mode normal | sebaq) and the ENGINE
+ * shape the relay runs (`gameId 'snag'` = the trivia engine in race flow; `gameId 'sebaq'` = its own
+ * engine/driver, D-026 tile-vs-engine). Both spellings stay on the wire forever: `game: 'sebaq'` and
+ * `modeId: 'snag'` are what every shipped build sends.
+ *
+ * INBOUND — `internalGameOf(game, modeId)`: what the client SAID → what the relay RUNS.
+ */
+declare function internalGameOf(game: GameId | undefined, modeId: ModeId | undefined): {
+    gameId: GameId | undefined;
+    modeId: ModeId | undefined;
+};
+/**
+ * OUTBOUND — `wireShapeOf(internalGameId, modeId, pv)`: what the relay RUNS → what THIS client can DECODE.
+ * pv ≥ 8 sees the product shape; below it, the pv7 shape it shipped with (`sebaq` as a game, `snag` as a mode).
+ */
+declare function wireShapeOf(gameId: GameId, modeId: ModeId | null, pv: number | undefined): {
+    gameId: GameId;
+    modeId: ModeId | null;
+};
 /** The modes available for a given game (for a client's mode picker). */
 declare const modesForGame: (gameId: GameId) => ModeInfo[];
 /**
@@ -176,6 +241,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     pv: z.ZodOptional<z.ZodNumber>;
     idToken: z.ZodOptional<z.ZodString>;
     platform: z.ZodOptional<z.ZodEnum<["web", "ios", "android", "tv"]>>;
+    games: z.ZodOptional<z.ZodArray<z.ZodEnum<["seedha", "snag", "trivia", "dama", "ersimha", "sebaq"]>, "many">>;
     appVersion: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     t: "createRoom";
@@ -189,6 +255,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     pv?: number | undefined;
     idToken?: string | undefined;
     platform?: "web" | "ios" | "android" | "tv" | undefined;
+    games?: ("seedha" | "snag" | "trivia" | "dama" | "ersimha" | "sebaq")[] | undefined;
     appVersion?: string | undefined;
 }, {
     t: "createRoom";
@@ -202,6 +269,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     pv?: number | undefined;
     idToken?: string | undefined;
     platform?: "web" | "ios" | "android" | "tv" | undefined;
+    games?: ("seedha" | "snag" | "trivia" | "dama" | "ersimha" | "sebaq")[] | undefined;
     appVersion?: string | undefined;
 }>, z.ZodObject<{
     t: z.ZodLiteral<"renameHost">;
@@ -260,10 +328,11 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     pv: z.ZodOptional<z.ZodNumber>;
     idToken: z.ZodOptional<z.ZodString>;
     platform: z.ZodOptional<z.ZodEnum<["web", "ios", "android", "tv"]>>;
+    games: z.ZodOptional<z.ZodArray<z.ZodEnum<["seedha", "snag", "trivia", "dama", "ersimha", "sebaq"]>, "many">>;
     appVersion: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    code: string;
     t: "joinRoom";
+    code: string;
     name: string;
     avatar?: {
         emoji: string;
@@ -273,10 +342,11 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     pv?: number | undefined;
     idToken?: string | undefined;
     platform?: "web" | "ios" | "android" | "tv" | undefined;
+    games?: ("seedha" | "snag" | "trivia" | "dama" | "ersimha" | "sebaq")[] | undefined;
     appVersion?: string | undefined;
 }, {
-    code: string;
     t: "joinRoom";
+    code: string;
     name: string;
     avatar?: {
         emoji: string;
@@ -286,6 +356,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     pv?: number | undefined;
     idToken?: string | undefined;
     platform?: "web" | "ios" | "android" | "tv" | undefined;
+    games?: ("seedha" | "snag" | "trivia" | "dama" | "ersimha" | "sebaq")[] | undefined;
     appVersion?: string | undefined;
 }>, z.ZodObject<{
     t: z.ZodLiteral<"resume">;
@@ -305,10 +376,11 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     pv: z.ZodOptional<z.ZodNumber>;
     idToken: z.ZodOptional<z.ZodString>;
     platform: z.ZodOptional<z.ZodEnum<["web", "ios", "android", "tv"]>>;
+    games: z.ZodOptional<z.ZodArray<z.ZodEnum<["seedha", "snag", "trivia", "dama", "ersimha", "sebaq"]>, "many">>;
     appVersion: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    code: string;
     t: "resume";
+    code: string;
     token: string;
     avatar?: {
         emoji: string;
@@ -318,10 +390,11 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     pv?: number | undefined;
     idToken?: string | undefined;
     platform?: "web" | "ios" | "android" | "tv" | undefined;
+    games?: ("seedha" | "snag" | "trivia" | "dama" | "ersimha" | "sebaq")[] | undefined;
     appVersion?: string | undefined;
 }, {
-    code: string;
     t: "resume";
+    code: string;
     token: string;
     avatar?: {
         emoji: string;
@@ -331,6 +404,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     pv?: number | undefined;
     idToken?: string | undefined;
     platform?: "web" | "ios" | "android" | "tv" | undefined;
+    games?: ("seedha" | "snag" | "trivia" | "dama" | "ersimha" | "sebaq")[] | undefined;
     appVersion?: string | undefined;
 }>, z.ZodObject<{
     t: z.ZodLiteral<"setPlaying">;
@@ -437,15 +511,15 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
 }>, z.ZodObject<{
     t: z.ZodLiteral<"setMode">;
     game: z.ZodOptional<z.ZodEnum<["seedha", "snag", "trivia", "dama", "ersimha", "sebaq"]>>;
-    modeId: z.ZodOptional<z.ZodEnum<["solo", "oneDevice", "snag", "multiplayer"]>>;
+    modeId: z.ZodOptional<z.ZodEnum<["solo", "oneDevice", "multiplayer", "normal", "sebaq", "snag"]>>;
 }, "strip", z.ZodTypeAny, {
     t: "setMode";
     game?: "seedha" | "snag" | "trivia" | "dama" | "ersimha" | "sebaq" | undefined;
-    modeId?: "snag" | "solo" | "oneDevice" | "multiplayer" | undefined;
+    modeId?: "snag" | "sebaq" | "solo" | "oneDevice" | "multiplayer" | "normal" | undefined;
 }, {
     t: "setMode";
     game?: "seedha" | "snag" | "trivia" | "dama" | "ersimha" | "sebaq" | undefined;
-    modeId?: "snag" | "solo" | "oneDevice" | "multiplayer" | undefined;
+    modeId?: "snag" | "sebaq" | "solo" | "oneDevice" | "multiplayer" | "normal" | undefined;
 }>, z.ZodObject<{
     t: z.ZodLiteral<"hostActivity">;
     activity: z.ZodEnum<["options", "configuring", "idle"]>;
@@ -469,7 +543,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     }, {
         difficulty?: "easy" | "medium" | "hard" | undefined;
     }>>;
-    modeId: z.ZodOptional<z.ZodEnum<["solo", "oneDevice", "snag", "multiplayer"]>>;
+    modeId: z.ZodOptional<z.ZodEnum<["solo", "oneDevice", "multiplayer", "normal", "sebaq", "snag"]>>;
     buzzerMode: z.ZodOptional<z.ZodEnum<["off", "solo", "race", "controller"]>>;
     noHost: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
@@ -477,7 +551,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     categoryIds: string[];
     totalRounds: number;
     game?: "seedha" | "snag" | "trivia" | "dama" | "ersimha" | "sebaq" | undefined;
-    modeId?: "snag" | "solo" | "oneDevice" | "multiplayer" | undefined;
+    modeId?: "snag" | "sebaq" | "solo" | "oneDevice" | "multiplayer" | "normal" | undefined;
     hostPlays?: boolean | undefined;
     players?: string[] | undefined;
     bot?: {
@@ -490,7 +564,7 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     categoryIds: string[];
     totalRounds: number;
     game?: "seedha" | "snag" | "trivia" | "dama" | "ersimha" | "sebaq" | undefined;
-    modeId?: "snag" | "solo" | "oneDevice" | "multiplayer" | undefined;
+    modeId?: "snag" | "sebaq" | "solo" | "oneDevice" | "multiplayer" | "normal" | undefined;
     hostPlays?: boolean | undefined;
     players?: string[] | undefined;
     bot?: {
@@ -704,8 +778,8 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     color: z.ZodString;
     width: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
-    color: string;
     t: "strokeBatch";
+    color: string;
     strokeId: string;
     seq: number;
     points: {
@@ -714,8 +788,8 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
     }[];
     width: number;
 }, {
-    color: string;
     t: "strokeBatch";
+    color: string;
     strokeId: string;
     seq: number;
     points: {
@@ -874,7 +948,7 @@ interface PackView {
     hasImage?: boolean;
 }
 type GameStatus = 'setup' | 'categorySelection' | 'inProgress' | 'completed';
-type GameplayFlow = 'classic' | 'openJudged' | 'noHost' | 'buzzer';
+type GameplayFlow = 'classic' | 'noHost' | 'buzzer';
 type BuzzerGameMode = 'off' | 'solo' | 'race' | 'controller';
 /** The help/lifeline ids (same set as the inbound `HelpType` zod enum above). */
 type HelpName = z.infer<typeof HelpType>;
@@ -890,6 +964,7 @@ interface TeamView {
     helps: {
         type: HelpName;
         isUsed: boolean;
+        unusable?: true;
     }[];
     /** The team's players in rotation order (`connected` = that player's socket is online right now).
      *  Empty for host-run single-device teams. */
@@ -1229,6 +1304,7 @@ type ServerMsg = {
     hostFrame?: string;
     hostPlaying?: boolean;
     hostPinned?: boolean;
+    hostTeamIndex?: number | null;
     players: LobbyPlayer[];
     categories: CategoryView[];
     packs?: PackView[];
@@ -1340,4 +1416,4 @@ interface MyQuestionRow {
     };
 }
 
-export { type AvatarView, type BuzzerGameMode, CHARACTER_IDS, COMEBACK_BONUS_MIN_PV, 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, type MyQuestionRow, PROTOCOL_VERSION, type PackView, type QuestionView, REJECT_REASONS, ROOM_ALPHABET, type RejectReason, type RosterEntry, SUBMISSION_KINDS, SUBMISSION_STATUSES, type SebaqStandingRow, type SebaqStateView, type ServerMsg, type SoundName, type StrokePointView, type SubmissionKind, type SubmissionStatus, type TeamSlotView, type TeamView, type YouContext, effectsForPv, gameIdForPv, gamesForPv, hostActivityForPv, modesForGame, normalizeWesternDigits, sanitizeName };
+export { type AvatarView, type BuzzerGameMode, CHARACTER_IDS, COMEBACK_BONUS_MIN_PV, COMEBACK_EFFECTS, type CategoryView, type CharacterId, ClientMsg, type DamaMoveView, type DamaPieceView, type DamaStateView, EFFECT_MIN_PV, 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, type MyQuestionRow, PROTOCOL_VERSION, type PackView, type QuestionView, REJECT_REASONS, ROOM_ALPHABET, type RejectReason, type RosterEntry, SEEDHA_MODE_IDS, SNAG_MODES_MIN_PV, SNAG_MODE_IDS, SUBMISSION_KINDS, SUBMISSION_STATUSES, type SebaqStandingRow, type SebaqStateView, type SeedhaModeId, type ServerMsg, type SnagModeId, type SoundName, type StrokePointView, type SubmissionKind, type SubmissionStatus, type TeamSlotView, type TeamView, type YouContext, effectsForPv, gameIdForPv, gamesForPv, hostActivityForPv, internalGameOf, modesForGame, modesOf, normalizeWesternDigits, sanitizeName, wireShapeOf };

package/dist/index.js

@@ -9,7 +9,7 @@ var LIMITS = {
    *  Clients batch pen points to stay under this — ~150ms batching lands at ~7/sec. */
   STROKE_BATCH_PER_SEC: 20
 };
-var PROTOCOL_VERSION = 7;
+var PROTOCOL_VERSION = 8;
 var MIN_SUPPORTED_PV = 1;
 var GAME_IDS = ["seedha", "snag", "trivia", "dama", "ersimha", "sebaq"];
 var GAMES = [
@@ -41,20 +41,55 @@ var GAMES = [
 ];
 var hostActivityForPv = (activity, pv) => activity === "options" && (pv ?? MIN_SUPPORTED_PV) < 6 ? "configuring" : activity;
 var COMEBACK_BONUS_MIN_PV = 7;
-var COMEBACK_EFFECTS = /* @__PURE__ */ new Set(["comebackBonus", "comebackOffer", "comebackDeclined"]);
-var effectsForPv = (effects, pv) => (pv ?? MIN_SUPPORTED_PV) >= COMEBACK_BONUS_MIN_PV ? effects : effects.filter((e) => !COMEBACK_EFFECTS.has(e.t));
+var EFFECT_MIN_PV = {
+  comebackOffer: COMEBACK_BONUS_MIN_PV,
+  comebackBonus: COMEBACK_BONUS_MIN_PV,
+  comebackDeclined: COMEBACK_BONUS_MIN_PV
+};
+var COMEBACK_EFFECTS = ["comebackOffer", "comebackBonus", "comebackDeclined"];
+var effectsForPv = (effects, pv) => {
+  const have = pv ?? MIN_SUPPORTED_PV;
+  return effects.filter((e) => (EFFECT_MIN_PV[e.t] ?? MIN_SUPPORTED_PV) <= have);
+};
 var gamesForPv = (pv) => GAMES.filter((g) => !g.deprecated && g.minPv <= pv);
 var gameIdForPv = (gameId, pv) => {
   const g = GAMES.find((x) => x.id === gameId);
   return g && !g.deprecated && (pv ?? MIN_SUPPORTED_PV) >= g.minPv ? gameId : "trivia";
 };
-var MODE_IDS = ["solo", "oneDevice", "snag", "multiplayer"];
+var SEEDHA_MODE_IDS = ["solo", "oneDevice", "multiplayer"];
+var SNAG_MODE_IDS = ["normal", "sebaq"];
+var MODE_IDS = [...SEEDHA_MODE_IDS, ...SNAG_MODE_IDS, "snag"];
+var SNAG_MODES_MIN_PV = 8;
+function modesOf(gameId) {
+  return MODES.filter((m) => m.gameId === gameId && !m.legacyAlias);
+}
 var MODES = [
   { id: "solo", gameId: "seedha", label: "Training", onlineEligible: false },
   { id: "oneDevice", gameId: "seedha", label: "One Device", onlineEligible: false },
   { id: "multiplayer", gameId: "seedha", label: "Multiplayer", onlineEligible: true },
-  { id: "snag", gameId: "snag", label: "Snag", onlineEligible: true }
+  // D-102: today's buzz Snag, by its real name. OFF the boards (owner 2026-08-29): the host awards 1-answer
+  // questions and the Comeback +100, so its score is not the relay's alone.
+  { id: "normal", gameId: "snag", label: "Normal", onlineEligible: false },
+  { id: "sebaq", gameId: "snag", label: "Sebaq", onlineEligible: true },
+  // D-102: the race — relay-scored end to end; THE Snag board
+  // NOT a mode — the legacy spelling of «snag / normal» (see MODE_IDS). Kept so old clients' `MODES.find` still maps it.
+  { id: "snag", gameId: "snag", label: "Snag", onlineEligible: false, legacyAlias: true }
 ];
+function internalGameOf(game, modeId) {
+  if (modeId === "sebaq" || game === "sebaq") return { gameId: "sebaq", modeId: void 0 };
+  if (modeId === "snag") return { gameId: "snag", modeId: "normal" };
+  if (modeId === "normal") return { gameId: "snag", modeId: "normal" };
+  return { gameId: game, modeId };
+}
+function wireShapeOf(gameId, modeId, pv) {
+  const v = pv ?? MIN_SUPPORTED_PV;
+  if (gameId === "sebaq") return v >= SNAG_MODES_MIN_PV ? { gameId: "snag", modeId: "sebaq" } : { gameId: gameIdForPv("sebaq", pv), modeId: null };
+  if (gameId === "snag") {
+    const m = modeId === "normal" || modeId === "snag" ? v >= SNAG_MODES_MIN_PV ? "normal" : "snag" : modeId;
+    return { gameId: gameIdForPv("snag", pv), modeId: m };
+  }
+  return { gameId: gameIdForPv(gameId, pv), modeId };
+}
 var modesForGame = (gameId) => MODES.filter((m) => m.gameId === gameId);
 var EMOTE_IDS = ["laugh", "wow", "think", "gg"];
 var CHARACTER_IDS = ["m", "f"];
@@ -77,6 +112,7 @@ var HelpType = z.enum([
 var Pv = z.number().int().min(1).max(1e6).optional();
 var IdToken = z.string().max(4096).optional();
 var Platform = z.enum(["web", "ios", "android", "tv"]).optional();
+var Games = z.array(z.enum(GAME_IDS)).max(GAME_IDS.length).optional();
 var AppVersion = z.string().trim().max(24).regex(/^[0-9]+(\.[0-9]+){0,3}([-+][0-9A-Za-z.-]+)?$/, "bad app version").optional();
 var Avatar = z.object({
   emoji: z.string().min(1).max(16).transform((s) => s.replace(UNSAFE_CHARS, "")).refine((s) => s.length >= 1, "empty emoji"),
@@ -85,7 +121,7 @@ var Avatar = z.object({
 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(), character: Character.optional(), pv: Pv, idToken: IdToken, platform: Platform, appVersion: AppVersion }),
+  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, games: Games, appVersion: AppVersion }),
   // 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).
@@ -99,8 +135,8 @@ var ClientMsg = z.discriminatedUnion("t", [
   // 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(), 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, appVersion: AppVersion }),
-  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, appVersion: AppVersion }),
+  z.object({ t: z.literal("joinRoom"), code: RoomCode, name: DisplayName, avatar: Avatar.optional(), character: Character.optional(), pv: Pv, idToken: IdToken, platform: Platform, games: Games, appVersion: AppVersion }),
+  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, games: Games, appVersion: AppVersion }),
   // `tally` (gs#46) = wins per PLAYER across every game this room has played tonight — «نتيجة الليلة».
   // Keyed by playerId, NOT by team: team names are recycled each game, so a per-team count means nothing
   // across a night. Survives playAgain. A One Device game credits nobody (its team slots hold no players).
@@ -315,7 +351,9 @@ var REJECT_REASONS = ["duplicate", "unclear_answer", "not_family", "inaccurate",
 export {
   CHARACTER_IDS,
   COMEBACK_BONUS_MIN_PV,
+  COMEBACK_EFFECTS,
   ClientMsg,
+  EFFECT_MIN_PV,
   EMOTE_IDS,
   GAMES,
   GAME_IDS,
@@ -326,13 +364,19 @@ export {
   PROTOCOL_VERSION,
   REJECT_REASONS,
   ROOM_ALPHABET,
+  SEEDHA_MODE_IDS,
+  SNAG_MODES_MIN_PV,
+  SNAG_MODE_IDS,
   SUBMISSION_KINDS,
   SUBMISSION_STATUSES,
   effectsForPv,
   gameIdForPv,
   gamesForPv,
   hostActivityForPv,
+  internalGameOf,
   modesForGame,
+  modesOf,
   normalizeWesternDigits,
-  sanitizeName
+  sanitizeName,
+  wireShapeOf
 };

package/package.json

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