@acmekit/workflows-sdk 2.13.36 → 2.13.38

package/dist/testing/mock-step.js

@@ -1,96 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.mockStep = mockStep;
-exports.restoreAllMocks = restoreAllMocks;
-const orchestration_1 = require("@acmekit/orchestration");
-const step_response_1 = require("../utils/composer/helpers/step-response");
-const originals = new Map();
-/**
- * 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()
- * ```
- */
-function mockStep(workflowId, stepAction, options) {
-    const workflow = orchestration_1.WorkflowManager.getWorkflow(workflowId);
-    if (!workflow) {
-        throw new Error(`Cannot mock step: workflow "${workflowId}" is not registered.`);
-    }
-    const handlers = workflow.handlers_;
-    const existing = handlers.get(stepAction);
-    if (!existing) {
-        throw new Error(`Cannot mock step: action "${stepAction}" not found in workflow "${workflowId}".`);
-    }
-    // Save originals for restoration
-    if (!originals.has(workflowId)) {
-        originals.set(workflowId, new Map());
-    }
-    if (!originals.get(workflowId).has(stepAction)) {
-        originals.get(workflowId).set(stepAction, { ...existing });
-    }
-    // Replace handlers
-    const mockedHandlers = { ...existing };
-    if (options.invoke) {
-        const mockInvoke = options.invoke;
-        mockedHandlers.invoke = async () => {
-            const result = await mockInvoke();
-            return new step_response_1.StepResponse(result, result);
-        };
-    }
-    if (options.compensate) {
-        const mockCompensate = options.compensate;
-        mockedHandlers.compensate = async () => {
-            await mockCompensate();
-        };
-    }
-    handlers.set(stepAction, mockedHandlers);
-    // Rebuild the handler function on the workflow definition
-    workflow.handler = orchestration_1.WorkflowManager.buildHandlers(handlers);
-    // Return restore function
-    return () => {
-        const original = originals.get(workflowId)?.get(stepAction);
-        if (original) {
-            handlers.set(stepAction, original);
-            workflow.handler = orchestration_1.WorkflowManager.buildHandlers(handlers);
-            originals.get(workflowId).delete(stepAction);
-        }
-    };
-}
-/**
- * Restore all mocked steps for a given workflow (or all workflows).
- * Useful in `afterEach` / `afterAll` hooks.
- */
-function restoreAllMocks(workflowId) {
-    if (workflowId) {
-        const mocks = originals.get(workflowId);
-        if (mocks) {
-            const workflow = orchestration_1.WorkflowManager.getWorkflow(workflowId);
-            if (workflow) {
-                for (const [action, original] of mocks.entries()) {
-                    workflow.handlers_.set(action, original);
-                }
-                workflow.handler = orchestration_1.WorkflowManager.buildHandlers(workflow.handlers_);
-            }
-            originals.delete(workflowId);
-        }
-    }
-    else {
-        for (const [wfId] of originals) {
-            restoreAllMocks(wfId);
-        }
-        originals.clear();
-    }
-}
-//# sourceMappingURL=mock-step.js.map

package/dist/testing/mock-step.js.map

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

package/dist/testing/types.d.ts

