@acmekit/workflows-sdk 2.13.1

package/dist/utils/composer/create-workflow.js

@@ -0,0 +1,230 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWorkflow = createWorkflow;
+const orchestration_1 = require("@acmekit/orchestration");
+const utils_1 = require("@acmekit/utils");
+const ulid_1 = require("ulid");
+const helper_1 = require("../../helper");
+const create_step_1 = require("./create-step");
+const proxy_1 = require("./helpers/proxy");
+const step_response_1 = require("./helpers/step-response");
+global[utils_1.OrchestrationUtils.SymbolAcmeKitWorkflowComposerContext] = null;
+const buildTransactionId = (step, stepContext) => {
+    return (step.__step__ +
+        "-" +
+        (stepContext.transactionId ?? (0, ulid_1.ulid)()) +
+        (stepContext.attempt > 1 ? `-attempt-${stepContext.attempt}` : ""));
+};
+/**
+ * This function creates a workflow with the provided name and a constructor function.
+ * The constructor function builds the workflow from steps created by the {@link createStep} function.
+ * The returned workflow is an exported workflow of type {@link ReturnWorkflow}, meaning it's not executed right away. To execute it,
+ * invoke the exported workflow, then run its `run` method.
+ *
+ * @typeParam TData - The type of the input passed to the composer function.
+ * @typeParam TResult - The type of the output returned by the composer function.
+ * @typeParam THooks - The type of hooks defined in the workflow.
+ *
+ * @returns The created workflow. You can later execute the workflow by invoking it, then using its `run` method.
+ *
+ * @example
+ * import {
+ *   createWorkflow,
+ *   WorkflowResponse
+ * } from "@acmekit/framework/workflows-sdk"
+ * import { AcmeKitRequest, AcmeKitResponse } from "@acmekit/framework/http"
+ * import {
+ *   createProductStep,
+ *   getProductStep,
+ * } from "./steps"
+ *
+ * interface WorkflowInput {
+ *  title: string
+ * }
+ *
+ * const myWorkflow = createWorkflow(
+ *   "my-workflow",
+ *   (input: WorkflowInput) => {
+ *    // Everything here will be executed and resolved later
+ *    // during the execution. Including the data access.
+ *
+ *     const product = createProductStep(input)
+ *     return new WorkflowResponse(getProductStep(product.id))
+ *   }
+ * )
+ *
+ * export async function GET(
+ *   req: AcmeKitRequest,
+ *   res: AcmeKitResponse
+ * ) {
+ *   const { result: product } = await myWorkflow(req.scope)
+ *     .run({
+ *       input: {
+ *         title: "Shirt"
+ *       }
+ *     })
+ *
+ *   res.json({
+ *     product
+ *   })
+ * }
+ */
+function createWorkflow(
+/**
+ * The name of the workflow or its configuration.
+ */
+nameOrConfig, 
+/**
+ * The constructor function that is executed when the `run` method in {@link ReturnWorkflow} is used.
+ * The function can't be an arrow function or an asynchronus function. It also can't directly manipulate data.
+ * You'll have to use the {@link transform} function if you need to directly manipulate data.
+ */
+composer) {
+    const fileSourcePath = (0, utils_1.getCallerFilePath)();
+    const name = (0, utils_1.isString)(nameOrConfig) ? nameOrConfig : nameOrConfig.name;
+    const options = (0, utils_1.isString)(nameOrConfig) ? {} : nameOrConfig;
+    (0, utils_1.registerDevServerResource)({
+        sourcePath: fileSourcePath,
+        id: name,
+        type: "workflow",
+    });
+    const handlers = new Map();
+    let newWorkflow = false;
+    if (!orchestration_1.WorkflowManager.getWorkflow(name)) {
+        newWorkflow = true;
+        orchestration_1.WorkflowManager.register(name, undefined, handlers, options);
+    }
+    const context = {
+        __type: utils_1.OrchestrationUtils.SymbolAcmeKitWorkflowComposerContext,
+        workflowId: name,
+        flow: orchestration_1.WorkflowManager.getEmptyTransactionDefinition(),
+        isAsync: false,
+        handlers,
+        overriddenHandler: new Map(),
+        hooks_: {
+            declared: [],
+            registered: [],
+        },
+        hooksCallback_: {},
+        stepConditions_: {},
+        hookBinder: (name, fn) => {
+            context.hooks_.declared.push(name);
+            context.hooksCallback_[name] = fn.bind(context)();
+        },
+        stepBinder: (fn) => {
+            return fn.bind(context)();
+        },
+        parallelizeBinder: (fn) => {
+            return fn.bind(context)();
+        },
+    };
+    global[utils_1.OrchestrationUtils.SymbolAcmeKitWorkflowComposerContext] = context;
+    const inputPlaceHolder = (0, proxy_1.proxify)({
+        __type: utils_1.OrchestrationUtils.SymbolInputReference,
+        __step__: "",
+        config: () => {
+            // TODO: config default value?
+            throw new Error("Config is not available for the input object.");
+        },
+    });
+    const returnedStep = composer.apply(context, [inputPlaceHolder]);
+    delete global[utils_1.OrchestrationUtils.SymbolAcmeKitWorkflowComposerContext];
+    if (newWorkflow) {
+        orchestration_1.WorkflowManager.update(name, context.flow, handlers, options);
+    }
+    else {
+        orchestration_1.WorkflowManager.register(name, context.flow, handlers, options);
+    }
+    const workflow = (0, helper_1.exportWorkflow)(name, returnedStep, {
+        wrappedInput: true,
+        sourcePath: fileSourcePath,
+    });
+    const mainFlow = (container) => {
+        const workflow_ = workflow(container);
+        const expandedFlow = workflow_;
+        expandedFlow.config = (config) => {
+            workflow_.setOptions(config);
+        };
+        return expandedFlow;
+    };
+    mainFlow.hooks = {};
+    for (const hook of context.hooks_.declared) {
+        mainFlow.hooks[hook] = context.hooksCallback_[hook].bind(context);
+    }
+    mainFlow.getName = () => name;
+    mainFlow.run = mainFlow().run;
+    mainFlow.runAsStep = ({ input, }) => {
+        // Get current workflow composition context
+        const workflowCompositionContext = global[utils_1.OrchestrationUtils.SymbolAcmeKitWorkflowComposerContext];
+        const runAsAsync = workflowCompositionContext.isAsync || context.isAsync;
+        const step = (0, create_step_1.createStep)({
+            name: `${name}-as-step`,
+            async: runAsAsync,
+            nested: runAsAsync, // if async we flag this is a nested transaction
+        }, async (stepInput, stepContext) => {
+            const { container, ...sharedContext } = stepContext;
+            const isAsync = stepContext[" stepDefinition"]?.async;
+            const workflowEngine = container.resolve(utils_1.Modules.WORKFLOW_ENGINE, {
+                allowUnregistered: true,
+            });
+            const executionContext = {
+                ...(sharedContext?.context ?? {}),
+                transactionId: buildTransactionId(step, stepContext),
+                parentStepIdempotencyKey: stepContext.idempotencyKey,
+                preventReleaseEvents: true,
+                runId: stepContext.runId,
+            };
+            let transaction;
+            if (workflowEngine && isAsync) {
+                transaction = await workflowEngine.run(name, {
+                    input: stepInput,
+                    transactionId: executionContext.transactionId,
+                    context: executionContext,
+                    throwOnError: false,
+                    logOnError: true,
+                });
+            }
+            else {
+                transaction = await workflow.run({
+                    input: stepInput,
+                    container,
+                    context: executionContext,
+                });
+            }
+            return new step_response_1.StepResponse(transaction.result, isAsync ? stepContext.transactionId : transaction);
+        }, async (transaction, stepContext) => {
+            // The step itself has failed, there is nothing to revert
+            const { container, ...sharedContext } = stepContext;
+            const isAsync = stepContext[" stepDefinition"]?.async;
+            const workflowEngine = container.resolve(utils_1.Modules.WORKFLOW_ENGINE, {
+                allowUnregistered: true,
+            });
+            const executionContext = {
+                ...(sharedContext?.context ?? {}),
+                transactionId: buildTransactionId(step, stepContext),
+                parentStepIdempotencyKey: stepContext.idempotencyKey,
+                preventReleaseEvents: true,
+                cancelingFromParentStep: true,
+            };
+            if (workflowEngine && isAsync) {
+                await workflowEngine.cancel(name, {
+                    transactionId: executionContext.transactionId,
+                    context: executionContext,
+                });
+            }
+            else {
+                await workflow(container).cancel({
+                    transaction: (transaction ?? {})
+                        ?.transaction,
+                    transactionId: executionContext.transactionId,
+                    container,
+                    context: executionContext,
+                });
+            }
+            return;
+        })(input);
+        return step;
+    };
+    return mainFlow;
+}
+//# sourceMappingURL=create-workflow.js.map

