@rotorsoft/act 0.42.0 → 0.44.0

package/dist/@types/types/ports.d.ts

@@ -169,11 +169,14 @@ export type QueryStreamsResult = {
     readonly count: number;
 };
 /**
- * Filter for {@link Store.prioritize} bulk priority updates.
+ * Filter shape for bulk operations on registered streams. Used by
+ * {@link Store.prioritize}, {@link Store.reset}, and {@link Store.unblock}
+ * — anything that operates on a set of streams selected by pattern or
+ * exact match rather than enumerated by name.
  *
  * Same shape as {@link QueryStreams} but without pagination — bulk
- * UPDATEs don't paginate. Empty filter (`{}`) updates **every**
- * registered stream.
+ * UPDATEs don't paginate. Empty filter (`{}`) matches **every**
+ * registered stream; treat as a footgun and use sparingly.
  *
  * @property stream - Stream-name filter (regex by default; `stream_exact`
  *   for equality).
@@ -184,7 +187,103 @@ export type QueryStreamsResult = {
  * @property blocked - Restrict to blocked / unblocked streams. Omit
  *   for both.
  */
-export type PrioritizeFilter = Pick<QueryStreams, "stream" | "stream_exact" | "source" | "source_exact" | "blocked">;
+export type StreamFilter = Pick<QueryStreams, "stream" | "stream_exact" | "source" | "source_exact" | "blocked">;
+/**
+ * Alias of {@link StreamFilter}. Retained for backward compatibility
+ * with code that imports the filter by its prioritize-specific name.
+ * Prefer `StreamFilter` for new code.
+ */
+export type PrioritizeFilter = StreamFilter;
+/**
+ * Framework-internal event names — written by the runtime, not by user
+ * code. Snapshots are seeded by `truncate()`; tombstones by `close()`.
+ *
+ * Kept as a literal-string union here (rather than re-exported from
+ * `../ports.js` where the runtime constants live) so {@link QueryStatsOptions.exclude}
+ * can be type-checked without inducing a `types/` → `ports.ts` cycle.
+ * The runtime constants {@link "../ports.js".SNAP_EVENT | SNAP_EVENT} and
+ * {@link "../ports.js".TOMBSTONE_EVENT | TOMBSTONE_EVENT} (exported from
+ * `@rotorsoft/act`) are the typed source of truth; this union mirrors
+ * them at the type level.
+ */
+export type FrameworkEventName = "__snapshot__" | "__tombstone__";
+/**
+ * Union of all event names valid for a given schema set: user-declared
+ * event names plus the framework-internal markers. Used by
+ * {@link QueryStatsOptions.exclude} so callers can mix domain events and
+ * framework markers in the same filter list without `as string` casts
+ * or stringly-typed mistakes (e.g. `"__tombsotne__"` typos fail at
+ * compile time).
+ *
+ * @template E - Event schemas; defaults to {@link Schemas}.
+ */
+export type EventName<E extends Schemas = Schemas> = (keyof E & string) | FrameworkEventName;
+/**
+ * Per-stream aggregated stats returned by {@link Store.query_stats}.
+ *
+ * `head` and `tail` follow the **git-log convention**, not the Unix
+ * `head`/`tail` convention:
+ * - `head` — the **latest** event (highest id), always present.
+ * - `tail` — the **earliest** event (lowest id), opt-in via
+ *   {@link QueryStatsOptions.tail}.
+ *
+ * @template E - Event schemas; defaults to {@link Schemas} when the caller
+ *   does not narrow.
+ * @property head - Latest non-excluded event for the stream.
+ * @property tail - Earliest non-excluded event for the stream, when
+ *   `options.tail` is true.
+ * @property count - Total non-excluded event count for the stream, when
+ *   `options.count` is true.
+ * @property names - Sparse map of event name → count of events with
+ *   that name, when `options.names` is true. Keys are typed as
+ *   {@link EventName | EventName<E>} so typos on lookup
+ *   (e.g. `stats.names?.["TicktOpened"]`) fail at compile time when the
+ *   caller narrows `E`. Empty object never returned — a stream with no
+ *   matching events is absent from the result map entirely.
+ */
+export type StreamStats<E extends Schemas = Schemas> = {
+    readonly head: Committed<E, keyof E>;
+    readonly tail?: Committed<E, keyof E>;
+    readonly count?: number;
+    readonly names?: Readonly<Partial<Record<EventName<E>, number>>>;
+};
+/**
+ * Options for {@link Store.query_stats}. All stat fields default to
+ * `false` except `head`, which is always returned.
+ *
+ * **Cost model:** With no opt-in flags (or `tail` alone), each requested
+ * stat resolves via an index-backed lookup — O(K) cost where K is the
+ * number of matched streams. Setting `count` and/or `names` triggers a
+ * full event scan over the matched streams (O(N) where N is total events);
+ * both share the same scan and so requesting one is the same cost as
+ * requesting both.
+ *
+ * @template E - Event schemas; defaults to {@link Schemas}. When the caller
+ *   narrows `E`, `exclude` is type-checked against the schema's event names
+ *   — typos like `["TOMBSTON_EVENT"]` fail at compile time.
+ * @property tail - Include the earliest non-excluded event per stream.
+ *   Cheap when alone (indexed); free when `count`/`names` also set
+ *   (already scanning).
+ * @property count - Include the total non-excluded event count per stream.
+ *   Triggers full scan.
+ * @property names - Include a `name → count` map per stream. Triggers
+ *   full scan (shares cost with `count`).
+ * @property exclude - Event names to skip — e.g.
+ *   `[TOMBSTONE_EVENT, SNAP_EVENT]` to ignore framework markers. Applies
+ *   to all returned stats (head, tail, count, names) consistently.
+ * @property before - Time-travel cutoff: only consider events with
+ *   `id < before`. Omitted = current state. Useful for "what did this
+ *   stream look like at event N?" historical queries without changing
+ *   the call shape. Cheap on both code paths (cheap-heads path narrows
+ *   the index scan; full-scan path adds a `WHERE id < ?` predicate).
+ */
+export type QueryStatsOptions<E extends Schemas = Schemas> = {
+    readonly tail?: boolean;
+    readonly count?: boolean;
+    readonly names?: boolean;
+    readonly exclude?: ReadonlyArray<EventName<E>>;
+    readonly before?: number;
+};
 /**
  * Interface for event store implementations.
  *
@@ -440,14 +539,24 @@ export interface Store extends Disposable {
      * "needs drain" flag, so a settled `Act` instance will short-circuit and
      * skip the replay. `Act.reset()` wraps this and arms the flag.
      *
-     * @param streams - Stream names to reset
+     * Accepts either an explicit list of stream names or a
+     * {@link StreamFilter} for bulk operations (e.g., "rebuild every
+     * blocked stream"). The filter form is the same shape used by
+     * {@link prioritize} and {@link query_streams}. An empty filter
+     * (`{}`) matches every registered stream — typically a footgun for
+     * `reset`; prefer narrower filters like `{ blocked: true }`.
+     *
+     * @param input - Stream names or a {@link StreamFilter}
      * @returns Count of streams that were actually reset
      *
      * @example
      * ```typescript
-     * // Recommended
+     * // By name
      * await app.reset(["my-projection"]);
      *
+     * // By filter — rebuild every blocked stream in a projection family
+     * await app.reset({ stream: "^proj-orders-", blocked: true });
+     *
      * // Low-level (does NOT trigger replay on settled apps)
      * await store().reset(["my-projection"]);
      * ```
@@ -455,7 +564,60 @@ export interface Store extends Disposable {
      * @see {@link Act.reset} for the high-level rebuild API that wraps
      *   this primitive and arms the orchestrator's drain flag
      */
