@acmekit/core-flows 2.13.1

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

@@ -0,0 +1,71 @@
+import { OrderChangeDTO, OrderExchangeDTO, OrderPreviewDTO, OrderWorkflow } from "@acmekit/framework/types";
+/**
+ * The data to validate that a shipping method can be removed from an exchange.
+ */
+export type RemoveExchangeShippingMethodValidationStepInput = {
+    /**
+     * The order exchange's details.
+     */
+    orderExchange: OrderExchangeDTO;
+    /**
+     * The order change's details.
+     */
+    orderChange: OrderChangeDTO;
+    /**
+     * The details of the action.
+     */
+    input: Pick<OrderWorkflow.DeleteExchangeShippingMethodWorkflowInput, "exchange_id" | "action_id">;
+};
+/**
+ * This step validates that a shipping method can be removed from an exchange.
+ * If the exchange is canceled, the order change is not active, the shipping method
+ * doesn't exist, or the action isn't adding a shipping method, the step will throw an error.
+ *
+ * :::note
+ *
+ * You can retrieve an 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 = removeExchangeShippingMethodValidationStep({
+ *   orderChange: {
+ *     id: "orch_123",
+ *     // other order change details...
+ *   },
+ *   orderExchange: {
+ *     id: "exchange_123",
+ *     // other order exchange details...
+ *   },
+ *   input: {
+ *     exchange_id: "exchange_123",
+ *     action_id: "orchact_123",
+ *   }
+ * })
+ */
+export declare const removeExchangeShippingMethodValidationStep: import("@acmekit/framework/workflows-sdk").StepFunction<RemoveExchangeShippingMethodValidationStepInput, unknown>;
+export declare const removeExchangeShippingMethodWorkflowId = "remove-exchange-shipping-method";
+/**
+ * This workflow removes an inbound or outbound shipping method of an exchange. It's used by the
+ * [Remove Inbound Shipping Admin API Route](https://docs.acmekit.com/api/admin#exchanges_deleteexchangesidinboundshippingmethodaction_id) or
+ * the [Remove Outbound Shipping Admin API Route](https://docs.acmekit.com/api/admin#exchanges_deleteexchangesidoutboundshippingmethodaction_id).
+ *
+ * You can use this workflow within your customizations or your own custom workflows, allowing you to remove an inbound or outbound shipping method
+ * from an exchange in your custom flow.
+ *
+ * @example
+ * const { result } = await removeExchangeShippingMethodWorkflow(container)
+ * .run({
+ *   input: {
+ *     exchange_id: "exchange_123",
+ *     action_id: "orchact_123",
+ *   }
+ * })
+ *
+ * @summary
+ *
+ * Remove an inbound or outbound shipping method from an exchange.
+ */
+export declare const removeExchangeShippingMethodWorkflow: import("@acmekit/framework/workflows-sdk").ReturnWorkflow<OrderWorkflow.DeleteExchangeShippingMethodWorkflowInput, OrderPreviewDTO, []>;
+//# sourceMappingURL=remove-exchange-shipping-method.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"remove-exchange-shipping-method.d.ts","sourceRoot":"","sources":["../../../../src/order/workflows/exchange/remove-exchange-shipping-method.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,aAAa,EACd,MAAM,0BAA0B,CAAA;AAmBjC;;GAEG;AACH,MAAM,MAAM,+CAA+C,GAAG;IAC5D;;OAEG;IACH,aAAa,EAAE,gBAAgB,CAAA;IAC/B;;OAEG;IACH,WAAW,EAAE,cAAc,CAAA;IAC3B;;OAEG;IACH,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,yCAAyC,EAAE,aAAa,GAAG,WAAW,CAAC,CAAA;CAClG,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,0CAA0C,mHAwBtD,CAAA;AAED,eAAO,MAAM,sCAAsC,oCAChB,CAAA;AACnC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,oCAAoC,yIAqDhD,CAAA"}

