@klbsjpolp/realtime-core 0.1.0

package/dist/code.d.ts

@@ -0,0 +1,5 @@
+export declare const ROOM_CODE_ALPHABET = "ABCDEFGHJKMNPQRSTVWXYZ";
+export declare const ROOM_CODE_LENGTH = 3;
+export declare const normalizeRoomCode: (value: string) => string;
+export declare const isValidRoomCode: (value: string) => boolean;
+//# sourceMappingURL=code.d.ts.map

package/dist/code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../src/code.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,2BAA2B,CAAC;AAC3D,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,eAAO,MAAM,iBAAiB,GAAI,OAAO,MAAM,KAAG,MAKnB,CAAC;AAEhC,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,KAAG,OAI/C,CAAC"}

package/dist/code.js

@@ -0,0 +1,11 @@
+export const ROOM_CODE_ALPHABET = 'ABCDEFGHJKMNPQRSTVWXYZ';
+export const ROOM_CODE_LENGTH = 3;
+export const normalizeRoomCode = (value) => value
+    .trim()
+    .toUpperCase()
+    .replace(/[\s-]+/g, '')
+    .slice(0, ROOM_CODE_LENGTH);
+export const isValidRoomCode = (value) => {
+    const normalized = normalizeRoomCode(value);
+    return normalized.length === ROOM_CODE_LENGTH && [...normalized].every((char) => ROOM_CODE_ALPHABET.includes(char));
+};

package/dist/http/index.d.ts

@@ -0,0 +1,23 @@
+export interface RoomSession {
+    expiresAt: string;
+    hostSeatIndex: number;
+    roomCode: string;
+    seatCapacity: number;
+    seatIndex: number;
+    seatToken: string;
+    wsUrl: string;
+}
+export interface CreateRoomRequest {
+    playerName?: string;
+    /** Which game this room hosts. The server treats it as an opaque routing key. */
+    gameId?: string;
+    /** Opaque per-game configuration. The server stores it without interpreting it. */
+    gameConfig?: unknown;
+}
+export interface JoinRoomRequest {
+    playerName?: string;
+    roomCode: string;
+}
+export type CreateRoomResponse = RoomSession;
+export type JoinRoomResponse = RoomSession;
+//# sourceMappingURL=index.d.ts.map

package/dist/http/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,kBAAkB,GAAG,WAAW,CAAC;AAC7C,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC"}

package/dist/http/index.js

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export * from './code.js';
+export * from './version.js';
+export * from './playerName.js';
+export * from './shuffle.js';
+export * from './http/index.js';
+export * from './room/index.js';
+export * from './protocol/index.js';
+export * from './schemas/http.js';
+export * from './schemas/websocket.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export * from './code.js';
+export * from './version.js';
+export * from './playerName.js';
+export * from './shuffle.js';
+export * from './http/index.js';
+export * from './room/index.js';
+export * from './protocol/index.js';
+export * from './schemas/http.js';
+export * from './schemas/websocket.js';

package/dist/playerName.d.ts

@@ -0,0 +1,5 @@
+export declare const MAX_PLAYER_NAME_LENGTH = 10;
+export declare const getDefaultPlayerName: (seatIndex: number) => string;
+export declare const normalizePlayerName: (value: string | null | undefined) => string | undefined;
+export declare const resolvePlayerName: (value: string | null | undefined, seatIndex: number) => string;
+//# sourceMappingURL=playerName.d.ts.map

package/dist/playerName.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playerName.d.ts","sourceRoot":"","sources":["../src/playerName.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,eAAO,MAAM,oBAAoB,GAAI,WAAW,MAAM,KAAG,MAAmC,CAAC;AAE7F,eAAO,MAAM,mBAAmB,GAAI,OAAO,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,MAAM,GAAG,SAQ/E,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,OAAO,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,WAAW,MAAM,KAAG,MACzB,CAAC"}

package/dist/playerName.js

@@ -0,0 +1,10 @@
+export const MAX_PLAYER_NAME_LENGTH = 10;
+export const getDefaultPlayerName = (seatIndex) => `Joueur ${seatIndex + 1}`;
+export const normalizePlayerName = (value) => {
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    const trimmedValue = value.trim().slice(0, MAX_PLAYER_NAME_LENGTH);
+    return trimmedValue.length > 0 ? trimmedValue : undefined;
+};
+export const resolvePlayerName = (value, seatIndex) => normalizePlayerName(value) ?? getDefaultPlayerName(seatIndex);