@@ -1,51 +0,0 @@
-import { DistributedTransactionType } from "@acmekit/orchestration";
-import { AcmeKitContainer } from "@acmekit/types";
-import { WorkflowResult } from "../helper/type";
-/**
- * Context object provided to test assertions after a workflow run.
- */
-export type WorkflowTestContext<TResult = unknown> = {
-    /** The workflow result */
-    result: WorkflowResult<TResult>;
-    /** All events captured during the run, in order */
-    events: WorkflowTestEvent[];
-    /** Errors thrown by the workflow (if any) */
-    errors: Error[];
-    /** The underlying transaction */
-    transaction: DistributedTransactionType;
-};
-/**
- * An event captured during a test run.
- */
-export type WorkflowTestEvent = {
-    /** Event name (e.g. "begin", "step_success", "finish") */
-    name: string;
-    /** Timestamp of the event */
-    timestamp: number;
-    /** Associated data */
-    data?: Record<string, unknown>;
-};
-/**
- * Options for `mockStep`.
- */
-export type MockStepOptions<TOutput = unknown> = {
-    /**
-     * The mock invoke handler. Return the value the step should produce.
-     * Throw to simulate a step failure.
-     */
-    invoke?: () => TOutput | Promise<TOutput>;
-    /**
-     * The mock compensate handler. Return void or throw to simulate compensation failure.
-     */
-    compensate?: () => void | Promise<void>;
-};
-/**
- * Options for `createWorkflowTestRunner`.
- */
-export type WorkflowTestRunnerOptions = {
-    /** A container or loaded modules to use for the test run. */
-    container?: AcmeKitContainer;
-    /** Whether to throw on errors (defaults to false for test inspection). */
-    throwOnError?: boolean;
-};
-//# sourceMappingURL=types.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/testing/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAA;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAE/C;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,OAAO,GAAG,OAAO,IAAI;IACnD,0BAA0B;IAC1B,MAAM,EAAE,cAAc,CAAC,OAAO,CAAC,CAAA;IAC/B,mDAAmD;IACnD,MAAM,EAAE,iBAAiB,EAAE,CAAA;IAC3B,6CAA6C;IAC7C,MAAM,EAAE,KAAK,EAAE,CAAA;IACf,iCAAiC;IACjC,WAAW,EAAE,0BAA0B,CAAA;CACxC,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAA;IACZ,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,sBAAsB;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,OAAO,GAAG,OAAO,IAAI;IAC/C;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACzC;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACxC,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,6DAA6D;IAC7D,SAAS,CAAC,EAAE,gBAAgB,CAAA;IAC5B,0EAA0E;IAC1E,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB,CAAA"}

package/dist/testing/types.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=types.js.map

package/dist/testing/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/testing/types.ts"],"names":[],"mappings":""}

package/dist/testing/workflow-test-runner.d.ts

@@ -1,35 +0,0 @@
-import { AcmeKitContainer } from "@acmekit/types";
-import { MainExportedWorkflow } from "../helper/type";
-import { WorkflowTestContext, WorkflowTestRunnerOptions } from "./types";
-/**
- * Creates a test runner that wraps a workflow with event capturing
- * and assertion-friendly output.
- *
- * @example
- * ```ts
- * import { createWorkflowTestRunner } from "@acmekit/workflows-sdk/testing"
- *
- * const runner = createWorkflowTestRunner(myWorkflow)
- *
- * it("should create a record", async () => {
- *   const { result, events, errors } = await runner.run({
- *     input: { name: "Test" },
- *   })
- *
- *   expect(errors).toHaveLength(0)
- *   expect(result.result).toEqual({ id: expect.any(String), name: "Test" })
- *   expect(events.some(e => e.name === "finish")).toBe(true)
- * })
- * ```
- */
-export declare function createWorkflowTestRunner<TData = unknown, TResult = unknown>(workflow: MainExportedWorkflow<TData, TResult>, options?: WorkflowTestRunnerOptions): {
-    /**
-     * Run the workflow and capture all events for assertions.
-     */
-    run(runOptions?: {
-        input?: TData;
-        container?: AcmeKitContainer;
-        throwOnError?: boolean;
-    }): Promise<WorkflowTestContext<TResult>>;
-};
-//# sourceMappingURL=workflow-test-runner.d.ts.map

package/dist/testing/workflow-test-runner.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"workflow-test-runner.d.ts","sourceRoot":"","sources":["../../src/testing/workflow-test-runner.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EAAE,oBAAoB,EAAkB,MAAM,gBAAgB,CAAA;AACrE,OAAO,EACL,mBAAmB,EAEnB,yBAAyB,EAC1B,MAAM,SAAS,CAAA;AAEhB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EACzE,QAAQ,EAAE,oBAAoB,CAAC,KAAK,EAAE,OAAO,CAAC,EAC9C,OAAO,CAAC,EAAE,yBAAyB;IAGjC;;OAEG;qBACoB;QACrB,KAAK,CAAC,EAAE,KAAK,CAAA;QACb,SAAS,CAAC,EAAE,gBAAgB,CAAA;QAC5B,YAAY,CAAC,EAAE,OAAO,CAAA;KACvB,GAAG,OAAO,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;EA0E5C"}

