@acmekit/core-flows 2.13.1

package/dist/order/workflows/exchange/cancel-exchange.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cancelOrderExchangeWorkflow = exports.cancelOrderExchangeWorkflowId = exports.cancelExchangeValidateOrder = void 0;
+const utils_1 = require("@acmekit/framework/utils");
+const workflows_sdk_1 = require("@acmekit/framework/workflows-sdk");
+const common_1 = require("../../../common");
+const delete_reservations_by_line_items_1 = require("../../../reservation/steps/delete-reservations-by-line-items");
+const steps_1 = require("../../steps");
+const order_validation_1 = require("../../utils/order-validation");
+const cancel_return_1 = require("../return/cancel-return");
+/**
+ * This step validates that an exchange can be canceled.
+ * If the exchange is canceled, or any of the fulfillments are not canceled, the step will throw an error.
+ *
+ * :::note
+ *
+ * You can retrieve an order exchange's details using [Query](https://docs.acmekit.com/learn/fundamentals/module-links/query),
+ * or [useQueryGraphStep](https://docs.acmekit.com/resources/references/acmekit-workflows/steps/useQueryGraphStep).
+ *
+ * :::
+ *
+ * @example
+ * const data = cancelExchangeValidateOrder({
+ *   orderExchange: {
+ *     id: "exchange_123",
+ *     // other order exchange details...
+ *   },
+ *   input: {
+ *     exchange_id: "exchange_123",
+ *   }
+ * })
+ */
+exports.cancelExchangeValidateOrder = (0, workflows_sdk_1.createStep)("validate-exchange", ({ orderExchange, orderReturn }) => {
+    const orderReturn_ = orderReturn;
+    (0, order_validation_1.throwIfIsCancelled)(orderExchange, "Exchange");
+    const throwErrorIf = (arr, pred, message) => {
+        if (arr?.some(pred)) {
+            throw new utils_1.AcmeKitError(utils_1.AcmeKitError.Types.NOT_ALLOWED, message);
+        }
+    };
+    const notCanceled = (o) => !o.canceled_at;
+    throwErrorIf(orderReturn_.fulfillments, notCanceled, "All fulfillments must be canceled before canceling am exchange");
+});
+exports.cancelOrderExchangeWorkflowId = "cancel-exchange";
+/**
+ * This workflow cancels a confirmed exchange. It's used by the
+ * [Cancel Exchange Admin API Route](https://docs.acmekit.com/api/admin#exchanges_postexchangesidcancel).
+ *
+ * You can use this workflow within your customizations or your own custom workflows, allowing you to cancel an exchange
+ * for an order in your custom flow.
+ *
+ * @example
+ * const { result } = await cancelOrderExchangeWorkflow(container)
+ * .run({
+ *   input: {
+ *     exchange_id: "exchange_123",
+ *   }
+ * })
+ *
+ * @summary
+ *
+ * Cancel an exchange for an order.
+ */
+exports.cancelOrderExchangeWorkflow = (0, workflows_sdk_1.createWorkflow)(exports.cancelOrderExchangeWorkflowId, (input) => {
+    const orderExchange = (0, common_1.useRemoteQueryStep)({
+        entry_point: "order_exchange",
+        fields: [
+            "id",
+            "order_id",
+            "return_id",
+            "canceled_at",
+            "additional_items.item_id",
+        ],
+        variables: { id: input.exchange_id },
+        list: false,
+        throw_if_key_not_found: true,
+    });
+    const orderReturn = (0, common_1.useRemoteQueryStep)({
+        entry_point: "return",
+        fields: ["id", "fulfillments.canceled_at"],
+        variables: { id: orderExchange.return_id },
+        list: false,
+    }).config({ name: "return-query" });
+    (0, exports.cancelExchangeValidateOrder)({ orderExchange, orderReturn, input });
+    const lineItemIds = (0, workflows_sdk_1.transform)({ orderExchange }, ({ orderExchange }) => {
+        return orderExchange.additional_items?.map((i) => i.item_id);
+    });
+    (0, workflows_sdk_1.parallelize)((0, steps_1.cancelOrderExchangeStep)({
+        exchange_id: orderExchange.id,
+        order_id: orderExchange.order_id,
+        canceled_by: input.canceled_by,
+    }), (0, delete_reservations_by_line_items_1.deleteReservationsByLineItemsStep)(lineItemIds));
+    (0, workflows_sdk_1.when)({ orderExchange }, ({ orderExchange }) => {
+        return !!orderExchange.return_id;
+    }).then(() => {
+        cancel_return_1.cancelReturnWorkflow.runAsStep({
+            input: {
+                return_id: orderExchange.return_id,
+                no_notification: input.no_notification,
+            },
+        });
+    });
+});
+//# sourceMappingURL=cancel-exchange.js.map