package/dist/protocol/index.d.ts

@@ -0,0 +1,48 @@
+import type { RelayKind } from '../schemas/websocket.js';
+import type { RoomStatus, RoomSummary } from '../room/index.js';
+/** An opaque message forwarded from another seat. `payload` is never inspected. */
+export interface RelayedServerMessage {
+    type: 'relayed';
+    fromSeat: number;
+    kind: RelayKind;
+    payload: unknown;
+}
+/** The abstract turn pointer changed. */
+export interface TurnServerMessage {
+    type: 'turn';
+    currentSeatIndex: number;
+}
+/**
+ * The host pressed start. The server has shuffled the seating and set the
+ * first turn; the host now builds the real game state from this.
+ */
+export interface GameStartedServerMessage {
+    type: 'gameStarted';
+    activeSeatIndices: number[];
+    currentSeatIndex: number;
+    gameConfig?: unknown;
+}
+/**
+ * Sent to the host seat on reconnect: the opaque full-state blob it last pushed,
+ * or `null` if none was stored yet.
+ */
+export interface SnapshotRestoreServerMessage {
+    type: 'snapshotRestore';
+    payload: unknown;
+}
+export interface PresenceServerMessage {
+    type: 'presence';
+    room: RoomSummary;
+}
+export interface RoomClosedServerMessage {
+    type: 'roomClosed';
+    roomCode: string;
+    status: RoomStatus;
+}
+export interface ActionRejectedServerMessage {
+    type: 'actionRejected';
+    code: 'forbidden' | 'invalid_action' | 'invalid_state' | 'not_authenticated' | 'not_your_turn';
+    reason: string;
+}
+export type ServerMessage = RelayedServerMessage | TurnServerMessage | GameStartedServerMessage | SnapshotRestoreServerMessage | PresenceServerMessage | RoomClosedServerMessage | ActionRejectedServerMessage;
+//# sourceMappingURL=index.d.ts.map

package/dist/protocol/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/protocol/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAMhE,mFAAmF;AACnF,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,yCAAyC;AACzC,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,aAAa,CAAC;IACpB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,WAAW,GAAG,gBAAgB,GAAG,eAAe,GAAG,mBAAmB,GAAG,eAAe,CAAC;IAC/F,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,aAAa,GACrB,oBAAoB,GACpB,iBAAiB,GACjB,wBAAwB,GACxB,4BAA4B,GAC5B,qBAAqB,GACrB,uBAAuB,GACvB,2BAA2B,CAAC"}

package/dist/protocol/index.js

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

package/dist/room/index.d.ts

