@couch-kit/core 0.9.3 → 0.10.1

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # @couch-kit/core
 
+## 0.10.1
+
+### Patch Changes
+
+- [#208](https://github.com/faluciano/react-native-couch-kit/pull/208) [`99598d6`](https://github.com/faluciano/react-native-couch-kit/commit/99598d6796b0bd3042aa9f3fbd3bf44ee891b890) Thanks [@faluciano](https://github.com/faluciano)! - `replayActions` wraps the reducer it is given with `createGameReducer`. A recording that contains internal actions (`__PLAYER_JOINED__` and the others a host recorder captures) now replays the way it ran. Before, those actions were silently ignored, because a game's own reducer does not handle them. Passing a reducer that is already wrapped is harmless.
+
+## 0.10.0
+
+### Minor Changes
+
+- [#164](https://github.com/faluciano/react-native-couch-kit/pull/164) [`a157126`](https://github.com/faluciano/react-native-couch-kit/commit/a157126424e4d73dcc7185118d5be0db6719792e) Thanks [@faluciano](https://github.com/faluciano)! - Back the time-sync ping off to 30s once the clock estimate settles
+
+  `useGameClient`'s clock sync pinged every 5 seconds for the life of the
+  connection. It now starts there and doubles to a 30-second ceiling
+  (`MAX_SYNC_INTERVAL`), resetting to the fast interval whenever a new socket is
+  established, including after a reconnect.
+
+  The first few pings are what converge the offset; the clock difference they
+  measure does not drift on a human timescale, so the fast interval stops earning
+  its cost within about a minute. On a relay transport it is not free: each ping
+  is a message in and a `PONG` back out, and pings are the only traffic an idle
+  table generates at all. A four-player lobby went from 5,760 relay messages an
+  hour to under 1,000 while sitting untouched.
+
+  `rtt` and `getServerTime()` are unchanged in accuracy — both are updated by the
+  same `PONG` handling as before, just less often once settled. Games needing the
+  old cadence can dispatch their own pings; the constants
+  (`DEFAULT_SYNC_INTERVAL`, `MAX_SYNC_INTERVAL`, `SYNC_BACKOFF_FACTOR`) are
+  exported from `@couch-kit/core`.
+
 ## 0.9.3
 
 ### Patch Changes

package/dist/index.cjs

@@ -39,30 +39,32 @@ var __export = (target, all) => {
 // src/index.ts
 var exports_src = {};
 __export(exports_src, {
-  toErrorMessage: () => toErrorMessage,
-  replayActions: () => replayActions,
-  isValidSecret: () => isValidSecret,
-  generateId: () => generateId,
-  derivePlayerIdLegacy: () => derivePlayerIdLegacy,
-  derivePlayerId: () => derivePlayerId,
-  createGameReducer: () => createGameReducer,
-  applyMiddleware: () => applyMiddleware,
-  actionValidator: () => actionValidator,
-  actionLogger: () => actionLogger,
-  MessageTypes: () => MessageTypes,
-  MAX_PENDING_PINGS: () => MAX_PENDING_PINGS,
-  MAX_FRAME_SIZE: () => MAX_FRAME_SIZE,
-  KEEPALIVE_TIMEOUT: () => KEEPALIVE_TIMEOUT,
-  KEEPALIVE_INTERVAL: () => KEEPALIVE_INTERVAL,
-  InternalActionTypes: () => InternalActionTypes,
-  DEFAULT_WS_PORT_OFFSET: () => DEFAULT_WS_PORT_OFFSET,
-  DEFAULT_WS_PATH: () => DEFAULT_WS_PATH,
-  DEFAULT_SYNC_INTERVAL: () => DEFAULT_SYNC_INTERVAL,
-  DEFAULT_MAX_RETRIES: () => DEFAULT_MAX_RETRIES,
-  DEFAULT_MAX_DELAY: () => DEFAULT_MAX_DELAY,
-  DEFAULT_HTTP_PORT: () => DEFAULT_HTTP_PORT,
+  DEFAULT_BASE_DELAY: () => DEFAULT_BASE_DELAY,
   DEFAULT_DISCONNECT_TIMEOUT: () => DEFAULT_DISCONNECT_TIMEOUT,
-  DEFAULT_BASE_DELAY: () => DEFAULT_BASE_DELAY
+  DEFAULT_HTTP_PORT: () => DEFAULT_HTTP_PORT,
+  DEFAULT_MAX_DELAY: () => DEFAULT_MAX_DELAY,
+  DEFAULT_MAX_RETRIES: () => DEFAULT_MAX_RETRIES,
+  DEFAULT_SYNC_INTERVAL: () => DEFAULT_SYNC_INTERVAL,
+  DEFAULT_WS_PATH: () => DEFAULT_WS_PATH,
+  DEFAULT_WS_PORT_OFFSET: () => DEFAULT_WS_PORT_OFFSET,
+  InternalActionTypes: () => InternalActionTypes,
+  KEEPALIVE_INTERVAL: () => KEEPALIVE_INTERVAL,
+  KEEPALIVE_TIMEOUT: () => KEEPALIVE_TIMEOUT,
+  MAX_FRAME_SIZE: () => MAX_FRAME_SIZE,
+  MAX_PENDING_PINGS: () => MAX_PENDING_PINGS,
+  MAX_SYNC_INTERVAL: () => MAX_SYNC_INTERVAL,
+  MessageTypes: () => MessageTypes,
+  SYNC_BACKOFF_FACTOR: () => SYNC_BACKOFF_FACTOR,
+  actionLogger: () => actionLogger,
+  actionValidator: () => actionValidator,
+  applyMiddleware: () => applyMiddleware,
+  createGameReducer: () => createGameReducer,
+  derivePlayerId: () => derivePlayerId,
+  derivePlayerIdLegacy: () => derivePlayerIdLegacy,
+  generateId: () => generateId,
+  isValidSecret: () => isValidSecret,
+  replayActions: () => replayActions,
+  toErrorMessage: () => toErrorMessage
 });
 module.exports = __toCommonJS(exports_src);
 
@@ -378,6 +380,8 @@ var DEFAULT_MAX_RETRIES = 5;
 var DEFAULT_BASE_DELAY = 1000;
 var DEFAULT_MAX_DELAY = 1e4;
 var DEFAULT_SYNC_INTERVAL = 5000;
+var MAX_SYNC_INTERVAL = 30000;
+var SYNC_BACKOFF_FACTOR = 2;
 var MAX_PENDING_PINGS = 50;
 var DEFAULT_DISCONNECT_TIMEOUT = 5 * 60 * 1000;
 var KEEPALIVE_INTERVAL = 30000;
@@ -389,7 +393,7 @@ function generateId() {
   if (typeof globalThis.crypto !== "undefined" && typeof globalThis.crypto.getRandomValues === "function") {
     const bytes = new Uint8Array(16);
     globalThis.crypto.getRandomValues(bytes);
-    return Array.from(bytes).map((b2) => b2.toString(16).padStart(2, "0")).join("");
+    return Array.from(bytes).map((b) => b.toString(16).padStart(2, "0")).join("");
   }
   const a = Math.random().toString(36).substring(2, 15);
   const b = Math.random().toString(36).substring(2, 10);
@@ -418,10 +422,11 @@ function toErrorMessage(error) {
 // src/replay.ts
 function replayActions(recording, reducer) {
   const snapshots = [];
+  const gameReducer = createGameReducer(reducer);
   let currentState = recording.initialState;
   for (let i = 0;i < recording.actions.length; i++) {
     const { action, timestamp } = recording.actions[i];
-    currentState = reducer(currentState, action);
+    currentState = gameReducer(currentState, action);
     snapshots.push({
       state: currentState,
       action,

package/dist/index.js

@@ -310,6 +310,8 @@ var DEFAULT_MAX_RETRIES = 5;
 var DEFAULT_BASE_DELAY = 1000;
 var DEFAULT_MAX_DELAY = 1e4;
 var DEFAULT_SYNC_INTERVAL = 5000;
+var MAX_SYNC_INTERVAL = 30000;
+var SYNC_BACKOFF_FACTOR = 2;
 var MAX_PENDING_PINGS = 50;
 var DEFAULT_DISCONNECT_TIMEOUT = 5 * 60 * 1000;
 var KEEPALIVE_INTERVAL = 30000;
@@ -321,7 +323,7 @@ function generateId() {
   if (typeof globalThis.crypto !== "undefined" && typeof globalThis.crypto.getRandomValues === "function") {
     const bytes = new Uint8Array(16);
     globalThis.crypto.getRandomValues(bytes);
-    return Array.from(bytes).map((b2) => b2.toString(16).padStart(2, "0")).join("");
+    return Array.from(bytes).map((b) => b.toString(16).padStart(2, "0")).join("");
   }
   const a = Math.random().toString(36).substring(2, 15);
   const b = Math.random().toString(36).substring(2, 10);
@@ -350,10 +352,11 @@ function toErrorMessage(error) {
 // src/replay.ts
 function replayActions(recording, reducer) {
   const snapshots = [];
+  const gameReducer = createGameReducer(reducer);
   let currentState = recording.initialState;
   for (let i = 0;i < recording.actions.length; i++) {
     const { action, timestamp } = recording.actions[i];
-    currentState = reducer(currentState, action);
+    currentState = gameReducer(currentState, action);
     snapshots.push({
       state: currentState,
       action,
@@ -370,28 +373,30 @@ function replayActions(recording, reducer) {
   };
 }
 export {
-  toErrorMessage,
-  replayActions,
-  isValidSecret,
-  generateId,
-  derivePlayerIdLegacy,
-  derivePlayerId,
-  createGameReducer,
-  applyMiddleware,
-  actionValidator,
-  actionLogger,
-  MessageTypes,
-  MAX_PENDING_PINGS,
-  MAX_FRAME_SIZE,
-  KEEPALIVE_TIMEOUT,
-  KEEPALIVE_INTERVAL,
-  InternalActionTypes,
-  DEFAULT_WS_PORT_OFFSET,
-  DEFAULT_WS_PATH,
-  DEFAULT_SYNC_INTERVAL,
-  DEFAULT_MAX_RETRIES,
-  DEFAULT_MAX_DELAY,
-  DEFAULT_HTTP_PORT,
+  DEFAULT_BASE_DELAY,
   DEFAULT_DISCONNECT_TIMEOUT,
-  DEFAULT_BASE_DELAY
+  DEFAULT_HTTP_PORT,
+  DEFAULT_MAX_DELAY,
+  DEFAULT_MAX_RETRIES,
+  DEFAULT_SYNC_INTERVAL,
+  DEFAULT_WS_PATH,
+  DEFAULT_WS_PORT_OFFSET,
+  InternalActionTypes,
+  KEEPALIVE_INTERVAL,
+  KEEPALIVE_TIMEOUT,
+  MAX_FRAME_SIZE,
+  MAX_PENDING_PINGS,
+  MAX_SYNC_INTERVAL,
+  MessageTypes,
+  SYNC_BACKOFF_FACTOR,
+  actionLogger,
+  actionValidator,
+  applyMiddleware,
+  createGameReducer,
+  derivePlayerId,
+  derivePlayerIdLegacy,
+  generateId,
+  isValidSecret,
+  replayActions,
+  toErrorMessage
 };

package/lib/constants.d.ts

@@ -13,8 +13,20 @@ export declare const DEFAULT_MAX_RETRIES = 5;
 export declare const DEFAULT_BASE_DELAY = 1000;
 /** Default maximum delay (ms) cap for reconnection backoff. */
 export declare const DEFAULT_MAX_DELAY = 10000;
-/** Default time sync ping interval (ms). */
+/** Default time sync ping interval (ms) — the interval a fresh socket starts at. */
 export declare const DEFAULT_SYNC_INTERVAL = 5000;
+/**
+ * Ceiling (ms) the time-sync interval backs off to once the clock estimate has
+ * settled.
+ *
+ * Pings are the only traffic an idle table generates, and on a relay transport
+ * every one of them is a billed message for the ping *and* the host's pong. The
+ * offset they measure is a clock difference that does not drift on a human
+ * timescale, so the fast interval only earns its cost right after connecting.
+ */
+export declare const MAX_SYNC_INTERVAL = 30000;
+/** Multiplier applied to the time-sync interval after each ping, up to {@link MAX_SYNC_INTERVAL}. */
+export declare const SYNC_BACKOFF_FACTOR = 2;
 /** Maximum number of outstanding pings before cleanup. */
 export declare const MAX_PENDING_PINGS = 50;
 /** Default timeout (ms) before a disconnected player is removed from state. */

package/lib/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,wDAAwD;AAIxD,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;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBpE;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;AAIxD,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,oFAAoF;AACpF,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAE1C;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,QAAQ,CAAC;AAEvC,qGAAqG;AACrG,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,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;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBpE;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/protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,aAAa,GACrB;IACE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5D,GACD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,CAAC;AAG7C,MAAM,MAAM,WAAW,GACnB;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CACnE,GACD;IACE,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CACrE,GACD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CACpE,GACD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAElE,eAAO,MAAM,YAAY;;;;;;;;;;CAaf,CAAC"}
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,aAAa,GACrB;IACE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5D,GACD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,CAAC;AAG7C,MAAM,MAAM,WAAW,GACnB;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CACnE,GACD;IACE,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CACrE,GACD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CACpE,GACD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAElE,eAAO,MAAM,YAAY;aAEvB,IAAI,EAAE,MAAM;aACZ,MAAM,EAAE,QAAQ;aAChB,IAAI,EAAE,MAAM;aACZ,aAAa,EAAE,eAAe;aAG9B,OAAO,EAAE,SAAS;aAClB,YAAY,EAAE,cAAc;aAC5B,IAAI,EAAE,MAAM;aACZ,WAAW,EAAE,aAAa;aAC1B,KAAK,EAAE,OAAO;CACN,CAAC"}

package/lib/replay.d.ts

@@ -37,6 +37,12 @@ export interface ReplayResult<S extends IGameState = IGameState> {
 /**
  * Replays a recording against a reducer, producing the final state
  * and intermediate snapshots for each action applied.
+ *
+ * Pass the game's own reducer, as given to the host. It is wrapped with
+ * {@link createGameReducer} here, so recordings that include internal actions
+ * (`__PLAYER_JOINED__` and friends, as a host recorder captures) replay the
+ * same way they ran. Wrapping an already-wrapped reducer is harmless: the outer
+ * layer handles internal actions and the inner never sees them.
  */
 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

@@ -1 +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,YAAY,CAAC;AAEnE;;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"}
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../src/replay.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEnE;;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;;;;;;;;;GASG;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,CA6BzE"}

package/lib/sha256.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sha256.d.ts","sourceRoot":"","sources":["../src/sha256.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAoDH;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAmGjD"}
+{"version":3,"file":"sha256.d.ts","sourceRoot":"","sources":["../src/sha256.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAoDH;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAiGjD"}

package/lib/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU,IACxD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,CAAC,CAAA;CAAE,GACnC;IACE,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACxD,GACD;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,wBAAwB,CAAC;IAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAElE,+CAA+C;AAC/C,eAAO,MAAM,mBAAmB;;;;;;CAMtB,CAAC;AAEX;;;;;GAKG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,UAAU,EAAE,CAAC,SAAS,OAAO,IAAI,CACjE,KAAK,EAAE,CAAC,EACR,MAAM,EAAE,CAAC,KACN,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU,IACxD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,CAAC,CAAA;CAAE,GACnC;IACE,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACxD,GACD;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,wBAAwB,CAAC;IAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAElE,+CAA+C;AAC/C,eAAO,MAAM,mBAAmB;aAC9B,OAAO,EAAE,aAAa;aACtB,aAAa,EAAE,mBAAmB;aAClC,WAAW,EAAE,iBAAiB;aAC9B,kBAAkB,EAAE,wBAAwB;aAC5C,cAAc,EAAE,oBAAoB;CAC5B,CAAC;AAEX;;;;;GAKG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,UAAU,EAAE,CAAC,SAAS,OAAO,IAAI,CACjE,KAAK,EAAE,CAAC,EACR,MAAM,EAAE,CAAC,KACN,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@couch-kit/core",
-  "version": "0.9.3",
+  "version": "0.10.1",
   "publishConfig": {
     "access": "public",
     "provenance": true
@@ -46,11 +46,10 @@
     "build": "bun build ./src/index.ts --outdir ./dist --target browser && bun build ./src/index.ts --outfile ./dist/index.cjs --target browser --format cjs && tsc -p tsconfig.build.json",
     "prepublishOnly": "bun run build",
     "test": "bun test",
-    "lint": "eslint src/",
     "typecheck": "tsc --noEmit",
     "clean": "rm -rf dist lib"
   },
   "devDependencies": {
-    "typescript": "^6.0.0"
+    "typescript": "^7.0.0"
   }
 }

package/src/constants.ts

@@ -23,9 +23,23 @@ export const DEFAULT_BASE_DELAY = 1000;
 /** Default maximum delay (ms) cap for reconnection backoff. */
 export const DEFAULT_MAX_DELAY = 10000;
 
-/** Default time sync ping interval (ms). */
+/** Default time sync ping interval (ms) — the interval a fresh socket starts at. */
 export const DEFAULT_SYNC_INTERVAL = 5000;
 
+/**
+ * Ceiling (ms) the time-sync interval backs off to once the clock estimate has
+ * settled.
+ *
+ * Pings are the only traffic an idle table generates, and on a relay transport
+ * every one of them is a billed message for the ping *and* the host's pong. The
+ * offset they measure is a clock difference that does not drift on a human
+ * timescale, so the fast interval only earns its cost right after connecting.
+ */
+export const MAX_SYNC_INTERVAL = 30000;
+
+/** Multiplier applied to the time-sync interval after each ping, up to {@link MAX_SYNC_INTERVAL}. */
+export const SYNC_BACKOFF_FACTOR = 2;
+
 /** Maximum number of outstanding pings before cleanup. */
 export const MAX_PENDING_PINGS = 50;
 

package/src/replay.ts

@@ -1,3 +1,4 @@
+import { createGameReducer } from "./reducer.js";
 import type { GameReducer, IAction, IGameState } from "./types.js";
 
 /**
@@ -45,17 +46,24 @@ export interface ReplayResult<S extends IGameState = IGameState> {
 /**
  * Replays a recording against a reducer, producing the final state
  * and intermediate snapshots for each action applied.
+ *
+ * Pass the game's own reducer, as given to the host. It is wrapped with
+ * {@link createGameReducer} here, so recordings that include internal actions
+ * (`__PLAYER_JOINED__` and friends, as a host recorder captures) replay the
+ * same way they ran. Wrapping an already-wrapped reducer is harmless: the outer
+ * layer handles internal actions and the inner never sees them.
  */
 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>[] = [];
+  const gameReducer = createGameReducer(reducer);
   let currentState = recording.initialState;
 
   for (let i = 0; i < recording.actions.length; i++) {
     const { action, timestamp } = recording.actions[i];
-    currentState = reducer(currentState, action);
+    currentState = gameReducer(currentState, action);
 
     snapshots.push({
       state: currentState,

package/src/sha256.ts

@@ -111,10 +111,8 @@ export function sha256Hex(message: string): string {
         0;
     }
     for (let i = 16; i < 64; i++) {
-      const s0 =
-        rotr(w[i - 15], 7) ^ rotr(w[i - 15], 18) ^ (w[i - 15] >>> 3);
-      const s1 =
-        rotr(w[i - 2], 17) ^ rotr(w[i - 2], 19) ^ (w[i - 2] >>> 10);
+      const s0 = rotr(w[i - 15], 7) ^ rotr(w[i - 15], 18) ^ (w[i - 15] >>> 3);
+      const s1 = rotr(w[i - 2], 17) ^ rotr(w[i - 2], 19) ^ (w[i - 2] >>> 10);
       w[i] = (w[i - 16] + s0 + w[i - 7] + s1) >>> 0;
     }