package/dist/order/workflows/exchange/cancel-exchange.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel-exchange.js","sourceRoot":"","sources":["../../../../src/order/workflows/exchange/cancel-exchange.ts"],"names":[],"mappings":";;;AAMA,oDAAuD;AACvD,oEAOyC;AACzC,4CAAoD;AACpD,oHAAgH;AAChH,uCAAqD;AACrD,mEAAiE;AACjE,2DAA8D;AAoB9D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACU,QAAA,2BAA2B,GAAG,IAAA,0BAAU,EACnD,mBAAmB,EACnB,CAAC,EAAE,aAAa,EAAE,WAAW,EAAwC,EAAE,EAAE;IACvE,MAAM,YAAY,GAAG,WAEpB,CAAA;IAED,IAAA,qCAAkB,EAAC,aAAa,EAAE,UAAU,CAAC,CAAA;IAE7C,MAAM,YAAY,GAAG,CACnB,GAAc,EACd,IAA2B,EAC3B,OAAe,EACf,EAAE;QACF,IAAI,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,oBAAY,CAAC,oBAAY,CAAC,KAAK,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA;QACjE,CAAC;IACH,CAAC,CAAA;IAED,MAAM,WAAW,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAA;IAEzC,YAAY,CACV,YAAY,CAAC,YAAY,EACzB,WAAW,EACX,gEAAgE,CACjE,CAAA;AACH,CAAC,CACF,CAAA;AAEY,QAAA,6BAA6B,GAAG,iBAAiB,CAAA;AAC9D;;;;;;;;;;;;;;;;;;GAkBG;AACU,QAAA,2BAA2B,GAAG,IAAA,8BAAc,EACvD,qCAA6B,EAC7B,CACE,KAAmE,EAC/C,EAAE;IACtB,MAAM,aAAa,GACjB,IAAA,2BAAkB,EAAC;QACjB,WAAW,EAAE,gBAAgB;QAC7B,MAAM,EAAE;YACN,IAAI;YACJ,UAAU;YACV,WAAW;YACX,aAAa;YACb,0BAA0B;SAC3B;QACD,SAAS,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,WAAW,EAAE;QACpC,IAAI,EAAE,KAAK;QACX,sBAAsB,EAAE,IAAI;KAC7B,CAAC,CAAA;IAEJ,MAAM,WAAW,GACf,IAAA,2BAAkB,EAAC;QACjB,WAAW,EAAE,QAAQ;QACrB,MAAM,EAAE,CAAC,IAAI,EAAE,0BAA0B,CAAC;QAC1C,SAAS,EAAE,EAAE,EAAE,EAAE,aAAa,CAAC,SAAS,EAAE;QAC1C,IAAI,EAAE,KAAK;KACZ,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAA;IAErC,IAAA,mCAA2B,EAAC,EAAE,aAAa,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAA;IAElE,MAAM,WAAW,GAAG,IAAA,yBAAS,EAAC,EAAE,aAAa,EAAE,EAAE,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE;QACrE,OAAO,aAAa,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;IAC9D,CAAC,CAAC,CAAA;IAEF,IAAA,2BAAW,EACT,IAAA,+BAAuB,EAAC;QACtB,WAAW,EAAE,aAAa,CAAC,EAAE;QAC7B,QAAQ,EAAE,aAAa,CAAC,QAAQ;QAChC,WAAW,EAAE,KAAK,CAAC,WAAW;KAC/B,CAAC,EACF,IAAA,qEAAiC,EAAC,WAAW,CAAC,CAC/C,CAAA;IAED,IAAA,oBAAI,EAAC,EAAE,aAAa,EAAE,EAAE,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE;QAC5C,OAAO,CAAC,CAAC,aAAa,CAAC,SAAS,CAAA;IAClC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;QACX,oCAAoB,CAAC,SAAS,CAAC;YAC7B,KAAK,EAAE;gBACL,SAAS,EAAE,aAAa,CAAC,SAAU;gBACnC,eAAe,EAAE,KAAK,CAAC,eAAe;aACvC;SACF,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CACF,CAAA"}

