@gesslar/actioneer 2.1.0 → 2.3.1

package/src/types/browser/lib/Activity.d.ts

@@ -2,21 +2,31 @@
  * *
  */
 export type ACTIVITY = number;
-/** @typedef {import("./ActionHooks.js").default} ActionHooks */
+/**
+ * @import {default as ActionBuilder} from "./ActionBuilder.js"
+ * @import {default as ActionHooks} from "./ActionHooks.js"
+ * @import {default as ActionWrapper} from "./ActionWrapper.js"
+ **/
 /**
  * Activity bit flags recognised by the builder. The flag decides
  * loop semantics for an activity.
  *
  * @readonly
  * @enum {number}
- * @property {number} WHILE - Execute activity while predicate returns true (2)
- * @property {number} UNTIL - Execute activity until predicate returns true (4)
- * @property {number} SPLIT - Execute activity with split/rejoin pattern for parallel execution (8)
+ * @property {number} WHILE - Execute activity while predicate returns true 1
+ * @property {number} UNTIL - Execute activity until predicate returns true 2
+ * @property {number} SPLIT - Execute activity with split/rejoin pattern for parallel execution 3
+ * @property {number} IF - Execute activity if predicate returns true 4
+ * @property {number} BREAK - Break out of a WHILE/UNTIL if predicate returns true 5
+ * @property {number} CONTINUE - Returns to the top of a WHILE/UNTIL if predicate returns true 6
  */
 export const ACTIVITY: Readonly<{
-    WHILE: number;
-    UNTIL: number;
-    SPLIT: number;
+    WHILE: 1;
+    UNTIL: 2;
+    SPLIT: 3;
+    IF: 4;
+    BREAK: 5;
+    CONTINUE: 6;
 }>;
 export default class Activity {
     /**
@@ -25,23 +35,31 @@ export default class Activity {
      * @param {object} init - Initial properties describing the activity operation, loop semantics, and predicate
      * @param {unknown} init.action - Parent action instance
      * @param {string|symbol} init.name - Activity identifier
-     * @param {(context: unknown) => unknown|Promise<unknown>|import("./ActionBuilder.js").default} init.op - Operation to execute
+     * @param {(context: unknown) => unknown|Promise<unknown>|ActionBuilder} init.op - Operation to execute
      * @param {number} [init.kind] - Optional loop semantics flags
      * @param {(context: unknown) => boolean|Promise<boolean>} [init.pred] - Optional predicate for WHILE/UNTIL
      * @param {ActionHooks} [init.hooks] - Optional hooks instance
      * @param {(context: unknown) => unknown} [init.splitter] - Optional splitter function for SPLIT activities
      * @param {(originalContext: unknown, splitResults: unknown) => unknown} [init.rejoiner] - Optional rejoiner function for SPLIT activities
+     * @param {ActionWrapper} [init.wrapper] - Optional wrapper containing this activity
      */
-    constructor({ action, name, op, kind, pred, hooks, splitter, rejoiner }: {
+    constructor({ action, name, op, kind, pred, hooks, splitter, rejoiner, wrapper }: {
         action: unknown;
         name: string | symbol;
-        op: (context: unknown) => unknown | Promise<unknown> | import("./ActionBuilder.js").default;
+        op: (context: unknown) => unknown | Promise<unknown> | ActionBuilder;
         kind?: number | undefined;
         pred?: ((context: unknown) => boolean | Promise<boolean>) | undefined;
-        hooks?: import("./ActionHooks.js").default | undefined;
+        hooks?: ActionHooks | undefined;
         splitter?: ((context: unknown) => unknown) | undefined;
         rejoiner?: ((originalContext: unknown, splitResults: unknown) => unknown) | undefined;
+        wrapper?: ActionWrapper | undefined;
     });
+    /**
+     * Unique identifier for this activity instance.
+     *
+     * @returns {symbol} Unique symbol identifier
+     */
+    get id(): symbol;
     /**
      * The activity name.
      *
@@ -55,7 +73,7 @@ export default class Activity {
      */
     get kind(): number | null;
     /**
-     * The predicate function for WHILE/UNTIL flows.
+     * The predicate function for WHILE/UNTIL/IF flows.
      *
      * @returns {(context: unknown) => boolean|Promise<boolean>|undefined} - Predicate used to continue/stop loops
      */
@@ -75,19 +93,19 @@ export default class Activity {
     /**
      * The operator to execute (function or nested ActionBuilder).
      *
-     * @returns {(context: unknown) => unknown|Promise<unknown>|import("./ActionBuilder.js").default} - Activity operation
+     * @returns {(context: unknown) => unknown|Promise<unknown>|ActionBuilder} - Activity operation
      */
-    get op(): (context: unknown) => unknown | Promise<unknown> | import("./ActionBuilder.js").default;
+    get op(): (context: unknown) => unknown | Promise<unknown> | ActionBuilder;
     /**
      * The splitter function for SPLIT activities.
      *
-     * @returns {((context: unknown) => unknown)|null} Splitter function or null
+     * @returns {((context: unknown) => unknown)?} Splitter function or null
      */
     get splitter(): ((context: unknown) => unknown) | null;
     /**
      * The rejoiner function for SPLIT activities.
      *
-     * @returns {((originalContext: unknown, splitResults: unknown) => unknown)|null} Rejoiner function or null
+     * @returns {((originalContext: unknown, splitResults: unknown) => unknown)?} Rejoiner function or null
      */
     get rejoiner(): ((originalContext: unknown, splitResults: unknown) => unknown) | null;
     /**
@@ -96,6 +114,13 @@ export default class Activity {
      * @returns {unknown} - Bound action instance
      */
     get action(): unknown;
+    /**
+     * Get the ActionWrapper containing this activity.
+     * Used by BREAK/CONTINUE to signal the parent loop.
+     *
+     * @returns {ActionWrapper?} The wrapper or null
+     */
+    get wrapper(): ActionWrapper | null;
     /**
      * Execute the activity with before/after hooks.
      *
@@ -113,10 +138,12 @@ export default class Activity {
     /**
      * Get the hooks instance attached to this activity.
      *
-     * @returns {ActionHooks|null} The hooks instance or null
+     * @returns {ActionHooks?} The hooks instance or null
      */
     get hooks(): ActionHooks | null;
     #private;
 }
-export type ActionHooks = import("./ActionHooks.js").default;
+import type { default as ActionBuilder } from "./ActionBuilder.js";
+import type { default as ActionWrapper } from "./ActionWrapper.js";
+import type { default as ActionHooks } from "./ActionHooks.js";
 //# sourceMappingURL=Activity.d.ts.map

package/src/types/browser/lib/Activity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Activity.d.ts","sourceRoot":"","sources":["../../../browser/lib/Activity.js"],"names":[],"mappings":";;;uBASU,MAAM;AAPhB,gEAAgE;AAEhE;;;;;;;;;GASG;AACH;;;;GAIE;AAEF;IAoBE;;;;;;;;;;;;OAYG;IACH,yEATG;QAAsB,MAAM,EAApB,OAAO;QACa,IAAI,EAAxB,MAAM,GAAC,MAAM;QAC6E,EAAE,EAA5F,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC,GAAC,OAAO,oBAAoB,EAAE,OAAO;QACrE,IAAI;QACoC,IAAI,cAAhD,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC;QAC3B,KAAK;QACa,QAAQ,cAAnC,OAAO,KAAK,OAAO;QACuC,QAAQ,sBAA1D,OAAO,gBAAgB,OAAO,KAAK,OAAO;KACtE,EAUA;IAED;;;;OAIG;IACH,YAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,YAFa,MAAM,GAAC,IAAI,CAIvB;IAED;;;;OAIG;IACH,YAFa,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC,GAAC,SAAS,CAIpE;IAED;;;;OAIG;IACH,eAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,cAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,UAFa,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC,GAAC,OAAO,oBAAoB,EAAE,OAAO,CAI/F;IAED;;;;OAIG;IACH,gBAFa,CAAC,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,GAAC,IAAI,CAIhD;IAED;;;;OAIG;IACH,gBAFa,CAAC,CAAC,eAAe,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,KAAK,OAAO,CAAC,GAAC,IAAI,CAI/E;IAED;;;;OAIG;IACH,cAFa,OAAO,CAInB;IAED;;;;;OAKG;IACH,aAHW,OAAO,GACL,OAAO,CAAC,OAAO,CAAC,CAa5B;IAED;;;;;OAKG;IACH,sBAHW,WAAW,GACT,IAAI,CAOhB;IAED;;;;OAIG;IACH,aAFa,WAAW,GAAC,IAAI,CAI5B;;CACF;0BAvLa,OAAO,kBAAkB,EAAE,OAAO"}
+{"version":3,"file":"Activity.d.ts","sourceRoot":"","sources":["../../../browser/lib/Activity.js"],"names":[],"mappings":";;;uBAaU,MAAM;AAXhB;;;;IAII;AAEJ;;;;;;;;;;;;GAYG;AACH;;;;;;;GAOE;AAEF;IAwBE;;;;;;;;;;;;;OAaG;IACH,kFAVG;QAAsB,MAAM,EAApB,OAAO;QACa,IAAI,EAAxB,MAAM,GAAC,MAAM;QACsD,EAAE,EAArE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC,GAAC,aAAa;QAC9C,IAAI;QACoC,IAAI,cAAhD,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC;QAC3B,KAAK;QACa,QAAQ,cAAnC,OAAO,KAAK,OAAO;QACuC,QAAQ,sBAA1D,OAAO,gBAAgB,OAAO,KAAK,OAAO;QACvC,OAAO;KACtC,EAWA;IAED;;;;OAIG;IACH,UAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,YAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,YAFa,MAAM,GAAC,IAAI,CAIvB;IAED;;;;OAIG;IACH,YAFa,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC,GAAC,SAAS,CAIpE;IAED;;;;OAIG;IACH,eAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,cAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,UAFa,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC,GAAC,aAAa,CAIxE;IAED;;;;OAIG;IACH,gBAFa,CAAC,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAC,CAI5C;IAED;;;;OAIG;IACH,gBAFa,CAAC,CAAC,eAAe,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,KAAK,OAAO,CAAC,OAAC,CAI3E;IAED;;;;OAIG;IACH,cAFa,OAAO,CAInB;IAED;;;;;OAKG;IACH,eAFa,aAAa,OAAC,CAI1B;IAED;;;;;OAKG;IACH,aAHW,OAAO,GACL,OAAO,CAAC,OAAO,CAAC,CAa5B;IAED;;;;;OAKG;IACH,sBAHW,WAAW,GACT,IAAI,CAOhB;IAED;;;;OAIG;IACH,aAFa,WAAW,OAAC,CAIxB;;CACF;8CAzN0C,oBAAoB;8CAEpB,oBAAoB;4CADtB,kBAAkB"}

package/src/types/browser/lib/Piper.d.ts

@@ -1,18 +1,19 @@
-export default class Piper {
+export default class Piper extends NotifyClass {
     /**
      * Create a Piper instance.
      *
-     * @param {{debug?: (message: string, level?: number, ...args: Array<unknown>) => void}} [config] Optional configuration with debug function
+     * @param {{debug?: (message: string, level?: number, ...args: Array<unknown>) => void}} [config] - Optional configuration with debug function
      */
     constructor({ debug }?: {
         debug?: (message: string, level?: number, ...args: Array<unknown>) => void;
     });
+    get reason(): any;
     /**
      * Add a processing step to the pipeline
      *
-     * @param {(context: unknown) => Promise<unknown>|unknown} fn Function that processes an item
-     * @param {{name?: string, required?: boolean}} [options] Step options
-     * @param {unknown} [newThis] Optional this binding
+     * @param {(context: unknown) => Promise<unknown>|unknown} fn - Function that processes an item
+     * @param {{name?: string, required?: boolean}} [options] - Step options
+     * @param {unknown} [newThis] - Optional this binding
      * @returns {Piper} The pipeline instance (for chaining)
      */
     addStep(fn: (context: unknown) => Promise<unknown> | unknown, options?: {
@@ -49,4 +50,5 @@ export default class Piper {
     }>>;
     #private;
 }
+import { NotifyClass } from "@gesslar/toolkit";
 //# sourceMappingURL=Piper.d.ts.map

package/src/types/browser/lib/Piper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Piper.d.ts","sourceRoot":"","sources":["../../../browser/lib/Piper.js"],"names":[],"mappings":"AAaA;IASE;;;;OAIG;IACH,wBAFW;QAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,CAAA;KAAC,EAItF;IAED;;;;;;;OAOG;IACH,YALW,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,GAAC,OAAO,YAC9C;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAC,YACnC,OAAO,GACL,KAAK,CAWjB;IAED;;;;;;OAMG;IACH,aAJW,MAAM,OAAO,CAAC,IAAI,CAAC,GAAC,IAAI,YACxB,OAAO,GACL,KAAK,CAMjB;IAED;;;;;;OAMG;IACH,eAJW,MAAM,OAAO,CAAC,IAAI,CAAC,GAAC,IAAI,YACxB,OAAO,GACL,KAAK,CAMjB;IAED;;;;;;OAMG;IACH,YAJW,KAAK,CAAC,OAAO,CAAC,GAAC,OAAO,kBACtB,MAAM,GACJ,OAAO,CAAC,KAAK,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAC,CAAC,CAAC,CAuD/E;;CAyCF"}
+{"version":3,"file":"Piper.d.ts","sourceRoot":"","sources":["../../../browser/lib/Piper.js"],"names":[],"mappings":"AAaA;IAWE;;;;OAIG;IACH,wBAFW;QAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,CAAA;KAAC,EAUtF;IAMD,kBAEC;IAED;;;;;;;OAOG;IACH,YALW,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,GAAC,OAAO,YAC9C;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAC,YACnC,OAAO,GACL,KAAK,CAWjB;IAED;;;;;;OAMG;IACH,aAJW,MAAM,OAAO,CAAC,IAAI,CAAC,GAAC,IAAI,YACxB,OAAO,GACL,KAAK,CAMjB;IAED;;;;;;OAMG;IACH,eAJW,MAAM,OAAO,CAAC,IAAI,CAAC,GAAC,IAAI,YACxB,OAAO,GACL,KAAK,CAMjB;IAED;;;;;;OAMG;IACH,YAJW,KAAK,CAAC,OAAO,CAAC,GAAC,OAAO,kBACtB,MAAM,GACJ,OAAO,CAAC,KAAK,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAC,CAAC,CAAC,CA6D/E;;CAuCF;4BA1LkE,kBAAkB"}