@couch-kit/core 0.7.0 → 0.8.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @couch-kit/core
 
+## 0.8.1
+
+### Patch Changes
+
+- [#27](https://github.com/faluciano/react-native-couch-kit/pull/27) [`4976357`](https://github.com/faluciano/react-native-couch-kit/commit/49763573df502e394d5591b73000f48ee711d7a8) Thanks [@faluciano](https://github.com/faluciano)! - Fix WebSocket connection failure caused by path mismatch: the client connected to `ws://host:8082` (root path `/`) while the server only accepted upgrades on `/ws`. Added shared `DEFAULT_WS_PATH` constant to `@couch-kit/core` and use it in both client URL construction and server handler registration.
+
+## 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

@@ -161,6 +161,7 @@ var MessageTypes = {
 // src/constants.ts
 var DEFAULT_HTTP_PORT = 8080;
 var DEFAULT_WS_PORT_OFFSET = 2;
+var DEFAULT_WS_PATH = "/ws";
 var MAX_FRAME_SIZE = 1024 * 1024;
 var DEFAULT_MAX_RETRIES = 5;
 var DEFAULT_BASE_DELAY = 1000;
@@ -200,8 +201,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,
@@ -217,6 +241,7 @@ export {
   KEEPALIVE_INTERVAL,
   InternalActionTypes,
   DEFAULT_WS_PORT_OFFSET,
+  DEFAULT_WS_PATH,
   DEFAULT_SYNC_INTERVAL,
   DEFAULT_MAX_RETRIES,
   DEFAULT_MAX_DELAY,

package/lib/constants.d.ts

@@ -3,6 +3,8 @@
 export declare const DEFAULT_HTTP_PORT = 8080;
 /** Default WebSocket port offset from the HTTP port (skips Metro on +1). */
 export declare const DEFAULT_WS_PORT_OFFSET = 2;
+/** Default WebSocket endpoint path on the host server. */
+export declare const DEFAULT_WS_PATH = "/ws";
 /** @deprecated Not used by Couch Kit internals. Will be removed in the next major version. */
 export declare const MAX_FRAME_SIZE: number;
 /** Default maximum reconnection attempts for the client. */

package/lib/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,wDAAwD;AAExD,oDAAoD;AACpD,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,4EAA4E;AAC5E,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,8FAA8F;AAC9F,eAAO,MAAM,cAAc,QAAc,CAAC;AAE1C,4DAA4D;AAC5D,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,oEAAoE;AACpE,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC,+DAA+D;AAC/D,eAAO,MAAM,iBAAiB,QAAQ,CAAC;AAEvC,4CAA4C;AAC5C,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAE1C,0DAA0D;AAC1D,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,+EAA+E;AAC/E,eAAO,MAAM,0BAA0B,QAAgB,CAAC;AAExD,8FAA8F;AAC9F,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AAExC,8FAA8F;AAC9F,eAAO,MAAM,iBAAiB,QAAQ,CAAC;AAEvC;;;;;GAKG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAwBnC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAGrD;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOpE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGrD"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,wDAAwD;AAExD,oDAAoD;AACpD,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,4EAA4E;AAC5E,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,0DAA0D;AAC1D,eAAO,MAAM,eAAe,QAAQ,CAAC;AAErC,8FAA8F;AAC9F,eAAO,MAAM,cAAc,QAAc,CAAC;AAE1C,4DAA4D;AAC5D,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,oEAAoE;AACpE,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC,+DAA+D;AAC/D,eAAO,MAAM,iBAAiB,QAAQ,CAAC;AAEvC,4CAA4C;AAC5C,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAE1C,0DAA0D;AAC1D,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,+EAA+E;AAC/E,eAAO,MAAM,0BAA0B,QAAgB,CAAC;AAExD,8FAA8F;AAC9F,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AAExC,8FAA8F;AAC9F,eAAO,MAAM,iBAAiB,QAAQ,CAAC;AAEvC;;;;;GAKG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAwBnC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAGrD;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOpE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGrD"}

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.1",
   "publishConfig": {
     "access": "public",
     "provenance": true

package/src/constants.ts

@@ -6,6 +6,9 @@ export const DEFAULT_HTTP_PORT = 8080;
 /** Default WebSocket port offset from the HTTP port (skips Metro on +1). */
 export const DEFAULT_WS_PORT_OFFSET = 2;
 
+/** Default WebSocket endpoint path on the host server. */
+export const DEFAULT_WS_PATH = "/ws";
+
 /** @deprecated Not used by Couch Kit internals. Will be removed in the next major version. */
 export const MAX_FRAME_SIZE = 1024 * 1024;
 

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,
+  };
+}