@rotorsoft/act 1.6.0 → 1.7.0

package/dist/index.js

@@ -873,6 +873,29 @@ var subscribe = (streams) => store().subscribe(streams);
 
 // src/internal/event-sourcing.ts
 import { patch } from "@rotorsoft/act-patch";
+
+// src/internal/backoff.ts
+function computeBackoffDelay(retry, opts) {
+  if (!opts || opts.baseMs <= 0) return 0;
+  const r = Math.max(0, retry);
+  let delay;
+  switch (opts.strategy) {
+    case "fixed":
+      delay = opts.baseMs;
+      break;
+    case "linear":
+      delay = opts.baseMs * (r + 1);
+      break;
+    case "exponential":
+      delay = opts.baseMs * 2 ** r;
+      if (opts.maxMs !== void 0) delay = Math.min(delay, opts.maxMs);
+      break;
+  }
+  if (opts.jitter) delay = delay * (0.5 + Math.random());
+  return Math.max(0, Math.floor(delay));
+}
+
+// src/internal/event-sourcing.ts
 var DEFAULT_BATCH = 500;
 async function snap(snapshot) {
   try {
@@ -1080,113 +1103,126 @@ async function action(me, action2, target, payload, reactingTo, skipValidation =
   const { stream, expectedVersion, actor } = target;
   if (!stream) throw new Error("Missing target stream");
   const validated = skipValidation ? payload : validate(action2, payload, me.actions[action2]);
-  const snapshot = await load(me, stream);
-  if (snapshot.event?.name === TOMBSTONE_EVENT)
-    throw new StreamClosedError(stream);
-  const expected = expectedVersion ?? snapshot.event?.version;
-  if (me.given) {
-    const invariants = me.given[action2] || [];
-    invariants.forEach(({ valid, description }) => {
-      if (!valid(snapshot.state, actor))
-        throw new InvariantError(
-          action2,
-          validated,
-          target,
-          snapshot,
-          description
-        );
-    });
-  }
-  const result = me.on[action2](validated, snapshot, target);
-  if (!result) return [snapshot];
-  if (Array.isArray(result) && result.length === 0) {
-    return [snapshot];
-  }
-  const tuples = Array.isArray(result[0]) ? result : [result];
-  const deprecated = me._deprecated;
-  if (deprecated && deprecated.size > 0) {
-    const me_ = me;
-    const warned = me_._warned ?? (me_._warned = /* @__PURE__ */ new Set());
-    for (const [name] of tuples) {
-      const evt = name;
-      if (deprecated.has(evt) && !warned.has(evt)) {
-        warned.add(evt);
-        log().warn(
-          `Action "${String(action2)}" emitted deprecated event "${evt}". A newer version exists in the registry \u2014 update the action's .emit() to target the current version. (warned once per process)`
+  const opts = me.options?.[action2];
+  const maxRetries = opts?.maxRetries ?? 0;
+  for (let attempt = 0; ; attempt++) {
+    try {
+      const snapshot = await load(me, stream);
+      if (snapshot.event?.name === TOMBSTONE_EVENT)
+        throw new StreamClosedError(stream);
+      const expected = expectedVersion ?? snapshot.event?.version;
+      if (me.given) {
+        const invariants = me.given[action2] || [];
+        invariants.forEach(({ valid, description }) => {
+          if (!valid(snapshot.state, actor))
+            throw new InvariantError(
+              action2,
+              validated,
+              target,
+              snapshot,
+              description
+            );
+        });
+      }
+      const result = me.on[action2](validated, snapshot, target);
+      if (!result) return [snapshot];
+      if (Array.isArray(result) && result.length === 0) {
+        return [snapshot];
+      }
+      const tuples = Array.isArray(result[0]) ? result : [result];
+      const deprecated = me._deprecated;
+      if (deprecated && deprecated.size > 0) {
+        const me_ = me;
+        const warned = me_._warned ?? (me_._warned = /* @__PURE__ */ new Set());
+        for (const [name] of tuples) {
+          const evt = name;
+          if (deprecated.has(evt) && !warned.has(evt)) {
+            warned.add(evt);
+            log().warn(
+              `Action "${String(action2)}" emitted deprecated event "${evt}". A newer version exists in the registry \u2014 update the action's .emit() to target the current version. (warned once per process)`
+            );
+          }
+        }
+      }
+      const emitted = tuples.map(([name, data]) => ({
+        name,
+        data: skipValidation ? data : validate(name, data, me.events[name])
+      }));
+      const meta = {
+        correlation: reactingTo?.meta.correlation || correlator({
+          action: action2,
+          state: me.name,
+          stream,
+          actor: target.actor
+        }),
+        causation: {
+          action: {
+            name: action2,
+            ...target
+            // payload intentionally omitted: it can be large or contain PII,
+            // and callers correlate via the correlation id when they need it.
+          },
+          event: reactingTo ? {
+            id: reactingTo.id,
+            name: reactingTo.name,
+            stream: reactingTo.stream
+          } : void 0
+        }
+      };
+      let committed;
+      try {
+        committed = await store().commit(
+          stream,
+          emitted,
+          meta,
+          // Reactions skip optimistic concurrency: they always append against the
+          // current head. Stream leasing already serializes concurrent reactions,
+          // and forcing version checks here would turn ordinary catch-up into
+          // spurious retries.
+          reactingTo ? void 0 : expected
         );
+      } catch (error) {
+        if (error instanceof ConcurrencyError) {
+          await cache().invalidate(stream);
+        }
+        throw error;
+      }
+      let { state: state2, patches } = snapshot;
+      const snapshots = committed.map((event) => {
+        const p = me.patch[event.name](event, state2);
+        state2 = patch(state2, p);
+        patches++;
+        return {
+          event,
+          state: state2,
+          version: event.version,
+          patches,
+          snaps: snapshot.snaps,
+          patch: p,
+          cache_hit: snapshot.cache_hit,
+          replayed: snapshot.replayed
+        };
+      });
+      const last = snapshots.at(-1);
+      const snapped = me.snap?.(last);
+      cache().set(stream, {
+        state: last.state,
+        version: last.event.version,
+        event_id: last.event.id,
+        patches: snapped ? 0 : last.patches,
+        snaps: snapped ? last.snaps + 1 : last.snaps
+      }).catch((err) => log().error(err));
+      if (snapped) void snap(last);
+      return snapshots;
+    } catch (error) {
+      if (!(error instanceof ConcurrencyError)) throw error;
+      if (attempt >= maxRetries) throw error;
+      if (opts?.backoff) {
+        const delayMs = computeBackoffDelay(attempt, opts.backoff);
+        if (delayMs > 0) await sleep(delayMs);
       }
     }
   }
-  const emitted = tuples.map(([name, data]) => ({
-    name,
-    data: skipValidation ? data : validate(name, data, me.events[name])
-  }));
-  const meta = {
-    correlation: reactingTo?.meta.correlation || correlator({
-      action: action2,
-      state: me.name,
-      stream,
-      actor: target.actor
-    }),
-    causation: {
-      action: {
-        name: action2,
-        ...target
-        // payload intentionally omitted: it can be large or contain PII,
-        // and callers correlate via the correlation id when they need it.
-      },
-      event: reactingTo ? {
-        id: reactingTo.id,
-        name: reactingTo.name,
-        stream: reactingTo.stream
-      } : void 0
-    }
-  };
-  let committed;
-  try {
-    committed = await store().commit(
-      stream,
-      emitted,
-      meta,
-      // Reactions skip optimistic concurrency: they always append against the
-      // current head. Stream leasing already serializes concurrent reactions,
-      // and forcing version checks here would turn ordinary catch-up into
-      // spurious retries.
-      reactingTo ? void 0 : expected
-    );
-  } catch (error) {
-    if (error instanceof ConcurrencyError) {
-      await cache().invalidate(stream);
-    }
-    throw error;
-  }
-  let { state: state2, patches } = snapshot;
-  const snapshots = committed.map((event) => {
-    const p = me.patch[event.name](event, state2);
-    state2 = patch(state2, p);
-    patches++;
-    return {
-      event,
-      state: state2,
-      version: event.version,
-      patches,
-      snaps: snapshot.snaps,
-      patch: p,
-      cache_hit: snapshot.cache_hit,
-      replayed: snapshot.replayed
-    };
-  });
-  const last = snapshots.at(-1);
-  const snapped = me.snap?.(last);
-  cache().set(stream, {
-    state: last.state,
-    version: last.event.version,
-    event_id: last.event.id,
-    patches: snapped ? 0 : last.patches,
-    snaps: snapped ? last.snaps + 1 : last.snaps
-  }).catch((err) => log().error(err));
-  if (snapped) void snap(last);
-  return snapshots;
 }
 
 // src/internal/tracing.ts
@@ -1720,27 +1756,6 @@ var _this_ = ({ stream }) => ({
   target: stream
 });
 
-// src/internal/backoff.ts
-function computeBackoffDelay(retry, opts) {
-  if (!opts || opts.baseMs <= 0) return 0;
-  const r = Math.max(0, retry);
-  let delay;
-  switch (opts.strategy) {
-    case "fixed":
-      delay = opts.baseMs;
-      break;
-    case "linear":
-      delay = opts.baseMs * (r + 1);
-      break;
-    case "exponential":
-      delay = opts.baseMs * 2 ** r;
-      if (opts.maxMs !== void 0) delay = Math.min(delay, opts.maxMs);
-      break;
-  }
-  if (opts.jitter) delay = delay * (0.5 + Math.random());
-  return Math.max(0, Math.floor(delay));
-}
-
 // src/internal/reactions.ts
 function finalize(lease, handled, at, error, options, logger, failed_at) {
   if (!error) return { lease, handled, acked_at: at };
@@ -3272,7 +3287,7 @@ function state(entry) {
 function action_builder(state2) {
   const internal = state2;
   const builder = {
-    on(entry) {
+    on(entry, options) {
       const keys = Object.keys(entry);
       if (keys.length !== 1) throw new Error(".on() requires exactly one key");
       const action2 = keys[0];
@@ -3280,6 +3295,10 @@ function action_builder(state2) {
       if (action2 in internal.actions)
         throw new Error(`Duplicate action "${action2}"`);
       internal.actions[action2] = schema;
+      if (options) {
+        internal.options ??= {};
+        internal.options[action2] = options;
+      }
       function given(rules) {
         internal.given ??= {};
         internal.given[action2] = rules;