@medusajs/core-flows 3.0.0-snapshot-20250410112222 → 3.0.0-snapshot-20251104004624

package/dist/draft-order/steps/validate-promo-codes-to-remove.d.ts

@@ -1,9 +1,40 @@
-import { PromotionDTO } from "@medusajs/types";
+import type { PromotionDTO } from "@medusajs/framework/types";
 export declare const validatePromoCodesToRemoveId = "validate-promo-codes-to-remove";
-interface ValidatePromoCodesToRemoveStepInput {
+/**
+ * The details of the promo codes removal to validate.
+ */
+export interface ValidatePromoCodesToRemoveStepInput {
+    /**
+     * The promo codes to remove from the draft order.
+     */
     promo_codes: string[];
+    /**
+     * The promotions to remove from the draft order.
+     */
     promotions: PromotionDTO[];
 }
+/**
+ * This step validates that the promo codes can be removed from a draft order. It throws an error if the promo
+ * codes don't exist.
+ *
+ * :::note
+ *
+ * You can retrieve a promotion's details using [Query](https://docs.medusajs.com/learn/fundamentals/module-links/query),
+ * or [useQueryGraphStep](https://docs.medusajs.com/resources/references/medusa-workflows/steps/useQueryGraphStep).
+ *
+ * :::
+ *
+ * @example
+ * const data = validatePromoCodesToRemoveStep({
+ *   promo_codes: ["PROMO_123", "PROMO_456"],
+ *   promotions: [{
+ *     id: "promo_123",
+ *     code: "PROMO_123"
+ *   }, {
+ *     id: "promo_456",
+ *     code: "PROMO_456"
+ *   }],
+ * })
+ */
 export declare const validatePromoCodesToRemoveStep: import("@medusajs/framework/workflows-sdk").StepFunction<ValidatePromoCodesToRemoveStepInput, unknown>;
-export {};
 //# sourceMappingURL=validate-promo-codes-to-remove.d.ts.map

package/dist/draft-order/steps/validate-promo-codes-to-remove.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate-promo-codes-to-remove.d.ts","sourceRoot":"","sources":["../../../src/draft-order/steps/validate-promo-codes-to-remove.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAG9C,eAAO,MAAM,4BAA4B,mCAAmC,CAAA;AAE5E,UAAU,mCAAmC;IAC3C,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,UAAU,EAAE,YAAY,EAAE,CAAA;CAC3B;AAED,eAAO,MAAM,8BAA8B,wGAO1C,CAAA"}
+{"version":3,"file":"validate-promo-codes-to-remove.d.ts","sourceRoot":"","sources":["../../../src/draft-order/steps/validate-promo-codes-to-remove.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAG7D,eAAO,MAAM,4BAA4B,mCAAmC,CAAA;AAE5E;;GAEG;AACH,MAAM,WAAW,mCAAmC;IAClD;;OAEG;IACH,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB;;OAEG;IACH,UAAU,EAAE,YAAY,EAAE,CAAA;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,8BAA8B,wGAO1C,CAAA"}

package/dist/draft-order/steps/validate-promo-codes-to-remove.js

@@ -4,6 +4,29 @@ exports.validatePromoCodesToRemoveStep = exports.validatePromoCodesToRemoveId =
 const workflows_sdk_1 = require("@medusajs/framework/workflows-sdk");
 const validation_1 = require("../utils/validation");
 exports.validatePromoCodesToRemoveId = "validate-promo-codes-to-remove";
+/**
+ * This step validates that the promo codes can be removed from a draft order. It throws an error if the promo
+ * codes don't exist.
+ *
+ * :::note
+ *
+ * You can retrieve a promotion's details using [Query](https://docs.medusajs.com/learn/fundamentals/module-links/query),
+ * or [useQueryGraphStep](https://docs.medusajs.com/resources/references/medusa-workflows/steps/useQueryGraphStep).
+ *
+ * :::
+ *
+ * @example
+ * const data = validatePromoCodesToRemoveStep({
+ *   promo_codes: ["PROMO_123", "PROMO_456"],
+ *   promotions: [{
+ *     id: "promo_123",
+ *     code: "PROMO_123"
+ *   }, {
+ *     id: "promo_456",
+ *     code: "PROMO_456"
+ *   }],
+ * })
+ */
 exports.validatePromoCodesToRemoveStep = (0, workflows_sdk_1.createStep)(exports.validatePromoCodesToRemoveId, async function (input) {
     const { promo_codes, promotions } = input;
     (0, validation_1.throwIfCodesAreMissing)(promo_codes, promotions);

package/dist/draft-order/steps/validate-promo-codes-to-remove.js.map

@@ -1 +1 @@
-{"version":3,"file":"validate-promo-codes-to-remove.js","sourceRoot":"","sources":["../../../src/draft-order/steps/validate-promo-codes-to-remove.ts"],"names":[],"mappings":";;;AAAA,qEAA8D;AAE9D,oDAA4D;AAE/C,QAAA,4BAA4B,GAAG,gCAAgC,CAAA;AAO/D,QAAA,8BAA8B,GAAG,IAAA,0BAAU,EACtD,oCAA4B,EAC5B,KAAK,WAAW,KAA0C;IACxD,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,KAAK,CAAA;IAEzC,IAAA,mCAAsB,EAAC,WAAW,EAAE,UAAU,CAAC,CAAA;AACjD,CAAC,CACF,CAAA"}
+{"version":3,"file":"validate-promo-codes-to-remove.js","sourceRoot":"","sources":["../../../src/draft-order/steps/validate-promo-codes-to-remove.ts"],"names":[],"mappings":";;;AAAA,qEAA8D;AAE9D,oDAA4D;AAE/C,QAAA,4BAA4B,GAAG,gCAAgC,CAAA;AAgB5E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACU,QAAA,8BAA8B,GAAG,IAAA,0BAAU,EACtD,oCAA4B,EAC5B,KAAK,WAAW,KAA0C;IACxD,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,KAAK,CAAA;IAEzC,IAAA,mCAAsB,EAAC,WAAW,EAAE,UAAU,CAAC,CAAA;AACjD,CAAC,CACF,CAAA"}

package/dist/draft-order/utils/fields.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../../src/draft-order/utils/fields.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,+BAA+B,UAqC3C,CAAA"}
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../../src/draft-order/utils/fields.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,+BAA+B,UAmC3C,CAAA"}

package/dist/draft-order/utils/fields.js

@@ -30,10 +30,8 @@ exports.draftOrderFieldsForRefreshSteps = [
     "shipping_methods.tax_lines.*",
     "customer.*",
     "customer.groups.*",
-    "promotion_link.*",
-    "promotion_link.promotion",
-    "promotion_link.promotion.id",
-    "promotion_link.promotion.code",
+    "promotions.id",
+    "promotions.code",
     "subtotal",
     "item_total",
     "total",

package/dist/draft-order/utils/fields.js.map

@@ -1 +1 @@
-{"version":3,"file":"fields.js","sourceRoot":"","sources":["../../../src/draft-order/utils/fields.ts"],"names":[],"mappings":";;;AAAa,QAAA,+BAA+B,GAAG;IAC7C,IAAI;IACJ,gBAAgB;IAChB,QAAQ;IACR,eAAe;IACf,UAAU;IACV,kBAAkB;IAClB,WAAW;IACX,UAAU;IACV,SAAS;IACT,kBAAkB;IAClB,6BAA6B;IAC7B,6BAA6B;IAC7B,uBAAuB;IACvB,kBAAkB;IAClB,0BAA0B;IAC1B,sBAAsB;IACtB,sBAAsB;IACtB,sBAAsB;IACtB,qBAAqB;IACrB,wBAAwB;IACxB,qBAAqB;IACrB,mBAAmB;IACnB,oBAAoB;IACpB,oBAAoB;IACpB,gCAAgC;IAChC,8BAA8B;IAC9B,YAAY;IACZ,mBAAmB;IACnB,kBAAkB;IAClB,0BAA0B;IAC1B,6BAA6B;IAC7B,+BAA+B;IAC/B,UAAU;IACV,YAAY;IACZ,OAAO;IACP,eAAe;CAChB,CAAA"}
+{"version":3,"file":"fields.js","sourceRoot":"","sources":["../../../src/draft-order/utils/fields.ts"],"names":[],"mappings":";;;AAAa,QAAA,+BAA+B,GAAG;IAC7C,IAAI;IACJ,gBAAgB;IAChB,QAAQ;IACR,eAAe;IACf,UAAU;IACV,kBAAkB;IAClB,WAAW;IACX,UAAU;IACV,SAAS;IACT,kBAAkB;IAClB,6BAA6B;IAC7B,6BAA6B;IAC7B,uBAAuB;IACvB,kBAAkB;IAClB,0BAA0B;IAC1B,sBAAsB;IACtB,sBAAsB;IACtB,sBAAsB;IACtB,qBAAqB;IACrB,wBAAwB;IACxB,qBAAqB;IACrB,mBAAmB;IACnB,oBAAoB;IACpB,oBAAoB;IACpB,gCAAgC;IAChC,8BAA8B;IAC9B,YAAY;IACZ,mBAAmB;IACnB,eAAe;IACf,iBAAiB;IACjB,UAAU;IACV,YAAY;IACZ,OAAO;IACP,eAAe;CAChB,CAAA"}

package/dist/draft-order/utils/validation.d.ts

@@ -1,4 +1,4 @@
-import { OrderDTO, PromotionDTO } from "@medusajs/types";
+import type { OrderDTO, PromotionDTO } from "@medusajs/framework/types";
 interface ThrowIfNotDraftOrderInput {
     order: OrderDTO;
 }

package/dist/draft-order/utils/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/draft-order/utils/validation.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAExD,UAAU,yBAAyB;IACjC,KAAK,EAAE,QAAQ,CAAA;CAChB;AAED,wBAAgB,oBAAoB,CAAC,EAAE,KAAK,EAAE,EAAE,yBAAyB,QAOxE;AAMD,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EAAE,EACrB,UAAU,EAAE,YAAY,EAAE,QAgB3B;AAED,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EAAE,EACrB,UAAU,EAAE,YAAY,EAAE,QAmB3B"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/draft-order/utils/validation.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAEvE,UAAU,yBAAyB;IACjC,KAAK,EAAE,QAAQ,CAAA;CAChB;AAED,wBAAgB,oBAAoB,CAAC,EAAE,KAAK,EAAE,EAAE,yBAAyB,QAOxE;AAMD,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EAAE,EACrB,UAAU,EAAE,YAAY,EAAE,QAgB3B;AAED,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EAAE,EACrB,UAAU,EAAE,YAAY,EAAE,QAmB3B"}

package/dist/draft-order/workflows/add-draft-order-items.d.ts

@@ -1,4 +1,27 @@
-import { OrderWorkflow } from "@medusajs/types";
+import { OrderWorkflow } from "@medusajs/framework/types";
 export declare const addDraftOrderItemsWorkflowId = "add-draft-order-items";
-export declare const addDraftOrderItemsWorkflow: import("@medusajs/framework/workflows-sdk").ReturnWorkflow<OrderWorkflow.OrderEditAddNewItemWorkflowInput, import("@medusajs/types").OrderPreviewDTO, []>;
+/**
+ * This workflow adds items to a draft order. It's used by the
+ * [Add Item to Draft Order Admin API Route](https://docs.medusajs.com/api/admin#draft-orders_postdraftordersidedititems).
+ *
+ * You can use this workflow within your customizations or your own custom workflows, allowing you to wrap custom logic around adding items to
+ * a draft order.
+ *
+ * @example
+ * const { result } = await addDraftOrderItemsWorkflow(container)
+ * .run({
+ *   input: {
+ *     order_id: "order_123",
+ *     items: [{
+ *       variant_id: "variant_123",
+ *       quantity: 1
+ *     }]
+ *   }
+ * })
+ *
+ * @summary
+ *
+ * Add items to a draft order.
+ */
+export declare const addDraftOrderItemsWorkflow: import("@medusajs/framework/workflows-sdk").ReturnWorkflow<OrderWorkflow.OrderEditAddNewItemWorkflowInput, import("@medusajs/framework/types").OrderPreviewDTO, []>;
 //# sourceMappingURL=add-draft-order-items.d.ts.map

package/dist/draft-order/workflows/add-draft-order-items.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add-draft-order-items.d.ts","sourceRoot":"","sources":["../../../src/draft-order/workflows/add-draft-order-items.ts"],"names":[],"mappings":"AAYA,OAAO,EAA4B,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAYzE,eAAO,MAAM,4BAA4B,0BAA0B,CAAA;AAEnE,eAAO,MAAM,0BAA0B,2JAqGtC,CAAA"}
+{"version":3,"file":"add-draft-order-items.d.ts","sourceRoot":"","sources":["../../../src/draft-order/workflows/add-draft-order-items.ts"],"names":[],"mappings":"AAYA,OAAO,EAGL,aAAa,EACd,MAAM,2BAA2B,CAAA;AAalC,eAAO,MAAM,4BAA4B,0BAA0B,CAAA;AAEnE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,0BAA0B,qKAuGtC,CAAA"}

package/dist/draft-order/workflows/add-draft-order-items.js

@@ -8,8 +8,37 @@ const order_1 = require("../../order");
 const validate_draft_order_change_1 = require("../steps/validate-draft-order-change");
 const fields_1 = require("../utils/fields");
 const refresh_draft_order_adjustments_1 = require("./refresh-draft-order-adjustments");
+const locking_1 = require("../../locking");
 exports.addDraftOrderItemsWorkflowId = "add-draft-order-items";
+/**
+ * This workflow adds items to a draft order. It's used by the
+ * [Add Item to Draft Order Admin API Route](https://docs.medusajs.com/api/admin#draft-orders_postdraftordersidedititems).
+ *
+ * You can use this workflow within your customizations or your own custom workflows, allowing you to wrap custom logic around adding items to
+ * a draft order.
+ *
+ * @example
+ * const { result } = await addDraftOrderItemsWorkflow(container)
+ * .run({
+ *   input: {
+ *     order_id: "order_123",
+ *     items: [{
+ *       variant_id: "variant_123",
+ *       quantity: 1
+ *     }]
+ *   }
+ * })
+ *
+ * @summary
+ *
+ * Add items to a draft order.
+ */
 exports.addDraftOrderItemsWorkflow = (0, workflows_sdk_1.createWorkflow)(exports.addDraftOrderItemsWorkflowId, function (input) {
+    (0, locking_1.acquireLockStep)({
+        key: input.order_id,
+        timeout: 2,
+        ttl: 10,
+    });
     const order = (0, common_1.useRemoteQueryStep)({
         entry_point: "orders",
         fields: fields_1.draftOrderFieldsForRefreshSteps,
@@ -44,16 +73,7 @@ exports.addDraftOrderItemsWorkflow = (0, workflows_sdk_1.createWorkflow)(exports
             item_ids: lineItemIds,
         },
     });
-    const appliedPromoCodes = (0, workflows_sdk_1.transform)(order, (order) => {
-        const promotionLink = order.promotion_link;
-        if (!promotionLink) {
-            return [];
-        }
-        if (Array.isArray(promotionLink)) {
-            return promotionLink.map((promo) => promo.promotion.code);
-        }
-        return [promotionLink.promotion.code];
-    });
+    const appliedPromoCodes = (0, workflows_sdk_1.transform)(order, (order) => order.promotions?.map((promotion) => promotion.code) ?? []);
     // If any the order has any promo codes, then we need to refresh the adjustments.
     (0, workflows_sdk_1.when)(appliedPromoCodes, (appliedPromoCodes) => appliedPromoCodes.length > 0).then(() => {
         refresh_draft_order_adjustments_1.refreshDraftOrderAdjustmentsWorkflow.runAsStep({
@@ -84,6 +104,9 @@ exports.addDraftOrderItemsWorkflow = (0, workflows_sdk_1.createWorkflow)(exports
     order_1.createOrderChangeActionsWorkflow.runAsStep({
         input: orderChangeActionInput,
     });
+    (0, locking_1.releaseLockStep)({
+        key: input.order_id,
+    });
     return new workflows_sdk_1.WorkflowResponse((0, order_1.previewOrderChangeStep)(input.order_id));
 });
 //# sourceMappingURL=add-draft-order-items.js.map

package/dist/draft-order/workflows/add-draft-order-items.js.map

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

package/dist/draft-order/workflows/add-draft-order-promotions.d.ts

@@ -1,8 +1,36 @@
 export declare const addDraftOrderPromotionWorkflowId = "add-draft-order-promotion";
-interface AddDraftOrderPromotionWorkflowInput {
+/**
+ * The details of the promotions to add to a draft order.
+ */
+export interface AddDraftOrderPromotionWorkflowInput {
+    /**
+     * The ID of the draft order to add the promotions to.
+     */
     order_id: string;
+    /**
+     * The codes of the promotions to add to the draft order.
+     */
     promo_codes: string[];
 }
-export declare const addDraftOrderPromotionWorkflow: import("@medusajs/framework/workflows-sdk").ReturnWorkflow<AddDraftOrderPromotionWorkflowInput, import("@medusajs/types").OrderPreviewDTO, []>;
-export {};
+/**
+ * This workflow adds promotions to a draft order. It's used by the
+ * [Add Promotion to Draft Order Admin API Route](https://docs.medusajs.com/api/admin#draft-orders_postdraftordersideditpromotions).
+ *
+ * You can use this workflow within your customizations or your own custom workflows, allowing you to wrap custom logic around adding promotions to
+ * a draft order.
+ *
+ * @example
+ * const { result } = await addDraftOrderPromotionWorkflow(container)
+ * .run({
+ *   input: {
+ *     order_id: "order_123",
+ *     promo_codes: ["PROMO_CODE_1", "PROMO_CODE_2"]
+ *   }
+ * })
+ *
+ * @summary
+ *
+ * Add promotions to a draft order.
+ */
+export declare const addDraftOrderPromotionWorkflow: import("@medusajs/framework/workflows-sdk").ReturnWorkflow<AddDraftOrderPromotionWorkflowInput, import("@medusajs/framework/types").OrderPreviewDTO, []>;
 //# sourceMappingURL=add-draft-order-promotions.d.ts.map

package/dist/draft-order/workflows/add-draft-order-promotions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add-draft-order-promotions.d.ts","sourceRoot":"","sources":["../../../src/draft-order/workflows/add-draft-order-promotions.ts"],"names":[],"mappings":"AAsBA,eAAO,MAAM,gCAAgC,8BAA8B,CAAA;AAE3E,UAAU,mCAAmC;IAC3C,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,EAAE,CAAA;CACtB;AAED,eAAO,MAAM,8BAA8B,gJAyE1C,CAAA"}
+{"version":3,"file":"add-draft-order-promotions.d.ts","sourceRoot":"","sources":["../../../src/draft-order/workflows/add-draft-order-promotions.ts"],"names":[],"mappings":"AA2BA,eAAO,MAAM,gCAAgC,8BAA8B,CAAA;AAE3E;;GAEG;AACH,MAAM,WAAW,mCAAmC;IAClD;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,WAAW,EAAE,MAAM,EAAE,CAAA;CACtB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,8BAA8B,0JAmF1C,CAAA"}

package/dist/draft-order/workflows/add-draft-order-promotions.js

@@ -9,8 +9,34 @@ const validate_draft_order_change_1 = require("../steps/validate-draft-order-cha
 const validate_promo_codes_to_add_1 = require("../steps/validate-promo-codes-to-add");
 const fields_1 = require("../utils/fields");
 const refresh_draft_order_adjustments_1 = require("./refresh-draft-order-adjustments");
+const locking_1 = require("../../locking");
 exports.addDraftOrderPromotionWorkflowId = "add-draft-order-promotion";
+/**
+ * This workflow adds promotions to a draft order. It's used by the
+ * [Add Promotion to Draft Order Admin API Route](https://docs.medusajs.com/api/admin#draft-orders_postdraftordersideditpromotions).
+ *
+ * You can use this workflow within your customizations or your own custom workflows, allowing you to wrap custom logic around adding promotions to
+ * a draft order.
+ *
+ * @example
+ * const { result } = await addDraftOrderPromotionWorkflow(container)
+ * .run({
+ *   input: {
+ *     order_id: "order_123",
+ *     promo_codes: ["PROMO_CODE_1", "PROMO_CODE_2"]
+ *   }
+ * })
+ *
+ * @summary
+ *
+ * Add promotions to a draft order.
+ */
 exports.addDraftOrderPromotionWorkflow = (0, workflows_sdk_1.createWorkflow)(exports.addDraftOrderPromotionWorkflowId, function (input) {
+    (0, locking_1.acquireLockStep)({
+        key: input.order_id,
+        timeout: 2,
+        ttl: 10,
+    });
     const order = (0, common_1.useRemoteQueryStep)({
         entry_point: "orders",
         fields: fields_1.draftOrderFieldsForRefreshSteps,
@@ -68,6 +94,9 @@ exports.addDraftOrderPromotionWorkflow = (0, workflows_sdk_1.createWorkflow)(exp
     order_1.createOrderChangeActionsWorkflow.runAsStep({
         input: orderChangeActionInput,
     });
+    (0, locking_1.releaseLockStep)({
+        key: input.order_id,
+    });
     return new workflows_sdk_1.WorkflowResponse((0, order_1.previewOrderChangeStep)(input.order_id));
 });
 //# sourceMappingURL=add-draft-order-promotions.js.map

package/dist/draft-order/workflows/add-draft-order-promotions.js.map

@@ -1 +1 @@
-{"version":3,"file":"add-draft-order-promotions.js","sourceRoot":"","sources":["../../../src/draft-order/workflows/add-draft-order-promotions.ts"],"names":[],"mappings":";;;AAAA,qDAIkC;AAClC,qEAK0C;AAE1C,yCAAiD;AACjD,uCAGoB;AACpB,sFAAmF;AACnF,sFAAkF;AAClF,4CAAiE;AACjE,uFAAwF;AAE3E,QAAA,gCAAgC,GAAG,2BAA2B,CAAA;AAO9D,QAAA,8BAA8B,GAAG,IAAA,8BAAc,EAC1D,wCAAgC,EAChC,UAAU,KAAwD;IAChE,MAAM,KAAK,GAAa,IAAA,2BAAkB,EAAC;QACzC,WAAW,EAAE,QAAQ;QACrB,MAAM,EAAE,wCAA+B;QACvC,SAAS,EAAE;YACT,EAAE,EAAE,KAAK,CAAC,QAAQ;SACnB;QACD,IAAI,EAAE,KAAK;QACX,sBAAsB,EAAE,IAAI;KAC7B,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAA;IAElC,MAAM,WAAW,GAAmB,IAAA,2BAAkB,EAAC;QACrD,WAAW,EAAE,cAAc;QAC3B,MAAM,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC;QACxB,SAAS,EAAE;YACT,OAAO,EAAE;gBACP,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,MAAM,EAAE,CAAC,yBAAiB,CAAC,OAAO,EAAE,yBAAiB,CAAC,SAAS,CAAC;aACjE;SACF;QACD,IAAI,EAAE,KAAK;KACZ,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC,CAAA;IAEzC,IAAA,0DAA4B,EAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAA;IAEpD,MAAM,UAAU,GAAmB,IAAA,2BAAkB,EAAC;QACpD,WAAW,EAAE,WAAW;QACxB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC;QAChC,SAAS,EAAE;YACT,OAAO,EAAE;gBACP,IAAI,EAAE,KAAK,CAAC,WAAW;aACxB;SACF;QACD,IAAI,EAAE,IAAI;KACX,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAA;IAEvC,IAAA,yDAA2B,EAAC;QAC1B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,UAAU;KACX,CAAC,CAAA;IAEF,sEAAoC,CAAC,SAAS,CAAC;QAC7C,KAAK,EAAE;YACL,KAAK;YACL,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,MAAM,EAAE,wBAAgB,CAAC,GAAG;SAC7B;KACF,CAAC,CAAA;IAEF,MAAM,sBAAsB,GAAG,IAAA,yBAAS,EACtC,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,EAClC,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,EAAE;QACrC,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;YACpC,MAAM,EAAE,wBAAgB,CAAC,aAAa;YACtC,SAAS,EAAE,iBAAiB;YAC5B,eAAe,EAAE,WAAW,CAAC,EAAE;YAC/B,YAAY,EAAE,SAAS,CAAC,EAAE;YAC1B,QAAQ,EAAE,KAAK,CAAC,EAAE;YAClB,OAAO,EAAE;gBACP,UAAU,EAAE,SAAS,CAAC,IAAI;aAC3B;SACF,CAAC,CAAC,CAAA;IACL,CAAC,CACF,CAAA;IAED,wCAAgC,CAAC,SAAS,CAAC;QACzC,KAAK,EAAE,sBAAsB;KAC9B,CAAC,CAAA;IAEF,OAAO,IAAI,gCAAgB,CAAC,IAAA,8BAAsB,EAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAA;AACrE,CAAC,CACF,CAAA"}
+{"version":3,"file":"add-draft-order-promotions.js","sourceRoot":"","sources":["../../../src/draft-order/workflows/add-draft-order-promotions.ts"],"names":[],"mappings":"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"}

package/dist/draft-order/workflows/add-draft-order-shipping-methods.d.ts

@@ -1,19 +1,43 @@
-import { BigNumberInput } from "@medusajs/types";
+import { BigNumberInput } from "@medusajs/framework/types";
 export declare const addDraftOrderShippingMethodsWorkflowId = "add-draft-order-shipping-methods";
-interface AddDraftOrderShippingMethodsWorkflowInput {
+/**
+ * The details of the shipping methods to add to a draft order.
+ */
+export interface AddDraftOrderShippingMethodsWorkflowInput {
     /**
      * The ID of the draft order to add the shipping methods to.
      */
     order_id: string;
     /**
-     * The ID of the shipping option to add the shipping methods from.
+     * The ID of the shipping option to add as a shipping method.
      */
     shipping_option_id: string;
     /**
-     * The custom amount to add the shipping methods with.
+     * The custom amount to add the shipping method with.
+     * If not specified, the shipping option's fixed or calculated price will be used.
      */
     custom_amount?: BigNumberInput | null;
 }
-export declare const addDraftOrderShippingMethodsWorkflow: import("@medusajs/framework/workflows-sdk").ReturnWorkflow<AddDraftOrderShippingMethodsWorkflowInput, import("@medusajs/types").OrderPreviewDTO, []>;
-export {};
+/**
+ * This workflow adds shipping methods to a draft order. It's used by the
+ * [Add Shipping Method to Draft Order Admin API Route](https://docs.medusajs.com/api/admin#draft-orders_postdraftordersideditshippingmethods).
+ *
+ * You can use this workflow within your customizations or your own custom workflows, allowing you to wrap custom logic around adding shipping methods to
+ * a draft order.
+ *
+ * @example
+ * const { result } = await addDraftOrderShippingMethodsWorkflow(container)
+ * .run({
+ *   input: {
+ *     order_id: "order_123",
+ *     shipping_option_id: "so_123",
+ *     custom_amount: 10
+ *   }
+ * })
+ *
+ * @summary
+ *
+ * Add shipping methods to a draft order.
+ */
+export declare const addDraftOrderShippingMethodsWorkflow: import("@medusajs/framework/workflows-sdk").ReturnWorkflow<AddDraftOrderShippingMethodsWorkflowInput, import("@medusajs/framework/types").OrderPreviewDTO, []>;
 //# sourceMappingURL=add-draft-order-shipping-methods.d.ts.map

package/dist/draft-order/workflows/add-draft-order-shipping-methods.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add-draft-order-shipping-methods.d.ts","sourceRoot":"","sources":["../../../src/draft-order/workflows/add-draft-order-shipping-methods.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,cAAc,EAA4B,MAAM,iBAAiB,CAAA;AAa1E,eAAO,MAAM,sCAAsC,qCACf,CAAA;AAEpC,UAAU,yCAAyC;IACjD;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,kBAAkB,EAAE,MAAM,CAAA;IAC1B;;OAEG;IACH,aAAa,CAAC,EAAE,cAAc,GAAG,IAAI,CAAA;CACtC;AAED,eAAO,MAAM,oCAAoC,sJA4IhD,CAAA"}
+{"version":3,"file":"add-draft-order-shipping-methods.d.ts","sourceRoot":"","sources":["../../../src/draft-order/workflows/add-draft-order-shipping-methods.ts"],"names":[],"mappings":"AAgBA,OAAO,EACL,cAAc,EAIf,MAAM,2BAA2B,CAAA;AAmClC,eAAO,MAAM,sCAAsC,qCACf,CAAA;AAEpC;;GAEG;AACH,MAAM,WAAW,yCAAyC;IACxD;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,kBAAkB,EAAE,MAAM,CAAA;IAC1B;;;OAGG;IACH,aAAa,CAAC,EAAE,cAAc,GAAG,IAAI,CAAA;CACtC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,oCAAoC,gKAoJhD,CAAA"}

package/dist/draft-order/workflows/add-draft-order-shipping-methods.js

@@ -10,8 +10,43 @@ const prepare_shipping_method_1 = require("../../order/utils/prepare-shipping-me
 const validate_draft_order_change_1 = require("../steps/validate-draft-order-change");
 const fields_1 = require("../utils/fields");
 const refresh_draft_order_adjustments_1 = require("./refresh-draft-order-adjustments");
+const locking_1 = require("../../locking");
+const validateShippingOptionStep = (0, workflows_sdk_1.createStep)("validate-shipping-option", async (data) => {
+    const shippingOption = data.shippingOptions[0];
+    const customAmount = data.input.custom_amount;
+    if (shippingOption.price_type === utils_1.ShippingOptionPriceType.CALCULATED &&
+        !(0, utils_1.isDefined)(customAmount)) {
+        throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, "Calculated shipping options are not currently supported on draft orders without a custom amount.");
+    }
+});
 exports.addDraftOrderShippingMethodsWorkflowId = "add-draft-order-shipping-methods";
+/**
+ * This workflow adds shipping methods to a draft order. It's used by the
+ * [Add Shipping Method to Draft Order Admin API Route](https://docs.medusajs.com/api/admin#draft-orders_postdraftordersideditshippingmethods).
+ *
+ * You can use this workflow within your customizations or your own custom workflows, allowing you to wrap custom logic around adding shipping methods to
+ * a draft order.
+ *
+ * @example
+ * const { result } = await addDraftOrderShippingMethodsWorkflow(container)
+ * .run({
+ *   input: {
+ *     order_id: "order_123",
+ *     shipping_option_id: "so_123",
+ *     custom_amount: 10
+ *   }
+ * })
+ *
+ * @summary
+ *
+ * Add shipping methods to a draft order.
+ */
 exports.addDraftOrderShippingMethodsWorkflow = (0, workflows_sdk_1.createWorkflow)(exports.addDraftOrderShippingMethodsWorkflowId, function (input) {
+    (0, locking_1.acquireLockStep)({
+        key: input.order_id,
+        timeout: 2,
+        ttl: 10,
+    });
     const order = (0, common_1.useRemoteQueryStep)({
         entry_point: "orders",
         fields: fields_1.draftOrderFieldsForRefreshSteps,
@@ -36,6 +71,7 @@ exports.addDraftOrderShippingMethodsWorkflow = (0, workflows_sdk_1.createWorkflo
         fields: [
             "id",
             "name",
+            "price_type",
             "calculated_price.calculated_amount",
             "calculated_price.is_calculated_price_tax_inclusive",
         ],
@@ -46,6 +82,7 @@ exports.addDraftOrderShippingMethodsWorkflow = (0, workflows_sdk_1.createWorkflo
             },
         },
     }).config({ name: "fetch-shipping-option" });
+    validateShippingOptionStep({ shippingOptions, input });
     const shippingMethodInput = (0, workflows_sdk_1.transform)({
         relatedEntity: { order_id: order.id },
         shippingOptions,
@@ -65,16 +102,7 @@ exports.addDraftOrderShippingMethodsWorkflow = (0, workflows_sdk_1.createWorkflo
             shipping_method_ids: shippingMethodIds,
         },
     });
-    const appliedPromoCodes = (0, workflows_sdk_1.transform)(order, (order) => {
-        const promotionLink = order.promotion_link;
-        if (!promotionLink) {
-            return [];
-        }
-        if (Array.isArray(promotionLink)) {
-            return promotionLink.map((promo) => promo.promotion.code);
-        }
-        return [promotionLink.promotion.code];
-    });
+    const appliedPromoCodes = (0, workflows_sdk_1.transform)(order, (order) => order.promotions?.map((promotion) => promotion.code) ?? []);
     // If any the order has any promo codes, then we need to refresh the adjustments.
     (0, workflows_sdk_1.when)(appliedPromoCodes, (appliedPromoCodes) => appliedPromoCodes.length > 0).then(() => {
         const refetchedOrder = (0, common_1.useRemoteQueryStep)({
@@ -96,7 +124,7 @@ exports.addDraftOrderShippingMethodsWorkflow = (0, workflows_sdk_1.createWorkflo
         order,
         shippingOptions,
         createdMethods,
-        customPrice: input.custom_amount, // Need to cast this to any otherwise the type becomes to complex.
+        customPrice: input.custom_amount, // Need to cast this to any otherwise the type becomes too complex.
         orderChange,
     }, ({ shippingOptions, order, createdMethods, customPrice, orderChange, }) => {
         const shippingOption = shippingOptions[0];
@@ -114,6 +142,9 @@ exports.addDraftOrderShippingMethodsWorkflow = (0, workflows_sdk_1.createWorkflo
     order_1.createOrderChangeActionsWorkflow.runAsStep({
         input: [orderChangeActionInput],
     });
+    (0, locking_1.releaseLockStep)({
+        key: input.order_id,
+    });
     return new workflows_sdk_1.WorkflowResponse((0, order_1.previewOrderChangeStep)(order.id));
 });
 //# sourceMappingURL=add-draft-order-shipping-methods.js.map

package/dist/draft-order/workflows/add-draft-order-shipping-methods.js.map

@@ -1 +1 @@
-{"version":3,"file":"add-draft-order-shipping-methods.js","sourceRoot":"","sources":["../../../src/draft-order/workflows/add-draft-order-shipping-methods.ts"],"names":[],"mappings":";;;AAAA,qDAIkC;AAClC,qEAM0C;AAE1C,yCAAiD;AACjD,uCAIoB;AACpB,mGAA4F;AAC5F,uFAAiF;AACjF,sFAAmF;AACnF,4CAAiE;AACjE,uFAAwF;AAE3E,QAAA,sCAAsC,GACjD,kCAAkC,CAAA;AAiBvB,QAAA,oCAAoC,GAAG,IAAA,8BAAc,EAChE,8CAAsC,EACtC,UAAU,KAA8D;IACtE,MAAM,KAAK,GAAa,IAAA,2BAAkB,EAAC;QACzC,WAAW,EAAE,QAAQ;QACrB,MAAM,EAAE,wCAA+B;QACvC,SAAS,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,QAAQ,EAAE;QACjC,IAAI,EAAE,KAAK;QACX,sBAAsB,EAAE,IAAI;KAC7B,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAA;IAElC,MAAM,WAAW,GAAmB,IAAA,2BAAkB,EAAC;QACrD,WAAW,EAAE,cAAc;QAC3B,MAAM,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC;QACnC,SAAS,EAAE;YACT,OAAO,EAAE;gBACP,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,MAAM,EAAE,CAAC,yBAAiB,CAAC,OAAO,EAAE,yBAAiB,CAAC,SAAS,CAAC;aACjE;SACF;QACD,IAAI,EAAE,KAAK;KACZ,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC,CAAA;IAEzC,IAAA,0DAA4B,EAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAA;IAEpD,MAAM,eAAe,GAAG,IAAA,2BAAkB,EAAC;QACzC,WAAW,EAAE,iBAAiB;QAC9B,MAAM,EAAE;YACN,IAAI;YACJ,MAAM;YACN,oCAAoC;YACpC,oDAAoD;SACrD;QACD,SAAS,EAAE;YACT,EAAE,EAAE,KAAK,CAAC,kBAAkB;YAC5B,gBAAgB,EAAE;gBAChB,OAAO,EAAE,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE;aAChD;SACF;KACF,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC,CAAA;IAE5C,MAAM,mBAAmB,GAAG,IAAA,yBAAS,EACnC;QACE,aAAa,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,EAAE;QACrC,eAAe;QACf,WAAW,EAAE,KAAK,CAAC,aAAoB,EAAE,kEAAkE;QAC3G,WAAW;QACX,KAAK;KACN,EACD,IAAA,+CAAqB,GAAE,CACxB,CAAA;IAED,MAAM,cAAc,GAAG,IAAA,0DAA0B,EAAC;QAChD,gBAAgB,EAAE,CAAC,mBAAmB,CAAC;KACxC,CAAC,CAAA;IAEF,MAAM,iBAAiB,GAAG,IAAA,yBAAS,EAAC,cAAc,EAAE,CAAC,cAAc,EAAE,EAAE;QACrE,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC9C,CAAC,CAAC,CAAA;IAEF,mCAA2B,CAAC,SAAS,CAAC;QACpC,KAAK,EAAE;YACL,QAAQ,EAAE,KAAK,CAAC,EAAE;YAClB,mBAAmB,EAAE,iBAAiB;SACvC;KACF,CAAC,CAAA;IAEF,MAAM,iBAAiB,GAAG,IAAA,yBAAS,EAAC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE;QACnD,MAAM,aAAa,GAAI,KAAa,CAAC,cAAc,CAAA;QAEnD,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO,EAAE,CAAA;QACX,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;YACjC,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;QAC3D,CAAC;QAED,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;IACvC,CAAC,CAAC,CAAA;IAEF,iFAAiF;IACjF,IAAA,oBAAI,EACF,iBAAiB,EACjB,CAAC,iBAAiB,EAAE,EAAE,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,CACpD,CAAC,IAAI,CAAC,GAAG,EAAE;QACV,MAAM,cAAc,GAAG,IAAA,2BAAkB,EAAC;YACxC,WAAW,EAAE,QAAQ;YACrB,MAAM,EAAE,wCAA+B;YACvC,SAAS,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,QAAQ,EAAE;YACjC,IAAI,EAAE,KAAK;YACX,sBAAsB,EAAE,IAAI;SAC7B,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC,CAAA;QAE5C,sEAAoC,CAAC,SAAS,CAAC;YAC7C,KAAK,EAAE;gBACL,KAAK,EAAE,cAAc;gBACrB,WAAW,EAAE,iBAAiB;gBAC9B,MAAM,EAAE,wBAAgB,CAAC,OAAO;aACjC;SACF,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,MAAM,sBAAsB,GAAG,IAAA,yBAAS,EACtC;QACE,KAAK;QACL,eAAe;QACf,cAAc;QACd,WAAW,EAAE,KAAK,CAAC,aAAoB,EAAE,kEAAkE;QAC3G,WAAW;KACZ,EACD,CAAC,EACC,eAAe,EACf,KAAK,EACL,cAAc,EACd,WAAW,EACX,WAAW,GACZ,EAAE,EAAE;QACH,MAAM,cAAc,GAAG,eAAe,CAAC,CAAC,CAAC,CAAA;QACzC,MAAM,aAAa,GAAG,cAAc,CAAC,CAAC,CAAC,CAAA;QACvC,MAAM,WAAW,GACf,WAAW,IAAI,cAAc,CAAC,gBAAgB,CAAC,iBAAiB,CAAA;QAElE,OAAO;YACL,MAAM,EAAE,wBAAgB,CAAC,YAAY;YACrC,SAAS,EAAE,uBAAuB;YAClC,eAAe,EAAE,WAAW,CAAC,EAAE;YAC/B,YAAY,EAAE,aAAa,CAAC,EAAE;YAC9B,MAAM,EAAE,WAAW;YACnB,QAAQ,EAAE,KAAK,CAAC,EAAE;SACnB,CAAA;IACH,CAAC,CACF,CAAA;IAED,wCAAgC,CAAC,SAAS,CAAC;QACzC,KAAK,EAAE,CAAC,sBAAsB,CAAC;KAChC,CAAC,CAAA;IAEF,OAAO,IAAI,gCAAgB,CAAC,IAAA,8BAAsB,EAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAA;AAC/D,CAAC,CACF,CAAA"}
+{"version":3,"file":"add-draft-order-shipping-methods.js","sourceRoot":"","sources":["../../../src/draft-order/workflows/add-draft-order-shipping-methods.ts"],"names":[],"mappings":"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"}

package/dist/draft-order/workflows/begin-draft-order-edit.d.ts

@@ -1,4 +1,25 @@
-import { OrderWorkflow } from "@medusajs/types";
+import type { OrderWorkflow } from "@medusajs/framework/types";
 export declare const beginDraftOrderEditWorkflowId = "begin-draft-order-edit";
-export declare const beginDraftOrderEditWorkflow: import("@medusajs/framework/workflows-sdk").ReturnWorkflow<OrderWorkflow.BeginorderEditWorkflowInput, import("@medusajs/types").OrderChangeDTO, []>;
+/**
+ * This workflow begins a draft order edit. It's used by the
+ * [Create Draft Order Edit Admin API Route](https://docs.medusajs.com/api/admin#draft-orders_postdraftordersidedit).
+ *
+ * The draft order edit can later be requested using {@link requestDraftOrderEditWorkflow} or confirmed using {@link confirmDraftOrderEditWorkflow}.
+ *
+ * You can use this workflow within your customizations or your own custom workflows, allowing you to wrap custom logic around
+ * creating a draft order edit request.
+ *
+ * @example
+ * const { result } = await beginDraftOrderEditWorkflow(container)
+ * .run({
+ *   input: {
+ *     order_id: "order_123",
+ *   }
+ * })
+ *
+ * @summary
+ *
+ * Create a draft order edit request.
+ */
+export declare const beginDraftOrderEditWorkflow: import("@medusajs/framework/workflows-sdk").ReturnWorkflow<OrderWorkflow.BeginorderEditWorkflowInput, import("@medusajs/framework/types").OrderPreviewDTO, []>;
 //# sourceMappingURL=begin-draft-order-edit.d.ts.map

package/dist/draft-order/workflows/begin-draft-order-edit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"begin-draft-order-edit.d.ts","sourceRoot":"","sources":["../../../src/draft-order/workflows/begin-draft-order-edit.ts"],"names":[],"mappings":"AAMA,OAAO,EAAY,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAKzD,eAAO,MAAM,6BAA6B,2BAA2B,CAAA;AAErE,eAAO,MAAM,2BAA2B,qJAyBvC,CAAA"}
+{"version":3,"file":"begin-draft-order-edit.d.ts","sourceRoot":"","sources":["../../../src/draft-order/workflows/begin-draft-order-edit.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAY,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAMxE,eAAO,MAAM,6BAA6B,2BAA2B,CAAA;AAErE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,2BAA2B,gKAqCvC,CAAA"}

package/dist/draft-order/workflows/begin-draft-order-edit.js

@@ -5,8 +5,35 @@ const workflows_sdk_1 = require("@medusajs/framework/workflows-sdk");
 const common_1 = require("../../common");
 const order_1 = require("../../order");
 const steps_1 = require("../steps");
+const locking_1 = require("../../locking");
 exports.beginDraftOrderEditWorkflowId = "begin-draft-order-edit";
+/**
+ * This workflow begins a draft order edit. It's used by the
+ * [Create Draft Order Edit Admin API Route](https://docs.medusajs.com/api/admin#draft-orders_postdraftordersidedit).
+ *
+ * The draft order edit can later be requested using {@link requestDraftOrderEditWorkflow} or confirmed using {@link confirmDraftOrderEditWorkflow}.
+ *
+ * You can use this workflow within your customizations or your own custom workflows, allowing you to wrap custom logic around
+ * creating a draft order edit request.
+ *
+ * @example
+ * const { result } = await beginDraftOrderEditWorkflow(container)
+ * .run({
+ *   input: {
+ *     order_id: "order_123",
+ *   }
+ * })
+ *
+ * @summary
+ *
+ * Create a draft order edit request.
+ */
 exports.beginDraftOrderEditWorkflow = (0, workflows_sdk_1.createWorkflow)(exports.beginDraftOrderEditWorkflowId, function (input) {
+    (0, locking_1.acquireLockStep)({
+        key: input.order_id,
+        timeout: 2,
+        ttl: 10,
+    });
     const order = (0, common_1.useRemoteQueryStep)({
         entry_point: "orders",
         fields: ["id", "status", "is_draft_order"],
@@ -24,6 +51,10 @@ exports.beginDraftOrderEditWorkflow = (0, workflows_sdk_1.createWorkflow)(export
             internal_note: input.internal_note,
         };
     });
-    return new workflows_sdk_1.WorkflowResponse((0, order_1.createOrderChangeStep)(orderChangeInput));
+    (0, order_1.createOrderChangeStep)(orderChangeInput);
+    (0, locking_1.releaseLockStep)({
+        key: input.order_id,
+    });
+    return new workflows_sdk_1.WorkflowResponse((0, order_1.previewOrderChangeStep)(input.order_id));
 });
 //# sourceMappingURL=begin-draft-order-edit.js.map

package/dist/draft-order/workflows/begin-draft-order-edit.js.map

@@ -1 +1 @@
-{"version":3,"file":"begin-draft-order-edit.js","sourceRoot":"","sources":["../../../src/draft-order/workflows/begin-draft-order-edit.ts"],"names":[],"mappings":";;;AAAA,qEAK0C;AAE1C,yCAAiD;AACjD,uCAAmD;AACnD,oCAAiD;AAEpC,QAAA,6BAA6B,GAAG,wBAAwB,CAAA;AAExD,QAAA,2BAA2B,GAAG,IAAA,8BAAc,EACvD,qCAA6B,EAC7B,UAAU,KAA8D;IACtE,MAAM,KAAK,GAAa,IAAA,2BAAkB,EAAC;QACzC,WAAW,EAAE,QAAQ;QACrB,MAAM,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,gBAAgB,CAAC;QAC1C,SAAS,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,QAAQ,EAAE;QACjC,IAAI,EAAE,KAAK;QACX,sBAAsB,EAAE,IAAI;KAC7B,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAA;IAElC,IAAA,8BAAsB,EAAC,EAAE,KAAK,EAAE,CAAC,CAAA;IAEjC,MAAM,gBAAgB,GAAG,IAAA,yBAAS,EAAC,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;QAC1D,OAAO;YACL,WAAW,EAAE,MAAe;YAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,aAAa,EAAE,KAAK,CAAC,aAAa;SACnC,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,OAAO,IAAI,gCAAgB,CAAC,IAAA,6BAAqB,EAAC,gBAAgB,CAAC,CAAC,CAAA;AACtE,CAAC,CACF,CAAA"}
+{"version":3,"file":"begin-draft-order-edit.js","sourceRoot":"","sources":["../../../src/draft-order/workflows/begin-draft-order-edit.ts"],"names":[],"mappings":";;;AAAA,qEAK0C;AAE1C,yCAAiD;AACjD,uCAA2E;AAC3E,oCAAiD;AACjD,2CAAgE;AAEnD,QAAA,6BAA6B,GAAG,wBAAwB,CAAA;AAErE;;;;;;;;;;;;;;;;;;;;GAoBG;AACU,QAAA,2BAA2B,GAAG,IAAA,8BAAc,EACvD,qCAA6B,EAC7B,UAAU,KAA8D;IACtE,IAAA,yBAAe,EAAC;QACd,GAAG,EAAE,KAAK,CAAC,QAAQ;QACnB,OAAO,EAAE,CAAC;QACV,GAAG,EAAE,EAAE;KACR,CAAC,CAAA;IAEF,MAAM,KAAK,GAAa,IAAA,2BAAkB,EAAC;QACzC,WAAW,EAAE,QAAQ;QACrB,MAAM,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,gBAAgB,CAAC;QAC1C,SAAS,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,QAAQ,EAAE;QACjC,IAAI,EAAE,KAAK;QACX,sBAAsB,EAAE,IAAI;KAC7B,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAA;IAElC,IAAA,8BAAsB,EAAC,EAAE,KAAK,EAAE,CAAC,CAAA;IAEjC,MAAM,gBAAgB,GAAG,IAAA,yBAAS,EAAC,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;QAC1D,OAAO;YACL,WAAW,EAAE,MAAe;YAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,aAAa,EAAE,KAAK,CAAC,aAAa;SACnC,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,IAAA,6BAAqB,EAAC,gBAAgB,CAAC,CAAA;IAEvC,IAAA,yBAAe,EAAC;QACd,GAAG,EAAE,KAAK,CAAC,QAAQ;KACpB,CAAC,CAAA;IAEF,OAAO,IAAI,gCAAgB,CAAC,IAAA,8BAAsB,EAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAA;AACrE,CAAC,CACF,CAAA"}