docs(packages): migrate legacy API reference links to new page paths in TSDocs (#16184)

Rewrites hash-anchor API-reference links (e.g. `/api/admin#carts_getcartsid`)
to the new real page paths (`/api/admin/carts/get-a-cart`) in TSDoc comments
across core-flows, js-sdk, types, and utils. Includes hand-fixed renames (MFA,
order transfer, customer addresses, etc.). Comment-only changes.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: shahednasser

packages/core/core-flows/src/api-key/workflows/create-api-keys.ts

@@ -25,7 +25,7 @@ export type CreateApiKeysWorkflowOutput = ApiKeyDTO[]
 export const createApiKeysWorkflowId = "create-api-keys"
 /**
  * This workflow creates one or more API keys, which can be secret or publishable. It's used by the
- * [Create API Key Admin API Route](https://docs.medusajs.com/api/admin#api-keys_postapikeys).
+ * [Create API Key Admin API Route](https://docs.medusajs.com/api/admin/api-keys/create-api-key).
  *
  * You can use this workflow within your customizations or your own custom workflows, allowing you to
  * create API keys within your custom flows.

packages/core/core-flows/src/api-key/workflows/delete-api-keys.ts

@@ -16,7 +16,7 @@ export type DeleteApiKeysWorkflowInput = {
 export const deleteApiKeysWorkflowId = "delete-api-keys"
 /**
  * This workflow deletes one or more secret or publishable API keys. It's used by the
- * [Delete API Key Admin API Route](https://docs.medusajs.com/api/admin#api-keys_deleteapikeysid).
+ * [Delete API Key Admin API Route](https://docs.medusajs.com/api/admin/api-keys/delete-an-api-key).
  * 
  * You can use this workflow within your customizations or your own custom workflows, allowing you to
  * delete API keys within your custom flows.

packages/core/core-flows/src/api-key/workflows/link-sales-channels-to-publishable-key.ts

@@ -18,7 +18,7 @@ export const linkSalesChannelsToApiKeyWorkflowId =
   "link-sales-channels-to-api-key"
 /**
  * This workflow manages the sales channels of a publishable API key. It's used by the
- * [Manage Sales Channels API Route](https://docs.medusajs.com/api/admin#api-keys_postapikeysidsaleschannels).
+ * [Manage Sales Channels API Route](https://docs.medusajs.com/api/admin/api-keys/manage-sales-channels).
  *
  * You can use this workflow within your customizations or your own custom workflows, allowing you to
  * manage the sales channels of a publishable API key within your custom flows.

packages/core/core-flows/src/api-key/workflows/revoke-api-keys.ts

@@ -34,7 +34,7 @@ export const revokeApiKeysWorkflowId = "revoke-api-keys"
  * This workflow revokes one or more API keys. If the API key is a secret, 
  * it can't be used for authentication anymore. If it's publishable, it can't be used by client applications.
  * 
- * This workflow is used by the [Revoke API Key API Route](https://docs.medusajs.com/api/admin#api-keys_postapikeysidrevoke).
+ * This workflow is used by the [Revoke API Key API Route](https://docs.medusajs.com/api/admin/api-keys/revoke-api-key).
  * 
  * You can use this workflow within your customizations or your own custom workflows, allowing you to
  * revoke API keys within your custom flows.

packages/core/core-flows/src/api-key/workflows/update-api-keys.ts

@@ -32,7 +32,7 @@ export type UpdateApiKeysWorkflowOutput = ApiKeyDTO[]
 export const updateApiKeysWorkflowId = "update-api-keys"
 /**
  * This workflow updates one or more secret or publishable API keys. It's used by the
- * [Update API Key Admin API Route](https://docs.medusajs.com/api/admin#api-keys_postapikeysid).
+ * [Update API Key Admin API Route](https://docs.medusajs.com/api/admin/api-keys/update-an-api-key).
  * 
  * You can use this workflow within your customizations or your own custom workflows, allowing you to
  * update API keys within your custom flows.

packages/core/core-flows/src/auth/workflows/generate-reset-password-token.ts

@@ -15,8 +15,8 @@ const RESET_PASSWORD_TOKEN_TTL_SECONDS = 15 * 60
 
 /**
  * This workflow generates a reset password token for a user. It's used by the
- * [Generate Reset Password Token for Admin](https://docs.medusajs.com/api/admin#auth_postactor_typeauth_providerresetpassword)
- * and [Generate Reset Password Token for Customer](https://docs.medusajs.com/api/store#auth_postactor_typeauth_providerresetpassword)
+ * [Generate Reset Password Token for Admin](https://docs.medusajs.com/api/admin/auth/generate-reset-password-token)
+ * and [Generate Reset Password Token for Customer](https://docs.medusajs.com/api/store/auth/generate-reset-password-token)
  * API Routes.
  *
  * The workflow emits the `auth.password_reset` event, which you can listen to in

packages/core/core-flows/src/cart/workflows/add-shipping-method-to-cart.ts

@@ -51,7 +51,7 @@ export interface AddShippingMethodToCartWorkflowInput {
 export const addShippingMethodToCartWorkflowId = "add-shipping-method-to-cart"
 /**
  * This workflow adds a shipping method to a cart. It's executed by the
- * [Add Shipping Method Store API Route](https://docs.medusajs.com/api/store#carts_postcartsidshippingmethods).
+ * [Add Shipping Method Store API Route](https://docs.medusajs.com/api/store/carts/add-shipping-method).
  *
  * You can use this workflow within your own customizations or custom workflows, allowing you to wrap custom logic around adding a shipping method to the cart.
  *

packages/core/core-flows/src/cart/workflows/add-to-cart.ts

@@ -54,7 +54,7 @@ const variantFields = deduplicate([
 export const addToCartWorkflowId = "add-to-cart"
 /**
  * This workflow adds a product variant to a cart as a line item. It's executed by the
- * [Add Line Item Store API Route](https://docs.medusajs.com/api/store#carts_postcartsidlineitems).
+ * [Add Line Item Store API Route](https://docs.medusajs.com/api/store/carts/add-line-item).
  *
  * You can use this workflow within your own customizations or custom workflows, allowing you to wrap custom logic around adding an item to the cart.
  * For example, you can use this workflow to add a line item to the cart with a custom price.

packages/core/core-flows/src/cart/workflows/complete-cart.ts

@@ -73,7 +73,7 @@ const TWO_MINUTES = 60 * 2
 export const completeCartWorkflowId = "complete-cart"
 /**
  * This workflow completes a cart and places an order for the customer. It's executed by the
- * [Complete Cart Store API Route](https://docs.medusajs.com/api/store#carts_postcartsidcomplete).
+ * [Complete Cart Store API Route](https://docs.medusajs.com/api/store/carts/complete-cart).
  *
  * You can use this workflow within your own customizations or custom workflows, allowing you to wrap custom logic around completing a cart.
  * For example, in the [Subscriptions recipe](https://docs.medusajs.com/resources/recipes/subscriptions/examples/standard#create-workflow),

packages/core/core-flows/src/cart/workflows/create-carts.ts

@@ -112,7 +112,7 @@ export const prepareCartToCreateStep = createStep(
 export const createCartWorkflowId = "create-cart"
 /**
  * This workflow creates and returns a cart. You can set the cart's items, region, customer, and other details. This workflow is executed by the
- * [Create Cart Store API Route](https://docs.medusajs.com/api/store#carts_postcarts).
+ * [Create Cart Store API Route](https://docs.medusajs.com/api/store/carts/create-cart).
  *
  * This workflow has a hook that allows you to perform custom actions on the created cart. You can see an example in [this guide](https://docs.medusajs.com/resources/commerce-modules/cart/extend#step-4-consume-cartcreated-workflow-hook).
  *