package/dist/testing/workflow-test-runner.js

@@ -1,99 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createWorkflowTestRunner = createWorkflowTestRunner;
-/**
- * Creates a test runner that wraps a workflow with event capturing
- * and assertion-friendly output.
- *
- * @example
- * ```ts
- * import { createWorkflowTestRunner } from "@acmekit/workflows-sdk/testing"
- *
- * const runner = createWorkflowTestRunner(myWorkflow)
- *
- * it("should create a record", async () => {
- *   const { result, events, errors } = await runner.run({
- *     input: { name: "Test" },
- *   })
- *
- *   expect(errors).toHaveLength(0)
- *   expect(result.result).toEqual({ id: expect.any(String), name: "Test" })
- *   expect(events.some(e => e.name === "finish")).toBe(true)
- * })
- * ```
- */
-function createWorkflowTestRunner(workflow, options) {
-    return {
-        /**
-         * Run the workflow and capture all events for assertions.
-         */
-        async run(runOptions) {
-            const events = [];
-            const errors = [];
-            const captureEvent = (name) => {
-                return (args) => {
-                    events.push({
-                        name,
-                        timestamp: Date.now(),
-                        data: args.transaction
-                            ? {
-                                transactionId: args.transaction.transactionId,
-                                state: args.transaction.getFlow().state,
-                            }
-                            : undefined,
-                    });
-                };
-            };
-            const eventHandlers = {
-                onBegin: captureEvent("begin"),
-                onResume: captureEvent("resume"),
-                onFinish: captureEvent("finish"),
-                onTimeout: captureEvent("timeout"),
-                onStepBegin: captureEvent("step_begin"),
-                onStepSuccess: captureEvent("step_success"),
-                onStepFailure: captureEvent("step_failure"),
-                onCompensateBegin: captureEvent("compensate_begin"),
-                onCompensateStepSuccess: captureEvent("compensate_step_success"),
-                onCompensateStepFailure: captureEvent("compensate_step_failure"),
-            };
-            const container = runOptions?.container ?? options?.container;
-            const throwOnError = runOptions?.throwOnError ?? options?.throwOnError ?? false;
-            let result;
-            try {
-                result = await workflow.run({
-                    input: runOptions?.input,
-                    container,
-                    throwOnError,
-                    events: eventHandlers,
-                });
-            }
-            catch (error) {
-                errors.push(error);
-                return {
-                    result: {
-                        errors: [error],
-                        transaction: undefined,
-                        result: undefined,
-                    },
-                    events,
-                    errors,
-                    transaction: undefined,
-                };
-            }
-            if (result.errors?.length) {
-                for (const err of result.errors) {
-                    if (err?.error) {
-                        errors.push(err.error);
-                    }
-                }
-            }
-            return {
-                result,
-                events,
-                errors,
-                transaction: result.transaction,
-            };
-        },
-    };
-}
-//# sourceMappingURL=workflow-test-runner.js.map