package/dist/order/workflows/exchange/remove-exchange-shipping-method.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeExchangeShippingMethodWorkflow = exports.removeExchangeShippingMethodWorkflowId = exports.removeExchangeShippingMethodValidationStep = void 0;
+const utils_1 = require("@acmekit/framework/utils");
+const workflows_sdk_1 = require("@acmekit/framework/workflows-sdk");
+const common_1 = require("../../../common");
+const steps_1 = require("../../steps");
+const delete_order_change_actions_1 = require("../../steps/delete-order-change-actions");
+const preview_order_change_1 = require("../../steps/preview-order-change");
+const order_validation_1 = require("../../utils/order-validation");
+/**
+ * This step validates that a shipping method can be removed from an exchange.
+ * If the exchange is canceled, the order change is not active, the shipping method
+ * doesn't exist, or the action isn't adding a shipping method, the step will throw an error.
+ *
+ * :::note
+ *
+ * You can retrieve an 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 = removeExchangeShippingMethodValidationStep({
+ *   orderChange: {
+ *     id: "orch_123",
+ *     // other order change details...
+ *   },
+ *   orderExchange: {
+ *     id: "exchange_123",
+ *     // other order exchange details...
+ *   },
+ *   input: {
+ *     exchange_id: "exchange_123",
+ *     action_id: "orchact_123",
+ *   }
+ * })
+ */
+exports.removeExchangeShippingMethodValidationStep = (0, workflows_sdk_1.createStep)("validate-remove-exchange-shipping-method", async function ({ orderChange, orderExchange, input, }) {
+    (0, order_validation_1.throwIfIsCancelled)(orderExchange, "Exchange");
+    (0, order_validation_1.throwIfOrderChangeIsNotActive)({ orderChange });
+    const associatedAction = (orderChange.actions ?? []).find((a) => a.id === input.action_id);
+    if (!associatedAction) {
+        throw new Error(`No shipping method found for exchange ${input.exchange_id} in order change ${orderChange.id}`);
+    }
+    else if (associatedAction.action !== utils_1.ChangeActionType.SHIPPING_ADD) {
+        throw new Error(`Action ${associatedAction.id} is not adding a shipping method`);
+    }
+});
+exports.removeExchangeShippingMethodWorkflowId = "remove-exchange-shipping-method";
+/**
+ * This workflow removes an inbound or outbound shipping method of an exchange. It's used by the
+ * [Remove Inbound Shipping Admin API Route](https://docs.acmekit.com/api/admin#exchanges_deleteexchangesidinboundshippingmethodaction_id) or
+ * the [Remove Outbound Shipping Admin API Route](https://docs.acmekit.com/api/admin#exchanges_deleteexchangesidoutboundshippingmethodaction_id).
+ *
+ * You can use this workflow within your customizations or your own custom workflows, allowing you to remove an inbound or outbound shipping method
+ * from an exchange in your custom flow.
+ *
+ * @example
+ * const { result } = await removeExchangeShippingMethodWorkflow(container)
+ * .run({
+ *   input: {
+ *     exchange_id: "exchange_123",
+ *     action_id: "orchact_123",
+ *   }
+ * })
+ *
+ * @summary
+ *
+ * Remove an inbound or outbound shipping method from an exchange.
+ */
+exports.removeExchangeShippingMethodWorkflow = (0, workflows_sdk_1.createWorkflow)(exports.removeExchangeShippingMethodWorkflowId, 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 orderChange = (0, common_1.useRemoteQueryStep)({
+        entry_point: "order_change",
+        fields: ["id", "status", "version", "actions.*"],
+        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.removeExchangeShippingMethodValidationStep)({
+        orderExchange,
+        orderChange,
+        input,
+    });
+    const dataToRemove = (0, workflows_sdk_1.transform)({ orderChange, input }, ({ orderChange, input }) => {
+        const associatedAction = (orderChange.actions ?? []).find((a) => a.id === input.action_id);
+        return {
+            actionId: associatedAction.id,
+            shippingMethodId: associatedAction.reference_id,
+        };
+    });
+    (0, workflows_sdk_1.parallelize)((0, delete_order_change_actions_1.deleteOrderChangeActionsStep)({ ids: [dataToRemove.actionId] }), (0, steps_1.deleteOrderShippingMethods)({ ids: [dataToRemove.shippingMethodId] }));
+    return new workflows_sdk_1.WorkflowResponse((0, preview_order_change_1.previewOrderChangeStep)(orderExchange.order_id));
+});
+//# sourceMappingURL=remove-exchange-shipping-method.js.map

