@joystyk/rooms 0.0.0 → 0.2.0

package/dist/protocol/schemas.js

@@ -0,0 +1,332 @@
+import { isJson } from "@joystyk/contracts";
+import * as z from "zod/mini";
+//#region src/protocol/schemas.ts
+/** The current wire protocol version. */
+var PROTOCOL_VERSION = 1;
+/** Versions the server accepts: the current one and, once it exists, the previous one (Rule 4). */
+var SUPPORTED_PROTOCOLS = [1];
+/** Invite-code letters: no 0/O or 1/I. */
+var ROOM_ALPHABET = "ABCDEFGHJKLMNPQRSTUVWXYZ23456789";
+var ROOM_CODE_LENGTH = 6;
+/** Any JSON value, checked with the contract's `isJson` (no NaN, Infinity or -0). */
+var JsonValue = z.custom((value) => isJson(value), { message: "Expected a JSON value." });
+var RoomCode = z.string().check(z.regex(/^[A-HJ-NP-Z2-9]{6}$/));
+/** Generated by the client for each action: 8–40 URL-safe characters. */
+var ActionId = z.string().check(z.regex(/^[A-Za-z0-9_-]{8,40}$/));
+/** 24 random bytes, base64url. */
+var SeatToken = z.string().check(z.regex(/^[A-Za-z0-9_-]{32}$/));
+var GameId = z.string().check(z.maxLength(64), z.regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/));
+/**
+* 1–24 characters, no control or format characters, no leading or trailing space. This schema
+* is only the shape: the room core runs the identity package's name filter and replaces a
+* refused name with a generated one (notice `name-replaced`).
+*/
+var DisplayName = z.string().check(z.minLength(1), z.maxLength(24), z.regex(/^(?![\s\S]*[\p{Cc}\p{Cf}])\S(?:[\s\S]*\S)?$/u));
+var Revision = z.int().check(z.nonnegative());
+var SeatIdSchema = z.int().check(z.nonnegative(), z.maximum(63));
+var BuildId = z.string().check(z.minLength(1), z.maxLength(64), z.regex(/^[A-Za-z0-9._+-]+$/));
+var Version = z.int().check(z.positive());
+/** A decision clock in milliseconds: 1 s to 24 h. */
+var DecisionMs = z.int().check(z.minimum(1e3), z.maximum(864e5));
+var AiLevel = z.string().check(z.minLength(1), z.maxLength(32));
+/** A time bank: 1 s to 24 h to start with, and up to 1 h added back per move. */
+var BankSettingSchema = z.strictObject({
+	initialMs: z.int().check(z.minimum(1e3), z.maximum(864e5)),
+	incrementMs: z.int().check(z.nonnegative(), z.maximum(36e5))
+});
+var Time = z.number().check(z.nonnegative());
+var GamePinSchema = z.object({
+	id: GameId,
+	build: BuildId,
+	rulesVersion: z.int().check(z.nonnegative()),
+	saveVersion: z.int().check(z.nonnegative())
+});
+var RoomPhaseSchema = z.enum([
+	"lobby",
+	"playing",
+	"finished",
+	"closed"
+]);
+var OfferKindSchema = z.enum(["rematch", "end"]);
+/** An offer's id: the revision that opened it. */
+var OfferId = Revision;
+var RoomControlSchema = z.discriminatedUnion("kind", [
+	z.strictObject({
+		kind: z.literal("ready"),
+		ready: z.boolean()
+	}),
+	z.strictObject({
+		kind: z.literal("settings"),
+		decisionMs: z.optional(z.nullable(DecisionMs)),
+		bank: z.optional(z.nullable(BankSettingSchema)),
+		config: z.optional(JsonValue),
+		aiLevel: z.optional(AiLevel)
+	}),
+	z.strictObject({
+		kind: z.literal("fill-with-ai"),
+		seat: SeatIdSchema
+	}),
+	z.strictObject({
+		kind: z.literal("remove-seat"),
+		seat: SeatIdSchema
+	}),
+	z.strictObject({ kind: z.literal("start") }),
+	z.strictObject({
+		kind: z.literal("offer"),
+		offer: OfferKindSchema
+	}),
+	z.strictObject({
+		kind: z.literal("accept"),
+		offer: OfferId
+	}),
+	z.strictObject({
+		kind: z.literal("decline"),
+		offer: OfferId
+	}),
+	z.strictObject({
+		kind: z.literal("withdraw"),
+		offer: OfferId
+	}),
+	z.strictObject({ kind: z.literal("leave-seat") }),
+	z.strictObject({ kind: z.literal("resign") })
+]);
+var JoinMessageSchema = z.strictObject({
+	v: Version,
+	t: z.literal("join"),
+	room: RoomCode,
+	game: GameId,
+	name: DisplayName,
+	token: z.optional(SeatToken),
+	watch: z.optional(z.boolean()),
+	build: BuildId
+});
+var ActMessageSchema = z.strictObject({
+	v: Version,
+	t: z.literal("act"),
+	id: ActionId,
+	rev: Revision,
+	command: JsonValue
+});
+var ControlMessageSchema = z.strictObject({
+	v: Version,
+	t: z.literal("control"),
+	id: ActionId,
+	rev: Revision,
+	control: RoomControlSchema
+});
+var ResyncMessageSchema = z.strictObject({
+	v: Version,
+	t: z.literal("resync")
+});
+var ClientMessageSchema = z.discriminatedUnion("t", [
+	JoinMessageSchema,
+	ActMessageSchema,
+	ControlMessageSchema,
+	ResyncMessageSchema
+]);
+var PublicSeatSchema = z.object({
+	id: SeatIdSchema,
+	name: z.string(),
+	controller: z.enum(["human", "ai"]),
+	aiLevel: z.nullable(z.string()),
+	claimed: z.boolean(),
+	ready: z.boolean()
+});
+var PresenceSchema = z.object({
+	connected: z.array(z.boolean()),
+	clocks: z.array(z.object({
+		seat: SeatIdSchema,
+		remainingMs: Time,
+		running: z.boolean(),
+		paused: z.optional(z.boolean())
+	})),
+	paused: z.boolean(),
+	spectators: z.int().check(z.nonnegative())
+});
+var SettingsSchema = z.object({
+	decisionMs: z.nullable(z.int()),
+	bank: z.nullable(z.object({
+		initialMs: z.int(),
+		incrementMs: z.int()
+	})),
+	aiLevel: z.nullable(z.string())
+});
+var OutcomeSchema = z.object({
+	result: z.enum([
+		"won",
+		"lost",
+		"draw",
+		"completed",
+		"abandoned"
+	]),
+	placements: z.array(z.object({
+		seat: SeatIdSchema,
+		place: z.int(),
+		score: z.optional(z.number())
+	})),
+	summary: z.string(),
+	stats: z.optional(z.record(z.string(), z.number())),
+	elapsedMs: z.optional(Time)
+});
+var RoomOfferSchema = z.object({
+	id: OfferId,
+	kind: OfferKindSchema,
+	by: SeatIdSchema,
+	status: z.enum([
+		"open",
+		"declined",
+		"withdrawn"
+	]),
+	accepted: z.array(SeatIdSchema),
+	declinedBy: z.nullable(SeatIdSchema),
+	endsAt: z.nullable(Time)
+});
+var ViewBeatSchema = z.object({
+	event: JsonValue,
+	view: z.optional(JsonValue)
+});
+var WelcomeMessageSchema = z.object({
+	v: Version,
+	t: z.literal("welcome"),
+	room: RoomCode,
+	seat: z.nullable(SeatIdSchema),
+	token: z.optional(SeatToken),
+	host: z.nullable(SeatIdSchema),
+	game: GamePinSchema,
+	protocol: Version
+});
+var SnapshotMessageSchema = z.object({
+	v: Version,
+	t: z.literal("snapshot"),
+	epoch: z.int().check(z.nonnegative()),
+	revision: Revision,
+	phase: RoomPhaseSchema,
+	seat: z.nullable(SeatIdSchema),
+	seats: z.array(PublicSeatSchema),
+	host: z.nullable(SeatIdSchema),
+	game: GamePinSchema,
+	settings: SettingsSchema,
+	view: z.nullable(JsonValue),
+	history: z.array(JsonValue),
+	pending: z.array(SeatIdSchema),
+	outcome: z.nullable(OutcomeSchema),
+	presentation: z.nullable(JsonValue),
+	offer: z.optional(z.nullable(RoomOfferSchema)),
+	presence: PresenceSchema,
+	serverTime: Time
+});
+var UpdateMessageSchema = z.object({
+	v: Version,
+	t: z.literal("update"),
+	epoch: z.int().check(z.nonnegative()),
+	revision: Revision,
+	from: Revision,
+	phase: RoomPhaseSchema,
+	host: z.nullable(SeatIdSchema),
+	seats: z.optional(z.array(PublicSeatSchema)),
+	settings: z.optional(SettingsSchema),
+	beats: z.array(ViewBeatSchema),
+	view: z.nullable(JsonValue),
+	pending: z.array(SeatIdSchema),
+	outcome: z.nullable(OutcomeSchema),
+	presentation: z.optional(z.nullable(JsonValue)),
+	offer: z.optional(z.nullable(RoomOfferSchema)),
+	presence: PresenceSchema,
+	serverTime: Time
+});
+/** Platform rejection codes, or a game's `GameError.code` with a `game:` prefix. */
+var RejectionCodeSchema = z.string().check(z.regex(/^(?:[a-z-]+|game:.+)$/));
+var ReceiptMessageSchema = z.object({
+	v: Version,
+	t: z.literal("receipt"),
+	id: ActionId,
+	result: z.discriminatedUnion("status", [z.object({
+		status: z.literal("accepted"),
+		revision: Revision
+	}), z.object({
+		status: z.literal("rejected"),
+		code: RejectionCodeSchema,
+		message: z.string(),
+		revision: Revision
+	})])
+});
+var PresenceMessageSchema = z.object({
+	v: Version,
+	t: z.literal("presence"),
+	presence: PresenceSchema,
+	serverTime: Time
+});
+var NoticeCodeSchema = z.enum([
+	"bad-message",
+	"too-fast",
+	"no-such-room",
+	"room-full",
+	"protocol-unsupported",
+	"server-busy",
+	"name-replaced"
+]);
+var NoticeMessageSchema = z.object({
+	v: Version,
+	t: z.literal("notice"),
+	code: NoticeCodeSchema,
+	message: z.string()
+});
+var ReplacedMessageSchema = z.object({
+	v: Version,
+	t: z.literal("replaced")
+});
+var ClosingMessageSchema = z.object({
+	v: Version,
+	t: z.literal("closing"),
+	reason: z.enum([
+		"restart",
+		"expired",
+		"closed"
+	]),
+	retryAfterMs: z.nullable(Time)
+});
+var ServerMessageSchema = z.discriminatedUnion("t", [
+	WelcomeMessageSchema,
+	SnapshotMessageSchema,
+	UpdateMessageSchema,
+	ReceiptMessageSchema,
+	PresenceMessageSchema,
+	NoticeMessageSchema,
+	ReplacedMessageSchema,
+	ClosingMessageSchema
+]);
+var CreateRoomRequestSchema = z.strictObject({
+	game: GameId,
+	name: DisplayName,
+	config: z.optional(JsonValue),
+	settings: z.optional(z.strictObject({
+		decisionMs: z.optional(z.nullable(DecisionMs)),
+		bank: z.optional(z.nullable(BankSettingSchema))
+	}))
+});
+var CreateRoomResponseSchema = z.object({
+	room: RoomCode,
+	token: SeatToken,
+	name: z.string(),
+	notice: z.optional(z.object({
+		code: NoticeCodeSchema,
+		message: z.string()
+	})),
+	game: GamePinSchema,
+	expiresAt: Time
+});
+var RoomInfoSchema = z.object({
+	game: GamePinSchema,
+	phase: RoomPhaseSchema,
+	seatsOpen: z.int().check(z.nonnegative()),
+	spectatorsAllowed: z.boolean()
+});
+var HostedGamesSchema = z.object({
+	protocol: Version,
+	protocols: z.array(Version),
+	games: z.array(GameId)
+});
+//#endregion
+export { ActMessageSchema, ActionId, BankSettingSchema, BuildId, ClientMessageSchema, ClosingMessageSchema, ControlMessageSchema, CreateRoomRequestSchema, CreateRoomResponseSchema, DecisionMs, DisplayName, GameId, GamePinSchema, HostedGamesSchema, JoinMessageSchema, JsonValue, NoticeCodeSchema, NoticeMessageSchema, OfferKindSchema, PROTOCOL_VERSION, PresenceMessageSchema, ROOM_ALPHABET, ROOM_CODE_LENGTH, ReceiptMessageSchema, RejectionCodeSchema, ReplacedMessageSchema, ResyncMessageSchema, Revision, RoomCode, RoomControlSchema, RoomInfoSchema, RoomOfferSchema, RoomPhaseSchema, SUPPORTED_PROTOCOLS, SeatIdSchema, SeatToken, ServerMessageSchema, SnapshotMessageSchema, UpdateMessageSchema, WelcomeMessageSchema };
+
+//# sourceMappingURL=schemas.js.map