package/dist/testing/workflow-test-runner.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"workflow-test-runner.js","sourceRoot":"","sources":["../../src/testing/workflow-test-runner.ts"],"names":[],"mappings":";;AAiCA,4DAsFC;AA3GD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,wBAAwB,CACtC,QAA8C,EAC9C,OAAmC;IAEnC,OAAO;QACL;;WAEG;QACH,KAAK,CAAC,GAAG,CAAC,UAIT;YACC,MAAM,MAAM,GAAwB,EAAE,CAAA;YACtC,MAAM,MAAM,GAAY,EAAE,CAAA;YAE1B,MAAM,YAAY,GAAG,CAAC,IAAY,EAAE,EAAE;gBACpC,OAAO,CAAC,IAAkD,EAAE,EAAE;oBAC5D,MAAM,CAAC,IAAI,CAAC;wBACV,IAAI;wBACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;wBACrB,IAAI,EAAE,IAAI,CAAC,WAAW;4BACpB,CAAC,CAAC;gCACE,aAAa,EAAE,IAAI,CAAC,WAAW,CAAC,aAAa;gCAC7C,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,KAAK;6BACxC;4BACH,CAAC,CAAC,SAAS;qBACd,CAAC,CAAA;gBACJ,CAAC,CAAA;YACH,CAAC,CAAA;YAED,MAAM,aAAa,GAAiC;gBAClD,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC;gBAC9B,QAAQ,EAAE,YAAY,CAAC,QAAQ,CAAC;gBAChC,QAAQ,EAAE,YAAY,CAAC,QAAQ,CAAC;gBAChC,SAAS,EAAE,YAAY,CAAC,SAAS,CAAC;gBAClC,WAAW,EAAE,YAAY,CAAC,YAAY,CAAC;gBACvC,aAAa,EAAE,YAAY,CAAC,cAAc,CAAC;gBAC3C,aAAa,EAAE,YAAY,CAAC,cAAc,CAAC;gBAC3C,iBAAiB,EAAE,YAAY,CAAC,kBAAkB,CAAC;gBACnD,uBAAuB,EAAE,YAAY,CAAC,yBAAyB,CAAC;gBAChE,uBAAuB,EAAE,YAAY,CAAC,yBAAyB,CAAC;aACjE,CAAA;YAED,MAAM,SAAS,GAAG,UAAU,EAAE,SAAS,IAAI,OAAO,EAAE,SAAS,CAAA;YAC7D,MAAM,YAAY,GAChB,UAAU,EAAE,YAAY,IAAI,OAAO,EAAE,YAAY,IAAI,KAAK,CAAA;YAE5D,IAAI,MAA+B,CAAA;YACnC,IAAI,CAAC;gBACH,MAAM,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC;oBAC1B,KAAK,EAAE,UAAU,EAAE,KAAK;oBACxB,SAAS;oBACT,YAAY;oBACZ,MAAM,EAAE,aAAa;iBACf,CAAC,CAAA;YACX,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CAAC,KAAc,CAAC,CAAA;gBAC3B,OAAO;oBACL,MAAM,EAAE;wBACN,MAAM,EAAE,CAAC,KAAK,CAAC;wBACf,WAAW,EAAE,SAAgB;wBAC7B,MAAM,EAAE,SAAgB;qBACzB;oBACD,MAAM;oBACN,MAAM;oBACN,WAAW,EAAE,SAAgB;iBAC9B,CAAA;YACH,CAAC;YAED,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;gBAC1B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;oBAChC,IAAI,GAAG,EAAE,KAAK,EAAE,CAAC;wBACf,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;oBACxB,CAAC;gBACH,CAAC;YACH,CAAC;YAED,OAAO;gBACL,MAAM;gBACN,MAAM;gBACN,MAAM;gBACN,WAAW,EAAE,MAAM,CAAC,WAAW;aAChC,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/utils/composer/for-each.d.ts

@@ -1,25 +0,0 @@
-import { WorkflowData } from "./type";
-/**
- * Dynamic fan-out primitive. Iterates over a runtime array and runs the provided
- * step function for each element, collecting results. Compensation reverses the
- * iteration order.
- *
- * Unlike `parallelize`, `forEach` works with arrays whose length is unknown at
- * workflow definition time.
- *
- * @param name - A unique name for this forEach block.
- * @param items - A workflow data reference to an array of items.
- * @param stepFn - A step function to invoke for each item.
- *
- * @example
- * ```ts
- * import { forEach } from "@acmekit/framework/workflows-sdk"
- *
- * const notifyWorkflow = createWorkflow("notify-users", (input: { userIds: string[] }) => {
- *   const results = forEach("notify-each-user", input.userIds, sendNotificationStep)
- *   return new WorkflowResponse(results)
- * })
- * ```
- */
-export declare function forEach<TItem, TOutput>(name: string, items: WorkflowData<TItem[]>, stepFn: (item: TItem) => WorkflowData<TOutput> | TOutput): WorkflowData<TOutput[]>;
-//# sourceMappingURL=for-each.d.ts.map

package/dist/utils/composer/for-each.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"for-each.d.ts","sourceRoot":"","sources":["../../../src/utils/composer/for-each.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAErC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,EACpC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,YAAY,CAAC,KAAK,EAAE,CAAC,EAC5B,MAAM,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,YAAY,CAAC,OAAO,CAAC,GAAG,OAAO,GACvD,YAAY,CAAC,OAAO,EAAE,CAAC,CA6BzB"}