package/dist/utils/composer/create-workflow.js.map

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

package/dist/utils/composer/helpers/create-step-handler.d.ts

@@ -0,0 +1,20 @@
+import { WorkflowStepHandlerArguments } from "@acmekit/orchestration";
+import { ApplyStepOptions } from "../create-step";
+import { CreateWorkflowComposerContext, WorkflowData } from "../type";
+import { StepResponse } from "./step-response";
+export declare function createStepHandler<TInvokeInput, TStepInput extends {
+    [K in keyof TInvokeInput]: WorkflowData<TInvokeInput[K]>;
+}, TInvokeResultOutput, TInvokeResultCompensateInput>(this: CreateWorkflowComposerContext, { stepName, input, invokeFn, compensateFn, }: ApplyStepOptions<TStepInput, TInvokeInput, TInvokeResultOutput, TInvokeResultCompensateInput>): {
+    invoke: (stepArguments: WorkflowStepHandlerArguments) => Promise<{
+        __type: string;
+        output: StepResponse<any, any> | {
+            __type: string;
+            output: any;
+            compensateInput: any;
+        };
+    }>;
+    compensate: ((stepArguments: WorkflowStepHandlerArguments) => Promise<{
+        output: any;
+    }>) | undefined;
+};
+//# sourceMappingURL=create-step-handler.d.ts.map