package/dist/protocol/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","names":[],"sources":["../../src/protocol/schemas.ts"],"sourcesContent":["// Zod 4 schemas (zod/mini, D-22) for every wire message. They are Standard Schemas (D-18),\n// shared by the server, the session package's remote client and the P2P host. The game's\n// own schemas validate the payloads inside (`command`, `view`, events).\nimport { isJson, type Json } from '@joystyk/contracts';\nimport * as z from 'zod/mini';\n\n/** The current wire protocol version. */\nexport const PROTOCOL_VERSION = 1;\n\n/** Versions the server accepts: the current one and, once it exists, the previous one (Rule 4). */\nexport const SUPPORTED_PROTOCOLS: readonly number[] = [PROTOCOL_VERSION];\n\n/** Invite-code letters: no 0/O or 1/I. */\nexport const ROOM_ALPHABET = 'ABCDEFGHJKLMNPQRSTUVWXYZ23456789';\nexport const ROOM_CODE_LENGTH = 6;\n\n/** Any JSON value, checked with the contract's `isJson` (no NaN, Infinity or -0). */\nexport const JsonValue = z.custom<Json>((value) => isJson(value), { message: 'Expected a JSON value.' });\n\nexport const RoomCode = z.string().check(z.regex(/^[A-HJ-NP-Z2-9]{6}$/));\n/** A six-character invite code from `ROOM_ALPHABET`. */\nexport type RoomCode = string;\n/** Generated by the client for each action: 8–40 URL-safe characters. */\nexport const ActionId = z.string().check(z.regex(/^[A-Za-z0-9_-]{8,40}$/));\nexport type ActionId = string;\n/** 24 random bytes, base64url. */\nexport const SeatToken = z.string().check(z.regex(/^[A-Za-z0-9_-]{32}$/));\nexport const GameId = z.string().check(z.maxLength(64), z.regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/));\n/**\n * 1–24 characters, no control or format characters, no leading or trailing space. This schema\n * is only the shape: the room core runs the identity package's name filter and replaces a\n * refused name with a generated one (notice `name-replaced`).\n */\nexport const DisplayName = z\n  .string()\n  .check(z.minLength(1), z.maxLength(24), z.regex(/^(?![\\s\\S]*[\\p{Cc}\\p{Cf}])\\S(?:[\\s\\S]*\\S)?$/u));\nexport const Revision = z.int().check(z.nonnegative());\nexport const SeatIdSchema = z.int().check(z.nonnegative(), z.maximum(63));\nexport const BuildId = z.string().check(z.minLength(1), z.maxLength(64), z.regex(/^[A-Za-z0-9._+-]+$/));\nconst Version = z.int().check(z.positive());\n/** A decision clock in milliseconds: 1 s to 24 h. */\nexport const DecisionMs = z.int().check(z.minimum(1_000), z.maximum(86_400_000));\nconst AiLevel = z.string().check(z.minLength(1), z.maxLength(32));\n/** A time bank: 1 s to 24 h to start with, and up to 1 h added back per move. */\nexport const BankSettingSchema = z.strictObject({\n  initialMs: z.int().check(z.minimum(1_000), z.maximum(86_400_000)),\n  incrementMs: z.int().check(z.nonnegative(), z.maximum(3_600_000)),\n});\nconst Time = z.number().check(z.nonnegative());\n\nexport const GamePinSchema = z.object({\n  id: GameId,\n  build: BuildId,\n  rulesVersion: z.int().check(z.nonnegative()),\n  saveVersion: z.int().check(z.nonnegative()),\n});\n\nexport const RoomPhaseSchema = z.enum(['lobby', 'playing', 'finished', 'closed']);\n\nexport const OfferKindSchema = z.enum(['rematch', 'end']);\n/** An offer's id: the revision that opened it. */\nconst OfferId = Revision;\n\nexport const RoomControlSchema = z.discriminatedUnion('kind', [\n  z.strictObject({ kind: z.literal('ready'), ready: z.boolean() }),\n  z.strictObject({\n    kind: z.literal('settings'),\n    decisionMs: z.optional(z.nullable(DecisionMs)),\n    bank: z.optional(z.nullable(BankSettingSchema)),\n    config: z.optional(JsonValue),\n    aiLevel: z.optional(AiLevel),\n  }),\n  z.strictObject({ kind: z.literal('fill-with-ai'), seat: SeatIdSchema }),\n  z.strictObject({ kind: z.literal('remove-seat'), seat: SeatIdSchema }),\n  z.strictObject({ kind: z.literal('start') }),\n  z.strictObject({ kind: z.literal('offer'), offer: OfferKindSchema }),\n  z.strictObject({ kind: z.literal('accept'), offer: OfferId }),\n  z.strictObject({ kind: z.literal('decline'), offer: OfferId }),\n  z.strictObject({ kind: z.literal('withdraw'), offer: OfferId }),\n  z.strictObject({ kind: z.literal('leave-seat') }),\n  z.strictObject({ kind: z.literal('resign') }),\n]);\n\n// ── Client → server ─────────────────────────────────────────────────────────────────────\n\nexport const JoinMessageSchema = z.strictObject({\n  v: Version,\n  t: z.literal('join'),\n  room: RoomCode,\n  game: GameId,\n  name: DisplayName,\n  token: z.optional(SeatToken),\n  watch: z.optional(z.boolean()),\n  build: BuildId,\n});\n\nexport const ActMessageSchema = z.strictObject({\n  v: Version,\n  t: z.literal('act'),\n  id: ActionId,\n  rev: Revision,\n  command: JsonValue,\n});\n\nexport const ControlMessageSchema = z.strictObject({\n  v: Version,\n  t: z.literal('control'),\n  id: ActionId,\n  rev: Revision,\n  control: RoomControlSchema,\n});\n\nexport const ResyncMessageSchema = z.strictObject({ v: Version, t: z.literal('resync') });\n\nexport const ClientMessageSchema = z.discriminatedUnion('t', [\n  JoinMessageSchema,\n  ActMessageSchema,\n  ControlMessageSchema,\n  ResyncMessageSchema,\n]);\n\n// ── Server → client ─────────────────────────────────────────────────────────────────────\n\nconst PublicSeatSchema = z.object({\n  id: SeatIdSchema,\n  name: z.string(),\n  controller: z.enum(['human', 'ai']),\n  aiLevel: z.nullable(z.string()),\n  claimed: z.boolean(),\n  ready: z.boolean(),\n});\n\nconst PresenceSchema = z.object({\n  connected: z.array(z.boolean()),\n  clocks: z.array(\n    z.object({ seat: SeatIdSchema, remainingMs: Time, running: z.boolean(), paused: z.optional(z.boolean()) }),\n  ),\n  paused: z.boolean(),\n  spectators: z.int().check(z.nonnegative()),\n});\n\nconst SettingsSchema = z.object({\n  decisionMs: z.nullable(z.int()),\n  bank: z.nullable(z.object({ initialMs: z.int(), incrementMs: z.int() })),\n  aiLevel: z.nullable(z.string()),\n});\n\nconst OutcomeSchema = z.object({\n  result: z.enum(['won', 'lost', 'draw', 'completed', 'abandoned']),\n  placements: z.array(z.object({ seat: SeatIdSchema, place: z.int(), score: z.optional(z.number()) })),\n  summary: z.string(),\n  stats: z.optional(z.record(z.string(), z.number())),\n  elapsedMs: z.optional(Time),\n});\n\nexport const RoomOfferSchema = z.object({\n  id: OfferId,\n  kind: OfferKindSchema,\n  by: SeatIdSchema,\n  status: z.enum(['open', 'declined', 'withdrawn']),\n  accepted: z.array(SeatIdSchema),\n  declinedBy: z.nullable(SeatIdSchema),\n  endsAt: z.nullable(Time),\n});\n\nconst ViewBeatSchema = z.object({ event: JsonValue, view: z.optional(JsonValue) });\n\nexport const WelcomeMessageSchema = z.object({\n  v: Version,\n  t: z.literal('welcome'),\n  room: RoomCode,\n  seat: z.nullable(SeatIdSchema),\n  token: z.optional(SeatToken),\n  host: z.nullable(SeatIdSchema),\n  game: GamePinSchema,\n  protocol: Version,\n});\n\nexport const SnapshotMessageSchema = z.object({\n  v: Version,\n  t: z.literal('snapshot'),\n  epoch: z.int().check(z.nonnegative()),\n  revision: Revision,\n  phase: RoomPhaseSchema,\n  seat: z.nullable(SeatIdSchema),\n  seats: z.array(PublicSeatSchema),\n  host: z.nullable(SeatIdSchema),\n  game: GamePinSchema,\n  settings: SettingsSchema,\n  view: z.nullable(JsonValue),\n  history: z.array(JsonValue),\n  pending: z.array(SeatIdSchema),\n  outcome: z.nullable(OutcomeSchema),\n  presentation: z.nullable(JsonValue),\n  offer: z.optional(z.nullable(RoomOfferSchema)),\n  presence: PresenceSchema,\n  serverTime: Time,\n});\n\nexport const UpdateMessageSchema = z.object({\n  v: Version,\n  t: z.literal('update'),\n  epoch: z.int().check(z.nonnegative()),\n  revision: Revision,\n  from: Revision,\n  phase: RoomPhaseSchema,\n  host: z.nullable(SeatIdSchema),\n  seats: z.optional(z.array(PublicSeatSchema)),\n  settings: z.optional(SettingsSchema),\n  beats: z.array(ViewBeatSchema),\n  view: z.nullable(JsonValue),\n  pending: z.array(SeatIdSchema),\n  outcome: z.nullable(OutcomeSchema),\n  presentation: z.optional(z.nullable(JsonValue)),\n  offer: z.optional(z.nullable(RoomOfferSchema)),\n  presence: PresenceSchema,\n  serverTime: Time,\n});\n\n/** Platform rejection codes, or a game's `GameError.code` with a `game:` prefix. */\nexport const RejectionCodeSchema = z.string().check(z.regex(/^(?:[a-z-]+|game:.+)$/));\n\nexport const ReceiptMessageSchema = z.object({\n  v: Version,\n  t: z.literal('receipt'),\n  id: ActionId,\n  result: z.discriminatedUnion('status', [\n    z.object({ status: z.literal('accepted'), revision: Revision }),\n    z.object({ status: z.literal('rejected'), code: RejectionCodeSchema, message: z.string(), revision: Revision }),\n  ]),\n});\n\nexport const PresenceMessageSchema = z.object({\n  v: Version,\n  t: z.literal('presence'),\n  presence: PresenceSchema,\n  serverTime: Time,\n});\n\nexport const NoticeCodeSchema = z.enum([\n  'bad-message',\n  'too-fast',\n  'no-such-room',\n  'room-full',\n  'protocol-unsupported',\n  'server-busy',\n  'name-replaced',\n]);\n\nexport const NoticeMessageSchema = z.object({\n  v: Version,\n  t: z.literal('notice'),\n  code: NoticeCodeSchema,\n  message: z.string(),\n});\n\nexport const ReplacedMessageSchema = z.object({ v: Version, t: z.literal('replaced') });\n\nexport const ClosingMessageSchema = z.object({\n  v: Version,\n  t: z.literal('closing'),\n  reason: z.enum(['restart', 'expired', 'closed']),\n  retryAfterMs: z.nullable(Time),\n});\n\nexport const ServerMessageSchema = z.discriminatedUnion('t', [\n  WelcomeMessageSchema,\n  SnapshotMessageSchema,\n  UpdateMessageSchema,\n  ReceiptMessageSchema,\n  PresenceMessageSchema,\n  NoticeMessageSchema,\n  ReplacedMessageSchema,\n  ClosingMessageSchema,\n]);\n\n// ── HTTP ────────────────────────────────────────────────────────────────────────────────\n\nexport const CreateRoomRequestSchema = z.strictObject({\n  game: GameId,\n  name: DisplayName,\n  config: z.optional(JsonValue),\n  settings: z.optional(\n    z.strictObject({ decisionMs: z.optional(z.nullable(DecisionMs)), bank: z.optional(z.nullable(BankSettingSchema)) }),\n  ),\n});\n\nexport const CreateRoomResponseSchema = z.object({\n  room: RoomCode,\n  token: SeatToken,\n  name: z.string(),\n  notice: z.optional(z.object({ code: NoticeCodeSchema, message: z.string() })),\n  game: GamePinSchema,\n  expiresAt: Time,\n});\n\nexport const RoomInfoSchema = z.object({\n  game: GamePinSchema,\n  phase: RoomPhaseSchema,\n  seatsOpen: z.int().check(z.nonnegative()),\n  spectatorsAllowed: z.boolean(),\n});\n\nexport const HostedGamesSchema = z.object({\n  protocol: Version,\n  protocols: z.array(Version),\n  games: z.array(GameId),\n});\n"],"mappings":"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"}