-    reset: (streams: string[]) => Promise<number>;
+    reset: (input: string[] | StreamFilter) => Promise<number>;
+    /**
+     * Clears the blocked flag on streams without replaying their history.
+     * Sets `blocked = false`, `retry_count = 0`, `error = null`, and
+     * clears any lease bookkeeping. The `at` watermark stays where it
+     * was — the stream resumes from the next event after the last
+     * successful ack, not from zero.
+     *
+     * The distinction from {@link reset} matters: `reset()` is for
+     * projection rebuilds (replay from event 0); `unblock()` is for
+     * recovering from a poison message after the operator fixes the
+     * underlying issue. Use `unblock()` when you don't want to re-process
+     * history.
+     *
+     * **Prefer `Act.unblock()` over calling this directly.** Like
+     * `reset()`, this primitive doesn't raise the orchestrator's internal
+     * "needs drain" flag — a settled `Act` instance will short-circuit and
+     * skip the resume. `Act.unblock()` wraps this and arms the flag.
+     *
+     * Only streams that were actually blocked at call time count toward
+     * the return value; already-unblocked streams and unknown stream
+     * names are silently skipped. The atomic single-statement update
+     * makes the call safe to issue concurrently with `claim()` — workers
+     * holding a `FOR UPDATE SKIP LOCKED` lock won't see partial state.
+     *
+     * Accepts either an explicit list of stream names or a
+     * {@link StreamFilter} for bulk recovery (e.g., "unblock every
+     * blocked order projection"). The `blocked = true` predicate is
+     * always applied — passing `blocked: false` in the filter matches
+     * nothing. An empty filter (`{}`) means "unblock everything that's
+     * blocked," which is a sane post-incident bulk recovery.
+     *
+     * @param input - Stream names or a {@link StreamFilter}
+     * @returns Count of streams that were actually flipped (were blocked)
+     *
+     * @example
+     * ```typescript
+     * // By name (single targeted recovery)
+     * await app.unblock(["webhooks-out-customer-42"]);
+     *
+     * // By filter — unblock every blocked stream in a family
+     * await app.unblock({ stream: "^webhooks-out-" });
+     *
+     * // Post-incident: unblock everything that's blocked
+     * await app.unblock({});
+     *
+     * // Low-level (does NOT trigger resume on settled apps)
+     * await store().unblock(["webhooks-out-customer-42"]);
+     * ```
+     *
+     * @see {@link Act.unblock} for the high-level recovery API
+     * @see {@link reset} for the rebuild-from-zero alternative
+     */
+    unblock: (input: string[] | StreamFilter) => Promise<number>;
     /**
      * Bulk-update the scheduling priority of streams matching a filter.
      *
@@ -495,7 +657,7 @@ export interface Store extends Disposable {
      * @see {@link Act.prioritize} for the orchestrator-level wrapper
      * @see {@link claim} for how priority biases stream scheduling
      */