package/dist/order/workflows/exchange/remove-exchange-shipping-method.js.map

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

package/dist/order/workflows/exchange/update-exchange-add-item.d.ts

@@ -0,0 +1,84 @@
+import { OrderChangeDTO, OrderDTO, OrderExchangeDTO, OrderPreviewDTO, OrderWorkflow } from "@acmekit/framework/types";
+/**
+ * The data to validate that an outbound or new item in an exchange can be updated.
+ */
+export type UpdateExchangeAddItemValidationStepInput = {
+    /**
+     * The order's details.
+     */
+    order: OrderDTO;
+    /**
+     * The order exchange's details.
+     */
+    orderExchange: OrderExchangeDTO;
+    /**
+     * The order change's details.
+     */
+    orderChange: OrderChangeDTO;
+    /**
+     * The details of the item update.
+     */
+    input: OrderWorkflow.UpdateExchangeAddNewItemWorkflowInput;
+};
+/**
+ * This step validates that an outbound or new item can be removed from an exchange.
+ * If the order or exchange is canceled, the item is not found in the exchange,
+ * 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 = updateExchangeAddItemValidationStep({
+ *   order: {
+ *     id: "order_123",
+ *     // other order details...
+ *   },
+ *   orderChange: {
+ *     id: "orch_123",
+ *     // other order change details...
+ *   },
+ *   orderExchange: {
+ *     id: "exchange_123",
+ *     // other order exchange details...
+ *   },
+ *   input: {
+ *     exchange_id: "exchange_123",
+ *     action_id: "orchact_123",
+ *     data: {
+ *       quantity: 1
+ *     }
+ *   }
+ * })
+ */
+export declare const updateExchangeAddItemValidationStep: import("@acmekit/framework/workflows-sdk").StepFunction<UpdateExchangeAddItemValidationStepInput, unknown>;
+export declare const updateExchangeAddItemWorkflowId = "update-exchange-add-item";
+/**
+ * This workflow updates an outbound or new item in the exchange. It's used by the
+ * [Update Outbound Item Admin API Route](https://docs.acmekit.com/api/admin#exchanges_postexchangesidoutbounditemsaction_id).
+ *
+ * You can use this workflow within your customizations or your own custom workflows, allowing you to update an outbound or new item
+ * in an exchange in your custom flow.
+ *
+ * @example
+ * const { result } = await updateExchangeAddItemWorkflow(container)
+ * .run({
+ *   input: {
+ *     exchange_id: "exchange_123",
+ *     action_id: "orchact_123",
+ *     data: {
+ *       quantity: 1
+ *     }
+ *   }
+ * })
+ *
+ * @summary
+ *
+ * Update an outbound or new item in an exchange.
+ */
+export declare const updateExchangeAddItemWorkflow: import("@acmekit/framework/workflows-sdk").ReturnWorkflow<OrderWorkflow.UpdateExchangeAddNewItemWorkflowInput, OrderPreviewDTO, []>;
+//# sourceMappingURL=update-exchange-add-item.d.ts.map

