@acmekit/workflows-sdk 2.13.36 → 2.13.38

package/dist/utils/composer/metadata.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.metadata = void 0;
+const orchestration_1 = require("@acmekit/orchestration");
+const utils_1 = require("@acmekit/utils");
+const ulid_1 = require("ulid");
+const create_step_1 = require("./create-step");
+const step_response_1 = require("./helpers/step-response");
+const transform_1 = require("./transform");
+/**
+ * No-op metadata implementation used when called outside any context.
+ */
+const noopMetadata = {
+    get: () => undefined,
+    set: () => exports.metadata,
+    del: () => exports.metadata,
+    current: () => ({}),
+    append: () => exports.metadata,
+    remove: () => exports.metadata,
+    increment: () => exports.metadata,
+    decrement: () => exports.metadata,
+};
+function getComposerContext() {
+    return global[utils_1.OrchestrationUtils.SymbolAcmeKitWorkflowComposerContext];
+}
+/**
+ * Composer-level handlers — create internal steps / transforms
+ * so that metadata operations participate in the workflow DAG.
+ */
+const composerHandlers = {
+    set(key, value) {
+        const step = (0, create_step_1.createStep)(`set-metadata-${(0, ulid_1.ulid)()}`, async (input) => {
+            exports.metadata.set(input.key, input.value);
+            return new step_response_1.StepResponse(void 0);
+        });
+        step({ key, value });
+        return exports.metadata;
+    },
+    get(key) {
+        return (0, transform_1.transform)({}, () => exports.metadata.get(key));
+    },
+    del(key) {
+        const step = (0, create_step_1.createStep)(`del-metadata-${(0, ulid_1.ulid)()}`, async (input) => {
+            exports.metadata.del(input.key);
+            return new step_response_1.StepResponse(void 0);
+        });
+        step({ key });
+        return exports.metadata;
+    },
+    current() {
+        return (0, transform_1.transform)({}, () => exports.metadata.current());
+    },
+    append(key, value) {
+        const step = (0, create_step_1.createStep)(`append-metadata-${(0, ulid_1.ulid)()}`, async (input) => {
+            exports.metadata.append(input.key, input.value);
+            return new step_response_1.StepResponse(void 0);
+        });
+        step({ key, value });
+        return exports.metadata;
+    },
+    remove(key, value) {
+        const step = (0, create_step_1.createStep)(`remove-metadata-${(0, ulid_1.ulid)()}`, async (input) => {
+            exports.metadata.remove(input.key, input.value);
+            return new step_response_1.StepResponse(void 0);
+        });
+        step({ key, value });
+        return exports.metadata;
+    },
+    increment(key, amount) {
+        const step = (0, create_step_1.createStep)(`increment-metadata-${(0, ulid_1.ulid)()}`, async (input) => {
+            exports.metadata.increment(input.key, input.amount);
+            return new step_response_1.StepResponse(void 0);
+        });
+        step({ key, amount: amount ?? 1 });
+        return exports.metadata;
+    },
+    decrement(key, amount) {
+        const step = (0, create_step_1.createStep)(`decrement-metadata-${(0, ulid_1.ulid)()}`, async (input) => {
+            exports.metadata.decrement(input.key, input.amount);
+            return new step_response_1.StepResponse(void 0);
+        });
+        step({ key, amount: amount ?? 1 });
+        return exports.metadata;
+    },
+};
+/**
+ * Unified metadata accessor. Works in all contexts:
+ *
+ * 1. **Inside step functions / query handlers / transform callbacks** —
+ *    Reads and writes go directly to the workflow's `flow.customMetadata`
+ *    via `AsyncLocalStorage`.
+ *
+ * 2. **Inside the workflow definition body** (same level as `transform()`,
+ *    `when()`) — Each write creates a lightweight internal step that
+ *    executes at runtime. `metadata.get()` creates a transform that
+ *    returns a `WorkflowData` proxy.
+ *
+ * 3. **Outside any context** — Safe no-op. Reads return `undefined`,
+ *    writes are silent.
+ *
+ * @example
+ * import { createStep, createWorkflow, metadata, StepResponse } from "@acmekit/framework/workflows-sdk"
+ *
+ * const step1 = createStep("step1", async () => {
+ *   metadata.set("stage", "processing")  // direct write
+ *   return new StepResponse("ok")
+ * })
+ *
+ * const step2 = createStep("step2", async () => {
+ *   return new StepResponse({ stage: metadata.get("stage") })
+ * })
+ *
+ * createWorkflow("my-wf", (input) => {
+ *   step1()
+ *   metadata.set("source", "workflow")   // creates internal step
+ *   const source = metadata.get("source") // creates transform → WorkflowData
+ *   return step2()
+ * })
+ */
+exports.metadata = new Proxy(noopMetadata, {
+    get(_target, prop, _receiver) {
+        // 1. Inside step / query / transform execution (AsyncLocalStorage active)
+        const store = (0, orchestration_1.getActiveMetadataStore)();
+        if (store)
+            return store[prop];
+        // 2. Inside workflow composer body (definition time)
+        if (getComposerContext() && prop in composerHandlers) {
+            return composerHandlers[prop];
+        }
+        // 3. No-op fallback
+        return noopMetadata[prop];
+    },
+});
+//# sourceMappingURL=metadata.js.map