package/dist/order/workflows/exchange/confirm-exchange-request.d.ts

@@ -0,0 +1,81 @@
+import { OrderChangeDTO, OrderDTO, OrderExchangeDTO, OrderPreviewDTO } from "@acmekit/framework/types";
+/**
+ * The data to validate that a requested exchange can be confirmed.
+ */
+export type ConfirmExchangeRequestValidationStepInput = {
+    /**
+     * The order's details.
+     */
+    order: OrderDTO;
+    /**
+     * The order exchange's details.
+     */
+    orderExchange: OrderExchangeDTO;
+    /**
+     * The order change's details.
+     */
+    orderChange: OrderChangeDTO;
+};
+/**
+ * This step validates that a requested exchange can be confirmed.
+ * If the order or exchange is canceled, or the order change is not active, the step will throw an error.
+ *
+ * :::note
+ *
+ * You can retrieve an order, order exchange, and order change details using [Query](https://docs.acmekit.com/learn/fundamentals/module-links/query),
+ * or [useQueryGraphStep](https://docs.acmekit.com/resources/references/acmekit-workflows/steps/useQueryGraphStep).
+ *
+ * :::
+ *
+ * @example
+ * const data = confirmExchangeRequestValidationStep({
+ *   order: {
+ *     id: "order_123",
+ *     // other order details...
+ *   },
+ *   orderChange: {
+ *     id: "orch_123",
+ *     // other order change details...
+ *   },
+ *   orderExchange: {
+ *     id: "exchange_123",
+ *     // other order exchange details...
+ *   },
+ * })
+ */
+export declare const confirmExchangeRequestValidationStep: import("@acmekit/framework/workflows-sdk").StepFunction<ConfirmExchangeRequestValidationStepInput, unknown>;
+/**
+ * The details to confirm an exchange request.
+ */
+export type ConfirmExchangeRequestWorkflowInput = {
+    /**
+     * The ID of the exchange to confirm.
+     */
+    exchange_id: string;
+    /**
+     * The ID of the user that's confirming the exchange.
+     */
+    confirmed_by?: string;
+};
+export declare const confirmExchangeRequestWorkflowId = "confirm-exchange-request";
+/**
+ * This workflow confirms an exchange request. It's used by the
+ * [Confirm Exchange Admin API Route](https://docs.acmekit.com/api/admin#exchanges_postexchangesidrequest).
+ *
+ * You can use this workflow within your customizations or your own custom workflows, allowing you to confirm an exchange
+ * for an order in your custom flow.
+ *
+ * @example
+ * const { result } = await confirmExchangeRequestWorkflow(container)
+ * .run({
+ *   input: {
+ *     exchange_id: "exchange_123",
+ *   }
+ * })
+ *
+ * @summary
+ *
+ * Confirm an exchange request.
+ */
+export declare const confirmExchangeRequestWorkflow: import("@acmekit/framework/workflows-sdk").ReturnWorkflow<ConfirmExchangeRequestWorkflowInput, OrderPreviewDTO, []>;
+//# sourceMappingURL=confirm-exchange-request.d.ts.map

package/dist/order/workflows/exchange/confirm-exchange-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirm-exchange-request.d.ts","sourceRoot":"","sources":["../../../../src/order/workflows/exchange/confirm-exchange-request.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,cAAc,EACd,QAAQ,EACR,gBAAgB,EAEhB,eAAe,EAEhB,MAAM,0BAA0B,CAAA;AAmCjC;;GAEG;AACH,MAAM,MAAM,yCAAyC,GAAG;IACtD;;OAEG;IACH,KAAK,EAAE,QAAQ,CAAA;IACf;;OAEG;IACH,aAAa,EAAE,gBAAgB,CAAA;IAC/B;;OAEG;IACH,WAAW,EAAE,cAAc,CAAA;CAC5B,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,oCAAoC,6GAWhD,CAAA;AAsJD;;GAEG;AACH,MAAM,MAAM,mCAAmC,GAAG;IAChD;;OAEG;IACH,WAAW,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,eAAO,MAAM,gCAAgC,6BAA6B,CAAA;AAC1E;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,8BAA8B,qHA6N1C,CAAA"}