package/dist/order/workflows/exchange/update-exchange-add-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-exchange-add-item.d.ts","sourceRoot":"","sources":["../../../../src/order/workflows/exchange/update-exchange-add-item.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,cAAc,EACd,QAAQ,EACR,gBAAgB,EAEhB,eAAe,EACf,aAAa,EACd,MAAM,0BAA0B,CAAA;AAsBjC;;GAEG;AACH,MAAM,MAAM,wCAAwC,GAAG;IACrD;;OAEG;IACH,KAAK,EAAE,QAAQ,CAAA;IACf;;OAEG;IACH,aAAa,EAAE,gBAAgB,CAAA;IAC/B;;OAEG;IACH,WAAW,EAAE,cAAc,CAAA;IAC3B;;OAEG;IACH,KAAK,EAAE,aAAa,CAAC,qCAAqC,CAAA;CAC3D,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,mCAAmC,4GA2B/C,CAAA;AAED,eAAO,MAAM,+BAA+B,6BAA6B,CAAA;AACzE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,6BAA6B,qIAuGzC,CAAA"}

package/dist/order/workflows/exchange/update-exchange-add-item.js

@@ -0,0 +1,163 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateExchangeAddItemWorkflow = exports.updateExchangeAddItemWorkflowId = exports.updateExchangeAddItemValidationStep = void 0;
+const utils_1 = require("@acmekit/framework/utils");
+const workflows_sdk_1 = require("@acmekit/framework/workflows-sdk");
+const common_1 = require("../../../common");
+const steps_1 = require("../../steps");
+const order_validation_1 = require("../../utils/order-validation");
+const refresh_shipping_1 = require("./refresh-shipping");
+const compute_adjustments_for_preview_1 = require("../compute-adjustments-for-preview");
+const fields_1 = require("../order-edit/utils/fields");
+/**
+ * This step validates that an outbound or new item can be removed from an exchange.
+ * If the order or exchange is canceled, the item is not found in the exchange,
+ * 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 = updateExchangeAddItemValidationStep({
+ *   order: {
+ *     id: "order_123",
+ *     // other order details...
+ *   },
+ *   orderChange: {
+ *     id: "orch_123",
+ *     // other order change details...
+ *   },
+ *   orderExchange: {
+ *     id: "exchange_123",
+ *     // other order exchange details...
+ *   },
+ *   input: {
+ *     exchange_id: "exchange_123",
+ *     action_id: "orchact_123",
+ *     data: {
+ *       quantity: 1
+ *     }
+ *   }
+ * })
+ */
+exports.updateExchangeAddItemValidationStep = (0, workflows_sdk_1.createStep)("update-exchange-add-item-validation", async function ({ order, orderChange, orderExchange, input, }, context) {
+    (0, order_validation_1.throwIfIsCancelled)(order, "Order");
+    (0, order_validation_1.throwIfIsCancelled)(orderExchange, "Exchange");
+    (0, order_validation_1.throwIfOrderChangeIsNotActive)({ orderChange });
+    const associatedAction = (orderChange.actions ?? []).find((a) => a.id === input.action_id);
+    if (!associatedAction) {
+        throw new Error(`No request to add item for exchange ${input.exchange_id} in order change ${orderChange.id}`);
+    }
+    else if (associatedAction.action !== utils_1.ChangeActionType.ITEM_ADD) {
+        throw new Error(`Action ${associatedAction.id} is not adding an item`);
+    }
+});
+exports.updateExchangeAddItemWorkflowId = "update-exchange-add-item";
+/**
+ * This workflow updates an outbound or new item in the exchange. It's used by the
+ * [Update Outbound Item Admin API Route](https://docs.acmekit.com/api/admin#exchanges_postexchangesidoutbounditemsaction_id).
+ *
+ * You can use this workflow within your customizations or your own custom workflows, allowing you to update an outbound or new item
+ * in an exchange in your custom flow.
+ *
+ * @example
+ * const { result } = await updateExchangeAddItemWorkflow(container)
+ * .run({
+ *   input: {
+ *     exchange_id: "exchange_123",
+ *     action_id: "orchact_123",
+ *     data: {
+ *       quantity: 1
+ *     }
+ *   }
+ * })
+ *
+ * @summary
+ *
+ * Update an outbound or new item in an exchange.
+ */
+exports.updateExchangeAddItemWorkflow = (0, workflows_sdk_1.createWorkflow)(exports.updateExchangeAddItemWorkflowId, 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: [
+            ...fields_1.fieldsToComputeAdjustmentsForPreview,
+            "status",
+            "canceled_at",
+        ],
+        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",
+            "version",
+            "exchange_id",
+            "actions.*",
+            "carry_over_promotions",
+        ],
+        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.updateExchangeAddItemValidationStep)({
+        order,
+        input,
+        orderExchange,
+        orderChange,
+    });
+    const updateData = (0, workflows_sdk_1.transform)({ orderChange, input }, ({ input, orderChange }) => {
+        const originalAction = (orderChange.actions ?? []).find((a) => a.id === input.action_id);
+        const data = input.data;
+        return {
+            id: input.action_id,
+            details: {
+                quantity: data.quantity ?? originalAction.details?.quantity,
+            },
+            internal_note: data.internal_note,
+        };
+    });
+    (0, steps_1.updateOrderChangeActionsStep)([updateData]);
+    const refreshArgs = (0, workflows_sdk_1.transform)({ orderChange, orderExchange }, ({ orderChange, orderExchange }) => {
+        return {
+            order_change_id: orderChange.id,
+            exchange_id: orderExchange.id,
+            order_id: orderExchange.order_id,
+        };
+    });
+    const orderWithPromotions = (0, workflows_sdk_1.transform)({ order }, ({ order }) => {
+        return {
+            ...order,
+            promotions: order.promotions ?? [],
+        };
+    });
+    compute_adjustments_for_preview_1.computeAdjustmentsForPreviewWorkflow.runAsStep({
+        input: {
+            order: orderWithPromotions,
+            orderChange,
+        },
+    });
+    refresh_shipping_1.refreshExchangeShippingWorkflow.runAsStep({
+        input: refreshArgs,
+    });
+    return new workflows_sdk_1.WorkflowResponse((0, steps_1.previewOrderChangeStep)(order.id));
+});
+//# sourceMappingURL=update-exchange-add-item.js.map