package/dist/utils/composer/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../../src/utils/composer/metadata.ts"],"names":[],"mappings":"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"}

package/dist/utils/composer/query.d.ts

@@ -0,0 +1,38 @@
+import { QueryDefinition } from "@acmekit/orchestration";
+export type { QueryDefinition };
+/**
+ * Define a query that can be invoked on a running workflow instance.
+ *
+ * @typeParam TResult - The type of the query result.
+ * @param name - A unique query name.
+ * @returns A query definition to be used with `query()` inside workflows and `.query()` from outside.
+ *
+ * @example
+ * const statusQuery = defineQuery<string>("status")
+ */
+export declare function defineQuery<TResult = unknown>(name: string): QueryDefinition<TResult>;
+/**
+ * Register a query handler in the current workflow.
+ *
+ * Creates no flow graph entry and no step. Queries allow external callers
+ * to read workflow state without advancing the state machine or writing a checkpoint.
+ *
+ * The `key` function is per-query — different queries in the same workflow
+ * can route by different keys.
+ *
+ * @param def - The query definition (from `defineQuery`).
+ * @param opts - Configuration for the query.
+ * @param opts.key - A function that extracts the routing key from the workflow input.
+ * @param opts.handler - The handler function that returns the query result.
+ *
+ * @example
+ * query(statusQuery, {
+ *   key: (input) => input.orderId,
+ *   handler: ({ context, flow }) => flow.state
+ * })
+ */
+export declare function query<TResult>(def: QueryDefinition<TResult>, opts: {
+    key?: (input: any) => string;
+    handler: (ctx: any) => TResult;
+}): void;
+//# sourceMappingURL=query.d.ts.map

package/dist/utils/composer/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/utils/composer/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAMxD,YAAY,EAAE,eAAe,EAAE,CAAA;AAE/B;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAG,OAAO,EAC3C,IAAI,EAAE,MAAM,GACX,eAAe,CAAC,OAAO,CAAC,CAK1B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAC3B,GAAG,EAAE,eAAe,CAAC,OAAO,CAAC,EAC7B,IAAI,EAAE;IACJ,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,MAAM,CAAA;IAC5B,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAA;CAC/B,GACA,IAAI,CAkBN"}

package/dist/utils/composer/query.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineQuery = defineQuery;
+exports.query = query;
+const utils_1 = require("@acmekit/utils");
+/**
+ * Define a query that can be invoked on a running workflow instance.
+ *
+ * @typeParam TResult - The type of the query result.
+ * @param name - A unique query name.
+ * @returns A query definition to be used with `query()` inside workflows and `.query()` from outside.
+ *
+ * @example
+ * const statusQuery = defineQuery<string>("status")
+ */
+function defineQuery(name) {
+    return {
+        name,
+        __type: "query_definition",
+    };
+}
+/**
+ * Register a query handler in the current workflow.
+ *
+ * Creates no flow graph entry and no step. Queries allow external callers
+ * to read workflow state without advancing the state machine or writing a checkpoint.
+ *
+ * The `key` function is per-query — different queries in the same workflow
+ * can route by different keys.
+ *
+ * @param def - The query definition (from `defineQuery`).
+ * @param opts - Configuration for the query.
+ * @param opts.key - A function that extracts the routing key from the workflow input.
+ * @param opts.handler - The handler function that returns the query result.
+ *
+ * @example
+ * query(statusQuery, {
+ *   key: (input) => input.orderId,
+ *   handler: ({ context, flow }) => flow.state
+ * })
+ */
+function query(def, opts) {
+    const context = global[utils_1.OrchestrationUtils.SymbolAcmeKitWorkflowComposerContext];
+    if (!context) {
+        throw new Error("query() must be used inside a createWorkflow definition");
+    }
+    // Store the query registration for runtime wiring
+    context.queryRegistrations_ ??= [];
+    context.queryRegistrations_.push({
+        name: def.name,
+        keyFn: opts.key,
+        handler: opts.handler,
+    });
+}
+//# sourceMappingURL=query.js.map

