@cadenza.io/core 3.16.4 → 3.17.0

package/dist/index.d.mts

@@ -1403,11 +1403,14 @@ declare class GraphRunner extends SignalEmitter {
 interface EmitOptions {
     squash?: boolean;
     squashId?: string | null;
+    groupId?: string | null;
     mergeFunction?: ((oldContext: AnyObject, newContext: AnyObject) => AnyObject) | null;
     debounce?: boolean;
+    throttle?: boolean;
     delayMs?: number;
     schedule?: boolean;
     exactDateTime?: Date | null;
+    throttleBatch?: number;
 }
 /**
  * This class manages signals and observers, enabling communication across different parts of an application.
@@ -1435,6 +1438,8 @@ declare class SignalBroker {
     debouncedEmitters: Map<string, any>;
     squashedEmitters: Map<string, any>;
     squashedContexts: Map<string, any>;
+    throttleEmitters: Map<string, any>;
+    throttleQueues: Map<string, any>;
     getSignalsTask: Task | undefined;
     registerSignalTask: Task | undefined;
     signalObservers: Map<string, {
@@ -1494,6 +1499,7 @@ declare class SignalBroker {
     debounce(signal: string, context: any, options?: {
         delayMs: number;
     }): void;
+    throttle(signal: string, context: any, options?: EmitOptions): void;
     /**
      * Aggregates and debounces multiple events with the same identifier to minimize redundant operations.
      *

package/dist/index.d.ts

@@ -1403,11 +1403,14 @@ declare class GraphRunner extends SignalEmitter {
 interface EmitOptions {
     squash?: boolean;
     squashId?: string | null;
+    groupId?: string | null;
     mergeFunction?: ((oldContext: AnyObject, newContext: AnyObject) => AnyObject) | null;
     debounce?: boolean;
+    throttle?: boolean;
     delayMs?: number;
     schedule?: boolean;
     exactDateTime?: Date | null;
+    throttleBatch?: number;
 }
 /**
  * This class manages signals and observers, enabling communication across different parts of an application.
@@ -1435,6 +1438,8 @@ declare class SignalBroker {
     debouncedEmitters: Map<string, any>;
     squashedEmitters: Map<string, any>;
     squashedContexts: Map<string, any>;
+    throttleEmitters: Map<string, any>;
+    throttleQueues: Map<string, any>;
     getSignalsTask: Task | undefined;
     registerSignalTask: Task | undefined;
     signalObservers: Map<string, {
@@ -1494,6 +1499,7 @@ declare class SignalBroker {
     debounce(signal: string, context: any, options?: {
         delayMs: number;
     }): void;
+    throttle(signal: string, context: any, options?: EmitOptions): void;
     /**
      * Aggregates and debounces multiple events with the same identifier to minimize redundant operations.
      *

package/dist/index.js

@@ -1262,6 +1262,11 @@ var merge = createAssigner_default(function(object, source, srcIndex) {
 });
 var merge_default = merge;
 
+// src/utils/promise.ts
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
 // src/engine/SignalBroker.ts
 var SignalBroker = class _SignalBroker {
   constructor() {
@@ -1270,6 +1275,8 @@ var SignalBroker = class _SignalBroker {
     this.debouncedEmitters = /* @__PURE__ */ new Map();
     this.squashedEmitters = /* @__PURE__ */ new Map();
     this.squashedContexts = /* @__PURE__ */ new Map();
+    this.throttleEmitters = /* @__PURE__ */ new Map();
+    this.throttleQueues = /* @__PURE__ */ new Map();
     // TODO: Signals should be a class with a the observers, registered flag and other data.
     this.signalObservers = /* @__PURE__ */ new Map();
     this.emittedSignalsRegistry = /* @__PURE__ */ new Set();
@@ -1470,6 +1477,35 @@ var SignalBroker = class _SignalBroker {
     }
     debouncedEmitter(context);
   }
+  throttle(signal, context, options = { delayMs: 1e3 }) {
+    let { groupId, delayMs = 300 } = options;
+    if (!groupId) {
+      groupId = signal;
+    }
+    if (!this.throttleQueues.has(groupId)) {
+      this.throttleQueues.set(groupId, []);
+    }
+    const queue = this.throttleQueues.get(groupId);
+    queue.push([signal, context]);
+    if (!this.throttleEmitters.has(groupId)) {
+      this.throttleEmitters.set(groupId, async () => {
+        while (queue.length > 0) {
+          let batchSize = options.throttleBatch ?? 1;
+          if (batchSize > queue.length) {
+            batchSize = queue.length;
+          }
+          for (let i = 0; i < batchSize; i++) {
+            const [nextSignal, nextContext] = queue.shift();
+            this.emit(nextSignal, nextContext);
+          }
+          await sleep(delayMs);
+        }
+        this.throttleEmitters.delete(groupId);
+        this.throttleQueues.delete(groupId);
+      });
+      this.throttleEmitters.get(groupId)();
+    }
+  }
   /**
    * Aggregates and debounces multiple events with the same identifier to minimize redundant operations.
    *
@@ -1490,7 +1526,8 @@ var SignalBroker = class _SignalBroker {
       this.squashedEmitters.set(
         squashId,
         debounce_default(() => {
-          this.emit(signal, this.squashedContexts.get(squashId));
+          options.squash = false;
+          this.emit(signal, this.squashedContexts.get(squashId), options);
           this.squashedEmitters.delete(squashId);
           this.squashedContexts.delete(squashId);
         }, delayMs ?? 300)
@@ -2094,11 +2131,6 @@ var SignalEmitter = class {
   }
 };
 
-// src/utils/promise.ts
-function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-
 // src/graph/execution/GraphNode.ts
 var GraphNode = class _GraphNode extends SignalEmitter {
   constructor(task, context, routineExecId, prevNodes = [], debug = false, verbose = false) {
@@ -2342,7 +2374,7 @@ var GraphNode = class _GraphNode extends SignalEmitter {
           },
           filter: { uuid: this.routineExecId }
         },
-        { squash: true, squashId: this.routineExecId }
+        { squash: true, squashId: this.routineExecId, delayMs: 200 }
       );
     }
     if (this.debug && !this.task.isSubMeta && !this.context.getMetadata().__isSubMeta || this.verbose) {
@@ -2403,7 +2435,7 @@ var GraphNode = class _GraphNode extends SignalEmitter {
         },
         filter: { uuid: this.id }
       },
-      { squash: true, squashId: this.id }
+      { squash: true, squashId: this.id, delayMs: 0 }
     );
     if (this.graphDone()) {
       const context2 = this.context.getFullContext();
@@ -2425,7 +2457,7 @@ var GraphNode = class _GraphNode extends SignalEmitter {
           },
           filter: { uuid: this.routineExecId }
         },
-        { squash: true, squashId: this.routineExecId }
+        { squash: true, squashId: this.routineExecId, delayMs: 0 }
       );
     }
     return end;
@@ -3306,7 +3338,7 @@ var GraphRunner = class extends SignalEmitter {
             __executionTraceId: executionTraceId
           }
         },
-        { squash: true, squashId: routineExecId }
+        { squash: true, squashId: routineExecId, delayMs: 200 }
       );
     }
     allTasks.forEach(