@inachess/sdk 0.1.0

package/README.md

@@ -0,0 +1,55 @@
+# @inachess/sdk
+
+JavaScript/TypeScript client SDK for the **inachess-engine** WebSocket protocol.
+Framework-agnostic — runs in the browser and in Node. It owns the wire protocol
+(join, moves, latency pings, reconnect) so your app never hand-rolls socket
+messages.
+
+## Install
+
+```bash
+npm install @inachess/sdk
+```
+
+## Usage
+
+```ts
+import { EngineClient } from "@inachess/sdk";
+
+const client = new EngineClient({ url: "wss://engine.example.com/ws" });
+
+client.on("gameState", (s) => render(s.fen, s.turn, s.you));
+client.on("move", (m) => render(m.fen, m.turn));
+client.on("gameOver", (g) => console.log(g.result, g.reason));
+client.on("error", (e) => console.warn(e.message));
+
+// Join with a single-use ticket minted by the platform.
+client.connect({ ticket });
+
+client.move("e2e4"); // UCI everywhere
+client.resign();
+```
+
+The client auto-answers the engine's latency pings and auto-reconnects with the
+engine's rotating reconnect token after a drop. Connect modes:
+
+```ts
+client.connect({ ticket });           // first join
+client.connect({ reconnect: token }); // resume after a drop
+client.connect({ spectate: token });  // read-only viewer
+```
+
+Helpers for rendering are exported too: `parseBoard(fen)`, `fenTurn(fen)`,
+`isPromotion(board, from, to)`.
+
+## Develop
+
+```bash
+npm install
+npm run build   # tsup → dist (ESM + CJS + .d.ts)
+npm test        # node --test
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,203 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  EngineClient: () => EngineClient,
+  FILES: () => FILES,
+  fenTurn: () => fenTurn,
+  isPromotion: () => isPromotion,
+  parseBoard: () => parseBoard
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client.ts
+var OPEN = 1;
+var EngineClient = class {
+  url;
+  WS;
+  autoReconnect;
+  baseDelay;
+  maxDelay;
+  ws = null;
+  mode = null;
+  closedByUser = false;
+  attempts = 0;
+  timer = null;
+  _reconnectToken = null;
+  _seat = null;
+  listeners = /* @__PURE__ */ new Map();
+  constructor(opts) {
+    this.url = opts.url;
+    const WS = opts.WebSocket ?? globalThis.WebSocket;
+    if (!WS) throw new Error("no WebSocket implementation available; pass options.WebSocket");
+    this.WS = WS;
+    this.autoReconnect = opts.autoReconnect ?? true;
+    this.baseDelay = opts.reconnectDelayMs ?? 500;
+    this.maxDelay = opts.maxReconnectDelayMs ?? 8e3;
+  }
+  /** The current rotating reconnect token, or null (spectators never get one). */
+  get reconnectToken() {
+    return this._reconnectToken;
+  }
+  /** The recipient's seat: "white" | "black" | "spectator" | null (before join). */
+  get seat() {
+    return this._seat;
+  }
+  on(event, handler) {
+    let set = this.listeners.get(event);
+    if (!set) {
+      set = /* @__PURE__ */ new Set();
+      this.listeners.set(event, set);
+    }
+    set.add(handler);
+    return this;
+  }
+  off(event, handler) {
+    this.listeners.get(event)?.delete(handler);
+    return this;
+  }
+  /** Open the socket with the given credentials. */
+  connect(mode) {
+    this.closedByUser = false;
+    this.mode = mode;
+    this.attempts = 0;
+    this.dial();
+  }
+  /** Submit a move (UCI). No-op if the socket is not open. */
+  move(uci) {
+    this.send({ type: "move", uci });
+  }
+  /** Resign the game. */
+  resign() {
+    this.send({ type: "resign" });
+  }
+  /** Close the socket and stop any reconnection. */
+  close() {
+    this.closedByUser = true;
+    if (this.timer) clearTimeout(this.timer);
+    this.ws?.close(1e3, "");
+    this.ws = null;
+  }
+  dial() {
+    if (!this.mode) return;
+    const ws = new this.WS(this.url + "?" + queryFor(this.mode));
+    this.ws = ws;
+    ws.onopen = () => {
+      this.attempts = 0;
+      this.emit("open", void 0);
+    };
+    ws.onmessage = (ev) => this.handleMessage(ev.data);
+    ws.onclose = (ev) => this.handleClose(ev.code, ev.reason);
+    ws.onerror = () => {
+    };
+  }
+  handleMessage(data) {
+    let msg;
+    try {
+      msg = JSON.parse(typeof data === "string" ? data : String(data));
+    } catch {
+      return;
+    }
+    this.emit("message", msg);
+    switch (msg.type) {
+      case "game_state":
+        if (msg.reconnectToken) this._reconnectToken = msg.reconnectToken;
+        this._seat = msg.you;
+        this.emit("gameState", msg);
+        break;
+      case "move":
+        this.emit("move", msg);
+        break;
+      case "game_over":
+        this.emit("gameOver", msg);
+        break;
+      case "error":
+        this.emit("error", msg);
+        break;
+      case "ping":
+        this.send({ type: "pong", t: msg.t });
+        break;
+    }
+  }
+  handleClose(code, reason) {
+    this.ws = null;
+    const willReconnect = !this.closedByUser && this.autoReconnect && this._reconnectToken !== null;
+    this.emit("close", { code, reason, willReconnect });
+    if (willReconnect) this.scheduleReconnect();
+  }
+  scheduleReconnect() {
+    this.attempts += 1;
+    const delay = Math.min(this.baseDelay * 2 ** (this.attempts - 1), this.maxDelay);
+    this.emit("reconnecting", { attempt: this.attempts });
+    this.timer = setTimeout(() => {
+      if (this.closedByUser || this._reconnectToken === null) return;
+      this.mode = { reconnect: this._reconnectToken };
+      this.dial();
+    }, delay);
+  }
+  send(obj) {
+    if (this.ws && this.ws.readyState === OPEN) this.ws.send(JSON.stringify(obj));
+  }
+  emit(event, payload) {
+    this.listeners.get(event)?.forEach((h) => h(payload));
+  }
+};
+function queryFor(mode) {
+  if ("ticket" in mode) return "ticket=" + encodeURIComponent(mode.ticket);
+  if ("reconnect" in mode) return "reconnect=" + encodeURIComponent(mode.reconnect);
+  return "spectate=" + encodeURIComponent(mode.spectate);
+}
+
+// src/fen.ts
+var FILES = ["a", "b", "c", "d", "e", "f", "g", "h"];
+function parseBoard(fen) {
+  const rows = fen.split(" ")[0].split("/");
+  const out = {};
+  for (let i = 0; i < 8; i++) {
+    const rank = 8 - i;
+    let file = 0;
+    for (const ch of rows[i] ?? "") {
+      if (ch >= "1" && ch <= "8") {
+        file += Number(ch);
+      } else {
+        out[FILES[file] + rank] = ch;
+        file += 1;
+      }
+    }
+  }
+  return out;
+}
+function fenTurn(fen) {
+  return fen.split(" ")[1] === "b" ? "black" : "white";
+}
+function isPromotion(board, from, to) {
+  const p = board[from];
+  return p === "P" && to[1] === "8" || p === "p" && to[1] === "1";
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  EngineClient,
+  FILES,
+  fenTurn,
+  isPromotion,
+  parseBoard
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/fen.ts"],"sourcesContent":["export { EngineClient } from \"./client.js\";\nexport type {\n  ConnectMode,\n  EngineClientOptions,\n  EngineClientEvents,\n} from \"./client.js\";\nexport type {\n  Color,\n  Seat,\n  GameStatus,\n  GameResult,\n  ServerMessage,\n  ClientMessage,\n  GameStateMessage,\n  MoveMessage,\n  GameOverMessage,\n  ErrorMessage,\n  PingMessage,\n} from \"./protocol.js\";\nexport { parseBoard, fenTurn, isPromotion, FILES } from \"./fen.js\";\nexport type { PieceChar } from \"./fen.js\";\n","import type {\n  ServerMessage,\n  GameStateMessage,\n  MoveMessage,\n  GameOverMessage,\n  ErrorMessage,\n  Seat,\n} from \"./protocol.js\";\n\n/** How to authenticate the socket to a room. */\nexport type ConnectMode =\n  | { ticket: string }\n  | { reconnect: string }\n  | { spectate: string };\n\n/** Events emitted by EngineClient. */\nexport interface EngineClientEvents {\n  open: void;\n  close: { code: number; reason: string; willReconnect: boolean };\n  reconnecting: { attempt: number };\n  gameState: GameStateMessage;\n  move: MoveMessage;\n  gameOver: GameOverMessage;\n  error: ErrorMessage;\n  message: ServerMessage;\n}\n\nexport interface EngineClientOptions {\n  /** Base socket URL, e.g. \"wss://engine.example.com/ws\". */\n  url: string;\n  /** WebSocket implementation; defaults to the global (browser). Pass `ws` in Node. */\n  WebSocket?: unknown;\n  /** Auto-reconnect with the rotating token after an unexpected drop (default true). */\n  autoReconnect?: boolean;\n  reconnectDelayMs?: number;\n  maxReconnectDelayMs?: number;\n}\n\ntype Listener<T> = (payload: T) => void;\ntype WSCtor = new (url: string) => WebSocketLike;\ninterface WebSocketLike {\n  readyState: number;\n  send(data: string): void;\n  close(code?: number, reason?: string): void;\n  onopen: ((ev: unknown) => void) | null;\n  onmessage: ((ev: { data: unknown }) => void) | null;\n  onclose: ((ev: { code: number; reason: string }) => void) | null;\n  onerror: ((ev: unknown) => void) | null;\n}\n\nconst OPEN = 1;\n\n/**\n * EngineClient wraps one game socket to the inachess-engine. It handles the wire\n * protocol end to end: parses server messages, auto-answers latency pings, tracks\n * the rotating reconnect token, and (by default) transparently reconnects after a\n * drop. Framework-agnostic — the platform routes a player to the play view with a\n * ticket, then hands that ticket to this client.\n *\n * ```ts\n * const c = new EngineClient({ url: \"wss://engine/ws\" });\n * c.on(\"gameState\", s => render(s));\n * c.on(\"move\", m => render(m));\n * c.connect({ ticket });\n * c.move(\"e2e4\");\n * ```\n */\nexport class EngineClient {\n  private readonly url: string;\n  private readonly WS: WSCtor;\n  private readonly autoReconnect: boolean;\n  private readonly baseDelay: number;\n  private readonly maxDelay: number;\n\n  private ws: WebSocketLike | null = null;\n  private mode: ConnectMode | null = null;\n  private closedByUser = false;\n  private attempts = 0;\n  private timer: ReturnType<typeof setTimeout> | null = null;\n\n  private _reconnectToken: string | null = null;\n  private _seat: Seat | null = null;\n  private listeners = new Map<keyof EngineClientEvents, Set<Listener<unknown>>>();\n\n  constructor(opts: EngineClientOptions) {\n    this.url = opts.url;\n    const WS = (opts.WebSocket ?? (globalThis as { WebSocket?: unknown }).WebSocket) as WSCtor | undefined;\n    if (!WS) throw new Error(\"no WebSocket implementation available; pass options.WebSocket\");\n    this.WS = WS;\n    this.autoReconnect = opts.autoReconnect ?? true;\n    this.baseDelay = opts.reconnectDelayMs ?? 500;\n    this.maxDelay = opts.maxReconnectDelayMs ?? 8000;\n  }\n\n  /** The current rotating reconnect token, or null (spectators never get one). */\n  get reconnectToken(): string | null {\n    return this._reconnectToken;\n  }\n\n  /** The recipient's seat: \"white\" | \"black\" | \"spectator\" | null (before join). */\n  get seat(): Seat | null {\n    return this._seat;\n  }\n\n  on<K extends keyof EngineClientEvents>(event: K, handler: Listener<EngineClientEvents[K]>): this {\n    let set = this.listeners.get(event);\n    if (!set) {\n      set = new Set();\n      this.listeners.set(event, set);\n    }\n    set.add(handler as Listener<unknown>);\n    return this;\n  }\n\n  off<K extends keyof EngineClientEvents>(event: K, handler: Listener<EngineClientEvents[K]>): this {\n    this.listeners.get(event)?.delete(handler as Listener<unknown>);\n    return this;\n  }\n\n  /** Open the socket with the given credentials. */\n  connect(mode: ConnectMode): void {\n    this.closedByUser = false;\n    this.mode = mode;\n    this.attempts = 0;\n    this.dial();\n  }\n\n  /** Submit a move (UCI). No-op if the socket is not open. */\n  move(uci: string): void {\n    this.send({ type: \"move\", uci });\n  }\n\n  /** Resign the game. */\n  resign(): void {\n    this.send({ type: \"resign\" });\n  }\n\n  /** Close the socket and stop any reconnection. */\n  close(): void {\n    this.closedByUser = true;\n    if (this.timer) clearTimeout(this.timer);\n    this.ws?.close(1000, \"\");\n    this.ws = null;\n  }\n\n  private dial(): void {\n    if (!this.mode) return;\n    const ws = new this.WS(this.url + \"?\" + queryFor(this.mode));\n    this.ws = ws;\n    ws.onopen = () => {\n      this.attempts = 0;\n      this.emit(\"open\", undefined);\n    };\n    ws.onmessage = (ev) => this.handleMessage(ev.data);\n    ws.onclose = (ev) => this.handleClose(ev.code, ev.reason);\n    ws.onerror = () => {}; // a close event always follows\n  }\n\n  private handleMessage(data: unknown): void {\n    let msg: ServerMessage;\n    try {\n      msg = JSON.parse(typeof data === \"string\" ? data : String(data)) as ServerMessage;\n    } catch {\n      return;\n    }\n    this.emit(\"message\", msg);\n    switch (msg.type) {\n      case \"game_state\":\n        if (msg.reconnectToken) this._reconnectToken = msg.reconnectToken;\n        this._seat = msg.you;\n        this.emit(\"gameState\", msg);\n        break;\n      case \"move\":\n        this.emit(\"move\", msg);\n        break;\n      case \"game_over\":\n        this.emit(\"gameOver\", msg);\n        break;\n      case \"error\":\n        this.emit(\"error\", msg);\n        break;\n      case \"ping\":\n        this.send({ type: \"pong\", t: msg.t });\n        break;\n    }\n  }\n\n  private handleClose(code: number, reason: string): void {\n    this.ws = null;\n    const willReconnect = !this.closedByUser && this.autoReconnect && this._reconnectToken !== null;\n    this.emit(\"close\", { code, reason, willReconnect });\n    if (willReconnect) this.scheduleReconnect();\n  }\n\n  private scheduleReconnect(): void {\n    this.attempts += 1;\n    const delay = Math.min(this.baseDelay * 2 ** (this.attempts - 1), this.maxDelay);\n    this.emit(\"reconnecting\", { attempt: this.attempts });\n    this.timer = setTimeout(() => {\n      if (this.closedByUser || this._reconnectToken === null) return;\n      this.mode = { reconnect: this._reconnectToken };\n      this.dial();\n    }, delay);\n  }\n\n  private send(obj: unknown): void {\n    if (this.ws && this.ws.readyState === OPEN) this.ws.send(JSON.stringify(obj));\n  }\n\n  private emit<K extends keyof EngineClientEvents>(event: K, payload: EngineClientEvents[K]): void {\n    this.listeners.get(event)?.forEach((h) => h(payload));\n  }\n}\n\nfunction queryFor(mode: ConnectMode): string {\n  if (\"ticket\" in mode) return \"ticket=\" + encodeURIComponent(mode.ticket);\n  if (\"reconnect\" in mode) return \"reconnect=\" + encodeURIComponent(mode.reconnect);\n  return \"spectate=\" + encodeURIComponent(mode.spectate);\n}\n","import type { Color } from \"./protocol.js\";\n\nexport type PieceChar = \"K\" | \"Q\" | \"R\" | \"B\" | \"N\" | \"P\" | \"k\" | \"q\" | \"r\" | \"b\" | \"n\" | \"p\";\n\nexport const FILES = [\"a\", \"b\", \"c\", \"d\", \"e\", \"f\", \"g\", \"h\"] as const;\n\n/** parseBoard turns a FEN into a map of square (\"e4\") → piece char. */\nexport function parseBoard(fen: string): Record<string, PieceChar> {\n  const rows = fen.split(\" \")[0].split(\"/\");\n  const out: Record<string, PieceChar> = {};\n  for (let i = 0; i < 8; i++) {\n    const rank = 8 - i;\n    let file = 0;\n    for (const ch of rows[i] ?? \"\") {\n      if (ch >= \"1\" && ch <= \"8\") {\n        file += Number(ch);\n      } else {\n        out[FILES[file] + rank] = ch as PieceChar;\n        file += 1;\n      }\n    }\n  }\n  return out;\n}\n\n/** fenTurn returns the side to move encoded in a FEN. */\nexport function fenTurn(fen: string): Color {\n  return fen.split(\" \")[1] === \"b\" ? \"black\" : \"white\";\n}\n\n/** isPromotion reports whether moving the piece on `from` to `to` is a pawn\n * reaching the last rank — the UI appends a promotion piece (default queen). */\nexport function isPromotion(board: Record<string, PieceChar>, from: string, to: string): boolean {\n  const p = board[from];\n  return (p === \"P\" && to[1] === \"8\") || (p === \"p\" && to[1] === \"1\");\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,156 @@
+type Color = "white" | "black";
+type Seat = Color | "spectator";
+type GameStatus = "active" | "finished";
+type GameResult = "white_win" | "black_win" | "draw";
+/** Full snapshot sent on join / rejoin / spectate. */
+interface GameStateMessage {
+    type: "game_state";
+    fen: string;
+    turn: Color;
+    you: Seat;
+    moves: string[];
+    status: GameStatus;
+    whiteMs: number;
+    blackMs: number;
+    /** Rotating single-use reconnect token (absent for spectators). */
+    reconnectToken?: string;
+}
+/** Broadcast after a validated move. */
+interface MoveMessage {
+    type: "move";
+    uci: string;
+    by: Color;
+    fen: string;
+    turn: Color;
+    whiteMs: number;
+    blackMs: number;
+}
+/** Broadcast when the game ends. */
+interface GameOverMessage {
+    type: "game_over";
+    result: GameResult;
+    reason: string;
+}
+/** Sent to a single client on a rejected command. */
+interface ErrorMessage {
+    type: "error";
+    message: string;
+}
+/** Server latency probe; the client must echo `t` back in a pong. */
+interface PingMessage {
+    type: "ping";
+    t: number;
+}
+type ServerMessage = GameStateMessage | MoveMessage | GameOverMessage | ErrorMessage | PingMessage;
+interface MoveIntent {
+    type: "move";
+    uci: string;
+}
+interface ResignIntent {
+    type: "resign";
+}
+interface PongIntent {
+    type: "pong";
+    t: number;
+}
+type ClientMessage = MoveIntent | ResignIntent | PongIntent;
+
+/** How to authenticate the socket to a room. */
+type ConnectMode = {
+    ticket: string;
+} | {
+    reconnect: string;
+} | {
+    spectate: string;
+};
+/** Events emitted by EngineClient. */
+interface EngineClientEvents {
+    open: void;
+    close: {
+        code: number;
+        reason: string;
+        willReconnect: boolean;
+    };
+    reconnecting: {
+        attempt: number;
+    };
+    gameState: GameStateMessage;
+    move: MoveMessage;
+    gameOver: GameOverMessage;
+    error: ErrorMessage;
+    message: ServerMessage;
+}
+interface EngineClientOptions {
+    /** Base socket URL, e.g. "wss://engine.example.com/ws". */
+    url: string;
+    /** WebSocket implementation; defaults to the global (browser). Pass `ws` in Node. */
+    WebSocket?: unknown;
+    /** Auto-reconnect with the rotating token after an unexpected drop (default true). */
+    autoReconnect?: boolean;
+    reconnectDelayMs?: number;
+    maxReconnectDelayMs?: number;
+}
+type Listener<T> = (payload: T) => void;
+/**
+ * EngineClient wraps one game socket to the inachess-engine. It handles the wire
+ * protocol end to end: parses server messages, auto-answers latency pings, tracks
+ * the rotating reconnect token, and (by default) transparently reconnects after a
+ * drop. Framework-agnostic — the platform routes a player to the play view with a
+ * ticket, then hands that ticket to this client.
+ *
+ * ```ts
+ * const c = new EngineClient({ url: "wss://engine/ws" });
+ * c.on("gameState", s => render(s));
+ * c.on("move", m => render(m));
+ * c.connect({ ticket });
+ * c.move("e2e4");
+ * ```
+ */
+declare class EngineClient {
+    private readonly url;
+    private readonly WS;
+    private readonly autoReconnect;
+    private readonly baseDelay;
+    private readonly maxDelay;
+    private ws;
+    private mode;
+    private closedByUser;
+    private attempts;
+    private timer;
+    private _reconnectToken;
+    private _seat;
+    private listeners;
+    constructor(opts: EngineClientOptions);
+    /** The current rotating reconnect token, or null (spectators never get one). */
+    get reconnectToken(): string | null;
+    /** The recipient's seat: "white" | "black" | "spectator" | null (before join). */
+    get seat(): Seat | null;
+    on<K extends keyof EngineClientEvents>(event: K, handler: Listener<EngineClientEvents[K]>): this;
+    off<K extends keyof EngineClientEvents>(event: K, handler: Listener<EngineClientEvents[K]>): this;
+    /** Open the socket with the given credentials. */
+    connect(mode: ConnectMode): void;
+    /** Submit a move (UCI). No-op if the socket is not open. */
+    move(uci: string): void;
+    /** Resign the game. */
+    resign(): void;
+    /** Close the socket and stop any reconnection. */
+    close(): void;
+    private dial;
+    private handleMessage;
+    private handleClose;
+    private scheduleReconnect;
+    private send;
+    private emit;
+}
+
+type PieceChar = "K" | "Q" | "R" | "B" | "N" | "P" | "k" | "q" | "r" | "b" | "n" | "p";
+declare const FILES: readonly ["a", "b", "c", "d", "e", "f", "g", "h"];
+/** parseBoard turns a FEN into a map of square ("e4") → piece char. */
+declare function parseBoard(fen: string): Record<string, PieceChar>;
+/** fenTurn returns the side to move encoded in a FEN. */
+declare function fenTurn(fen: string): Color;
+/** isPromotion reports whether moving the piece on `from` to `to` is a pawn
+ * reaching the last rank — the UI appends a promotion piece (default queen). */
+declare function isPromotion(board: Record<string, PieceChar>, from: string, to: string): boolean;
+
+export { type ClientMessage, type Color, type ConnectMode, EngineClient, type EngineClientEvents, type EngineClientOptions, type ErrorMessage, FILES, type GameOverMessage, type GameResult, type GameStateMessage, type GameStatus, type MoveMessage, type PieceChar, type PingMessage, type Seat, type ServerMessage, fenTurn, isPromotion, parseBoard };

package/dist/index.d.ts

@@ -0,0 +1,156 @@
+type Color = "white" | "black";
+type Seat = Color | "spectator";
+type GameStatus = "active" | "finished";
+type GameResult = "white_win" | "black_win" | "draw";
+/** Full snapshot sent on join / rejoin / spectate. */
+interface GameStateMessage {
+    type: "game_state";
+    fen: string;
+    turn: Color;
+    you: Seat;
+    moves: string[];
+    status: GameStatus;
+    whiteMs: number;
+    blackMs: number;
+    /** Rotating single-use reconnect token (absent for spectators). */
+    reconnectToken?: string;
+}
+/** Broadcast after a validated move. */
+interface MoveMessage {
+    type: "move";
+    uci: string;
+    by: Color;
+    fen: string;
+    turn: Color;
+    whiteMs: number;
+    blackMs: number;
+}
+/** Broadcast when the game ends. */
+interface GameOverMessage {
+    type: "game_over";
+    result: GameResult;
+    reason: string;
+}
+/** Sent to a single client on a rejected command. */
+interface ErrorMessage {
+    type: "error";
+    message: string;
+}
+/** Server latency probe; the client must echo `t` back in a pong. */
+interface PingMessage {
+    type: "ping";
+    t: number;
+}
+type ServerMessage = GameStateMessage | MoveMessage | GameOverMessage | ErrorMessage | PingMessage;
+interface MoveIntent {
+    type: "move";
+    uci: string;
+}
+interface ResignIntent {
+    type: "resign";
+}
+interface PongIntent {
+    type: "pong";
+    t: number;
+}
+type ClientMessage = MoveIntent | ResignIntent | PongIntent;
+
+/** How to authenticate the socket to a room. */
+type ConnectMode = {
+    ticket: string;
+} | {
+    reconnect: string;
+} | {
+    spectate: string;
+};
+/** Events emitted by EngineClient. */
+interface EngineClientEvents {
+    open: void;
+    close: {
+        code: number;
+        reason: string;
+        willReconnect: boolean;
+    };
+    reconnecting: {
+        attempt: number;
+    };
+    gameState: GameStateMessage;
+    move: MoveMessage;
+    gameOver: GameOverMessage;
+    error: ErrorMessage;
+    message: ServerMessage;
+}
+interface EngineClientOptions {
+    /** Base socket URL, e.g. "wss://engine.example.com/ws". */
+    url: string;
+    /** WebSocket implementation; defaults to the global (browser). Pass `ws` in Node. */
+    WebSocket?: unknown;
+    /** Auto-reconnect with the rotating token after an unexpected drop (default true). */
+    autoReconnect?: boolean;
+    reconnectDelayMs?: number;
+    maxReconnectDelayMs?: number;
+}
+type Listener<T> = (payload: T) => void;
+/**
+ * EngineClient wraps one game socket to the inachess-engine. It handles the wire
+ * protocol end to end: parses server messages, auto-answers latency pings, tracks
+ * the rotating reconnect token, and (by default) transparently reconnects after a
+ * drop. Framework-agnostic — the platform routes a player to the play view with a
+ * ticket, then hands that ticket to this client.
+ *
+ * ```ts
+ * const c = new EngineClient({ url: "wss://engine/ws" });
+ * c.on("gameState", s => render(s));
+ * c.on("move", m => render(m));
+ * c.connect({ ticket });
+ * c.move("e2e4");
+ * ```
+ */
+declare class EngineClient {
+    private readonly url;
+    private readonly WS;
+    private readonly autoReconnect;
+    private readonly baseDelay;
+    private readonly maxDelay;
+    private ws;
+    private mode;
+    private closedByUser;
+    private attempts;
+    private timer;
+    private _reconnectToken;
+    private _seat;
+    private listeners;
+    constructor(opts: EngineClientOptions);
+    /** The current rotating reconnect token, or null (spectators never get one). */
+    get reconnectToken(): string | null;
+    /** The recipient's seat: "white" | "black" | "spectator" | null (before join). */
+    get seat(): Seat | null;
+    on<K extends keyof EngineClientEvents>(event: K, handler: Listener<EngineClientEvents[K]>): this;
+    off<K extends keyof EngineClientEvents>(event: K, handler: Listener<EngineClientEvents[K]>): this;
+    /** Open the socket with the given credentials. */
+    connect(mode: ConnectMode): void;
+    /** Submit a move (UCI). No-op if the socket is not open. */
+    move(uci: string): void;
+    /** Resign the game. */
+    resign(): void;
+    /** Close the socket and stop any reconnection. */
+    close(): void;
+    private dial;
+    private handleMessage;
+    private handleClose;
+    private scheduleReconnect;
+    private send;
+    private emit;
+}
+
+type PieceChar = "K" | "Q" | "R" | "B" | "N" | "P" | "k" | "q" | "r" | "b" | "n" | "p";
+declare const FILES: readonly ["a", "b", "c", "d", "e", "f", "g", "h"];
+/** parseBoard turns a FEN into a map of square ("e4") → piece char. */
+declare function parseBoard(fen: string): Record<string, PieceChar>;
+/** fenTurn returns the side to move encoded in a FEN. */
+declare function fenTurn(fen: string): Color;
+/** isPromotion reports whether moving the piece on `from` to `to` is a pawn
+ * reaching the last rank — the UI appends a promotion piece (default queen). */
+declare function isPromotion(board: Record<string, PieceChar>, from: string, to: string): boolean;
+
+export { type ClientMessage, type Color, type ConnectMode, EngineClient, type EngineClientEvents, type EngineClientOptions, type ErrorMessage, FILES, type GameOverMessage, type GameResult, type GameStateMessage, type GameStatus, type MoveMessage, type PieceChar, type PingMessage, type Seat, type ServerMessage, fenTurn, isPromotion, parseBoard };

package/dist/index.js

@@ -0,0 +1,172 @@
+// src/client.ts
+var OPEN = 1;
+var EngineClient = class {
+  url;
+  WS;
+  autoReconnect;
+  baseDelay;
+  maxDelay;
+  ws = null;
+  mode = null;
+  closedByUser = false;
+  attempts = 0;
+  timer = null;
+  _reconnectToken = null;
+  _seat = null;
+  listeners = /* @__PURE__ */ new Map();
+  constructor(opts) {
+    this.url = opts.url;
+    const WS = opts.WebSocket ?? globalThis.WebSocket;
+    if (!WS) throw new Error("no WebSocket implementation available; pass options.WebSocket");
+    this.WS = WS;
+    this.autoReconnect = opts.autoReconnect ?? true;
+    this.baseDelay = opts.reconnectDelayMs ?? 500;
+    this.maxDelay = opts.maxReconnectDelayMs ?? 8e3;
+  }
+  /** The current rotating reconnect token, or null (spectators never get one). */
+  get reconnectToken() {
+    return this._reconnectToken;
+  }
+  /** The recipient's seat: "white" | "black" | "spectator" | null (before join). */
+  get seat() {
+    return this._seat;
+  }
+  on(event, handler) {
+    let set = this.listeners.get(event);
+    if (!set) {
+      set = /* @__PURE__ */ new Set();
+      this.listeners.set(event, set);
+    }
+    set.add(handler);
+    return this;
+  }
+  off(event, handler) {
+    this.listeners.get(event)?.delete(handler);
+    return this;
+  }
+  /** Open the socket with the given credentials. */
+  connect(mode) {
+    this.closedByUser = false;
+    this.mode = mode;
+    this.attempts = 0;
+    this.dial();
+  }
+  /** Submit a move (UCI). No-op if the socket is not open. */
+  move(uci) {
+    this.send({ type: "move", uci });
+  }
+  /** Resign the game. */
+  resign() {
+    this.send({ type: "resign" });
+  }
+  /** Close the socket and stop any reconnection. */
+  close() {
+    this.closedByUser = true;
+    if (this.timer) clearTimeout(this.timer);
+    this.ws?.close(1e3, "");
+    this.ws = null;
+  }
+  dial() {
+    if (!this.mode) return;
+    const ws = new this.WS(this.url + "?" + queryFor(this.mode));
+    this.ws = ws;
+    ws.onopen = () => {
+      this.attempts = 0;
+      this.emit("open", void 0);
+    };
+    ws.onmessage = (ev) => this.handleMessage(ev.data);
+    ws.onclose = (ev) => this.handleClose(ev.code, ev.reason);
+    ws.onerror = () => {
+    };
+  }
+  handleMessage(data) {
+    let msg;
+    try {
+      msg = JSON.parse(typeof data === "string" ? data : String(data));
+    } catch {
+      return;
+    }
+    this.emit("message", msg);
+    switch (msg.type) {
+      case "game_state":
+        if (msg.reconnectToken) this._reconnectToken = msg.reconnectToken;
+        this._seat = msg.you;
+        this.emit("gameState", msg);
+        break;
+      case "move":
+        this.emit("move", msg);
+        break;
+      case "game_over":
+        this.emit("gameOver", msg);
+        break;
+      case "error":
+        this.emit("error", msg);
+        break;
+      case "ping":
+        this.send({ type: "pong", t: msg.t });
+        break;
+    }
+  }
+  handleClose(code, reason) {
+    this.ws = null;
+    const willReconnect = !this.closedByUser && this.autoReconnect && this._reconnectToken !== null;
+    this.emit("close", { code, reason, willReconnect });
+    if (willReconnect) this.scheduleReconnect();
+  }
+  scheduleReconnect() {
+    this.attempts += 1;
+    const delay = Math.min(this.baseDelay * 2 ** (this.attempts - 1), this.maxDelay);
+    this.emit("reconnecting", { attempt: this.attempts });
+    this.timer = setTimeout(() => {
+      if (this.closedByUser || this._reconnectToken === null) return;
+      this.mode = { reconnect: this._reconnectToken };
+      this.dial();
+    }, delay);
+  }
+  send(obj) {
+    if (this.ws && this.ws.readyState === OPEN) this.ws.send(JSON.stringify(obj));
+  }
+  emit(event, payload) {
+    this.listeners.get(event)?.forEach((h) => h(payload));
+  }
+};
+function queryFor(mode) {
+  if ("ticket" in mode) return "ticket=" + encodeURIComponent(mode.ticket);
+  if ("reconnect" in mode) return "reconnect=" + encodeURIComponent(mode.reconnect);
+  return "spectate=" + encodeURIComponent(mode.spectate);
+}
+
+// src/fen.ts
+var FILES = ["a", "b", "c", "d", "e", "f", "g", "h"];
+function parseBoard(fen) {
+  const rows = fen.split(" ")[0].split("/");
+  const out = {};
+  for (let i = 0; i < 8; i++) {
+    const rank = 8 - i;
+    let file = 0;
+    for (const ch of rows[i] ?? "") {
+      if (ch >= "1" && ch <= "8") {
+        file += Number(ch);
+      } else {
+        out[FILES[file] + rank] = ch;
+        file += 1;
+      }
+    }
+  }
+  return out;
+}
+function fenTurn(fen) {
+  return fen.split(" ")[1] === "b" ? "black" : "white";
+}
+function isPromotion(board, from, to) {
+  const p = board[from];
+  return p === "P" && to[1] === "8" || p === "p" && to[1] === "1";
+}
+export {
+  EngineClient,
+  FILES,
+  fenTurn,
+  isPromotion,
+  parseBoard
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../src/fen.ts"],"sourcesContent":["import type {\n  ServerMessage,\n  GameStateMessage,\n  MoveMessage,\n  GameOverMessage,\n  ErrorMessage,\n  Seat,\n} from \"./protocol.js\";\n\n/** How to authenticate the socket to a room. */\nexport type ConnectMode =\n  | { ticket: string }\n  | { reconnect: string }\n  | { spectate: string };\n\n/** Events emitted by EngineClient. */\nexport interface EngineClientEvents {\n  open: void;\n  close: { code: number; reason: string; willReconnect: boolean };\n  reconnecting: { attempt: number };\n  gameState: GameStateMessage;\n  move: MoveMessage;\n  gameOver: GameOverMessage;\n  error: ErrorMessage;\n  message: ServerMessage;\n}\n\nexport interface EngineClientOptions {\n  /** Base socket URL, e.g. \"wss://engine.example.com/ws\". */\n  url: string;\n  /** WebSocket implementation; defaults to the global (browser). Pass `ws` in Node. */\n  WebSocket?: unknown;\n  /** Auto-reconnect with the rotating token after an unexpected drop (default true). */\n  autoReconnect?: boolean;\n  reconnectDelayMs?: number;\n  maxReconnectDelayMs?: number;\n}\n\ntype Listener<T> = (payload: T) => void;\ntype WSCtor = new (url: string) => WebSocketLike;\ninterface WebSocketLike {\n  readyState: number;\n  send(data: string): void;\n  close(code?: number, reason?: string): void;\n  onopen: ((ev: unknown) => void) | null;\n  onmessage: ((ev: { data: unknown }) => void) | null;\n  onclose: ((ev: { code: number; reason: string }) => void) | null;\n  onerror: ((ev: unknown) => void) | null;\n}\n\nconst OPEN = 1;\n\n/**\n * EngineClient wraps one game socket to the inachess-engine. It handles the wire\n * protocol end to end: parses server messages, auto-answers latency pings, tracks\n * the rotating reconnect token, and (by default) transparently reconnects after a\n * drop. Framework-agnostic — the platform routes a player to the play view with a\n * ticket, then hands that ticket to this client.\n *\n * ```ts\n * const c = new EngineClient({ url: \"wss://engine/ws\" });\n * c.on(\"gameState\", s => render(s));\n * c.on(\"move\", m => render(m));\n * c.connect({ ticket });\n * c.move(\"e2e4\");\n * ```\n */\nexport class EngineClient {\n  private readonly url: string;\n  private readonly WS: WSCtor;\n  private readonly autoReconnect: boolean;\n  private readonly baseDelay: number;\n  private readonly maxDelay: number;\n\n  private ws: WebSocketLike | null = null;\n  private mode: ConnectMode | null = null;\n  private closedByUser = false;\n  private attempts = 0;\n  private timer: ReturnType<typeof setTimeout> | null = null;\n\n  private _reconnectToken: string | null = null;\n  private _seat: Seat | null = null;\n  private listeners = new Map<keyof EngineClientEvents, Set<Listener<unknown>>>();\n\n  constructor(opts: EngineClientOptions) {\n    this.url = opts.url;\n    const WS = (opts.WebSocket ?? (globalThis as { WebSocket?: unknown }).WebSocket) as WSCtor | undefined;\n    if (!WS) throw new Error(\"no WebSocket implementation available; pass options.WebSocket\");\n    this.WS = WS;\n    this.autoReconnect = opts.autoReconnect ?? true;\n    this.baseDelay = opts.reconnectDelayMs ?? 500;\n    this.maxDelay = opts.maxReconnectDelayMs ?? 8000;\n  }\n\n  /** The current rotating reconnect token, or null (spectators never get one). */\n  get reconnectToken(): string | null {\n    return this._reconnectToken;\n  }\n\n  /** The recipient's seat: \"white\" | \"black\" | \"spectator\" | null (before join). */\n  get seat(): Seat | null {\n    return this._seat;\n  }\n\n  on<K extends keyof EngineClientEvents>(event: K, handler: Listener<EngineClientEvents[K]>): this {\n    let set = this.listeners.get(event);\n    if (!set) {\n      set = new Set();\n      this.listeners.set(event, set);\n    }\n    set.add(handler as Listener<unknown>);\n    return this;\n  }\n\n  off<K extends keyof EngineClientEvents>(event: K, handler: Listener<EngineClientEvents[K]>): this {\n    this.listeners.get(event)?.delete(handler as Listener<unknown>);\n    return this;\n  }\n\n  /** Open the socket with the given credentials. */\n  connect(mode: ConnectMode): void {\n    this.closedByUser = false;\n    this.mode = mode;\n    this.attempts = 0;\n    this.dial();\n  }\n\n  /** Submit a move (UCI). No-op if the socket is not open. */\n  move(uci: string): void {\n    this.send({ type: \"move\", uci });\n  }\n\n  /** Resign the game. */\n  resign(): void {\n    this.send({ type: \"resign\" });\n  }\n\n  /** Close the socket and stop any reconnection. */\n  close(): void {\n    this.closedByUser = true;\n    if (this.timer) clearTimeout(this.timer);\n    this.ws?.close(1000, \"\");\n    this.ws = null;\n  }\n\n  private dial(): void {\n    if (!this.mode) return;\n    const ws = new this.WS(this.url + \"?\" + queryFor(this.mode));\n    this.ws = ws;\n    ws.onopen = () => {\n      this.attempts = 0;\n      this.emit(\"open\", undefined);\n    };\n    ws.onmessage = (ev) => this.handleMessage(ev.data);\n    ws.onclose = (ev) => this.handleClose(ev.code, ev.reason);\n    ws.onerror = () => {}; // a close event always follows\n  }\n\n  private handleMessage(data: unknown): void {\n    let msg: ServerMessage;\n    try {\n      msg = JSON.parse(typeof data === \"string\" ? data : String(data)) as ServerMessage;\n    } catch {\n      return;\n    }\n    this.emit(\"message\", msg);\n    switch (msg.type) {\n      case \"game_state\":\n        if (msg.reconnectToken) this._reconnectToken = msg.reconnectToken;\n        this._seat = msg.you;\n        this.emit(\"gameState\", msg);\n        break;\n      case \"move\":\n        this.emit(\"move\", msg);\n        break;\n      case \"game_over\":\n        this.emit(\"gameOver\", msg);\n        break;\n      case \"error\":\n        this.emit(\"error\", msg);\n        break;\n      case \"ping\":\n        this.send({ type: \"pong\", t: msg.t });\n        break;\n    }\n  }\n\n  private handleClose(code: number, reason: string): void {\n    this.ws = null;\n    const willReconnect = !this.closedByUser && this.autoReconnect && this._reconnectToken !== null;\n    this.emit(\"close\", { code, reason, willReconnect });\n    if (willReconnect) this.scheduleReconnect();\n  }\n\n  private scheduleReconnect(): void {\n    this.attempts += 1;\n    const delay = Math.min(this.baseDelay * 2 ** (this.attempts - 1), this.maxDelay);\n    this.emit(\"reconnecting\", { attempt: this.attempts });\n    this.timer = setTimeout(() => {\n      if (this.closedByUser || this._reconnectToken === null) return;\n      this.mode = { reconnect: this._reconnectToken };\n      this.dial();\n    }, delay);\n  }\n\n  private send(obj: unknown): void {\n    if (this.ws && this.ws.readyState === OPEN) this.ws.send(JSON.stringify(obj));\n  }\n\n  private emit<K extends keyof EngineClientEvents>(event: K, payload: EngineClientEvents[K]): void {\n    this.listeners.get(event)?.forEach((h) => h(payload));\n  }\n}\n\nfunction queryFor(mode: ConnectMode): string {\n  if (\"ticket\" in mode) return \"ticket=\" + encodeURIComponent(mode.ticket);\n  if (\"reconnect\" in mode) return \"reconnect=\" + encodeURIComponent(mode.reconnect);\n  return \"spectate=\" + encodeURIComponent(mode.spectate);\n}\n","import type { Color } from \"./protocol.js\";\n\nexport type PieceChar = \"K\" | \"Q\" | \"R\" | \"B\" | \"N\" | \"P\" | \"k\" | \"q\" | \"r\" | \"b\" | \"n\" | \"p\";\n\nexport const FILES = [\"a\", \"b\", \"c\", \"d\", \"e\", \"f\", \"g\", \"h\"] as const;\n\n/** parseBoard turns a FEN into a map of square (\"e4\") → piece char. */\nexport function parseBoard(fen: string): Record<string, PieceChar> {\n  const rows = fen.split(\" \")[0].split(\"/\");\n  const out: Record<string, PieceChar> = {};\n  for (let i = 0; i < 8; i++) {\n    const rank = 8 - i;\n    let file = 0;\n    for (const ch of rows[i] ?? \"\") {\n      if (ch >= \"1\" && ch <= \"8\") {\n        file += Number(ch);\n      } else {\n        out[FILES[file] + rank] = ch as PieceChar;\n        file += 1;\n      }\n    }\n  }\n  return out;\n}\n\n/** fenTurn returns the side to move encoded in a FEN. */\nexport function fenTurn(fen: string): Color {\n  return fen.split(\" \")[1] === \"b\" ? \"black\" : \"white\";\n}\n\n/** isPromotion reports whether moving the piece on `from` to `to` is a pawn\n * reaching the last rank — the UI appends a promotion piece (default queen). */\nexport function isPromotion(board: Record<string, PieceChar>, from: string, to: string): boolean {\n  const p = board[from];\n  return (p === \"P\" && to[1] === \"8\") || (p === \"p\" && to[1] === \"1\");\n}\n"],"mappings":";AAkDA,IAAM,OAAO;AAiBN,IAAM,eAAN,MAAmB;AAAA,EACP;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAET,KAA2B;AAAA,EAC3B,OAA2B;AAAA,EAC3B,eAAe;AAAA,EACf,WAAW;AAAA,EACX,QAA8C;AAAA,EAE9C,kBAAiC;AAAA,EACjC,QAAqB;AAAA,EACrB,YAAY,oBAAI,IAAsD;AAAA,EAE9E,YAAY,MAA2B;AACrC,SAAK,MAAM,KAAK;AAChB,UAAM,KAAM,KAAK,aAAc,WAAuC;AACtE,QAAI,CAAC,GAAI,OAAM,IAAI,MAAM,+DAA+D;AACxF,SAAK,KAAK;AACV,SAAK,gBAAgB,KAAK,iBAAiB;AAC3C,SAAK,YAAY,KAAK,oBAAoB;AAC1C,SAAK,WAAW,KAAK,uBAAuB;AAAA,EAC9C;AAAA;AAAA,EAGA,IAAI,iBAAgC;AAClC,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,OAAoB;AACtB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,GAAuC,OAAU,SAAgD;AAC/F,QAAI,MAAM,KAAK,UAAU,IAAI,KAAK;AAClC,QAAI,CAAC,KAAK;AACR,YAAM,oBAAI,IAAI;AACd,WAAK,UAAU,IAAI,OAAO,GAAG;AAAA,IAC/B;AACA,QAAI,IAAI,OAA4B;AACpC,WAAO;AAAA,EACT;AAAA,EAEA,IAAwC,OAAU,SAAgD;AAChG,SAAK,UAAU,IAAI,KAAK,GAAG,OAAO,OAA4B;AAC9D,WAAO;AAAA,EACT;AAAA;AAAA,EAGA,QAAQ,MAAyB;AAC/B,SAAK,eAAe;AACpB,SAAK,OAAO;AACZ,SAAK,WAAW;AAChB,SAAK,KAAK;AAAA,EACZ;AAAA;AAAA,EAGA,KAAK,KAAmB;AACtB,SAAK,KAAK,EAAE,MAAM,QAAQ,IAAI,CAAC;AAAA,EACjC;AAAA;AAAA,EAGA,SAAe;AACb,SAAK,KAAK,EAAE,MAAM,SAAS,CAAC;AAAA,EAC9B;AAAA;AAAA,EAGA,QAAc;AACZ,SAAK,eAAe;AACpB,QAAI,KAAK,MAAO,cAAa,KAAK,KAAK;AACvC,SAAK,IAAI,MAAM,KAAM,EAAE;AACvB,SAAK,KAAK;AAAA,EACZ;AAAA,EAEQ,OAAa;AACnB,QAAI,CAAC,KAAK,KAAM;AAChB,UAAM,KAAK,IAAI,KAAK,GAAG,KAAK,MAAM,MAAM,SAAS,KAAK,IAAI,CAAC;AAC3D,SAAK,KAAK;AACV,OAAG,SAAS,MAAM;AAChB,WAAK,WAAW;AAChB,WAAK,KAAK,QAAQ,MAAS;AAAA,IAC7B;AACA,OAAG,YAAY,CAAC,OAAO,KAAK,cAAc,GAAG,IAAI;AACjD,OAAG,UAAU,CAAC,OAAO,KAAK,YAAY,GAAG,MAAM,GAAG,MAAM;AACxD,OAAG,UAAU,MAAM;AAAA,IAAC;AAAA,EACtB;AAAA,EAEQ,cAAc,MAAqB;AACzC,QAAI;AACJ,QAAI;AACF,YAAM,KAAK,MAAM,OAAO,SAAS,WAAW,OAAO,OAAO,IAAI,CAAC;AAAA,IACjE,QAAQ;AACN;AAAA,IACF;AACA,SAAK,KAAK,WAAW,GAAG;AACxB,YAAQ,IAAI,MAAM;AAAA,MAChB,KAAK;AACH,YAAI,IAAI,eAAgB,MAAK,kBAAkB,IAAI;AACnD,aAAK,QAAQ,IAAI;AACjB,aAAK,KAAK,aAAa,GAAG;AAC1B;AAAA,MACF,KAAK;AACH,aAAK,KAAK,QAAQ,GAAG;AACrB;AAAA,MACF,KAAK;AACH,aAAK,KAAK,YAAY,GAAG;AACzB;AAAA,MACF,KAAK;AACH,aAAK,KAAK,SAAS,GAAG;AACtB;AAAA,MACF,KAAK;AACH,aAAK,KAAK,EAAE,MAAM,QAAQ,GAAG,IAAI,EAAE,CAAC;AACpC;AAAA,IACJ;AAAA,EACF;AAAA,EAEQ,YAAY,MAAc,QAAsB;AACtD,SAAK,KAAK;AACV,UAAM,gBAAgB,CAAC,KAAK,gBAAgB,KAAK,iBAAiB,KAAK,oBAAoB;AAC3F,SAAK,KAAK,SAAS,EAAE,MAAM,QAAQ,cAAc,CAAC;AAClD,QAAI,cAAe,MAAK,kBAAkB;AAAA,EAC5C;AAAA,EAEQ,oBAA0B;AAChC,SAAK,YAAY;AACjB,UAAM,QAAQ,KAAK,IAAI,KAAK,YAAY,MAAM,KAAK,WAAW,IAAI,KAAK,QAAQ;AAC/E,SAAK,KAAK,gBAAgB,EAAE,SAAS,KAAK,SAAS,CAAC;AACpD,SAAK,QAAQ,WAAW,MAAM;AAC5B,UAAI,KAAK,gBAAgB,KAAK,oBAAoB,KAAM;AACxD,WAAK,OAAO,EAAE,WAAW,KAAK,gBAAgB;AAC9C,WAAK,KAAK;AAAA,IACZ,GAAG,KAAK;AAAA,EACV;AAAA,EAEQ,KAAK,KAAoB;AAC/B,QAAI,KAAK,MAAM,KAAK,GAAG,eAAe,KAAM,MAAK,GAAG,KAAK,KAAK,UAAU,GAAG,CAAC;AAAA,EAC9E;AAAA,EAEQ,KAAyC,OAAU,SAAsC;AAC/F,SAAK,UAAU,IAAI,KAAK,GAAG,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;AAAA,EACtD;AACF;AAEA,SAAS,SAAS,MAA2B;AAC3C,MAAI,YAAY,KAAM,QAAO,YAAY,mBAAmB,KAAK,MAAM;AACvE,MAAI,eAAe,KAAM,QAAO,eAAe,mBAAmB,KAAK,SAAS;AAChF,SAAO,cAAc,mBAAmB,KAAK,QAAQ;AACvD;;;ACtNO,IAAM,QAAQ,CAAC,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK,GAAG;AAGrD,SAAS,WAAW,KAAwC;AACjE,QAAM,OAAO,IAAI,MAAM,GAAG,EAAE,CAAC,EAAE,MAAM,GAAG;AACxC,QAAM,MAAiC,CAAC;AACxC,WAAS,IAAI,GAAG,IAAI,GAAG,KAAK;AAC1B,UAAM,OAAO,IAAI;AACjB,QAAI,OAAO;AACX,eAAW,MAAM,KAAK,CAAC,KAAK,IAAI;AAC9B,UAAI,MAAM,OAAO,MAAM,KAAK;AAC1B,gBAAQ,OAAO,EAAE;AAAA,MACnB,OAAO;AACL,YAAI,MAAM,IAAI,IAAI,IAAI,IAAI;AAC1B,gBAAQ;AAAA,MACV;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAGO,SAAS,QAAQ,KAAoB;AAC1C,SAAO,IAAI,MAAM,GAAG,EAAE,CAAC,MAAM,MAAM,UAAU;AAC/C;AAIO,SAAS,YAAY,OAAkC,MAAc,IAAqB;AAC/F,QAAM,IAAI,MAAM,IAAI;AACpB,SAAQ,MAAM,OAAO,GAAG,CAAC,MAAM,OAAS,MAAM,OAAO,GAAG,CAAC,MAAM;AACjE;","names":[]}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@inachess/sdk",
+  "version": "0.1.0",
+  "description": "JavaScript/TypeScript client SDK for the inachess-engine socket protocol.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsup",
+    "test": "node --test",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": ["chess", "inachess", "websocket", "sdk"],
+  "license": "MIT",
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.6.3",
+    "ws": "^8.18.0"
+  }
+}