fix(core-flows): export order-related utility workflows (#12380)

.changeset/good-kiwis-applaud.md

@@ -0,0 +1,5 @@
+---
+"@medusajs/core-flows": patch
+---
+
+fix(core-flows): export order-related workflows

packages/core/core-flows/src/draft-order/workflows/convert-draft-order.ts

@@ -14,7 +14,7 @@ import { IOrderModuleService, OrderDTO } from "@medusajs/types"
 import { emitEventStep, useRemoteQueryStep } from "../../common"
 import { validateDraftOrderStep } from "../steps/validate-draft-order"
 
-const convertDraftOrderWorkflowId = "convert-draft-order"
+export const convertDraftOrderWorkflowId = "convert-draft-order"
 
 /**
  * The details of the draft order to convert to an order.

packages/core/core-flows/src/order/index.ts

@@ -1,3 +1,2 @@
 export * from "./steps"
-export * from "./workflows"
+export * from "./workflows"
-export * from "./utils/fetch-shipping-option"

packages/core/core-flows/src/order/workflows/claim/create-claim-shipping-method.ts

@@ -23,7 +23,7 @@ import {
 import { prepareShippingMethod } from "../../utils/prepare-shipping-method"
 import { createOrderChangeActionsWorkflow } from "../create-order-change-actions"
 import { updateOrderTaxLinesWorkflow } from "../update-tax-lines"
-import { fetchShippingOptionForOrderWorkflow } from "../../utils/fetch-shipping-option"
+import { fetchShippingOptionForOrderWorkflow } from "../fetch-shipping-option"
 
 /**
  * The data to validate that a shipping method can be created for a claim.

packages/core/core-flows/src/order/workflows/claim/refresh-shipping.ts

@@ -7,7 +7,7 @@ import {
   when,
 } from "@medusajs/framework/workflows-sdk"
 
-import { maybeRefreshShippingMethodsWorkflow } from "../../utils/maybe-refresh-shipping-methods"
+import { maybeRefreshShippingMethodsWorkflow } from "../maybe-refresh-shipping-methods"
 import { useQueryGraphStep } from "../../../common"
 
 /**

packages/core/core-flows/src/order/workflows/exchange/create-exchange-shipping-method.ts

@@ -23,7 +23,7 @@ import {
 import { prepareShippingMethod } from "../../utils/prepare-shipping-method"
 import { createOrderChangeActionsWorkflow } from "../create-order-change-actions"
 import { updateOrderTaxLinesWorkflow } from "../update-tax-lines"
-import { fetchShippingOptionForOrderWorkflow } from "../../utils/fetch-shipping-option"
+import { fetchShippingOptionForOrderWorkflow } from "../fetch-shipping-option"
 
 /**
  * The data to validate that a shipping method can be created for an exchange.

packages/core/core-flows/src/order/workflows/exchange/refresh-shipping.ts

@@ -8,7 +8,7 @@ import {
   when,
 } from "@medusajs/framework/workflows-sdk"
 
-import { maybeRefreshShippingMethodsWorkflow } from "../../utils/maybe-refresh-shipping-methods"
+import { maybeRefreshShippingMethodsWorkflow } from "../maybe-refresh-shipping-methods"
 import { useQueryGraphStep } from "../../../common"
 
 /**

packages/core/core-flows/src/order/workflows/fetch-shipping-option.ts

@@ -46,7 +46,7 @@ const COMMON_OPTIONS_FIELDS = [
 /**
  * The data to create a shipping method for an order edit.
  */
-export type FetchShippingOptionForOrderWorkflowInput = {
+export type FetchShippingOptionForOrderWorkflowInput = AdditionalData & {
   /**
    * The ID of the shipping option to fetch.
    */
@@ -165,7 +165,7 @@ export const fetchShippingOptionsForOrderWorkflowId = "fetch-shipping-option"
  */
 export const fetchShippingOptionForOrderWorkflow = createWorkflow(
   fetchShippingOptionsForOrderWorkflowId,
-  function (input: FetchShippingOptionForOrderWorkflowInput & AdditionalData) {
+  function (input: FetchShippingOptionForOrderWorkflowInput) {
     const initialOption = useRemoteQueryStep({
       entry_point: "shipping_option",
       variables: { id: input.shipping_option_id },

packages/core/core-flows/src/order/workflows/index.ts

@@ -30,6 +30,7 @@ export * from "./decline-order-change"
 export * from "./delete-order-change"
 export * from "./delete-order-change-actions"
 export * from "./delete-order-payment-collection"
+export * from "./fetch-shipping-option"
 export * from "./exchange/begin-order-exchange"
 export * from "./exchange/cancel-begin-order-exchange"
 export * from "./exchange/cancel-exchange"
@@ -45,6 +46,7 @@ export * from "./get-order-detail"
 export * from "./get-orders-list"
 export * from "./mark-order-fulfillment-as-delivered"
 export * from "./mark-payment-collection-as-paid"
+export * from "./maybe-refresh-shipping-methods"
 export * from "./order-edit/begin-order-edit"
 export * from "./order-edit/cancel-begin-order-edit"
 export * from "./order-edit/confirm-order-edit-request"

packages/core/core-flows/src/order/workflows/maybe-refresh-shipping-methods.ts

@@ -68,8 +68,34 @@ export type MaybeRefreshShippingMethodsWorkflowInput = {
 export const maybeRefreshShippingMethodsWorkflowId =
   "maybe-refresh-shipping-methods"
 /**
- * This workflows refreshes shipping method an order (used in RMA flows).
+ * This workflows refreshes shipping method prices of an order and its changes. It's used in Return Merchandise Authorization (RMA) flows. It's used
- * The shipping method and the action is updated if the shipping option is calculated.
+ * by other workflows, such as {@link refreshExchangeShippingWorkflow}.
+ * 
+ * You can use this workflow within your customizations or your own custom workflows, allowing you to wrap custom logic around
+ * refreshing shipping methods in your custom flows.
+ * 
+ * @example
+ * const { result } = await maybeRefreshShippingMethodsWorkflow(container)
+ * .run({
+ *   input: {
+ *     shipping_method_id: "shipping_method_123",
+ *     order_id: "order_123",
+ *     action_id: "orchact_123",
+ *     context: {
+ *       return_id: "ret_123",
+ *       return_items: [
+ *         {
+ *            id: "orli_123",
+ *            quantity: 1,
+ *         }
+ *       ]
+ *     }
+ *  }
+ * })
+ * 
+ * @summary
+ * 
+ * Refreshes the shipping method prices of an order and its changes.
  */
 export const maybeRefreshShippingMethodsWorkflow = createWorkflow(
   maybeRefreshShippingMethodsWorkflowId,

packages/core/core-flows/src/order/workflows/return/create-return-shipping-method.ts

@@ -22,7 +22,7 @@ import {
 import { prepareShippingMethod } from "../../utils/prepare-shipping-method"
 import { createOrderChangeActionsWorkflow } from "../create-order-change-actions"
 import { updateOrderTaxLinesWorkflow } from "../update-tax-lines"
-import { fetchShippingOptionForOrderWorkflow } from "../../utils/fetch-shipping-option"
+import { fetchShippingOptionForOrderWorkflow } from "../fetch-shipping-option"
 
 /**
  * The data to validate that a shipping method can be created for a return.

packages/core/core-flows/src/order/workflows/return/refresh-shipping.ts

@@ -8,7 +8,7 @@ import {
   when,
 } from "@medusajs/framework/workflows-sdk"
 
-import { maybeRefreshShippingMethodsWorkflow } from "../../utils/maybe-refresh-shipping-methods"
+import { maybeRefreshShippingMethodsWorkflow } from "../maybe-refresh-shipping-methods"
 import { useQueryGraphStep } from "../../../common"
 
 /**

packages/core/core-flows/src/payment/workflows/process-payment.ts

@@ -9,7 +9,7 @@ import { capturePaymentWorkflow } from "./capture-payment"
 /**
  * The data to process a payment from a webhook action.
  */
-interface ProcessPaymentWorkflowInput extends WebhookActionResult {}
+export interface ProcessPaymentWorkflowInput extends WebhookActionResult {}
 
 export const processPaymentWorkflowId = "process-payment-workflow"
 /**

packages/core/types/src/workflow/order/request-transfer.ts

@@ -1,8 +1,24 @@
 export interface RequestOrderTransferWorkflowInput {
+  /**
+   * The ID of the order to transfer.
+   */
   order_id: string
+  /**
+   * The ID of the customer to transfer the order to.
+   */
   customer_id: string
+  /**
+   * The ID of the logged in user requesting the transfer.
+   * Can be an admin user or a customer.
+   */
   logged_in_user: string
 
+  /**
+   * Details of the transfer request.
+   */
   description?: string
+  /**
+   * A note viewed by admin users only.
+   */
   internal_note?: string
 }

packages/core/utils/src/core-flows/events.ts

@@ -38,7 +38,7 @@ export const CartWorkflowEvents = {
   CUSTOMER_UPDATED: "cart.customer_updated",
   /**
    * Emitted when the cart's region is updated. This
-   * event is emitted alongside the {@link CartWorkflowEvents.UPDATED} event.
+   * event is emitted alongside the `cart.updated` event.
    * 
    * @eventPayload
    * ```ts