@@ -0,0 +1,25 @@
+export type RoomStatus = 'WAITING' | 'ACTIVE' | 'FINISHED';
+export type LobbyReadyState = 'never-ready' | 'ready' | 'unready';
+export interface LobbySeatInfo {
+    seatIndex: number;
+    readyState: LobbyReadyState;
+    displayName: string | null;
+}
+export interface DisconnectedSeatInfo {
+    seatIndex: number;
+    disconnectedAt: string;
+}
+export interface RoomSummary {
+    connectedSeats: number[];
+    /** Whose turn it is, as an abstract seat index. `null` while WAITING/FINISHED. */
+    currentSeatIndex: number | null;
+    disconnectedSeats: DisconnectedSeatInfo[];
+    expiresAt: string;
+    hostSeatIndex: number;
+    lobbySeats: LobbySeatInfo[];
+    roomCode: string;
+    seatCapacity: number;
+    status: RoomStatus;
+    version: number;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/room/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/room/index.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE3D,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,OAAO,GAAG,SAAS,CAAC;AAElE,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,eAAe,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,kFAAkF;IAClF,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,iBAAiB,EAAE,oBAAoB,EAAE,CAAC;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/room/index.js

@@ -0,0 +1,4 @@
+// Game-agnostic room, lobby and presence shapes. Nothing here knows about a
+// specific game — only seats, lobby readiness, connectivity and the abstract
+// turn pointer (currentSeatIndex).
+export {};

package/dist/schemas/http.d.ts

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+export declare const roomCodeSchema: z.ZodString;
+export declare const playerNameSchema: z.ZodString;
+export declare const gameIdSchema: z.ZodString;
+export declare const createRoomRequestSchema: z.ZodObject<{
+    playerName: z.ZodOptional<z.ZodString>;
+    gameId: z.ZodOptional<z.ZodString>;
+    gameConfig: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+export declare const joinRoomRequestSchema: z.ZodObject<{
+    playerName: z.ZodOptional<z.ZodString>;
+    roomCode: z.ZodString;
+}, z.core.$strip>;
+export declare const roomSessionSchema: z.ZodObject<{
+    expiresAt: z.ZodString;
+    hostSeatIndex: z.ZodNumber;
+    roomCode: z.ZodString;
+    seatCapacity: z.ZodNumber;
+    seatIndex: z.ZodNumber;
+    seatToken: z.ZodString;
+    wsUrl: z.ZodString;
+}, z.core.$strip>;
+//# sourceMappingURL=http.d.ts.map

package/dist/schemas/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/schemas/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,cAAc,aAAiD,CAAC;AAC7E,eAAO,MAAM,gBAAgB,aAAgD,CAAC;AAC9E,eAAO,MAAM,YAAY,aAAmC,CAAC;AAE7D,eAAO,MAAM,uBAAuB;;;;iBAKlC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;iBAGhC,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;iBAQ5B,CAAC"}

package/dist/schemas/http.js

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+import { ROOM_CODE_LENGTH } from '../code.js';
+import { MAX_PLAYER_NAME_LENGTH } from '../playerName.js';
+export const roomCodeSchema = z.string().trim().min(1).max(ROOM_CODE_LENGTH);
+export const playerNameSchema = z.string().trim().max(MAX_PLAYER_NAME_LENGTH);
+export const gameIdSchema = z.string().trim().min(1).max(64);
+export const createRoomRequestSchema = z.object({
+    playerName: playerNameSchema.optional(),
+    gameId: gameIdSchema.optional(),
+    // Opaque to the server; the host client validates it against the game.
+    gameConfig: z.unknown().optional(),
+});
+export const joinRoomRequestSchema = z.object({
+    playerName: playerNameSchema.optional(),
+    roomCode: roomCodeSchema,
+});
+export const roomSessionSchema = z.object({
+    expiresAt: z.string().datetime(),
+    hostSeatIndex: z.number().int().min(0).max(3),
+    roomCode: z.string().length(ROOM_CODE_LENGTH),
+    seatCapacity: z.number().int().min(2).max(4),
+    seatIndex: z.number().int().min(0).max(3),
+    seatToken: z.string().min(1),
+    wsUrl: z.string().url(),
+});

package/dist/schemas/websocket.d.ts

@@ -0,0 +1,99 @@
+import { z } from 'zod';
+export declare const relayKindSchema: z.ZodEnum<{
+    move: "move";
+    event: "event";
+    view: "view";
+}>;
+export type RelayKind = z.infer<typeof relayKindSchema>;
+export declare const relayClientMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"relay">;
+    kind: z.ZodEnum<{
+        move: "move";
+        event: "event";
+        view: "view";
+    }>;
+    payload: z.ZodUnknown;
+    toSeats: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+}, z.core.$strip>;
+export declare const setTurnClientMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"setTurn">;
+    currentSeatIndex: z.ZodNumber;
+}, z.core.$strip>;
+export declare const snapshotClientMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"snapshot">;
+    payload: z.ZodUnknown;
+}, z.core.$strip>;
+export declare const endGameClientMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"endGame">;
+    winnerSeatIndex: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const authClientMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"auth">;
+    protocolVersion: z.ZodOptional<z.ZodNumber>;
+    roomCode: z.ZodString;
+    seatIndex: z.ZodNumber;
+    seatToken: z.ZodString;
+}, z.core.$strip>;
+export declare const startGameClientMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"startGame">;
+    clientVersion: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const pingClientMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"ping">;
+}, z.core.$strip>;
+export declare const setReadyClientMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"setReady">;
+    playerName: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const setUnreadyClientMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"setUnready">;
+}, z.core.$strip>;
+export declare const kickSeatClientMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"kickSeat">;
+    targetSeatIndex: z.ZodNumber;
+}, z.core.$strip>;
+export declare const leaveLobbyClientMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"leaveLobby">;
+}, z.core.$strip>;
+export declare const clientMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"auth">;
+    protocolVersion: z.ZodOptional<z.ZodNumber>;
+    roomCode: z.ZodString;
+    seatIndex: z.ZodNumber;
+    seatToken: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"relay">;
+    kind: z.ZodEnum<{
+        move: "move";
+        event: "event";
+        view: "view";
+    }>;
+    payload: z.ZodUnknown;
+    toSeats: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"setTurn">;
+    currentSeatIndex: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"snapshot">;
+    payload: z.ZodUnknown;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"endGame">;
+    winnerSeatIndex: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"startGame">;
+    clientVersion: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"ping">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"setReady">;
+    playerName: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"setUnready">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"kickSeat">;
+    targetSeatIndex: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"leaveLobby">;
+}, z.core.$strip>], "type">;
+export type ClientMessage = z.infer<typeof clientMessageSchema>;
+//# sourceMappingURL=websocket.d.ts.map