package/dist/utils/composer/helpers/create-step-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-step-handler.d.ts","sourceRoot":"","sources":["../../../../src/utils/composer/helpers/create-step-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAA;AAErE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EACL,6BAA6B,EAE7B,YAAY,EACb,MAAM,SAAS,CAAA;AAEhB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AA6C9C,wBAAgB,iBAAiB,CAC/B,YAAY,EACZ,UAAU,SAAS;KAChB,CAAC,IAAI,MAAM,YAAY,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;CACzD,EACD,mBAAmB,EACnB,4BAA4B,EAE5B,IAAI,EAAE,6BAA6B,EACnC,EACE,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,YAAY,GACb,EAAE,gBAAgB,CACjB,UAAU,EACV,YAAY,EACZ,mBAAmB,EACnB,4BAA4B,CAC7B;4BAG+B,4BAA4B;;;;;;;;iCAqChC,4BAA4B;;;EAiCzD"}

package/dist/utils/composer/helpers/create-step-handler.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStepHandler = createStepHandler;
+const utils_1 = require("@acmekit/utils");
+const resolve_value_1 = require("./resolve-value");
+function buildStepContext({ action, stepArguments, }) {
+    const metadata = stepArguments.metadata;
+    const idempotencyKey = metadata.idempotency_key;
+    stepArguments.context.idempotencyKey = idempotencyKey;
+    const flow = stepArguments.transaction.getFlow();
+    const flowMetadata = flow?.metadata;
+    const stepDefinition = stepArguments.step.definition;
+    const executionContext = {
+        workflowId: metadata.model_id,
+        stepName: metadata.action,
+        action,
+        idempotencyKey,
+        attempt: metadata.attempt,
+        container: stepArguments.container,
+        metadata,
+        eventGroupId: flowMetadata?.eventGroupId ?? stepArguments.context.eventGroupId,
+        parentStepIdempotencyKey: flowMetadata?.parentStepIdempotencyKey,
+        preventReleaseEvents: flowMetadata?.preventReleaseEvents ?? false,
+        transactionId: stepArguments.context.transactionId,
+        runId: flow.runId,
+        context: stepArguments.context,
+        " stepDefinition": stepDefinition,
+        " getStepResult"(stepId, action = "invoke") {
+            return stepArguments[action][stepId]?.output?.output;
+        },
+    };
+    return executionContext;
+}
+function createStepHandler({ stepName, input, invokeFn, compensateFn, }) {
+    const handler = {
+        invoke: async (stepArguments) => {
+            const executionContext = buildStepContext({
+                action: "invoke",
+                stepArguments,
+            });
+            let argInput = {};
+            if (input) {
+                argInput = (0, resolve_value_1.resolveValue)(input, stepArguments);
+                if (argInput instanceof Promise) {
+                    argInput = await argInput;
+                }
+            }
+            const stepResponse = await invokeFn.apply(this, [
+                argInput,
+                executionContext,
+            ]);
+            if (!stepResponse || typeof stepResponse !== "object") {
+                return {
+                    __type: utils_1.OrchestrationUtils.SymbolWorkflowWorkflowData,
+                    output: stepResponse,
+                };
+            }
+            const stepResponseJSON = stepResponse.__type === utils_1.OrchestrationUtils.SymbolWorkflowStepResponse
+                ? stepResponse.toJSON()
+                : stepResponse;
+            return {
+                __type: utils_1.OrchestrationUtils.SymbolWorkflowWorkflowData,
+                output: stepResponseJSON,
+            };
+        },
+        compensate: compensateFn
+            ? async (stepArguments) => {
+                const executionContext = buildStepContext({
+                    action: "compensate",
+                    stepArguments,
+                });
+                const stepOutput = stepArguments.invoke[stepName]?.output;
+                if (!stepOutput) {
+                    const output = await compensateFn.apply(this, [
+                        stepOutput,
+                        executionContext,
+                    ]);
+                    return { output };
+                }
+                const invokeResult = stepOutput.__type === utils_1.OrchestrationUtils.SymbolWorkflowStepResponse
+                    ? stepOutput.compensateInput
+                    : stepOutput;
+                const output = await compensateFn.apply(this, [
+                    invokeResult,
+                    executionContext,
+                ]);
+                return {
+                    output,
+                };
+            }
+            : undefined,
+    };
+    return handler;
+}
+//# sourceMappingURL=create-step-handler.js.map