-    prioritize: (filter: PrioritizeFilter, priority: number) => Promise<number>;
+    prioritize: (filter: StreamFilter, priority: number) => Promise<number>;
     /**
      * Atomically truncates streams and seeds each with a final event.
      *
@@ -560,6 +722,110 @@ export interface Store extends Disposable {
      * ```
      */
     query_streams: (callback: (position: StreamPosition) => void, query?: QueryStreams) => Promise<QueryStreamsResult>;
+    /**
+     * Per-stream aggregated stats — single round trip per adapter.
+     *
+     * Returns the latest event (`head`) plus opt-in extras (`tail`, `count`,
+     * `names`) for each stream selected by `input`. Streams with no
+     * qualifying events are absent from the result map.
+     *
+     * **Cost model.** With no opt-in flags, the call uses an index-backed
+     * head lookup per stream — O(K) where K is the number of matched
+     * streams. `tail` alone stays in the cheap tier. Setting `count` and/or
+     * `names` triggers a full event scan over the matched streams (O(N)
+     * where N is total events); both stats share that scan, so requesting
+     * one or both is the same cost.
+     *
+     * **`input`.** Either an explicit `string[]` of stream names, or a
+     * narrow event-stream selector `{ stream?, stream_exact? }` for
+     * pattern-based or exact-name matching. **Subscription-level filters
+     * (`source`, `blocked`) are intentionally not accepted here** — they
+     * describe subscriptions, not events, and conflating the two would
+     * silently exclude unsubscribed event streams. For
+     * "stats for all blocked subscriptions" compose explicitly:
+     * `query_streams({blocked: true})` → collect names → `query_stats(names)`.
+     *
+     * **`head` vs `tail` naming.** Follows the git-log convention: `head`
+     * is the latest event (highest id), `tail` is the earliest (lowest id).
+     * This is the **opposite** of the Unix `head`/`tail` commands.
+     *
+     * **Framework markers.** Snapshots (`__snapshot__`) and tombstones
+     * (`__tombstone__`) are real events and are included by default —
+     * intentional, so schema-evolution tooling can count them. To exclude
+     * them, pass them in `options.exclude` (typed against {@link EventName})
+     * so typos are compile-time errors.
+     *
+     * **Snapshot counts come from `names`.** When `names: true` and snapshots
+     * are not in `exclude`, `result.names["__snapshot__"]` is the snapshot
+     * count for that stream — no separate field needed. Validates snapshot
+     * policy at scale: `names["__snapshot__"] / count` should match the
+     * configured snap predicate's expected ratio.
+     *
+     * **Time travel.** `options.before` narrows to events with `id < before`,
+     * answering "what did this stream look like at event N?" without
+     * special call shape.
+     *
+     * @example Cheap heads — close-cycle pattern (one round trip, no scan)
+     * ```typescript
+     * const stats = await store().query_stats(streams, {
+     *   exclude: [TOMBSTONE_EVENT],
+     * });
+     * for (const [stream, { head }] of stats) {
+     *   // head.id, head.version, head.name
+     * }
+     * ```
+     *
+     * @example Full stats — inspector / admin dashboard (one full scan)
+     * ```typescript
+     * const stats = await store().query_stats<MyEvents>(
+     *   { stream: "^orders-" },
+     *   { count: true, tail: true, names: true,
+     *     exclude: [TOMBSTONE_EVENT] }
+     * );
+     * for (const [stream, s] of stats) {
+     *   const snaps = s.names?.[SNAP_EVENT] ?? 0;
+     *   const domain = (s.count ?? 0) - snaps;
+     *   console.log(stream, { snaps, domain, tail: s.tail?.created });
+     * }
+     * ```
+     *
+     * @example Schema-evolution — surface deprecated events per stream
+     * ```typescript
+     * const stats = await store().query_stats<TicketEvents>(
+     *   { stream: "^ticket-" },
+     *   { names: true }
+     * );
+     * for (const [stream, { names = {} }] of stats) {
+     *   if ((names["TicketOpened"] ?? 0) > 0) {
+     *     console.log(`${stream}: ${names["TicketOpened"]} legacy events`);
+     *   }
+     * }
+     * ```
+     *
+     * @example Time travel — stream state at a historical cutoff
+     * ```typescript
+     * const stats = await store().query_stats(["order-42"], {
+     *   before: 100_000, // events up to (not including) id 100000
+     *   tail: true,
+     * });
+     * const { head, tail } = stats.get("order-42") ?? {};
+     * // head = latest event with id < 100_000; tail = earliest in range
+     * ```
+     *
+     * @template E - Event schemas. Narrow at the call site to type-check
+     *   `exclude` against your event names (typos fail at compile time).
+     *
+     * @param input - Stream names or a filter selecting the streams to stat.
+     * @param options - Opt-in stat fields, event-name exclusions, and
+     *   time-travel cutoff. See {@link QueryStatsOptions}.
+     * @returns Map keyed by stream name. Streams with no qualifying events
+     *   (after `exclude` and `before` are applied) are absent.
+     *
+     * @see {@link QueryStatsOptions} for the cost-aware option surface
+     * @see {@link StreamStats} for the per-stream result shape
+     * @see {@link EventName} for the typed exclude entries
+     */
+    query_stats: <E extends Schemas>(input: string[] | Pick<StreamFilter, "stream" | "stream_exact">, options?: QueryStatsOptions<E>) => Promise<Map<string, StreamStats<E>>>;
     /**
      * Optional cross-process commit notifications.
      *

package/dist/@types/types/ports.d.ts.map

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

package/dist/{chunk-M5YFKVRV.js → chunk-LKRNWD7C.js}

@@ -3,7 +3,7 @@ import {
   Environments,
   LogLevels,
   ValidationError
-} from "./chunk-AGWZY6YT.js";
+} from "./chunk-VMX7RPTC.js";
 
 // src/adapters/console-logger.ts
 var LEVEL_VALUES = {
@@ -364,6 +364,20 @@ var InMemoryStream = class {
     this._leased_by = void 0;
     this._leased_until = void 0;
   }
+  /**
+   * Clear the blocked flag and lease bookkeeping without touching the
+   * watermark. Returns true if the stream was actually blocked (and is
+   * now flipped); false otherwise.
+   */
+  unblock() {
+    if (!this._blocked) return false;
+    this._blocked = false;
+    this._retry = -1;
+    this._error = "";
+    this._leased_by = void 0;
+    this._leased_until = void 0;
+    return true;
+  }
 };
 var InMemoryStore = class {
   // stored events
@@ -599,19 +613,81 @@ var InMemoryStore = class {
     return leases.map((l) => this._streams.get(l.stream)?.block(l, l.error)).filter((l) => !!l);
   }
   /**
-   * Reset watermarks for the given streams to -1, clearing retry, blocked,
-   * error, and lease state so they can be replayed from the beginning.
-   * @param streams - Stream names to reset.
+   * Build a predicate from a {@link StreamFilter}. Compiled regexes are
+   * cached in the closure so callers can apply it across the streams
+   * map without re-compiling per iteration.
+   */
+  _filterPredicate(filter) {
+    const streamRe = filter.stream && !filter.stream_exact ? new RegExp(filter.stream) : void 0;
+    const sourceRe = filter.source && !filter.source_exact ? new RegExp(filter.source) : void 0;
+    return (s) => {
+      if (filter.stream !== void 0) {
+        if (filter.stream_exact ? s.stream !== filter.stream : !streamRe.test(s.stream))
+          return false;
+      }
+      if (filter.source !== void 0) {
+        if (s.source === void 0) return false;
+        if (filter.source_exact ? s.source !== filter.source : !sourceRe.test(s.source))
+          return false;
+      }
+      if (filter.blocked !== void 0 && s.blocked !== filter.blocked)
+        return false;
+      return true;
+    };
+  }
+  /**
+   * Reset watermarks to -1, clearing retry, blocked, error, and lease
+   * state so the matched streams can be replayed from the beginning.
+   * Accepts either an explicit list of names or a {@link StreamFilter}.
+   *
+   * @param input - Stream names or a filter selecting the streams to reset.
    * @returns Count of streams that were actually reset.
    */
-  async reset(streams) {
+  async reset(input) {
     await sleep();
     let count = 0;
-    for (const name of streams) {
-      const s = this._streams.get(name);
-      if (s) {
-        s.reset();
-        count++;
+    if (Array.isArray(input)) {
+      for (const name of input) {
+        const s = this._streams.get(name);
+        if (s) {
+          s.reset();
+          count++;
+        }
+      }
+    } else {
+      const matches = this._filterPredicate(input);
+      for (const s of this._streams.values()) {
+        if (matches(s)) {
+          s.reset();
+          count++;
+        }
+      }
+    }
+    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._filterPredicate({ ...input, blocked: true });
+      for (const s of this._streams.values()) {
+        if (matches(s) && s.unblock()) count++;
       }
     }
     return count;
@@ -627,21 +703,10 @@ var InMemoryStore = class {
    */
   async prioritize(filter, priority) {
     await sleep();
-    const streamRe = filter.stream && !filter.stream_exact ? new RegExp(filter.stream) : void 0;
-    const sourceRe = filter.source && !filter.source_exact ? new RegExp(filter.source) : void 0;
+    const matches = this._filterPredicate(filter);
     let count = 0;
     for (const s of this._streams.values()) {
-      if (filter.stream !== void 0) {
-        if (filter.stream_exact ? s.stream !== filter.stream : !streamRe.test(s.stream))
-          continue;
-      }
-      if (filter.source !== void 0) {
-        if (s.source === void 0) continue;
-        if (filter.source_exact ? s.source !== filter.source : !sourceRe.test(s.source))
-          continue;
-      }
-      if (filter.blocked !== void 0 && s.blocked !== filter.blocked)
-        continue;
+      if (!matches(s)) continue;
       if (s.priority !== priority) {
         s.setPriority(priority);
         count++;
@@ -693,6 +758,77 @@ var InMemoryStore = class {
     }
     return { maxEventId: this._events.length - 1, count };
   }
+  /**
+   * Per-stream aggregated stats — see {@link Store.query_stats}.
+   *
+   * Single forward scan over the in-memory event list, accumulating per
+   * stream. The "cheap heads" cost tier from durable adapters doesn't
+   * apply here (InMemory has no indexes); correctness is the goal, perf
+   * is a non-issue.
+   *
+   * Scope rules:
+   * - Array `input` — explicit stream names, regardless of subscription.
+   * - Filter `input` — `stream`/`stream_exact` match against event-bearing
+   *   stream names; `source`/`source_exact`/`blocked` require a
+   *   corresponding subscription in `_streams` (those are subscription
+   *   concepts, not event concepts). Empty filter `{}` matches every
+   *   event-bearing stream.
+   */
+  async query_stats(input, options) {
+    await sleep();
+    const exclude = new Set(options?.exclude ?? []);
+    const wantTail = options?.tail ?? false;
+    const wantCount = options?.count ?? false;
+    const wantNames = options?.names ?? false;
+    const before = options?.before;
+    const arrayTargets = Array.isArray(input) ? new Set(input) : null;
+    const filter = Array.isArray(input) ? null : input;
+    const streamRe = filter?.stream && !filter.stream_exact ? new RegExp(filter.stream) : void 0;
+    const scopeCache = /* @__PURE__ */ new Map();
+    const inScope = (stream) => {
+      const cached = scopeCache.get(stream);
+      if (cached !== void 0) return cached;
+      let ok = true;
+      if (arrayTargets) {
+        ok = arrayTargets.has(stream);
+      } else if (filter?.stream !== void 0) {
+        ok = filter.stream_exact ? stream === filter.stream : (
+          // biome-ignore lint/style/noNonNullAssertion: streamRe set when stream is regex
+          streamRe.test(stream)
+        );
+      }
+      scopeCache.set(stream, ok);
+      return ok;
+    };
+    const acc = /* @__PURE__ */ new Map();
+    for (const e of this._events) {
+      if (before !== void 0 && e.id >= before) continue;
+      if (!inScope(e.stream)) continue;
+      if (exclude.has(e.name)) continue;
+      let a = acc.get(e.stream);
+      if (!a) {
+        a = { head: e, count: 0 };
+        if (wantTail) a.tail = e;
+        if (wantNames) a.names = {};
+        acc.set(e.stream, a);
+      }
+      a.head = e;
+      a.count++;
+      if (wantNames) {
+        const n = String(e.name);
+        a.names[n] = (a.names[n] ?? 0) + 1;
+      }
+    }
+    const out = /* @__PURE__ */ new Map();
+    for (const [stream, a] of acc) {
+      const stats = { head: a.head };
+      if (wantTail) stats.tail = a.tail;
+      if (wantCount) stats.count = a.count;
+      if (wantNames) stats.names = a.names;
+      out.set(stream, stats);
+    }
+    return out;
+  }
   /**
    * Atomically truncates streams and seeds each with a snapshot or tombstone.
    * @param targets - Streams to truncate with optional snapshot state and meta.
@@ -874,4 +1010,4 @@ export {
   SNAP_EVENT,
   TOMBSTONE_EVENT
 };
-//# sourceMappingURL=chunk-M5YFKVRV.js.map
+//# sourceMappingURL=chunk-LKRNWD7C.js.map