@thegeem/protocol 0.1.4 → 0.1.6

package/dist/index.cjs

@@ -71,13 +71,24 @@ var ClientMsg = import_zod.z.discriminatedUnion("t", [
   // Host's IN-PROGRESS category selection in the lobby — a live preview for waiting
   // players. Distinct from startGame.categoryIds, which COMMITS the board. Empty = cleared.
   import_zod.z.object({ t: import_zod.z.literal("setCategories"), categoryIds: import_zod.z.array(import_zod.z.string().max(60)).max(12) }),
+  // Host defines the lobby teams players can join (1–12). Resets picks that fall out of range.
+  import_zod.z.object({ t: import_zod.z.literal("setTeams"), teams: import_zod.z.array(DisplayName).min(1).max(LIMITS.MAX_PLAYERS) }),
+  // A player joins team slot `teamIndex` (0-based, into the host's `setTeams` list).
+  import_zod.z.object({ t: import_zod.z.literal("pickTeam"), teamIndex: import_zod.z.number().int().min(0).max(LIMITS.MAX_PLAYERS - 1) }),
   // host game actions
   import_zod.z.object({
     t: import_zod.z.literal("startGame"),
     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(1).max(12),
+    // How to play (maps to the engine). Omit → controller (each player answers from
+    // their own device). 'off' = one device drives (Me-Controller); pair with noHost.
+    //   solo=Solo · race=Snag/buzz · controller=each-player-from-device · off=Me-Controller
+    buzzerMode: import_zod.z.enum(["off", "solo", "race", "controller"]).optional(),
+    // Only meaningful for 'off' (Me-Controller): false = a referee drives & sees answers
+    // (classic); true = the driver is a player, answers stay hidden + auto-reveal (noHost).
+    noHost: import_zod.z.boolean().optional()
   }),
   import_zod.z.object({ t: import_zod.z.literal("pickLevel"), categoryId: import_zod.z.string().max(60), level: import_zod.z.number().int().min(1).max(6) }),
   import_zod.z.object({ t: import_zod.z.literal("nextTurn") }),

package/dist/index.d.cts

@@ -196,21 +196,45 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
 }, {
     t: "setCategories";
     categoryIds: string[];
+}>, z.ZodObject<{
+    t: z.ZodLiteral<"setTeams">;
+    teams: z.ZodArray<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, "many">;
+}, "strip", z.ZodTypeAny, {
+    t: "setTeams";
+    teams: string[];
+}, {
+    t: "setTeams";
+    teams: string[];
+}>, z.ZodObject<{
+    t: z.ZodLiteral<"pickTeam">;
+    teamIndex: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    t: "pickTeam";
+    teamIndex: number;
+}, {
+    t: "pickTeam";
+    teamIndex: number;
 }>, z.ZodObject<{
     t: z.ZodLiteral<"startGame">;
     game: z.ZodOptional<z.ZodEnum<["trivia"]>>;
     totalRounds: z.ZodNumber;
     categoryIds: z.ZodArray<z.ZodString, "many">;
+    buzzerMode: z.ZodOptional<z.ZodEnum<["off", "solo", "race", "controller"]>>;
+    noHost: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     t: "startGame";
     categoryIds: string[];
     totalRounds: number;
     game?: "trivia" | undefined;
+    buzzerMode?: "off" | "solo" | "race" | "controller" | undefined;
+    noHost?: boolean | undefined;
 }, {
     t: "startGame";
     categoryIds: string[];
     totalRounds: number;
     game?: "trivia" | undefined;
+    buzzerMode?: "off" | "solo" | "race" | "controller" | undefined;
+    noHost?: boolean | undefined;
 }>, z.ZodObject<{
     t: z.ZodLiteral<"pickLevel">;
     categoryId: z.ZodString;
@@ -308,6 +332,11 @@ interface AvatarView {
     emoji: string;
     color: string;
 }
+/** A lobby team slot players can join (`pickTeam` by its index in `lobby.teams`). */
+interface TeamSlotView {
+    name: string;
+    color: string;
+}
 interface LobbyPlayer {
     id: string;
     name: string;
@@ -470,6 +499,7 @@ type ServerMsg = {
     players: LobbyPlayer[];
     categories: CategoryView[];
     selectedCategoryIds: string[];
+    teams: TeamSlotView[];
     you: YouContext;
 } | {
     t: 'state';
@@ -486,4 +516,4 @@ type ServerMsg = {
     message: string;
 };
 
-export { type AvatarView, type BuzzerGameMode, type CategoryView, ClientMsg, type Effect, GAME_IDS, type GameId, type GameStateView, type GameStatus, type GameplayFlow, type HelpName, LIMITS, type LobbyPlayer, PROTOCOL_VERSION, type QuestionView, ROOM_ALPHABET, type ServerMsg, type SoundName, type TeamView, type YouContext };
+export { type AvatarView, type BuzzerGameMode, type CategoryView, ClientMsg, type Effect, GAME_IDS, type GameId, type GameStateView, type GameStatus, type GameplayFlow, type HelpName, LIMITS, type LobbyPlayer, PROTOCOL_VERSION, type QuestionView, ROOM_ALPHABET, type ServerMsg, type SoundName, type TeamSlotView, type TeamView, type YouContext };

package/dist/index.d.ts

@@ -196,21 +196,45 @@ declare const ClientMsg: z.ZodDiscriminatedUnion<"t", [z.ZodObject<{
 }, {
     t: "setCategories";
     categoryIds: string[];
+}>, z.ZodObject<{
+    t: z.ZodLiteral<"setTeams">;
+    teams: z.ZodArray<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, "many">;
+}, "strip", z.ZodTypeAny, {
+    t: "setTeams";
+    teams: string[];
+}, {
+    t: "setTeams";
+    teams: string[];
+}>, z.ZodObject<{
+    t: z.ZodLiteral<"pickTeam">;
+    teamIndex: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    t: "pickTeam";
+    teamIndex: number;
+}, {
+    t: "pickTeam";
+    teamIndex: number;
 }>, z.ZodObject<{
     t: z.ZodLiteral<"startGame">;
     game: z.ZodOptional<z.ZodEnum<["trivia"]>>;
     totalRounds: z.ZodNumber;
     categoryIds: z.ZodArray<z.ZodString, "many">;
+    buzzerMode: z.ZodOptional<z.ZodEnum<["off", "solo", "race", "controller"]>>;
+    noHost: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     t: "startGame";
     categoryIds: string[];
     totalRounds: number;
     game?: "trivia" | undefined;
+    buzzerMode?: "off" | "solo" | "race" | "controller" | undefined;
+    noHost?: boolean | undefined;
 }, {
     t: "startGame";
     categoryIds: string[];
     totalRounds: number;
     game?: "trivia" | undefined;
+    buzzerMode?: "off" | "solo" | "race" | "controller" | undefined;
+    noHost?: boolean | undefined;
 }>, z.ZodObject<{
     t: z.ZodLiteral<"pickLevel">;
     categoryId: z.ZodString;
@@ -308,6 +332,11 @@ interface AvatarView {
     emoji: string;
     color: string;
 }
+/** A lobby team slot players can join (`pickTeam` by its index in `lobby.teams`). */
+interface TeamSlotView {
+    name: string;
+    color: string;
+}
 interface LobbyPlayer {
     id: string;
     name: string;
@@ -470,6 +499,7 @@ type ServerMsg = {
     players: LobbyPlayer[];
     categories: CategoryView[];
     selectedCategoryIds: string[];
+    teams: TeamSlotView[];
     you: YouContext;
 } | {
     t: 'state';
@@ -486,4 +516,4 @@ type ServerMsg = {
     message: string;
 };
 
-export { type AvatarView, type BuzzerGameMode, type CategoryView, ClientMsg, type Effect, GAME_IDS, type GameId, type GameStateView, type GameStatus, type GameplayFlow, type HelpName, LIMITS, type LobbyPlayer, PROTOCOL_VERSION, type QuestionView, ROOM_ALPHABET, type ServerMsg, type SoundName, type TeamView, type YouContext };
+export { type AvatarView, type BuzzerGameMode, type CategoryView, ClientMsg, type Effect, GAME_IDS, type GameId, type GameStateView, type GameStatus, type GameplayFlow, type HelpName, LIMITS, type LobbyPlayer, PROTOCOL_VERSION, type QuestionView, ROOM_ALPHABET, type ServerMsg, type SoundName, type TeamSlotView, type TeamView, type YouContext };

package/dist/index.js

@@ -43,13 +43,24 @@ var ClientMsg = z.discriminatedUnion("t", [
   // Host's IN-PROGRESS category selection in the lobby — a live preview for waiting
   // players. Distinct from startGame.categoryIds, which COMMITS the board. Empty = cleared.
   z.object({ t: z.literal("setCategories"), categoryIds: z.array(z.string().max(60)).max(12) }),
+  // Host defines the lobby teams players can join (1–12). Resets picks that fall out of range.
+  z.object({ t: z.literal("setTeams"), teams: z.array(DisplayName).min(1).max(LIMITS.MAX_PLAYERS) }),
+  // A player joins team slot `teamIndex` (0-based, into the host's `setTeams` list).
+  z.object({ t: z.literal("pickTeam"), teamIndex: z.number().int().min(0).max(LIMITS.MAX_PLAYERS - 1) }),
   // host game actions
   z.object({
     t: z.literal("startGame"),
     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(1).max(12),
+    // How to play (maps to the engine). Omit → controller (each player answers from
+    // their own device). 'off' = one device drives (Me-Controller); pair with noHost.
+    //   solo=Solo · race=Snag/buzz · controller=each-player-from-device · off=Me-Controller
+    buzzerMode: z.enum(["off", "solo", "race", "controller"]).optional(),
+    // Only meaningful for 'off' (Me-Controller): false = a referee drives & sees answers
+    // (classic); true = the driver is a player, answers stay hidden + auto-reveal (noHost).
+    noHost: z.boolean().optional()
   }),
   z.object({ t: z.literal("pickLevel"), categoryId: z.string().max(60), level: z.number().int().min(1).max(6) }),
   z.object({ t: z.literal("nextTurn") }),

package/package.json

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