package/dist/schemas/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../src/schemas/websocket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,eAAO,MAAM,eAAe;;;;EAAoC,CAAC;AAEjE,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,wBAAwB;;;;;;;;;iBAMnC,CAAC;AAKH,eAAO,MAAM,0BAA0B;;;iBAGrC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;iBAItC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;iBAGrC,CAAC;AAKH,eAAO,MAAM,uBAAuB;;;;;;iBAMlC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;iBAGvC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;iBAElC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;iBAGtC,CAAC;AAEH,eAAO,MAAM,6BAA6B;;iBAExC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;iBAGtC,CAAC;AAEH,eAAO,MAAM,6BAA6B;;iBAExC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAY9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/schemas/websocket.js

@@ -0,0 +1,78 @@
+import { z } from 'zod';
+import { MAX_PLAYER_NAME_LENGTH } from '../playerName.js';
+const MAX_SEAT_INDEX = 3;
+// ---------------------------------------------------------------------------
+// Relay envelope
+// ---------------------------------------------------------------------------
+// The server never inspects `payload`. It only enforces:
+//   - `move`: may only be sent by the seat whose turn it is (currentSeatIndex)
+//   - `view`: host-only (the authoritative client pushing a redacted view)
+//   - `event`: any authenticated seat (chat, resync requests, …)
+export const relayKindSchema = z.enum(['move', 'event', 'view']);
+export const relayClientMessageSchema = z.object({
+    type: z.literal('relay'),
+    kind: relayKindSchema,
+    payload: z.unknown(),
+    // Target seats. Omitted = every other authenticated seat in the room.
+    toSeats: z.array(z.number().int().min(0).max(MAX_SEAT_INDEX)).optional(),
+});
+// ---------------------------------------------------------------------------
+// Host-only control messages
+// ---------------------------------------------------------------------------
+export const setTurnClientMessageSchema = z.object({
+    type: z.literal('setTurn'),
+    currentSeatIndex: z.number().int().min(0).max(MAX_SEAT_INDEX),
+});
+export const snapshotClientMessageSchema = z.object({
+    type: z.literal('snapshot'),
+    // Opaque full-state blob the server stores for host reconnection only.
+    payload: z.unknown(),
+});
+export const endGameClientMessageSchema = z.object({
+    type: z.literal('endGame'),
+    winnerSeatIndex: z.number().int().min(0).max(MAX_SEAT_INDEX).nullable(),
+});
+// ---------------------------------------------------------------------------
+// Lobby + session messages (game-agnostic)
+// ---------------------------------------------------------------------------
+export const authClientMessageSchema = z.object({
+    type: z.literal('auth'),
+    protocolVersion: z.number().int().min(0).optional(),
+    roomCode: z.string().min(1),
+    seatIndex: z.number().int().min(0).max(MAX_SEAT_INDEX),
+    seatToken: z.string().min(1),
+});
+export const startGameClientMessageSchema = z.object({
+    type: z.literal('startGame'),
+    clientVersion: z.number().int().min(0).optional(),
+});
+export const pingClientMessageSchema = z.object({
+    type: z.literal('ping'),
+});
+export const setReadyClientMessageSchema = z.object({
+    type: z.literal('setReady'),
+    playerName: z.string().trim().max(MAX_PLAYER_NAME_LENGTH).optional(),
+});
+export const setUnreadyClientMessageSchema = z.object({
+    type: z.literal('setUnready'),
+});
+export const kickSeatClientMessageSchema = z.object({
+    type: z.literal('kickSeat'),
+    targetSeatIndex: z.number().int().min(0).max(MAX_SEAT_INDEX),
+});
+export const leaveLobbyClientMessageSchema = z.object({
+    type: z.literal('leaveLobby'),
+});
+export const clientMessageSchema = z.discriminatedUnion('type', [
+    authClientMessageSchema,
+    relayClientMessageSchema,
+    setTurnClientMessageSchema,
+    snapshotClientMessageSchema,
+    endGameClientMessageSchema,
+    startGameClientMessageSchema,
+    pingClientMessageSchema,
+    setReadyClientMessageSchema,
+    setUnreadyClientMessageSchema,
+    kickSeatClientMessageSchema,
+    leaveLobbyClientMessageSchema,
+]);