package/dist/order/workflows/exchange/update-exchange-add-item.js.map

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

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

@@ -0,0 +1,118 @@
+import { AdditionalData, OrderChangeDTO, OrderExchangeDTO, OrderPreviewDTO, OrderWorkflow } from "@acmekit/framework/types";
+import { WorkflowData } from "@acmekit/framework/workflows-sdk";
+/**
+ * The data to validate that an exchange's shipping method can be updated.
+ */
+export type UpdateExchangeShippingMethodValidationStepInput = {
+    /**
+     * The order exchange's details.
+     */
+    orderExchange: OrderExchangeDTO;
+    /**
+     * The order change's details.
+     */
+    orderChange: OrderChangeDTO;
+    /**
+     * The details of the shipping method update.
+     */
+    input: Pick<OrderWorkflow.UpdateExchangeShippingMethodWorkflowInput, "exchange_id" | "action_id">;
+};
+/**
+ * This step validates that an exchange's shipping method can be updated.
+ * If the exchange is canceled, the order change is not active, the shipping method
+ * doesn't exist in the exchange, or the action isn't adding a shipping method,
+ * the step will throw an error.
+ *
+ * :::note
+ *
+ * You can retrieve an 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 = updateExchangeShippingMethodValidationStep({
+ *   orderChange: {
+ *     id: "orch_123",
+ *     // other order change details...
+ *   },
+ *   orderExchange: {
+ *     id: "exchange_123",
+ *     // other order exchange details...
+ *   },
+ *   input: {
+ *     exchange_id: "exchange_123",
+ *     action_id: "orchact_123",
+ *     data: {
+ *       custom_amount: 10,
+ *     }
+ *   }
+ * })
+ */
+export declare const updateExchangeShippingMethodValidationStep: import("@acmekit/framework/workflows-sdk").StepFunction<UpdateExchangeShippingMethodValidationStepInput, unknown>;
+export declare const updateExchangeShippingMethodWorkflowId = "update-exchange-shipping-method";
+/**
+ * This workflow updates an exchange's inbound or outbound shipping method. It's used by the
+ * [Update Inbound Shipping Admin API Route](https://docs.acmekit.com/api/admin#exchanges_postexchangesidinboundshippingmethodaction_id)
+ * or the [Outbound Inbound Shipping Admin API Route](https://docs.acmekit.com/api/admin#exchanges_postexchangesidoutboundshippingmethodaction_id).
+ *
+ * You can use this workflow within your customizations or your own custom workflows, allowing you to update an exchange's
+ * inbound or outbound shipping method in your custom flow.
+ *
+ * @example
+ * const { result } = await updateExchangeShippingMethodWorkflow(container)
+ * .run({
+ *   input: {
+ *     exchange_id: "exchange_123",
+ *     action_id: "orchact_123",
+ *     data: {
+ *       custom_amount: 10,
+ *     }
+ *   }
+ * })
+ *
+ * @summary
+ *
+ * Update an exchange's inbound or outbound shipping method.
+ *
+ * @property hooks.setPricingContext - This hook is executed before the shipping method is updated. You can consume this hook to return any custom context useful for the prices retrieval of the shipping method's option.
+ *
+ * For example, assuming you have the following custom pricing rule:
+ *
+ * ```json
+ * {
+ *   "attribute": "location_id",
+ *   "operator": "eq",
+ *   "value": "sloc_123",
+ * }
+ * ```
+ *
+ * You can consume the `setPricingContext` hook to add the `location_id` context to the prices calculation:
+ *
+ * ```ts
+ * import { updateExchangeShippingMethodWorkflow } from "@acmekit/acmekit/core-flows";
+ * import { StepResponse } from "@acmekit/workflows-sdk";
+ *
+ * updateExchangeShippingMethodWorkflow.hooks.setPricingContext((
+ *   { order_exchange, order_change, additional_data }, { container }
+ * ) => {
+ *   return new StepResponse({
+ *     location_id: "sloc_123", // Special price for in-store purchases
+ *   });
+ * });
+ * ```
+ *
+ * The price of the shipping method's option will now be retrieved using the context you return.
+ *
+ * :::note
+ *
+ * Learn more about prices calculation context in the [Prices Calculation](https://docs.acmekit.com/resources/commerce-modules/pricing/price-calculation) documentation.
+ *
+ * :::
+ */
+export declare const updateExchangeShippingMethodWorkflow: import("@acmekit/framework/workflows-sdk").ReturnWorkflow<OrderWorkflow.UpdateExchangeShippingMethodWorkflowInput & AdditionalData, OrderPreviewDTO, [import("@acmekit/framework/workflows-sdk").Hook<"setPricingContext", {
+    order_exchange: OrderExchangeDTO;
+    order_change: OrderChangeDTO;
+    additional_data: ((Record<string, unknown> | WorkflowData<Record<string, unknown> | undefined>) & Record<string, unknown>) | undefined;
+}, Record<string, any> | undefined>]>;
+//# sourceMappingURL=update-exchange-shipping-method.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update-exchange-shipping-method.d.ts","sourceRoot":"","sources":["../../../../src/order/workflows/exchange/update-exchange-shipping-method.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EAEd,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,aAAa,EACd,MAAM,0BAA0B,CAAA;AAEjC,OAAO,EACL,YAAY,EAQb,MAAM,kCAAkC,CAAA;AAczC;;GAEG;AACH,MAAM,MAAM,+CAA+C,GAAG;IAC5D;;OAEG;IACH,aAAa,EAAE,gBAAgB,CAAA;IAC/B;;OAEG;IACH,WAAW,EAAE,cAAc,CAAA;IAC3B;;OAEG;IACH,KAAK,EAAE,IAAI,CACT,aAAa,CAAC,yCAAyC,EACvD,aAAa,GAAG,WAAW,CAC5B,CAAA;CACF,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,0CAA0C,mHAwBtD,CAAA;AAED,eAAO,MAAM,sCAAsC,oCAChB,CAAA;AACnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,eAAO,MAAM,oCAAoC;;;;qCA6HhD,CAAA"}