package/dist/utils/composer/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/utils/composer/query.ts"],"names":[],"mappings":";;AAkBA,kCAOC;AAsBD,sBAwBC;AAtED,0CAAmD;AAOnD;;;;;;;;;GASG;AACH,SAAgB,WAAW,CACzB,IAAY;IAEZ,OAAO;QACL,IAAI;QACJ,MAAM,EAAE,kBAAkB;KACC,CAAA;AAC/B,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,KAAK,CACnB,GAA6B,EAC7B,IAGC;IAED,MAAM,OAAO,GAAG,MAAM,CACpB,0BAAkB,CAAC,oCAAoC,CACvB,CAAA;IAElC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,yDAAyD,CAC1D,CAAA;IACH,CAAC;IAED,kDAAkD;IAClD,OAAO,CAAC,mBAAmB,KAAK,EAAE,CAAA;IAClC,OAAO,CAAC,mBAAmB,CAAC,IAAI,CAAC;QAC/B,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,KAAK,EAAE,IAAI,CAAC,GAAG;QACf,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC,CAAA;AACJ,CAAC"}

package/dist/utils/composer/signal.d.ts

@@ -0,0 +1,42 @@
+import { SignalDefinition } from "@acmekit/orchestration";
+import { WorkflowData } from "./type";
+export type { SignalDefinition };
+/**
+ * Define a signal that can be sent to a running workflow instance.
+ *
+ * @typeParam TPayload - The type of the payload the signal carries.
+ * @param name - A unique signal name.
+ * @returns A signal definition to be used with `signal()` inside workflows and `.signal()` from outside.
+ *
+ * @example
+ * const approvalSignal = defineSignal<{ approvedBy: string }>("approval")
+ */
+export declare function defineSignal<TPayload = unknown>(name: string): SignalDefinition<TPayload>;
+/**
+ * Register a signal step in the current workflow.
+ *
+ * Sets `definition.signal = { name, key, timeout }` on the step.
+ * Does not wrap createStep — adds the action directly to the flow graph
+ * with a no-op handler that returns void (so the orchestrator treats it
+ * as an awaiting async step).
+ *
+ * The `key` function is called at composition time with the workflow `input`
+ * proxy, producing a `WorkflowData` reference. At runtime, the handler resolves
+ * the key from the transaction context, sets it on `step.definition.signal.key`,
+ * and registers the signal in the signal index for O(1) routing.
+ *
+ * @param def - The signal definition (from `defineSignal`).
+ * @param opts - Configuration for the signal step.
+ * @param opts.key - A function that extracts the routing key from the workflow input.
+ * @param opts.timeout - Optional timeout as a number (seconds) or duration string (e.g. "7d").
+ * @returns WorkflowData containing the signal payload when delivered.
+ *
+ * @example
+ * const byOrderId = (input: { orderId: string }) => input.orderId
+ * const approval = signal(approvalSignal, { key: byOrderId, timeout: "7d" })
+ */
+export declare function signal<TPayload>(def: SignalDefinition<TPayload>, opts?: {
+    key?: (input: any) => string;
+    timeout?: number | string;
+}): WorkflowData<TPayload>;
+//# sourceMappingURL=signal.d.ts.map

package/dist/utils/composer/signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../../../src/utils/composer/signal.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,gBAAgB,EAEjB,MAAM,wBAAwB,CAAA;AAK/B,OAAO,EAEL,YAAY,EACb,MAAM,QAAQ,CAAA;AAEf,YAAY,EAAE,gBAAgB,EAAE,CAAA;AAEhC;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,QAAQ,GAAG,OAAO,EAC7C,IAAI,EAAE,MAAM,GACX,gBAAgB,CAAC,QAAQ,CAAC,CAK5B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,MAAM,CAAC,QAAQ,EAC7B,GAAG,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EAC/B,IAAI,GAAE;IACJ,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,MAAM,CAAA;IAC5B,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CACrB,GACL,YAAY,CAAC,QAAQ,CAAC,CA0FxB"}

