@couch-kit/host 1.1.2 → 1.2.1

package/lib/assets.d.ts

@@ -0,0 +1,28 @@
+export interface AssetManifest {
+    files: string[];
+}
+export interface ExtractAssetsResult {
+    /** The filesystem path to the extracted www directory, or undefined if not ready */
+    staticDir: string | undefined;
+    /** Whether extraction is in progress */
+    loading: boolean;
+    /** Error message if extraction failed */
+    error: string | null;
+}
+/**
+ * Extracts bundled web assets from the APK to the filesystem so the native
+ * HTTP server can serve them.
+ *
+ * On Android, assets live inside the APK and cannot be served directly by
+ * a native HTTP server. This hook copies each file listed in the manifest
+ * from `asset:///www/<file>` to `<Paths.document>/www/<file>`.
+ *
+ * On iOS, assets are accessible from the bundle directory, so extraction
+ * is skipped and `staticDir` is returned as `undefined` (the server falls
+ * back to the bundle path).
+ *
+ * @param manifest - The asset manifest generated by `couch-kit bundle`.
+ *                   Contains a `files` array listing all relative paths.
+ */
+export declare function useExtractAssets(manifest: AssetManifest): ExtractAssetsResult;
+//# sourceMappingURL=assets.d.ts.map

package/lib/assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../src/assets.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,oFAAoF;IACpF,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,yCAAyC;IACzC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,aAAa,GAAG,mBAAmB,CAyE7E"}

package/lib/buffer-utils.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Buffer management utilities for WebSocket per-client receive buffers.
+ * Extracted into a standalone module so they can be tested without
+ * react-native dependencies.
+ */
+import { Buffer } from "buffer";
+import type { TcpSocketInstance } from "./declarations";
+export interface ManagedSocket {
+    socket: TcpSocketInstance;
+    id: string;
+    isHandshakeComplete: boolean;
+    buffer: Buffer;
+    /** Number of valid bytes currently in `buffer` (may be less than buffer.length). */
+    bufferLength: number;
+    lastPong: number;
+}
+/**
+ * Append data to a managed socket's buffer, growing capacity geometrically
+ * to avoid re-allocation on every TCP data event.
+ */
+export declare function appendToBuffer(managed: ManagedSocket, data: Buffer): void;
+/**
+ * Compact the buffer by discarding consumed bytes from the front.
+ * If all data has been consumed, reset the length to 0 without re-allocating.
+ */
+export declare function compactBuffer(managed: ManagedSocket, consumed: number): void;
+//# sourceMappingURL=buffer-utils.d.ts.map

package/lib/buffer-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer-utils.d.ts","sourceRoot":"","sources":["../src/buffer-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGxD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,mBAAmB,EAAE,OAAO,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAazE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAS5E"}

package/lib/event-emitter.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Lightweight, type-safe EventEmitter implementation for cross-platform compatibility.
+ * Works in browser, React Native, and Node.js environments.
+ *
+ * @typeParam EventMap - A record mapping event names to their listener argument tuples.
+ *
+ * @example
+ * ```ts
+ * type MyEvents = {
+ *   data: [payload: string];
+ *   error: [err: Error];
+ *   close: [];
+ * };
+ * const emitter = new EventEmitter<MyEvents>();
+ * emitter.on("data", (payload) => { ... }); // payload is typed as string
+ * ```
+ */
+export declare class EventEmitter<EventMap extends Record<string, any[]> = Record<string, any[]>> {
+    private listeners;
+    on<K extends string & keyof EventMap>(event: K, listener: (...args: EventMap[K]) => void): this;
+    once<K extends string & keyof EventMap>(event: K, listener: (...args: EventMap[K]) => void): this;
+    off<K extends string & keyof EventMap>(event: K, listener: (...args: EventMap[K]) => void): this;
+    emit<K extends string & keyof EventMap>(event: K, ...args: EventMap[K]): boolean;
+    removeAllListeners<K extends string & keyof EventMap>(event?: K): this;
+    listenerCount<K extends string & keyof EventMap>(event: K): number;
+}
+//# sourceMappingURL=event-emitter.d.ts.map

package/lib/event-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-emitter.d.ts","sourceRoot":"","sources":["../src/event-emitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,qBAAa,YAAY,CACvB,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC;IAE9D,OAAO,CAAC,SAAS,CAA2D;IAG5E,EAAE,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,QAAQ,EAClC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,GACvC,IAAI;IAQP,IAAI,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,QAAQ,EACpC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,GACvC,IAAI;IASP,GAAG,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,QAAQ,EACnC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,GACvC,IAAI;IAWP,IAAI,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,QAAQ,EACpC,KAAK,EAAE,CAAC,EACR,GAAG,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,GACnB,OAAO;IAqBV,kBAAkB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI;IAStE,aAAa,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,QAAQ,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM;CAGnE"}

