@inachess/sdk 0.1.0 → 0.2.0

package/README.md

@@ -1,9 +1,16 @@
 # @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.
+TypeScript/JavaScript client for the **inachess-engine** game WebSocket.
+
+Framework-agnostic, zero runtime dependencies, runs in the browser and Node. It
+owns the wire protocol — join, moves, draws, latency pings, reconnect — so your
+app never hand-rolls socket messages.
+
+- **UCI everywhere.** Moves are UCI strings (`"e2e4"`), never SAN.
+- **Server is authoritative.** The engine validates every move and computes every
+  clock; the client only sends intent. Rejections come back as an `error` event.
+- **Clocks are milliseconds remaining**, sent by the server. Never compute them
+  client-side.
 
 ## Install
 
@@ -11,7 +18,7 @@ messages.
 npm install @inachess/sdk
 ```
 
-## Usage
+## Quick start
 
 ```ts
 import { EngineClient } from "@inachess/sdk";
@@ -26,30 +33,114 @@ 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();
+client.move("e2e4");
 ```
 
-The client auto-answers the engine's latency pings and auto-reconnects with the
-engine's rotating reconnect token after a drop. Connect modes:
+The client auto-answers the engine's latency pings and, after an unexpected drop,
+auto-reconnects using the engine's rotating reconnect token.
+
+## Connect modes
 
 ```ts
-client.connect({ ticket });           // first join
+client.connect({ ticket });           // first join (single-use ticket)
 client.connect({ reconnect: token }); // resume after a drop
-client.connect({ spectate: token });  // read-only viewer
+client.connect({ spectate: token });  // read-only viewer (no reconnect token)
+```
+
+Read state after connecting:
+
+```ts
+client.seat;           // "white" | "black" | "spectator" | null (before join)
+client.reconnectToken; // rotating token, or null (spectators never get one)
 ```
 
-Helpers for rendering are exported too: `parseBoard(fen)`, `fenTurn(fen)`,
-`isPromotion(board, from, to)`.
+## Events
+
+Subscribe with `client.on(event, handler)`; unsubscribe with `client.off(...)`.
+
+| Event          | Payload                                        | When |
+|----------------|------------------------------------------------|------|
+| `gameState`    | full snapshot (`fen`, `turn`, `you`, `moves`, `status`, `whiteMs`, `blackMs`) | join / rejoin / spectate |
+| `move`         | `uci`, `by`, `fen`, `turn`, `whiteMs`, `blackMs` | a move was validated |
+| `gameOver`     | `result`, `reason`                             | game ended (`result`: `white_win` \| `black_win` \| `draw` \| `aborted`) |
+| `drawOffer`    | `by`                                           | opponent offered a draw |
+| `drawDeclined` | —                                              | your draw offer was declined |
+| `error`        | `message`                                      | a command was rejected |
+| `open`         | —                                              | socket opened |
+| `close`        | `code`, `reason`, `willReconnect`              | socket closed |
+| `reconnecting` | `attempt`                                      | a reconnect attempt is scheduled |
+| `message`      | any `ServerMessage`                            | catch-all, fires for every server message |
+
+## Actions
+
+Client → engine. All are no-ops if the socket is not open.
+
+| Method             | Sends           | Purpose |
+|--------------------|-----------------|---------|
+| `move(uci)`        | `move`          | submit a UCI move |
+| `resign()`         | `resign`        | resign the game |
+| `abort()`          | `abort`         | abort before both sides' first move |
+| `accept()`         | `accept`        | confirm presence under a `ready_check` gate |
+| `offerDraw()`      | `offer_draw`    | propose a draw (rate-limited by the engine) |
+| `acceptDraw()`     | `accept_draw`   | accept the opponent's pending offer |
+| `declineDraw()`    | `decline_draw`  | decline the opponent's pending offer |
+| `claimDraw()`      | `claim_draw`    | claim a threefold / 50-move draw when eligible |
+| `close()`          | —               | close the socket and stop reconnecting |
+
+## Node usage
+
+There is no global `WebSocket` in Node, so pass an implementation:
+
+```ts
+import { EngineClient } from "@inachess/sdk";
+import { WebSocket } from "ws";
+
+const client = new EngineClient({ url: "ws://localhost:8080/ws", WebSocket });
+```
+
+## Options
+
+```ts
+new EngineClient({
+  url: "wss://engine.example.com/ws", // required
+  WebSocket,                // WebSocket impl; defaults to the global (browser)
+  autoReconnect: true,      // reconnect after an unexpected drop (default true)
+  reconnectDelayMs: 500,    // base backoff (default 500)
+  maxReconnectDelayMs: 8000,// backoff cap (default 8000)
+  maxReconnectAttempts: 10, // give up after this many failures (default 10)
+});
+```
+
+Reconnect uses exponential backoff (`reconnectDelayMs · 2ⁿ`, capped at
+`maxReconnectDelayMs`). It only fires when `autoReconnect` is on **and** a
+reconnect token exists — so spectators and games that ended (`gameOver`) never
+reconnect.
+
+## Rendering helpers
+
+Pure, protocol-free helpers for drawing a board from a FEN:
+
+```ts
+import { parseBoard, fenTurn, isPromotion, FILES } from "@inachess/sdk";
+
+const board = parseBoard(fen);      // { e1: "K", e8: "k", ... }
+fenTurn(fen);                       // "white" | "black"
+isPromotion(board, "e7", "e8");     // true if this move promotes a pawn
+FILES;                              // ["a".."h"]
+```
 
 ## Develop
 
 ```bash
 npm install
