@rotorsoft/act 1.32.22 → 1.32.24

package/dist/@types/internal/event-sourcing.d.ts

@@ -1,190 +1,53 @@
 /**
- * @module event-sourcing
- * @category Internal
- *
- * Pure event-sourcing primitives: `snap` persists state checkpoints, `load`
- * reconstructs state by folding events through reducers, and `action`
- * validates an action, runs invariants, emits events, and commits them
- * atomically. `tombstone` commits the close-the-books guard with optimistic
- * concurrency.
- *
- * These are the bare implementations — observability is layered on top in
- * {@link "tracing"} and wired by the orchestrator at construction time.
- * No tracing imports here, no module-level mutable state.
- *
- * @internal
+ * Event-sourcing primitives: `snap`, `load`, `action`, `tombstone`, `scan`.
+ * Bare implementations; tracing wraps them in `tracing.ts`.
  */
 import { type Patch } from "@rotorsoft/act-patch";
 import type { Committed, DoOptions, EventSource, LoadTarget, ScanOptions, ScanResult, Schema, Schemas, Snapshot, State, Target } from "../types/index.js";
 /**
- * The reduction pipeline names three distinct things, and each word means
- * exactly one of them:
- *
- * - a **reducer** is a state's `.patch()` handler — it takes one event and
- *   returns a {@link Patch} *partial*;
- * - a **patch step** ({@link bare_patch} / {@link validating_patch}) merges
- *   that partial into the current state, yielding the next full state;
- * - the **fold** is the loop that applies the patch step across a stream's
- *   events (the reader loop in {@link load} / {@link action}, and the
- *   projection engine in {@link "projection-fold"}).
- *
- * `PatchFn` is the per-event patch step. The fold loop calls one of two
- * implementations, selected **once** at construction (in
- * {@link "tracing".build_es}) — never branched per event:
- *
- * - {@link bare_patch} — the default. Literally `patch(state, partial)`,
- *   no wrapper. No validation cost on the hot path.
- * - {@link validating_patch} — the opt-in `ActOptions.validateFoldedState`
- *   path. Merges, then parses the merged full state against the state's
- *   declared Zod schema.
- *
- * The `me`/`event` arguments are unused by the bare implementation but
- * carried on the shared signature so the fold loop is call-shape-identical
- * regardless of which patch step was selected — the validating
- * implementation needs them to name the failing reduction.
- *
- * @internal
+ * The patch step: merges a reducer's partial into state. Chosen once at
+ * construction (`build_es`), never per event. `me`/`event` only serve
+ * {@link validating_patch}, to name the failing reduction.
  */
 export type PatchFn = <TState extends Schema, TEvents extends Schemas, TActions extends Schemas>(me: State<TState, TEvents, TActions>, state: TState, partial: Readonly<Patch<TState>>, event: Committed<TEvents, keyof TEvents>) => TState;
-/**
- * The default patch step: a bare `patch()` merge with no wrapper and no
- * branch. The off-path is a plain reduction, so an
- * app that leaves `validateFoldedState` off pays nothing — not even a
- * comparison.
- *
- * @internal
- */
+/** The default patch step: a bare merge, so the hot path pays nothing. */
 export declare const bare_patch: PatchFn;
 /**
- * The opt-in patch step: merge the partial into state, then
- * parse the merged full state against the owning state's declared Zod
- * schema. A reducer that produces schema-violating state (the calculator
- * divide-by-zero NaN class) fails here, at the triggering event,
- * instead of propagating and surfacing hops later as a confusing
- * downstream error.
- *
- * The `target` string names the state and the triggering event
- * (`"<state>.<event>#<id>"`) so the resulting {@link ValidationError}
- * points straight at the reduction that produced bad state. A debugging /
- * CI aid, not a production guard — selected only when the operator opts
- * in.
- *
- * @internal
+ * `validateFoldedState`: merge, then parse against the state schema, so a
+ * bad reducer fails at its own event. A debugging aid, not a production guard.
  */
 export declare const validating_patch: PatchFn;
-/**
- * Internal action signature seen by the orchestrator — the {@link Correlator}
- * is bound at `build_es` time, so callers don't pass it through.
- *
- * @internal
- */
+/** `action` with the correlator and patch step bound by `build_es`. */
 type BoundAction = <TState extends Schema, TEvents extends Schemas, TActions extends Schemas, TKey extends keyof TActions>(me: State<TState, TEvents, TActions>, action: TKey, target: Target, payload: Readonly<TActions[TKey]>, options?: DoOptions<TEvents>) => Promise<Snapshot<TState, TEvents>[]>;
