@gesslar/actioneer 2.0.2 → 2.1.0

package/package.json

@@ -5,7 +5,7 @@
     "name": "gesslar",
     "url": "https://gesslar.dev"
   },
-  "version": "2.0.2",
+  "version": "2.1.0",
   "license": "Unlicense",
   "homepage": "https://github.com/gesslar/toolkit#readme",
   "repository": {
@@ -49,19 +49,19 @@
     "node": ">=22"
   },
   "dependencies": {
-    "@gesslar/toolkit": "^3.6.2"
+    "@gesslar/toolkit": "^3.23.0"
   },
   "devDependencies": {
-    "@gesslar/uglier": "^0.5.0",
+    "@gesslar/uglier": "^1.1.0",
     "eslint": "^9.39.2",
     "typescript": "^5.9.3"
   },
   "scripts": {
     "lint": "eslint src/",
     "lint:fix": "eslint src/ --fix",
-    "types:build": "tsc -p tsconfig.types.json",
+    "types": "node -e \"require('fs').rmSync('types',{recursive:true,force:true});\" && tsc -p tsconfig.types.json",
     "submit": "pnpm publish --access public --//registry.npmjs.org/:_authToken=\"${NPM_ACCESS_TOKEN}\"",
-    "update": "pnpm up --latest --recursive",
+    "update": "pnpm self-update && pnpx npm-check-updates -u && pnpm install",
     "test": "node --test tests/**/*.test.js",
     "test:browser": "node --test tests/browser/*.test.js",
     "test:node": "node --test tests/node/*.test.js",

package/src/browser/lib/ActionBuilder.js

@@ -69,6 +69,7 @@ export default class ActionBuilder {
   #hooksFile = null
   #hooksKind = null
   #hooks = null
+  #done = null
 
   /**
    * Creates a new ActionBuilder instance with the provided action callback.
@@ -246,6 +247,19 @@ export default class ActionBuilder {
     return this
   }
 
+  /**
+   * Register a callback to be executed after all activities complete.
+   *
+   * @param {ActionFunction} callback Function to execute at the end of the pipeline.
+   * @returns {ActionBuilder} The builder instance for chaining.
+   */
+  done(callback) {
+    Valid.type(callback, "Function")
+    this.#done = callback
+
+    return this
+  }
+
   /**
    * Validates that an activity name has not been reused.
    *
@@ -281,6 +295,8 @@ export default class ActionBuilder {
       activities: this.#activities,
       debug: this.#debug,
       hooks,
+      done: this.#done,
+      action: this.#action,
     })
   }
 

package/src/browser/lib/ActionRunner.js

@@ -7,10 +7,15 @@ import Piper from "./Piper.js"
  * @typedef {(message: string, level?: number, ...args: Array<unknown>) => void} DebugFn
  */
 
+/**
+ * @typedef {import("./ActionBuilder.js").default} ActionBuilder
+ */
+
 /**
  * @typedef {object} ActionRunnerOptions
  * @property {DebugFn} [debug] Logger function.
  */
+
 /**
  * Orchestrates execution of {@link ActionBuilder}-produced pipelines.
  *
@@ -71,95 +76,109 @@ export default class ActionRunner extends Piper {
     const actionWrapper = this.#actionWrapper
     const activities = actionWrapper.activities
 
-    for(const activity of activities) {
-      try {
-        // await timeout(500)
-
-        const kind = activity.kind
+    try {
+      for(const activity of activities) {
+        try {
+          // await timeout(500)
 
-        // If we have no kind, then it's just a once.
-        // Get it over and done with!
-        if(!kind) {
-          context = await this.#execute(activity, context)
-        } else {
-          // Validate that only one activity kind bit is set
-          // (kind & (kind - 1)) !== 0 means multiple bits are set
-          const multipleBitsSet = (kind & (kind - 1)) !== 0
-          if(multipleBitsSet)
-            throw Sass.new(
-              "For Kathy Griffin's sake! You can't combine activity kinds. " +
-              "Pick one: WHILE, UNTIL, or SPLIT!"
-            )
-
-          const {WHILE,UNTIL,SPLIT} = ACTIVITY
-          const kindWhile = kind & WHILE
-          const kindUntil = kind & UNTIL
-          const kindSplit = kind & SPLIT
-
-          if(kindWhile || kindUntil) {
-            const predicate = activity.pred
-
-            for(;;) {
-
-              if(kindWhile)
-                if(!await this.#hasPredicate(activity,predicate,context))
-                  break
-
-              context = await this.#execute(activity,context)
-
-              if(kindUntil)
-                if(await this.#hasPredicate(activity,predicate,context))
-                  break
-            }
-          } else if(kindSplit) {
-            // SPLIT activity: parallel execution with splitter/rejoiner
-            // pattern
-            const {splitter, rejoiner} = activity
+          const kind = activity.kind
 
-            if(!splitter || !rejoiner)
+          // If we have no kind, then it's just a once.
+          // Get it over and done with!
+          if(!kind) {
+            context = await this.#execute(activity, context)
+          } else {
+            // Validate that only one activity kind bit is set
+            // (kind & (kind - 1)) !== 0 means multiple bits are set
+            const multipleBitsSet = (kind & (kind - 1)) !== 0
+            if(multipleBitsSet)
               throw Sass.new(
-                `SPLIT activity "${String(activity.name)}" requires both ` +
-                `splitter and rejoiner functions.`
+                "For Kathy Griffin's sake! You can't combine activity kinds. " +
+                "Pick one: WHILE, UNTIL, or SPLIT!"
               )
 
-            const original = context
-            const splitContexts = await splitter.call(activity.action, context)
+            const {WHILE,UNTIL,SPLIT} = ACTIVITY
+            const kindWhile = kind & WHILE
+            const kindUntil = kind & UNTIL
+            const kindSplit = kind & SPLIT
 
-            let settled
+            if(kindWhile || kindUntil) {
+              const predicate = activity.pred
 
-            if(activity.opKind === "ActionBuilder") {
-              if(activity.action)
-                activity.op.withAction(activity.action)
+              for(;;) {
 
-              if(activity.hooks)
-                activity.op.withHooks(activity.hooks)
+                if(kindWhile)
+                  if(!await this.#hasPredicate(activity,predicate,context))
+                    break
 
-              const runner = new this.constructor(activity.op, {
-                debug: this.#debug, name: activity.name
-              })
+                context = await this.#execute(activity,context)
 
-              // pipe() returns settled results with concurrency control
-              settled = await runner.pipe(splitContexts)
-            } else {
-              // For plain functions, process each split context
-              settled = await Promised.settle(
-                splitContexts.map(ctx => this.#execute(activity, ctx))
-              )
-            }
+                if(kindUntil)
+                  if(await this.#hasPredicate(activity,predicate,context))
+                    break
+              }
+            } else if(kindSplit) {
+              // SPLIT activity: parallel execution with splitter/rejoiner
+              // pattern
+              const {splitter, rejoiner} = activity
 
-            const rejoined = await rejoiner.call(
-              activity.action,
-              original,
-              settled
-            )
+              if(!splitter || !rejoiner)
+                throw Sass.new(
+                  `SPLIT activity "${String(activity.name)}" requires both ` +
+                  `splitter and rejoiner functions.`
+                )
 
-            context = rejoined
-          } else {
-            context = await this.#execute(activity, context)
+              const original = context
+              const splitContexts = await splitter.call(
+                activity.action, context
+              )
+              let settled
+
+              if(activity.opKind === "ActionBuilder") {
+                if(activity.action)
+                  activity.op.withAction(activity.action)
+
+                if(activity.hooks)
+                  activity.op.withHooks(activity.hooks)
+
+                const runner = new this.constructor(activity.op, {
+                  debug: this.#debug, name: activity.name
+                })
+
+                // pipe() returns settled results with concurrency control
+                settled = await runner.pipe(splitContexts)
+              } else {
+                // For plain functions, process each split context
+                settled = await Promised.settle(
+                  splitContexts.map(ctx => this.#execute(activity, ctx))
+                )
+              }
+
+              const rejoined = await rejoiner.call(
+                activity.action,
+                original,
+                settled
+              )
+
+              context = rejoined
+            } else {
+              context = await this.#execute(activity, context)
+            }
           }
+        } catch(error) {
+          throw Sass.new("ActionRunner running activity", error)
+        }
+      }
+    } finally {
+      // Execute done callback if registered - always runs, even on error
+      if(actionWrapper.done) {
+        try {
+          context = await actionWrapper.done.call(
+            actionWrapper.action, context
+          )
+        } catch(error) {
+          throw Sass.new("ActionRunner running done callback", error)
         }
-      } catch(error) {
-        throw Sass.new("ActionRunner running activity", error)
       }
     }
 

package/src/browser/lib/ActionWrapper.js

@@ -11,7 +11,7 @@ import Activity from "./Activity.js"
  */
 
 /**
- * @typedef {Generator<Activity, void, unknown>} ActivityIterator
+ * @typedef {import("@gesslar/toolkit").Generator<Activity, void, unknown>} ActivityIterator
  */
 
 /**
@@ -33,14 +33,20 @@ export default class ActionWrapper {
 
   #hooks = null
 
+  #done = null
+
+  #action = null
+
   /**
    * Create a wrapper from the builder payload.
    *
    * @param {{activities: Map<string|symbol, WrappedActivityConfig>, debug: (message: string, level?: number, ...args: Array<unknown>) => void}} init Builder payload containing activities + logger.
    */
-  constructor({activities,hooks,debug}) {
+  constructor({activities,hooks,debug,done: doneCallback,action}) {
     this.#debug = debug
     this.#hooks = hooks
+    this.#done = doneCallback
+    this.#action = action
     this.#activities = activities
     this.#debug(
       "Instantiating ActionWrapper with %o activities.",
@@ -62,4 +68,22 @@ export default class ActionWrapper {
   get activities() {
     return this.#_activities()
   }
+
+  /**
+   * Get the done callback if registered.
+   *
+   * @returns {((context: unknown) => unknown|Promise<unknown>)|null} Done callback or null.
+   */
+  get done() {
+    return this.#done
+  }
+
+  /**
+   * Get the action instance.
+   *
+   * @returns {unknown|null} Action instance or null.
+   */
+  get action() {
+    return this.#action
+  }
 }

package/src/browser/lib/Piper.js

@@ -109,7 +109,7 @@ export default class Piper {
     }
 
     const setupResult = await Promised.settle(
-      [...this.#lifeCycle.get("setup")].map(e => e())
+      [...this.#lifeCycle.get("setup")].map(e => Promise.resolve(e()))
     )
 
     this.#processResult("Setting up the pipeline.", setupResult)
@@ -127,7 +127,7 @@ export default class Piper {
     } finally {
       // Run cleanup hooks
       const teardownResult = await Promised.settle(
-        [...this.#lifeCycle.get("teardown")].map(e => e())
+        [...this.#lifeCycle.get("teardown")].map(e => Promise.resolve(e()))
       )
 
       this.#processResult("Tearing down the pipeline.", teardownResult)

package/src/lib/ActionHooks.js

@@ -41,6 +41,14 @@ export default class ActionHooks extends BrowserActionHooks {
     return this.#hooksFile
   }
 
+  /**
+   * @typedef {object} ActionHooksConfig
+   * @property {string} [hooksFile] Path to the hooks file
+   * @property {string} [hooksKind] Name of the hooks class to instantiate
+   * @property {object} [hooks] Pre-instantiated hooks object
+   * @property {number} [timeout] Timeout for hook execution
+   */
+
   /**
    * Static factory method to create and initialize a hook manager.
    * Loads hooks from the specified file and returns an initialized instance.

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

@@ -112,6 +112,13 @@ export default class ActionBuilder {
      * @returns {ActionBuilder} The builder instance for chaining.
      */
     withAction(action: ActionBuilderAction): ActionBuilder;
+    /**
+     * Register a callback to be executed after all activities complete.
+     *
+     * @param {ActionFunction} callback Function to execute at the end of the pipeline.
+     * @returns {ActionBuilder} The builder instance for chaining.
+     */
+    done(callback: ActionFunction): ActionBuilder;
     /**
      * Finalises the builder and returns a payload that can be consumed by the
      * runner.

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

@@ -1 +1 @@
-{"version":3,"file":"ActionBuilder.d.ts","sourceRoot":"","sources":["../../../browser/lib/ActionBuilder.js"],"names":[],"mappings":"AAMA,kEAAkE;AAClE,uEAAuE;AAEvE;;GAEG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;;;;;GAQG;AAEH;;GAEG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH;IAaE;;;;;OAKG;IACH,qBAHW,mBAAmB,mBACnB,mBAAmB,EAe7B;IAED,yBAEC;;;;;;;;;;;;;;IAUE,SACQ,MAAM,GAAC,MAAM,MACb,cAAc,GACZ,aAAa,CACzB;;;;;;;;;IAGE,SACQ,MAAM,GAAC,MAAM,QACb,MAAM,QACN,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC,MAC9C,cAAc,GAAC,OAAO,oBAAoB,EAAE,OAAO,GACjD,aAAa,CACzB;;;;;;;;;;IAGE,SACQ,MAAM,GAAC,MAAM,QACb,MAAM,YACN,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,YAC7B,CAAC,eAAe,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,KAAK,OAAO,MAC5D,cAAc,GAAC,OAAO,oBAAoB,EAAE,OAAO,GACjD,aAAa,CACzB;IA0DD;;;;;;;OAOG;IACH,yBALW,MAAM,aACN,MAAM,GACJ,aAAa,CAYzB;IAED;;;;;;OAMG;IACH,iBAJW,OAAO,kBAAkB,EAAE,OAAO,GAChC,aAAa,CAgBzB;IAED;;;;;;OAMG;IACH,mBAHW,mBAAmB,GACjB,aAAa,CAczB;IAeD;;;;;OAKG;IACH,SAFa,OAAO,CAAC,OAAO,oBAAoB,EAAE,OAAO,CAAC,CAmBzD;;CAqBF;2BA3Sa,OAAO,mBAAmB,EAAE,OAAO;4BACnC,cAAc,eAAe,EAAE,QAAQ;sBAGxC,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI;;;;;WAKjE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI;;;;;;;;;;;;;;;;;;;;YAYhC,mBAAmB,GAAC,IAAI;;;;WACxB,OAAO,GAAC,IAAI;;;;UACZ,MAAM,GAAC,MAAM;;;;QACb,cAAc,GAAC,OAAO,oBAAoB,EAAE,OAAO;;;;;;;;sBAEzC,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC;;6BAI/C,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC"}
+{"version":3,"file":"ActionBuilder.d.ts","sourceRoot":"","sources":["../../../browser/lib/ActionBuilder.js"],"names":[],"mappings":"AAMA,kEAAkE;AAClE,uEAAuE;AAEvE;;GAEG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;;;;;GAQG;AAEH;;GAEG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH;IAcE;;;;;OAKG;IACH,qBAHW,mBAAmB,mBACnB,mBAAmB,EAe7B;IAED,yBAEC;;;;;;;;;;;;;;IAUE,SACQ,MAAM,GAAC,MAAM,MACb,cAAc,GACZ,aAAa,CACzB;;;;;;;;;IAGE,SACQ,MAAM,GAAC,MAAM,QACb,MAAM,QACN,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC,MAC9C,cAAc,GAAC,OAAO,oBAAoB,EAAE,OAAO,GACjD,aAAa,CACzB;;;;;;;;;;IAGE,SACQ,MAAM,GAAC,MAAM,QACb,MAAM,YACN,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,YAC7B,CAAC,eAAe,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,KAAK,OAAO,MAC5D,cAAc,GAAC,OAAO,oBAAoB,EAAE,OAAO,GACjD,aAAa,CACzB;IA0DD;;;;;;;OAOG;IACH,yBALW,MAAM,aACN,MAAM,GACJ,aAAa,CAYzB;IAED;;;;;;OAMG;IACH,iBAJW,OAAO,kBAAkB,EAAE,OAAO,GAChC,aAAa,CAgBzB;IAED;;;;;;OAMG;IACH,mBAHW,mBAAmB,GACjB,aAAa,CAczB;IAED;;;;;OAKG;IACH,eAHW,cAAc,GACZ,aAAa,CAOzB;IAeD;;;;;OAKG;IACH,SAFa,OAAO,CAAC,OAAO,oBAAoB,EAAE,OAAO,CAAC,CAoBzD;;CAqBF;2BA1Ta,OAAO,mBAAmB,EAAE,OAAO;4BACnC,cAAc,eAAe,EAAE,QAAQ;sBAGxC,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI;;;;;WAKjE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI;;;;;;;;;;;;;;;;;;;;YAYhC,mBAAmB,GAAC,IAAI;;;;WACxB,OAAO,GAAC,IAAI;;;;UACZ,MAAM,GAAC,MAAM;;;;QACb,cAAc,GAAC,OAAO,oBAAoB,EAAE,OAAO;;;;;;;;sBAEzC,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC;;6BAI/C,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC"}

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

@@ -1,6 +1,9 @@
 /**
  * @typedef {(message: string, level?: number, ...args: Array<unknown>) => void} DebugFn
  */
+/**
+ * @typedef {import("./ActionBuilder.js").default} ActionBuilder
+ */
 /**
  * @typedef {object} ActionRunnerOptions
  * @property {DebugFn} [debug] Logger function.
@@ -33,6 +36,7 @@ export default class ActionRunner extends Piper {
     #private;
 }
 export type DebugFn = (message: string, level?: number, ...args: Array<unknown>) => void;
+export type ActionBuilder = import("./ActionBuilder.js").default;
 export type ActionRunnerOptions = {
     /**
      * Logger function.

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

@@ -1 +1 @@
-{"version":3,"file":"ActionRunner.d.ts","sourceRoot":"","sources":["../../../browser/lib/ActionRunner.js"],"names":[],"mappings":"AAKA;;GAEG;AAEH;;;GAGG;AACH;;;;;;GAMG;AACH;IAaE;;;;;OAKG;IACH,2BAHW,OAAO,oBAAoB,EAAE,OAAO,GAAC,IAAI,cACzC,mBAAmB,EAkB7B;IAED;;;;;;;;OAQG;IACH,aAJW,OAAO,GACL,OAAO,CAAC,OAAO,CAAC,CAuG5B;;CA0FF;sBA1PY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI;;;;;;;kBAH7D,YAAY"}
+{"version":3,"file":"ActionRunner.d.ts","sourceRoot":"","sources":["../../../browser/lib/ActionRunner.js"],"names":[],"mappings":"AAKA;;GAEG;AAEH;;GAEG;AAEH;;;GAGG;AACH;;;;;;GAMG;AACH;IAaE;;;;;OAKG;IACH,2BAHW,OAAO,oBAAoB,EAAE,OAAO,GAAC,IAAI,cACzC,mBAAmB,EAkB7B;IAED;;;;;;;;OAQG;IACH,aAJW,OAAO,GACL,OAAO,CAAC,OAAO,CAAC,CAgH5B;;CA0FF;sBAvQY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI;4BAIlE,OAAO,oBAAoB,EAAE,OAAO;;;;;;;kBAP/B,YAAY"}

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

@@ -8,7 +8,7 @@
  * @property {(message: string, level?: number, ...args: Array<unknown>) => void} [debug] Optional logger reference.
  */
 /**
- * @typedef {Generator<Activity, void, unknown>} ActivityIterator
+ * @typedef {import("@gesslar/toolkit").Generator<Activity, void, unknown>} ActivityIterator
  */
 /**
  * Thin wrapper that materialises {@link Activity} instances on demand.
@@ -19,7 +19,7 @@ export default class ActionWrapper {
      *
      * @param {{activities: Map<string|symbol, WrappedActivityConfig>, debug: (message: string, level?: number, ...args: Array<unknown>) => void}} init Builder payload containing activities + logger.
      */
-    constructor({ activities, hooks, debug }: {
+    constructor({ activities, hooks, debug, done: doneCallback }: {
         activities: Map<string | symbol, WrappedActivityConfig>;
         debug: (message: string, level?: number, ...args: Array<unknown>) => void;
     });
@@ -29,6 +29,12 @@ export default class ActionWrapper {
      * @returns {ActivityIterator} Lazy iterator yielding Activity instances.
      */
     get activities(): ActivityIterator;
+    /**
+     * Get the done callback if registered.
+     *
+     * @returns {((context: unknown) => unknown|Promise<unknown>)|null} Done callback or null.
+     */
+    get done(): ((context: unknown) => unknown | Promise<unknown>) | null;
     #private;
 }
 export type WrappedActivityConfig = {
@@ -57,6 +63,6 @@ export type WrappedActivityConfig = {
      */
     debug?: ((message: string, level?: number, ...args: Array<unknown>) => void) | undefined;
 };
-export type ActivityIterator = Generator<Activity, void, unknown>;
+export type ActivityIterator = import("@gesslar/toolkit").Generator<Activity, void, unknown>;
 import Activity from "./Activity.js";
 //# sourceMappingURL=ActionWrapper.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ActionWrapper.d.ts","sourceRoot":"","sources":["../../../browser/lib/ActionWrapper.js"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH;;GAEG;AAEH;;GAEG;AACH;IAgBE;;;;OAIG;IACH,0CAFW;QAAC,UAAU,EAAE,GAAG,CAAC,MAAM,GAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;QAAC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,CAAA;KAAC,EAW5I;IAOD;;;;OAIG;IACH,kBAFa,gBAAgB,CAI5B;;CACF;;;;;UA5Da,MAAM,GAAC,MAAM;;;;QACb,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC,GAAC,aAAa;;;;;;;;sBAElD,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC;;;;aAC9C,OAAO;;;;uBACG,MAAM,UAAU,MAAM,WAAW,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI;;+BAInE,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC;qBAb1B,eAAe"}
+{"version":3,"file":"ActionWrapper.d.ts","sourceRoot":"","sources":["../../../browser/lib/ActionWrapper.js"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH;;GAEG;AAEH;;GAEG;AACH;IAkBE;;;;OAIG;IACH,8DAFW;QAAC,UAAU,EAAE,GAAG,CAAC,MAAM,GAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;QAAC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,CAAA;KAAC,EAY5I;IAOD;;;;OAIG;IACH,kBAFa,gBAAgB,CAI5B;IAED;;;;OAIG;IACH,YAFa,CAAC,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAC,IAAI,CAIjE;;CACF;;;;;UAxEa,MAAM,GAAC,MAAM;;;;QACb,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC,GAAC,aAAa;;;;;;;;sBAElD,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC;;;;aAC9C,OAAO;;;;uBACG,MAAM,UAAU,MAAM,WAAW,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI;;+BAInE,OAAO,kBAAkB,EAAE,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC;qBAbrD,eAAe"}

package/src/types/lib/ActionBuilder.d.ts

@@ -112,6 +112,13 @@ export default class ActionBuilder {
    * @returns {ActionBuilder} The builder instance for chaining.
    */
   withAction(action: ActionBuilderAction): ActionBuilder
+  /**
+   * Register a callback to be executed after all activities complete.
+   *
+   * @param {ActionFunction} callback Function to execute at the end of the pipeline.
+   * @returns {ActionBuilder} The builder instance for chaining.
+   */
+  done(callback: ActionFunction): ActionBuilder
   /**
    * Finalises the builder and returns a payload that can be consumed by the
    * runner.

package/src/types/lib/ActionHooks.d.ts

@@ -14,6 +14,13 @@
  * Inherits all browser functionality and adds FileObject-based hook import capability.
  */
 export default class ActionHooks extends BrowserActionHooks {
+    /**
+     * @typedef {object} ActionHooksConfig
+     * @property {string} [hooksFile] Path to the hooks file
+     * @property {string} [hooksKind] Name of the hooks class to instantiate
+     * @property {object} [hooks] Pre-instantiated hooks object
+     * @property {number} [timeout] Timeout for hook execution
+     */
     /**
      * Static factory method to create and initialize a hook manager.
      * Loads hooks from the specified file and returns an initialized instance.
@@ -23,7 +30,24 @@ export default class ActionHooks extends BrowserActionHooks {
      * @param {DebugFn} debug The debug function.
      * @returns {Promise<ActionHooks|null>} Initialized hook manager or null if no hooks found
      */
-    static "new"(config: ActionHooksConfig, debug: DebugFn): Promise<ActionHooks | null>;
+    static "new"(config: {
+        /**
+         * Path to the hooks file
+         */
+        hooksFile?: string | undefined;
+        /**
+         * Name of the hooks class to instantiate
+         */
+        hooksKind?: string | undefined;
+        /**
+         * Pre-instantiated hooks object
+         */
+        hooks?: object | undefined;
+        /**
+         * Timeout for hook execution
+         */
+        timeout?: number | undefined;
+    }, debug: DebugFn): Promise<ActionHooks | null>;
     /**
      * Creates a new ActionHook instance.
      *

package/src/types/lib/ActionHooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ActionHooks.d.ts","sourceRoot":"","sources":["../../lib/ActionHooks.js"],"names":[],"mappings":"AAGA;;GAEG;AAEH;;;;;;;GAOG;AAEH;;;GAGG;AACH;IAuBE;;;;;;;;OAQG;IACH,qBAJW,iBAAiB,SACjB,OAAO,GACL,OAAO,CAAC,WAAW,GAAC,IAAI,CAAC,CAgDrC;IA1ED;;;;OAIG;IACH,kEAFW,qBAAqB,EAK/B;IAED;;;;OAIG;IACH,iBAFa,UAAU,CAItB;;CA2DF;sBAhGY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI;;;;;gBAKjE,MAAM;;;;;;;;YAEN,OAAO;;;;;;;;WAEP,OAAO;;kDAZ2B,qBAAqB;2BADtC,kBAAkB"}
+{"version":3,"file":"ActionHooks.d.ts","sourceRoot":"","sources":["../../lib/ActionHooks.js"],"names":[],"mappings":"AAGA;;GAEG;AAEH;;;;;;;GAOG;AAEH;;;GAGG;AACH;IAuBE;;;;;;OAMG;IAEH;;;;;;;;OAQG;IACH;;;;;;;;;;;;;;;;;cAHW,OAAO,GACL,OAAO,CAAC,WAAW,GAAC,IAAI,CAAC,CAgDrC;IAlFD;;;;OAIG;IACH,kEAFW,qBAAqB,EAK/B;IAED;;;;OAIG;IACH,iBAFa,UAAU,CAItB;;CAmEF;sBAxGY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI;;;;;gBAKjE,MAAM;;;;;;;;YAEN,OAAO;;;;;;;;WAEP,OAAO;;kDAZ2B,qBAAqB;2BADtC,kBAAkB"}

package/src/types/lib/ActionWrapper.d.ts

@@ -19,7 +19,7 @@ export default class ActionWrapper {
    *
    * @param {{activities: Map<string|symbol, WrappedActivityConfig>, debug: (message: string, level?: number, ...args: Array<unknown>) => void}} init Builder payload containing activities + logger.
    */
-  constructor({ activities, hooks, debug }: {
+  constructor({ activities, hooks, debug, done: doneCallback }: {
     activities: Map<string | symbol, WrappedActivityConfig>;
     debug: (message: string, level?: number, ...args: Array<unknown>) => void;
   })
@@ -29,6 +29,12 @@ export default class ActionWrapper {
    * @returns {ActivityIterator} Lazy iterator yielding Activity instances.
    */
   get activities(): ActivityIterator
+  /**
+   * Get the done callback if registered.
+   *
+   * @returns {((context: unknown) => unknown|Promise<unknown>)|null} Done callback or null.
+   */
+  get done(): ((context: unknown) => unknown | Promise<unknown>) | null
   #private
 }
 export type WrappedActivityConfig = {