package/dist/order/workflows/exchange/confirm-exchange-request.js

@@ -0,0 +1,335 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.confirmExchangeRequestWorkflow = exports.confirmExchangeRequestWorkflowId = exports.confirmExchangeRequestValidationStep = void 0;
+const utils_1 = require("@acmekit/framework/utils");
+const workflows_sdk_1 = require("@acmekit/framework/workflows-sdk");
+const reserve_inventory_1 = require("../../../cart/steps/reserve-inventory");
+const prepare_confirm_inventory_input_1 = require("../../../cart/utils/prepare-confirm-inventory-input");
+const common_1 = require("../../../common");
+const create_return_fulfillment_1 = require("../../../fulfillment/workflows/create-return-fulfillment");
+const steps_1 = require("../../steps");
+const confirm_order_changes_1 = require("../../steps/confirm-order-changes");
+const create_exchange_items_from_actions_1 = require("../../steps/exchange/create-exchange-items-from-actions");
+const create_return_items_from_actions_1 = require("../../steps/return/create-return-items-from-actions");
+const order_validation_1 = require("../../utils/order-validation");
+const create_or_update_order_payment_collection_1 = require("../create-or-update-order-payment-collection");
+/**
+ * This step validates that a requested exchange can be confirmed.
+ * If the order or exchange is canceled, or the order change is not active, the step will throw an error.
+ *
+ * :::note
+ *
+ * You can retrieve an order, order exchange, and order change details using [Query](https://docs.acmekit.com/learn/fundamentals/module-links/query),
+ * or [useQueryGraphStep](https://docs.acmekit.com/resources/references/acmekit-workflows/steps/useQueryGraphStep).
+ *
+ * :::
+ *
+ * @example
+ * const data = confirmExchangeRequestValidationStep({
+ *   order: {
+ *     id: "order_123",
+ *     // other order details...
+ *   },
+ *   orderChange: {
+ *     id: "orch_123",
+ *     // other order change details...
+ *   },
+ *   orderExchange: {
+ *     id: "exchange_123",
+ *     // other order exchange details...
+ *   },
+ * })
+ */
+exports.confirmExchangeRequestValidationStep = (0, workflows_sdk_1.createStep)("validate-confirm-exchange-request", async function ({ order, orderChange, orderExchange, }) {
+    (0, order_validation_1.throwIfIsCancelled)(order, "Order");
+    (0, order_validation_1.throwIfIsCancelled)(orderExchange, "Exchange");
+    (0, order_validation_1.throwIfOrderChangeIsNotActive)({ orderChange });
+});
+/**
+ * This step confirms that a requested exchange has at least one item to return or send
+ */
+const confirmIfExchangeItemsArePresent = (0, workflows_sdk_1.createStep)("confirm-if-exchange-items-are-present", async function ({ exchangeItems, returnItems, }) {
+    if (exchangeItems.length > 0 && (returnItems || []).length > 0) {
+        return;
+    }
+    throw new utils_1.AcmeKitError(utils_1.AcmeKitError.Types.INVALID_DATA, `Order exchange request should have at least 1 item inbound and 1 item outbound`);
+});
+function prepareFulfillmentData({ order, items, shippingOption, deliveryAddress, }) {
+    const orderItemsMap = new Map(order.items.map((i) => [i.id, i]));
+    const fulfillmentItems = items.map((i) => {
+        const orderItem = orderItemsMap.get(i.id) ?? i.item;
+        return {
+            line_item_id: i.item_id,
+            quantity: i.quantity,
+            title: orderItem.variant_title ?? orderItem.title,
+            sku: orderItem.variant_sku || "",
+            barcode: orderItem.variant_barcode || "",
+        };
+    });
+    const locationId = shippingOption.service_zone.fulfillment_set.location?.id;
+    // delivery address is the stock location address
+    const address = deliveryAddress ??
+        shippingOption.service_zone.fulfillment_set.location?.address ??
+        {};
+    delete address.id;
+    return {
+        input: {
+            location_id: locationId,
+            provider_id: shippingOption.provider_id,
+            shipping_option_id: shippingOption.id,
+            items: fulfillmentItems,
+            delivery_address: address,
+            order: order,
+        },
+    };
+}
+function transformActionsToItems({ orderChange }) {
+    const exchangeItems = [];
+    const returnItems = [];
+    const actions = orderChange.actions ?? [];
+    actions.forEach((item) => {
+        if (item.action === utils_1.ChangeActionType.RETURN_ITEM) {
+            returnItems.push(item);
+        }
+        else if (item.action === utils_1.ChangeActionType.ITEM_ADD) {
+            exchangeItems.push(item);
+        }
+    });
+    return {
+        exchangeItems: {
+            changes: exchangeItems,
+            exchangeId: exchangeItems?.[0]?.exchange_id,
+        },
+        returnItems: {
+            changes: returnItems,
+            returnId: returnItems?.[0]?.return_id,
+        },
+    };
+}
+function extractShippingOption({ orderPreview, orderExchange, returnId }) {
+    if (!orderPreview.shipping_methods?.length) {
+        return;
+    }
+    let returnShippingMethod;
+    let exchangeShippingMethod;
+    for (const shippingMethod of orderPreview.shipping_methods) {
+        const modifiedShippingMethod_ = shippingMethod;
+        if (!modifiedShippingMethod_.actions) {
+            continue;
+        }
+        for (const action of modifiedShippingMethod_.actions) {
+            if (action.action === utils_1.ChangeActionType.SHIPPING_ADD) {
+                if (action.return_id === returnId) {
+                    returnShippingMethod = shippingMethod;
+                }
+                else if (action.exchange_id === orderExchange.id) {
+                    exchangeShippingMethod = shippingMethod;
+                }
+            }
+        }
+    }
+    return {
+        returnShippingMethod,
+        exchangeShippingMethod,
+    };
+}
+function getUpdateReturnData({ returnId }) {
+    return (0, workflows_sdk_1.transform)({ returnId }, ({ returnId }) => {
+        return [
+            {
+                id: returnId,
+                status: utils_1.ReturnStatus.REQUESTED,
+                requested_at: new Date(),
+            },
+        ];
+    });
+}
+exports.confirmExchangeRequestWorkflowId = "confirm-exchange-request";
+/**
+ * This workflow confirms an exchange request. It's used by the
+ * [Confirm Exchange Admin API Route](https://docs.acmekit.com/api/admin#exchanges_postexchangesidrequest).
+ *
+ * You can use this workflow within your customizations or your own custom workflows, allowing you to confirm an exchange
+ * for an order in your custom flow.
+ *
+ * @example
+ * const { result } = await confirmExchangeRequestWorkflow(container)
+ * .run({
+ *   input: {
+ *     exchange_id: "exchange_123",
+ *   }
+ * })
+ *
+ * @summary
+ *
+ * Confirm an exchange request.
+ */
+exports.confirmExchangeRequestWorkflow = (0, workflows_sdk_1.createWorkflow)(exports.confirmExchangeRequestWorkflowId, function (input) {
+    const orderExchange = (0, common_1.useRemoteQueryStep)({
+        entry_point: "order_exchange",
+        fields: ["id", "status", "order_id", "canceled_at"],
+        variables: { id: input.exchange_id },
+        list: false,
+        throw_if_key_not_found: true,
+    });
+    const order = (0, common_1.useRemoteQueryStep)({
+        entry_point: "orders",
+        fields: [
+            "id",
+            "version",
+            "canceled_at",
+            "items.*",
+            "items.item.id",
+            "shipping_address.*",
+        ],
+        variables: { id: orderExchange.order_id },
+        list: false,
+        throw_if_key_not_found: true,
+    }).config({ name: "order-query" });
+    const orderChange = (0, common_1.useRemoteQueryStep)({
+        entry_point: "order_change",
+        fields: [
+            "id",
+            "status",
+            "actions.id",
+            "actions.exchange_id",
+            "actions.return_id",
+            "actions.action",
+            "actions.details",
+            "actions.reference",
+            "actions.reference_id",
+            "actions.internal_note",
+        ],
+        variables: {
+            filters: {
+                order_id: orderExchange.order_id,
+                exchange_id: orderExchange.id,
+                status: [utils_1.OrderChangeStatus.PENDING, utils_1.OrderChangeStatus.REQUESTED],
+            },
+        },
+        list: false,
+    }).config({ name: "order-change-query" });
+    (0, exports.confirmExchangeRequestValidationStep)({ order, orderExchange, orderChange });
+    const { exchangeItems, returnItems } = (0, workflows_sdk_1.transform)({ orderChange }, transformActionsToItems);
+    const orderPreview = (0, steps_1.previewOrderChangeStep)(order.id);
+    const [createdExchangeItems, createdReturnItems] = (0, workflows_sdk_1.parallelize)((0, create_exchange_items_from_actions_1.createOrderExchangeItemsFromActionsStep)(exchangeItems), (0, create_return_items_from_actions_1.createReturnItemsFromActionsStep)(returnItems));
+    confirmIfExchangeItemsArePresent({
+        exchangeItems: createdExchangeItems,
+        returnItems: createdReturnItems,
+    });
+    (0, confirm_order_changes_1.confirmOrderChanges)({
+        changes: [orderChange],
+        orderId: order.id,
+        confirmed_by: input.confirmed_by,
+    });
+    const returnId = (0, workflows_sdk_1.transform)({ createdReturnItems }, ({ createdReturnItems }) => {
+        return createdReturnItems?.[0]?.return_id;
+    });
+    (0, workflows_sdk_1.when)({ returnId }, ({ returnId }) => {
+        return !!returnId;
+    }).then(() => {
+        const updateReturnData = getUpdateReturnData({ returnId });
+        (0, steps_1.updateReturnsStep)(updateReturnData);
+    });
+    const { returnShippingMethod, exchangeShippingMethod } = (0, workflows_sdk_1.transform)({ orderPreview, orderExchange, returnId }, extractShippingOption);
+    (0, workflows_sdk_1.when)({ exchangeShippingMethod }, ({ exchangeShippingMethod }) => {
+        return !!exchangeShippingMethod;
+    }).then(() => {
+        const exchange = (0, common_1.useRemoteQueryStep)({
+            entry_point: "order_exchange",
+            fields: [
+                "id",
+                "version",
+                "canceled_at",
+                "order.sales_channel_id",
+                "additional_items.quantity",
+                "additional_items.raw_quantity",
+                "additional_items.item.id",
+                "additional_items.item.variant.manage_inventory",
+                "additional_items.item.variant.allow_backorder",
+                "additional_items.item.variant.inventory_items.inventory_item_id",
+                "additional_items.item.variant.inventory_items.required_quantity",
+                "additional_items.item.variant.inventory_items.inventory.location_levels.stock_locations.id",
+                "additional_items.item.variant.inventory_items.inventory.location_levels.stock_locations.name",
+                "additional_items.item.variant.inventory_items.inventory.location_levels.stock_locations.sales_channels.id",
+                "additional_items.item.variant.inventory_items.inventory.location_levels.stock_locations.sales_channels.name",
+            ],
+            variables: { id: input.exchange_id },
+            list: false,
+            throw_if_key_not_found: true,
+        }).config({ name: "exchange-query" });
+        const { variants, items } = (0, workflows_sdk_1.transform)({ exchange }, ({ exchange }) => {
+            const allItems = [];
+            const allVariants = [];
+            exchange.additional_items.forEach((exchangeItem) => {
+                const item = exchangeItem.item;
+                allItems.push({
+                    id: item.id,
+                    variant_id: item.variant_id,
+                    quantity: exchangeItem.raw_quantity ?? exchangeItem.quantity,
+                });
+                allVariants.push(item.variant);
+            });
+            return {
+                variants: allVariants,
+                items: allItems,
+            };
+        });
+        const formatedInventoryItems = (0, workflows_sdk_1.transform)({
+            input: {
+                sales_channel_id: exchange.order.sales_channel_id,
+                variants,
+                items,
+            },
+        }, prepare_confirm_inventory_input_1.prepareConfirmInventoryInput);
+        (0, reserve_inventory_1.reserveInventoryStep)(formatedInventoryItems);
+    });
+    (0, workflows_sdk_1.when)({ returnShippingMethod, returnId }, ({ returnShippingMethod, returnId }) => {
+        return !!returnShippingMethod && !!returnId;
+    }).then(() => {
+        const returnShippingOption = (0, common_1.useRemoteQueryStep)({
+            entry_point: "shipping_options",
+            fields: [
+                "id",
+                "provider_id",
+                "service_zone.fulfillment_set.location.id",
+                "service_zone.fulfillment_set.location.address.*",
+            ],
+            variables: {
+                id: returnShippingMethod.shipping_option_id,
+            },
+            list: false,
+        }).config({ name: "exchange-return-shipping-option" });
+        const fulfillmentData = (0, workflows_sdk_1.transform)({
+            order,
+            items: order.items,
+            shippingOption: returnShippingOption,
+        }, prepareFulfillmentData);
+        const returnFulfillment = create_return_fulfillment_1.createReturnFulfillmentWorkflow.runAsStep(fulfillmentData);
+        const returnLink = (0, workflows_sdk_1.transform)({ returnId, fulfillment: returnFulfillment }, (data) => {
+            return [
+                {
+                    [utils_1.Modules.ORDER]: { return_id: data.returnId },
+                    [utils_1.Modules.FULFILLMENT]: { fulfillment_id: data.fulfillment.id },
+                },
+            ];
+        });
+        (0, common_1.createRemoteLinkStep)(returnLink).config({
+            name: "exchange-return-shipping-fulfillment-link",
+        });
+    });
+    create_or_update_order_payment_collection_1.createOrUpdateOrderPaymentCollectionWorkflow.runAsStep({
+        input: {
+            order_id: order.id,
+        },
+    });
+    (0, common_1.emitEventStep)({
+        eventName: utils_1.OrderWorkflowEvents.EXCHANGE_CREATED,
+        data: {
+            order_id: order.id,
+            exchange_id: orderExchange.id,
+        },
+    });
+    return new workflows_sdk_1.WorkflowResponse(orderPreview);
+});
+//# sourceMappingURL=confirm-exchange-request.js.map