package/dist/utils/composer/signal.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineSignal = defineSignal;
+exports.signal = signal;
+const orchestration_1 = require("@acmekit/orchestration");
+const utils_1 = require("@acmekit/utils");
+const ulid_1 = require("ulid");
+const resolve_value_1 = require("./helpers/resolve-value");
+const proxy_1 = require("./helpers/proxy");
+/**
+ * Define a signal that can be sent to a running workflow instance.
+ *
+ * @typeParam TPayload - The type of the payload the signal carries.
+ * @param name - A unique signal name.
+ * @returns A signal definition to be used with `signal()` inside workflows and `.signal()` from outside.
+ *
+ * @example
+ * const approvalSignal = defineSignal<{ approvedBy: string }>("approval")
+ */
+function defineSignal(name) {
+    return {
+        name,
+        __type: "signal_definition",
+    };
+}
+/**
+ * Register a signal step in the current workflow.
+ *
+ * Sets `definition.signal = { name, key, timeout }` on the step.
+ * Does not wrap createStep — adds the action directly to the flow graph
+ * with a no-op handler that returns void (so the orchestrator treats it
+ * as an awaiting async step).
+ *
+ * The `key` function is called at composition time with the workflow `input`
+ * proxy, producing a `WorkflowData` reference. At runtime, the handler resolves
+ * the key from the transaction context, sets it on `step.definition.signal.key`,
+ * and registers the signal in the signal index for O(1) routing.
+ *
+ * @param def - The signal definition (from `defineSignal`).
+ * @param opts - Configuration for the signal step.
+ * @param opts.key - A function that extracts the routing key from the workflow input.
+ * @param opts.timeout - Optional timeout as a number (seconds) or duration string (e.g. "7d").
+ * @returns WorkflowData containing the signal payload when delivered.
+ *
+ * @example
+ * const byOrderId = (input: { orderId: string }) => input.orderId
+ * const approval = signal(approvalSignal, { key: byOrderId, timeout: "7d" })
+ */
+function signal(def, opts = {}) {
+    const context = global[utils_1.OrchestrationUtils.SymbolAcmeKitWorkflowComposerContext];
+    if (!context) {
+        throw new Error("signal() must be used inside a createWorkflow definition");
+    }
+    const stepName = `__signal_${def.name}`;
+    // Evaluate key function at composition time with input proxy.
+    // Produces a WorkflowData reference that resolves at runtime.
+    let keyRef;
+    if (opts.key) {
+        const inputProxy = (0, proxy_1.proxify)({
+            __type: utils_1.OrchestrationUtils.SymbolInputReference,
+            __step__: "",
+        });
+        keyRef = opts.key(inputProxy);
+    }
+    const signalField = {
+        name: def.name,
+        timeout: opts.timeout,
+    };
+    const stepConfig = {
+        async: true,
+        noCompensation: true,
+        saveResponse: true,
+        signal: signalField,
+        uuid: (0, ulid_1.ulid)(),
+    };
+    // No-op handler: signal steps wait for external delivery.
+    // The handler resolves the key at runtime and registers the signal
+    // in the signal index and flow's signalRegistry for O(1) routing.
+    const handler = {
+        invoke: async (stepArguments) => {
+            const { transaction, step } = stepArguments;
+            const flow = transaction.getFlow();
+            // Resolve and set the key value at runtime
+            if (keyRef) {
+                const txContext = transaction.getContext();
+                let actualKey = (0, resolve_value_1.resolveValue)(keyRef, txContext);
+                if (actualKey instanceof Promise) {
+                    actualKey = await actualKey;
+                }
+                if (actualKey != null) {
+                    step.definition.signal.key = String(actualKey);
+                }
+            }
+            // Register in flow's signalRegistry (persisted in checkpoints)
+            flow.signalRegistry ??= {};
+            flow.signalRegistry[def.name] = step.definition.action;
+            // Register in WorkflowManager signal index for O(1) routing
+            const sig = step.definition.signal;
+            orchestration_1.WorkflowManager.registerSignalIndex(flow.modelId, sig.name, sig.key, flow.transactionId);
+            // Persist the signalRegistry to the checkpoint so that
+            // a later `retrieveExistingTransaction` sees the registration.
+            await transaction.saveCheckpoint();
+            // Return void — orchestrator treats this as awaiting async step
+            return undefined;
+        },
+        compensate: undefined,
+    };
+    context.flow.addAction(stepName, stepConfig);
+    context.isAsync = true;
+    context.handlers.set(stepName, handler);
+    const ret = {
+        __type: utils_1.OrchestrationUtils.SymbolWorkflowStep,
+        __step__: stepName,
+    };
+    return (0, proxy_1.proxify)(ret);
+}
+//# sourceMappingURL=signal.js.map

