@gesslar/actioneer 2.3.1 → 2.4.0

package/package.json

@@ -5,7 +5,7 @@
     "name": "gesslar",
     "url": "https://gesslar.dev"
   },
-  "version": "2.3.1",
+  "version": "2.4.0",
   "license": "Unlicense",
   "homepage": "https://github.com/gesslar/toolkit#readme",
   "repository": {
@@ -22,7 +22,6 @@
     "composition",
     "lasagna"
   ],
-  "main": "./src/index.js",
   "type": "module",
   "exports": {
     ".": {
@@ -46,28 +45,28 @@
   ],
   "sideEffects": false,
   "engines": {
-    "node": ">=22"
-  },
-  "dependencies": {
-    "@gesslar/toolkit": "^3.34.0"
-  },
-  "devDependencies": {
-    "@gesslar/uglier": "^1.4.1",
-    "eslint": "^10.0.0",
-    "typescript": "^5.9.3"
+    "node": ">=24.13.0"
   },
   "scripts": {
     "lint": "eslint src/",
     "lint:fix": "eslint src/ --fix",
     "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 self-update && pnpx npm-check-updates -u && pnpm install",
+    "submit": "npm publish --access public --//registry.npmjs.org/:_authToken=\"${NPM_ACCESS_TOKEN}\"",
+    "update": "npx npm-check-updates -u && npm install",
     "test": "node --test tests/**/*.test.js",
     "test:browser": "node --test tests/browser/*.test.js",
     "test:node": "node --test tests/node/*.test.js",
     "pr": "gt submit -p --ai",
-    "patch": "pnpm version patch",
-    "minor": "pnpm version minor",
-    "major": "pnpm version major"
+    "patch": "npm version patch",
+    "minor": "npm version minor",
+    "major": "npm version major"
+  },
+  "dependencies": {
+    "@gesslar/toolkit": "^3.37.0"
+  },
+  "devDependencies": {
+    "@gesslar/uglier": "^1.6.2",
+    "eslint": "^10.0.0",
+    "typescript": "^5.9.3"
   }
-}
+}

package/src/browser/lib/ActionBuilder.js

