@rotorsoft/act 1.32.19 → 1.32.20

package/dist/index.js

@@ -1665,13 +1665,14 @@ var CorrelateCycle = class {
     cd,
     max_subscribed_streams,
     declared_lanes,
+    shard,
     on_init,
     on_init_async,
     cold_start_back_scan = DEFAULT_COLD_START_BACK_SCAN,
     lease_millis = DEFAULT_CORRELATION_LEASE_MS
   }) {
     this._lease_millis = lease_millis;
-    this._key = registry_key(registry.events);
+    this._key = shard ? `${registry_key(registry.events)}:${[...shard].sort().join(",")}` : registry_key(registry.events);
     this._dynamic_subscriptions = new LruMap(max_subscribed_streams);
     this._registry = registry;
     this._declared_lanes = declared_lanes;
@@ -3671,6 +3672,8 @@ var Act = class {
       // Declared lanes (not active ones): a lane another process claims is
       // still a valid destination.
       declared_lanes: new Set(this._declared_lanes),
+      // Built after the controllers, so their keys are the active lanes.
+      shard: this._drain_controllers.size < this._declared_lanes.length ? [...this._drain_controllers.keys()] : void 0,
       on_init: () => {
         if (this._drain && this._reactive_events.size > 0) this._arm_all();
       },
@@ -4367,11 +4370,11 @@ var Act = class {
     });
   }
   /**
-   * Atomically wipe the store and rebuild it from an async stream of
-   * committed events. The framework owns iteration, validation,
-   * `drop_snapshots` filtering, `on_progress`, and the per-call
-   * `old → new` causation remap; the adapter's {@link Store.restore}
-   * driver supplies the transaction lifecycle and per-event insert.
+   * Atomically wipe the store and rebuild it from an event source. The
+   * framework owns iteration, validation, `drop_snapshots` filtering,
+   * `on_progress`, and the per-call `old → new` causation remap; the
+   * adapter's {@link Store.restore} driver supplies the transaction
+   * lifecycle and per-event insert.
    *
    * Throws if the adapter has no restore capability. Throws on the
    * first invalid event (negative version, malformed `created`) with
@@ -4379,33 +4382,30 @@ var Act = class {
    * the adapter means a failing restore leaves the store byte-for-byte
    * unchanged.
    *
-   * @param source - Async stream of events in target order. Streamed
-   *   rather than buffered so multi-million-event backups don't OOM.
-   *   Each event's original `id` is used as a causation lookup key but
-   *   never written through — adapters renumber densely.
+   * @param source - Any {@link EventSource}: a `CsvFile` backup or
+   *   another store. Read in batches rather than buffered, so
+   *   multi-million-event backups don't OOM. Each event's original `id`
+   *   is used as a causation lookup key but never written through —
+   *   adapters renumber densely.
    * @param opts - {@link ScanOptions}. `drop_snapshots` skips
    *   `__snapshot__` events (counted in the result); `on_progress`
    *   fires once per event.
+   * @param sink - Where the events land. Defaults to this Act's store.
    * @returns {@link ScanResult} with `kept`, `duration_ms`, and
    *   `dropped` per-category counters.
    *
-   * @example Round-trip a CSV backup
+   * @example Restore a CSV backup into the connected store
    * ```typescript
-   * async function* parseCsv(blob: string) {
-   *   for (const line of blob.split("\n").slice(1)) {
-   *     const [id, name, data, stream, version, created, meta] = parse(line);
-   *     yield {
-   *       id: +id, name, data: JSON.parse(data), stream,
-   *       version: +version, created: new Date(created),
-   *       meta: JSON.parse(meta),
-   *     };
-   *   }
-   * }
-   * const result = await app.restore(parseCsv(csvBlob), {});
+   * const result = await app.restore(new CsvFile({ path: "./backup.csv" }));
    * console.log(`Restored ${result.kept} events in ${result.duration_ms}ms`);
    * await cache().clear();   // operator's responsibility
    * ```
    *
+   * @example Copy one store into another
+   * ```typescript
+   * await app.restore(pg, {}, sqlite);
+   * ```
+   *
    * @see {@link Store.restore} for the underlying driver-pattern primitive.
    */
   async restore(source, opts = {}, sink) {