package/dist/utils/composer/signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.js","sourceRoot":"","sources":["../../../src/utils/composer/signal.ts"],"names":[],"mappings":"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"}

package/dist/utils/composer/type.d.ts

@@ -1,8 +1,25 @@
-import { LocalWorkflow, OrchestratorBuilder, TransactionContext as OriginalWorkflowTransactionContext, TransactionModelOptions, TransactionPayload, TransactionStepsDefinition, WorkflowHandler } from "@acmekit/orchestration";
+import { LocalWorkflow, OrchestratorBuilder, TransactionContext as OriginalWorkflowTransactionContext, TransactionModelOptions, TransactionPayload, TransactionStepsDefinition, WorkflowHandler, WorkflowMetadata } from "@acmekit/orchestration";
 import { Context, LoadedModule, AcmeKitContainer } from "@acmekit/types";
 import { ExportedWorkflow } from "../../helper";
 import { Hook } from "./create-hook";
 import { CompensateFn, InvokeFn } from "./create-step";
+/**
+ * Generic schema interface. Supports Zod (.parse), Yup (.validate),
+ * or any custom validator exposing either method.
+ */
+export type SchemaLike<T> = {
+    parse(data: unknown): T;
+} | {
+    validate(data: unknown): T;
+};
+/** Extract output type T from a SchemaLike<T>. */
+export type InferSchemaOutput<S> = S extends {
+    parse(data: unknown): infer T;
+} ? T : S extends {
+    validate(data: unknown): infer T;
+} ? T : never;
+/** @internal Runtime dispatch: calls .parse() or .validate(), whichever exists. */
+export declare function runSchema<T>(schema: SchemaLike<T>, data: unknown): T;
 export type StepFunctionResult<TOutput extends unknown | unknown[] = unknown> = (this: CreateWorkflowComposerContext) => WorkflowData<TOutput>;
 export type StepFunctionReturnConfig<TOutput> = {
     config(config: {
@@ -49,6 +66,11 @@ export type WorkflowData<T = unknown> = (T extends Array<infer Item> ? Array<Ite
         name?: string;
     } & Omit<TransactionStepsDefinition, "next" | "uuid" | "action">): WorkflowData<T>;
 };
+export type QueryRegistration = {
+    name: string;
+    keyFn?: (input: any) => string;
+    handler: (ctx: any) => unknown;
+};
 export type CreateWorkflowComposerContext = {
     __type: string;
     hooks_: {
@@ -68,6 +90,11 @@ export type CreateWorkflowComposerContext = {
         input: any;
     }>;
     parallelizeBinder: <TOutput extends (WorkflowData | undefined)[] = WorkflowData[]>(fn: (this: CreateWorkflowComposerContext) => TOutput) => TOutput;
+    /**
+     * Query definitions registered via the `query()` primitive.
+     * These are registered into `WorkflowManager.queryIndex_` when the workflow starts.
+     */
+    queryRegistrations_?: QueryRegistration[];
 };
 /**
  * The step's context.
@@ -106,9 +133,14 @@ export interface StepExecutionContext {
      */
     container: AcmeKitContainer;
     /**
-     * Metadata passed in the input.
+     * Workflow metadata accessor. Use to read/write arbitrary key-value
+     * pairs that persist across steps within the same workflow execution.
+     */
+    metadata: WorkflowMetadata;
+    /**
+     * @internal Original transaction payload metadata (attempt, action, idempotency_key, etc.).
      */
-    metadata: TransactionPayload["metadata"];
+    " transactionMetadata": TransactionPayload["metadata"];
     /**
      * {@inheritDoc types!Context}
      */
@@ -136,11 +168,6 @@ export interface StepExecutionContext {
      * Get access to the definition of the step.
      */
     " stepDefinition": TransactionStepsDefinition;
-    /**
-     * Step-level metadata defined via `createStep({ metadata: ... })`.
-     * Enables richer instrumentation, UI display, and alerting.
-     */
-    stepMetadata?: Record<string, unknown>;
 }
 export type WorkflowTransactionContext = StepExecutionContext & OriginalWorkflowTransactionContext & {
     invoke: {

package/dist/utils/composer/type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../../src/utils/composer/type.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../../src/utils/composer/type.ts"],"names":[],"mappings":"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"}

package/dist/utils/composer/type.js

@@ -1,3 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSchema = runSchema;
+/** @internal Runtime dispatch: calls .parse() or .validate(), whichever exists. */
+function runSchema(schema, data) {
+    if ("parse" in schema && typeof schema.parse === "function") {
+        return schema.parse(data);
+    }
+    if ("validate" in schema &&
+        typeof schema.validate === "function") {
+        return schema.validate(data);
+    }
+    throw new Error("Schema must implement parse() or validate()");
+}
 //# sourceMappingURL=type.js.map

package/dist/utils/composer/type.js.map

@@ -1 +1 @@
-{"version":3,"file":"type.js","sourceRoot":"","sources":["../../../src/utils/composer/type.ts"],"names":[],"mappings":""}
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../../../src/utils/composer/type.ts"],"names":[],"mappings":";;AA+BA,8BAWC;AAZD,mFAAmF;AACnF,SAAgB,SAAS,CAAI,MAAqB,EAAE,IAAa;IAC/D,IAAI,OAAO,IAAI,MAAM,IAAI,OAAQ,MAAc,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;QACrE,OAAQ,MAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACpC,CAAC;IACD,IACE,UAAU,IAAI,MAAM;QACpB,OAAQ,MAAc,CAAC,QAAQ,KAAK,UAAU,EAC9C,CAAC;QACD,OAAQ,MAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IACvC,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;AAChE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acmekit/workflows-sdk",
-  "version": "2.13.36",
+  "version": "2.13.38",
   "description": "Set of workflows tooling for AcmeKit",
   "main": "dist/index.js",
   "exports": {
@@ -27,13 +27,13 @@
   "author": "AcmeKit",
   "license": "MIT",
   "devDependencies": {
-    "@acmekit/types": "2.13.36"
+    "@acmekit/types": "2.13.38"
   },
   "dependencies": {
-    "@acmekit/deps": "2.13.36",
-    "@acmekit/modules-sdk": "2.13.36",
-    "@acmekit/orchestration": "2.13.36",
-    "@acmekit/utils": "2.13.36",
+    "@acmekit/deps": "2.13.38",
+    "@acmekit/modules-sdk": "2.13.38",
+    "@acmekit/orchestration": "2.13.38",
+    "@acmekit/utils": "2.13.38",
     "ulid": "^2.3.0"
   },
   "scripts": {

package/dist/testing/index.d.ts

@@ -1,4 +0,0 @@
-export * from "./mock-step";
-export * from "./types";
-export * from "./workflow-test-runner";
-//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,SAAS,CAAA;AACvB,cAAc,wBAAwB,CAAA"}

package/dist/testing/index.js

@@ -1,20 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./mock-step"), exports);
-__exportStar(require("./types"), exports);
-__exportStar(require("./workflow-test-runner"), exports);
-//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA2B;AAC3B,0CAAuB;AACvB,yDAAsC"}

package/dist/testing/mock-step.d.ts

@@ -1,26 +0,0 @@
-import { MockStepOptions } from "./types";
-/**
- * Replace the invoke and/or compensate handlers for a specific step in a
- * registered workflow. Useful for isolating a single step's behavior in tests.
- *
- * Returns a `restore` function that reverts the mock.
- *
- * @example
- * ```ts
- * const restore = mockStep("my-workflow", "create-record", {
- *   invoke: () => ({ id: "mock-id" }),
- * })
- *
- * const { result } = await myWorkflow.run({ input: { ... } })
- * expect(result.id).toBe("mock-id")
- *
- * restore()
- * ```
- */
-export declare function mockStep<TOutput = unknown>(workflowId: string, stepAction: string, options: MockStepOptions<TOutput>): () => void;
-/**
- * Restore all mocked steps for a given workflow (or all workflows).
- * Useful in `afterEach` / `afterAll` hooks.
- */
-export declare function restoreAllMocks(workflowId?: string): void;
-//# sourceMappingURL=mock-step.d.ts.map

package/dist/testing/mock-step.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mock-step.d.ts","sourceRoot":"","sources":["../../src/testing/mock-step.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AASzC;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,QAAQ,CAAC,OAAO,GAAG,OAAO,EACxC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,eAAe,CAAC,OAAO,CAAC,GAChC,MAAM,IAAI,CAwDZ;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAmBzD"}