@moostjs/event-wf 0.6.17 → 0.6.18

package/dist/index.cjs

@@ -127,7 +127,7 @@ const CONTEXT_TYPE = "WF";
 * ```ts
 * const wf = new MoostWf()
 * app.adapter(wf).controllers(MyWorkflows).init()
-* const result = await wf.start('my-flow', {}, input)
+* const result = await wf.start('my-flow', {}, { input })
 * ```
 */ var MoostWf = class {
 	async onNotFound() {
@@ -169,8 +169,8 @@ const CONTEXT_TYPE = "WF";
 	* @returns The outlet result (form payload + token), finished response, or error.
 	*/ handleOutlet(config) {
 		return (0, _wooksjs_event_wf.handleWfOutletRequest)(config, {
-			start: (schemaId, context, opts) => this.start(schemaId, context, opts?.input),
-			resume: (state, opts) => this.resume(state, opts?.input)
+			start: (schemaId, context, opts) => this.start(schemaId, context, opts),
+			resume: (state, opts) => this.resume(state, opts)
 		});
 	}
 	/**
@@ -178,10 +178,14 @@ const CONTEXT_TYPE = "WF";
 	*
 	* @param schemaId - Identifier of the registered workflow schema.
 	* @param initialContext - Initial context data for the workflow.
-	* @param input - Optional input passed to the first step.
-	*/ start(schemaId, initialContext, input) {
+	* @param opts - Optional run options: `input` for the first step, `eventContext`
+	*   to link this run to a parent event scope (e.g. an HTTP request), and
+	*   `strategy.name` to pick the initial state strategy. Passing a bare
+	*   `input` value (legacy positional form) is no longer supported — wrap it
+	*   in `{ input }`.
+	*/ start(schemaId, initialContext, opts) {
 		return this.wfApp.start(schemaId, initialContext, {
-			input,
+			...opts,
 			cleanup: () => {
 				(0, moost.getMoostInfact)().unregisterScope((0, moost.useScopeId)());
 			}
@@ -191,10 +195,12 @@ const CONTEXT_TYPE = "WF";
 	* Resumes a previously paused workflow from a saved state.
 	*
 	* @param state - Saved workflow state containing schema, context, and step indexes.
-	* @param input - Optional input for the resumed step.
-	*/ resume(state, input) {
+	* @param opts - Optional run options: `input` for the resumed step, `eventContext`
+	*   for parent-chain composable access, and `strategy.name` for the strategy
+	*   that loaded this state. Legacy positional `input` is no longer supported.
+	*/ resume(state, opts) {
 		return this.wfApp.resume(state, {
-			input,
+			...opts,
 			cleanup: () => {
 				(0, moost.getMoostInfact)().unregisterScope((0, moost.useScopeId)());
 			}
@@ -341,6 +347,12 @@ Object.defineProperty(exports, 'outletHttp', {
     return _prostojs_wf_outlets.outletHttp;
   }
 });
+Object.defineProperty(exports, 'swapStrategy', {
+  enumerable: true,
+  get: function () {
+    return _wooksjs_event_wf.swapStrategy;
+  }
+});
 Object.defineProperty(exports, 'useWfFinished', {
   enumerable: true,
   get: function () {
@@ -359,6 +371,12 @@ Object.defineProperty(exports, 'useWfState', {
     return _wooksjs_event_wf.useWfState;
   }
 });
+Object.defineProperty(exports, 'useWfStrategy', {
+  enumerable: true,
+  get: function () {
+    return _wooksjs_event_wf.useWfStrategy;
+  }
+});
 Object.defineProperty(exports, 'wfKind', {
   enumerable: true,
   get: function () {

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { TWorkflowSchema, TWorkflowSpy, TFlowOutput } from '@prostojs/wf';
 export { StepRetriableError, TFlowOutput, TWorkflowSchema } from '@prostojs/wf';
-import { WooksWf, TWooksWfOptions, WfOutletTriggerConfig } from '@wooksjs/event-wf';
-export { WfFinishedResponse, WfOutletTokenConfig, WfOutletTriggerConfig, WfOutletTriggerDeps, createEmailOutlet, createHttpOutlet, createOutletHandler, handleWfOutletRequest, useWfFinished, useWfOutlet, useWfState, wfKind } from '@wooksjs/event-wf';
+import { WooksWf, TWooksWfOptions, WfOutletTriggerConfig, TWfRunOptions } from '@wooksjs/event-wf';
+export { WfFinishedResponse, WfOutletTokenConfig, WfOutletTriggerConfig, WfOutletTriggerDeps, WfPauseRequest, createEmailOutlet, createHttpOutlet, createOutletHandler, handleWfOutletRequest, swapStrategy, useWfFinished, useWfOutlet, useWfState, useWfStrategy, wfKind } from '@wooksjs/event-wf';
 import { TMoostAdapter, Moost, TMoostAdapterOptions } from 'moost';
 export { EncapsulatedStateStrategy, HandleStateStrategy, WfOutlet, WfOutletRequest, WfOutletResult, WfState, WfStateStore, WfStateStoreMemory, WfStateStrategy, outlet, outletEmail, outletHttp } from '@prostojs/wf/outlets';
 
@@ -91,7 +91,7 @@ interface TWfHandlerMeta {
  * ```ts
  * const wf = new MoostWf()
  * app.adapter(wf).controllers(MyWorkflows).init()
- * const result = await wf.start('my-flow', {}, input)
+ * const result = await wf.start('my-flow', {}, { input })
  * ```
  */
 declare class MoostWf<T = any, IR = any> implements TMoostAdapter<TWfHandlerMeta> {
@@ -128,20 +128,26 @@ declare class MoostWf<T = any, IR = any> implements TMoostAdapter<TWfHandlerMeta
      *
      * @param schemaId - Identifier of the registered workflow schema.
      * @param initialContext - Initial context data for the workflow.
-     * @param input - Optional input passed to the first step.
+     * @param opts - Optional run options: `input` for the first step, `eventContext`
+     *   to link this run to a parent event scope (e.g. an HTTP request), and
+     *   `strategy.name` to pick the initial state strategy. Passing a bare
+     *   `input` value (legacy positional form) is no longer supported — wrap it
+     *   in `{ input }`.
      */
-    start<I>(schemaId: string, initialContext: T, input?: I): Promise<TFlowOutput<T, I, IR>>;
+    start<I>(schemaId: string, initialContext: T, opts?: TWfRunOptions<I, T, IR>): Promise<TFlowOutput<T, I, IR>>;
     /**
      * Resumes a previously paused workflow from a saved state.
      *
      * @param state - Saved workflow state containing schema, context, and step indexes.
-     * @param input - Optional input for the resumed step.
+     * @param opts - Optional run options: `input` for the resumed step, `eventContext`
+     *   for parent-chain composable access, and `strategy.name` for the strategy
+     *   that loaded this state. Legacy positional `input` is no longer supported.
      */
     resume<I>(state: {
         schemaId: string;
         context: T;
         indexes: number[];
-    }, input?: I): Promise<TFlowOutput<T, I, IR>>;
+    }, opts?: TWfRunOptions<I, T, IR>): Promise<TFlowOutput<T, I, IR>>;
     bindHandler<T extends object = object>(opts: TMoostAdapterOptions<TWfHandlerMeta, T>): void;
 }
 

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { WooksWf, createEmailOutlet, createHttpOutlet, createOutletHandler, createWfApp, handleWfOutletRequest, handleWfOutletRequest as handleWfOutletRequest$1, useWfFinished, useWfOutlet, useWfState, useWfState as useWfState$1, wfKind } from "@wooksjs/event-wf";
+import { WooksWf, createEmailOutlet, createHttpOutlet, createOutletHandler, createWfApp, handleWfOutletRequest, handleWfOutletRequest as handleWfOutletRequest$1, swapStrategy, useWfFinished, useWfOutlet, useWfState, useWfState as useWfState$1, useWfStrategy, wfKind } from "@wooksjs/event-wf";
 import { Resolve, defineMoostEventHandler, getMoostInfact, getMoostMate, setControllerContext, useScopeId } from "moost";
 import { StepRetriableError } from "@prostojs/wf";
 import { EncapsulatedStateStrategy, HandleStateStrategy, WfStateStoreMemory, outlet, outletEmail, outletHttp } from "@prostojs/wf/outlets";
@@ -126,7 +126,7 @@ const CONTEXT_TYPE = "WF";
 * ```ts
 * const wf = new MoostWf()
 * app.adapter(wf).controllers(MyWorkflows).init()
-* const result = await wf.start('my-flow', {}, input)
+* const result = await wf.start('my-flow', {}, { input })
 * ```
 */ var MoostWf = class {
 	async onNotFound() {
@@ -168,8 +168,8 @@ const CONTEXT_TYPE = "WF";
 	* @returns The outlet result (form payload + token), finished response, or error.
 	*/ handleOutlet(config) {
 		return handleWfOutletRequest$1(config, {
-			start: (schemaId, context, opts) => this.start(schemaId, context, opts?.input),
-			resume: (state, opts) => this.resume(state, opts?.input)
+			start: (schemaId, context, opts) => this.start(schemaId, context, opts),
+			resume: (state, opts) => this.resume(state, opts)
 		});
 	}
 	/**
@@ -177,10 +177,14 @@ const CONTEXT_TYPE = "WF";
 	*
 	* @param schemaId - Identifier of the registered workflow schema.
 	* @param initialContext - Initial context data for the workflow.
-	* @param input - Optional input passed to the first step.
-	*/ start(schemaId, initialContext, input) {
+	* @param opts - Optional run options: `input` for the first step, `eventContext`
+	*   to link this run to a parent event scope (e.g. an HTTP request), and
+	*   `strategy.name` to pick the initial state strategy. Passing a bare
+	*   `input` value (legacy positional form) is no longer supported — wrap it
+	*   in `{ input }`.
+	*/ start(schemaId, initialContext, opts) {
 		return this.wfApp.start(schemaId, initialContext, {
-			input,
+			...opts,
 			cleanup: () => {
 				getMoostInfact().unregisterScope(useScopeId());
 			}
@@ -190,10 +194,12 @@ const CONTEXT_TYPE = "WF";
 	* Resumes a previously paused workflow from a saved state.
 	*
 	* @param state - Saved workflow state containing schema, context, and step indexes.
-	* @param input - Optional input for the resumed step.
-	*/ resume(state, input) {
+	* @param opts - Optional run options: `input` for the resumed step, `eventContext`
+	*   for parent-chain composable access, and `strategy.name` for the strategy
+	*   that loaded this state. Legacy positional `input` is no longer supported.
+	*/ resume(state, opts) {
 		return this.wfApp.resume(state, {
-			input,
+			...opts,
 			cleanup: () => {
 				getMoostInfact().unregisterScope(useScopeId());
 			}
@@ -268,4 +274,4 @@ const CONTEXT_TYPE = "WF";
 };
 
 //#endregion
-export { EncapsulatedStateStrategy, HandleStateStrategy, MoostWf, Step, StepRetriableError, StepTTL, WfStateStoreMemory, Workflow, WorkflowParam, WorkflowSchema, createEmailOutlet, createHttpOutlet, createOutletHandler, handleWfOutletRequest, outlet, outletEmail, outletHttp, useWfFinished, useWfOutlet, useWfState, wfKind };
+export { EncapsulatedStateStrategy, HandleStateStrategy, MoostWf, Step, StepRetriableError, StepTTL, WfStateStoreMemory, Workflow, WorkflowParam, WorkflowSchema, createEmailOutlet, createHttpOutlet, createOutletHandler, handleWfOutletRequest, outlet, outletEmail, outletHttp, swapStrategy, useWfFinished, useWfOutlet, useWfState, useWfStrategy, wfKind };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moostjs/event-wf",
-  "version": "0.6.17",
+  "version": "0.6.18",
   "description": "@moostjs/event-wf",
   "keywords": [
     "composables",
@@ -39,7 +39,7 @@
   },
   "dependencies": {
     "@prostojs/wf": "^0.2.1",
-    "@wooksjs/event-wf": "^0.7.15"
+    "@wooksjs/event-wf": "^0.7.16"
   },
   "devDependencies": {
     "vitest": "3.2.4"
@@ -47,9 +47,9 @@
   "peerDependencies": {
     "@prostojs/infact": "^0.4.1",
     "@prostojs/mate": "^0.4.0",
-    "@wooksjs/event-core": "^0.7.15",
-    "wooks": "^0.7.15",
-    "moost": "^0.6.17"
+    "@wooksjs/event-core": "^0.7.16",
+    "wooks": "^0.7.16",
+    "moost": "^0.6.18"
   },
   "scripts": {
     "pub": "pnpm publish --access public",