package/lib/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./provider";
+export * from "./server";
+export * from "./websocket";
+export * from "./network";
+export * from "./assets";
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}

package/lib/network.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Smart IP Discovery
+ * Prioritizes interfaces that are likely to be the main network (WiFi/Ethernet)
+ * over internal/virtual interfaces.
+ */
+export declare function getBestIpAddress(): Promise<string | null>;
+//# sourceMappingURL=network.d.ts.map

package/lib/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../src/network.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAa/D"}

package/lib/provider.d.ts

@@ -0,0 +1,57 @@
+import React from "react";
+import { type IGameState, type IAction } from "@couch-kit/core";
+export interface GameHostConfig<S extends IGameState, A extends IAction> {
+    initialState: S;
+    reducer: (state: S, action: A) => S;
+    port?: number;
+    wsPort?: number;
+    devMode?: boolean;
+    devServerUrl?: string;
+    staticDir?: string;
+    debug?: boolean;
+    /** Called when a player successfully joins. */
+    onPlayerJoined?: (playerId: string, name: string) => void;
+    /** Called when a player disconnects. */
+    onPlayerLeft?: (playerId: string) => void;
+    /** Called when a server error occurs. */
+    onError?: (error: Error) => void;
+}
+interface GameHostContextValue<S extends IGameState, A extends IAction> {
+    state: S;
+    dispatch: (action: A) => void;
+    serverUrl: string | null;
+    serverError: Error | null;
+}
+/**
+ * React context provider that turns a React Native TV app into a local game server.
+ *
+ * Starts a static file server (for the web controller) and a WebSocket game server
+ * (for real-time state sync). Manages the canonical game state using the provided
+ * reducer and broadcasts state updates to all connected clients.
+ *
+ * @param config - Host configuration including reducer, initial state, ports, and callbacks.
+ *
+ * @example
+ * ```tsx
+ * <GameHostProvider config={{ reducer: gameReducer, initialState }}>
+ *   <GameScreen />
+ * </GameHostProvider>
+ * ```
+ */
+export declare function GameHostProvider<S extends IGameState, A extends IAction>({ children, config, }: {
+    children: React.ReactNode;
+    config: GameHostConfig<S, A>;
+}): React.JSX.Element;
+/**
+ * React hook to access the game host context.
+ *
+ * Must be used within a `<GameHostProvider>`. Returns the canonical game state,
+ * a dispatch function for actions, the server URL (for QR codes), and any
+ * server startup errors.
+ *
+ * @returns An object with `state`, `dispatch`, `serverUrl`, and `serverError`.
+ * @throws If used outside of a `<GameHostProvider>`.
+ */
+export declare function useGameHost<S extends IGameState, A extends IAction>(): GameHostContextValue<S, A>;
+export {};
+//# sourceMappingURL=provider.d.ts.map

package/lib/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAQN,MAAM,OAAO,CAAC;AAGf,OAAO,EAML,KAAK,UAAU,EACf,KAAK,OAAO,EAGb,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,UAAU,EAAE,CAAC,SAAS,OAAO;IACrE,YAAY,EAAE,CAAC,CAAC;IAChB,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1D,wCAAwC;IACxC,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,yCAAyC;IACzC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,UAAU,oBAAoB,CAAC,CAAC,SAAS,UAAU,EAAE,CAAC,SAAS,OAAO;IACpE,KAAK,EAAE,CAAC,CAAC;IACT,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,CAAC;IAC9B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,KAAK,GAAG,IAAI,CAAC;CAC3B;AA4CD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,UAAU,EAAE,CAAC,SAAS,OAAO,EAAE,EACxE,QAAQ,EACR,MAAM,GACP,EAAE;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,MAAM,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CAC9B,qBA+NA;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,UAAU,EAAE,CAAC,SAAS,OAAO,KAK/C,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,CAC7C"}

package/lib/server.d.ts

@@ -0,0 +1,23 @@
+export interface CouchKitHostConfig {
+    port?: number;
+    devMode?: boolean;
+    devServerUrl?: string;
+    staticDir?: string;
+}
+/**
+ * React hook that manages a static HTTP file server for serving the web controller.
+ *
+ * In production mode, starts a `StaticServer` bound to `0.0.0.0` on the configured port,
+ * serving files from `staticDir` (or the iOS bundle directory + `/www` by default).
+ * On Android, `staticDir` must be provided since bundle assets live inside the APK.
+ * In dev mode, skips the server and returns `devServerUrl` directly.
+ *
+ * @param config - Server configuration including port, dev mode, and static directory.
+ * @returns An object with `url` (the server URL or null), `error`, and `loading`.
+ */
+export declare const useStaticServer: (config: CouchKitHostConfig) => {
+    url: string | null;
+    error: Error | null;
+    loading: boolean;
+};
+//# sourceMappingURL=server.d.ts.map

package/lib/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,kBAAkB;;;;CAgEzD,CAAC"}