package/dist/utils/composer/helpers/create-step-handler.js.map

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

package/dist/utils/composer/helpers/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./step-response";
+export * from "./resolve-value";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/composer/helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/composer/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA"}

package/dist/utils/composer/helpers/index.js

@@ -0,0 +1,19 @@
+"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("./step-response"), exports);
+__exportStar(require("./resolve-value"), exports);
+//# sourceMappingURL=index.js.map

package/dist/utils/composer/helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/utils/composer/helpers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAA+B;AAC/B,kDAA+B"}

package/dist/utils/composer/helpers/proxy.d.ts

@@ -0,0 +1,3 @@
+import { WorkflowData } from "../type";
+export declare function proxify<T>(obj: WorkflowData<any>): T;
+//# sourceMappingURL=proxy.d.ts.map

package/dist/utils/composer/helpers/proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../../../src/utils/composer/helpers/proxy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAEtC,wBAAgB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAcpD"}

package/dist/utils/composer/helpers/proxy.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.proxify = proxify;
+const transform_1 = require("../transform");
+function proxify(obj) {
+    return new Proxy(obj, {
+        get(target, prop) {
+            if (prop in target) {
+                return target[prop];
+            }
+            const transformer = (0, transform_1.transform)({ target }, function (data) {
+                return data.target?.[prop];
+            });
+            return transformer;
+        },
+    });
+}
+//# sourceMappingURL=proxy.js.map

