@caitdesk/client 0.1.0

package/README.md

@@ -0,0 +1,193 @@
+# @caitdesk/client
+
+Official TypeScript client for the CaitDesk captioner API. Provides typed REST and WebSocket interfaces for third-party captioning applications.
+
+## Install
+
+```bash
+npm install @caitdesk/client
+```
+
+## Quick Start
+
+```ts
+import { CaitDeskClient } from '@caitdesk/client';
+
+const client = new CaitDeskClient({
+  apiUrl: 'https://api.caitdesk.com',
+  apiKey: 'cait_sk_...',
+  onStatusChange: (status) => console.log('Connection:', status),
+  onSlotChange: (status) => console.log('Slot:', status),
+  onCaptionAck: (ack) => console.log('Ack seq:', ack.seq),
+  onError: (err) => console.error('Error:', err.code, err.message),
+  onEventEnded: () => console.log('Event ended'),
+});
+
+// List your assigned events
+const events = await client.getEvents();
+
+// Connect to an event
+await client.connect(events[0].id);
+
+// Send captions
+client.append('Hello, world!');
+client.append(' More text.');
+
+// Control the event
+client.start();  // Start the event
+client.pause();  // Pause captions
+client.resume(); // Resume captions
+client.stop();   // End the event
+
+// Disconnect when done
+client.disconnect();
+```
+
+## API Reference
+
+### CaitDeskClient
+
+#### Constructor
+
+```ts
+new CaitDeskClient(config: CaitDeskConfig)
+```
+
+#### Properties
+
+| Property     | Type               | Description                              |
+| ------------ | ------------------ | ---------------------------------------- |
+| `status`     | `ConnectionStatus` | Current WebSocket connection status      |
+| `slotStatus` | `SlotStatus`       | Current slot status (active or waiting)  |
+
+#### REST Methods
+
+```ts
+client.getMe(): Promise<User>
+client.getEvents(): Promise<Event[]>
+```
+
+- `getMe()` — returns the authenticated user's info
+- `getEvents()` — returns events assigned to you as captioner (scheduled and live only)
+
+#### Connection
+
+```ts
+client.connect(eventId: string): Promise<void>
+client.disconnect(): void
+```
+
+`connect()` fetches a stream ticket and opens a WebSocket connection. If already connected, the previous connection is closed first. Handles reconnection automatically on unexpected disconnects.
+
+#### Sending Captions
+
+```ts
+client.append(text: string): void   // Append text (max 10,000 chars)
+client.delete(count: number): void  // Delete characters from end (max 100,000)
+client.sync(text: string): void     // Full text sync (max 100,000 chars)
+```
+
+All methods auto-inject `eventId` and `timestamp`. Throws if not connected.
+
+#### Event Control
+
+```ts
+client.start(): void   // Transition event from scheduled to live
+client.stop(): void    // End the event
+client.pause(): void   // Pause caption display
+client.resume(): void  // Resume caption display
+```
+
+#### Slot Management
+
+```ts
+client.releaseSlot(): void  // Yield active slot to next waiting captioner
+```
+
+### Configuration
+
+```ts
+interface CaitDeskConfig {
+  apiUrl: string;
+  apiKey: string;
+  onStatusChange?: (status: ConnectionStatus) => void;
+  onSlotChange?: (status: SlotStatus, detail?: SlotDetail) => void;
+  onCaptionAck?: (ack: CaptionAck) => void;
+  onControlAck?: (ack: ControlAck) => void;
+  onError?: (error: ServerError) => void;
+  onEventEnded?: (eventId: string) => void;
+  onWaitingCountChange?: (count: number) => void;
+}
+```
+
+| Callback               | When it fires                                           |
+| ---------------------- | ------------------------------------------------------- |
+| `onStatusChange`       | Connection state changes (connecting/connected/etc.)    |
+| `onSlotChange`         | You become the active captioner or enter the wait queue |
+| `onCaptionAck`         | Server acknowledges a caption message (with `seq`)      |
+| `onControlAck`         | Server acknowledges a control action                    |
+| `onError`              | Server sends an error message                           |
+| `onEventEnded`         | The event has ended (server-initiated)                  |
+| `onWaitingCountChange` | Number of waiting captioners changed (active slot only) |
+
+### Types
+
+```ts
+interface User { id: string; email: string; name: string | null }
+interface Event { id: string; organizationId: string; title: string; description: string | null; scheduledStart: string; scheduledEnd: string | null; status: string; clientName: string | null }
+interface CaptionAck { type: 'ack'; timestamp: number; seq: number }
+interface ControlAck { type: 'ack'; action: string }
+interface ServerError { type: 'error'; code: string; message: string; details?: Record<string, unknown> }
+interface SlotDetail { position?: number; activeSince?: string }
+```
+
+### Constants
+
+```ts
+import { ERROR_CODE, RATE_LIMITS, CONNECTION_DEFAULTS } from '@caitdesk/client';
+```
+
+## Error Handling
+
+Errors are delivered via the `onError` callback. Some errors are terminal:
+
+| Code              | Terminal | Meaning                                  | Action                      |
+| ----------------- | -------- | ---------------------------------------- | --------------------------- |
+| `WS_AUTH_FAILED`  | Yes      | API key or ticket is invalid             | Check credentials           |
+| `WS_SLOT_FULL`   | Yes      | Too many captioners connected            | Try again later             |
+| `WS_NOT_ACTIVE`   | No       | You sent captions but aren't active yet  | Wait for `onSlotChange`     |
+| `WS_INVALID_MESSAGE` | No   | Malformed message                        | Check message format        |
+| `RATE_LIMITED`    | No       | Too many messages/second                 | Reduce send rate            |
+| `NETWORK_ERROR`   | No       | Connection or ticket refresh failed      | Client retries automatically |
+
+Terminal errors close the connection without reconnection.
+
+## Reconnection
+
+The client reconnects automatically on unexpected disconnects using exponential backoff (1s initial, 30s max, 1.5x multiplier). During reconnection:
+
+1. A fresh ticket is fetched via the REST API
+2. A new WebSocket connection is established
+3. The slot system restores your position (same user ID = seamless takeover)
+
+The client does **not** reconnect when:
+- You call `disconnect()`
+- The event ends (`event_ended` message)
+- Authentication fails (close code `1008`)
+- The slot queue is full (close code `1013`)
+
+## Slot System
+
+Each event has one active captioner slot and a waiting queue (max 2 waiters).
+
+| Status    | Meaning                              | Can send captions? |
+| --------- | ------------------------------------ | ------------------ |
+| `active`  | You hold the active slot             | Yes                |
+| `waiting` | You're in the queue                  | No                 |
+| `unknown` | Not connected or status not received | No                 |
+
+When the active captioner disconnects or calls `releaseSlot()`, the next waiter is promoted automatically. You'll receive a `onSlotChange('active')` callback when promoted.
+
+## License
+
+Proprietary. See LICENSE for details.