-/** @internal */
 export interface EsOps {
     snap: typeof snap;
     load: typeof load;
     action: BoundAction;
     tombstone: typeof tombstone;
 }
-/**
- * Event sourcing utilities for snapshotting, loading, and committing actions/events.
- * Used internally by Act and state machines.
- */
-/**
- * Saves a snapshot of the state to the store.
- *
- * Snapshots are used to optimize state reconstruction for aggregates with long event streams.
- *
- * @template TState The type of state
- * @template TEvents The type of events
- * @param snapshot The snapshot to save
- * @returns Promise that resolves when the snapshot is saved
- *
- * @example
- * await snap(snapshot);
- */
+/** Commits a snapshot event. Never throws: a failed snapshot must not fail the action. */
 export declare function snap<TState extends Schema, TEvents extends Schemas>(snapshot: Snapshot<TState, TEvents>): Promise<Committed<TEvents, keyof TEvents> | undefined>;
 /**
- * Commits a tombstone event with optimistic concurrency, returning the
- * committed record on success or `undefined` if the stream moved past
- * `expectedVersion` (concurrent write detected). Other store errors
- * propagate.
- *
- * Used by `close()` to guard a stream while archive/truncate runs:
- * subsequent `action()` calls see the tombstone at head and reject with
- * {@link StreamClosedError} until the close completes.
- *
- * @internal
+ * Commits the close guard at `expectedVersion`; `undefined` when the stream
+ * moved. Actions then see the tombstone at head and throw {@link StreamClosedError}.
  */
 export declare function tombstone(stream: string, expectedVersion: number, correlation: string): Promise<Committed<Schemas, keyof Schemas> | undefined>;
 /**
- * Scan a restore source event by event. Owns pagination, validation,
- * the `drop_snapshots` filter, the `on_progress` callback, and the
- * causation remap; adapters supply only the per-event insert
- * `callback` via the driver pattern (see {@link Store.restore}).
- *
- * Pages the source with `limit`/`after`; a source that ignores the
- * filter (`CsvFile`) returns everything at once and the loop ends. Throws
- * on the first invalid event. Returns the result without `duration_ms`,
- * which {@link Act.restore} adds.
- *
- * @internal
+ * Pages a restore source: validation, drop filters, migrations, progress and
+ * causation remap. Adapters supply only the per-event insert `callback`
+ * (see {@link Store.restore}). A source that ignores `limit` (`CsvFile`)
+ * returns everything in one page.
  */
 export declare function scan(source: EventSource, opts?: ScanOptions, callback?: (event: Committed<Schemas, keyof Schemas>) => Promise<number>): Promise<Omit<ScanResult, "duration_ms">>;
 /**
- * Loads a snapshot of the state from the store by folding events through the
- * state's patch reducers.
- *
- * First checks the cache for a checkpoint, then queries the store for events
- * committed after the cached position. On cache miss, replays from the store
- * (using snapshots if available to avoid full replay).
- *
- * @template TState The type of state
- * @template TEvents The type of events
- * @template TActions The type of actions
- * @param me The state machine definition.
- * @param stream The stream (instance) to load
- * @param callback (Optional) Callback to receive the loaded snapshot as it is built
- * @param asOf (Optional) Time-travel cursor; bypasses the cache.
- * @param actor (Optional) Passed through to the state's `view` delegate
- *   when constructing the snapshot.event — semantics are the state's to
- *   define (see {@link state}).
- * @returns The snapshot of the loaded state
- *
- * @example
- * const snapshot = await load(Counter, "counter1");
+ * Folds a stream into state, from the cached checkpoint or the latest
+ * snapshot. `asOf` time-travels and bypasses the cache.
  */
 export declare function load<TState extends Schema, TEvents extends Schemas, TActions extends Schemas>(me: State<TState, TEvents, TActions>, target: LoadTarget, callback?: (snapshot: Snapshot<TState, TEvents>) => void, patch_fn?: PatchFn): Promise<Snapshot<TState, TEvents>>;
 /**
- * Executes an action and emits an event to be committed by the store.
- *
- * Validates the action, applies business invariants, emits events, and
- * commits them to the event store. When the action's
- * {@link ActionOptions} declare a retry budget, the orchestrator owns
- * the loop on {@link ConcurrencyError}: cache is invalidated, optional
- * `backoff` delay is applied, and the action re-runs from `load`. Any
- * other error rethrows immediately and does not consume the budget.
- *
- * Reactions skip optimistic concurrency (commit below passes
- * `undefined` as `expectedVersion` when `reactingTo` is set), so
- * `ConcurrencyError` cannot fire on the reaction-driven path — the
- * loop is naturally a no-op there.
- *
- * @template TState The type of state
- * @template TEvents The type of events
- * @template TActions The type of action_schemas
- * @template TKey The type of action to execute
- * @param me The state machine definition
- * @param action The action to execute
- * @param target The target (stream, actor, etc.)
- * @param payload The payload of the action
- * @param options Per-call dispatch options ({@link DoOptions}) —
- *   `reactingTo` to thread correlation, `correlator` to override the
- *   framework or orchestrator-level correlator for this call only.
- * @returns The snapshot of the committed event
- *
- * @example
- * const snapshot = await action(Counter, "increment", { stream: "counter1", actor }, { by: 1 });
+ * Validates, checks invariants, emits and commits. On {@link ConcurrencyError}
+ * it re-runs from `load` within the action's `maxRetries`; any other error
+ * rethrows. Reactions commit without the inferred version guard.
  */
 export declare function action<TState extends Schema, TEvents extends Schemas, TActions extends Schemas, TKey extends keyof TActions>(me: State<TState, TEvents, TActions>, action: TKey, target: Target, payload: Readonly<TActions[TKey]>, options?: DoOptions<TEvents>, patch_fn?: PatchFn): Promise<Snapshot<TState, TEvents>[]>;
 export {};