package/dist/utils/composer/helpers/proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.js","sourceRoot":"","sources":["../../../../src/utils/composer/helpers/proxy.ts"],"names":[],"mappings":";;AAGA,0BAcC;AAjBD,4CAAwC;AAGxC,SAAgB,OAAO,CAAI,GAAsB;IAC/C,OAAO,IAAI,KAAK,CAAC,GAAG,EAAE;QACpB,GAAG,CAAC,MAAW,EAAE,IAAqB;YACpC,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;gBACnB,OAAO,MAAM,CAAC,IAAI,CAAC,CAAA;YACrB,CAAC;YAED,MAAM,WAAW,GAAG,IAAA,qBAAS,EAAC,EAAE,MAAM,EAAE,EAAE,UAAU,IAAI;gBACtD,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAA;YAC5B,CAAC,CAAC,CAAA;YAEF,OAAO,WAAW,CAAA;QACpB,CAAC;KACF,CAAiB,CAAA;AACpB,CAAC"}

package/dist/utils/composer/helpers/resolve-value.d.ts

@@ -0,0 +1,8 @@
+type InputPrimitive = string | Symbol;
+type InputObject = object & {
+    __type?: string | Symbol;
+    output?: any;
+};
+export declare function resolveValue(input: InputPrimitive | InputObject | unknown | undefined, transactionContext: any): Promise<any> | any;
+export {};
+//# sourceMappingURL=resolve-value.d.ts.map

package/dist/utils/composer/helpers/resolve-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-value.d.ts","sourceRoot":"","sources":["../../../../src/utils/composer/helpers/resolve-value.ts"],"names":[],"mappings":"AAQA,KAAK,cAAc,GAAG,MAAM,GAAG,MAAM,CAAA;AACrC,KAAK,WAAW,GAAG,MAAM,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,GAAG,CAAA;CAAE,CAAA;AA8KtE,wBAAgB,YAAY,CAC1B,KAAK,EAAE,cAAc,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,EACzD,kBAAkB,EAAE,GAAG,GACtB,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CA8BpB"}

package/dist/utils/composer/helpers/resolve-value.js