package/dist/utils/composer/for-each.js

@@ -1,50 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.forEach = forEach;
-const create_step_1 = require("./create-step");
-const step_response_1 = require("./helpers/step-response");
-/**
- * Dynamic fan-out primitive. Iterates over a runtime array and runs the provided
- * step function for each element, collecting results. Compensation reverses the
- * iteration order.
- *
- * Unlike `parallelize`, `forEach` works with arrays whose length is unknown at
- * workflow definition time.
- *
- * @param name - A unique name for this forEach block.
- * @param items - A workflow data reference to an array of items.
- * @param stepFn - A step function to invoke for each item.
- *
- * @example
- * ```ts
- * import { forEach } from "@acmekit/framework/workflows-sdk"
- *
- * const notifyWorkflow = createWorkflow("notify-users", (input: { userIds: string[] }) => {
- *   const results = forEach("notify-each-user", input.userIds, sendNotificationStep)
- *   return new WorkflowResponse(results)
- * })
- * ```
- */
-function forEach(name, items, stepFn) {
-    if (!name || typeof name !== "string") {
-        throw new Error(`"forEach" name must be a non-empty string`);
-    }
-    const forEachStep = (0, create_step_1.createStep)({
-        name,
-        saveResponse: true,
-    }, async (resolvedItems, context) => {
-        const results = [];
-        const compensateData = [];
-        for (const item of resolvedItems) {
-            const result = await Promise.resolve(stepFn(item));
-            results.push(result);
-            compensateData.push(item);
-        }
-        return new step_response_1.StepResponse(results, compensateData);
-    }, async (compensateData) => {
-        // Compensation is a no-op at the forEach level.
-        // Individual step compensations are handled by the inner step definitions.
-    });
-    return forEachStep(items);
-}
-//# sourceMappingURL=for-each.js.map

package/dist/utils/composer/for-each.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"for-each.js","sourceRoot":"","sources":["../../../src/utils/composer/for-each.ts"],"names":[],"mappings":";;AA0BA,0BAiCC;AA3DD,+CAA0C;AAC1C,2DAAsD;AAGtD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,SAAgB,OAAO,CACrB,IAAY,EACZ,KAA4B,EAC5B,MAAwD;IAExD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAA;IAC9D,CAAC;IAED,MAAM,WAAW,GAAG,IAAA,wBAAU,EAC5B;QACE,IAAI;QACJ,YAAY,EAAE,IAAI;KACnB,EACD,KAAK,EAAE,aAAsB,EAAE,OAAO,EAAE,EAAE;QACxC,MAAM,OAAO,GAAc,EAAE,CAAA;QAC7B,MAAM,cAAc,GAAY,EAAE,CAAA;QAElC,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;YAClD,OAAO,CAAC,IAAI,CAAC,MAAiB,CAAC,CAAA;YAC/B,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC3B,CAAC;QAED,OAAO,IAAI,4BAAY,CAAC,OAAO,EAAE,cAAc,CAAC,CAAA;IAClD,CAAC,EACD,KAAK,EAAE,cAAmC,EAAE,EAAE;QAC5C,gDAAgD;QAChD,2EAA2E;IAC7E,CAAC,CACF,CAAA;IAED,OAAO,WAAW,CAAC,KAAK,CAAC,CAAA;AAC3B,CAAC"}

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

