From f659c6d8bd90c6e0036ae5645c217723b7b5cb47 Mon Sep 17 00:00:00 2001
From: Shahed Nasser <shahednasser@gmail.com>
Date: Fri, 9 Aug 2024 10:08:27 +0300
Subject: [PATCH] chore(core-flows): [10] export types and types, add basic
 TSDocs (#8520)

* chore(core-flows): [10] export types and types, add basic TSDocs

* fix overlapping names

* fix overlapping name
---
 .../core/core-flows/src/order/steps/archive-orders.ts     | 5 ++++-
 .../core/core-flows/src/order/steps/cancel-fulfillment.ts | 7 ++++---
 .../core-flows/src/order/steps/cancel-order-change.ts     | 3 +++
 packages/core/core-flows/src/order/steps/cancel-orders.ts | 7 +++++--
 .../core/core-flows/src/order/steps/complete-orders.ts    | 5 ++++-
 .../core-flows/src/order/steps/confirm-order-changes.ts   | 5 ++++-
 .../core/core-flows/src/order/steps/create-line-items.ts  | 7 +++++--
 .../src/order/steps/create-order-change-actions.ts        | 3 +++
 .../core-flows/src/order/steps/create-order-change.ts     | 3 +++
 .../src/order/steps/create-order-shipping-methods.ts      | 7 +++++--
 packages/core/core-flows/src/order/steps/create-orders.ts | 7 ++++---
 .../core-flows/src/order/steps/decline-order-change.ts    | 3 +++
 .../core/core-flows/src/order/steps/delete-line-items.ts  | 7 +++++--
 .../src/order/steps/delete-order-change-actions.ts        | 3 +++
 .../core-flows/src/order/steps/delete-order-changes.ts    | 3 +++
 .../src/order/steps/delete-order-shipping-methods.ts      | 8 ++++++--
 .../core/core-flows/src/order/steps/get-item-tax-lines.ts | 7 +++++--
 .../core-flows/src/order/steps/preview-order-change.ts    | 3 +++
 .../core-flows/src/order/steps/register-fulfillment.ts    | 7 ++++---
 .../core/core-flows/src/order/steps/register-shipment.ts  | 7 ++++---
 .../core-flows/src/order/steps/set-tax-lines-for-items.ts | 7 +++++--
 .../src/order/steps/update-order-change-actions.ts        | 3 +++
 .../core-flows/src/order/steps/update-order-exchanges.ts  | 3 +++
 .../core-flows/src/order/steps/update-shipping-methods.ts | 3 +++
 .../core/core-flows/src/order/steps/update-tax-lines.ts   | 7 +++++--
 25 files changed, 99 insertions(+), 31 deletions(-)

diff --git a/packages/core/core-flows/src/order/steps/archive-orders.ts b/packages/core/core-flows/src/order/steps/archive-orders.ts
index c2aef08585..e2c95ddf2e 100644
--- a/packages/core/core-flows/src/order/steps/archive-orders.ts
+++ b/packages/core/core-flows/src/order/steps/archive-orders.ts
@@ -2,11 +2,14 @@ import { IOrderModuleService } from "@medusajs/types"
 import { ModuleRegistrationName } from "@medusajs/utils"
 import { createStep, StepResponse } from "@medusajs/workflows-sdk"
 
-type ArchiveOrdersStepInput = {
+export type ArchiveOrdersStepInput = {
   orderIds: string[]
 }
 
 export const archiveOrdersStepId = "archive-orders"
+/**
+ * This step archives one or more orders.
+ */
 export const archiveOrdersStep = createStep(
   archiveOrdersStepId,
   async (data: ArchiveOrdersStepInput, { container }) => {
diff --git a/packages/core/core-flows/src/order/steps/cancel-fulfillment.ts b/packages/core/core-flows/src/order/steps/cancel-fulfillment.ts
index 1e0f202ae6..aa9c1156bc 100644
--- a/packages/core/core-flows/src/order/steps/cancel-fulfillment.ts
+++ b/packages/core/core-flows/src/order/steps/cancel-fulfillment.ts
@@ -2,12 +2,13 @@ import { CancelOrderFulfillmentDTO, IOrderModuleService } from "@medusajs/types"
 import { ModuleRegistrationName } from "@medusajs/utils"
 import { StepResponse, createStep } from "@medusajs/workflows-sdk"
 
-type CancelOrderFulfillmentStepInput = CancelOrderFulfillmentDTO
-
 export const cancelOrderFulfillmentStepId = "cancel-order-fulfillment"
+/**
+ * This step cancels an order's fulfillment.
+ */
 export const cancelOrderFulfillmentStep = createStep(
   cancelOrderFulfillmentStepId,
-  async (data: CancelOrderFulfillmentStepInput, { container }) => {
+  async (data: CancelOrderFulfillmentDTO, { container }) => {
     const service = container.resolve<IOrderModuleService>(
       ModuleRegistrationName.ORDER
     )
diff --git a/packages/core/core-flows/src/order/steps/cancel-order-change.ts b/packages/core/core-flows/src/order/steps/cancel-order-change.ts
index 72c6a54a0e..4a4a5a21c7 100644
--- a/packages/core/core-flows/src/order/steps/cancel-order-change.ts
+++ b/packages/core/core-flows/src/order/steps/cancel-order-change.ts
@@ -11,6 +11,9 @@ import {
 import { StepResponse, createStep } from "@medusajs/workflows-sdk"
 
 export const cancelOrderChangeStepId = "cancel-order-change"
+/**
+ * This step cancels an order change.
+ */
 export const cancelOrderChangeStep = createStep(
   cancelOrderChangeStepId,
   async (data: CancelOrderChangeDTO, { container }) => {
diff --git a/packages/core/core-flows/src/order/steps/cancel-orders.ts b/packages/core/core-flows/src/order/steps/cancel-orders.ts
index b9d728d778..5b52aca37e 100644
--- a/packages/core/core-flows/src/order/steps/cancel-orders.ts
+++ b/packages/core/core-flows/src/order/steps/cancel-orders.ts
@@ -2,14 +2,17 @@ import { IOrderModuleService } from "@medusajs/types"
 import { ModuleRegistrationName } from "@medusajs/utils"
 import { createStep, StepResponse } from "@medusajs/workflows-sdk"
 
-type CompleteOrdersStepInput = {
+export type CancelOrdersStepInput = {
   orderIds: string[]
 }
 
 export const cancelOrdersStepId = "cancel-orders"
+/**
+ * This step cancels one or more orders.
+ */
 export const cancelOrdersStep = createStep(
   cancelOrdersStepId,
-  async (data: CompleteOrdersStepInput, { container }) => {
+  async (data: CancelOrdersStepInput, { container }) => {
     const service = container.resolve<IOrderModuleService>(
       ModuleRegistrationName.ORDER
     )
diff --git a/packages/core/core-flows/src/order/steps/complete-orders.ts b/packages/core/core-flows/src/order/steps/complete-orders.ts
index 9dd159c2e5..0f1d086350 100644
--- a/packages/core/core-flows/src/order/steps/complete-orders.ts
+++ b/packages/core/core-flows/src/order/steps/complete-orders.ts
@@ -2,11 +2,14 @@ import { IOrderModuleService } from "@medusajs/types"
 import { ModuleRegistrationName } from "@medusajs/utils"
 import { createStep, StepResponse } from "@medusajs/workflows-sdk"
 
-type CompleteOrdersStepInput = {
+export type CompleteOrdersStepInput = {
   orderIds: string[]
 }
 
 export const completeOrdersStepId = "complete-orders"
+/**
+ * This step completes one or more orders.
+ */
 export const completeOrdersStep = createStep(
   completeOrdersStepId,
   async (data: CompleteOrdersStepInput, { container }) => {
diff --git a/packages/core/core-flows/src/order/steps/confirm-order-changes.ts b/packages/core/core-flows/src/order/steps/confirm-order-changes.ts
index 69125cc1db..993731100e 100644
--- a/packages/core/core-flows/src/order/steps/confirm-order-changes.ts
+++ b/packages/core/core-flows/src/order/steps/confirm-order-changes.ts
@@ -2,11 +2,14 @@ import { OrderChangeDTO } from "@medusajs/types"
 import { ModuleRegistrationName } from "@medusajs/utils"
 import { createStep, StepResponse } from "@medusajs/workflows-sdk"
 
-type ConfirmOrderChangesInput = {
+export type ConfirmOrderChangesInput = {
   orderId: string
   changes: OrderChangeDTO[]
 }
 
+/**
+ * This step confirms changes of an order.
+ */
 export const confirmOrderChanges = createStep(
   "confirm-order-changes",
   async (input: ConfirmOrderChangesInput, { container }) => {
diff --git a/packages/core/core-flows/src/order/steps/create-line-items.ts b/packages/core/core-flows/src/order/steps/create-line-items.ts
index cbc42061a3..5d3d1a16ed 100644
--- a/packages/core/core-flows/src/order/steps/create-line-items.ts
+++ b/packages/core/core-flows/src/order/steps/create-line-items.ts
@@ -2,14 +2,17 @@ import { CreateOrderLineItemDTO } from "@medusajs/types"
 import { ModuleRegistrationName } from "@medusajs/utils"
 import { StepResponse, createStep } from "@medusajs/workflows-sdk"
 
-interface StepInput {
+export interface CreateOrderLineItemsStepInput {
   items: CreateOrderLineItemDTO[]
 }
 
 export const createOrderLineItemsStepId = "create-order-line-items-step"
+/**
+ * This step creates order line items.
+ */
 export const createOrderLineItemsStep = createStep(
   createOrderLineItemsStepId,
-  async (input: StepInput, { container }) => {
+  async (input: CreateOrderLineItemsStepInput, { container }) => {
     const orderModule = container.resolve(ModuleRegistrationName.ORDER)
 
     const createdItems = input.items.length
diff --git a/packages/core/core-flows/src/order/steps/create-order-change-actions.ts b/packages/core/core-flows/src/order/steps/create-order-change-actions.ts
index c0a4292f09..fc342454b2 100644
--- a/packages/core/core-flows/src/order/steps/create-order-change-actions.ts
+++ b/packages/core/core-flows/src/order/steps/create-order-change-actions.ts
@@ -6,6 +6,9 @@ import { ModuleRegistrationName } from "@medusajs/utils"
 import { StepResponse, createStep } from "@medusajs/workflows-sdk"
 
 export const createOrderChangeActionsStepId = "create-order-change-actions"
+/**
+ * This step creates order change actions.
+ */
 export const createOrderChangeActionsStep = createStep(
   createOrderChangeActionsStepId,
   async (data: CreateOrderChangeActionDTO[], { container }) => {
diff --git a/packages/core/core-flows/src/order/steps/create-order-change.ts b/packages/core/core-flows/src/order/steps/create-order-change.ts
index 0b49372097..41f3829100 100644
--- a/packages/core/core-flows/src/order/steps/create-order-change.ts
+++ b/packages/core/core-flows/src/order/steps/create-order-change.ts
@@ -3,6 +3,9 @@ import { ModuleRegistrationName } from "@medusajs/utils"
 import { StepResponse, createStep } from "@medusajs/workflows-sdk"
 
 export const createOrderChangeStepId = "create-order-change"
+/**
+ * This step creates an order change.
+ */
 export const createOrderChangeStep = createStep(
   createOrderChangeStepId,
   async (data: CreateOrderChangeDTO, { container }) => {
diff --git a/packages/core/core-flows/src/order/steps/create-order-shipping-methods.ts b/packages/core/core-flows/src/order/steps/create-order-shipping-methods.ts
index 2394761512..1640382104 100644
--- a/packages/core/core-flows/src/order/steps/create-order-shipping-methods.ts
+++ b/packages/core/core-flows/src/order/steps/create-order-shipping-methods.ts
@@ -5,13 +5,16 @@ import {
 import { ModuleRegistrationName } from "@medusajs/utils"
 import { createStep, StepResponse } from "@medusajs/workflows-sdk"
 
-interface StepInput {
+export interface CreateOrderShippingMethodsStepInput {
   shipping_methods: CreateOrderShippingMethodDTO[]
 }
 
+/**
+ * This step creates order shipping methods.
+ */
 export const createOrderShippingMethods = createStep(
   "create-order-shipping-methods",
-  async (input: StepInput, { container }) => {
+  async (input: CreateOrderShippingMethodsStepInput, { container }) => {
     const service = container.resolve<IOrderModuleService>(
       ModuleRegistrationName.ORDER
     )
diff --git a/packages/core/core-flows/src/order/steps/create-orders.ts b/packages/core/core-flows/src/order/steps/create-orders.ts
index 6365aff354..5ffd6db0f9 100644
--- a/packages/core/core-flows/src/order/steps/create-orders.ts
+++ b/packages/core/core-flows/src/order/steps/create-orders.ts
@@ -2,12 +2,13 @@ import { CreateOrderDTO, IOrderModuleService } from "@medusajs/types"
 import { ModuleRegistrationName } from "@medusajs/utils"
 import { StepResponse, createStep } from "@medusajs/workflows-sdk"
 
-type CreateOrdersStepInput = CreateOrderDTO[]
-
 export const createOrdersStepId = "create-orders"
+/**
+ * This step creates one or more orders.
+ */
 export const createOrdersStep = createStep(
   createOrdersStepId,
-  async (data: CreateOrdersStepInput, { container }) => {
+  async (data: CreateOrderDTO[], { container }) => {
     const service = container.resolve<IOrderModuleService>(
       ModuleRegistrationName.ORDER
     )
diff --git a/packages/core/core-flows/src/order/steps/decline-order-change.ts b/packages/core/core-flows/src/order/steps/decline-order-change.ts
index 4da1001939..b5452a1ec5 100644
--- a/packages/core/core-flows/src/order/steps/decline-order-change.ts
+++ b/packages/core/core-flows/src/order/steps/decline-order-change.ts
@@ -11,6 +11,9 @@ import {
 import { StepResponse, createStep } from "@medusajs/workflows-sdk"
 
 export const declineOrderChangeStepId = "decline-order-change"
+/**
+ * This step declines an order change.
+ */
 export const declineOrderChangeStep = createStep(
   declineOrderChangeStepId,
   async (data: DeclineOrderChangeDTO, { container }) => {
diff --git a/packages/core/core-flows/src/order/steps/delete-line-items.ts b/packages/core/core-flows/src/order/steps/delete-line-items.ts
index 32c0c9351e..4c7d155e22 100644
--- a/packages/core/core-flows/src/order/steps/delete-line-items.ts
+++ b/packages/core/core-flows/src/order/steps/delete-line-items.ts
@@ -2,13 +2,16 @@ import { IOrderModuleService } from "@medusajs/types"
 import { ModuleRegistrationName } from "@medusajs/utils"
 import { StepResponse, createStep } from "@medusajs/workflows-sdk"
 
-interface StepInput {
+export interface DeleteOrderLineItemsStepInput {
   ids: string[]
 }
 
+/**
+ * This step deletes order line items.
+ */
 export const deleteOrderLineItems = createStep(
   "delete-order-line-items",
-  async (input: StepInput, { container }) => {
+  async (input: DeleteOrderLineItemsStepInput, { container }) => {
     const service = container.resolve<IOrderModuleService>(
       ModuleRegistrationName.ORDER
     )
diff --git a/packages/core/core-flows/src/order/steps/delete-order-change-actions.ts b/packages/core/core-flows/src/order/steps/delete-order-change-actions.ts
index ed2aade126..4a0e8b46c1 100644
--- a/packages/core/core-flows/src/order/steps/delete-order-change-actions.ts
+++ b/packages/core/core-flows/src/order/steps/delete-order-change-actions.ts
@@ -3,6 +3,9 @@ import { ModuleRegistrationName } from "@medusajs/utils"
 import { StepResponse, createStep } from "@medusajs/workflows-sdk"
 
 export const deleteOrderChangeActionsStepId = "delete-order-change-actions"
+/**
+ * This step deletes order change actions.
+ */
 export const deleteOrderChangeActionsStep = createStep(
   deleteOrderChangeActionsStepId,
   async (data: { ids: string[] }, { container }) => {
diff --git a/packages/core/core-flows/src/order/steps/delete-order-changes.ts b/packages/core/core-flows/src/order/steps/delete-order-changes.ts
index cda13b8a46..28d3cecdc7 100644
--- a/packages/core/core-flows/src/order/steps/delete-order-changes.ts
+++ b/packages/core/core-flows/src/order/steps/delete-order-changes.ts
@@ -3,6 +3,9 @@ import { ModuleRegistrationName } from "@medusajs/utils"
 import { createStep, StepResponse } from "@medusajs/workflows-sdk"
 
 export const deleteOrderChangesStepId = "delete-order-change"
+/**
+ * This step deletes order changes.
+ */
 export const deleteOrderChangesStep = createStep(
   deleteOrderChangesStepId,
   async (data: { ids: string[] }, { container }) => {
diff --git a/packages/core/core-flows/src/order/steps/delete-order-shipping-methods.ts b/packages/core/core-flows/src/order/steps/delete-order-shipping-methods.ts
index eaa2d2ff2b..8bb79ef618 100644
--- a/packages/core/core-flows/src/order/steps/delete-order-shipping-methods.ts
+++ b/packages/core/core-flows/src/order/steps/delete-order-shipping-methods.ts
@@ -2,13 +2,17 @@ import { IOrderModuleService } from "@medusajs/types"
 import { ModuleRegistrationName } from "@medusajs/utils"
 import { StepResponse, createStep } from "@medusajs/workflows-sdk"
 
-interface StepInput {
+export interface DeleteOrderShippingMethodsStepInput {
   ids: string[]
 }
 
+
+/**
+ * This step deletes order shipping methods.
+ */
 export const deleteOrderShippingMethods = createStep(
   "delete-order-shipping-methods",
-  async (input: StepInput, { container }) => {
+  async (input: DeleteOrderShippingMethodsStepInput, { container }) => {
     const service = container.resolve<IOrderModuleService>(
       ModuleRegistrationName.ORDER
     )
diff --git a/packages/core/core-flows/src/order/steps/get-item-tax-lines.ts b/packages/core/core-flows/src/order/steps/get-item-tax-lines.ts
index 5a61e22881..115891f1fb 100644
--- a/packages/core/core-flows/src/order/steps/get-item-tax-lines.ts
+++ b/packages/core/core-flows/src/order/steps/get-item-tax-lines.ts
@@ -12,7 +12,7 @@ import {
 import { MedusaError, ModuleRegistrationName } from "@medusajs/utils"
 import { createStep, StepResponse } from "@medusajs/workflows-sdk"
 
-interface StepInput {
+export interface GetOrderItemTaxLinesStepInput {
   order: OrderWorkflowDTO
   items: OrderLineItemDTO[]
   shipping_methods: OrderShippingMethodDTO[]
@@ -98,9 +98,12 @@ function normalizeLineItemsForShipping(
 }
 
 export const getOrderItemTaxLinesStepId = "get-order-item-tax-lines"
+/**
+ * This step retrieves the tax lines for an order's line items and shipping methods.
+ */
 export const getOrderItemTaxLinesStep = createStep(
   getOrderItemTaxLinesStepId,
-  async (data: StepInput, { container }) => {
+  async (data: GetOrderItemTaxLinesStepInput, { container }) => {
     const {
       order,
       items = [],
diff --git a/packages/core/core-flows/src/order/steps/preview-order-change.ts b/packages/core/core-flows/src/order/steps/preview-order-change.ts
index 23cc0d23af..6418f57a72 100644
--- a/packages/core/core-flows/src/order/steps/preview-order-change.ts
+++ b/packages/core/core-flows/src/order/steps/preview-order-change.ts
@@ -3,6 +3,9 @@ import { ModuleRegistrationName } from "@medusajs/utils"
 import { StepResponse, createStep } from "@medusajs/workflows-sdk"
 
 export const previewOrderChangeStepId = "preview-order-change"
+/**
+ * This step retrieves a preview of an order change.
+ */
 export const previewOrderChangeStep = createStep(
   previewOrderChangeStepId,
   async (orderId: string, { container }) => {
diff --git a/packages/core/core-flows/src/order/steps/register-fulfillment.ts b/packages/core/core-flows/src/order/steps/register-fulfillment.ts
index cecbf5a689..bcca0e05ed 100644
--- a/packages/core/core-flows/src/order/steps/register-fulfillment.ts
+++ b/packages/core/core-flows/src/order/steps/register-fulfillment.ts
@@ -5,12 +5,13 @@ import {
 import { ModuleRegistrationName } from "@medusajs/utils"
 import { StepResponse, createStep } from "@medusajs/workflows-sdk"
 
-type RegisterOrderFulfillmentStepInput = RegisterOrderFulfillmentDTO
-
 export const registerOrderFulfillmentStepId = "register-order-fullfillment"
+/**
+ * This step registers a fulfillment for an order.
+ */
 export const registerOrderFulfillmentStep = createStep(
   registerOrderFulfillmentStepId,
-  async (data: RegisterOrderFulfillmentStepInput, { container }) => {
+  async (data: RegisterOrderFulfillmentDTO, { container }) => {
     const service = container.resolve<IOrderModuleService>(
       ModuleRegistrationName.ORDER
     )
diff --git a/packages/core/core-flows/src/order/steps/register-shipment.ts b/packages/core/core-flows/src/order/steps/register-shipment.ts
index 648aec5004..1b9b275438 100644
--- a/packages/core/core-flows/src/order/steps/register-shipment.ts
+++ b/packages/core/core-flows/src/order/steps/register-shipment.ts
@@ -2,12 +2,13 @@ import { IOrderModuleService, RegisterOrderShipmentDTO } from "@medusajs/types"
 import { ModuleRegistrationName } from "@medusajs/utils"
 import { StepResponse, createStep } from "@medusajs/workflows-sdk"
 
-type RegisterOrderShipmentStepInput = RegisterOrderShipmentDTO
-
 export const registerOrderShipmentStepId = "register-order-shipment"
+/**
+ * This step registers a shipment for an order.
+ */
 export const registerOrderShipmentStep = createStep(
   registerOrderShipmentStepId,
-  async (data: RegisterOrderShipmentStepInput, { container }) => {
+  async (data: RegisterOrderShipmentDTO, { container }) => {
     const service = container.resolve<IOrderModuleService>(
       ModuleRegistrationName.ORDER
     )
diff --git a/packages/core/core-flows/src/order/steps/set-tax-lines-for-items.ts b/packages/core/core-flows/src/order/steps/set-tax-lines-for-items.ts
index 4d82537df8..77d28c9ec1 100644
--- a/packages/core/core-flows/src/order/steps/set-tax-lines-for-items.ts
+++ b/packages/core/core-flows/src/order/steps/set-tax-lines-for-items.ts
@@ -9,16 +9,19 @@ import {
 import { ModuleRegistrationName, promiseAll } from "@medusajs/utils"
 import { StepResponse, createStep } from "@medusajs/workflows-sdk"
 
-interface StepInput {
+export interface SetOrderTaxLinesForItemsStepInput {
   order: OrderDTO
   item_tax_lines: ItemTaxLineDTO[]
   shipping_tax_lines: ShippingTaxLineDTO[]
 }
 
 export const setOrderTaxLinesForItemsStepId = "set-order-tax-lines-for-items"
+/**
+ * This step sets the tax lines of an order's items and shipping methods.
+ */
 export const setOrderTaxLinesForItemsStep = createStep(
   setOrderTaxLinesForItemsStepId,
-  async (data: StepInput, { container }) => {
+  async (data: SetOrderTaxLinesForItemsStepInput, { container }) => {
     const { order, item_tax_lines, shipping_tax_lines } = data
     const orderService = container.resolve<IOrderModuleService>(
       ModuleRegistrationName.ORDER
diff --git a/packages/core/core-flows/src/order/steps/update-order-change-actions.ts b/packages/core/core-flows/src/order/steps/update-order-change-actions.ts
index 372814b534..a615a6c7c9 100644
--- a/packages/core/core-flows/src/order/steps/update-order-change-actions.ts
+++ b/packages/core/core-flows/src/order/steps/update-order-change-actions.ts
@@ -10,6 +10,9 @@ import {
 import { StepResponse, createStep } from "@medusajs/workflows-sdk"
 
 export const updateOrderChangeActionsStepId = "update-order-change-actions"
+/**
+ * This step updates order change actions.
+ */
 export const updateOrderChangeActionsStep = createStep(
   updateOrderChangeActionsStepId,
   async (data: UpdateOrderChangeActionDTO[], { container }) => {
diff --git a/packages/core/core-flows/src/order/steps/update-order-exchanges.ts b/packages/core/core-flows/src/order/steps/update-order-exchanges.ts
index b949b5d860..d684ab32e2 100644
--- a/packages/core/core-flows/src/order/steps/update-order-exchanges.ts
+++ b/packages/core/core-flows/src/order/steps/update-order-exchanges.ts
@@ -6,6 +6,9 @@ import {
 import { StepResponse, createStep } from "@medusajs/workflows-sdk"
 
 export const updateOrderExchangesStepId = "update-order-exchange"
+/**
+ * This step update order changes.
+ */
 export const updateOrderExchangesStep = createStep(
   updateOrderExchangesStepId,
   async (data: UpdateOrderExchangeDTO[], { container }) => {
diff --git a/packages/core/core-flows/src/order/steps/update-shipping-methods.ts b/packages/core/core-flows/src/order/steps/update-shipping-methods.ts
index c3b1c6805d..18644f0ce7 100644
--- a/packages/core/core-flows/src/order/steps/update-shipping-methods.ts
+++ b/packages/core/core-flows/src/order/steps/update-shipping-methods.ts
@@ -9,6 +9,9 @@ import {
 import { StepResponse, createStep } from "@medusajs/workflows-sdk"
 
 export const updateOrderShippingMethodsStepId = "update-order-shopping-methods"
+/**
+ * This step updats order shipping methods.
+ */
 export const updateOrderShippingMethodsStep = createStep(
   updateOrderShippingMethodsStepId,
   async (data: UpdateOrderShippingMethodDTO[], { container }) => {
diff --git a/packages/core/core-flows/src/order/steps/update-tax-lines.ts b/packages/core/core-flows/src/order/steps/update-tax-lines.ts
index 24f0d4563b..f075079154 100644
--- a/packages/core/core-flows/src/order/steps/update-tax-lines.ts
+++ b/packages/core/core-flows/src/order/steps/update-tax-lines.ts
@@ -2,7 +2,7 @@ import { OrderLineItemDTO, OrderShippingMethodDTO } from "@medusajs/types"
 import { StepResponse, createStep } from "@medusajs/workflows-sdk"
 import { updateOrderTaxLinesWorkflow } from "../workflows/update-tax-lines"
 
-interface StepInput {
+export interface UpdateOrderTaxLinesStepInput {
   order_id: string
   items?: OrderLineItemDTO[]
   shipping_methods?: OrderShippingMethodDTO[]
@@ -10,9 +10,12 @@ interface StepInput {
 }
 
 export const updateOrderTaxLinesStepId = "update-order-tax-lines-step"
+/**
+ * This step updates tax lines for an order's line items and shipping methods.
+ */
 export const updateOrderTaxLinesStep = createStep(
   updateOrderTaxLinesStepId,
-  async (input: StepInput, { container }) => {
+  async (input: UpdateOrderTaxLinesStepInput, { container }) => {
     const { transaction } = await updateOrderTaxLinesWorkflow(container).run({
       input,
     })