@@ -0,0 +1,211 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveValue = resolveValue;
+const utils_1 = require("@acmekit/utils");
+const util = __importStar(require("node:util"));
+function resolveProperty(property, transactionContext) {
+    const { invoke: invokeRes } = transactionContext;
+    let res;
+    if (property.__type === utils_1.OrchestrationUtils.SymbolInputReference) {
+        res = transactionContext.payload;
+    }
+    else if (property.__type === utils_1.OrchestrationUtils.SymbolAcmeKitWorkflowResponse) {
+        res = resolveValue(property.$result, transactionContext);
+    }
+    else if (property.__type === utils_1.OrchestrationUtils.SymbolWorkflowStepTransformer) {
+        res = property.__resolver(transactionContext);
+    }
+    else if (property.__type === utils_1.OrchestrationUtils.SymbolWorkflowStep) {
+        const output = invokeRes[property.__step__]?.output ?? invokeRes[property.__step__];
+        if (output?.__type === utils_1.OrchestrationUtils.SymbolWorkflowStepResponse) {
+            res = output.output;
+        }
+        else {
+            res = output;
+        }
+    }
+    else if (property.__type === utils_1.OrchestrationUtils.SymbolWorkflowStepResponse) {
+        res = property.output;
+    }
+    else {
+        res = property;
+    }
+    return res;
+}
+function unwrapInput({ inputTOUnwrap, parentRef, transactionContext, }) {
+    if (inputTOUnwrap == null) {
+        return inputTOUnwrap;
+    }
+    if (Array.isArray(inputTOUnwrap)) {
+        const promises = [];
+        const resolvedItems = new Array(inputTOUnwrap.length);
+        for (let i = 0; i < inputTOUnwrap.length; i++) {
+            const item = inputTOUnwrap[i];
+            if (item == null || typeof item !== "object") {
+                resolvedItems[i] = item;
+            }
+            else {
+                const resolved = resolveValue(item, transactionContext);
+                if (resolved instanceof Promise) {
+                    promises.push({ promise: resolved, index: i });
+                }
+                else {
+                    resolvedItems[i] = resolved;
+                }
+            }
+        }
+        if (promises.length > 0) {
+            return (0, utils_1.promiseAll)(promises.map((p) => p.promise)).then((resolvedPromises) => {
+                for (let i = 0; i < promises.length; i++) {
+                    resolvedItems[promises[i].index] = resolvedPromises[i];
+                }
+                return resolvedItems;
+            });
+        }
+        return resolvedItems;
+    }
+    if (util.types.isProxy(inputTOUnwrap)) {
+        const resolved = resolveProperty(inputTOUnwrap, transactionContext);
+        if (resolved instanceof Promise) {
+            return resolved.then((r) => {
+                inputTOUnwrap = r;
+                if (!(0, utils_1.isObject)(inputTOUnwrap)) {
+                    return inputTOUnwrap;
+                }
+                return unwrapInput({
+                    inputTOUnwrap,
+                    parentRef: {},
+                    transactionContext,
+                });
+            });
+        }
+        inputTOUnwrap = resolved;
+    }
+    if (!(0, utils_1.isObject)(inputTOUnwrap)) {
+        return inputTOUnwrap;
+    }
+    const keys = Object.keys(inputTOUnwrap);
+    const promises = [];
+    for (let i = 0; i < keys.length; i++) {
+        const key = keys[i];
+        if (inputTOUnwrap[key] == null || typeof inputTOUnwrap[key] !== "object") {
+            parentRef[key] = inputTOUnwrap[key];
+            continue;
+        }
+        const result = resolveProperty(inputTOUnwrap[key], transactionContext);
+        if (result instanceof Promise) {
+            promises.push({ promise: result, keyIndex: i });
+        }
+        else {
+            parentRef[key] = result;
+            if (result != null && typeof result === "object") {
+                const unwrapped = unwrapInput({
+                    inputTOUnwrap: result,
+                    parentRef: {},
+                    transactionContext,
+                });
+                if (unwrapped instanceof Promise) {
+                    promises.push({
+                        promise: unwrapped.then((r) => ({ key, value: r })),
+                        keyIndex: i,
+                    });
+                }
+                else {
+                    parentRef[key] = unwrapped;
+                }
+            }
+        }
+    }
+    if (promises.length > 0) {
+        return (0, utils_1.promiseAll)(promises.map((p) => p.promise)).then((resolvedPromises) => {
+            for (let i = 0; i < promises.length; i++) {
+                const resolved = resolvedPromises[i];
+                if (resolved && typeof resolved === "object" && "key" in resolved) {
+                    parentRef[resolved.key] = resolved.value;
+                }
+                else {
+                    const key = keys[promises[i].keyIndex];
+                    parentRef[key] = resolved;
+                    if (resolved != null && typeof resolved === "object") {
+                        const unwrapped = unwrapInput({
+                            inputTOUnwrap: resolved,
+                            parentRef: {},
+                            transactionContext,
+                        });
+                        if (unwrapped instanceof Promise) {
+                            return unwrapped.then((r) => {
+                                parentRef[key] = r;
+                                return parentRef;
+                            });
+                        }
+                        parentRef[key] = unwrapped;
+                    }
+                }
+            }
+            return parentRef;
+        });
+    }
+    return parentRef;
+}
+function resolveValue(input, transactionContext) {
+    if (input == null || typeof input !== "object") {
+        return input;
+    }
+    const input_ = input?.__type ===
+        utils_1.OrchestrationUtils.SymbolWorkflowWorkflowData
+        ? input.output
+        : input;
+    let result;
+    if (input_?.__type) {
+        result = resolveProperty(input_, transactionContext);
+        if (result instanceof Promise) {
+            return result.then((r) => (0, utils_1.parseStringifyIfNecessary)(r));
+        }
+        return (0, utils_1.parseStringifyIfNecessary)(result);
+    }
+    else {
+        result = unwrapInput({
+            inputTOUnwrap: input_,
+            parentRef: {},
+            transactionContext,
+        });
+        if (result instanceof Promise) {
+            return result.then((r) => (0, utils_1.parseStringifyIfNecessary)(r));
+        }
+        return (0, utils_1.parseStringifyIfNecessary)(result);
+    }
+}
+//# sourceMappingURL=resolve-value.js.map