@rotorsoft/act 0.21.0 → 0.22.0

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

@@ -225,16 +225,18 @@ export interface Store extends Disposable {
      * Upserts stream entries so they become visible to {@link claim}. Used by
      * `correlate()` to register dynamically discovered reaction target streams.
      *
+     * Also returns the current maximum watermark across all subscribed streams,
+     * used internally for correlation checkpoint initialization on cold start.
+     *
      * @param streams - Streams to register with optional source hint
-     * @returns Number of newly registered streams (excludes already-known streams)
+     * @returns `subscribed` count of newly registered streams, `watermark` max `at` across all streams
      *
      * @example
      * ```typescript
-     * const count = await store().subscribe([
+     * const { subscribed, watermark } = await store().subscribe([
      *   { stream: "stats-user-1", source: "user-1" },
      *   { stream: "stats-user-2", source: "user-2" },
      * ]);
-     * console.log(`Registered ${count} new streams`);
      * ```
      *
      * @see {@link claim} for discovering and leasing registered streams
@@ -242,7 +244,10 @@ export interface Store extends Disposable {
     subscribe: (streams: Array<{
         stream: string;
         source?: string;
-    }>) => Promise<number>;
+    }>) => Promise<{
+        subscribed: number;
+        watermark: number;
+    }>;
     /**
      * Blocks streams after persistent processing failures.
      *

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/index.cjs

@@ -496,18 +496,22 @@ var InMemoryStore = class {
   /**
    * Registers streams for event processing.
    * @param streams - Streams to register with optional source.
-   * @returns Number of newly registered streams.
+   * @returns subscribed count and current max watermark.
    */
   async subscribe(streams) {
     await sleep();
-    let count = 0;
+    let subscribed = 0;
     for (const { stream, source } of streams) {
       if (!this._streams.has(stream)) {
         this._streams.set(stream, new InMemoryStream(stream, source));
-        count++;
+        subscribed++;
       }
     }
-    return count;
+    let watermark = -1;
+    for (const s of this._streams.values()) {
+      if (s.at > watermark) watermark = s.at;
+    }
+    return { subscribed, watermark };
   }
   /**
    * Acknowledge completion of processing for leased streams.
@@ -794,15 +798,21 @@ async function action(me, action2, target, payload, reactingTo, skipValidation =
 // src/act.ts
 var tracer = build_tracer(config().logLevel);
 var Act = class {
-  /**
-   * Create a new Act orchestrator.
-   *
-   * @param registry The registry of state, event, and action schemas
-   * @param states Map of state names to their (potentially merged) state definitions
-   */
   constructor(registry, _states = /* @__PURE__ */ new Map()) {
     this.registry = registry;
     this._states = _states;
+    const statics = [];
+    for (const register of Object.values(this.registry.events)) {
+      for (const reaction of register.reactions.values()) {
+        if (typeof reaction.resolver === "function") {
+          this._has_dynamic_resolvers = true;
+        } else if (reaction.resolver) {
+          const r = reaction.resolver;
+          statics.push({ stream: r.target, source: r.source });
+        }
+      }
+    }
+    this._static_targets = statics;
     dispose(() => {
       this._emitter.removeAllListeners();
       this.stop_correlations();
@@ -816,6 +826,10 @@ var Act = class {
   _correlation_timer = void 0;
   _settle_timer = void 0;
   _settling = false;
+  _correlation_checkpoint = -1;
+  _subscribed_statics = /* @__PURE__ */ new Set();
+  _has_dynamic_resolvers = false;
+  _correlation_initialized = false;
   emit(event, args) {
     return this._emitter.emit(event, args);
   }
@@ -827,6 +841,14 @@ var Act = class {
     this._emitter.off(event, listener);
     return this;
   }
+  /**
+   * Create a new Act orchestrator.
+   *
+   * @param registry The registry of state, event, and action schemas
+   * @param states Map of state names to their (potentially merged) state definitions
+   */
+  /** Static resolver targets collected at build time */
+  _static_targets;
   /**
    * Executes an action on a state instance, committing resulting events.
    *
@@ -1236,37 +1258,67 @@ var Act = class {
    * @see {@link start_correlations} for automatic periodic correlation
    * @see {@link stop_correlations} to stop automatic correlation
    */
+  /**
+   * Initialize correlation state on first call.
+   * - Reads max(at) from store as cold-start checkpoint
+   * - Subscribes static resolver targets (idempotent upsert)
+   * - Populates the subscribed statics set
+   * @internal
+   */
+  async _init_correlation() {
+    if (this._correlation_initialized) return;
+    this._correlation_initialized = true;
+    const { watermark } = await store().subscribe(this._static_targets);
+    this._correlation_checkpoint = watermark;
+    for (const { stream } of this._static_targets) {
+      this._subscribed_statics.add(stream);
+    }
+  }
   async correlate(query = { after: -1, limit: 10 }) {
+    await this._init_correlation();
+    if (!this._has_dynamic_resolvers)
+      return { subscribed: 0, last_id: this._correlation_checkpoint };
+    const after = Math.max(this._correlation_checkpoint, query.after || -1);
     const correlated = /* @__PURE__ */ new Map();
-    let last_id = query.after || -1;
-    await store().query((event) => {
-      last_id = event.id;
-      const register = this.registry.events[event.name];
-      if (register) {
-        for (const reaction of register.reactions.values()) {
-          const resolved = typeof reaction.resolver === "function" ? reaction.resolver(event) : reaction.resolver;
-          if (resolved) {
-            const entry = correlated.get(resolved.target) || {
-              source: resolved.source,
-              payloads: []
-            };
-            entry.payloads.push({
-              ...reaction,
-              source: resolved.source,
-              event
-            });
-            correlated.set(resolved.target, entry);
+    let last_id = after;
+    await store().query(
+      (event) => {
+        last_id = event.id;
+        const register = this.registry.events[event.name];
+        if (register) {
+          for (const reaction of register.reactions.values()) {
+            if (typeof reaction.resolver !== "function") continue;
+            const resolved = reaction.resolver(event);
+            if (resolved && !this._subscribed_statics.has(resolved.target)) {
+              const entry = correlated.get(resolved.target) || {
+                source: resolved.source,
+                payloads: []
+              };
+              entry.payloads.push({
+                ...reaction,
+                source: resolved.source,
+                event
+              });
+              correlated.set(resolved.target, entry);
+            }
           }
         }
-      }
-    }, query);
+      },
+      { ...query, after }
+    );
+    this._correlation_checkpoint = last_id;
     if (correlated.size) {
       const streams = [...correlated.entries()].map(([stream, { source }]) => ({
         stream,
         source
       }));
-      const subscribed = await store().subscribe(streams);
-      subscribed && tracer.correlated(streams);
+      const { subscribed } = await store().subscribe(streams);
+      if (subscribed) {
+        tracer.correlated(streams);
+        for (const { stream } of streams) {
+          this._subscribed_statics.add(stream);
+        }
+      }
       return { subscribed, last_id };
     }
     return { subscribed: 0, last_id };
@@ -1329,10 +1381,8 @@ var Act = class {
   start_correlations(query = {}, frequency = 1e4, callback) {
     if (this._correlation_timer) return false;
     const limit = query.limit || 100;
-    let after = query.after || -1;
     this._correlation_timer = setInterval(
-      () => this.correlate({ ...query, after, limit }).then((result) => {
-        after = result.last_id;
+      () => this.correlate({ ...query, after: this._correlation_checkpoint, limit }).then((result) => {
         if (callback && result.subscribed) callback(result.subscribed);
       }).catch(console.error),
       frequency
@@ -1415,9 +1465,13 @@ var Act = class {
       if (this._settling) return;
       this._settling = true;
       (async () => {
+        await this._init_correlation();
         let lastDrain;
         for (let i = 0; i < maxPasses; i++) {
-          const { subscribed } = await this.correlate(correlateQuery);
+          const { subscribed } = await this.correlate({
+            ...correlateQuery,
+            after: this._correlation_checkpoint
+          });
           if (subscribed === 0 && i > 0) break;
           lastDrain = await this.drain(drainOptions);
           if (!lastDrain.acked.length && !lastDrain.blocked.length) break;