-npm run build   # tsup → dist (ESM + CJS + .d.ts)
+npm run build   # tsup → dist/ (ESM + CJS + .d.ts)
 npm test        # node --test
 ```
 
+`src/protocol.ts` mirrors the engine's `internal/game/room/protocol.go`
+byte-for-byte — if the engine's wire protocol changes, that file changes in
+lockstep. Consumers import from `dist/`, so rebuild after any change.
+
 ## License
 
 MIT

package/dist/index.cjs

@@ -36,9 +36,12 @@ var EngineClient = class {
   autoReconnect;
   baseDelay;
   maxDelay;
+  maxAttempts;
   ws = null;
   mode = null;
   closedByUser = false;
+  finished = false;
+  // game_over seen → terminal, no auto-reconnect
   attempts = 0;
   timer = null;
   _reconnectToken = null;
@@ -52,6 +55,7 @@ var EngineClient = class {
     this.autoReconnect = opts.autoReconnect ?? true;
     this.baseDelay = opts.reconnectDelayMs ?? 500;
     this.maxDelay = opts.maxReconnectDelayMs ?? 8e3;
+    this.maxAttempts = opts.maxReconnectAttempts ?? 10;
   }
   /** The current rotating reconnect token, or null (spectators never get one). */
   get reconnectToken() {
@@ -76,7 +80,9 @@ var EngineClient = class {
   }
   /** Open the socket with the given credentials. */
   connect(mode) {
+    if (this.timer) clearTimeout(this.timer);
     this.closedByUser = false;
+    this.finished = false;
     this.mode = mode;
     this.attempts = 0;
     this.dial();
@@ -89,6 +95,30 @@ var EngineClient = class {
   resign() {
     this.send({ type: "resign" });
   }
+  /** Offer a draw to the opponent (rate-limited by the engine). */
+  offerDraw() {
+    this.send({ type: "offer_draw" });
+  }
+  /** Accept the opponent's pending draw offer. */
+  acceptDraw() {
+    this.send({ type: "accept_draw" });
+  }
+  /** Decline the opponent's pending draw offer. */
+  declineDraw() {
+    this.send({ type: "decline_draw" });
+  }
+  /** Claim a threefold-repetition / 50-move draw when eligible. */
+  claimDraw() {
+    this.send({ type: "claim_draw" });
+  }
+  /** Abort the game before both sides have made their first move. */
+  abort() {
+    this.send({ type: "abort" });
+  }
+  /** Confirm presence under a ready_check gate. */
+  accept() {
+    this.send({ type: "accept" });
+  }
   /** Close the socket and stop any reconnection. */
   close() {
     this.closedByUser = true;
@@ -98,10 +128,16 @@ var EngineClient = class {
   }
   dial() {
     if (!this.mode) return;
+    if (this.ws) {
+      this.ws.onopen = this.ws.onmessage = this.ws.onclose = this.ws.onerror = null;
+      try {
+        this.ws.close(1e3, "");
+      } catch {
+      }
+    }
     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);
@@ -116,9 +152,11 @@ var EngineClient = class {
     } catch {
       return;
     }
+    if (!msg || typeof msg.type !== "string") return;
     this.emit("message", msg);
     switch (msg.type) {
       case "game_state":
+        this.attempts = 0;
         if (msg.reconnectToken) this._reconnectToken = msg.reconnectToken;
         this._seat = msg.you;
         this.emit("gameState", msg);
@@ -127,11 +165,18 @@ var EngineClient = class {
         this.emit("move", msg);
         break;
       case "game_over":
+        this.finished = true;
         this.emit("gameOver", msg);
         break;
       case "error":
         this.emit("error", msg);
         break;
+      case "draw_offer":
+        this.emit("drawOffer", msg);
+        break;
+      case "draw_declined":
+        this.emit("drawDeclined", msg);
+        break;
       case "ping":
         this.send({ type: "pong", t: msg.t });
         break;
@@ -139,16 +184,21 @@ var EngineClient = class {
   }
   handleClose(code, reason) {
     this.ws = null;
-    const willReconnect = !this.closedByUser && this.autoReconnect && this._reconnectToken !== null;
+    const willReconnect = !this.closedByUser && !this.finished && this.autoReconnect && this._reconnectToken !== null;
     this.emit("close", { code, reason, willReconnect });
     if (willReconnect) this.scheduleReconnect();
   }
   scheduleReconnect() {
     this.attempts += 1;
+    if (this.attempts > this.maxAttempts) {
+      this._reconnectToken = null;
+      this.emit("close", { code: 1006, reason: "reconnect gave up", willReconnect: false });
+      return;
+    }
     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;
+      if (this.closedByUser || this.finished || this._reconnectToken === null) return;
       this.mode = { reconnect: this._reconnectToken };
       this.dial();
     }, delay);

package/dist/index.cjs.map

@@ -1 +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":[]}
+{"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  DrawOfferMessage,\n  DrawDeclinedMessage,\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  DrawOfferMessage,\n  DrawDeclinedMessage,\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  drawOffer: DrawOfferMessage;\n  drawDeclined: DrawDeclinedMessage;\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  /** Give up reconnecting after this many consecutive failed attempts (default 10). */\n  maxReconnectAttempts?: 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 readonly maxAttempts: number;\n\n  private ws: WebSocketLike | null = null;\n  private mode: ConnectMode | null = null;\n  private closedByUser = false;\n  private finished = false; // game_over seen → terminal, no auto-reconnect\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    this.maxAttempts = opts.maxReconnectAttempts ?? 10;\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    if (this.timer) clearTimeout(this.timer); // cancel a pending reconnect so it can't clobber this socket\n    this.closedByUser = false;\n    this.finished = 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  /** Offer a draw to the opponent (rate-limited by the engine). */\n  offerDraw(): void {\n    this.send({ type: \"offer_draw\" });\n  }\n\n  /** Accept the opponent's pending draw offer. */\n  acceptDraw(): void {\n    this.send({ type: \"accept_draw\" });\n  }\n\n  /** Decline the opponent's pending draw offer. */\n  declineDraw(): void {\n    this.send({ type: \"decline_draw\" });\n  }\n\n  /** Claim a threefold-repetition / 50-move draw when eligible. */\n  claimDraw(): void {\n    this.send({ type: \"claim_draw\" });\n  }\n\n  /** Abort the game before both sides have made their first move. */\n  abort(): void {\n    this.send({ type: \"abort\" });\n  }\n\n  /** Confirm presence under a ready_check gate. */\n  accept(): void {\n    this.send({ type: \"accept\" });\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    if (this.ws) {\n      // Detach + close any previous socket so its late events can't drive this\n      // client or spawn a second reconnect chain.\n      this.ws.onopen = this.ws.onmessage = this.ws.onclose = this.ws.onerror = null;\n      try {\n        this.ws.close(1000, \"\");\n      } catch {\n        /* closing a still-CONNECTING socket can throw; ignore */\n      }\n    }\n    const ws = new this.WS(this.url + \"?\" + queryFor(this.mode));\n    this.ws = ws;\n    ws.onopen = () => {\n      // Do NOT reset attempts here — a rejected reconnect still fires onopen\n      // before the server's policy close. Reset only on a real join (game_state).\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    if (!msg || typeof (msg as { type?: unknown }).type !== \"string\") return;\n    this.emit(\"message\", msg);\n    switch (msg.type) {\n      case \"game_state\":\n        this.attempts = 0; // a real join succeeded → reset backoff\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.finished = true; // terminal — a later socket close must not reconnect\n        this.emit(\"gameOver\", msg);\n        break;\n      case \"error\":\n        this.emit(\"error\", msg);\n        break;\n      case \"draw_offer\":\n        this.emit(\"drawOffer\", msg);\n        break;\n      case \"draw_declined\":\n        this.emit(\"drawDeclined\", 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 =\n      !this.closedByUser && !this.finished && 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    if (this.attempts > this.maxAttempts) {\n      // A consumed/invalid token would otherwise retry forever. Give up terminally.\n      this._reconnectToken = null;\n      this.emit(\"close\", { code: 1006, reason: \"reconnect gave up\", willReconnect: false });\n      return;\n    }\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.finished || 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":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACwDA,IAAM,OAAO;AAiBN,IAAM,eAAN,MAAmB;AAAA,EACP;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EAET,KAA2B;AAAA,EAC3B,OAA2B;AAAA,EAC3B,eAAe;AAAA,EACf,WAAW;AAAA;AAAA,EACX,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;AAC5C,SAAK,cAAc,KAAK,wBAAwB;AAAA,EAClD;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,QAAI,KAAK,MAAO,cAAa,KAAK,KAAK;AACvC,SAAK,eAAe;AACpB,SAAK,WAAW;AAChB,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,YAAkB;AAChB,SAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAAA,EAClC;AAAA;AAAA,EAGA,aAAmB;AACjB,SAAK,KAAK,EAAE,MAAM,cAAc,CAAC;AAAA,EACnC;AAAA;AAAA,EAGA,cAAoB;AAClB,SAAK,KAAK,EAAE,MAAM,eAAe,CAAC;AAAA,EACpC;AAAA;AAAA,EAGA,YAAkB;AAChB,SAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAAA,EAClC;AAAA;AAAA,EAGA,QAAc;AACZ,SAAK,KAAK,EAAE,MAAM,QAAQ,CAAC;AAAA,EAC7B;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,QAAI,KAAK,IAAI;AAGX,WAAK,GAAG,SAAS,KAAK,GAAG,YAAY,KAAK,GAAG,UAAU,KAAK,GAAG,UAAU;AACzE,UAAI;AACF,aAAK,GAAG,MAAM,KAAM,EAAE;AAAA,MACxB,QAAQ;AAAA,MAER;AAAA,IACF;AACA,UAAM,KAAK,IAAI,KAAK,GAAG,KAAK,MAAM,MAAM,SAAS,KAAK,IAAI,CAAC;AAC3D,SAAK,KAAK;AACV,OAAG,SAAS,MAAM;AAGhB,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,QAAI,CAAC,OAAO,OAAQ,IAA2B,SAAS,SAAU;AAClE,SAAK,KAAK,WAAW,GAAG;AACxB,YAAQ,IAAI,MAAM;AAAA,MAChB,KAAK;AACH,aAAK,WAAW;AAChB,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,WAAW;AAChB,aAAK,KAAK,YAAY,GAAG;AACzB;AAAA,MACF,KAAK;AACH,aAAK,KAAK,SAAS,GAAG;AACtB;AAAA,MACF,KAAK;AACH,aAAK,KAAK,aAAa,GAAG;AAC1B;AAAA,MACF,KAAK;AACH,aAAK,KAAK,gBAAgB,GAAG;AAC7B;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,gBACJ,CAAC,KAAK,gBAAgB,CAAC,KAAK,YAAY,KAAK,iBAAiB,KAAK,oBAAoB;AACzF,SAAK,KAAK,SAAS,EAAE,MAAM,QAAQ,cAAc,CAAC;AAClD,QAAI,cAAe,MAAK,kBAAkB;AAAA,EAC5C;AAAA,EAEQ,oBAA0B;AAChC,SAAK,YAAY;AACjB,QAAI,KAAK,WAAW,KAAK,aAAa;AAEpC,WAAK,kBAAkB;AACvB,WAAK,KAAK,SAAS,EAAE,MAAM,MAAM,QAAQ,qBAAqB,eAAe,MAAM,CAAC;AACpF;AAAA,IACF;AACA,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,YAAY,KAAK,oBAAoB,KAAM;AACzE,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;;;AC3RO,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/dist/index.d.cts

@@ -1,7 +1,7 @@
 type Color = "white" | "black";
 type Seat = Color | "spectator";
 type GameStatus = "active" | "finished";
-type GameResult = "white_win" | "black_win" | "draw";
+type GameResult = "white_win" | "black_win" | "draw" | "aborted";
 /** Full snapshot sent on join / rejoin / spectate. */
 interface GameStateMessage {
     type: "game_state";
@@ -41,7 +41,16 @@ interface PingMessage {
     type: "ping";
     t: number;
 }
-type ServerMessage = GameStateMessage | MoveMessage | GameOverMessage | ErrorMessage | PingMessage;
+/** Sent to the opponent when a player offers a draw. */
+interface DrawOfferMessage {
+    type: "draw_offer";
+    by: Color;
+}
+/** Sent to the offerer when the opponent declines their draw offer. */
+interface DrawDeclinedMessage {
+    type: "draw_declined";
+}
+type ServerMessage = GameStateMessage | MoveMessage | GameOverMessage | ErrorMessage | PingMessage | DrawOfferMessage | DrawDeclinedMessage;
 interface MoveIntent {
     type: "move";
     uci: string;
@@ -53,7 +62,31 @@ interface PongIntent {
     type: "pong";
     t: number;
 }
-type ClientMessage = MoveIntent | ResignIntent | PongIntent;
+/** Propose a draw to the opponent (rate-limited by the engine). */
+interface OfferDrawIntent {
+    type: "offer_draw";
+}
+/** Accept the opponent's pending draw offer. */
+interface AcceptDrawIntent {
+    type: "accept_draw";
+}
+/** Decline the opponent's pending draw offer. */
+interface DeclineDrawIntent {
+    type: "decline_draw";
+}
+/** Claim a threefold-repetition / 50-move draw when eligible. */
+interface ClaimDrawIntent {
+    type: "claim_draw";
+}
+/** Abort the game before both sides have made their first move. */
+interface AbortIntent {
+    type: "abort";
+}
+/** Confirm presence under a ready_check gate. */
+interface AcceptIntent {
+    type: "accept";
+}
+type ClientMessage = MoveIntent | ResignIntent | PongIntent | OfferDrawIntent | AcceptDrawIntent | DeclineDrawIntent | ClaimDrawIntent | AbortIntent | AcceptIntent;
 
 /** How to authenticate the socket to a room. */
 type ConnectMode = {
@@ -78,6 +111,8 @@ interface EngineClientEvents {
     move: MoveMessage;
     gameOver: GameOverMessage;
     error: ErrorMessage;
+    drawOffer: DrawOfferMessage;
+    drawDeclined: DrawDeclinedMessage;
     message: ServerMessage;
 }
 interface EngineClientOptions {
@@ -89,6 +124,8 @@ interface EngineClientOptions {
     autoReconnect?: boolean;
     reconnectDelayMs?: number;
     maxReconnectDelayMs?: number;
+    /** Give up reconnecting after this many consecutive failed attempts (default 10). */
+    maxReconnectAttempts?: number;
 }
 type Listener<T> = (payload: T) => void;
 /**
@@ -112,9 +149,11 @@ declare class EngineClient {
     private readonly autoReconnect;
     private readonly baseDelay;
     private readonly maxDelay;
+    private readonly maxAttempts;
     private ws;
     private mode;
     private closedByUser;
+    private finished;
     private attempts;
     private timer;
     private _reconnectToken;
@@ -133,6 +172,18 @@ declare class EngineClient {
     move(uci: string): void;
     /** Resign the game. */
     resign(): void;
+    /** Offer a draw to the opponent (rate-limited by the engine). */
+    offerDraw(): void;
+    /** Accept the opponent's pending draw offer. */
+    acceptDraw(): void;
+    /** Decline the opponent's pending draw offer. */
+    declineDraw(): void;
+    /** Claim a threefold-repetition / 50-move draw when eligible. */
+    claimDraw(): void;
+    /** Abort the game before both sides have made their first move. */
+    abort(): void;
+    /** Confirm presence under a ready_check gate. */
+    accept(): void;
     /** Close the socket and stop any reconnection. */
     close(): void;
     private dial;
@@ -153,4 +204,4 @@ declare function fenTurn(fen: string): Color;
  * 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 };
+export { type ClientMessage, type Color, type ConnectMode, type DrawDeclinedMessage, type DrawOfferMessage, 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

@@ -1,7 +1,7 @@
 type Color = "white" | "black";
 type Seat = Color | "spectator";
 type GameStatus = "active" | "finished";
-type GameResult = "white_win" | "black_win" | "draw";
+type GameResult = "white_win" | "black_win" | "draw" | "aborted";
 /** Full snapshot sent on join / rejoin / spectate. */
 interface GameStateMessage {
     type: "game_state";
@@ -41,7 +41,16 @@ interface PingMessage {
     type: "ping";
     t: number;
 }
-type ServerMessage = GameStateMessage | MoveMessage | GameOverMessage | ErrorMessage | PingMessage;
+/** Sent to the opponent when a player offers a draw. */
+interface DrawOfferMessage {
+    type: "draw_offer";
+    by: Color;
+}
+/** Sent to the offerer when the opponent declines their draw offer. */
+interface DrawDeclinedMessage {
+    type: "draw_declined";
+}
+type ServerMessage = GameStateMessage | MoveMessage | GameOverMessage | ErrorMessage | PingMessage | DrawOfferMessage | DrawDeclinedMessage;
 interface MoveIntent {
     type: "move";
     uci: string;
@@ -53,7 +62,31 @@ interface PongIntent {
     type: "pong";
     t: number;
 }
-type ClientMessage = MoveIntent | ResignIntent | PongIntent;
+/** Propose a draw to the opponent (rate-limited by the engine). */
+interface OfferDrawIntent {
+    type: "offer_draw";
+}
+/** Accept the opponent's pending draw offer. */
+interface AcceptDrawIntent {
+    type: "accept_draw";
+}
+/** Decline the opponent's pending draw offer. */
+interface DeclineDrawIntent {
+    type: "decline_draw";
+}
+/** Claim a threefold-repetition / 50-move draw when eligible. */
+interface ClaimDrawIntent {
+    type: "claim_draw";
+}
+/** Abort the game before both sides have made their first move. */
+interface AbortIntent {
+    type: "abort";
+}
+/** Confirm presence under a ready_check gate. */
+interface AcceptIntent {
+    type: "accept";
+}
+type ClientMessage = MoveIntent | ResignIntent | PongIntent | OfferDrawIntent | AcceptDrawIntent | DeclineDrawIntent | ClaimDrawIntent | AbortIntent | AcceptIntent;
 
 /** How to authenticate the socket to a room. */
 type ConnectMode = {
@@ -78,6 +111,8 @@ interface EngineClientEvents {
     move: MoveMessage;
     gameOver: GameOverMessage;
     error: ErrorMessage;
+    drawOffer: DrawOfferMessage;
+    drawDeclined: DrawDeclinedMessage;
     message: ServerMessage;
 }
 interface EngineClientOptions {
@@ -89,6 +124,8 @@ interface EngineClientOptions {
     autoReconnect?: boolean;
     reconnectDelayMs?: number;
     maxReconnectDelayMs?: number;
+    /** Give up reconnecting after this many consecutive failed attempts (default 10). */
+    maxReconnectAttempts?: number;
 }
 type Listener<T> = (payload: T) => void;
 /**
@@ -112,9 +149,11 @@ declare class EngineClient {
     private readonly autoReconnect;
     private readonly baseDelay;
     private readonly maxDelay;
+    private readonly maxAttempts;
     private ws;
     private mode;
     private closedByUser;
+    private finished;
     private attempts;
     private timer;
     private _reconnectToken;
@@ -133,6 +172,18 @@ declare class EngineClient {
     move(uci: string): void;
     /** Resign the game. */
     resign(): void;
+    /** Offer a draw to the opponent (rate-limited by the engine). */
+    offerDraw(): void;
+    /** Accept the opponent's pending draw offer. */
+    acceptDraw(): void;
+    /** Decline the opponent's pending draw offer. */
+    declineDraw(): void;
+    /** Claim a threefold-repetition / 50-move draw when eligible. */
+    claimDraw(): void;
+    /** Abort the game before both sides have made their first move. */
+    abort(): void;
+    /** Confirm presence under a ready_check gate. */
+    accept(): void;
     /** Close the socket and stop any reconnection. */
     close(): void;
     private dial;
@@ -153,4 +204,4 @@ declare function fenTurn(fen: string): Color;
  * 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 };
+export { type ClientMessage, type Color, type ConnectMode, type DrawDeclinedMessage, type DrawOfferMessage, 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

@@ -6,9 +6,12 @@ var EngineClient = class {
   autoReconnect;
   baseDelay;
   maxDelay;
+  maxAttempts;
   ws = null;
   mode = null;
   closedByUser = false;
+  finished = false;
+  // game_over seen → terminal, no auto-reconnect
   attempts = 0;
   timer = null;
   _reconnectToken = null;
@@ -22,6 +25,7 @@ var EngineClient = class {
     this.autoReconnect = opts.autoReconnect ?? true;
     this.baseDelay = opts.reconnectDelayMs ?? 500;
     this.maxDelay = opts.maxReconnectDelayMs ?? 8e3;
+    this.maxAttempts = opts.maxReconnectAttempts ?? 10;
   }
   /** The current rotating reconnect token, or null (spectators never get one). */
   get reconnectToken() {
@@ -46,7 +50,9 @@ var EngineClient = class {
   }
   /** Open the socket with the given credentials. */
   connect(mode) {
+    if (this.timer) clearTimeout(this.timer);
     this.closedByUser = false;
+    this.finished = false;
     this.mode = mode;
     this.attempts = 0;
     this.dial();
@@ -59,6 +65,30 @@ var EngineClient = class {
   resign() {
     this.send({ type: "resign" });
   }
+  /** Offer a draw to the opponent (rate-limited by the engine). */
+  offerDraw() {
+    this.send({ type: "offer_draw" });
+  }
+  /** Accept the opponent's pending draw offer. */
+  acceptDraw() {
+    this.send({ type: "accept_draw" });
+  }
+  /** Decline the opponent's pending draw offer. */
+  declineDraw() {
+    this.send({ type: "decline_draw" });
+  }
+  /** Claim a threefold-repetition / 50-move draw when eligible. */
+  claimDraw() {
+    this.send({ type: "claim_draw" });
+  }
+  /** Abort the game before both sides have made their first move. */
+  abort() {
+    this.send({ type: "abort" });
+  }
+  /** Confirm presence under a ready_check gate. */
+  accept() {
+    this.send({ type: "accept" });
+  }
   /** Close the socket and stop any reconnection. */
   close() {
     this.closedByUser = true;
@@ -68,10 +98,16 @@ var EngineClient = class {
   }
   dial() {
     if (!this.mode) return;
+    if (this.ws) {
+      this.ws.onopen = this.ws.onmessage = this.ws.onclose = this.ws.onerror = null;
+      try {
+        this.ws.close(1e3, "");
+      } catch {
+      }
+    }
     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);
@@ -86,9 +122,11 @@ var EngineClient = class {
     } catch {
       return;
     }
+    if (!msg || typeof msg.type !== "string") return;
     this.emit("message", msg);
     switch (msg.type) {
       case "game_state":
+        this.attempts = 0;
         if (msg.reconnectToken) this._reconnectToken = msg.reconnectToken;
         this._seat = msg.you;
         this.emit("gameState", msg);
@@ -97,11 +135,18 @@ var EngineClient = class {
         this.emit("move", msg);
         break;
       case "game_over":
+        this.finished = true;
         this.emit("gameOver", msg);
         break;
       case "error":
         this.emit("error", msg);
         break;
+      case "draw_offer":
+        this.emit("drawOffer", msg);
+        break;
+      case "draw_declined":
+        this.emit("drawDeclined", msg);
+        break;
       case "ping":
         this.send({ type: "pong", t: msg.t });
         break;
@@ -109,16 +154,21 @@ var EngineClient = class {
   }
   handleClose(code, reason) {
     this.ws = null;
-    const willReconnect = !this.closedByUser && this.autoReconnect && this._reconnectToken !== null;
+    const willReconnect = !this.closedByUser && !this.finished && this.autoReconnect && this._reconnectToken !== null;
     this.emit("close", { code, reason, willReconnect });
     if (willReconnect) this.scheduleReconnect();
   }
   scheduleReconnect() {
     this.attempts += 1;
+    if (this.attempts > this.maxAttempts) {
+      this._reconnectToken = null;
+      this.emit("close", { code: 1006, reason: "reconnect gave up", willReconnect: false });
+      return;
+    }
     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;
+      if (this.closedByUser || this.finished || this._reconnectToken === null) return;
       this.mode = { reconnect: this._reconnectToken };
       this.dial();
     }, delay);

package/dist/index.js.map

@@ -1 +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":"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","names":[]}
+{"version":3,"sources":["../src/client.ts","../src/fen.ts"],"sourcesContent":["import type {\n  ServerMessage,\n  GameStateMessage,\n  MoveMessage,\n  GameOverMessage,\n  ErrorMessage,\n  DrawOfferMessage,\n  DrawDeclinedMessage,\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  drawOffer: DrawOfferMessage;\n  drawDeclined: DrawDeclinedMessage;\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  /** Give up reconnecting after this many consecutive failed attempts (default 10). */\n  maxReconnectAttempts?: 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 readonly maxAttempts: number;\n\n  private ws: WebSocketLike | null = null;\n  private mode: ConnectMode | null = null;\n  private closedByUser = false;\n  private finished = false; // game_over seen → terminal, no auto-reconnect\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    this.maxAttempts = opts.maxReconnectAttempts ?? 10;\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    if (this.timer) clearTimeout(this.timer); // cancel a pending reconnect so it can't clobber this socket\n    this.closedByUser = false;\n    this.finished = 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  /** Offer a draw to the opponent (rate-limited by the engine). */\n  offerDraw(): void {\n    this.send({ type: \"offer_draw\" });\n  }\n\n  /** Accept the opponent's pending draw offer. */\n  acceptDraw(): void {\n    this.send({ type: \"accept_draw\" });\n  }\n\n  /** Decline the opponent's pending draw offer. */\n  declineDraw(): void {\n    this.send({ type: \"decline_draw\" });\n  }\n\n  /** Claim a threefold-repetition / 50-move draw when eligible. */\n  claimDraw(): void {\n    this.send({ type: \"claim_draw\" });\n  }\n\n  /** Abort the game before both sides have made their first move. */\n  abort(): void {\n    this.send({ type: \"abort\" });\n  }\n\n  /** Confirm presence under a ready_check gate. */\n  accept(): void {\n    this.send({ type: \"accept\" });\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    if (this.ws) {\n      // Detach + close any previous socket so its late events can't drive this\n      // client or spawn a second reconnect chain.\n      this.ws.onopen = this.ws.onmessage = this.ws.onclose = this.ws.onerror = null;\n      try {\n        this.ws.close(1000, \"\");\n      } catch {\n        /* closing a still-CONNECTING socket can throw; ignore */\n      }\n    }\n    const ws = new this.WS(this.url + \"?\" + queryFor(this.mode));\n    this.ws = ws;\n    ws.onopen = () => {\n      // Do NOT reset attempts here — a rejected reconnect still fires onopen\n      // before the server's policy close. Reset only on a real join (game_state).\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    if (!msg || typeof (msg as { type?: unknown }).type !== \"string\") return;\n    this.emit(\"message\", msg);\n    switch (msg.type) {\n      case \"game_state\":\n        this.attempts = 0; // a real join succeeded → reset backoff\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.finished = true; // terminal — a later socket close must not reconnect\n        this.emit(\"gameOver\", msg);\n        break;\n      case \"error\":\n        this.emit(\"error\", msg);\n        break;\n      case \"draw_offer\":\n        this.emit(\"drawOffer\", msg);\n        break;\n      case \"draw_declined\":\n        this.emit(\"drawDeclined\", 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 =\n      !this.closedByUser && !this.finished && 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    if (this.attempts > this.maxAttempts) {\n      // A consumed/invalid token would otherwise retry forever. Give up terminally.\n      this._reconnectToken = null;\n      this.emit(\"close\", { code: 1006, reason: \"reconnect gave up\", willReconnect: false });\n      return;\n    }\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.finished || 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inachess/sdk",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "JavaScript/TypeScript client SDK for the inachess-engine socket protocol.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -13,7 +13,9 @@
       "require": "./dist/index.cjs"
     }
   },
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "scripts": {
     "build": "tsup",
     "test": "node --test",
@@ -22,7 +24,12 @@
   "publishConfig": {
     "access": "public"
   },
-  "keywords": ["chess", "inachess", "websocket", "sdk"],
+  "keywords": [
+    "chess",
+    "inachess",
+    "websocket",
+    "sdk"
+  ],
   "license": "MIT",
   "devDependencies": {
     "tsup": "^8.3.5",