package/dist/api.d.ts

@@ -0,0 +1,12 @@
+import type { User, Event, Ticket } from './types';
+export declare class ApiClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly timeoutMs;
+    constructor(baseUrl: string, apiKey: string);
+    getMe(): Promise<User>;
+    getEvents(): Promise<Event[]>;
+    getTicket(eventId: string): Promise<Ticket>;
+    private request;
+}
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAanD,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAMrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,SAAS,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAI7B,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAInC,OAAO;CA+BtB"}

package/dist/api.js

@@ -0,0 +1,50 @@
+import { CONNECTION_DEFAULTS } from './constants';
+export class ApiClient {
+    baseUrl;
+    apiKey;
+    timeoutMs;
+    constructor(baseUrl, apiKey) {
+        this.baseUrl = baseUrl.replace(/\/+$/, '');
+        this.apiKey = apiKey;
+        this.timeoutMs = CONNECTION_DEFAULTS.REQUEST_TIMEOUT_MS;
+    }
+    async getMe() {
+        return this.request('GET', '/api/v1/me');
+    }
+    async getEvents() {
+        return this.request('GET', '/api/v1/me/events');
+    }
+    async getTicket(eventId) {
+        return this.request('POST', `/api/v1/me/events/${eventId}/stream/ticket`);
+    }
+    async request(method, path) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const response = await fetch(`${this.baseUrl}${path}`, {
+                method,
+                headers: {
+                    'x-api-key': this.apiKey,
+                    'Content-Type': 'application/json',
+                },
+                signal: controller.signal,
+            });
+            const body = (await response.json());
+            if (!response.ok) {
+                const err = body;
+                throw new Error(err.error?.message ?? `HTTP ${response.status}`);
+            }
+            return body.data;
+        }
+        catch (error) {
+            if (error instanceof DOMException && error.name === 'AbortError') {
+                throw new Error(`Request timed out after ${this.timeoutMs}ms`);
+            }
+            throw error;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAclD,MAAM,OAAO,SAAS;IACH,OAAO,CAAS;IAChB,MAAM,CAAS;IACf,SAAS,CAAS;IAEnC,YAAY,OAAe,EAAE,MAAc;QACzC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,mBAAmB,CAAC,kBAAkB,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,KAAK;QACT,OAAO,IAAI,CAAC,OAAO,CAAO,KAAK,EAAE,YAAY,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC,OAAO,CAAU,KAAK,EAAE,mBAAmB,CAAC,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAe;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAS,MAAM,EAAE,qBAAqB,OAAO,gBAAgB,CAAC,CAAC;IACpF,CAAC;IAEO,KAAK,CAAC,OAAO,CAAI,MAAc,EAAE,IAAY;QACnD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAEnE,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,EAAE;gBACrD,MAAM;gBACN,OAAO,EAAE;oBACP,WAAW,EAAE,IAAI,CAAC,MAAM;oBACxB,cAAc,EAAE,kBAAkB;iBACnC;gBACD,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA6C,CAAC;YAEjF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,GAAG,GAAG,IAAwB,CAAC;gBACrC,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,IAAI,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YACnE,CAAC;YAED,OAAQ,IAA8B,CAAC,IAAI,CAAC;QAC9C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBACjE,MAAM,IAAI,KAAK,CAAC,2BAA2B,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;YACjE,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;CACF"}

package/dist/client.d.ts

@@ -0,0 +1,39 @@
+import type { CaitDeskConfig, User, Event, ConnectionStatus, SlotStatus } from './types';
+export declare class CaitDeskClient {
+    private readonly api;
+    private ws;
+    private eventId;
+    private readonly config;
+    constructor(config: CaitDeskConfig);
+    /** Current WebSocket connection status */
+    get status(): ConnectionStatus;
+    /** Current slot status (active, waiting, or unknown) */
+    get slotStatus(): SlotStatus;
+    /** Get the authenticated user's info */
+    getMe(): Promise<User>;
+    /** List events assigned to the authenticated user as captioner */
+    getEvents(): Promise<Event[]>;
+    /** Connect to an event's WebSocket gateway */
+    connect(eventId: string): Promise<void>;
+    /** Disconnect from the WebSocket gateway */
+    disconnect(): void;
+    /** Append text to the current caption stream */
+    append(text: string): void;
+    /** Delete characters from the end of the caption stream */
+    delete(count: number): void;
+    /** Sync the full caption text state (used for reconnection or full-text edits) */
+    sync(text: string): void;
+    /** Start the event (transitions from scheduled to live) */
+    start(): void;
+    /** Stop the event (transitions from live to ended) */
+    stop(): void;
+    /** Pause caption display */
+    pause(): void;
+    /** Resume caption display */
+    resume(): void;
+    /** Release the active slot to the next waiting captioner */
+    releaseSlot(): void;
+    private sendControl;
+    private requireConnection;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,cAAc,EACd,IAAI,EACJ,KAAK,EACL,gBAAgB,EAChB,UAAU,EAEX,MAAM,SAAS,CAAC;AAIjB,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAY;IAChC,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;gBAE5B,MAAM,EAAE,cAAc;IAKlC,0CAA0C;IAC1C,IAAI,MAAM,IAAI,gBAAgB,CAE7B;IAED,wDAAwD;IACxD,IAAI,UAAU,IAAI,UAAU,CAE3B;IAMD,wCAAwC;IAClC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,kEAAkE;IAC5D,SAAS,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAQnC,8CAA8C;IACxC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB7C,4CAA4C;IAC5C,UAAU,IAAI,IAAI;IAUlB,gDAAgD;IAChD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQ1B,2DAA2D;IAC3D,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQ3B,kFAAkF;IAClF,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAYxB,2DAA2D;IAC3D,KAAK,IAAI,IAAI;IAIb,sDAAsD;IACtD,IAAI,IAAI,IAAI;IAIZ,4BAA4B;IAC5B,KAAK,IAAI,IAAI;IAIb,6BAA6B;IAC7B,MAAM,IAAI,IAAI;IAQd,4DAA4D;IAC5D,WAAW,IAAI,IAAI;IASnB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,iBAAiB;CAM1B"}

package/dist/client.js

@@ -0,0 +1,127 @@
+import { CONTROL_ACTION, RATE_LIMITS } from './constants';
+import { ApiClient } from './api';
+import { WsClient } from './ws';
+const noop = () => { };
+export class CaitDeskClient {
+    api;
+    ws = null;
+    eventId = null;
+    config;
+    constructor(config) {
+        this.config = config;
+        this.api = new ApiClient(config.apiUrl, config.apiKey);
+    }
+    /** Current WebSocket connection status */
+    get status() {
+        return this.ws?.status ?? 'disconnected';
+    }
+    /** Current slot status (active, waiting, or unknown) */
+    get slotStatus() {
+        return this.ws?.slotStatus ?? 'unknown';
+    }
+    // -----------------------------------------------------------------------
+    // REST
+    // -----------------------------------------------------------------------
+    /** Get the authenticated user's info */
+    async getMe() {
+        return this.api.getMe();
+    }
+    /** List events assigned to the authenticated user as captioner */
+    async getEvents() {
+        return this.api.getEvents();
+    }
+    // -----------------------------------------------------------------------
+    // Connection
+    // -----------------------------------------------------------------------
+    /** Connect to an event's WebSocket gateway */
+    async connect(eventId) {
+        this.ws?.disconnect();
+        this.eventId = eventId;
+        const ticket = await this.api.getTicket(eventId);
+        this.ws = new WsClient({
+            onStatusChange: this.config.onStatusChange ?? noop,
+            onSlotChange: this.config.onSlotChange ?? noop,
+            onCaptionAck: this.config.onCaptionAck ?? noop,
+            onControlAck: this.config.onControlAck ?? noop,
+            onError: this.config.onError ?? noop,
+            onEventEnded: this.config.onEventEnded ?? noop,
+            onWaitingCountChange: this.config.onWaitingCountChange ?? noop,
+            refreshTicket: () => this.api.getTicket(eventId),
+        });
+        this.ws.connect(ticket);
+    }
+    /** Disconnect from the WebSocket gateway */
+    disconnect() {
+        this.ws?.disconnect();
+        this.ws = null;
+        this.eventId = null;
+    }
+    // -----------------------------------------------------------------------
+    // Captions
+    // -----------------------------------------------------------------------
+    /** Append text to the current caption stream */
+    append(text) {
+        const { ws, eventId } = this.requireConnection();
+        if (text.length > RATE_LIMITS.MAX_APPEND_LENGTH) {
+            throw new Error(`Text length ${text.length} exceeds maximum of ${RATE_LIMITS.MAX_APPEND_LENGTH}`);
+        }
+        ws.send({ type: 'append', eventId, timestamp: Date.now(), text });
+    }
+    /** Delete characters from the end of the caption stream */
+    delete(count) {
+        const { ws, eventId } = this.requireConnection();
+        if (count > RATE_LIMITS.MAX_DELETE_COUNT) {
+            throw new Error(`Delete count ${count} exceeds maximum of ${RATE_LIMITS.MAX_DELETE_COUNT}`);
+        }
+        ws.send({ type: 'delete', eventId, timestamp: Date.now(), count });
+    }
+    /** Sync the full caption text state (used for reconnection or full-text edits) */
+    sync(text) {
+        const { ws, eventId } = this.requireConnection();
+        if (text.length > RATE_LIMITS.MAX_SYNC_LENGTH) {
+            throw new Error(`Text length ${text.length} exceeds maximum of ${RATE_LIMITS.MAX_SYNC_LENGTH}`);
+        }
+        ws.send({ type: 'sync', eventId, timestamp: Date.now(), text });
+    }
+    // -----------------------------------------------------------------------
+    // Event control
+    // -----------------------------------------------------------------------
+    /** Start the event (transitions from scheduled to live) */
+    start() {
+        this.sendControl(CONTROL_ACTION.START);
+    }
+    /** Stop the event (transitions from live to ended) */
+    stop() {
+        this.sendControl(CONTROL_ACTION.STOP);
+    }
+    /** Pause caption display */
+    pause() {
+        this.sendControl(CONTROL_ACTION.PAUSE);
+    }
+    /** Resume caption display */
+    resume() {
+        this.sendControl(CONTROL_ACTION.RESUME);
+    }
+    // -----------------------------------------------------------------------
+    // Slot management
+    // -----------------------------------------------------------------------
+    /** Release the active slot to the next waiting captioner */
+    releaseSlot() {
+        const { ws } = this.requireConnection();
+        ws.releaseSlot();
+    }
+    // -----------------------------------------------------------------------
+    // Private
+    // -----------------------------------------------------------------------
+    sendControl(action) {
+        const { ws, eventId } = this.requireConnection();
+        ws.send({ type: 'control', eventId, action });
+    }
+    requireConnection() {
+        if (!this.ws || !this.eventId || this.ws.status === 'disconnected') {
+            throw new Error('Not connected. Call connect(eventId) first.');
+        }
+        return { ws: this.ws, eventId: this.eventId };
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/constants.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Protocol constants inlined from @caitdesk/shared.
+ * Keep in sync with packages/shared/src/constants/.
+ */
+/** Session actions (gateway <-> captioner slot management) */
+export declare const SESSION_ACTION: {
+    readonly SLOT_GRANTED: "slot:granted";
+    readonly SLOT_OCCUPIED: "slot:occupied";
+    readonly SLOT_REQUESTED: "slot:requested";
+    readonly SLOT_REQUEST_CANCELLED: "slot:request_cancelled";
+    readonly SLOT_RELEASE: "slot:release";
+};
+/** Control actions sent by captioner to manage event state */
+export declare const CONTROL_ACTION: {
+    readonly START: "event:start";
+    readonly STOP: "event:stop";
+    readonly PAUSE: "event:pause";
+    readonly RESUME: "event:resume";
+};
+/** Error codes returned by the API and gateway */
+export declare const ERROR_CODE: {
+    readonly UNAUTHORIZED: "UNAUTHORIZED";
+    readonly FORBIDDEN: "FORBIDDEN";
+    readonly NOT_FOUND: "NOT_FOUND";
+    readonly GONE: "GONE";
+    readonly VALIDATION_ERROR: "VALIDATION_ERROR";
+    readonly RATE_LIMITED: "RATE_LIMITED";
+    readonly INTERNAL_ERROR: "INTERNAL_ERROR";
+    readonly WS_AUTH_FAILED: "WS_AUTH_FAILED";
+    readonly WS_INVALID_MESSAGE: "WS_INVALID_MESSAGE";
+    readonly WS_EVENT_NOT_FOUND: "WS_EVENT_NOT_FOUND";
+    readonly WS_CONNECTION_ERROR: "WS_CONNECTION_ERROR";
+    readonly WS_SLOT_FULL: "WS_SLOT_FULL";
+    readonly WS_NOT_ACTIVE: "WS_NOT_ACTIVE";
+    readonly NETWORK_ERROR: "NETWORK_ERROR";
+};
+/** Rate limits enforced by the gateway */
+export declare const RATE_LIMITS: {
+    /** Maximum caption messages per second per connection */
+    readonly MAX_MESSAGES_PER_SECOND: 50;
+    /** Maximum text length for append messages */
+    readonly MAX_APPEND_LENGTH: 10000;
+    /** Maximum text length for sync messages */
+    readonly MAX_SYNC_LENGTH: 100000;
+    /** Maximum delete count */
+    readonly MAX_DELETE_COUNT: 100000;
+    /** Allowed timestamp drift in milliseconds (±30s) */
+    readonly MAX_TIMESTAMP_DRIFT_MS: 30000;
+};
+/** Default connection parameters */
+export declare const CONNECTION_DEFAULTS: {
+    /** Initial reconnect delay in ms */
+    readonly RECONNECT_DELAY_MS: 1000;
+    /** Maximum reconnect delay in ms */
+    readonly RECONNECT_DELAY_MAX_MS: 30000;
+    /** Reconnect delay multiplier (exponential backoff) */
+    readonly RECONNECT_MULTIPLIER: 1.5;
+    /** HTTP request timeout in ms */
+    readonly REQUEST_TIMEOUT_MS: 10000;
+};
+/** WebSocket close codes with special meaning */
+export declare const WS_CLOSE_CODE: {
+    /** Normal closure (event ended, slot released) */
+    readonly NORMAL: 1000;
+    /** Authentication failed — do not reconnect */
+    readonly AUTH_FAILED: 1008;
+    /** Slot queue full — do not reconnect */
+    readonly SLOT_FULL: 1013;
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,8DAA8D;AAC9D,eAAO,MAAM,cAAc;;;;;;CAMjB,CAAC;AAEX,8DAA8D;AAC9D,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC;AAEX,kDAAkD;AAClD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;CA4Bb,CAAC;AAEX,0CAA0C;AAC1C,eAAO,MAAM,WAAW;IACtB,yDAAyD;;IAEzD,8CAA8C;;IAE9C,4CAA4C;;IAE5C,2BAA2B;;IAE3B,qDAAqD;;CAE7C,CAAC;AAEX,oCAAoC;AACpC,eAAO,MAAM,mBAAmB;IAC9B,oCAAoC;;IAEpC,oCAAoC;;IAEpC,uDAAuD;;IAEvD,iCAAiC;;CAEzB,CAAC;AAEX,iDAAiD;AACjD,eAAO,MAAM,aAAa;IACxB,kDAAkD;;IAElD,+CAA+C;;IAE/C,yCAAyC;;CAEjC,CAAC"}

package/dist/constants.js

@@ -0,0 +1,77 @@
+/**
+ * Protocol constants inlined from @caitdesk/shared.
+ * Keep in sync with packages/shared/src/constants/.
+ */
+/** Session actions (gateway <-> captioner slot management) */
+export const SESSION_ACTION = {
+    SLOT_GRANTED: 'slot:granted',
+    SLOT_OCCUPIED: 'slot:occupied',
+    SLOT_REQUESTED: 'slot:requested',
+    SLOT_REQUEST_CANCELLED: 'slot:request_cancelled',
+    SLOT_RELEASE: 'slot:release',
+};
+/** Control actions sent by captioner to manage event state */
+export const CONTROL_ACTION = {
+    START: 'event:start',
+    STOP: 'event:stop',
+    PAUSE: 'event:pause',
+    RESUME: 'event:resume',
+};
+/** Error codes returned by the API and gateway */
+export const ERROR_CODE = {
+    // Auth
+    UNAUTHORIZED: 'UNAUTHORIZED',
+    FORBIDDEN: 'FORBIDDEN',
+    // Resource
+    NOT_FOUND: 'NOT_FOUND',
+    GONE: 'GONE',
+    // Validation
+    VALIDATION_ERROR: 'VALIDATION_ERROR',
+    // Rate limiting
+    RATE_LIMITED: 'RATE_LIMITED',
+    // Service
+    INTERNAL_ERROR: 'INTERNAL_ERROR',
+    // WebSocket
+    WS_AUTH_FAILED: 'WS_AUTH_FAILED',
+    WS_INVALID_MESSAGE: 'WS_INVALID_MESSAGE',
+    WS_EVENT_NOT_FOUND: 'WS_EVENT_NOT_FOUND',
+    WS_CONNECTION_ERROR: 'WS_CONNECTION_ERROR',
+    WS_SLOT_FULL: 'WS_SLOT_FULL',
+    WS_NOT_ACTIVE: 'WS_NOT_ACTIVE',
+    // Client-side
+    NETWORK_ERROR: 'NETWORK_ERROR',
+};
+/** Rate limits enforced by the gateway */
+export const RATE_LIMITS = {
+    /** Maximum caption messages per second per connection */
+    MAX_MESSAGES_PER_SECOND: 50,
+    /** Maximum text length for append messages */
+    MAX_APPEND_LENGTH: 10_000,
+    /** Maximum text length for sync messages */
+    MAX_SYNC_LENGTH: 100_000,
+    /** Maximum delete count */
+    MAX_DELETE_COUNT: 100_000,
+    /** Allowed timestamp drift in milliseconds (±30s) */
+    MAX_TIMESTAMP_DRIFT_MS: 30_000,
+};
+/** Default connection parameters */
+export const CONNECTION_DEFAULTS = {
+    /** Initial reconnect delay in ms */
+    RECONNECT_DELAY_MS: 1_000,
+    /** Maximum reconnect delay in ms */
+    RECONNECT_DELAY_MAX_MS: 30_000,
+    /** Reconnect delay multiplier (exponential backoff) */
+    RECONNECT_MULTIPLIER: 1.5,
+    /** HTTP request timeout in ms */
+    REQUEST_TIMEOUT_MS: 10_000,
+};
+/** WebSocket close codes with special meaning */
+export const WS_CLOSE_CODE = {
+    /** Normal closure (event ended, slot released) */
+    NORMAL: 1000,
+    /** Authentication failed — do not reconnect */
+    AUTH_FAILED: 1008,
+    /** Slot queue full — do not reconnect */
+    SLOT_FULL: 1013,
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,8DAA8D;AAC9D,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,YAAY,EAAE,cAAc;IAC5B,aAAa,EAAE,eAAe;IAC9B,cAAc,EAAE,gBAAgB;IAChC,sBAAsB,EAAE,wBAAwB;IAChD,YAAY,EAAE,cAAc;CACpB,CAAC;AAEX,8DAA8D;AAC9D,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,KAAK,EAAE,aAAa;IACpB,IAAI,EAAE,YAAY;IAClB,KAAK,EAAE,aAAa;IACpB,MAAM,EAAE,cAAc;CACd,CAAC;AAEX,kDAAkD;AAClD,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,OAAO;IACP,YAAY,EAAE,cAAc;IAC5B,SAAS,EAAE,WAAW;IAEtB,WAAW;IACX,SAAS,EAAE,WAAW;IACtB,IAAI,EAAE,MAAM;IAEZ,aAAa;IACb,gBAAgB,EAAE,kBAAkB;IAEpC,gBAAgB;IAChB,YAAY,EAAE,cAAc;IAE5B,UAAU;IACV,cAAc,EAAE,gBAAgB;IAEhC,YAAY;IACZ,cAAc,EAAE,gBAAgB;IAChC,kBAAkB,EAAE,oBAAoB;IACxC,kBAAkB,EAAE,oBAAoB;IACxC,mBAAmB,EAAE,qBAAqB;IAC1C,YAAY,EAAE,cAAc;IAC5B,aAAa,EAAE,eAAe;IAE9B,cAAc;IACd,aAAa,EAAE,eAAe;CACtB,CAAC;AAEX,0CAA0C;AAC1C,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,yDAAyD;IACzD,uBAAuB,EAAE,EAAE;IAC3B,8CAA8C;IAC9C,iBAAiB,EAAE,MAAM;IACzB,4CAA4C;IAC5C,eAAe,EAAE,OAAO;IACxB,2BAA2B;IAC3B,gBAAgB,EAAE,OAAO;IACzB,qDAAqD;IACrD,sBAAsB,EAAE,MAAM;CACtB,CAAC;AAEX,oCAAoC;AACpC,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,oCAAoC;IACpC,kBAAkB,EAAE,KAAK;IACzB,oCAAoC;IACpC,sBAAsB,EAAE,MAAM;IAC9B,uDAAuD;IACvD,oBAAoB,EAAE,GAAG;IACzB,iCAAiC;IACjC,kBAAkB,EAAE,MAAM;CAClB,CAAC;AAEX,iDAAiD;AACjD,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,kDAAkD;IAClD,MAAM,EAAE,IAAI;IACZ,+CAA+C;IAC/C,WAAW,EAAE,IAAI;IACjB,yCAAyC;IACzC,SAAS,EAAE,IAAI;CACP,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { CaitDeskClient } from './client';
+export type { CaitDeskConfig, User, Event, Ticket, ConnectionStatus, SlotStatus, SlotDetail, CaptionAck, ControlAck, ServerError, ControlActionValue, ErrorCodeValue, } from './types';
+export { ERROR_CODE, RATE_LIMITS, CONNECTION_DEFAULTS, SESSION_ACTION, CONTROL_ACTION, WS_CLOSE_CODE, } from './constants';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C,YAAY,EACV,cAAc,EACd,IAAI,EACJ,KAAK,EACL,MAAM,EACN,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,kBAAkB,EAClB,cAAc,GACf,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,UAAU,EACV,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,aAAa,GACd,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { CaitDeskClient } from './client';
+export { ERROR_CODE, RATE_LIMITS, CONNECTION_DEFAULTS, SESSION_ACTION, CONTROL_ACTION, WS_CLOSE_CODE, } from './constants';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAiB1C,OAAO,EACL,UAAU,EACV,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,aAAa,GACd,MAAM,aAAa,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,127 @@
+import type { SESSION_ACTION, CONTROL_ACTION, ERROR_CODE } from './constants';
+export interface CaitDeskConfig {
+    /** Base URL of the CaitDesk API (e.g. "https://api.caitdesk.com") */
+    apiUrl: string;
+    /** API key for authentication (starts with "cait_sk_") */
+    apiKey: string;
+    /** Called when the WebSocket connection status changes */
+    onStatusChange?: (status: ConnectionStatus) => void;
+    /** Called when the slot status changes (active / waiting) */
+    onSlotChange?: (status: SlotStatus, detail?: SlotDetail) => void;
+    /** Called when a caption message is acknowledged by the server */
+    onCaptionAck?: (ack: CaptionAck) => void;
+    /** Called when a control action is acknowledged by the server */
+    onControlAck?: (ack: ControlAck) => void;
+    /** Called when the server reports an error */
+    onError?: (error: ServerError) => void;
+    /** Called when the event ends (server-initiated) */
+    onEventEnded?: (eventId: string) => void;
+    /** Called when the number of waiting captioners changes (active captioner only) */
+    onWaitingCountChange?: (count: number) => void;
+}
+export interface User {
+    id: string;
+    email: string;
+    name: string | null;
+}
+export interface Event {
+    id: string;
+    organizationId: string;
+    title: string;
+    description: string | null;
+    scheduledStart: string;
+    scheduledEnd: string | null;
+    status: string;
+    clientName: string | null;
+}
+export interface Ticket {
+    ticket: string;
+    expiresIn: number;
+    gatewayUrl: string;
+}
+export type ConnectionStatus = 'disconnected' | 'connecting' | 'connected' | 'reconnecting';
+export type SlotStatus = 'unknown' | 'active' | 'waiting';
+export interface SlotDetail {
+    /** Queue position (1-based, only when waiting) */
+    position?: number;
+    /** ISO timestamp of when the active captioner connected */
+    activeSince?: string;
+}
+export interface AppendMessage {
+    type: 'append';
+    eventId: string;
+    timestamp: number;
+    text: string;
+}
+export interface DeleteMessage {
+    type: 'delete';
+    eventId: string;
+    timestamp: number;
+    count: number;
+}
+export interface SyncMessage {
+    type: 'sync';
+    eventId: string;
+    timestamp: number;
+    text: string;
+}
+export interface ControlMessage {
+    type: 'control';
+    eventId: string;
+    action: ControlActionValue;
+}
+export interface SessionReleaseMessage {
+    type: 'session';
+    action: typeof SESSION_ACTION.SLOT_RELEASE;
+}
+export type OutgoingMessage = AppendMessage | DeleteMessage | SyncMessage | ControlMessage | SessionReleaseMessage;
+export interface ConnectedMessage {
+    type: 'connected';
+    eventId: string;
+    message: string;
+}
+export interface CaptionAck {
+    type: 'ack';
+    timestamp: number;
+    seq: number;
+}
+export interface ControlAck {
+    type: 'ack';
+    action: string;
+}
+export interface ServerError {
+    type: 'error';
+    code: ErrorCodeValue;
+    message: string;
+    details?: Record<string, unknown>;
+}
+export interface EventEndedMessage {
+    type: 'event_ended';
+    eventId: string;
+    message: string;
+}
+export interface SlotGrantedMessage {
+    type: 'session';
+    action: typeof SESSION_ACTION.SLOT_GRANTED;
+}
+export interface SlotOccupiedMessage {
+    type: 'session';
+    action: typeof SESSION_ACTION.SLOT_OCCUPIED;
+    position: number;
+    activeSince: string;
+}
+export interface SlotRequestedMessage {
+    type: 'session';
+    action: typeof SESSION_ACTION.SLOT_REQUESTED;
+    waitingCount: number;
+}
+export interface SlotRequestCancelledMessage {
+    type: 'session';
+    action: typeof SESSION_ACTION.SLOT_REQUEST_CANCELLED;
+    waitingCount: number;
+}
+export type SessionMessage = SlotGrantedMessage | SlotOccupiedMessage | SlotRequestedMessage | SlotRequestCancelledMessage;
+export type IncomingMessage = ConnectedMessage | CaptionAck | ControlAck | ServerError | EventEndedMessage | SessionMessage;
+export type ControlActionValue = (typeof CONTROL_ACTION)[keyof typeof CONTROL_ACTION];
+export type ErrorCodeValue = (typeof ERROR_CODE)[keyof typeof ERROR_CODE];
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/ws.d.ts

@@ -0,0 +1,38 @@
+import type { ConnectionStatus, SlotStatus, SlotDetail, CaptionAck, ControlAck, ServerError, Ticket } from './types';
+export interface WsClientCallbacks {
+    onStatusChange: (status: ConnectionStatus) => void;
+    onSlotChange: (status: SlotStatus, detail?: SlotDetail) => void;
+    onCaptionAck: (ack: CaptionAck) => void;
+    onControlAck: (ack: ControlAck) => void;
+    onError: (error: ServerError) => void;
+    onEventEnded: (eventId: string) => void;
+    onWaitingCountChange: (count: number) => void;
+    refreshTicket: () => Promise<Ticket>;
+}
+export declare class WsClient {
+    private ws;
+    private _status;
+    private _slotStatus;
+    private reconnectDelay;
+    private reconnectTimer;
+    private intentionalClose;
+    private gatewayUrl;
+    private ticket;
+    private readonly cb;
+    constructor(callbacks: WsClientCallbacks);
+    get status(): ConnectionStatus;
+    get slotStatus(): SlotStatus;
+    connect(ticket: Ticket): void;
+    disconnect(): void;
+    send(message: object): void;
+    releaseSlot(): void;
+    private openSocket;
+    private handleMessage;
+    private handleSession;
+    private handleClose;
+    private scheduleReconnect;
+    private clearReconnectTimer;
+    private setStatus;
+    private setSlotStatus;
+}
+//# sourceMappingURL=ws.d.ts.map

package/dist/ws.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../src/ws.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,UAAU,EACV,UAAU,EAEV,UAAU,EACV,UAAU,EACV,WAAW,EAEX,MAAM,EACP,MAAM,SAAS,CAAC;AAcjB,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACnD,YAAY,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,UAAU,KAAK,IAAI,CAAC;IAChE,YAAY,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,CAAC;IACxC,YAAY,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,CAAC;IACxC,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IACtC,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,oBAAoB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,aAAa,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CACtC;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,cAAc,CAAkD;IACxE,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAoB;gBAE3B,SAAS,EAAE,iBAAiB;IAIxC,IAAI,MAAM,IAAI,gBAAgB,CAE7B;IAED,IAAI,UAAU,IAAI,UAAU,CAE3B;IAED,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAO7B,UAAU,IAAI,IAAI;IAWlB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM3B,WAAW,IAAI,IAAI;IAQnB,OAAO,CAAC,UAAU;IAyBlB,OAAO,CAAC,aAAa;IAuCrB,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,iBAAiB;IAwBzB,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,aAAa;CAOtB"}

package/dist/ws.js

@@ -0,0 +1,180 @@
+import { SESSION_ACTION, ERROR_CODE, CONNECTION_DEFAULTS, WS_CLOSE_CODE } from './constants';
+/** Terminal error codes that should not trigger reconnection */
+const TERMINAL_CODES = new Set([
+    ERROR_CODE.WS_AUTH_FAILED,
+    ERROR_CODE.WS_SLOT_FULL,
+]);
+/** Close codes that should not trigger reconnection */
+const TERMINAL_CLOSE_CODES = new Set([
+    WS_CLOSE_CODE.AUTH_FAILED,
+    WS_CLOSE_CODE.SLOT_FULL,
+]);
+export class WsClient {
+    ws = null;
+    _status = 'disconnected';
+    _slotStatus = 'unknown';
+    reconnectDelay = CONNECTION_DEFAULTS.RECONNECT_DELAY_MS;
+    reconnectTimer = null;
+    intentionalClose = false;
+    gatewayUrl = '';
+    ticket = '';
+    cb;
+    constructor(callbacks) {
+        this.cb = callbacks;
+    }
+    get status() {
+        return this._status;
+    }
+    get slotStatus() {
+        return this._slotStatus;
+    }
+    connect(ticket) {
+        this.intentionalClose = false;
+        this.gatewayUrl = ticket.gatewayUrl;
+        this.ticket = ticket.ticket;
+        this.openSocket();
+    }
+    disconnect() {
+        this.intentionalClose = true;
+        this.clearReconnectTimer();
+        if (this.ws) {
+            this.ws.close(1000);
+            this.ws = null;
+        }
+        this.setStatus('disconnected');
+        this.setSlotStatus('unknown');
+    }
+    send(message) {
+        if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+            this.ws.send(JSON.stringify(message));
+        }
+    }
+    releaseSlot() {
+        this.send({ type: 'session', action: SESSION_ACTION.SLOT_RELEASE });
+    }
+    // -----------------------------------------------------------------------
+    // Private
+    // -----------------------------------------------------------------------
+    openSocket() {
+        this.setStatus('connecting');
+        const url = new URL(this.gatewayUrl);
+        url.searchParams.set('ticket', this.ticket);
+        this.ws = new WebSocket(url.toString());
+        this.ws.onopen = () => {
+            this.reconnectDelay = CONNECTION_DEFAULTS.RECONNECT_DELAY_MS;
+            this.setStatus('connected');
+        };
+        this.ws.onmessage = (event) => {
+            this.handleMessage(event.data);
+        };
+        this.ws.onclose = (event) => {
+            this.handleClose(event);
+        };
+        this.ws.onerror = () => {
+            // The close event fires after error, which handles reconnection
+        };
+    }
+    handleMessage(data) {
+        let msg;
+        try {
+            msg = JSON.parse(data);
+        }
+        catch {
+            return;
+        }
+        switch (msg.type) {
+            case 'connected':
+                // Connection confirmed, status already set in onopen
+                break;
+            case 'session':
+                this.handleSession(msg);
+                break;
+            case 'ack':
+                if ('seq' in msg) {
+                    this.cb.onCaptionAck(msg);
+                }
+                else if ('action' in msg) {
+                    this.cb.onControlAck(msg);
+                }
+                break;
+            case 'error':
+                this.cb.onError(msg);
+                if (TERMINAL_CODES.has(msg.code)) {
+                    this.intentionalClose = true;
+                }
+                break;
+            case 'event_ended':
+                this.cb.onEventEnded(msg.eventId);
+                this.intentionalClose = true;
+                break;
+        }
+    }
+    handleSession(msg) {
+        switch (msg.action) {
+            case SESSION_ACTION.SLOT_GRANTED:
+                this.setSlotStatus('active');
+                break;
+            case SESSION_ACTION.SLOT_OCCUPIED:
+                this.setSlotStatus('waiting', {
+                    position: msg.position,
+                    activeSince: msg.activeSince,
+                });
+                break;
+            case SESSION_ACTION.SLOT_REQUESTED:
+            case SESSION_ACTION.SLOT_REQUEST_CANCELLED:
+                this.cb.onWaitingCountChange(msg.waitingCount);
+                break;
+        }
+    }
+    handleClose(event) {
+        this.ws = null;
+        if (this.intentionalClose || TERMINAL_CLOSE_CODES.has(event.code)) {
+            this.setStatus('disconnected');
+            this.setSlotStatus('unknown');
+            return;
+        }
+        // Attempt reconnection
+        this.setStatus('reconnecting');
+        this.scheduleReconnect();
+    }
+    scheduleReconnect() {
+        this.clearReconnectTimer();
+        this.reconnectTimer = setTimeout(async () => {
+            try {
+                const newTicket = await this.cb.refreshTicket();
+                this.ticket = newTicket.ticket;
+                this.gatewayUrl = newTicket.gatewayUrl;
+                this.openSocket();
+            }
+            catch {
+                this.cb.onError({
+                    type: 'error',
+                    code: ERROR_CODE.NETWORK_ERROR,
+                    message: 'Failed to refresh connection ticket',
+                });
+                this.reconnectDelay = Math.min(this.reconnectDelay * CONNECTION_DEFAULTS.RECONNECT_MULTIPLIER, CONNECTION_DEFAULTS.RECONNECT_DELAY_MAX_MS);
+                this.scheduleReconnect();
+            }
+        }, this.reconnectDelay);
+    }
+    clearReconnectTimer() {
+        if (this.reconnectTimer != null) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+    }
+    setStatus(status) {
+        if (this._status !== status) {
+            this._status = status;
+            this.cb.onStatusChange(status);
+        }
+    }
+    setSlotStatus(status, detail) {
+        const changed = this._slotStatus !== status;
+        this._slotStatus = status;
+        if (changed) {
+            this.cb.onSlotChange(status, detail);
+        }
+    }
+}
+//# sourceMappingURL=ws.js.map

package/dist/ws.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.js","sourceRoot":"","sources":["../src/ws.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@caitdesk/client",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Official TypeScript client for the CaitDesk captioner API",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "bun run build"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.2"
+  }
+}