@couch-kit/host 1.7.17 → 2.0.1

package/README.md

@@ -216,12 +216,19 @@ Records game actions with timestamps for session replay and debugging. Useful fo
 
 ```tsx
 import { useActionRecorder, useGameHost } from "@couch-kit/host";
+import type { GameAction } from "./shared/gameLogic";
 
 function GameScreen() {
-  const { state } = useGameHost();
+  const { state, dispatch } = useGameHost();
   const { isRecording, recordedCount, startRecording, stopRecording, recordAction } =
     useActionRecorder();
 
+  // Recording is not automatic: call recordAction for each action you dispatch.
+  const dispatchAndRecord = (action: GameAction) => {
+    dispatch(action);
+    recordAction(action);
+  };
+
   const handleStartRecording = () => startRecording(state);
   const handleStop = () => {
     const recording = stopRecording();
@@ -233,6 +240,7 @@ function GameScreen() {
     <View>
       <Text>Actions recorded: {recordedCount}</Text>
       <Button title={isRecording ? "Stop" : "Record"} onPress={isRecording ? handleStop : handleStartRecording} />
+      <Button title="Reset" onPress={() => dispatchAndRecord({ type: "RESET" })} />
     </View>
   );
 }
@@ -244,7 +252,9 @@ Returns:
 - `recordedCount`: number of actions captured so far
 - `startRecording(currentState, metadata?)`: begin recording from the given state
 - `stopRecording()`: end recording and return the `ActionRecording` object (or `null`)
-- `recordAction(action, state)`: capture a single action + resulting state
+- `recordAction(action)`: capture a single action with a timestamp. Nothing is recorded automatically — call it alongside `dispatch`. Resulting states are not stored; replay recomputes them from `initialState` and the reducer. No-op when no recording is active.
+- `exportRecording()`: the current recording as a JSON string (or `null`)
+- `discardRecording()`: drop the current recording and reset the count
 
 ### `getBestIpAddress()`
 

package/lib/server.d.ts.map

@@ -1 +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,WAAY,kBAAkB;;;;CAyEzD,CAAC"}
+{"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,WAAY,kBAAkB;;;;CA6FzD,CAAC"}

package/lib/websocket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../src/websocket.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAO/C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,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;AAOF,qBAAa,mBAAoB,SAAQ,YAAY,CAAC,qBAAqB,CAAC;IAC1E,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,OAAO,CAA2C;IAC1D,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,KAAK,CAAU;IACvB,OAAO,CAAC,eAAe,CAAS;IAEhC,YAAY,MAAM,EAAE,eAAe,EAUlC;IAED,OAAO,CAAC,GAAG;IAME,KAAK,kBAqGjB;IAEY,IAAI,kBAkBhB;IAED;;;OAGG;IACI,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,QAoB1C;IAED;;;OAGG;IACI,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,QAkBjD;IAED,yDAAyD;IACzD,IAAW,WAAW,IAAI,MAAM,CAE/B;CACF"}
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../src/websocket.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAO/C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,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;AAOF,qBAAa,mBAAoB,SAAQ,YAAY,CAAC,qBAAqB,CAAC;IAC1E,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,OAAO,CAA2C;IAC1D,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,KAAK,CAAU;IACvB,OAAO,CAAC,eAAe,CAAS;IAEhC,YAAY,MAAM,EAAE,eAAe,EASlC;IAED,OAAO,CAAC,GAAG;IAME,KAAK,kBAkGjB;IAEY,IAAI,kBAkBhB;IAED;;;OAGG;IACI,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,QAoB1C;IAED;;;OAGG;IACI,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,QAkBjD;IAED,yDAAyD;IACzD,IAAW,WAAW,IAAI,MAAM,CAE/B;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@couch-kit/host",
-  "version": "1.7.17",
+  "version": "2.0.1",
   "publishConfig": {
     "access": "public",
     "provenance": true
@@ -58,8 +58,8 @@
   },
   "dependencies": {
     "@couch-kit/core": "0.10.0",
-    "@couch-kit/runtime": "0.3.0",
-    "react-native-nitro-http-server": "~1.6.1"
+    "@couch-kit/runtime": "0.4.0",
+    "react-native-nitro-http-server": "^1.9.2"
   },
   "devDependencies": {
     "@happy-dom/global-registrator": "^20.10.6",
@@ -69,13 +69,14 @@
     "react": "19.3.0",
     "react-dom": "19.3.0",
     "react-native": "0.87.1",
+    "react-native-nitro-modules": "0.37.1",
     "del-cli": "^7.0.0",
     "jest": "^30.0.0"
   },
   "peerDependencies": {
     "react": ">=18.2.0",
     "react-native": ">=0.72.0",
-    "react-native-nitro-modules": ">=0.33.0",
+    "react-native-nitro-modules": ">=0.35.0",
     "expo": ">=51.0.0",
     "expo-file-system": ">=19.0.0",
     "expo-network": ">=7.0.0"

package/src/server.ts

@@ -29,13 +29,26 @@ export const useStaticServer = (config: CouchKitHostConfig) => {
 
   useEffect(() => {
     let server: StaticServer | null = null;
+    // Set by cleanup. Starting is asynchronous, so an effect that was torn down
+    // mid-start (a config change, StrictMode's double mount, an unmount) must
+    // neither publish its result nor leave its server holding the port.
+    let cancelled = false;
     setLoading(true);
+    setError(null);
+
+    const stop = (target: StaticServer | null) => {
+      if (!target) return;
+      void Promise.resolve(target.stop()).catch(() => {
+        // Nothing useful to do if a server we no longer want fails to stop.
+      });
+    };
 
     const startServer = async () => {
       // In Dev Mode, we don't start the static server.
       // We just resolve the IP so the host knows where it is.
       if (config.devMode && config.devServerUrl) {
         const ip = await getBestIpAddress();
+        if (cancelled) return;
         if (ip) {
           // In dev mode, the URL is the laptop's dev server,
           // but we might need the TV's IP for the WebSocket connection later.
@@ -65,13 +78,21 @@ export const useStaticServer = (config: CouchKitHostConfig) => {
         }
         const port = config.port || DEFAULT_HTTP_PORT;
 
-        server = new StaticServer();
+        const started = new StaticServer();
+        server = started;
 
         // Use '0.0.0.0' to bind to all interfaces (local network)
-        await server.start(port, path, "0.0.0.0");
+        await started.start(port, path, "0.0.0.0");
+        if (cancelled) {
+          // Cleanup ran while the server was still starting, when a stop may
+          // not have taken; stop it again now that it is actually up.
+          stop(started);
+          return;
+        }
 
         // We prefer the actual IP over "localhost" returned by some libs
         const ip = await getBestIpAddress();
+        if (cancelled) return;
         if (ip) {
           setUrl(`http://${ip}:${port}/index.html`);
         } else {
@@ -79,18 +100,17 @@ export const useStaticServer = (config: CouchKitHostConfig) => {
           setUrl(`http://localhost:${port}/index.html`);
         }
       } catch (e) {
-        setError(new Error(toErrorMessage(e)));
+        if (!cancelled) setError(new Error(toErrorMessage(e)));
       } finally {
-        setLoading(false);
+        if (!cancelled) setLoading(false);
       }
     };
 
     startServer();
 
     return () => {
-      if (server) {
-        server.stop();
-      }
+      cancelled = true;
+      stop(server);
     };
   }, [config.port, config.devMode, config.devServerUrl, config.staticDir]);
 

package/src/websocket.ts

@@ -73,8 +73,7 @@ export class GameWebSocketServer extends EventEmitter<WebSocketServerEvents> {
     super();
     this.port = config.port;
     this.debug = !!config.debug;
-    this.maxMessageBytes =
-      config.maxMessageBytes ?? DEFAULT_MAX_MESSAGE_BYTES;
+    this.maxMessageBytes = config.maxMessageBytes ?? DEFAULT_MAX_MESSAGE_BYTES;
     // Only `port`, `debug`, and `maxMessageBytes` are honored. `maxFrameSize`,
     // `keepaliveInterval`, and `keepaliveTimeout` are deprecated no-ops: the
     // nitro-http WebSocket transport does not expose these knobs, so they are
@@ -150,10 +149,7 @@ export class GameWebSocketServer extends EventEmitter<WebSocketServerEvents> {
         // Handle errors
         ws.onerror = (event: { message: string }) => {
           this.log(`[WebSocket] Error on ${socketId}:`, event.message);
-          this.emit(
-            "error",
-            new Error(`WebSocket error: ${event.message}`),
-          );
+          this.emit("error", new Error(`WebSocket error: ${event.message}`));
         };
       },
     );