@mercurjs/docs 2.2.1 → 2.3.0-canary.1

package/content/references/workflows/cart/complete-cart-with-split-orders.mdx

@@ -1,36 +0,0 @@
----
-title: "completeCartWithSplitOrdersWorkflow"
-description: "Complete a multi-seller cart by splitting it into per-seller orders under an order group."
----
-
-Mercur's replacement for Medusa's `completeCartWorkflow` and the heart of multi-vendor checkout. It groups the cart's items by the seller behind each item's offer, creates one order per seller (each carrying only that seller's items, shipping methods, addresses, and promotion adjustments), and wraps them in a single `OrderGroup` the shopper tracks as one purchase. Along the way it validates seller items and shipping coverage, mirrors line-item ↔ offer links onto the new order items, reserves offer inventory, registers promotion usage, links orders to the cart, sellers, payment collection, and order group, authorizes the single payment session, distributes captured amounts proportionally as order transactions, and refreshes each order's commission lines via `refreshOrderCommissionLinesWorkflow`. The run is idempotent per cart — an existing order group for the cart is returned instead of re-creating orders. Emits `order.placed` (one entry per child order) and `order_group.created`. Triggered by `POST /store/carts/:id/complete`.
-
-## Usage
-
-```ts
-import { completeCartWithSplitOrdersWorkflow } from "@mercurjs/core/workflows"
-
-const { result } = await completeCartWithSplitOrdersWorkflow(container).run({
-  input: { cart_id: "cart_123" },
-})
-```
-
-## Input
-
-<ParamField body="cart_id" type="string" required>The cart to complete; must have an authorized-able payment session and seller-scoped shipping methods covering every seller in the cart.</ParamField>
-
-## Result
-
-<ResponseField name="result.order_group_id" type="string">ID of the order group wrapping the per-seller orders — either newly created or the one already created for this cart.</ResponseField>
-
-## Hooks
-
-- `validate` — runs after the cart is loaded (before any orders are created) with `{ input, cart }`.
-- `beforePaymentAuthorization` — runs after orders and links are created, right before the payment session is authorized, with `{ input }`.
-- `orderGroupCreated` — runs at the end of the creation branch with `{ order_group_id, cart_id }`.
-
-```ts
-completeCartWithSplitOrdersWorkflow.hooks.validate(async ({ input, cart }) => {
-  // throw to block checkout
-})
-```

package/content/references/workflows/cart/list-seller-shipping-options-for-cart.mdx

@@ -1,39 +0,0 @@
----
-title: "listSellerShippingOptionsForCartWorkflow"
-description: "List available shipping options for a cart, grouped by seller."
----
-
-Resolves the sellers behind the cart's offers, finds their stock locations valid for the cart's sales channel, and queries shipping options in those locations' fulfillment sets with cart-scoped pricing. Each option carries its calculated `amount`, `is_tax_inclusive`, and an `insufficient_inventory` flag when the seller's location can't cover the cart quantities. Options are translated to the cart locale and returned keyed by seller ID. Triggered by `GET /store/shipping-options`.
-
-## Usage
-
-```ts
-import { listSellerShippingOptionsForCartWorkflow } from "@mercurjs/core/workflows"
-
-const { result } = await listSellerShippingOptionsForCartWorkflow(container).run({
-  input: { cart_id: "cart_123" },
-})
-```
-
-## Input
-
-<ParamField body="cart_id" type="string" required>The cart to list options for; must have `sales_channel_id`, `region_id`, and `currency_code` set.</ParamField>
-<ParamField body="is_return" type="boolean">List return shipping options instead; defaults to `false`.</ParamField>
-<ParamField body="enabled_in_store" type="boolean">Only options enabled in the storefront; defaults to `true`.</ParamField>
-<ParamField body="fields" type="string[]">Extra shipping-option fields to retrieve on top of the defaults.</ParamField>
-<ParamField body="additional_data" type="object">Custom data passed through to the workflow hooks.</ParamField>
-
-## Result
-
-<ResponseField name="result" type="Record<string, ShippingOptionDTO[]>">Map of seller ID to that seller's priced shipping options, each extended with `amount`, `is_tax_inclusive`, and `insufficient_inventory`.</ResponseField>
-
-## Hooks
-
-- `setPricingContext` — runs with `{ cart, fulfillmentSetIds, additional_data }`; return a record to merge into the price calculation context.
-- `setShippingOptionsContext` — runs with the same payload; return a record to merge into the shipping-option rule context.
-
-```ts
-listSellerShippingOptionsForCartWorkflow.hooks.setPricingContext(async ({ cart }) => {
-  return { customer_tier: "vip" }
-})
-```

package/content/references/workflows/cart/update-cart-seller-promotions.mdx

@@ -1,42 +0,0 @@
----
-title: "updateCartSellerPromotionsWorkflow"
-description: "Apply, remove, or replace promotion codes on a cart with seller-scoped adjustments."
----
-
-Seller-aware variant of Medusa's `updateCartPromotionsWorkflow`. Computes promotion actions for the requested codes, then prepares line-item and shipping-method adjustments so each promotion only discounts the owning seller's items, before creating/removing adjustments and syncing the cart's applied promotions. Optionally refreshes the payment collection. Triggered by `POST /store/carts/:id/promotions`.
-
-## Usage
-
-```ts
-import { updateCartSellerPromotionsWorkflow } from "@mercurjs/core/workflows"
-
-await updateCartSellerPromotionsWorkflow(container).run({
-  input: {
-    cart_id: "cart_123",
-    promo_codes: ["SUMMER10"],
-    action: "add",
-  },
-})
-```
-
-## Input
-
-<ParamField body="cart_id" type="string" required>The cart to update promotions on.</ParamField>
-<ParamField body="promo_codes" type="string[]">Promotion codes to apply; defaults to `[]`.</ParamField>
-<ParamField body="action" type="string">One of `add`, `remove`, `replace`; defaults to `add`.</ParamField>
-<ParamField body="cart" type="object">Preloaded cart data; skips the internal cart fetch when provided.</ParamField>
-<ParamField body="force_refresh_payment_collection" type="boolean">Refresh the cart's payment collection after adjustments change.</ParamField>
-
-## Result
-
-<ResponseField name="result" type="void">No return value; the cart's adjustments and applied promotions are updated as a side effect.</ResponseField>
-
-## Hooks
-
-- `validate` — runs after the cart is loaded with `{ input, cart }`.
-
-```ts
-updateCartSellerPromotionsWorkflow.hooks.validate(async ({ input, cart }) => {
-  // throw to reject the promotion change
-})
-```

package/content/references/workflows/commission/batch-commission-rules.mdx

@@ -1,49 +0,0 @@
----
-title: "batchCommissionRulesWorkflow"
-description: "Create, update, and delete a commission rate's rules in one call."
----
-
-Runs create, update, and delete operations on a commission rate's rules in parallel. Rules bind a rate to a reference (e.g. a seller, category, or product type) so the rate applies when an order line matches. Triggered by `POST /admin/commission-rates/:id/rules`.
-
-## Usage
-
-```ts
-import { batchCommissionRulesWorkflow } from "@mercurjs/core/workflows"
-
-const { result } = await batchCommissionRulesWorkflow(container).run({
-  input: {
-    commission_rate_id: "comrate_123",
-    create: [{ reference: "seller", reference_id: "sel_123" }],
-    update: [{ id: "comrule_456", reference_id: "sel_789" }],
-    delete: ["comrule_999"],
-  },
-})
-```
-
-## Input
-
-<ParamField body="commission_rate_id" type="string" required>The commission rate the rules belong to.</ParamField>
-<ParamField body="create" type="object[]">
-  Rules to create.
-
-  <Expandable title="properties">
-    <ParamField body="reference" type="string" required>Entity type the rule targets (e.g. `seller`, `product_category`, `product_type`).</ParamField>
-    <ParamField body="reference_id" type="string" required>ID of the referenced entity.</ParamField>
-  </Expandable>
-</ParamField>
-<ParamField body="update" type="object[]">
-  Rules to update.
-
-  <Expandable title="properties">
-    <ParamField body="id" type="string" required>The rule to update.</ParamField>
-    <ParamField body="reference" type="string">New reference type.</ParamField>
-    <ParamField body="reference_id" type="string">New referenced entity ID.</ParamField>
-  </Expandable>
-</ParamField>
-<ParamField body="delete" type="string[]">IDs of rules to delete.</ParamField>
-
-## Result
-
-<ResponseField name="result.created" type="CommissionRuleDTO[]">The created rules.</ResponseField>
-<ResponseField name="result.updated" type="CommissionRuleDTO[]">The updated rules.</ResponseField>
-<ResponseField name="result.deleted" type="string[]">IDs of the deleted rules.</ResponseField>

package/content/references/workflows/commission/create-commission-rates.mdx

@@ -1,41 +0,0 @@
----
-title: "createCommissionRatesWorkflow"
-description: "Create one or more commission rates."
----
-
-Creates commission rates — the fee definitions (flat or percentage) applied to seller orders. A unique `code` is auto-generated from the name when not provided. Triggered by `POST /admin/commission-rates`.
-
-## Usage
-
-```ts
-import { createCommissionRatesWorkflow } from "@mercurjs/core/workflows"
-
-const { result } = await createCommissionRatesWorkflow(container).run({
-  input: [
-    {
-      name: "Default commission",
-      type: "percentage",
-      value: 10,
-      is_default: true,
-    },
-  ],
-})
-```
-
-## Input
-
-The input is an array of commission rates to create.
-
-<ParamField body="name" type="string" required>Display name of the rate.</ParamField>
-<ParamField body="type" type="string" required>One of `fixed`, `percentage`.</ParamField>
-<ParamField body="value" type="number" required>Rate value — a percentage for `percentage`, an amount for `fixed`.</ParamField>
-<ParamField body="code" type="string">Unique code; auto-generated from the name when omitted.</ParamField>
-<ParamField body="currency_code" type="string | null">Currency of a `fixed` rate.</ParamField>
-<ParamField body="include_tax" type="boolean">Include tax totals in the commission base.</ParamField>
-<ParamField body="include_shipping" type="boolean">Also apply the rate to shipping methods.</ParamField>
-<ParamField body="is_enabled" type="boolean">Whether the rate is active.</ParamField>
-<ParamField body="is_default" type="boolean">Marks the rate as the platform-wide fallback.</ParamField>
-
-## Result
-
-<ResponseField name="result" type="CommissionRateDTO[]">The created commission rates.</ResponseField>

package/content/references/workflows/commission/delete-commission-rates.mdx

@@ -1,34 +0,0 @@
----
-title: "deleteCommissionRatesWorkflow"
-description: "Soft-delete commission rates after validating they can be removed."
----
-
-Validates the rates are deletable, then soft-deletes them. Deletion is reversible on workflow failure (compensation restores the rates). Triggered by `DELETE /admin/commission-rates/:id`.
-
-## Usage
-
-```ts
-import { deleteCommissionRatesWorkflow } from "@mercurjs/core/workflows"
-
-await deleteCommissionRatesWorkflow(container).run({
-  input: { ids: ["comrate_123"] },
-})
-```
-
-## Input
-
-<ParamField body="ids" type="string[]" required>IDs of the commission rates to delete.</ParamField>
-
-## Result
-
-<ResponseField name="result" type="void">No return value; the rates are soft-deleted.</ResponseField>
-
-## Hooks
-
-- `commissionRatesDeleted` — runs after deletion with `{ ids }`.
-
-```ts
-deleteCommissionRatesWorkflow.hooks.commissionRatesDeleted(async ({ ids }) => {
-  // react to deleted rates
-})
-```

package/content/references/workflows/commission/refresh-order-commission-lines.mdx

@@ -1,30 +0,0 @@
----
-title: "refreshOrderCommissionLinesWorkflow"
-description: "Recompute the commission lines for one or more orders."
----
-
-Loads each order with its items, products, sellers, and shipping methods, evaluates the matching commission rates, and upserts a commission line per item and shipping method (delete-then-insert, so re-running is idempotent). Runs inside `completeCartWithSplitOrdersWorkflow` after orders are created, and again from the `order-edit-confirmed` subscriber on order edits, returns, claims, and exchanges.
-
-## Usage
-
-```ts
-import { refreshOrderCommissionLinesWorkflow } from "@mercurjs/core/workflows"
-
-const { result } = await refreshOrderCommissionLinesWorkflow(container).run({
-  input: { order_ids: ["order_123"] },
-})
-```
-
-## Input
-
-<ParamField body="order_ids" type="string[]" required>IDs of the orders to recompute commission lines for; fails if any order is not found.</ParamField>
-
-## Result
-
-<ResponseField name="result" type="CommissionLineDTO[]">The upserted commission lines.</ResponseField>
-<ResponseField name="result[].item_id" type="string | null">The order line item the commission applies to.</ResponseField>
-<ResponseField name="result[].shipping_method_id" type="string | null">The shipping method the commission applies to.</ResponseField>
-<ResponseField name="result[].commission_rate_id" type="string | null">The rate that produced the line.</ResponseField>
-<ResponseField name="result[].code" type="string">Code of the applied rate.</ResponseField>
-<ResponseField name="result[].rate" type="number">Rate value applied.</ResponseField>
-<ResponseField name="result[].amount" type="number">Commission amount in the order currency.</ResponseField>

package/content/references/workflows/commission/update-commission-rates.mdx

@@ -1,35 +0,0 @@
----
-title: "updateCommissionRatesWorkflow"
-description: "Update one or more commission rates."
----
-
-Applies partial updates to existing commission rates by ID. Triggered by `POST /admin/commission-rates/:id`.
-
-## Usage
-
-```ts
-import { updateCommissionRatesWorkflow } from "@mercurjs/core/workflows"
-
-const { result } = await updateCommissionRatesWorkflow(container).run({
-  input: [{ id: "comrate_123", value: 12, is_enabled: true }],
-})
-```
-
-## Input
-
-The input is an array of commission rate updates.
-
-<ParamField body="id" type="string" required>The commission rate to update.</ParamField>
-<ParamField body="name" type="string">Display name of the rate.</ParamField>
-<ParamField body="code" type="string">Unique code of the rate.</ParamField>
-<ParamField body="type" type="string">One of `fixed`, `percentage`.</ParamField>
-<ParamField body="value" type="number">Rate value — a percentage for `percentage`, an amount for `fixed`.</ParamField>
-<ParamField body="currency_code" type="string | null">Currency of a `fixed` rate.</ParamField>
-<ParamField body="include_tax" type="boolean">Include tax totals in the commission base.</ParamField>
-<ParamField body="include_shipping" type="boolean">Also apply the rate to shipping methods.</ParamField>
-<ParamField body="is_enabled" type="boolean">Whether the rate is active.</ParamField>
-<ParamField body="is_default" type="boolean">Marks the rate as the platform-wide fallback.</ParamField>
-
-## Result
-
-<ResponseField name="result" type="CommissionRateDTO[]">The updated commission rates.</ResponseField>

package/content/references/workflows/media/set-category-images.mdx

@@ -1,41 +0,0 @@
----
-title: "setCategoryImagesWorkflow"
-description: "Replace a category's media gallery and icon, enforcing single thumbnail/banner."
----
-
-Replaces a product category's media. When `media` is provided, the entire existing gallery is swapped for the new list; when `icon` is provided, the existing icon image is swapped (pass `null` to clear it). Omitted fields are left untouched. At most one image keeps `is_thumbnail` and one keeps `is_banner` — the first flagged entry wins and later flags are silently dropped. Usually invoked through the `createProductCategoryWithImagesWorkflow`, `updateProductCategoryWithImagesWorkflow`, and `deleteProductCategoryWithImagesWorkflow` wrappers behind the `/admin/product-categories` routes.
-
-## Usage
-
-```ts
-import { setCategoryImagesWorkflow } from "@mercurjs/core/workflows"
-
-await setCategoryImagesWorkflow(container).run({
-  input: {
-    category_id: "pcat_123",
-    media: [
-      { url: "https://cdn.example.com/hero.jpg", is_banner: true },
-      { url: "https://cdn.example.com/thumb.jpg", is_thumbnail: true },
-    ],
-    icon: "https://cdn.example.com/icon.svg",
-  },
-})
-```
-
-## Input
-
-<ParamField body="category_id" type="string" required>The category whose images are replaced.</ParamField>
-<ParamField body="media" type="CategoryMediaInput[]">
-  New gallery; replaces all existing non-icon images (pass `[]` to clear).
-  <Expandable title="properties">
-    <ParamField body="url" type="string" required>Public URL of the image.</ParamField>
-    <ParamField body="is_thumbnail" type="boolean">Mark as the thumbnail; only the first flagged image is honoured.</ParamField>
-    <ParamField body="is_banner" type="boolean">Mark as the banner; only the first flagged image is honoured.</ParamField>
-    <ParamField body="rank" type="number">Sort rank; defaults to the array index.</ParamField>
-  </Expandable>
-</ParamField>
-<ParamField body="icon" type="string | null">New icon URL; `null` removes the current icon, omit to keep it.</ParamField>
-
-## Result
-
-<ResponseField name="result" type="void">No return value.</ResponseField>

package/content/references/workflows/media/set-collection-images.mdx

@@ -1,41 +0,0 @@
----
-title: "setCollectionImagesWorkflow"
-description: "Replace a collection's media gallery and icon, enforcing single thumbnail/banner."
----
-
-Replaces a product collection's media. When `media` is provided, the entire existing gallery is swapped for the new list; when `icon` is provided, the existing icon image is swapped (pass `null` to clear it). Omitted fields are left untouched. At most one image keeps `is_thumbnail` and one keeps `is_banner` — the first flagged entry wins and later flags are silently dropped. Usually invoked through the `createProductCollectionWithImagesWorkflow`, `updateProductCollectionWithImagesWorkflow`, and `deleteProductCollectionWithImagesWorkflow` wrappers behind the `/admin/collections` routes.
-
-## Usage
-
-```ts
-import { setCollectionImagesWorkflow } from "@mercurjs/core/workflows"
-
-await setCollectionImagesWorkflow(container).run({
-  input: {
-    collection_id: "pcol_123",
-    media: [
-      { url: "https://cdn.example.com/hero.jpg", is_banner: true },
-      { url: "https://cdn.example.com/thumb.jpg", is_thumbnail: true },
-    ],
-    icon: "https://cdn.example.com/icon.svg",
-  },
-})
-```
-
-## Input
-
-<ParamField body="collection_id" type="string" required>The collection whose images are replaced.</ParamField>
-<ParamField body="media" type="CollectionMediaInput[]">
-  New gallery; replaces all existing non-icon images (pass `[]` to clear).
-  <Expandable title="properties">
-    <ParamField body="url" type="string" required>Public URL of the image.</ParamField>
-    <ParamField body="is_thumbnail" type="boolean">Mark as the thumbnail; only the first flagged image is honoured.</ParamField>
-    <ParamField body="is_banner" type="boolean">Mark as the banner; only the first flagged image is honoured.</ParamField>
-    <ParamField body="rank" type="number">Sort rank; defaults to the array index.</ParamField>
-  </Expandable>
-</ParamField>
-<ParamField body="icon" type="string | null">New icon URL; `null` removes the current icon, omit to keep it.</ParamField>
-
-## Result
-
-<ResponseField name="result" type="void">No return value.</ResponseField>

package/content/references/workflows/member/accept-member-invite.mdx

@@ -1,33 +0,0 @@
----
-title: "acceptMemberInviteWorkflow"
-description: "Redeem an invite token and join a seller's team."
----
-
-Validates the invite token, upserts the member by the invited email, links them to the seller with the invited role (as owner if the seller has none yet), binds the auth identity when the member is new, and deletes the consumed invite. Triggered by `POST /vendor/members/invites/accept`. Emits `member_invite.accepted`.
-
-## Usage
-
-```ts
-import { acceptMemberInviteWorkflow } from "@mercurjs/core/workflows"
-
-const { result } = await acceptMemberInviteWorkflow(container).run({
-  input: {
-    invite_token: "eyJhbGciOi...",
-    auth_identity_id: "authid_123",
-    first_name: "Jane",
-    last_name: "Doe",
-  },
-})
-```
-
-## Input
-
-<ParamField body="invite_token" type="string" required>Signed invite token from the invitation link.</ParamField>
-<ParamField body="auth_identity_id" type="string" required>Auth identity of the accepting user.</ParamField>
-<ParamField body="member_id" type="string">Existing member id; when set, no auth metadata is written.</ParamField>
-<ParamField body="first_name" type="string">First name for a newly created member.</ParamField>
-<ParamField body="last_name" type="string">Last name for a newly created member.</ParamField>
-
-## Result
-
-<ResponseField name="result" type="MemberDTO">The member linked to the seller.</ResponseField>

package/content/references/workflows/member/add-seller-member.mdx

@@ -1,30 +0,0 @@
----
-title: "addSellerMemberWorkflow"
-description: "Attach an existing member to a seller with a role."
----
-
-Creates a seller-member link between an existing member and a seller with the given role. Triggered by `POST /admin/sellers/:id/members` and `POST /vendor/sellers/:id/members`. Emits `seller_member.created`.
-
-## Usage
-
-```ts
-import { addSellerMemberWorkflow } from "@mercurjs/core/workflows"
-
-const { result } = await addSellerMemberWorkflow(container).run({
-  input: {
-    seller_id: "sel_123",
-    member_id: "mem_123",
-    role_id: "role_seller_support",
-  },
-})
-```
-
-## Input
-
-<ParamField body="seller_id" type="string" required>Id of the seller.</ParamField>
-<ParamField body="member_id" type="string" required>Id of the member to attach.</ParamField>
-<ParamField body="role_id" type="string" required>Role to assign, e.g. `role_seller_administration`, `role_seller_support`.</ParamField>
-
-## Result
-
-<ResponseField name="result" type="SellerMemberDTO">The created seller-member link.</ResponseField>

package/content/references/workflows/member/create-member-invites.mdx

@@ -1,34 +0,0 @@
----
-title: "createMemberInvitesWorkflow"
-description: "Create tokenized member invitations for sellers."
----
-
-Creates invite records with a signed token and expiry for each entry. Triggered by `POST /admin/sellers/:id/members/invite` and the vendor invite routes; also run as a step by `createSellersWorkflow` for the initial member. Emits `member_invite.created` with `{ id, token, expires_at }` per invite, which typically drives the invitation email.
-
-## Usage
-
-```ts
-import { createMemberInvitesWorkflow } from "@mercurjs/core/workflows"
-
-const { result } = await createMemberInvitesWorkflow(container).run({
-  input: [
-    {
-      seller_id: "sel_123",
-      email: "teammate@acme.co",
-      role_id: "role_seller_support",
-    },
-  ],
-})
-```
-
-## Input
-
-The input is an array of invites.
-
-<ParamField body="[].seller_id" type="string" required>Seller the invite belongs to.</ParamField>
-<ParamField body="[].email" type="string" required>Email of the invitee.</ParamField>
-<ParamField body="[].role_id" type="string" required>Role the invitee receives on acceptance.</ParamField>
-
-## Result
-
-<ResponseField name="result" type="MemberInviteDTO[]">The created invites, including `token` and `expires_at`.</ResponseField>

package/content/references/workflows/member/delete-member-invite.mdx

@@ -1,24 +0,0 @@
----
-title: "deleteMemberInviteWorkflow"
-description: "Delete a pending member invite."
----
-
-Deletes the invite so its token can no longer be redeemed. Triggered by `DELETE /admin/sellers/:id/members/invites/:invite_id` and the vendor equivalent.
-
-## Usage
-
-```ts
-import { deleteMemberInviteWorkflow } from "@mercurjs/core/workflows"
-
-await deleteMemberInviteWorkflow(container).run({
-  input: { invite_id: "meminv_123" },
-})
-```
-
-## Input
-
-<ParamField body="invite_id" type="string" required>Id of the invite to delete.</ParamField>
-
-## Result
-
-<ResponseField name="result" type="void">Nothing is returned.</ResponseField>

package/content/references/workflows/member/remove-seller-member.mdx

@@ -1,28 +0,0 @@
----
-title: "removeSellerMemberWorkflow"
-description: "Remove a member from a seller's team."
----
-
-Validates the seller-member link can be removed (owners cannot be removed), then deletes it. Triggered by `DELETE /admin/sellers/:id/members/:member_id` and `DELETE /vendor/sellers/:id/members/:member_id`. Emits `seller_member.deleted`.
-
-## Usage
-
-```ts
-import { removeSellerMemberWorkflow } from "@mercurjs/core/workflows"
-
-await removeSellerMemberWorkflow(container).run({
-  input: {
-    seller_member_id: "selmem_123",
-    seller_id: "sel_123",
-  },
-})
-```
-
-## Input
-
-<ParamField body="seller_member_id" type="string" required>Id of the seller-member link to delete.</ParamField>
-<ParamField body="seller_id" type="string" required>Id of the seller, included in the emitted event.</ParamField>
-
-## Result
-
-<ResponseField name="result" type="void">Nothing is returned.</ResponseField>

package/content/references/workflows/member/resend-member-invite.mdx

@@ -1,28 +0,0 @@
----
-title: "resendMemberInviteWorkflow"
-description: "Re-issue a member invite with a fresh token."
----
-
-Loads the existing invite, deletes it, and creates a new one with the same email and role — resetting the token and expiry. Triggered by `POST /admin/sellers/:id/members/invites/:invite_id/resend` and the vendor equivalent. Emits `member_invite.created` for the new invite.
-
-## Usage
-
-```ts
-import { resendMemberInviteWorkflow } from "@mercurjs/core/workflows"
-
-const { result } = await resendMemberInviteWorkflow(container).run({
-  input: {
-    invite_id: "meminv_123",
-    seller_id: "sel_123",
-  },
-})
-```
-
-## Input
-
-<ParamField body="invite_id" type="string" required>Id of the invite to re-issue; must belong to the seller.</ParamField>
-<ParamField body="seller_id" type="string" required>Seller the invite belongs to.</ParamField>
-
-## Result
-
-<ResponseField name="result" type="MemberInviteDTO[]">The re-created invite (single-element array) with a new `token` and `expires_at`.</ResponseField>

package/content/references/workflows/member/update-member-role.mdx

@@ -1,28 +0,0 @@
----
-title: "updateMemberRoleWorkflow"
-description: "Change a team member's role."
----
-
-Validates the target is not the seller owner, then updates the seller-member link's role. Triggered by `POST /admin/sellers/:id/members/:member_id` and `POST /vendor/sellers/:id/members/:member_id`. Emits `seller_member.updated`.
-
-## Usage
-
-```ts
-import { updateMemberRoleWorkflow } from "@mercurjs/core/workflows"
-
-await updateMemberRoleWorkflow(container).run({
-  input: {
-    seller_member_id: "selmem_123",
-    role_id: "role_seller_order_management",
-  },
-})
-```
-
-## Input
-
-<ParamField body="seller_member_id" type="string" required>Id of the seller-member link to update; must not be the owner.</ParamField>
-<ParamField body="role_id" type="string" required>New role to assign.</ParamField>
-
-## Result
-
-<ResponseField name="result" type="void">Nothing is returned.</ResponseField>

package/content/references/workflows/member/update-member.mdx

@@ -1,35 +0,0 @@
----
-title: "updateMemberWorkflow"
-description: "Update member profile fields matching a selector."
----
-
-Updates every member matching the selector — name and locale only. Triggered by `POST /vendor/members/me` when a member edits their own profile.
-
-## Usage
-
-```ts
-import { updateMemberWorkflow } from "@mercurjs/core/workflows"
-
-const { result } = await updateMemberWorkflow(container).run({
-  input: {
-    selector: { id: "mem_123" },
-    update: { first_name: "Jane", last_name: "Doe" },
-  },
-})
-```
-
-## Input
-
-<ParamField body="selector" type="object" required>Filter selecting the members to update, e.g. `{ id: "mem_123" }`.</ParamField>
-<ParamField body="update" type="object" required>
-  Fields to update.
-  <Expandable title="properties">
-    <ParamField body="first_name" type="string | null">First name.</ParamField>
-    <ParamField body="last_name" type="string | null">Last name.</ParamField>
-    <ParamField body="locale" type="string | null">Preferred locale.</ParamField>
-  </Expandable>
-</ParamField>
-
-## Result
-
-<ResponseField name="result" type="MemberDTO[]">The updated members.</ResponseField>