@cadenza.io/core 3.19.2 → 3.19.4

package/dist/index.mjs

@@ -1272,6 +1272,36 @@ var SignalBroker = class _SignalBroker {
   setVerbose(value) {
     this.verbose = value;
   }
+  // Dor debugging
+  logMemoryFootprint(label = "current") {
+    console.log(`[${label}] SignalBroker state sizes:`);
+    console.log(`  \u2022 signalObservers entries: ${this.signalObservers.size}`);
+    console.log(
+      `  \u2022 emittedSignalsRegistry size: ${this.emittedSignalsRegistry.size}`
+    );
+    let totalSquashContexts = 0;
+    let totalSquashGroups = 0;
+    for (const groups of this.strategyData.values()) {
+      totalSquashGroups += groups.size;
+      for (const data of groups.values()) {
+        totalSquashContexts += data.contexts.length;
+      }
+    }
+    console.log(`  \u2022 Active squash groups: ${totalSquashGroups}`);
+    console.log(`  \u2022 Total queued squash contexts: ${totalSquashContexts}`);
+    let totalDebouncers = this.debouncedEmitters.size;
+    console.log(`  \u2022 Active debouncers: ${totalDebouncers}`);
+    let totalThrottleQueues = 0;
+    for (const q of this.throttleQueues.values()) {
+      totalThrottleQueues += q.length;
+    }
+    console.log(`  \u2022 Total items in throttle queues: ${totalThrottleQueues}`);
+    let totalScheduled = 0;
+    for (const bucket of this.scheduledBuckets.values()) {
+      totalScheduled += bucket.length;
+    }
+    console.log(`  \u2022 Pending scheduled items: ${totalScheduled}`);
+  }
   /**
    * Validates the provided signal name string to ensure it adheres to specific formatting rules.
    * Throws an error if any of the validation checks fail.
@@ -1467,7 +1497,8 @@ var SignalBroker = class _SignalBroker {
       delay = options.exactDateTime.getTime() - Date.now();
     }
     delay = Math.max(0, delay);
-    const bucketKey = Math.ceil(delay / 100) * 100;
+    const dueAt = Date.now() + delay;
+    const bucketKey = Math.ceil(dueAt / 100) * 100;
     let bucket = this.scheduledBuckets.get(bucketKey);
     if (!bucket) {
       bucket = [];
@@ -3572,9 +3603,9 @@ var Task = class _Task extends SignalEmitter {
    * @param {boolean} [isSubMeta=false] - Indicates if the task is a sub-meta-task.
    * @param {boolean} [isHidden=false] - Determines if the task is hidden and not exposed publicly.
    * @param {ThrottleTagGetter} [getTagCallback=undefined] - A callback to generate a throttle tag for the task.
-   * @param {SchemaDefinition} [inputSchema=undefined] - The input schema for validating the task's input context.
+   * @param {Schema} [inputSchema=undefined] - The input schema for validating the task's input context.
    * @param {boolean} [validateInputContext=false] - Specifies if the input context should be validated against the input schema.
-   * @param {SchemaDefinition} [outputSchema=undefined] - The output schema for validating the task's output context.
+   * @param {Schema} [outputSchema=undefined] - The output schema for validating the task's output context.
    * @param {boolean} [validateOutputContext=false] - Specifies if the output context should be validated against the output schema.
    * @param {number} [retryCount=0] - The number of retry attempts allowed for the task in case of failure.
    * @param {number} [retryDelay=0] - The initial delay (in milliseconds) between retry attempts.
@@ -3819,14 +3850,27 @@ var Task = class _Task extends SignalEmitter {
    * Validates a data object against a specified schema definition and returns validation results.
    *
    * @param {any} data - The target object to validate against the schema.
-   * @param {SchemaDefinition | undefined} schema - The schema definition describing the expected structure and constraints of the data.
+   * @param {Schema | undefined} schema - The schema definition describing the expected structure and constraints of the data.
    * @param {string} [path="context"] - The base path or context for traversing the data, used in generating error messages.
    * @return {{ valid: boolean, errors: Record<string, string> }} - An object containing a validity flag (`valid`)
    * and a map (`errors`) of validation error messages keyed by property paths.
    */
   validateSchema(data, schema, path = "context") {
     const errors = {};
-    if (!schema || typeof schema !== "object") return { valid: true, errors };
+    if (!schema || typeof schema !== "object" && !Array.isArray(schema))
+      return { valid: true, errors };
+    if (Array.isArray(schema)) {
+      for (const s of schema) {
+        const subValidation = this.validateSchema(data, s, path);
+        if (!subValidation.valid) {
+          Object.assign(errors, subValidation.errors);
+        }
+        if (subValidation.valid) {
+          return { valid: true, errors: {} };
+        }
+      }
+      return { valid: false, errors };
+    }
     const required = schema.required || [];
     for (const key of required) {
       if (!(key in data)) {
@@ -3837,84 +3881,12 @@ var Task = class _Task extends SignalEmitter {
     for (const [key, value] of Object.entries(data)) {
       if (key in properties) {
         const prop = properties[key];
-        const propType = prop.type;
-        if (propType === "any") {
-          continue;
-        }
-        if ((value === void 0 || value === null) && !prop.strict) {
-          continue;
-        }
-        if (propType === "string" && typeof value !== "string") {
-          errors[`${path}.${key}`] = `Expected 'string' for '${key}', got '${typeof value}'`;
-        } else if (propType === "number" && typeof value !== "number") {
-          errors[`${path}.${key}`] = `Expected 'number' for '${key}', got '${typeof value}'`;
-        } else if (propType === "boolean" && typeof value !== "boolean") {
-          errors[`${path}.${key}`] = `Expected 'boolean' for '${key}', got '${typeof value}'`;
-        } else if (propType === "array" && !Array.isArray(value)) {
-          errors[`${path}.${key}`] = `Expected 'array' for '${key}', got '${typeof value}'`;
-        } else if (propType === "object" && (typeof value !== "object" || value === null || Array.isArray(value))) {
-          errors[`${path}.${key}`] = `Expected 'object' for '${key}', got '${typeof value}'`;
-        } else if (propType === "array" && prop.items) {
-          if (Array.isArray(value)) {
-            value.forEach((item, index) => {
-              const subValidation = this.validateSchema(
-                item,
-                prop.items,
-                `${path}.${key}[${index}]`
-              );
-              if (!subValidation.valid) {
-                Object.assign(errors, subValidation.errors);
-              }
-            });
-          }
-        } else if (propType === "object" && !Array.isArray(value) && value !== null) {
-          const subValidation = this.validateSchema(
-            value,
-            prop,
-            `${path}.${key}`
-          );
-          if (!subValidation.valid) {
-            Object.assign(errors, subValidation.errors);
-          }
-        }
-        const constraints = prop.constraints || {};
-        if (typeof value === "string") {
-          if (constraints.minLength && value.length < constraints.minLength) {
-            errors[`${path}.${key}`] = `String '${key}' shorter than minLength ${constraints.minLength}`;
-          }
-          if (constraints.maxLength && value.length > constraints.maxLength) {
-            errors[`${path}.${key}`] = `String '${key}' exceeds maxLength ${constraints.maxLength}`;
-          }
-          if (constraints.pattern && !new RegExp(constraints.pattern).test(value)) {
-            errors[`${path}.${key}`] = `String '${key}' does not match pattern ${constraints.pattern}`;
-          }
-        } else if (typeof value === "number") {
-          if (constraints.min && value < constraints.min) {
-            errors[`${path}.${key}`] = `Number '${key}' below min ${constraints.min}`;
+        if (Array.isArray(prop)) {
+          for (const p of prop) {
+            Object.assign(errors, this.validateProp(p, key, value, path));
           }
-          if (constraints.max && value > constraints.max) {
-            errors[`${path}.${key}`] = `Number '${key}' exceeds max ${constraints.max}`;
-          }
-          if (constraints.multipleOf && value % constraints.multipleOf !== 0) {
-            errors[`${path}.${key}`] = `Number '${key}' not multiple of ${constraints.multipleOf}`;
-          }
-        } else if (constraints.enum && !constraints.enum.includes(value)) {
-          errors[`${path}.${key}`] = `Value '${value}' for '${key}' not in enum ${JSON.stringify(constraints.enum)}`;
-        } else if (constraints.format) {
-          const formats = {
-            email: /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/,
-            url: /^(https?|ftp):\/\/[^\s/$.?#].[^\s]*$/,
-            "date-time": /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})?$/,
-            uuid: /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
-            custom: /.*/
-            // Placeholder; override with prop.constraints.pattern if present
-          };
-          const regex = formats[constraints.format] || new RegExp(constraints.pattern || ".*");
-          if (typeof value === "string" && !regex.test(value)) {
-            errors[`${path}.${key}`] = `Value '${value}' for '${key}' does not match format '${constraints.format}'`;
-          }
-        } else if (constraints.oneOf && !constraints.oneOf.includes(value)) {
-          errors[`${path}.${key}`] = `Value '${value}' for '${key}' not in oneOf ${JSON.stringify(constraints.oneOf)}`;
+        } else {
+          Object.assign(errors, this.validateProp(prop, key, value, path));
         }
       } else if (schema.strict) {
         errors[`${path}.${key}`] = `Key '${key}' is not allowed`;
@@ -3925,6 +3897,83 @@ var Task = class _Task extends SignalEmitter {
     }
     return { valid: true, errors: {} };
   }
+  validateProp(prop, key, value, path = "context") {
+    const propType = prop.type;
+    const errors = {};
+    if (propType === "any") {
+      return errors;
+    }
+    if ((value === void 0 || value === null) && !prop.strict) {
+      return errors;
+    }
+    if (propType === "string" && typeof value !== "string") {
+      errors[`${path}.${key}`] = `Expected 'string' for '${key}', got '${typeof value}'`;
+    } else if (propType === "number" && typeof value !== "number") {
+      errors[`${path}.${key}`] = `Expected 'number' for '${key}', got '${typeof value}'`;
+    } else if (propType === "boolean" && typeof value !== "boolean") {
+      errors[`${path}.${key}`] = `Expected 'boolean' for '${key}', got '${typeof value}'`;
+    } else if (propType === "array" && !Array.isArray(value)) {
+      errors[`${path}.${key}`] = `Expected 'array' for '${key}', got '${typeof value}'`;
+    } else if (propType === "object" && (typeof value !== "object" || value === null || Array.isArray(value))) {
+      errors[`${path}.${key}`] = `Expected 'object' for '${key}', got '${typeof value}'`;
+    } else if (propType === "array" && prop.items) {
+      value.forEach((item, index) => {
+        const subValidation = this.validateSchema(
+          item,
+          prop.items,
+          `${path}.${key}[${index}]`
+        );
+        if (!subValidation.valid) {
+          Object.assign(errors, subValidation.errors);
+        }
+      });
+    } else if (propType === "object" && !Array.isArray(value) && value !== null) {
+      const subValidation = this.validateSchema(value, prop, `${path}.${key}`);
+      if (!subValidation.valid) {
+        Object.assign(errors, subValidation.errors);
+      }
+    }
+    const constraints = prop.constraints || {};
+    if (typeof value === "string") {
+      if (constraints.minLength && value.length < constraints.minLength) {
+        errors[`${path}.${key}`] = `String '${key}' shorter than minLength ${constraints.minLength}`;
+      }
+      if (constraints.maxLength && value.length > constraints.maxLength) {
+        errors[`${path}.${key}`] = `String '${key}' exceeds maxLength ${constraints.maxLength}`;
+      }
+      if (constraints.pattern && !new RegExp(constraints.pattern).test(value)) {
+        errors[`${path}.${key}`] = `String '${key}' does not match pattern ${constraints.pattern}`;
+      }
+    } else if (typeof value === "number") {
+      if (constraints.min && value < constraints.min) {
+        errors[`${path}.${key}`] = `Number '${key}' below min ${constraints.min}`;
+      }
+      if (constraints.max && value > constraints.max) {
+        errors[`${path}.${key}`] = `Number '${key}' exceeds max ${constraints.max}`;
+      }
+      if (constraints.multipleOf && value % constraints.multipleOf !== 0) {
+        errors[`${path}.${key}`] = `Number '${key}' not multiple of ${constraints.multipleOf}`;
+      }
+    } else if (constraints.enum && !constraints.enum.includes(value)) {
+      errors[`${path}.${key}`] = `Value '${value}' for '${key}' not in enum ${JSON.stringify(constraints.enum)}`;
+    } else if (constraints.format) {
+      const formats = {
+        email: /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/,
+        url: /^(https?|ftp):\/\/[^\s/$.?#].[^\s]*$/,
+        "date-time": /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})?$/,
+        uuid: /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
+        custom: /.*/
+        // Placeholder; override with prop.constraints.pattern if present
+      };
+      const regex = formats[constraints.format] || new RegExp(constraints.pattern || ".*");
+      if (typeof value === "string" && !regex.test(value)) {
+        errors[`${path}.${key}`] = `Value '${value}' for '${key}' does not match format '${constraints.format}'`;
+      }
+    } else if (constraints.oneOf && !constraints.oneOf.includes(value)) {
+      errors[`${path}.${key}`] = `Value '${value}' for '${key}' not in oneOf ${JSON.stringify(constraints.oneOf)}`;
+    }
+    return errors;
+  }
   /**
    * Validates the input context against the predefined schema and emits metadata if validation fails.
    *
@@ -5967,8 +6016,11 @@ var Cadenza = class {
   static emit(event, data = {}, options = {}) {
     this.signalBroker?.emit(event, data, options);
   }
-  static schedule(taskName, context, delayMs, exactDateTime) {
-    this.signalBroker?.schedule(taskName, context, { delayMs, exactDateTime });
+  static schedule(signalName, context, delayMs, exactDateTime) {
+    this.signalBroker?.schedule(signalName, context, {
+      delayMs,
+      exactDateTime
+    });
   }
   static interval(taskName, context, intervalMs, leading = false, startDateTime) {
     this.signalBroker?.interval(