@couch-kit/core 0.7.0 → 0.8.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @couch-kit/core
 
+## 0.8.0
+
+### Minor Changes
+
+- [#21](https://github.com/faluciano/react-native-couch-kit/pull/21) [`f1e836d`](https://github.com/faluciano/react-native-couch-kit/commit/f1e836d8f17821f0da20db7c3c552552c9b22133) Thanks [@faluciano](https://github.com/faluciano)! - Add `replayActions` utility function for replaying recorded game sessions against a reducer. Includes `Recording`, `RecordedAction`, `StateSnapshot`, and `ReplayResult` types.
+
 ## 0.7.0
 
 ### Minor Changes

package/dist/index.js

@@ -200,8 +200,31 @@ function toErrorMessage(error) {
     return error.message;
   return String(error);
 }
+// src/replay.ts
+function replayActions(recording, reducer) {
+  const snapshots = [];
+  let currentState = recording.initialState;
+  for (let i = 0;i < recording.actions.length; i++) {
+    const { action, timestamp } = recording.actions[i];
+    currentState = reducer(currentState, action);
+    snapshots.push({
+      state: currentState,
+      action,
+      timestamp,
+      index: i
+    });
+  }
+  const endTimestamp = recording.endTimestamp ?? (recording.actions.length > 0 ? recording.actions[recording.actions.length - 1].timestamp : recording.startTimestamp);
+  return {
+    finalState: currentState,
+    snapshots,
+    duration: endTimestamp - recording.startTimestamp,
+    actionCount: recording.actions.length
+  };
+}
 export {
   toErrorMessage,
+  replayActions,
   isValidSecret,
   generateId,
   derivePlayerIdLegacy,

package/lib/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./types";
 export * from "./protocol";
 export * from "./constants";
+export * from "./replay";
 export * from "./middleware";
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

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

package/lib/replay.d.ts

@@ -0,0 +1,42 @@
+import type { GameReducer, IAction, IGameState } from "./types";
+/**
+ * A recorded action with timing metadata.
+ */
+export interface RecordedAction<A extends IAction = IAction> {
+    action: A;
+    timestamp: number;
+}
+/**
+ * A snapshot of state at a point in time during replay.
+ */
+export interface StateSnapshot<S extends IGameState = IGameState> {
+    state: S;
+    action: IAction;
+    timestamp: number;
+    index: number;
+}
+/**
+ * A recording that can be replayed against a reducer.
+ */
+export interface Recording<S extends IGameState = IGameState, A extends IAction = IAction> {
+    initialState: S;
+    actions: RecordedAction<A>[];
+    startTimestamp: number;
+    endTimestamp?: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * The result of replaying a recording.
+ */
+export interface ReplayResult<S extends IGameState = IGameState> {
+    finalState: S;
+    snapshots: StateSnapshot<S>[];
+    duration: number;
+    actionCount: number;
+}
+/**
+ * Replays a recording against a reducer, producing the final state
+ * and intermediate snapshots for each action applied.
+ */
+export declare function replayActions<S extends IGameState = IGameState, A extends IAction = IAction>(recording: Recording<S, A>, reducer: GameReducer<S, A>): ReplayResult<S>;
+//# sourceMappingURL=replay.d.ts.map

package/lib/replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../src/replay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEhE;;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,aAAa,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU;IAC9D,KAAK,EAAE,CAAC,CAAC;IACT,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,SAAS,CACxB,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,YAAY,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU;IAC7D,UAAU,EAAE,CAAC,CAAC;IACd,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,CAAC,SAAS,UAAU,GAAG,UAAU,EACjC,CAAC,SAAS,OAAO,GAAG,OAAO,EAC3B,SAAS,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CA4BzE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@couch-kit/core",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "publishConfig": {
     "access": "public",
     "provenance": true

package/src/index.ts

@@ -1,4 +1,5 @@
 export * from "./types";
 export * from "./protocol";
 export * from "./constants";
+export * from "./replay";
 export * from "./middleware";

package/src/replay.ts

@@ -0,0 +1,80 @@
+import type { GameReducer, IAction, IGameState } from "./types";
+
+/**
+ * A recorded action with timing metadata.
+ */
+export interface RecordedAction<A extends IAction = IAction> {
+  action: A;
+  timestamp: number;
+}
+
+/**
+ * A snapshot of state at a point in time during replay.
+ */
+export interface StateSnapshot<S extends IGameState = IGameState> {
+  state: S;
+  action: IAction;
+  timestamp: number;
+  index: number;
+}
+
+/**
+ * A recording that can be replayed against a reducer.
+ */
+export interface Recording<
+  S extends IGameState = IGameState,
+  A extends IAction = IAction,
+> {
+  initialState: S;
+  actions: RecordedAction<A>[];
+  startTimestamp: number;
+  endTimestamp?: number;
+  metadata?: Record<string, unknown>;
+}
+
+/**
+ * The result of replaying a recording.
+ */
+export interface ReplayResult<S extends IGameState = IGameState> {
+  finalState: S;
+  snapshots: StateSnapshot<S>[];
+  duration: number;
+  actionCount: number;
+}
+
+/**
+ * Replays a recording against a reducer, producing the final state
+ * and intermediate snapshots for each action applied.
+ */
+export function replayActions<
+  S extends IGameState = IGameState,
+  A extends IAction = IAction,
+>(recording: Recording<S, A>, reducer: GameReducer<S, A>): ReplayResult<S> {
+  const snapshots: StateSnapshot<S>[] = [];
+  let currentState = recording.initialState;
+
+  for (let i = 0; i < recording.actions.length; i++) {
+    const { action, timestamp } = recording.actions[i];
+    currentState = reducer(currentState, action);
+
+    snapshots.push({
+      state: currentState,
+      action,
+      timestamp,
+      index: i,
+    });
+  }
+
+  const endTimestamp =
+    recording.endTimestamp ??
+    (recording.actions.length > 0
+      ? recording.actions[recording.actions.length - 1].timestamp
+      : recording.startTimestamp);
+
+  return {
+    finalState: currentState,
+    snapshots,
+    duration: endTimestamp - recording.startTimestamp,
+    actionCount: recording.actions.length,
+  };
+}