package/dist/@types/internal/event-sourcing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-sourcing.d.ts","sourceRoot":"","sources":["../../../src/internal/event-sourcing.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"event-sourcing.d.ts","sourceRoot":"","sources":["../../../src/internal/event-sourcing.ts"],"names":[],"mappings":"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"}

package/dist/{chunk-T3CWXVGT.js → chunk-OG5O36AJ.js}

@@ -749,25 +749,19 @@ var InMemoryStore = class {
    */
   async defer(input, deferred_at) {
     await sleep();
-    let count = 0;
-    if (Array.isArray(input)) {
-      for (const name of new Set(input)) {
-        const s = this._streams.get(name);
-        if (s) {
-          s.defer(deferred_at);
-          count++;
-        }
-      }
-    } else {
-      const matches = this._filter_predicate(input);
-      for (const s of this._streams.values()) {
-        if (matches(s)) {
-          s.defer(deferred_at);
-          count++;
-        }
-      }
-    }
-    return count;
+    const selected = this._select(input);
+    for (const s of selected) s.defer(deferred_at);
+    return selected.length;
+  }
+  /**
+   * The streams named by `input`: an explicit list (de-duplicated, so a
+   * repeated name counts once, matching the SQL adapters' set-based
+   * `stream = ANY(...)`; unknown names are skipped) or a {@link StreamFilter}.
+   */
+  _select(input) {
+    if (Array.isArray(input))
+      return [...new Set(input)].map((name) => this._streams.get(name)).filter((s) => s !== void 0);
+    return [...this._streams.values()].filter(this._filter_predicate(input));
   }
   /**
    * Build a predicate from a {@link StreamFilter}. Compiled regexes are
@@ -803,37 +797,10 @@ var InMemoryStore = class {
    */
   async reset(input) {
     await sleep();
-    let count = 0;
-    if (Array.isArray(input)) {
-      for (const name of new Set(input)) {
-        const s = this._streams.get(name);
-        if (s) {
-          s.reset();
-          count++;
-        }
-      }
-    } else {
-      const matches = this._filter_predicate(input);
-      for (const s of this._streams.values()) {
-        if (matches(s)) {
-          s.reset();
-          count++;
-        }
-      }
-    }
-    return count;
+    const selected = this._select(input);
+    for (const s of selected) s.reset();
+    return selected.length;
   }
-  /**
-   * Clear the blocked flag (and retry / error / lease) on the matched
-   * streams without touching the watermark. Streams that aren't blocked
-   * at call time are silently skipped. Accepts either an explicit list
-   * of names or a {@link StreamFilter}. The filter form always restricts
-   * to blocked streams — passing `blocked: false` matches nothing.
-   * See {@link Store.unblock}.
-   *
-   * @param input - Stream names or a filter selecting the streams to unblock.
-   * @returns Count of streams that were actually flipped (were blocked).
-   */
   /**
    * Wipe the sensitive-data payload for every event on the stream — see
    * {@link Store.forget_pii}. O(1) drop of the stream's inner Map; the size of
@@ -849,21 +816,23 @@ var InMemoryStore = class {
     this._pii.delete(stream);
     return count;
   }
+  /**
+   * Clear the blocked flag (and retry / error / lease) on the matched
+   * streams without touching the watermark. Streams that aren't blocked
+   * at call time are silently skipped. Accepts either an explicit list
+   * of names or a {@link StreamFilter}. The filter form always restricts
+   * to blocked streams — passing `blocked: false` matches nothing.
+   * See {@link Store.unblock}.
+   *
+   * @param input - Stream names or a filter selecting the streams to unblock.
+   * @returns Count of streams that were actually flipped (were blocked).
+   */
   async unblock(input) {
     await sleep();
-    let count = 0;
-    if (Array.isArray(input)) {
-      for (const name of input) {
-        const s = this._streams.get(name);
-        if (s?.unblock()) count++;
-      }
-    } else {
-      const matches = this._filter_predicate({ ...input, blocked: true });
-      for (const s of this._streams.values()) {
-        if (matches(s) && s.unblock()) count++;
-      }
-    }
-    return count;
+    const selected = this._select(
+      Array.isArray(input) ? input : { ...input, blocked: true }
+    );
+    return selected.filter((s) => s.unblock()).length;
   }
   /**
    * Bulk-update priority of streams matching `filter`. Mirrors
@@ -876,16 +845,9 @@ var InMemoryStore = class {
    */
   async prioritize(filter, priority) {
     await sleep();
-    const matches = this._filter_predicate(filter);
-    let count = 0;
-    for (const s of this._streams.values()) {
-      if (!matches(s)) continue;
-      if (s.priority !== priority) {
-        s.set_priority(priority);
-        count++;
-      }
-    }
-    return count;
+    const changed = this._select(filter).filter((s) => s.priority !== priority);
+    for (const s of changed) s.set_priority(priority);
+    return changed.length;
   }
   /**
    * Streams registered subscription positions to the callback, ordered by
@@ -896,10 +858,8 @@ var InMemoryStore = class {
     await sleep();
     const limit = query?.limit ?? 100;
     const after = query?.after;
-    const blocked = query?.blocked;
     const source_matches = query?.source_matches;
-    const stream_re = query?.stream !== void 0 && !query.stream_exact ? new RegExp(query.stream) : void 0;
-    const source_re = query?.source !== void 0 && !query.source_exact ? new RegExp(query.source) : void 0;
+    const matches = this._filter_predicate(query ?? {});
     const reverse_cache = /* @__PURE__ */ new Map();
     const reverse_match = (source) => {
       let re = reverse_cache.get(source);
@@ -913,20 +873,10 @@ var InMemoryStore = class {
     let count = 0;
     for (const s of sorted) {
       if (after !== void 0 && s.stream <= after) continue;
-      if (query?.stream !== void 0) {
-        if (query.stream_exact ? s.stream !== query.stream : !stream_re.test(s.stream))
-          continue;
-      }
-      if (query?.source !== void 0) {
-        if (s.source === void 0) continue;
-        if (query.source_exact ? s.source !== query.source : !source_re.test(s.source))
-          continue;
-      }
+      if (!matches(s)) continue;
       if (source_matches !== void 0) {
         if (s.source && !reverse_match(s.source)) continue;
       }
-      if (blocked !== void 0 && s.blocked !== blocked) continue;
-      if (query?.lane !== void 0 && s.lane !== query.lane) continue;
       if (count >= limit) break;
       callback({
         stream: s.stream,
@@ -1339,4 +1289,4 @@ export {
   TOMBSTONE_EVENT,
   DEFAULT_LANE
 };
-//# sourceMappingURL=chunk-T3CWXVGT.js.map
+//# sourceMappingURL=chunk-OG5O36AJ.js.map