@@ -1,24 +0,0 @@
-import { StepFunction, WorkflowData } from "./type";
-/**
- * Sequentially chains steps, passing the output of each as input to the next.
- * Pure ergonomics — compiles to the same sequential step chain.
- *
- * @example
- * ```ts
- * import { pipe } from "@acmekit/framework/workflows-sdk"
- *
- * const result = pipe(input, validateStep, transformStep, saveStep)
- * // Equivalent to:
- * // const a = validateStep(input)
- * // const b = transformStep(a)
- * // const c = saveStep(b)
- * ```
- */
-export declare function pipe<TInput, TA>(input: WorkflowData<TInput>, step1: StepFunction<TInput, TA>): WorkflowData<TA>;
-export declare function pipe<TInput, TA, TB>(input: WorkflowData<TInput>, step1: StepFunction<TInput, TA>, step2: StepFunction<TA, TB>): WorkflowData<TB>;
-export declare function pipe<TInput, TA, TB, TC>(input: WorkflowData<TInput>, step1: StepFunction<TInput, TA>, step2: StepFunction<TA, TB>, step3: StepFunction<TB, TC>): WorkflowData<TC>;
-export declare function pipe<TInput, TA, TB, TC, TD>(input: WorkflowData<TInput>, step1: StepFunction<TInput, TA>, step2: StepFunction<TA, TB>, step3: StepFunction<TB, TC>, step4: StepFunction<TC, TD>): WorkflowData<TD>;
-export declare function pipe<TInput, TA, TB, TC, TD, TE>(input: WorkflowData<TInput>, step1: StepFunction<TInput, TA>, step2: StepFunction<TA, TB>, step3: StepFunction<TB, TC>, step4: StepFunction<TC, TD>, step5: StepFunction<TD, TE>): WorkflowData<TE>;
-export declare function pipe<TInput, TA, TB, TC, TD, TE, TF>(input: WorkflowData<TInput>, step1: StepFunction<TInput, TA>, step2: StepFunction<TA, TB>, step3: StepFunction<TB, TC>, step4: StepFunction<TC, TD>, step5: StepFunction<TD, TE>, step6: StepFunction<TE, TF>): WorkflowData<TF>;
-export declare function pipe<TInput, TA, TB, TC, TD, TE, TF, TG>(input: WorkflowData<TInput>, step1: StepFunction<TInput, TA>, step2: StepFunction<TA, TB>, step3: StepFunction<TB, TC>, step4: StepFunction<TC, TD>, step5: StepFunction<TD, TE>, step6: StepFunction<TE, TF>, step7: StepFunction<TF, TG>): WorkflowData<TG>;
-//# sourceMappingURL=pipe.d.ts.map

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

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

package/dist/utils/composer/pipe.js

@@ -1,11 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.pipe = pipe;
-function pipe(input, ...steps) {
-    let current = input;
-    for (const step of steps) {
-        current = step(current);
-    }
-    return current;
-}
-//# sourceMappingURL=pipe.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"pipe.js","sourceRoot":"","sources":["../../../src/utils/composer/pipe.ts"],"names":[],"mappings":";;AAyEA,oBASC;AATD,SAAgB,IAAI,CAClB,KAAwB,EACxB,GAAG,KAA+B;IAElC,IAAI,OAAO,GAAG,KAAK,CAAA;IACnB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAA;IACzB,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC"}

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

@@ -1,19 +0,0 @@
-import { WorkflowData } from "./type";
-/**
- * Runs multiple steps in parallel and returns the first non-undefined result.
- * Other steps still complete but their results are discarded.
- *
- * Useful for timeout/fallback patterns where you want the fastest response.
- *
- * @example
- * ```ts
- * import { race } from "@acmekit/framework/workflows-sdk"
- *
- * const result = race(
- *   callPrimaryApiStep(input),
- *   callFallbackApiStep(input),
- * )
- * ```
- */
-export declare function race<TResult>(...steps: WorkflowData<TResult>[]): WorkflowData<TResult>;
-//# sourceMappingURL=race.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"race.d.ts","sourceRoot":"","sources":["../../../src/utils/composer/race.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAErC;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAC1B,GAAG,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,EAAE,GAChC,YAAY,CAAC,OAAO,CAAC,CA0BvB"}

package/dist/utils/composer/race.js