package/dist/order/workflows/exchange/confirm-exchange-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirm-exchange-request.js","sourceRoot":"","sources":["../../../../src/order/workflows/exchange/confirm-exchange-request.ts"],"names":[],"mappings":"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"}

package/dist/order/workflows/exchange/create-exchange-shipping-method.d.ts

@@ -0,0 +1,111 @@
+import { BigNumberInput, OrderChangeDTO, OrderDTO, OrderExchangeDTO, OrderPreviewDTO } from "@acmekit/framework/types";
+/**
+ * The data to validate that a shipping method can be created for an exchange.
+ */
+export type CreateExchangeShippingMethodValidationStepInput = {
+    /**
+     * The order's details.
+     */
+    order: OrderDTO;
+    /**
+     * The order exchange's details.
+     */
+    orderExchange: OrderExchangeDTO;
+    /**
+     * The order change's details.
+     */
+    orderChange: OrderChangeDTO;
+};
+/**
+ * This step validates that an inbound or outbound shipping method can be created for an exchange.
+ * If the order or exchange is canceled, or the order change is not active, the step will throw an error.
+ *
+ * :::note
+ *
+ * You can retrieve an order, order exchange, and order change details using [Query](https://docs.acmekit.com/learn/fundamentals/module-links/query),
+ * or [useQueryGraphStep](https://docs.acmekit.com/resources/references/acmekit-workflows/steps/useQueryGraphStep).
+ *
+ * :::
+ *
+ * @example
+ * const data = createExchangeShippingMethodValidationStep({
+ *   order: {
+ *     id: "order_123",
+ *     // other order details...
+ *   },
+ *   orderChange: {
+ *     id: "orch_123",
+ *     // other order change details...
+ *   },
+ *   orderExchange: {
+ *     id: "exchange_123",
+ *     // other order exchange details...
+ *   },
+ * })
+ */
+export declare const createExchangeShippingMethodValidationStep: import("@acmekit/framework/workflows-sdk").StepFunction<CreateExchangeShippingMethodValidationStepInput, unknown>;
+/**
+ * The details to create the shipping method for the exchange.
+ */
+export type CreateExchangeShippingMethodWorkflowInput = {
+    /**
+     * The ID of the return associated with the exchange.
+     * If set, an inbound shipping method will be created for the return.
+     * If not set, an outbound shipping method will be created for the exchange.
+     */
+    return_id?: string;
+    /**
+     * The ID of the exchange to create the shipping method for.
+     */
+    exchange_id?: string;
+    /**
+     * The ID of the shipping option to create the shipping method from.
+     */
+    shipping_option_id: string;
+    /**
+     * The custom amount to charge for the shipping method.
+     * If not set, the shipping option's amount is used.
+     */
+    custom_amount?: BigNumberInput | null;
+};
+export declare const createExchangeShippingMethodWorkflowId = "create-exchange-shipping-method";
+/**
+ * This workflow creates an inbound (return) or outbound (delivery of new items) shipping method for an exchange.
+ * It's used by the [Add Inbound Shipping Admin API Route](https://docs.acmekit.com/api/admin#exchanges_postexchangesidinboundshippingmethod)
+ * and the [Add Outbound Shipping Admin API Route](https://docs.acmekit.com/api/admin#exchanges_postexchangesidoutboundshippingmethod).
+ *
+ * You can use this workflow within your customizations or your own custom workflows, allowing you to create a shipping method
+ * for an exchange in your custom flow.
+ *
+ * @example
+ * To create an outbound shipping method for the exchange:
+ *
+ * ```ts
+ * const { result } = await createExchangeShippingMethodWorkflow(container)
+ * .run({
+ *   input: {
+ *     exchange_id: "exchange_123",
+ *     shipping_option_id: "so_123"
+ *   }
+ * })
+ * ```
+ *
+ * To create an inbound shipping method, pass the ID of the return associated with the exchange:
+ *
+ * ```ts
+ * const { result } = await createExchangeShippingMethodWorkflow(container)
+ * .run({
+ *   input: {
+ *     exchange_id: "exchange_123",
+ *     return_id: "return_123",
+ *     shipping_option_id: "so_123"
+ *   }
+ * })
+ * ```
+ *
+ * @summary
+ *
+ * Create an inbound or outbound shipping method for an exchange.
+ */
+export declare const createExchangeShippingMethodWorkflow: import("@acmekit/framework/workflows-sdk").ReturnWorkflow<CreateExchangeShippingMethodWorkflowInput, OrderPreviewDTO, []>;
+//# sourceMappingURL=create-exchange-shipping-method.d.ts.map

package/dist/order/workflows/exchange/create-exchange-shipping-method.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-exchange-shipping-method.d.ts","sourceRoot":"","sources":["../../../../src/order/workflows/exchange/create-exchange-shipping-method.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EAEd,cAAc,EACd,QAAQ,EACR,gBAAgB,EAChB,eAAe,EAChB,MAAM,0BAA0B,CAAA;AAqBjC;;GAEG;AACH,MAAM,MAAM,+CAA+C,GAAG;IAC5D;;OAEG;IACH,KAAK,EAAE,QAAQ,CAAA;IACf;;OAEG;IACH,aAAa,EAAE,gBAAgB,CAAA;IAC/B;;OAEG;IACH,WAAW,EAAE,cAAc,CAAA;CAC5B,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,0CAA0C,mHAWtD,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,yCAAyC,GAAG;IACtD;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;OAEG;IACH,kBAAkB,EAAE,MAAM,CAAA;IAC1B;;;OAGG;IACH,aAAa,CAAC,EAAE,cAAc,GAAG,IAAI,CAAA;CACtC,CAAA;AAED,eAAO,MAAM,sCAAsC,oCAChB,CAAA;AACnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,eAAO,MAAM,oCAAoC,2HAiKhD,CAAA"}