package/dist/shuffle.d.ts

@@ -0,0 +1,3 @@
+export declare const shuffle: <T>(array: readonly T[]) => T[];
+export declare const shuffleInPlace: <T>(array: T[]) => void;
+//# sourceMappingURL=shuffle.d.ts.map

package/dist/shuffle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shuffle.d.ts","sourceRoot":"","sources":["../src/shuffle.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,GAAI,CAAC,EAAE,OAAO,SAAS,CAAC,EAAE,KAAG,CAAC,EAIjD,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,CAAC,EAAE,OAAO,CAAC,EAAE,KAAG,IAK9C,CAAC"}

package/dist/shuffle.js

@@ -0,0 +1,11 @@
+export const shuffle = (array) => {
+    const result = [...array];
+    shuffleInPlace(result);
+    return result;
+};
+export const shuffleInPlace = (array) => {
+    for (let i = array.length - 1; i > 0; i--) {
+        const j = Math.floor(Math.random() * (i + 1));
+        [array[i], array[j]] = [array[j], array[i]];
+    }
+};

package/dist/version.d.ts

@@ -0,0 +1,5 @@
+export declare const PROTOCOL_VERSION = 2;
+export declare const MIN_SUPPORTED_PROTOCOL_VERSION = 2;
+export declare const ASSUMED_LEGACY_PROTOCOL_VERSION = 1;
+export declare const isProtocolVersionSupported: (clientVersion: number | undefined) => boolean;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAIhD,eAAO,MAAM,+BAA+B,IAAI,CAAC;AAEjD,eAAO,MAAM,0BAA0B,GAAI,eAAe,MAAM,GAAG,SAAS,KAAG,OACO,CAAC"}

package/dist/version.js

@@ -0,0 +1,16 @@
+// Bumped when the wire protocol changes in a backwards-incompatible way (new
+// required message types, renamed fields, changed semantics). The server reads
+// the client's reported version during auth and rejects mismatched clients
+// with HTTP 426. Keep MIN_SUPPORTED_PROTOCOL_VERSION in sync with the oldest
+// client build the server still accepts; pair bumps with
+// PWA_MINIMUM_SUPPORTED_VERSION.
+//
+// v2 introduces the host-authoritative relay protocol (relay/setTurn/snapshot/
+// endGame messages) and removes the server-authoritative `action`/`snapshot`
+// flow. It is intentionally incompatible with v1 clients.
+export const PROTOCOL_VERSION = 2;
+export const MIN_SUPPORTED_PROTOCOL_VERSION = 2;
+// Clients that omit `protocolVersion` predate the field entirely (v1). Since the
+// relay protocol is a hard break, absent-field clients are rejected.
+export const ASSUMED_LEGACY_PROTOCOL_VERSION = 1;
+export const isProtocolVersionSupported = (clientVersion) => (clientVersion ?? ASSUMED_LEGACY_PROTOCOL_VERSION) >= MIN_SUPPORTED_PROTOCOL_VERSION;

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@klbsjpolp/realtime-core",
+  "version": "0.1.0",
+  "description": "Game-agnostic realtime relay protocol and room model shared by the realtime-api server and game clients.",
+  "license": "GPL-3.0-only",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/klbsjpolp/realtime-infra.git",
+    "directory": "packages/realtime-core"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^4.1.7",
+    "vite": "^8.0.14",
+    "vitest": "^4.1.7"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "lint": "eslint src tests --ext ts --report-unused-disable-directives --max-warnings 0",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage --coverage.reporter=lcovonly --coverage.reporter=text-summary",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  }
+}