@@ -229,10 +229,10 @@ export default class ActionBuilder {
    * @throws {Sass} If hooks have already been configured with a different instance.
    */
   withHooks(hooks) {
-    // If the same hooks instance is already set, this is idempotent - just return
-    if(this.#hooks === hooks) {
+    // If the same hooks instance is already set, this is idempotent -just
+    // return.
+    if(this.#hooks === hooks)
       return this
-    }
 
     Valid.assert(this.#hooksFile === null, "Hooks have already been configured.")
     Valid.assert(this.#hooksKind === null, "Hooks have already been configured.")
@@ -294,6 +294,7 @@ export default class ActionBuilder {
    * Finalises the builder and returns a payload that can be consumed by the
    * runner.
    *
+   * @param {ActionRunner} runner - The runner invoking the build.
    * @returns {Promise<ActionWrapper>} Payload consumed by the {@link ActionRunner} constructor.
    */
   async build(runner) {
@@ -351,4 +352,14 @@ export default class ActionBuilder {
     if(hooksFile && hooksKind)
       return await newHooks({hooksFile,hooksKind}, this.#debug)
   }
+
+  /**
+   * Returns the raw hooks value configured on this builder.
+   * Used by {@link ActionRunner} to access setup/cleanup lifecycle hooks.
+   *
+   * @returns {object|Function|null} Raw hooks value, or null if not configured.
+   */
+  get hooks() {
+    return this.#hooks
+  }
 }

package/src/browser/lib/ActionHooks.js

@@ -9,7 +9,7 @@ import {Data, Sass, Promised, Time, Util, Valid} from "@gesslar/toolkit"
  *
  * @typedef {object} ActionHooksConfig
  * @property {string} actionKind - Action identifier shared between runner and hooks.
- * @property {unknown} hooks - Already-instantiated hooks implementation.
+ * @property {object|Function|null} hooks - Pre-instantiated hooks object, a constructor to instantiate, or null.
  * @property {number} [hookTimeout] - Timeout applied to hook execution in milliseconds.
  * @property {DebugFn} debug - Logger to emit diagnostics.
  */
@@ -54,10 +54,18 @@ export default class ActionHooks {
 
   /**
    * Gets the loaded hooks object.
+   * If the stored value is a plain object it is returned as-is.
+   * If it is a constructor function a new instance is created and returned.
    *
    * @returns {object?} Hooks object or null if not loaded
    */
   get hooks() {
+    if(Data.isType(this.#hooks, "Object"))
+      return this.#hooks
+
+    else if(Data.isType(this.#hooks, "Function"))
+      return new this.#hooks()
+
     return this.#hooks
   }
 
@@ -97,7 +105,7 @@ export default class ActionHooks {
    * @returns {Promise<ActionHooks?>} Initialized hook manager or null if no hooks provided
    */
   static async new(config, debug) {
-    debug("Creating new HookManager instance with args: %o", 2, config)
+    debug("Creating new ActionHooks instance with args: %o", 2, config)
 
     if(!config.hooks) {
       debug("No hooks provided (browser mode requires pre-instantiated hooks)", 2)
@@ -117,10 +125,11 @@ export default class ActionHooks {
    *
    * @param {string} kind - Hook namespace.
    * @param {string|symbol} activityName - Activity identifier.
-   * @param {unknown} context - Pipeline context supplied to the hook.
+   * @param {unknown} oldContext - Pipeline context supplied to the hook.
+   * @param {unknown} newContext - For after$ hooks, the result of the op
    * @returns {Promise<void>}
    */
-  async callHook(kind, activityName, context) {
+  async callHook(kind, activityName, oldContext, newContext) {
     try {
       const debug = this.#debug
       const hooks = this.#hooks
@@ -147,7 +156,11 @@ export default class ActionHooks {
         debug("Hook function starting execution: %o", 4, hookName)
 
         const duration = (
-          await Util.time(() => hook.call(this.#hooks, context))
+          newContext
+            ? await Util.time(
+              () => hook.call(this.#hooks, newContext, oldContext)
+            )
+            : await Util.time(() => hook.call(this.#hooks, oldContext))
         ).cost
 
         debug("Hook function completed successfully: %o, after %oms", 4, hookName, duration)
@@ -168,9 +181,6 @@ export default class ActionHooks {
       } catch(error) {
         throw Sass.new(`Processing hook ${kind}$${activityName}`, error)
       }
-
-      debug("We made it throoough the wildernessss", 4)
-
     } catch(error) {
       throw Sass.new(`Processing hook ${kind}$${activityName}`, error)
     }

package/src/browser/lib/ActionRunner.js

@@ -55,9 +55,45 @@ export default class ActionRunner extends Piper {
 
     this.#actionBuilder = actionBuilder
 
+    this.addSetup(this.#setupHooks)
     this.addStep(this.run, {
       name: `ActionRunner for ${actionBuilder.tag.description}`
     })
+    this.addCleanup(this.#cleanupHooks)
+  }
+
+  /**
+   * Invokes the `setup` lifecycle hook on the raw hooks object, if defined.
+   * Registered as a Piper setup step so it fires before any items are processed.
+   *
+   * @param {unknown} ctx - Value passed by {@link Piper#pipe} (the items array).
+   * @returns {Promise<void>}
+   * @private
+   */
+  async #setupHooks(ctx) {
+    const ab = this.#actionBuilder
+    const ah = ab?.hooks
+    const setup = ah?.setup
+
+    if(setup)
+      await setup.call(ah, ctx)
+  }
+
+  /**
+   * Invokes the `cleanup` lifecycle hook on the raw hooks object, if defined.
+   * Registered as a Piper teardown step so it fires after all items are processed.
+   *
+   * @param {unknown} ctx - Value passed by {@link Piper#pipe} (the items array).
+   * @returns {Promise<void>}
+   * @private
+   */
+  async #cleanupHooks(ctx) {
+    const ab = this.#actionBuilder
+    const ah = ab?.hooks
+    const cleanup = ah?.cleanup
+
+    if(cleanup)
+      await cleanup.call(ah, ctx)
   }
 
   /**

package/src/browser/lib/ActionWrapper.js

@@ -4,7 +4,6 @@ import Activity from "./Activity.js"
  * Type imports
  *
  * @import {default as ActionHooks} from "./ActionHooks.js"
- * @import {default as ActionRunner} from "./ActionRunner.js"
  */
 
 /**
@@ -43,13 +42,16 @@ export default class ActionWrapper {
   #action = null
   /** @type {symbol} */
   #id = Symbol(performance.now())
-  /** @type {ActionRunner} */
-  #runner
 
   /**
    * 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.
+   * @param {object} init - Builder payload.
+   * @param {Map<string|symbol, WrappedActivityConfig>} init.activities - Registered activities.
+   * @param {(message: string, level?: number, ...args: Array<unknown>) => void} init.debug - Logger.
+   * @param {import("./ActionHooks.js").default?} init.hooks - Optional hooks instance.
+   * @param {((context: unknown) => unknown|Promise<unknown>)|null} [init.done] - Optional done callback.
+   * @param {unknown} [init.action] - Optional parent action instance.
    */
   constructor({activities,hooks,debug,done: doneCallback,action}) {
     this.#debug = debug

package/src/browser/lib/Activity.js

@@ -192,7 +192,7 @@ export default class Activity {
     const result = await this.#op.call(this.#action, context)
 
     // after hook
-    await this.#hooks?.callHook("after", this.#name, context)
+    await this.#hooks?.callHook("after", this.#name, result, context)
 
     return result
   }

package/src/browser/lib/Piper.js

@@ -9,7 +9,11 @@
  * - Error handling and reporting
  */
 
-import {Data, Disposer, NotifyClass, Promised, Sass, Tantrum} from "@gesslar/toolkit"
+import {Data, Disposer, NotifyClass, Promised, Sass} from "@gesslar/toolkit"
+
+/**
+ * @import {Tantrum} from "@gesslar/toolkit"
+ */
 
 export default class Piper extends NotifyClass {
   #debug
@@ -67,7 +71,7 @@ export default class Piper extends NotifyClass {
   /**
    * Add setup hook that runs before processing starts.
    *
-   * @param {() => Promise<void>|void} fn - Setup function executed before processing
+   * @param {(items: Array<unknown>) => Promise<void>|void} fn - Setup function executed before processing; receives the full items array.
    * @param {unknown} [thisArg] - Optional this binding for the setup function
    * @returns {Piper} - The pipeline instance
    */
@@ -80,7 +84,7 @@ export default class Piper extends NotifyClass {
   /**
    * Add cleanup hook that runs after processing completes
    *
-   * @param {() => Promise<void>|void} fn - Cleanup function executed after processing
+   * @param {(items: Array<unknown>) => Promise<void>|void} fn - Cleanup function executed after processing; receives the full items array.
    * @param {unknown} [thisArg] - Optional this binding for the cleanup function
    * @returns {Piper} - The pipeline instance
    */
@@ -128,7 +132,7 @@ export default class Piper extends NotifyClass {
     }
 
     const setupResult = await Promised.settle(
-      [...this.#lifeCycle.get("setup")].map(e => Promise.resolve(e()))
+      [...this.#lifeCycle.get("setup")].map(e => Promise.resolve(e(items)))
     )
 
     this.#processResult("Setting up the pipeline.", setupResult)
@@ -146,7 +150,7 @@ export default class Piper extends NotifyClass {
     } finally {
       // Run cleanup hooks
       const teardownResult = await Promised.settle(
-        [...this.#lifeCycle.get("teardown")].map(e => Promise.resolve(e()))
+        [...this.#lifeCycle.get("teardown")].map(e => Promise.resolve(e(items)))
       )
 
       this.#processResult("Tearing down the pipeline.", teardownResult)
@@ -164,9 +168,9 @@ export default class Piper extends NotifyClass {
    * @private
    * @param {string} message - Context message
    * @param {Array<unknown>} settled - Results from settleAll
-   * @throws {Tantrum} - If any rejected
+   * @throws {Tantrum} - If any settled result was rejected
    */
-  #processResult(message, settled) {
+  #processResult(_message, settled) {
     if(Promised.hasRejected(settled))
       Promised.throw(settled)
   }

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

@@ -130,9 +130,17 @@ export default class ActionBuilder {
      * Finalises the builder and returns a payload that can be consumed by the
      * runner.
      *
+     * @param {ActionRunner} runner - The runner invoking the build.
      * @returns {Promise<ActionWrapper>} Payload consumed by the {@link ActionRunner} constructor.
      */
-    build(runner: any): Promise<ActionWrapper>;
+    build(runner: ActionRunner): Promise<ActionWrapper>;
+    /**
+     * Returns the raw hooks value configured on this builder.
+     * Used by {@link ActionRunner} to access setup/cleanup lifecycle hooks.
+     *
+     * @returns {object|Function|null} Raw hooks value, or null if not configured.
+     */
+    get hooks(): object | Function | null;
     #private;
 }
 /**
@@ -199,5 +207,6 @@ export type ActivityDefinition = {
  */
 export type ActionFunction = (context: unknown) => unknown | Promise<unknown>;
 import ActionHooks from "./ActionHooks.js";
+import type { default as ActionRunner } from "./ActionRunner.js";
 import ActionWrapper from "./ActionWrapper.js";
 //# sourceMappingURL=ActionBuilder.d.ts.map

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;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH;IAkBE;;;;;OAKG;IACH,qBAHW,mBAAmB,mBACnB,mBAAmB,EAkB7B;IAED,yBAEC;;;;;;;;;;;;;;;IAWE,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,GAC5C,aAAa,CACzB;;;;;;;;;IAGE,SACQ,MAAM,GAAC,MAAM,QACb,MAAM,QACN,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC,MAC9C,cAAc,GAAC,aAAa,GAC1B,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,aAAa,GAC1B,aAAa,CACzB;IAkED;;;;;;;OAOG;IACH,yBALW,MAAM,aACN,MAAM,GACJ,aAAa,CAYzB;IAED;;;;;;OAMG;IACH,iBAJW,WAAW,GACT,aAAa,CAgBzB;IAED;;;;;;OAMG;IACH,mBAHW,mBAAmB,GACjB,aAAa,CAczB;IAED;;;;;OAKG;IACH,eAHW,cAAc,GACZ,aAAa,CAOzB;IAeD;;;;;OAKG;IACH,oBAFa,OAAO,CAAC,aAAa,CAAC,CAoClC;;CAqBF;;;;sBAtVY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI;;;;;;;;WAGjE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;YAQhC,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;;;;;6BAE/C,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC;wBA1BnC,kBAAkB;0BADhB,oBAAoB"}
+{"version":3,"file":"ActionBuilder.d.ts","sourceRoot":"","sources":["../../../browser/lib/ActionBuilder.js"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH;IAkBE;;;;;OAKG;IACH,qBAHW,mBAAmB,mBACnB,mBAAmB,EAkB7B;IAED,yBAEC;;;;;;;;;;;;;;;IAWE,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,GAC5C,aAAa,CACzB;;;;;;;;;IAGE,SACQ,MAAM,GAAC,MAAM,QACb,MAAM,QACN,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC,MAC9C,cAAc,GAAC,aAAa,GAC1B,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,aAAa,GAC1B,aAAa,CACzB;IAkED;;;;;;;OAOG;IACH,yBALW,MAAM,aACN,MAAM,GACJ,aAAa,CAYzB;IAED;;;;;;OAMG;IACH,iBAJW,WAAW,GACT,aAAa,CAgBzB;IAED;;;;;;OAMG;IACH,mBAHW,mBAAmB,GACjB,aAAa,CAczB;IAED;;;;;OAKG;IACH,eAHW,cAAc,GACZ,aAAa,CAOzB;IAeD;;;;;;OAMG;IACH,cAHW,YAAY,GACV,OAAO,CAAC,aAAa,CAAC,CAoClC;IAsBD;;;;;OAKG;IACH,aAFa,MAAM,cAAU,IAAI,CAIhC;;CACF;;;;sBAjWY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI;;;;;;;;WAGjE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;YAQhC,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;;;;;6BAE/C,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC;wBA1BnC,kBAAkB;6CAMA,mBAAmB;0BAPnC,oBAAoB"}

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

@@ -6,7 +6,7 @@
  *
  * @typedef {object} ActionHooksConfig
  * @property {string} actionKind - Action identifier shared between runner and hooks.
- * @property {unknown} hooks - Already-instantiated hooks implementation.
+ * @property {object|Function|null} hooks - Pre-instantiated hooks object, a constructor to instantiate, or null.
  * @property {number} [hookTimeout] - Timeout applied to hook execution in milliseconds.
  * @property {DebugFn} debug - Logger to emit diagnostics.
  */
@@ -41,6 +41,8 @@ export default class ActionHooks {
     get actionKind(): string;
     /**
      * Gets the loaded hooks object.
+     * If the stored value is a plain object it is returned as-is.
+     * If it is a constructor function a new instance is created and returned.
      *
      * @returns {object?} Hooks object or null if not loaded
      */
@@ -68,10 +70,11 @@ export default class ActionHooks {
      *
      * @param {string} kind - Hook namespace.
      * @param {string|symbol} activityName - Activity identifier.
-     * @param {unknown} context - Pipeline context supplied to the hook.
+     * @param {unknown} oldContext - Pipeline context supplied to the hook.
+     * @param {unknown} newContext - For after$ hooks, the result of the op
      * @returns {Promise<void>}
      */
-    callHook(kind: string, activityName: string | symbol, context: unknown): Promise<void>;
+    callHook(kind: string, activityName: string | symbol, oldContext: unknown, newContext: unknown): Promise<void>;
     #private;
 }
 export type DebugFn = (message: string, level?: number, ...args: Array<unknown>) => void;
@@ -82,9 +85,9 @@ export type ActionHooksConfig = {
      */
     actionKind: string;
     /**
-     * - Already-instantiated hooks implementation.
+     * - Pre-instantiated hooks object, a constructor to instantiate, or null.
      */
-    hooks: unknown;
+    hooks: object | Function | null;
     /**
      * - Timeout applied to hook execution in milliseconds.
      */

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

@@ -1 +1 @@
-{"version":3,"file":"ActionHooks.d.ts","sourceRoot":"","sources":["../../../browser/lib/ActionHooks.js"],"names":[],"mappings":"AAEA;;GAEG;AAEH;;;;;;;;GAQG;AAEH;;;;;;GAMG;AACH;IAmEE;;;;;;;OAOG;IACH,qBAJW,iBAAiB,SACjB,OAAO,GACL,OAAO,CAAC,WAAW,OAAC,CAAC,CAgBjC;IA/ED;;;;OAIG;IACH,uDAFW,iBAAiB,EAO3B;IAED;;;;OAIG;IACH,kBAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,aAFa,MAAM,OAAC,CAInB;IAED;;;;OAIG;IACH,eAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,aAFa,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAIrC;IAED;;;;OAIG;IACH,eAFa,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAIrC;IA0BD;;;;;;;OAOG;IACH,eALW,MAAM,gBACN,MAAM,GAAC,MAAM,WACb,OAAO,GACL,OAAO,CAAC,IAAI,CAAC,CAwDzB;;CAmBF;sBAhMY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI;yBAIlE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,GAAC,OAAO,CAAC;;;;;gBAG7D,MAAM;;;;WACN,OAAO;;;;;;;;WAEP,OAAO"}
+{"version":3,"file":"ActionHooks.d.ts","sourceRoot":"","sources":["../../../browser/lib/ActionHooks.js"],"names":[],"mappings":"AAEA;;GAEG;AAEH;;;;;;;;GAQG;AAEH;;;;;;GAMG;AACH;IA2EE;;;;;;;OAOG;IACH,qBAJW,iBAAiB,SACjB,OAAO,GACL,OAAO,CAAC,WAAW,OAAC,CAAC,CAgBjC;IAvFD;;;;OAIG;IACH,uDAFW,iBAAiB,EAO3B;IAED;;;;OAIG;IACH,kBAFa,MAAM,CAIlB;IAED;;;;;;OAMG;IACH,aAFa,MAAM,OAAC,CAUnB;IAED;;;;OAIG;IACH,eAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,aAFa,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAIrC;IAED;;;;OAIG;IACH,eAFa,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAIrC;IA0BD;;;;;;;;OAQG;IACH,eANW,MAAM,gBACN,MAAM,GAAC,MAAM,cACb,OAAO,cACP,OAAO,GACL,OAAO,CAAC,IAAI,CAAC,CAyDzB;;CAmBF;sBA1MY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI;yBAIlE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,GAAC,OAAO,CAAC;;;;;gBAG7D,MAAM;;;;WACN,MAAM,cAAU,IAAI;;;;;;;;WAEpB,OAAO"}

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;;;;;GAKG;AACH;;;;;GAKG;AAEH;;;;;;GAMG;AACH;IAaE;;;;;OAKG;IACH,2BAHW,OAAO,oBAAoB,EAAE,OAAO,GAAC,IAAI,cACzC,mBAAmB,EAkB7B;IAED;;;;;;;;;;OAUG;IACH,aANW,OAAO,kBACP,OAAO,oBAAoB,EAAE,OAAO,GAAC,IAAI,GACvC,OAAO,CAAC,OAAO,CAAC,CAoJ5B;;CAiGF;sBA9SY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI;;;;;;;kBAT7D,YAAY"}
+{"version":3,"file":"ActionRunner.d.ts","sourceRoot":"","sources":["../../../browser/lib/ActionRunner.js"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH;;;;;GAKG;AAEH;;;;;;GAMG;AACH;IAaE;;;;;OAKG;IACH,2BAHW,OAAO,oBAAoB,EAAE,OAAO,GAAC,IAAI,cACzC,mBAAmB,EAoB7B;IAoCD;;;;;;;;;;OAUG;IACH,aANW,OAAO,kBACP,OAAO,oBAAoB,EAAE,OAAO,GAAC,IAAI,GACvC,OAAO,CAAC,OAAO,CAAC,CAoJ5B;;CAiGF;sBAlVY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI;;;;;;;kBAT7D,YAAY"}

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

@@ -2,7 +2,6 @@
  * Type imports
  *
  * @import {default as ActionHooks} from "./ActionHooks.js"
- * @import {default as ActionRunner} from "./ActionRunner.js"
  */
 /**
  * @typedef {object} WrappedActivityConfig
@@ -20,11 +19,19 @@ export default class ActionWrapper {
     /**
      * 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.
+     * @param {object} init - Builder payload.
+     * @param {Map<string|symbol, WrappedActivityConfig>} init.activities - Registered activities.
+     * @param {(message: string, level?: number, ...args: Array<unknown>) => void} init.debug - Logger.
+     * @param {import("./ActionHooks.js").default?} init.hooks - Optional hooks instance.
+     * @param {((context: unknown) => unknown|Promise<unknown>)|null} [init.done] - Optional done callback.
+     * @param {unknown} [init.action] - Optional parent action instance.
      */
     constructor({ activities, hooks, debug, done: doneCallback, action }: {
         activities: Map<string | symbol, WrappedActivityConfig>;
         debug: (message: string, level?: number, ...args: Array<unknown>) => void;
+        hooks: import("./ActionHooks.js").default | null;
+        done?: ((context: unknown) => unknown | Promise<unknown>) | null | undefined;
+        action?: unknown;
     });
     /**
      * Unique identifier for this wrapper instance.

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;;;;;GAKG;AAEH;;;;;;;;GAQG;AAEH;;GAEG;AACH;IA0BE;;;;OAIG;IACH,sEAFW;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,EAwB5I;IAED;;;;;OAKG;IACH,UAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,kBAFa,QAAQ,CAAC,QAAQ,CAAC,CAI9B;IAED;;;;OAIG;IACH,YAFa,CAAC,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAC,IAAI,CAIjE;IAED;;;;OAIG;IACH,cAFa,OAAO,GAAC,IAAI,CAIxB;;CACF;;;;;UAtGa,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;;qBAhB3D,eAAe"}
+{"version":3,"file":"ActionWrapper.d.ts","sourceRoot":"","sources":["../../../browser/lib/ActionWrapper.js"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH;;;;;;;;GAQG;AAEH;;GAEG;AACH;IAwBE;;;;;;;;;OASG;IACH,sEANG;QAAwD,UAAU,EAA1D,GAAG,CAAC,MAAM,GAAC,MAAM,EAAE,qBAAqB,CAAC;QACgC,KAAK,EAA9E,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI;QACxB,KAAK,EAA/C,OAAO,kBAAkB,EAAE,OAAO,OAAC;QAC0B,IAAI,cAAtD,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC;QAChC,MAAM,GAArB,OAAO;KACjB,EAuBA;IAED;;;;;OAKG;IACH,UAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,kBAFa,QAAQ,CAAC,QAAQ,CAAC,CAI9B;IAED;;;;OAIG;IACH,YAFa,CAAC,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAC,IAAI,CAIjE;IAED;;;;OAIG;IACH,cAFa,OAAO,GAAC,IAAI,CAIxB;;CACF;;;;;UAzGa,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;;qBAf3D,eAAe"}

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

@@ -1,3 +1,6 @@
+/**
+ * @import {Tantrum} from "@gesslar/toolkit"
+ */
 export default class Piper extends NotifyClass {
     /**
      * Create a Piper instance.
@@ -23,19 +26,19 @@ export default class Piper extends NotifyClass {
     /**
      * Add setup hook that runs before processing starts.
      *
-     * @param {() => Promise<void>|void} fn - Setup function executed before processing
+     * @param {(items: Array<unknown>) => Promise<void>|void} fn - Setup function executed before processing; receives the full items array.
      * @param {unknown} [thisArg] - Optional this binding for the setup function
      * @returns {Piper} - The pipeline instance
      */
-    addSetup(fn: () => Promise<void> | void, thisArg?: unknown): Piper;
+    addSetup(fn: (items: Array<unknown>) => Promise<void> | void, thisArg?: unknown): Piper;
     /**
      * Add cleanup hook that runs after processing completes
      *
-     * @param {() => Promise<void>|void} fn - Cleanup function executed after processing
+     * @param {(items: Array<unknown>) => Promise<void>|void} fn - Cleanup function executed after processing; receives the full items array.
      * @param {unknown} [thisArg] - Optional this binding for the cleanup function
      * @returns {Piper} - The pipeline instance
      */
-    addCleanup(fn: () => Promise<void> | void, thisArg?: unknown): Piper;
+    addCleanup(fn: (items: Array<unknown>) => Promise<void> | void, thisArg?: unknown): Piper;
     /**
      * Process items through the pipeline with concurrency control
      *

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;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"}
+{"version":3,"file":"Piper.d.ts","sourceRoot":"","sources":["../../../browser/lib/Piper.js"],"names":[],"mappings":"AAaA;;GAEG;AAEH;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,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAC,IAAI,YAC7C,OAAO,GACL,KAAK,CAMjB;IAED;;;;;;OAMG;IACH,eAJW,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAC,IAAI,YAC7C,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;4BA9LyD,kBAAkB"}