@absolutejs/sync 1.7.6 → 1.7.7

package/dist/engine/mutation.d.ts

@@ -45,6 +45,28 @@ export type MutationActions = {
     delete: (table: string, row: unknown) => Promise<void>;
     /** Escape hatch: emit a change you persisted yourself (no writer call). */
     change: <T>(collection: string, change: RowChange<T>) => Promise<void>;
+    /**
+     * Wall-clock timestamp the handler should use instead of `Date.now()`.
+     * Returns a `number` (ms since epoch).
+     *
+     * Why an injected clock? Two forward-looking reasons:
+     *
+     *   1. **Replay / rebase determinism.** When the engine re-runs a
+     *      mutation against an updated state (Replicache-style mutator
+     *      replay), `actions.now()` returns the ORIGINAL call's timestamp
+     *      instead of the current wall clock. `Date.now()` would silently
+     *      diverge between client-optimistic and server-canonical runs;
+     *      `actions.now()` doesn't.
+     *
+     *   2. **Test determinism.** Test harnesses can pin time by passing a
+     *      custom `now()` through {@link MutationActions} — the handler
+     *      observes whatever the test wants.
+     *
+     * If the engine doesn't override it (the common case today), it just
+     * returns `Date.now()`. Use it everywhere you'd reach for
+     * `Date.now()` inside a mutation handler.
+     */
+    now: () => number;
 };
 export type MutationHandler<Args, Ctx, Result> = (args: Args, ctx: Ctx, actions: MutationActions) => Promise<Result> | Result;
 export type MutationDefinition<Args = unknown, Ctx = CollectionContext, Result = unknown> = {

package/dist/index.js

@@ -737,7 +737,8 @@ var wrap = (source) => `
 			insert: (table, data) => __dispatch(__callId, 'insert', table, data),
 			update: (table, data) => __dispatch(__callId, 'update', table, data),
 			delete: (table, row) => __dispatch(__callId, 'delete', table, row),
-			change: (collection, change) => __dispatch(__callId, 'change', collection, change)
+			change: (collection, change) => __dispatch(__callId, 'change', collection, change),
+			now: () => __dispatch(__callId, 'now')
 		};
 		return userFn(args, ctx, actions);
 	}
@@ -764,6 +765,8 @@ var compile = async (source, config) => {
         return a.delete(rest[0], rest[1]);
       case "change":
         return a.change(rest[0], rest[1]);
+      case "now":
+        return a.now();
       default:
         throw new Error(`unknown sandbox action op: ${String(op)}`);
     }
@@ -1286,7 +1289,8 @@ var createSyncEngine = (options = {}) => {
         }
         await writerFor(table).delete(row, ctx, tx);
         buffered.push({ table, change: { op: "delete", row } });
-      }
+      },
+      now: () => Date.now()
     };
     return { actions, buffered };
   };
@@ -2370,5 +2374,5 @@ export {
   createPresenceHub
 };
 
-//# debugId=9570274420A04D4164756E2164756E21
+//# debugId=0583BD887ED853F264756E2164756E21
 //# sourceMappingURL=index.js.map