@couch-kit/host 1.5.1 → 1.6.0

package/lib/action-recorder.d.ts

@@ -0,0 +1,43 @@
+import type { IAction, IGameState } from "@couch-kit/core";
+/**
+ * A recorded action with timing metadata.
+ */
+export interface RecordedAction<A extends IAction = IAction> {
+    action: A;
+    timestamp: number;
+}
+/**
+ * A complete recording of a game session.
+ */
+export interface ActionRecording<S extends IGameState = IGameState, A extends IAction = IAction> {
+    initialState: S;
+    actions: RecordedAction<A>[];
+    startTimestamp: number;
+    endTimestamp?: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Return type of useActionRecorder.
+ */
+export interface ActionRecorderControls<S extends IGameState = IGameState, A extends IAction = IAction> {
+    /** Whether recording is currently active */
+    isRecording: boolean;
+    /** Number of actions recorded so far */
+    recordedCount: number;
+    /** Start recording actions. Captures current state as initial state. */
+    startRecording: (currentState: S, metadata?: Record<string, unknown>) => void;
+    /** Stop recording and return the recording */
+    stopRecording: () => ActionRecording<S, A> | null;
+    /** Record a single action (call this when dispatching) */
+    recordAction: (action: A) => void;
+    /** Export the current recording as JSON string */
+    exportRecording: () => string | null;
+    /** Discard the current recording */
+    discardRecording: () => void;
+}
+/**
+ * Hook that enables recording of game actions for later replay.
+ * Used on the host side to capture game sessions.
+ */
+export declare function useActionRecorder<S extends IGameState = IGameState, A extends IAction = IAction>(): ActionRecorderControls<S, A>;
+//# sourceMappingURL=action-recorder.d.ts.map

package/lib/action-recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-recorder.d.ts","sourceRoot":"","sources":["../src/action-recorder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO;IACzD,MAAM,EAAE,CAAC,CAAC;IACV,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAC9B,CAAC,SAAS,UAAU,GAAG,UAAU,EACjC,CAAC,SAAS,OAAO,GAAG,OAAO;IAE3B,YAAY,EAAE,CAAC,CAAC;IAChB,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB,CACrC,CAAC,SAAS,UAAU,GAAG,UAAU,EACjC,CAAC,SAAS,OAAO,GAAG,OAAO;IAE3B,4CAA4C;IAC5C,WAAW,EAAE,OAAO,CAAC;IACrB,wCAAwC;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,cAAc,EAAE,CAAC,YAAY,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAC9E,8CAA8C;IAC9C,aAAa,EAAE,MAAM,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IAClD,0DAA0D;IAC1D,YAAY,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,CAAC;IAClC,kDAAkD;IAClD,eAAe,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACrC,oCAAoC;IACpC,gBAAgB,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,CAAC,SAAS,UAAU,GAAG,UAAU,EACjC,CAAC,SAAS,OAAO,GAAG,OAAO,KACxB,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC,CA0DhC"}

package/lib/index.d.ts

@@ -3,4 +3,5 @@ export * from "./server";
 export * from "./websocket";
 export * from "./network";
 export * from "./assets";
+export * from "./action-recorder";
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +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"}
+{"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;AACzB,cAAc,mBAAmB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@couch-kit/host",
-  "version": "1.5.1",
+  "version": "1.6.0",
   "publishConfig": {
     "access": "public",
     "provenance": true
@@ -55,7 +55,7 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@couch-kit/core": "0.7.0",
+    "@couch-kit/core": "0.8.0",
     "buffer": "^6.0.3",
     "js-sha1": "^0.7.0",
     "react-native-nitro-http-server": "^1.5.4"

package/src/action-recorder.ts

@@ -0,0 +1,114 @@
+import { useCallback, useRef, useState } from "react";
+import type { IAction, IGameState } from "@couch-kit/core";
+
+/**
+ * A recorded action with timing metadata.
+ */
+export interface RecordedAction<A extends IAction = IAction> {
+  action: A;
+  timestamp: number;
+}
+
+/**
+ * A complete recording of a game session.
+ */
+export interface ActionRecording<
+  S extends IGameState = IGameState,
+  A extends IAction = IAction,
+> {
+  initialState: S;
+  actions: RecordedAction<A>[];
+  startTimestamp: number;
+  endTimestamp?: number;
+  metadata?: Record<string, unknown>;
+}
+
+/**
+ * Return type of useActionRecorder.
+ */
+export interface ActionRecorderControls<
+  S extends IGameState = IGameState,
+  A extends IAction = IAction,
+> {
+  /** Whether recording is currently active */
+  isRecording: boolean;
+  /** Number of actions recorded so far */
+  recordedCount: number;
+  /** Start recording actions. Captures current state as initial state. */
+  startRecording: (currentState: S, metadata?: Record<string, unknown>) => void;
+  /** Stop recording and return the recording */
+  stopRecording: () => ActionRecording<S, A> | null;
+  /** Record a single action (call this when dispatching) */
+  recordAction: (action: A) => void;
+  /** Export the current recording as JSON string */
+  exportRecording: () => string | null;
+  /** Discard the current recording */
+  discardRecording: () => void;
+}
+
+/**
+ * Hook that enables recording of game actions for later replay.
+ * Used on the host side to capture game sessions.
+ */
+export function useActionRecorder<
+  S extends IGameState = IGameState,
+  A extends IAction = IAction,
+>(): ActionRecorderControls<S, A> {
+  const [isRecording, setIsRecording] = useState(false);
+  const [recordedCount, setRecordedCount] = useState(0);
+  const recordingRef = useRef<ActionRecording<S, A> | null>(null);
+
+  const startRecording = useCallback(
+    (currentState: S, metadata?: Record<string, unknown>) => {
+      recordingRef.current = {
+        initialState: currentState,
+        actions: [],
+        startTimestamp: Date.now(),
+        metadata,
+      };
+      setIsRecording(true);
+      setRecordedCount(0);
+    },
+    [],
+  );
+
+  const stopRecording = useCallback((): ActionRecording<S, A> | null => {
+    if (!recordingRef.current) return null;
+
+    recordingRef.current.endTimestamp = Date.now();
+    const recording = recordingRef.current;
+    setIsRecording(false);
+    return recording;
+  }, []);
+
+  const recordAction = useCallback((action: A) => {
+    if (!recordingRef.current) return;
+
+    recordingRef.current.actions.push({
+      action,
+      timestamp: Date.now(),
+    });
+    setRecordedCount((c) => c + 1);
+  }, []);
+
+  const exportRecording = useCallback((): string | null => {
+    if (!recordingRef.current) return null;
+    return JSON.stringify(recordingRef.current, null, 2);
+  }, []);
+
+  const discardRecording = useCallback(() => {
+    recordingRef.current = null;
+    setIsRecording(false);
+    setRecordedCount(0);
+  }, []);
+
+  return {
+    isRecording,
+    recordedCount,
+    startRecording,
+    stopRecording,
+    recordAction,
+    exportRecording,
+    discardRecording,
+  };
+}

package/src/index.tsx

@@ -3,3 +3,4 @@ export * from "./server";
 export * from "./websocket";
 export * from "./network";
 export * from "./assets";
+export * from "./action-recorder";