package/lib/websocket.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Lightweight WebSocket Server Implementation
+ * Built on top of react-native-tcp-socket
+ *
+ * Supports: text frames, close frames, ping/pong, multi-frame TCP packets,
+ * server-side keepalive, frame size limits, and robust buffer management per RFC 6455.
+ */
+import { EventEmitter } from "./event-emitter";
+export interface WebSocketConfig {
+    port: number;
+    debug?: boolean;
+    /** Maximum allowed frame payload size in bytes (default: 1 MB). */
+    maxFrameSize?: number;
+    /** Interval (ms) between server-side keepalive pings (default: 30s). 0 disables. */
+    keepaliveInterval?: number;
+    /** Timeout (ms) to wait for a pong after a keepalive ping (default: 10s). */
+    keepaliveTimeout?: number;
+}
+/** Event map for type-safe event emission. */
+export type WebSocketServerEvents = {
+    connection: [socketId: string];
+    message: [socketId: string, message: unknown];
+    disconnect: [socketId: string];
+    listening: [port: number];
+    error: [error: Error];
+};
+export declare class GameWebSocketServer extends EventEmitter<WebSocketServerEvents> {
+    private server;
+    private clients;
+    private port;
+    private debug;
+    private maxFrameSize;
+    private keepaliveInterval;
+    private keepaliveTimeout;
+    private keepaliveTimer;
+    constructor(config: WebSocketConfig);
+    private log;
+    start(): void;
+    private startKeepalive;
+    private processFrames;
+    /**
+     * Gracefully stop the server.
+     * Sends close frames to all clients before destroying connections.
+     */
+    stop(): void;
+    /**
+     * Send data to a specific client by socket ID.
+     * Silently ignores unknown socket IDs and write errors.
+     */
+    send(socketId: string, data: unknown): void;
+    /**
+     * Broadcast data to all connected clients.
+     * Wraps each write in try/catch so a single dead socket doesn't skip remaining clients.
+     */
+    broadcast(data: unknown, excludeId?: string): void;
+    /** Returns the number of currently connected clients. */
+    get clientCount(): number;
+    private handleHandshake;
+    private generateAcceptKey;
+    private decodeFrame;
+    private encodeFrame;
+    private encodeControlFrame;
+    private buildFrame;
+}
+//# sourceMappingURL=websocket.d.ts.map

package/lib/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../src/websocket.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAY/C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oFAAoF;IACpF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,8CAA8C;AAC9C,MAAM,MAAM,qBAAqB,GAAG;IAClC,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC9C,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC/B,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1B,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;CACvB,CAAC;AAwBF,qBAAa,mBAAoB,SAAQ,YAAY,CAAC,qBAAqB,CAAC;IAC1E,OAAO,CAAC,MAAM,CAA0D;IACxE,OAAO,CAAC,OAAO,CAAyC;IACxD,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,KAAK,CAAU;IACvB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,cAAc,CAA+C;gBAEzD,MAAM,EAAE,eAAe;IASnC,OAAO,CAAC,GAAG;IAMJ,KAAK;IAkFZ,OAAO,CAAC,cAAc;IAkCtB,OAAO,CAAC,aAAa;IAyGrB;;;OAGG;IACI,IAAI;IAqCX;;;OAGG;IACI,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO;IAgB3C;;;OAGG;IACI,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM;IAclD,yDAAyD;IACzD,IAAW,WAAW,IAAI,MAAM,CAE/B;IAID,OAAO,CAAC,eAAe;IAkDvB,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,WAAW;IA4DnB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,UAAU;CA2BnB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@couch-kit/host",
-  "version": "1.1.2",
+  "version": "1.2.1",
   "description": "React Native host for local multiplayer party games on Android TV — WebSocket server, state management, and static file serving",
   "license": "MIT",
   "repository": {
@@ -19,13 +19,17 @@
     "local-multiplayer",
     "game-host"
   ],
-  "main": "src/index.tsx",
+  "main": "lib/index.d.ts",
+  "types": "lib/index.d.ts",
   "react-native": "src/index.tsx",
   "source": "src/index.tsx",
   "exports": {
     ".": {
-      "react-native": "./src/index.tsx",
-      "types": "./src/index.tsx",
+      "react-native": {
+        "types": "./lib/index.d.ts",
+        "default": "./src/index.tsx"
+      },
+      "types": "./lib/index.d.ts",
       "default": "./src/index.tsx"
     }
   },
@@ -39,10 +43,12 @@
     "!**/__mocks__"
   ],
   "scripts": {
+    "build": "tsc -p tsconfig.build.json",
     "test": "bun test",
     "typecheck": "tsc --noEmit",
     "lint": "eslint \"**/*.{js,ts,tsx}\"",
-    "clean": "del-cli lib"
+    "clean": "del-cli lib",
+    "prepublishOnly": "bun run build"
   },
   "dependencies": {
     "@couch-kit/core": "0.3.3",