@cadenza.io/core 1.12.0 → 3.0.0

package/dist/index.d.mts

@@ -48,8 +48,8 @@ declare class GraphContext {
      * @returns Exported object.
      */
     export(): {
-        __id: string;
-        __context: AnyObject;
+        id: string;
+        context: AnyObject;
     };
 }
 
@@ -258,8 +258,8 @@ declare class GraphNode extends SignalEmitter implements Graph {
         __id: string;
         __task: AnyObject;
         __context: {
-            __id: string;
-            __context: AnyObject;
+            id: string;
+            context: AnyObject;
         };
         __result: TaskResult;
         __executionTime: number;
@@ -280,12 +280,12 @@ declare class GraphNode extends SignalEmitter implements Graph {
     lightExport(): {
         __id: string;
         __task: {
-            __id: string;
             __name: string;
+            __version: number;
         };
         __context: {
-            __id: string;
-            __context: AnyObject;
+            id: string;
+            context: AnyObject;
         };
         __executionTime: number;
         __executionStart: number;
@@ -324,68 +324,6 @@ declare class TaskIterator implements Iterator {
     next(): Task | undefined;
 }
 
-declare class SignalParticipant extends SignalEmitter {
-    emitsSignals: Set<string>;
-    signalsToEmitAfter: Set<string>;
-    signalsToEmitOnFail: Set<string>;
-    observedSignals: Set<string>;
-    /**
-     * Subscribes to signals (chainable).
-     * @param signals The signal names.
-     * @returns This for chaining.
-     * @edge Duplicates ignored; assumes broker.observe binds this as handler.
-     */
-    doOn(...signals: string[]): this;
-    /**
-     * Sets signals to emit post-execution (chainable).
-     * @param signals The signal names.
-     * @returns This for chaining.
-     */
-    emitsAfter(...signals: string[]): this;
-    emitsOnFail(...signals: string[]): this;
-    /**
-     * Unsubscribes from all observed signals.
-     * @returns This for chaining.
-     */
-    unsubscribeAll(): this;
-    /**
-     * Unsubscribes from specific signals.
-     * @param signals The signals.
-     * @returns This for chaining.
-     * @edge No-op if not subscribed.
-     */
-    unsubscribe(...signals: string[]): this;
-    /**
-     * Detaches specific emitted signals.
-     * @param signals The signals.
-     * @returns This for chaining.
-     */
-    detachSignals(...signals: string[]): this;
-    /**
-     * Detaches all emitted signals.
-     * @returns This for chaining.
-     */
-    detachAllSignals(): this;
-    mapSignals(callback: (signal: string) => void): void[];
-    mapOnFailSignals(callback: (signal: string) => void): void[];
-    /**
-     * Emits attached signals.
-     * @param context The context for emission.
-     * @edge If isMeta (from Task), suppresses further "meta.*" to prevent loops.
-     */
-    emitSignals(context: GraphContext): void;
-    /**
-     * Emits attached fail signals.
-     * @param context The context for emission.
-     * @edge If isMeta (from Task), suppresses further "meta.*" to prevent loops.
-     */
-    emitOnFailSignals(context: GraphContext): void;
-    /**
-     * Destroys the participant (unsub/detach).
-     */
-    destroy(): void;
-}
-
 type SchemaType = "string" | "number" | "boolean" | "array" | "object" | "any";
 type SchemaConstraints = {
     min?: number;
@@ -413,10 +351,10 @@ type SchemaDefinition = {
 type TaskFunction = (context: AnyObject, emit: (signal: string, context: AnyObject) => void, progressCallback: (progress: number) => void) => TaskResult;
 type TaskResult = boolean | AnyObject | Generator | Promise<any> | void;
 type ThrottleTagGetter = (context?: AnyObject, task?: Task) => string;
-declare class Task extends SignalParticipant implements Graph {
-    id: string;
+declare class Task extends SignalEmitter implements Graph {
     readonly name: string;
     readonly description: string;
+    version: number;
     concurrency: number;
     timeout: number;
     readonly isMeta: boolean;
@@ -442,6 +380,10 @@ declare class Task extends SignalParticipant implements Graph {
     onFailTasks: Set<Task>;
     predecessorTasks: Set<Task>;
     destroyed: boolean;
+    emitsSignals: Set<string>;
+    signalsToEmitAfter: Set<string>;
+    signalsToEmitOnFail: Set<string>;
+    observedSignals: Set<string>;
     readonly taskFunction: TaskFunction;
     /**
      * Constructs a Task (static definition).
@@ -468,7 +410,7 @@ declare class Task extends SignalParticipant implements Graph {
      */
     constructor(name: string, task: TaskFunction, description?: string, concurrency?: number, timeout?: number, register?: boolean, isUnique?: boolean, isMeta?: boolean, isSubMeta?: boolean, isHidden?: boolean, getTagCallback?: ThrottleTagGetter | undefined, inputSchema?: SchemaDefinition | undefined, validateInputContext?: boolean, outputSchema?: SchemaDefinition | undefined, validateOutputContext?: boolean, retryCount?: number, retryDelay?: number, retryDelayMax?: number, retryDelayFactor?: number);
     getTag(context?: AnyObject): string;
-    setGlobalId(id: string): void;
+    setVersion(version: number): void;
     setTimeout(timeout: number): void;
     setConcurrency(concurrency: number): void;
     setProgressWeight(weight: number): void;
@@ -505,13 +447,63 @@ declare class Task extends SignalParticipant implements Graph {
     doAfter(...tasks: Task[]): this;
     then(...tasks: Task[]): this;
     decouple(task: Task): void;
-    doOnFail(...tasks: Task[]): this;
     updateProgressWeights(): void;
     getSubgraphLayers(): Map<number, Set<Task>>;
     updateLayerFromPredecessors(): void;
     hasCycle(): boolean;
     mapNext(callback: (task: Task) => any, failed?: boolean): any[];
     mapPrevious(callback: (task: Task) => any): any[];
+    /**
+     * Subscribes to signals (chainable).
+     * @param signals The signal names.
+     * @returns This for chaining.
+     * @edge Duplicates ignored; assumes broker.observe binds this as handler.
+     */
+    doOn(...signals: string[]): this;
+    /**
+     * Sets signals to emit post-execution (chainable).
+     * @param signals The signal names.
+     * @returns This for chaining.
+     */
+    emits(...signals: string[]): this;
+    emitsOnFail(...signals: string[]): this;
+    /**
+     * Unsubscribes from all observed signals.
+     * @returns This for chaining.
+     */
+    unsubscribeAll(): this;
+    /**
+     * Unsubscribes from specific signals.
+     * @param signals The signals.
+     * @returns This for chaining.
+     * @edge No-op if not subscribed.
+     */
+    unsubscribe(...signals: string[]): this;
+    /**
+     * Detaches specific emitted signals.
+     * @param signals The signals.
+     * @returns This for chaining.
+     */
+    detachSignals(...signals: string[]): this;
+    /**
+     * Detaches all emitted signals.
+     * @returns This for chaining.
+     */
+    detachAllSignals(): this;
+    mapSignals(callback: (signal: string) => void): void[];
+    mapOnFailSignals(callback: (signal: string) => void): void[];
+    /**
+     * Emits attached signals.
+     * @param context The context for emission.
+     * @edge If isMeta (from Task), suppresses further "meta.*" to prevent loops.
+     */
+    emitSignals(context: GraphContext): void;
+    /**
+     * Emits attached fail signals.
+     * @param context The context for emission.
+     * @edge If isMeta (from Task), suppresses further "meta.*" to prevent loops.
+     */
+    emitOnFailSignals(context: GraphContext): void;
     destroy(): void;
     export(): AnyObject;
     getIterator(): TaskIterator;
@@ -578,12 +570,13 @@ declare class GraphRun {
     setExporter(exporter: GraphExporter): void;
 }
 
-declare class GraphRoutine extends SignalParticipant {
-    id: string;
+declare class GraphRoutine extends SignalEmitter {
     readonly name: string;
+    version: number;
     readonly description: string;
     readonly isMeta: boolean;
     tasks: Set<Task>;
+    observedSignals: Set<string>;
     constructor(name: string, tasks: Task[], description: string, isMeta?: boolean);
     /**
      * Applies callback to starting tasks.
@@ -592,10 +585,29 @@ declare class GraphRoutine extends SignalParticipant {
      */
     forEachTask(callBack: (task: Task) => any): Promise<void>;
     /**
-     * Sets global ID.
-     * @param id The ID.
+     * Sets global Version.
+     * @param version The Version.
+     */
+    setVersion(version: number): void;
+    /**
+     * Subscribes to signals (chainable).
+     * @param signals The signal names.
+     * @returns This for chaining.
+     * @edge Duplicates ignored; assumes broker.observe binds this as handler.
+     */
+    doOn(...signals: string[]): this;
+    /**
+     * Unsubscribes from all observed signals.
+     * @returns This for chaining.
      */
-    setGlobalId(id: string): void;
+    unsubscribeAll(): this;
+    /**
+     * Unsubscribes from specific signals.
+     * @param signals The signals.
+     * @returns This for chaining.
+     * @edge No-op if not subscribed.
+     */
+    unsubscribe(...signals: string[]): this;
     /**
      * Destroys the routine.
      */
@@ -603,7 +615,6 @@ declare class GraphRoutine extends SignalParticipant {
 }
 
 declare class GraphRunner extends SignalEmitter {
-    readonly id: string;
     currentRun: GraphRun;
     debug: boolean;
     verbose: boolean;
@@ -710,18 +721,14 @@ declare class GraphRegistry {
     tasks: Map<string, Task>;
     routines: Map<string, GraphRoutine>;
     registerTask: Task;
-    updateTaskId: Task;
     updateTaskInputSchema: Task;
     updateTaskOutputSchema: Task;
-    getTaskById: Task;
     getTaskByName: Task;
     getTasksByLayer: Task;
     getAllTasks: Task;
     doForEachTask: Task;
     deleteTask: Task;
     registerRoutine: Task;
-    updateRoutineId: Task;
-    getRoutineById: Task;
     getRoutineByName: Task;
     getAllRoutines: Task;
     doForEachRoutine: Task;
@@ -944,4 +951,4 @@ declare class SignalTask extends Task {
     constructor(signal: string, description?: string);
 }
 
-export { type AnyObject, type CadenzaMode, type DebounceOptions, DebounceTask, EphemeralTask, type EphemeralTaskOptions, GraphContext, GraphRegistry, GraphRoutine, GraphRun, GraphRunner, type SchemaConstraints, type SchemaDefinition, type SchemaType, SignalBroker, SignalEmitter, SignalParticipant, SignalTask, Task, type TaskFunction, type TaskOptions, type TaskResult, type ThrottleTagGetter, Cadenza as default };
+export { type AnyObject, type CadenzaMode, type DebounceOptions, DebounceTask, EphemeralTask, type EphemeralTaskOptions, GraphContext, GraphRegistry, GraphRoutine, GraphRun, GraphRunner, type SchemaConstraints, type SchemaDefinition, type SchemaType, SignalBroker, SignalEmitter, SignalTask, Task, type TaskFunction, type TaskOptions, type TaskResult, type ThrottleTagGetter, Cadenza as default };

package/dist/index.d.ts

@@ -48,8 +48,8 @@ declare class GraphContext {
      * @returns Exported object.
      */
     export(): {
-        __id: string;
-        __context: AnyObject;
+        id: string;
+        context: AnyObject;
     };
 }
 
@@ -258,8 +258,8 @@ declare class GraphNode extends SignalEmitter implements Graph {
         __id: string;
         __task: AnyObject;
         __context: {
-            __id: string;
-            __context: AnyObject;
+            id: string;
+            context: AnyObject;
         };
         __result: TaskResult;
         __executionTime: number;
@@ -280,12 +280,12 @@ declare class GraphNode extends SignalEmitter implements Graph {
     lightExport(): {
         __id: string;
         __task: {
-            __id: string;
             __name: string;
+            __version: number;
         };
         __context: {
-            __id: string;
-            __context: AnyObject;
+            id: string;
+            context: AnyObject;
         };
         __executionTime: number;
         __executionStart: number;
@@ -324,68 +324,6 @@ declare class TaskIterator implements Iterator {
     next(): Task | undefined;
 }
 
-declare class SignalParticipant extends SignalEmitter {
-    emitsSignals: Set<string>;
-    signalsToEmitAfter: Set<string>;
-    signalsToEmitOnFail: Set<string>;
-    observedSignals: Set<string>;
-    /**
-     * Subscribes to signals (chainable).
-     * @param signals The signal names.
-     * @returns This for chaining.
-     * @edge Duplicates ignored; assumes broker.observe binds this as handler.
-     */
-    doOn(...signals: string[]): this;
-    /**
-     * Sets signals to emit post-execution (chainable).
-     * @param signals The signal names.
-     * @returns This for chaining.
-     */
-    emitsAfter(...signals: string[]): this;
-    emitsOnFail(...signals: string[]): this;
-    /**
-     * Unsubscribes from all observed signals.
-     * @returns This for chaining.
-     */
-    unsubscribeAll(): this;
-    /**
-     * Unsubscribes from specific signals.
-     * @param signals The signals.
-     * @returns This for chaining.
-     * @edge No-op if not subscribed.
-     */
-    unsubscribe(...signals: string[]): this;
-    /**
-     * Detaches specific emitted signals.
-     * @param signals The signals.
-     * @returns This for chaining.
-     */
-    detachSignals(...signals: string[]): this;
-    /**
-     * Detaches all emitted signals.
-     * @returns This for chaining.
-     */
-    detachAllSignals(): this;
-    mapSignals(callback: (signal: string) => void): void[];
-    mapOnFailSignals(callback: (signal: string) => void): void[];
-    /**
-     * Emits attached signals.
-     * @param context The context for emission.
-     * @edge If isMeta (from Task), suppresses further "meta.*" to prevent loops.
-     */
-    emitSignals(context: GraphContext): void;
-    /**
-     * Emits attached fail signals.
-     * @param context The context for emission.
-     * @edge If isMeta (from Task), suppresses further "meta.*" to prevent loops.
-     */
-    emitOnFailSignals(context: GraphContext): void;
-    /**
-     * Destroys the participant (unsub/detach).
-     */
-    destroy(): void;
-}
-
 type SchemaType = "string" | "number" | "boolean" | "array" | "object" | "any";
 type SchemaConstraints = {
     min?: number;
@@ -413,10 +351,10 @@ type SchemaDefinition = {
 type TaskFunction = (context: AnyObject, emit: (signal: string, context: AnyObject) => void, progressCallback: (progress: number) => void) => TaskResult;
 type TaskResult = boolean | AnyObject | Generator | Promise<any> | void;
 type ThrottleTagGetter = (context?: AnyObject, task?: Task) => string;
-declare class Task extends SignalParticipant implements Graph {
-    id: string;
+declare class Task extends SignalEmitter implements Graph {
     readonly name: string;
     readonly description: string;
+    version: number;
     concurrency: number;
     timeout: number;
     readonly isMeta: boolean;
@@ -442,6 +380,10 @@ declare class Task extends SignalParticipant implements Graph {
     onFailTasks: Set<Task>;
     predecessorTasks: Set<Task>;
     destroyed: boolean;
+    emitsSignals: Set<string>;
+    signalsToEmitAfter: Set<string>;
+    signalsToEmitOnFail: Set<string>;
+    observedSignals: Set<string>;
     readonly taskFunction: TaskFunction;
     /**
      * Constructs a Task (static definition).
@@ -468,7 +410,7 @@ declare class Task extends SignalParticipant implements Graph {
      */
     constructor(name: string, task: TaskFunction, description?: string, concurrency?: number, timeout?: number, register?: boolean, isUnique?: boolean, isMeta?: boolean, isSubMeta?: boolean, isHidden?: boolean, getTagCallback?: ThrottleTagGetter | undefined, inputSchema?: SchemaDefinition | undefined, validateInputContext?: boolean, outputSchema?: SchemaDefinition | undefined, validateOutputContext?: boolean, retryCount?: number, retryDelay?: number, retryDelayMax?: number, retryDelayFactor?: number);
     getTag(context?: AnyObject): string;
-    setGlobalId(id: string): void;
+    setVersion(version: number): void;
     setTimeout(timeout: number): void;
     setConcurrency(concurrency: number): void;
     setProgressWeight(weight: number): void;
@@ -505,13 +447,63 @@ declare class Task extends SignalParticipant implements Graph {
     doAfter(...tasks: Task[]): this;
     then(...tasks: Task[]): this;
     decouple(task: Task): void;
-    doOnFail(...tasks: Task[]): this;
     updateProgressWeights(): void;
     getSubgraphLayers(): Map<number, Set<Task>>;
     updateLayerFromPredecessors(): void;
     hasCycle(): boolean;
     mapNext(callback: (task: Task) => any, failed?: boolean): any[];
     mapPrevious(callback: (task: Task) => any): any[];
+    /**
+     * Subscribes to signals (chainable).
+     * @param signals The signal names.
+     * @returns This for chaining.
+     * @edge Duplicates ignored; assumes broker.observe binds this as handler.
+     */
+    doOn(...signals: string[]): this;
+    /**
+     * Sets signals to emit post-execution (chainable).
+     * @param signals The signal names.
+     * @returns This for chaining.
+     */
+    emits(...signals: string[]): this;
+    emitsOnFail(...signals: string[]): this;
+    /**
+     * Unsubscribes from all observed signals.
+     * @returns This for chaining.
+     */
+    unsubscribeAll(): this;
+    /**
+     * Unsubscribes from specific signals.
+     * @param signals The signals.
+     * @returns This for chaining.
+     * @edge No-op if not subscribed.
+     */
+    unsubscribe(...signals: string[]): this;
+    /**
+     * Detaches specific emitted signals.
+     * @param signals The signals.
+     * @returns This for chaining.
+     */
+    detachSignals(...signals: string[]): this;
+    /**
+     * Detaches all emitted signals.
+     * @returns This for chaining.
+     */
+    detachAllSignals(): this;
+    mapSignals(callback: (signal: string) => void): void[];
+    mapOnFailSignals(callback: (signal: string) => void): void[];
+    /**
+     * Emits attached signals.
+     * @param context The context for emission.
+     * @edge If isMeta (from Task), suppresses further "meta.*" to prevent loops.
+     */
+    emitSignals(context: GraphContext): void;
+    /**
+     * Emits attached fail signals.
+     * @param context The context for emission.
+     * @edge If isMeta (from Task), suppresses further "meta.*" to prevent loops.
+     */
+    emitOnFailSignals(context: GraphContext): void;
     destroy(): void;
     export(): AnyObject;
     getIterator(): TaskIterator;
@@ -578,12 +570,13 @@ declare class GraphRun {
     setExporter(exporter: GraphExporter): void;
 }
 
-declare class GraphRoutine extends SignalParticipant {
-    id: string;
+declare class GraphRoutine extends SignalEmitter {
     readonly name: string;
+    version: number;
     readonly description: string;
     readonly isMeta: boolean;
     tasks: Set<Task>;
+    observedSignals: Set<string>;
     constructor(name: string, tasks: Task[], description: string, isMeta?: boolean);
     /**
      * Applies callback to starting tasks.
@@ -592,10 +585,29 @@ declare class GraphRoutine extends SignalParticipant {
      */
     forEachTask(callBack: (task: Task) => any): Promise<void>;
     /**
-     * Sets global ID.
-     * @param id The ID.
+     * Sets global Version.
+     * @param version The Version.
+     */
+    setVersion(version: number): void;
+    /**
+     * Subscribes to signals (chainable).
+     * @param signals The signal names.
+     * @returns This for chaining.
+     * @edge Duplicates ignored; assumes broker.observe binds this as handler.
+     */
+    doOn(...signals: string[]): this;
+    /**
+     * Unsubscribes from all observed signals.
+     * @returns This for chaining.
      */
-    setGlobalId(id: string): void;
+    unsubscribeAll(): this;
+    /**
+     * Unsubscribes from specific signals.
+     * @param signals The signals.
+     * @returns This for chaining.
+     * @edge No-op if not subscribed.
+     */
+    unsubscribe(...signals: string[]): this;
     /**
      * Destroys the routine.
      */
@@ -603,7 +615,6 @@ declare class GraphRoutine extends SignalParticipant {
 }
 
 declare class GraphRunner extends SignalEmitter {
-    readonly id: string;
     currentRun: GraphRun;
     debug: boolean;
     verbose: boolean;
@@ -710,18 +721,14 @@ declare class GraphRegistry {
     tasks: Map<string, Task>;
     routines: Map<string, GraphRoutine>;
     registerTask: Task;
-    updateTaskId: Task;
     updateTaskInputSchema: Task;
     updateTaskOutputSchema: Task;
-    getTaskById: Task;
     getTaskByName: Task;
     getTasksByLayer: Task;
     getAllTasks: Task;
     doForEachTask: Task;
     deleteTask: Task;
     registerRoutine: Task;
-    updateRoutineId: Task;
-    getRoutineById: Task;
     getRoutineByName: Task;
     getAllRoutines: Task;
     doForEachRoutine: Task;
@@ -944,4 +951,4 @@ declare class SignalTask extends Task {
     constructor(signal: string, description?: string);
 }
 
-export { type AnyObject, type CadenzaMode, type DebounceOptions, DebounceTask, EphemeralTask, type EphemeralTaskOptions, GraphContext, GraphRegistry, GraphRoutine, GraphRun, GraphRunner, type SchemaConstraints, type SchemaDefinition, type SchemaType, SignalBroker, SignalEmitter, SignalParticipant, SignalTask, Task, type TaskFunction, type TaskOptions, type TaskResult, type ThrottleTagGetter, Cadenza as default };
+export { type AnyObject, type CadenzaMode, type DebounceOptions, DebounceTask, EphemeralTask, type EphemeralTaskOptions, GraphContext, GraphRegistry, GraphRoutine, GraphRun, GraphRunner, type SchemaConstraints, type SchemaDefinition, type SchemaType, SignalBroker, SignalEmitter, SignalTask, Task, type TaskFunction, type TaskOptions, type TaskResult, type ThrottleTagGetter, Cadenza as default };