@@ -1,43 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.race = race;
-const utils_1 = require("@acmekit/utils");
-const parallelize_1 = require("./parallelize");
-const transform_1 = require("./transform");
-/**
- * Runs multiple steps in parallel and returns the first non-undefined result.
- * Other steps still complete but their results are discarded.
- *
- * Useful for timeout/fallback patterns where you want the fastest response.
- *
- * @example
- * ```ts
- * import { race } from "@acmekit/framework/workflows-sdk"
- *
- * const result = race(
- *   callPrimaryApiStep(input),
- *   callFallbackApiStep(input),
- * )
- * ```
- */
-function race(...steps) {
-    if (!global[utils_1.OrchestrationUtils.SymbolAcmeKitWorkflowComposerContext]) {
-        throw new Error("race must be used inside a createWorkflow definition");
-    }
-    if (steps.length < 2) {
-        throw new Error("race requires at least 2 steps");
-    }
-    // Run all steps in parallel
-    const parallelResults = (0, parallelize_1.parallelize)(...steps);
-    // Pick the first defined result
-    const result = (0, transform_1.transform)({ results: parallelResults }, ({ results }) => {
-        for (const r of results) {
-            if (r !== undefined && r !== null) {
-                return r;
-            }
-        }
-        return results[0];
-    });
-    return result;
-}
-//# sourceMappingURL=race.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"race.js","sourceRoot":"","sources":["../../../src/utils/composer/race.ts"],"names":[],"mappings":";;AAqBA,oBA4BC;AAjDD,0CAAmD;AACnD,+CAA2C;AAC3C,2CAAuC;AAGvC;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,IAAI,CAClB,GAAG,KAA8B;IAEjC,IAAI,CAAC,MAAM,CAAC,0BAAkB,CAAC,oCAAoC,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAA;IACzE,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAA;IACnD,CAAC;IAED,4BAA4B;IAC5B,MAAM,eAAe,GAAG,IAAA,yBAAW,EAAC,GAAG,KAAK,CAAC,CAAA;IAE7C,gCAAgC;IAChC,MAAM,MAAM,GAAG,IAAA,qBAAS,EACtB,EAAE,OAAO,EAAE,eAAe,EAAE,EAC5B,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE;QACd,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;gBAClC,OAAO,CAAC,CAAA;YACV,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC,CAAC,CAAC,CAAA;IACnB,CAAC,CACF,CAAA;IAED,OAAO,MAA+B,CAAA;AACxC,CAAC"}

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

@@ -1,36 +0,0 @@
-import { WorkflowData } from "./type";
-/**
- * Configuration for retry behavior at the composition level.
- */
-export type RetryConfig = {
-    /**
-     * Maximum number of retry attempts.
-     */
-    maxRetries: number;
-    /**
-     * Interval between retries in seconds.
-     */
-    retryInterval?: number;
-    /**
-     * Whether to automatically retry on temporary failure. Defaults to true.
-     */
-    autoRetry?: boolean;
-};
-/**
- * Override retry configuration for a step at the composition site,
- * without modifying the step definition itself.
- *
- * Useful when the same step is used in multiple workflows with different retry requirements.
- *
- * @example
- * ```ts
- * import { retry } from "@acmekit/framework/workflows-sdk"
- *
- * const result = retry(sendEmailStep(input), {
- *   maxRetries: 3,
- *   retryInterval: 5,
- * })
- * ```
- */
-export declare function retry<TOutput>(stepResult: WorkflowData<TOutput>, config: RetryConfig): WorkflowData<TOutput>;
-//# sourceMappingURL=retry.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../src/utils/composer/retry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAErC;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAA;IAElB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB,CAAA;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAC3B,UAAU,EAAE,YAAY,CAAC,OAAO,CAAC,EACjC,MAAM,EAAE,WAAW,GAClB,YAAY,CAAC,OAAO,CAAC,CAMvB"}

package/dist/utils/composer/retry.js

@@ -1,27 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.retry = retry;
-/**
- * Override retry configuration for a step at the composition site,
- * without modifying the step definition itself.
- *
- * Useful when the same step is used in multiple workflows with different retry requirements.
- *
- * @example
- * ```ts
- * import { retry } from "@acmekit/framework/workflows-sdk"
- *
- * const result = retry(sendEmailStep(input), {
- *   maxRetries: 3,
- *   retryInterval: 5,
- * })
- * ```
- */
-function retry(stepResult, config) {
-    return stepResult.config({
-        maxRetries: config.maxRetries,
-        retryInterval: config.retryInterval,
-        autoRetry: config.autoRetry,
-    });
-}
-//# sourceMappingURL=retry.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../../src/utils/composer/retry.ts"],"names":[],"mappings":";;AAsCA,sBASC;AAzBD;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,KAAK,CACnB,UAAiC,EACjC,MAAmB;IAEnB,OAAO,UAAU,CAAC,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC,CAAA;AACJ,CAAC"}