package/dist/protocol/types.d.ts

@@ -0,0 +1,279 @@
+import type { Json, Outcome, SeatClock, SeatId, ViewBeat } from '@joystyk/contracts';
+import type { ActionId, RoomCode } from './schemas.js';
+/** The game build and versions a match runs on; fixed for the match (section 6.1). */
+export type GamePin = {
+    /** Manifest id, e.g. "hearts". */
+    readonly id: string;
+    /** Build of the game package, e.g. "1.4.0". Clients load this build. */
+    readonly build: string;
+    readonly rulesVersion: number;
+    readonly saveVersion: number;
+};
+export type RoomPhase = 'lobby' | 'playing' | 'finished' | 'closed';
+/** A seat as every viewer sees it. No token or token hash ever leaves the server. */
+export type PublicSeat = {
+    readonly id: SeatId;
+    readonly name: string;
+    readonly controller: 'human' | 'ai';
+    readonly aiLevel: string | null;
+    /** True when a player holds the seat's token (also while the AI covers for them). */
+    readonly claimed: boolean;
+    readonly ready: boolean;
+};
+/** A time bank with increment (the manifest's `clock.mode: 'bank'`). */
+export type BankSetting = {
+    readonly initialMs: number;
+    readonly incrementMs: number;
+};
+/** Live facts that never change the revision: connections and running clocks. */
+export type Presence = {
+    /** Indexed by seat: whether a player is connected to it. */
+    readonly connected: readonly boolean[];
+    /**
+     * Decision clocks as the contract's `SeatClock`: per-move clocks for pending seats, or
+     * every seat's bank. A clock that isn't `running` (paused room, playback hold, a seat
+     * that isn't pending) doesn't count down.
+     */
+    readonly clocks: readonly SeatClock[];
+    /**
+     * True when no player is connected, so the table is paused (section 3.5 rule 8, D-58):
+     * its clocks keep the time they had and say so with `paused`.
+     */
+    readonly paused: boolean;
+    readonly spectators: number;
+};
+/** What an offer proposes: a new match after this one, or ending this one early with no result (D-61). */
+export type OfferKind = 'rematch' | 'end';
+/**
+ * A rematch or end-match offer as every viewer sees it (section 3.10). Any seated player may
+ * make one. A declined or withdrawn offer stays until the next one, so the table can say so.
+ */
+export type RoomOffer = {
+    /** Names the offer in answers: the revision that opened it. */
+    readonly id: number;
+    readonly kind: OfferKind;
+    /** The seat that offered. */
+    readonly by: SeatId;
+    readonly status: 'open' | 'declined' | 'withdrawn';
+    /** Seats that have accepted: the proposer, each player who said yes and, for a rematch, every computer seat. */
+    readonly accepted: readonly SeatId[];
+    /** The seat that declined, if one did. */
+    readonly declinedBy: SeatId | null;
+    /** An end offer: when the match ends if nobody declines, in server time. Null for a rematch. */
+    readonly endsAt: number | null;
+};
+/** Room settings the host may change in the lobby. */
+export type RoomSettings = {
+    /** Per-move clock; null when off or when a bank runs. */
+    readonly decisionMs: number | null;
+    readonly bank: BankSetting | null;
+    readonly aiLevel: string | null;
+};
+/** A room control: lobby and match actions that belong to the room, not the game. */
+export type RoomControl = {
+    readonly kind: 'ready';
+    readonly ready: boolean;
+} | {
+    readonly kind: 'settings';
+    /** A per-move clock (turns the bank off), or null for none. */
+    readonly decisionMs?: number | null;
+    /** A time bank (turns the per-move clock off), or null for none. */
+    readonly bank?: BankSetting | null;
+    readonly config?: Json;
+    readonly aiLevel?: string;
+} | {
+    readonly kind: 'fill-with-ai';
+    readonly seat: SeatId;
+} | {
+    readonly kind: 'remove-seat';
+    readonly seat: SeatId;
+} | {
+    readonly kind: 'start';
+}
+/** Offer a rematch (after the match) or to end the match early (during it); D-61. */
+ | {
+    readonly kind: 'offer';
+    readonly offer: OfferKind;
+}
+/** Answer the open offer, named by its id: the other players accept or decline, the proposer withdraws. */
+ | {
+    readonly kind: 'accept' | 'decline' | 'withdraw';
+    readonly offer: number;
+} | {
+    readonly kind: 'leave-seat';
+}
+/** The contract's `resign` input, offered by the platform at any time during a match. */
+ | {
+    readonly kind: 'resign';
+};
+export type JoinMessage = {
+    readonly v: number;
+    readonly t: 'join';
+    readonly room: RoomCode;
+    readonly game: string;
+    readonly name: string;
+    readonly token?: string;
+    readonly watch?: boolean;
+    readonly build: string;
+};
+export type ActMessage = {
+    readonly v: number;
+    readonly t: 'act';
+    readonly id: ActionId;
+    /** The revision the client last saw; staleness is judged per seat (section 3.8). */
+    readonly rev: number;
+    readonly command: Json;
+};
+export type ControlMessage = {
+    readonly v: number;
+    readonly t: 'control';
+    readonly id: ActionId;
+    readonly rev: number;
+    readonly control: RoomControl;
+};
+export type ResyncMessage = {
+    readonly v: number;
+    readonly t: 'resync';
+};
+export type ClientMessage = JoinMessage | ActMessage | ControlMessage | ResyncMessage;
+export type WelcomeMessage = {
+    readonly v: number;
+    readonly t: 'welcome';
+    readonly room: RoomCode;
+    /** Null for a spectator. */
+    readonly seat: SeatId | null;
+    /** Present only when the server issued a new seat token to this connection. */
+    readonly token?: string;
+    readonly host: SeatId | null;
+    readonly game: GamePin;
+    readonly protocol: number;
+};
+export type SnapshotMessage = {
+    readonly v: number;
+    readonly t: 'snapshot';
+    readonly epoch: number;
+    readonly revision: number;
+    readonly phase: RoomPhase;
+    /** The viewer's own seat (null for a spectator). It can change when a match starts. */
+    readonly seat: SeatId | null;
+    readonly seats: readonly PublicSeat[];
+    readonly host: SeatId | null;
+    readonly game: GamePin;
+    readonly settings: RoomSettings;
+    /** `viewFor(state, seat)`; null in a lobby before the first match. */
+    readonly view: Json | null;
+    /** The match's recent events, each through `eventFor(event, seat)`. */
+    readonly history: readonly Json[];
+    readonly pending: readonly SeatId[];
+    readonly outcome: Outcome | null;
+    readonly presentation: Json | null;
+    /** The latest rematch or end-match offer; absent from servers older than D-61. */
+    readonly offer?: RoomOffer | null;
+    readonly presence: Presence;
+    readonly serverTime: number;
+};
+export type UpdateMessage = {
+    readonly v: number;
+    readonly t: 'update';
+    readonly epoch: number;
+    readonly revision: number;
+    /** The revision this update follows. A client whose revision differs sends `resync`. */
+    readonly from: number;
+    readonly phase: RoomPhase;
+    readonly host: SeatId | null;
+    /** Present when a seat changed. */
+    readonly seats?: readonly PublicSeat[];
+    /** Present when the settings changed. */
+    readonly settings?: RoomSettings;
+    readonly beats: readonly ViewBeat<Json, Json>[];
+    readonly view: Json | null;
+    readonly pending: readonly SeatId[];
+    readonly outcome: Outcome | null;
+    /** Present when a job delivered new presentation data. */
+    readonly presentation?: Json | null;
+    /** The latest rematch or end-match offer; absent from servers older than D-61. */
+    readonly offer?: RoomOffer | null;
+    readonly presence: Presence;
+    readonly serverTime: number;
+};
+export type ReceiptResult = {
+    readonly status: 'accepted';
+    readonly revision: number;
+} | {
+    readonly status: 'rejected';
+    readonly code: string;
+    readonly message: string;
+    readonly revision: number;
+};
+export type ReceiptMessage = {
+    readonly v: number;
+    readonly t: 'receipt';
+    readonly id: ActionId;
+    readonly result: ReceiptResult;
+};
+export type PresenceMessage = {
+    readonly v: number;
+    readonly t: 'presence';
+    readonly presence: Presence;
+    readonly serverTime: number;
+};
+/** `name-replaced`: the display name was refused, so the seat got a generated one; the message says why. */
+export type NoticeCode = 'bad-message' | 'too-fast' | 'no-such-room' | 'room-full' | 'protocol-unsupported' | 'server-busy' | 'name-replaced';
+export type NoticeMessage = {
+    readonly v: number;
+    readonly t: 'notice';
+    readonly code: NoticeCode;
+    readonly message: string;
+};
+export type ReplacedMessage = {
+    readonly v: number;
+    readonly t: 'replaced';
+};
+export type ClosingMessage = {
+    readonly v: number;
+    readonly t: 'closing';
+    readonly reason: 'restart' | 'expired' | 'closed';
+    readonly retryAfterMs: number | null;
+};
+export type ServerMessage = WelcomeMessage | SnapshotMessage | UpdateMessage | ReceiptMessage | PresenceMessage | NoticeMessage | ReplacedMessage | ClosingMessage;
+export type CreateRoomRequest = {
+    readonly game: string;
+    readonly name: string;
+    readonly config?: Json;
+    readonly settings?: {
+        readonly decisionMs?: number | null;
+        readonly bank?: BankSetting | null;
+    };
+};
+export type CreateRoomResponse = {
+    readonly room: RoomCode;
+    /** The creator's seat token for seat 0. Store it before opening the socket. */
+    readonly token: string;
+    /** The name seat 0 holds: the one asked for, normalized, or a generated one. */
+    readonly name: string;
+    /** Present when the name asked for was refused: `code` is `name-replaced`, `message` says why. */
+    readonly notice?: {
+        readonly code: NoticeCode;
+        readonly message: string;
+    };
+    readonly game: GamePin;
+    readonly expiresAt: number;
+};
+export type RoomInfo = {
+    readonly game: GamePin;
+    readonly phase: RoomPhase;
+    readonly seatsOpen: number;
+    readonly spectatorsAllowed: boolean;
+};
+/**
+ * `GET /api/rooms/games`: what this room server hosts, so a launcher offers "Online with
+ * friends" only for games it can open (section 5.4).
+ */
+export type HostedGames = {
+    /** The server's current wire protocol version. */
+    readonly protocol: number;
+    /** Every protocol version it accepts. */
+    readonly protocols: readonly number[];
+    /** Ids of the games it opens new rooms for. */
+    readonly games: readonly string[];
+};

package/dist/protocol/types.js

@@ -0,0 +1 @@
+export {};