Skip to content

The complete open source platform to run your entire marketplace. Storefront, vendor panel, admin console, and integrations in one enterprise-grade platform you own.

docs: add seller-members, subscriptions pages and update seller docs

vholik374943ccb294
diff --git a/apps/docs/docs.json b/apps/docs/docs.json
index 2d82d6776..1392eb08e 100644
--- a/apps/docs/docs.json
+++ b/apps/docs/docs.json
@@ -26,7 +26,7 @@
"navigation": {
"versions": [
{
- "version": "2.0",
+ "version": "2.0.1",
"default": true,
"tabs": [
{
@@ -55,6 +55,8 @@
"group": "Core Concepts",
"pages": [
"v2/core-concepts/seller",
+ "v2/core-concepts/seller-members",
+ "v2/core-concepts/subscriptions",
"v2/core-concepts/payout",
"v2/core-concepts/commission"
]
diff --git a/apps/docs/v2/core-concepts/seller-members.mdx b/apps/docs/v2/core-concepts/seller-members.mdx
new file mode 100644
index 000000000..e4fbb18b1
--- /dev/null
+++ b/apps/docs/v2/core-concepts/seller-members.mdx
@@ -0,0 +1,62 @@
+---
+title: "Seller Members"
+description: "Multi-user seller accounts — member data, team management, store switching, and access rules."
+---
+
+A **seller member** represents a user who has access to a seller account. Mercur supports **multi-user seller accounts** — multiple people can manage the same store — and **multi-seller users** — a single person can belong to more than one store. This page covers how members relate to sellers, how access is structured, and the rules governing team management.
+
+## Concept
+
+The relationship between users and sellers is **many-to-many**. A seller account can have several members (e.g. an owner, a warehouse manager, and a support agent), and a single user can be a member of multiple seller accounts (e.g. a consultant managing stores for different brands).
+
+Each membership is a distinct association between a user and a seller account.
+
+## Member Data
+
+Each member record holds the following information:
+
+
+| Field | Description |
+| -------- | ------------------------------------------------------------ |
+| `email` | The member's email address, used for login and notifications |
+| `locale` | Preferred language/locale for the vendor portal UI |
+| `status` | Whether the member is active or deactivated |
+
+
+The member's identity is tied to their **email address**. Email addresses must be unique across all members within a single seller account but the same email can appear on different seller accounts.
+
+## Member-Seller Association
+
+When a member is added to a seller account, the association includes:
+
+- A reference to the **seller account**
+- A reference to the **member**
+
+Removing the association revokes the member's access to that seller account entirely.
+
+## Store Switcher
+
+For users who belong to multiple seller accounts, the vendor portal provides a **store switcher**. Each store context is fully isolated — when a member switches stores, they see only the data (products, orders, payouts) belonging to that seller account.
+
+This isolation ensures that access to one store never leaks information from another, even when the same person manages both.
+
+## Adding Members
+
+Members can be added to a seller account by:
+
+- **Operators** — via the admin dashboard, an operator can add members to any seller account
+- **Seller admins** — members with admin access can invite new members to their own seller account
+
+When a new member is added, they receive an invitation to set up their access. If the email already belongs to an existing user in the system, the new seller association is linked to their existing account.
+
+## Removing Members
+
+Removing a member **deletes the association** between the user and the seller account. The user's account continues to exist — they simply lose access to that particular store.
+
+Both **operators** and **seller admins** can remove members, subject to the constraint that a seller account must always retain at least one admin member.
+
+## Business Rules
+
+- A seller account must have **at least one member** with admin access at all times
+- **Email addresses** must be unique within a single seller account
+- Members are managed through the [seller account lifecycle](/v2/core-concepts/seller) — if a seller is terminated, all member associations are effectively void
diff --git a/apps/docs/v2/core-concepts/seller.mdx b/apps/docs/v2/core-concepts/seller.mdx
index 871b543c3..a778f3ef1 100644
--- a/apps/docs/v2/core-concepts/seller.mdx
+++ b/apps/docs/v2/core-concepts/seller.mdx
@@ -1,182 +1,118 @@
---
title: "Seller"
-description: "How sellers work in Mercur — registration, lifecycle, product ownership, and order splitting."
+description: "The central marketplace actor — seller profile, lifecycle, registration flows, and business rules."
---
-In a marketplace, the **Seller** is the central actor. Every product, order, shipment, and payout ultimately ties back to a seller. Mercur's seller module manages the full vendor lifecycle — from registration through order fulfillment.
+A **seller** is the central actor in a Mercur marketplace. Every product listing, order, payout, and storefront presence traces back to a seller account. This page covers the seller data model, lifecycle, and the business rules that govern how sellers operate on the platform.
-## Seller lifecycle
+## Seller Profile
-A seller progresses through a defined set of statuses:
+Each seller account holds the following core fields:
-```
-PENDING → ACTIVE → (optionally) SUSPENDED
-```
-
-1. **PENDING** — A new seller registers and starts in this state. They can set up their profile but cannot sell.
-2. **ACTIVE** — An admin approves the seller. Only active sellers' products appear in the storefront and can be purchased.
-3. **SUSPENDED** — An admin can suspend a seller at any time, removing their products from sale.
-
-### Auto-approve sellers
-
-By default, new sellers start as `PENDING` and require manual admin approval. You can configure the seller module to automatically approve sellers on creation by passing the `autoApprove` option:
-
-```ts
-// medusa-config.ts
-{
- resolve: "./modules/seller",
- options: {
- autoApprove: true,
- },
-}
-```
-
-When `autoApprove` is `true`, new sellers are created with `ACTIVE` status immediately, skipping the manual approval step. If an explicit status is provided during creation, it takes precedence over this option.
-
-### Seller profile
-Each seller has a profile with:
+| Field | Description |
+| --------------- | ----------------------------------------------------------------------------- |
+| `name` | Display name shown to customers on the storefront (unique) |
+| `handle` | URL-friendly identifier for the seller (unique) |
+| `email` | Primary contact email for the seller account (unique) |
+| `description` | Free-text seller description, typically shown on the seller's storefront page |
+| `logo` | Seller logo or avatar |
+| `banner` | Banner image for the seller's storefront page |
+| `website_url` | Seller's external website |
+| `currency_code` | The single currency in which this seller operates |
+| `is_premium` | Operator-designated premium seller flag (see below) |
+| `status_reason` | Optional explanation for the current status (e.g. reason for suspension) |
+| `external_id` | Identifier in an external system (unique, optional) |
+| `metadata` | Arbitrary JSON metadata |
-| Field | Description |
-|-------|-------------|
-| `name` | Display name (required) |
-| `handle` | Unique, URL-safe identifier (auto-generated from name) |
-| `email` | Contact email |
-| `phone` | Contact phone |
-| `logo` | Logo URL for storefront/portal |
-| `cover_image` | Cover image URL |
-| `address_1`, `city`, `country_code`, `province`, `postal_code` | Business address |
-Handles are validated to be URL-safe (alphanumeric characters, hyphens, and underscores only).
+### Single Currency Per Account
-## Product ownership
+Every seller account is locked to **one currency**. Prices, payouts, and subscription billing all use this currency. This constraint keeps financial reporting simple and eliminates exchange-rate ambiguity in payouts.
-Products in Mercur are always owned by a seller. This relationship is established via a **link** between the `Product` entity (from Medusa core) and the `Seller` entity. When a seller creates a product, this link is automatically created.
+If a seller needs to trade in multiple currencies, the recommended pattern is to create **separate seller accounts** — one per currency. Each account operates independently with its own products, orders, and payouts.
-This ownership is what drives the core marketplace behavior — it determines which seller receives an order, which shipping options apply, and how commissions are calculated.
+### Professional Sellers
-## Order splitting
+A seller can optionally have associated **professional details**. If present, the seller is treated as a registered business; if absent, the seller is an individual.
-When a customer adds products from multiple sellers to their cart and checks out, Mercur does not create a single order. Instead, it splits the cart into **one order per seller**.
+## Address and Payment Information
-### The split order pipeline
+Sellers can store one or more **addresses** (warehouse, return, business) and **payment details** used for payout processing. These are managed as sub-resources of the seller account and are referenced by workflows such as fulfillment and payout settlement.
-The `completeCartWithSplitOrdersWorkflow` handles this process:
+## Seller Lifecycle
-**1. Validation**
-- Acquires a distributed lock on the cart to prevent concurrent completions
-- Validates that every cart item has an assigned seller
-- Validates that items requiring shipping have seller-specific shipping methods
+A seller account moves through **four statuses** over its lifetime:
-**2. Grouping by seller**
-- Cart items are grouped by their seller
-- Shipping methods are matched to the corresponding seller's shipping options
-- Addresses, tax lines, and promotion adjustments are copied per seller
+```
+ ┌──────────────────┐
+ │ pending_approval │
+ └────────┬─────────┘
+ │ approve
+ ▼
+ ┌──────────┐ ┌────────┐
+ │ suspended │◄────►│ open │
+ └──────────┘ └───┬────┘
+ │ terminate
+ ▼
+ ┌────────────┐
+ │ terminated │
+ └────────────┘
+```
-**3. Order creation**
-- A separate order is created for each seller, containing only that seller's items and shipping methods
-- An **OrderGroup** is created to tie all seller orders back to the original cart transaction
-- Inventory is reserved across all orders in parallel
+### Status Definitions
-**4. Payment splitting**
-- The total payment is proportionally allocated across seller orders
-- Formula: `(seller_order_total / payment_total) × capture_amount`
-- Each seller order gets its own payment transaction record
+- `**pending_approval**` — The seller has registered but has not yet been reviewed by the platform operator.
+- `**open**` — The seller is active and may list products, receive orders, and collect payouts.
+- `**suspended**` — The seller's operations are temporarily frozen. Products remain in the catalog but cannot be purchased.
+- `**terminated**` — The seller account is permanently closed. This status is irreversible.
-**5. Post-creation**
-- Commission lines are calculated for each order
-- Seller–customer relationships are created (for first-purchase tracking)
-- `order.placed` events are emitted for each seller order
-- An `order_group.created` event is emitted for the group
+### Status Transition Rules
-### OrderGroup
-The `OrderGroup` entity represents the customer's view of their purchase. It groups all seller orders from a single checkout and provides computed fields:
+| From | To | Who | Conditions |
+| ------------------ | ------------ | ----------------- | --------------------------------------------------------- |
+| `pending_approval` | `open` | Operator | Operator reviews and approves the application |
+| `open` | `suspended` | Operator | Policy violation, compliance hold, or operator discretion |
+| `suspended` | `open` | Operator | Issue resolved, seller reinstated |
+| `open` | `terminated` | Operator / Seller | All prerequisites met (see below) |
+| `suspended` | `terminated` | Operator | All prerequisites met (see below) |
-- `seller_count` — Number of distinct sellers in the order
-- `total` — Combined total across all seller orders
-<Info>
- The order splitting process uses distributed locking with a 30-second timeout and 2-minute TTL to ensure only one completion attempt can proceed at a time.
-</Info>
+## Scheduled Closures
-## Relationships
+Sellers can schedule **temporary closures** without changing their account status. Two date fields control this:
-A seller is linked to many entities across the system:
+- `closed_from` — The date the closure begins
+- `closed_to` — The date the closure ends
-| Entity | Relationship | Purpose |
-|--------|-------------|---------|
-| Products | One-to-many | Products the seller owns |
-| Orders | One-to-many | Orders placed for this seller's items |
-| Customers | Many-to-many | Customers who have purchased from this seller |
-| Shipping Options | One-to-many | Seller-specific shipping methods |
-| Stock Locations | One-to-many | Warehouses and fulfillment locations |
-| Payout Account | One-to-one | Financial account for receiving payouts |
-| Promotions | One-to-many | Seller-created promotions and discounts |
-| Price Lists | One-to-many | Custom pricing rules |
+During a scheduled closure the seller's storefront shows as unavailable and new orders cannot be placed, but the account remains in `open` status. This is designed for holidays, seasonal breaks, or planned downtime. Once `closed_to` passes, the seller automatically resumes normal operation.
-## API examples
+Scheduled closures are **not a status** — they overlay on top of the current status and do not affect status transition rules.
-### Register a seller (Vendor API)
+## Premium Sellers
-The seller registration endpoint allows unauthenticated users to create a new seller account. The seller starts in `PENDING_APPROVAL` status.
+The `is_premium` flag is set **exclusively by the platform operator**. Sellers cannot designate themselves as premium. This flag is used for storefront features such as:
-```bash
-curl -X POST http://localhost:9000/vendor/sellers \
- -H "Content-Type: application/json" \
- -d '{
- "name": "Acme Electronics",
- "email": "[email protected]",
- "member_email": "[email protected]",
- "currency_code": "eur",
- "address": {
- "company": "Acme Electronics Ltd",
- "address_1": "123 Market Street",
- "city": "Berlin",
- "country_code": "de",
- "postal_code": "10115"
- }
- }'
-```
+- Featured placement in search results or category pages
+- Visual badges or highlights on the seller's profile
+- Priority in marketplace curation
-### Create a seller (Admin API)
-
-Admins can create sellers directly with a specified status and send a member invite:
-
-```bash
-curl -X POST http://localhost:9000/admin/sellers \
- -H "Authorization: Bearer <admin-token>" \
- -H "Content-Type: application/json" \
- -d '{
- "name": "Acme Electronics",
- "email": "[email protected]",
- "currency_code": "eur",
- "member": {
- "email": "[email protected]"
- }
- }'
-```
+The specific storefront behavior tied to premium status is determined by the frontend implementation.
-### List sellers (Admin API)
+## Registration Flows
-```bash
-curl http://localhost:9000/admin/sellers \
- -H "Authorization: Bearer <admin-token>"
-```
-
-### Approve a seller (Admin API)
-
-Approves a seller in `PENDING_APPROVAL` status, changing it to `OPEN`:
-
-```bash
-curl -X POST http://localhost:9000/admin/sellers/slr_abc123/approve \
- -H "Authorization: Bearer <admin-token>"
-```
+There are **two methods** for creating a seller account:
-## Extension points
+1. **Operator-created** — The platform operator creates the seller account directly via the admin dashboard. The account can be set to `open` immediately, bypassing `pending_approval`.
+2. **Self-registration** — The seller registers through the public-facing registration flow. The account enters `pending_approval` status and waits for operator review.
-The order completion workflow provides hooks for custom logic:
+## Business Rules Summary
-- **`validate`** — Add custom pre-completion validation
-- **`beforePaymentAuthorization`** — Run logic before payment is captured
-- **`orderGroupCreated`** — React to the completed order group
+- A seller account operates in **exactly one currency**
+- The presence of `professional_details` determines whether the seller is a registered business
+- Only the **operator** can approve, suspend, or reinstate sellers
+- **Termination** is irreversible and requires all orders and payouts to be resolved
+- Scheduled closures are **date-driven** and do not change account status
+- **Premium** designation is operator-only and influences storefront presentation
+- Every seller account must have at least one [member](/v2/core-concepts/seller-members) with an admin role
diff --git a/apps/docs/v2/core-concepts/subscriptions.mdx b/apps/docs/v2/core-concepts/subscriptions.mdx
new file mode 100644
index 000000000..53cdcce37
--- /dev/null
+++ b/apps/docs/v2/core-concepts/subscriptions.mdx
@@ -0,0 +1,91 @@
+---
+title: "Subscriptions"
+description: "Recurring seller billing — platform toggle, default plans, per-seller overrides, and billing rules."
+---
+
+**Subscriptions** allow the platform operator to charge sellers a recurring fee for marketplace access. This is an opt-in feature — when disabled, sellers operate without any platform billing. This page covers the subscription model, billing rules, and how overrides work.
+
+## Platform-Level Toggle
+
+Subscriptions are controlled by a **platform-wide toggle**:
+
+- **Disabled** (default) — No subscription billing occurs. Sellers are not charged any platform fees. The subscription UI is hidden from both the admin dashboard and the vendor portal.
+- **Enabled** — Sellers are billed according to their subscription plan. The operator must configure at least one default plan before enabling subscriptions.
+
+Toggling subscriptions off after they have been enabled **does not delete** existing subscription records. Billing simply stops, and sellers are not charged for subsequent periods. Re-enabling resumes billing from the next cycle.
+
+## Default Subscription Plan
+
+When subscriptions are enabled, the operator defines a **default plan** for each currency in which sellers operate. Each plan specifies:
+
+
+| Field | Description |
+| ----------------- | ----------------------------------------------------------------------------------------- |
+| `currency_code` | The currency this plan applies to (matches the seller's `currency_code`, unique per plan) |
+| `monthly_amount` | The recurring fee charged each billing cycle |
+| `free_months` | Number of initial months during which no charge is applied (default: 0) |
+| `requires_orders` | When enabled, billing only occurs for months in which the seller had at least one order |
+| `metadata` | Arbitrary JSON metadata |
+
+
+### How the Default Plan Works
+
+When a new [seller](/v2/core-concepts/seller) account is approved, the system automatically assigns the default plan matching the seller's currency. The seller begins their subscription immediately, starting with any configured free months.
+
+The `requires_orders` flag is designed for marketplaces that want to avoid charging inactive sellers. When this flag is set, a billing cycle with zero orders produces no invoice — the seller is effectively not charged for that month.
+
+## Per-Seller Overrides
+
+The operator can override subscription terms for **individual sellers**. An override is linked to a plan and identified by a `reference` / `reference_id` pair (e.g. referencing a specific seller). Each seller can have at most one override per plan. Override fields take precedence over the default plan when present:
+
+
+| Field | Description |
+| ---------------- | ------------------------------------------------------------------------------------- |
+| `monthly_amount` | Custom recurring fee (nullable — when null, the plan's amount applies) |
+| `free_months` | Custom number of free initial months (nullable — when null, the plan's value applies) |
+| `free_from` | Start date of a temporary free period |
+| `free_to` | End date of a temporary free period |
+| `metadata` | Arbitrary JSON metadata |
+
+
+The `free_from` / `free_to` date range allows **time-bound fee waivers** independent of the initial free months. This is useful for granting temporary relief without permanently changing the seller's subscription terms.
+
+Overrides are managed through the admin dashboard and can be applied at any time during the seller's lifecycle. They are commonly used for:
+
+- **Promotional onboarding** — Offering an extended free trial to attract high-value sellers
+- **Negotiated rates** — Enterprise or high-volume sellers may negotiate custom pricing
+- **Temporary relief** — Waiving fees for a specific date range during platform incidents or market disruptions
+
+## Billing Rules
+
+### Billing Cycle
+
+Subscriptions are billed on a **monthly anniversary** basis. The cycle starts on the date the seller's account was approved, and each subsequent billing occurs on the same day of the month.
+
+If the start date falls on the 29th, 30th, or 31st, billing rolls to the last day of shorter months.
+
+### Billing Across Statuses
+
+Subscription billing continues regardless of the seller's [account status](/v2/core-concepts/seller), with one exception:
+
+
+| Status | Billed? | Notes |
+| ------------------ | ------- | ------------------------------------------------------- |
+| `open` | Yes | Normal billing |
+| `suspended` | Yes | Seller is still occupying platform resources |
+| `pending_approval` | No | Billing begins only after approval |
+| `terminated` | No | Final invoice issued at termination; no further billing |
+
+
+Suspended sellers **continue to be billed**. This is intentional — suspension is a temporary measure, and the seller retains their catalog, data, and platform presence. If the operator does not wish to charge a suspended seller, they can apply a per-seller override.
+
+### Negative Balance
+
+If a seller's subscription payment fails, the unpaid amount carries forward as a **negative balance**. The platform does not automatically retry payment. The outstanding amount is added to the next billing cycle's invoice.
+
+Persistent negative balances may be grounds for suspension or termination at the operator's discretion.
+
+## Relationship to Other Concepts
+
+- **Seller accounts** determine which default plan applies based on `currency_code` (see [Seller](/v2/core-concepts/seller))
+- Subscription status is independent of [member management](/v2/core-concepts/seller-members) — adding or removing members does not affect billing
diff --git a/packages/registry/package.json b/packages/registry/package.json
index 0af394bbf..50e562805 100644
--- a/packages/registry/package.json
+++ b/packages/registry/package.json
@@ -4,7 +4,6 @@
"private": true,
"type": "module",
"scripts": {
- "build": "tsc",
"dev": "tsc --watch",
"build:registry": "bunx @mercurjs/cli@latest registry:build",
"codegen": "bunx @mercurjs/cli@latest registry:codegen",
@@ -49,4 +48,4 @@
"@types/jest": "^29.5.13",
"jest": "^30.2.0"
}
-}
+}
\ No newline at end of file
diff --git a/packages/registry/r/registry.json b/packages/registry/r/registry.json
index 991a14c0d..ffcd12086 100644
--- a/packages/registry/r/registry.json
+++ b/packages/registry/r/registry.json
@@ -297,185 +297,6 @@
"vendor"
]
},
- {
- "name": "team-management",
- "description": "Team member management with invitations, roles, and vendor portal pages.",
- "dependencies": [
- "jsonwebtoken",
- "@types/jsonwebtoken",
- "react-jwt"
- ],
- "registryDependencies": [],
- "docs": "## Configuration\n\nAdd the member module to your `medusa-config.ts`:\n\n```ts\nimport { ContainerRegistrationKeys } from \"@medusajs/framework/utils\"\n\nmodules: [\n {\n resolve: './modules/member',\n dependencies: [ContainerRegistrationKeys.QUERY],\n },\n]\n```\n\n## Middlewares\n\nAdd the team management middlewares to your `api/middlewares.ts`:\n\n```ts\nimport { defineMiddlewares } from \"@medusajs/medusa\";\nimport { vendorMembersMiddlewares } from \"./vendor/members/middlewares\";\nimport { vendorInvitesMiddlewares } from \"./vendor/invites/middlewares\";\n\nexport default defineMiddlewares({\n routes: [...vendorMembersMiddlewares, ...vendorInvitesMiddlewares],\n});\n```\n\nIf you already have a `middlewares.ts` file, merge the middleware imports and spread them into your existing `routes` array.\n\n## Database Migrations\n\nAfter installing the block and adding the module configuration, generate and run the migrations to create the necessary tables in your database:\n\n```bash\nnpx medusa db:generate member\nnpx medusa db:migrate\n```\n\n## Run codegen\n\nAfter installing the block, regenerate SDK types:\n\n```bash\nnpx @mercurjs/cli@latest codegen\n```",
- "files": [
- {
- "path": "team-management/modules/member/index.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/modules/member/service.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/modules/member/types.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/modules/member/models/member.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/modules/member/models/member-invite.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/workflows/member/steps/create-member.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/workflows/member/steps/update-member.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/workflows/member/steps/delete-member.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/workflows/member/steps/create-member-invite.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/workflows/member/steps/validate-member-invite.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/workflows/member/steps/update-member-invite.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/workflows/member/steps/delete-member-invite.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/workflows/member/workflows/invite-member.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/workflows/member/workflows/accept-member-invite.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/workflows/member/workflows/update-member.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/workflows/member/workflows/delete-member.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/workflows/member/workflows/delete-member-invite.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/workflows/hooks/seller-created.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/api/vendor/members/helpers.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/api/vendor/members/query-config.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/api/vendor/members/validators.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/api/vendor/members/middlewares.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/api/vendor/members/route.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/api/vendor/members/[id]/route.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/api/vendor/members/me/route.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/api/vendor/invites/query-config.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/api/vendor/invites/validators.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/api/vendor/invites/middlewares.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/api/vendor/invites/route.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/api/vendor/invites/accept/route.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/vendor/hooks/api/members.tsx",
- "type": "registry:vendor"
- },
- {
- "path": "team-management/vendor/hooks/api/invites.tsx",
- "type": "registry:vendor"
- },
- {
- "path": "team-management/vendor/hooks/table/columns/use-member-table-columns.tsx",
- "type": "registry:vendor"
- },
- {
- "path": "team-management/vendor/hooks/table/query/use-member-table-query.tsx",
- "type": "registry:vendor"
- },
- {
- "path": "team-management/vendor/routes/settings/users/page.tsx",
- "type": "registry:vendor"
- },
- {
- "path": "team-management/vendor/routes/settings/users/[id]/page.tsx",
- "type": "registry:vendor"
- },
- {
- "path": "team-management/vendor/routes/settings/users/[id]/breadcrumb.tsx",
- "type": "registry:vendor"
- },
- {
- "path": "team-management/vendor/routes/settings/users/[id]/edit/page.tsx",
- "type": "registry:vendor"
- },
- {
- "path": "team-management/vendor/routes/settings/users/invite/page.tsx",
- "type": "registry:vendor"
- },
- {
- "path": "team-management/vendor/routes/invite/page.tsx",
- "type": "registry:vendor"
- }
- ],
- "categories": [
- "module",
- "workflow",
- "api",
- "vendor"
- ]
- },
{
"name": "wishlist",
"description": "Customer wishlist with product bookmarking, pricing context, and store API endpoints.",
diff --git a/packages/registry/r/team-management.json b/packages/registry/r/team-management.json
index f64fbfc7d..1379e38eb 100644
--- a/packages/registry/r/team-management.json
+++ b/packages/registry/r/team-management.json
@@ -18,202 +18,162 @@
"files": [
{
"path": "team-management/modules/member/index.ts",
- "content": "import { Module } from \"@medusajs/framework/utils\"\n\nimport MemberModuleService from \"./service\"\n\nexport const MEMBER_MODULE = \"member\"\n\nexport * from \"./types\"\nexport { MemberModuleService }\n\nexport default Module(MEMBER_MODULE, {\n service: MemberModuleService,\n})\n",
"type": "registry:api"
},
{
"path": "team-management/modules/member/service.ts",
- "content": "import jwt, { JwtPayload } from \"jsonwebtoken\"\n\nimport { ConfigModule } from \"@medusajs/framework\"\nimport { Context } from \"@medusajs/framework/types\"\nimport {\n InjectTransactionManager,\n MedusaContext,\n MedusaError,\n MedusaService,\n} from \"@medusajs/framework/utils\"\n\nimport { Member } from \"./models/member\"\nimport { MemberInvite } from \"./models/member-invite\"\nimport { CreateMemberInviteDTO, MemberInviteDTO } from \"./types\"\n\nconst MEMBER_MODULE = \"member\"\n\ntype InjectedDependencies = {\n configModule: ConfigModule\n}\n\n// 7 days in ms\nconst DEFAULT_VALID_INVITE_DURATION = 1000 * 60 * 60 * 24 * 7\n\nclass MemberModuleService extends MedusaService({\n Member,\n MemberInvite,\n}) {\n private readonly httpConfig_: ConfigModule[\"projectConfig\"][\"http\"]\n private readonly validInviteDuration_: number\n\n constructor({ configModule }: InjectedDependencies) {\n super(...arguments)\n\n this.httpConfig_ = configModule.projectConfig.http\n\n const moduleDef = configModule.modules?.[MEMBER_MODULE]\n const options =\n typeof moduleDef !== \"boolean\"\n ? (moduleDef?.options as { validInviteDuration?: number })\n : null\n\n this.validInviteDuration_ =\n options?.validInviteDuration ?? DEFAULT_VALID_INVITE_DURATION\n }\n\n async validateInviteToken(token: string) {\n const jwtSecret = this.httpConfig_.jwtSecret as string\n const decoded: JwtPayload = jwt.verify(token, jwtSecret, {\n complete: true,\n })\n\n const invite = await this.retrieveMemberInvite(decoded.payload.id, {})\n\n if (invite.accepted) {\n throw new MedusaError(\n MedusaError.Types.INVALID_DATA,\n \"The invite has already been accepted\"\n )\n }\n\n if (invite.expires_at < new Date()) {\n throw new MedusaError(\n MedusaError.Types.INVALID_DATA,\n \"The invite has expired\"\n )\n }\n\n return invite\n }\n\n @InjectTransactionManager()\n // @ts-expect-error: createMemberInvites method already exists in base\n async createMemberInvites(\n input: CreateMemberInviteDTO | CreateMemberInviteDTO[],\n @MedusaContext() sharedContext: Context = {}\n ): Promise<MemberInviteDTO[]> {\n const data = Array.isArray(input) ? input : [input]\n\n const expires_at = new Date()\n expires_at.setMilliseconds(\n new Date().getMilliseconds() + DEFAULT_VALID_INVITE_DURATION\n )\n\n const toCreate = data.map((invite) => {\n return {\n ...invite,\n expires_at: new Date(),\n token: \"placeholder\",\n }\n })\n\n const created = await super.createMemberInvites(toCreate, sharedContext)\n const toUpdate = Array.isArray(created) ? created : [created]\n\n const updates = toUpdate.map((invite) => {\n return {\n ...invite,\n id: invite.id,\n expires_at,\n token: this.generateToken({ id: invite.id }),\n }\n })\n\n await this.updateMemberInvites(updates, sharedContext)\n\n return updates\n }\n\n private generateToken(data: { id: string }): string {\n const jwtSecret = this.httpConfig_.jwtSecret as string\n return jwt.sign(data, jwtSecret, {\n expiresIn: this.validInviteDuration_ / 1000,\n })\n }\n}\n\nexport default MemberModuleService\n",
"type": "registry:api"
},
{
"path": "team-management/modules/member/types.ts",
- "content": "export type MemberRole = \"owner\" | \"admin\" | \"member\"\n\nexport const MemberRole = {\n OWNER: \"owner\",\n ADMIN: \"admin\",\n MEMBER: \"member\",\n} as const\n\nexport type CreateMemberDTO = {\n seller_id: string\n name: string\n email?: string\n role?: MemberRole\n bio?: string\n phone?: string\n photo?: string\n}\n\nexport type UpdateMemberDTO = {\n id: string\n name?: string\n bio?: string\n phone?: string\n photo?: string\n}\n\nexport type CreateMemberInviteDTO = {\n email: string\n role?: MemberRole\n seller_id: string\n}\n\nexport type UpdateMemberInviteDTO = {\n id: string\n accepted?: boolean\n}\n\nexport type AcceptMemberInviteDTO = {\n token: string\n name: string\n}\n\nexport type MemberDTO = {\n id: string\n role: MemberRole\n name: string\n email: string | null\n bio: string | null\n phone: string | null\n photo: string | null\n seller_id: string\n}\n\nexport type MemberInviteDTO = {\n id: string\n email: string\n role: MemberRole\n token: string\n expires_at: Date | string\n accepted: boolean\n seller_id: string\n}\n\nexport type VendorMemberListResponse = {\n members: MemberDTO[]\n count: number\n offset: number\n limit: number\n}\n\nexport type VendorMemberResponse = {\n member: MemberDTO\n}\n\nexport type VendorMemberInviteListResponse = {\n invites: MemberInviteDTO[]\n count: number\n offset: number\n limit: number\n}\n\nexport type VendorMemberInviteResponse = {\n invite: MemberInviteDTO\n}\n",
"type": "registry:api"
},
{
"path": "team-management/modules/member/models/member.ts",
- "content": "import { model } from \"@medusajs/framework/utils\"\n\nexport const Member = model.define(\"member\", {\n id: model.id({ prefix: \"mem\" }).primaryKey(),\n seller_id: model.text(),\n role: model.enum([\"owner\", \"admin\", \"member\"]).default(\"owner\"),\n name: model.text().searchable(),\n email: model.text().nullable(),\n bio: model.text().searchable().nullable(),\n phone: model.text().searchable().nullable(),\n photo: model.text().nullable(),\n})\n",
"type": "registry:api"
},
{
"path": "team-management/modules/member/models/member-invite.ts",
- "content": "import { model } from \"@medusajs/framework/utils\"\n\nexport const MemberInvite = model.define(\"member_invite\", {\n id: model.id({ prefix: \"meminv\" }).primaryKey(),\n seller_id: model.text(),\n email: model.text(),\n role: model.enum([\"owner\", \"admin\", \"member\"]).default(\"owner\"),\n token: model.text(),\n expires_at: model.dateTime(),\n accepted: model.boolean().default(false),\n})\n",
"type": "registry:api"
},
{
"path": "team-management/workflows/member/steps/create-member.ts",
- "content": "import { StepResponse, createStep } from \"@medusajs/framework/workflows-sdk\"\n\nimport { CreateMemberDTO, MEMBER_MODULE, MemberModuleService } from \"../../../modules/member\"\n\nexport const createMemberStep = createStep(\n \"create-member\",\n async (input: CreateMemberDTO, { container }) => {\n const service = container.resolve<MemberModuleService>(MEMBER_MODULE)\n\n const member = await service.createMembers(input)\n\n return new StepResponse(member, member.id)\n },\n async (memberId: string | undefined, { container }) => {\n if (!memberId) return\n\n const service = container.resolve<MemberModuleService>(MEMBER_MODULE)\n\n await service.deleteMembers([memberId])\n }\n)\n",
"type": "registry:api"
},
{
"path": "team-management/workflows/member/steps/update-member.ts",
- "content": "import { StepResponse, createStep } from \"@medusajs/framework/workflows-sdk\"\n\nimport { UpdateMemberDTO, MEMBER_MODULE, MemberModuleService } from \"../../../modules/member\"\n\nexport const updateMemberStep = createStep(\n \"update-member\",\n async (input: UpdateMemberDTO, { container }) => {\n const service = container.resolve<MemberModuleService>(MEMBER_MODULE)\n\n const previousData = await service.retrieveMember(input.id)\n\n const updatedMember = await service.updateMembers(input)\n\n return new StepResponse(updatedMember, previousData)\n },\n async (previousData, { container }) => {\n if (!previousData) return\n const service = container.resolve<MemberModuleService>(MEMBER_MODULE)\n\n await service.updateMembers(previousData)\n }\n)\n",
"type": "registry:api"
},
{
"path": "team-management/workflows/member/steps/delete-member.ts",
- "content": "import { MedusaError } from \"@medusajs/framework/utils\"\nimport { StepResponse, createStep } from \"@medusajs/framework/workflows-sdk\"\n\nimport { MemberRole, MEMBER_MODULE, MemberModuleService } from \"../../../modules/member\"\n\nexport const deleteMemberStep = createStep(\n \"delete-member\",\n async (id: string, { container }) => {\n const service = container.resolve<MemberModuleService>(MEMBER_MODULE)\n\n const member = await service.retrieveMember(id)\n\n if (member.role === MemberRole.OWNER) {\n throw new MedusaError(\n MedusaError.Types.INVALID_DATA,\n \"Owner member cannot be deleted\"\n )\n }\n\n await service.softDeleteMembers(id)\n\n return new StepResponse(id)\n },\n async (memberId: string | undefined, { container }) => {\n if (!memberId) return\n\n const service = container.resolve<MemberModuleService>(MEMBER_MODULE)\n\n await service.restoreMembers(memberId)\n }\n)\n",
"type": "registry:api"
},
{
"path": "team-management/workflows/member/steps/create-member-invite.ts",
- "content": "import { StepResponse, createStep } from \"@medusajs/framework/workflows-sdk\"\n\nimport { CreateMemberInviteDTO, MEMBER_MODULE, MemberModuleService } from \"../../../modules/member\"\n\nexport const createMemberInviteStep = createStep(\n \"create-member-invite\",\n async (input: CreateMemberInviteDTO, { container }) => {\n const service = container.resolve<MemberModuleService>(MEMBER_MODULE)\n\n const [memberInvite] = await service.createMemberInvites(input)\n\n return new StepResponse(memberInvite, memberInvite?.id ?? \"\")\n },\n async (memberInviteId: string | undefined, { container }) => {\n if (!memberInviteId) return\n\n const service = container.resolve<MemberModuleService>(MEMBER_MODULE)\n\n await service.deleteMemberInvites([memberInviteId as string])\n }\n)\n",
"type": "registry:api"
},
{
"path": "team-management/workflows/member/steps/validate-member-invite.ts",
- "content": "import { StepResponse, createStep } from \"@medusajs/framework/workflows-sdk\"\n\nimport { AcceptMemberInviteDTO, MEMBER_MODULE, MemberModuleService } from \"../../../modules/member\"\n\nexport const validateMemberInviteStep = createStep(\n \"validate-member-invite\",\n async (input: AcceptMemberInviteDTO, { container }) => {\n const service = container.resolve<MemberModuleService>(MEMBER_MODULE)\n\n const invite = await service.validateInviteToken(input.token)\n\n return new StepResponse(invite)\n }\n)\n",
"type": "registry:api"
},
{
"path": "team-management/workflows/member/steps/update-member-invite.ts",
- "content": "import { StepResponse, createStep } from \"@medusajs/framework/workflows-sdk\"\n\nimport { UpdateMemberInviteDTO, MEMBER_MODULE, MemberModuleService } from \"../../../modules/member\"\n\nexport const updateMemberInviteStep = createStep(\n \"update-member-invite\",\n async (input: UpdateMemberInviteDTO, { container }) => {\n const service = container.resolve<MemberModuleService>(MEMBER_MODULE)\n\n const previousData = await service.retrieveMemberInvite(input.id)\n\n const updatedInvites = await service.updateMemberInvites(input)\n\n return new StepResponse(updatedInvites, previousData)\n },\n async (previousData: Record<string, unknown> | undefined, { container }) => {\n if (!previousData) return\n\n const service = container.resolve<MemberModuleService>(MEMBER_MODULE)\n await service.updateMemberInvites(previousData)\n }\n)\n",
"type": "registry:api"
},
{
"path": "team-management/workflows/member/steps/delete-member-invite.ts",
- "content": "import { StepResponse, createStep } from \"@medusajs/framework/workflows-sdk\"\n\nimport { MEMBER_MODULE, MemberModuleService } from \"../../../modules/member\"\n\nexport const deleteMemberInvitesStep = createStep(\n \"delete-member-invite\",\n async (id: string, { container }) => {\n const service = container.resolve<MemberModuleService>(MEMBER_MODULE)\n\n await service.softDeleteMemberInvites(id)\n\n return new StepResponse(id)\n },\n async (inviteId: string | undefined, { container }) => {\n if (!inviteId) return\n\n const service = container.resolve<MemberModuleService>(MEMBER_MODULE)\n\n await service.restoreMemberInvites(inviteId)\n }\n)\n",
"type": "registry:api"
},
{
"path": "team-management/workflows/member/workflows/invite-member.ts",
- "content": "import { WorkflowResponse, createWorkflow } from \"@medusajs/framework/workflows-sdk\"\n\nimport { CreateMemberInviteDTO } from \"../../../modules/member\"\nimport { createMemberInviteStep } from \"../steps/create-member-invite\"\n\nexport const inviteMemberWorkflow = createWorkflow(\n \"invite-member\",\n function (input: CreateMemberInviteDTO) {\n const invite = createMemberInviteStep(input)\n\n return new WorkflowResponse(invite)\n }\n)\n",
"type": "registry:api"
},
{
"path": "team-management/workflows/member/workflows/accept-member-invite.ts",
- "content": "import { parallelize } from \"@medusajs/framework/workflows-sdk\"\nimport { setAuthAppMetadataStep } from \"@medusajs/medusa/core-flows\"\nimport { WorkflowResponse, createWorkflow } from \"@medusajs/framework/workflows-sdk\"\n\nimport { AcceptMemberInviteDTO } from \"../../../modules/member\"\nimport { createMemberStep } from \"../steps/create-member\"\nimport { updateMemberInviteStep } from \"../steps/update-member-invite\"\nimport { validateMemberInviteStep } from \"../steps/validate-member-invite\"\n\ntype AcceptMemberInviteWorkflowInput = {\n invite: AcceptMemberInviteDTO\n authIdentityId: string\n}\n\nexport const acceptMemberInviteWorkflow = createWorkflow(\n \"accept-member-invite\",\n function (input: AcceptMemberInviteWorkflowInput) {\n const invite = validateMemberInviteStep(input.invite)\n\n const [member] = parallelize(\n createMemberStep({\n seller_id: invite.seller_id,\n name: input.invite.name,\n role: invite.role,\n email: invite.email,\n }),\n updateMemberInviteStep({\n id: invite.id,\n accepted: true,\n })\n )\n\n // link seller to auth identity\n setAuthAppMetadataStep({\n authIdentityId: input.authIdentityId,\n actorType: \"seller\",\n value: member.seller_id,\n }).config({\n name: \"link-seller-to-auth-identity\",\n })\n\n // link member to auth identity\n setAuthAppMetadataStep({\n authIdentityId: input.authIdentityId,\n actorType: \"member\",\n value: member.id,\n }).config({\n name: \"link-member-to-auth-identity\",\n })\n\n return new WorkflowResponse(invite)\n }\n)\n",
"type": "registry:api"
},
{
"path": "team-management/workflows/member/workflows/update-member.ts",
- "content": "import { WorkflowResponse, createWorkflow } from \"@medusajs/framework/workflows-sdk\"\n\nimport { UpdateMemberDTO } from \"../../../modules/member\"\nimport { updateMemberStep } from \"../steps/update-member\"\n\nexport const updateMemberWorkflow = createWorkflow(\n \"update-member\",\n function (input: UpdateMemberDTO) {\n return new WorkflowResponse(updateMemberStep(input))\n }\n)\n",
"type": "registry:api"
},
{
"path": "team-management/workflows/member/workflows/delete-member.ts",
- "content": "import { createWorkflow } from \"@medusajs/framework/workflows-sdk\"\n\nimport { deleteMemberStep } from \"../steps/delete-member\"\n\nexport const deleteMemberWorkflow = createWorkflow(\n \"delete-member\",\n function (id: string) {\n deleteMemberStep(id)\n }\n)\n",
"type": "registry:api"
},
{
"path": "team-management/workflows/member/workflows/delete-member-invite.ts",
- "content": "import { createWorkflow } from \"@medusajs/framework/workflows-sdk\"\n\nimport { deleteMemberInvitesStep } from \"../steps/delete-member-invite\"\n\nexport const deleteMemberInviteWorkflow = createWorkflow(\n \"delete-member-invite\",\n function (id: string) {\n deleteMemberInvitesStep(id)\n }\n)\n",
"type": "registry:api"
},
{
"path": "team-management/workflows/hooks/seller-created.ts",
- "content": "import { StepResponse } from \"@medusajs/framework/workflows-sdk\"\nimport { Modules } from \"@medusajs/framework/utils\"\nimport { IAuthModuleService } from \"@medusajs/framework/types\"\n\nimport { createSellerWorkflow } from \"@mercurjs/core-plugin/workflows\"\nimport { MEMBER_MODULE, MemberModuleService } from \"../../modules/member\"\n\ncreateSellerWorkflow.hooks.sellerCreated(\n async ({ seller, auth_identity_id }, { container }) => {\n const memberService =\n container.resolve<MemberModuleService>(MEMBER_MODULE)\n\n const member = await memberService.createMembers({\n seller_id: seller.id,\n name: seller.name,\n role: \"owner\",\n })\n\n const authModule =\n container.resolve<IAuthModuleService>(Modules.AUTH)\n\n const authIdentity = await authModule.retrieveAuthIdentity(auth_identity_id)\n\n await authModule.updateAuthIdentities({\n id: auth_identity_id,\n app_metadata: {\n ...authIdentity.app_metadata,\n member_id: member.id,\n },\n })\n\n return new StepResponse(member, {\n member_id: member.id,\n auth_identity_id,\n previous_app_metadata: authIdentity.app_metadata,\n })\n },\n async (data, { container }) => {\n if (!data) return\n\n const memberService =\n container.resolve<MemberModuleService>(MEMBER_MODULE)\n\n await memberService.deleteMembers([data.member_id])\n\n const authModule =\n container.resolve<IAuthModuleService>(Modules.AUTH)\n\n await authModule.updateAuthIdentities({\n id: data.auth_identity_id,\n app_metadata: data.previous_app_metadata,\n })\n }\n)\n",
"type": "registry:api"
},
{
"path": "team-management/api/vendor/members/helpers.ts",
- "content": "import {\n AuthenticatedMedusaRequest,\n MedusaNextFunction,\n MedusaResponse,\n} from \"@medusajs/framework/http\"\nimport { MedusaContainer } from \"@medusajs/framework/types\"\nimport {\n ContainerRegistrationKeys,\n MedusaError,\n} from \"@medusajs/framework/utils\"\n\nexport const applySellerMemberFilter = (\n req: AuthenticatedMedusaRequest,\n _res: MedusaResponse,\n next: MedusaNextFunction\n) => {\n req.filterableFields.seller_id = req.auth_context.actor_id\n next()\n}\n\nexport const validateSellerMember = async (\n scope: MedusaContainer,\n sellerId: string,\n memberId: string\n) => {\n const query = scope.resolve(ContainerRegistrationKeys.QUERY)\n\n const {\n data: [member],\n } = await query.graph({\n entity: \"member\",\n filters: {\n id: memberId,\n seller_id: sellerId,\n },\n fields: [\"id\"],\n })\n\n if (!member) {\n throw new MedusaError(\n MedusaError.Types.NOT_FOUND,\n `Member with id: ${memberId} was not found`\n )\n }\n}\n\nexport const fetchSellerByAuthActorId = async (\n authActorId: string,\n scope: MedusaContainer,\n fields: string[] = [\"id\"]\n) => {\n const query = scope.resolve(ContainerRegistrationKeys.QUERY)\n\n const {\n data: [seller],\n } = await query.graph({\n entity: \"seller\",\n filters: { id: authActorId },\n fields,\n })\n\n return seller\n}\n",
"type": "registry:api"
},
{
"path": "team-management/api/vendor/members/query-config.ts",
- "content": "export const vendorMemberFields = [\n \"id\",\n \"email\",\n \"role\",\n \"name\",\n \"bio\",\n \"phone\",\n \"photo\",\n \"seller_id\",\n]\n\nexport const vendorMemberQueryConfig = {\n list: {\n defaults: vendorMemberFields,\n isList: true,\n },\n retrieve: {\n defaults: vendorMemberFields,\n isList: false,\n },\n}\n",
"type": "registry:api"
},
{
"path": "team-management/api/vendor/members/validators.ts",
- "content": "import { z } from \"zod\"\n\nimport { createFindParams } from \"@medusajs/medusa/api/utils/validators\"\n\nexport type VendorGetMemberParamsType = z.infer<typeof VendorGetMemberParams>\nexport const VendorGetMemberParams = createFindParams({\n offset: 0,\n limit: 50,\n}).merge(\n z.object({\n q: z.string().optional(),\n })\n)\n\nexport type VendorUpdateMemberType = z.infer<typeof VendorUpdateMember>\nexport const VendorUpdateMember = z\n .object({\n name: z.string().optional(),\n bio: z.string().optional(),\n phone: z.string().optional(),\n photo: z.string().optional(),\n })\n .strict()\n",
"type": "registry:api"
},
{
"path": "team-management/api/vendor/members/middlewares.ts",
- "content": "import {\n validateAndTransformBody,\n validateAndTransformQuery,\n} from \"@medusajs/framework\"\nimport { MiddlewareRoute } from \"@medusajs/framework/http\"\n\nimport { applySellerMemberFilter } from \"./helpers\"\nimport { vendorMemberQueryConfig } from \"./query-config\"\nimport { VendorGetMemberParams, VendorUpdateMember } from \"./validators\"\n\nexport const vendorMembersMiddlewares: MiddlewareRoute[] = [\n {\n method: [\"GET\"],\n matcher: \"/vendor/members/me\",\n middlewares: [\n validateAndTransformQuery(\n VendorGetMemberParams,\n vendorMemberQueryConfig.retrieve\n ),\n ],\n },\n {\n method: [\"GET\"],\n matcher: \"/vendor/members\",\n middlewares: [\n validateAndTransformQuery(\n VendorGetMemberParams,\n vendorMemberQueryConfig.list\n ),\n applySellerMemberFilter,\n ],\n },\n {\n method: [\"GET\"],\n matcher: \"/vendor/members/:id\",\n middlewares: [\n validateAndTransformQuery(\n VendorGetMemberParams,\n vendorMemberQueryConfig.retrieve\n ),\n ],\n },\n {\n method: [\"POST\"],\n matcher: \"/vendor/members/:id\",\n middlewares: [\n validateAndTransformQuery(\n VendorGetMemberParams,\n vendorMemberQueryConfig.retrieve\n ),\n validateAndTransformBody(VendorUpdateMember),\n ],\n },\n {\n method: [\"DELETE\"],\n matcher: \"/vendor/members/:id\",\n middlewares: [\n ],\n },\n]\n",
"type": "registry:api"
},
{
"path": "team-management/api/vendor/members/route.ts",
- "content": "import {\n AuthenticatedMedusaRequest,\n MedusaResponse,\n} from \"@medusajs/framework\"\nimport { ContainerRegistrationKeys } from \"@medusajs/framework/utils\"\n\nimport { VendorMemberListResponse } from \"../../../modules/member\"\n\nexport const GET = async (\n req: AuthenticatedMedusaRequest,\n res: MedusaResponse<VendorMemberListResponse>\n) => {\n const query = req.scope.resolve(ContainerRegistrationKeys.QUERY)\n\n const { data: members, metadata } = await query.graph({\n entity: \"member\",\n fields: req.queryConfig.fields,\n filters: req.filterableFields,\n pagination: req.queryConfig.pagination,\n })\n\n res.json({\n members,\n count: metadata?.count ?? 0,\n offset: metadata?.skip ?? 0,\n limit: metadata?.take ?? 0,\n })\n}\n",
"type": "registry:api"
},
{
"path": "team-management/api/vendor/members/[id]/route.ts",
- "content": "import {\n AuthenticatedMedusaRequest,\n MedusaResponse,\n} from \"@medusajs/framework\"\nimport { ContainerRegistrationKeys } from \"@medusajs/framework/utils\"\n\nimport { VendorMemberResponse } from \"../../../../modules/member\"\nimport { deleteMemberWorkflow } from \"../../../../workflows/member/workflows/delete-member\"\nimport { updateMemberWorkflow } from \"../../../../workflows/member/workflows/update-member\"\nimport { validateSellerMember } from \"../helpers\"\nimport { VendorUpdateMemberType } from \"../validators\"\n\nexport const GET = async (\n req: AuthenticatedMedusaRequest,\n res: MedusaResponse<VendorMemberResponse>\n) => {\n const { id } = req.params\n await validateSellerMember(req.scope, req.auth_context.actor_id, id!)\n\n const query = req.scope.resolve(ContainerRegistrationKeys.QUERY)\n const {\n data: [member],\n } = await query.graph(\n {\n entity: \"member\",\n fields: req.queryConfig.fields,\n filters: { id },\n },\n { throwIfKeyNotFound: true }\n )\n\n res.json({ member })\n}\n\nexport const POST = async (\n req: AuthenticatedMedusaRequest<VendorUpdateMemberType>,\n res: MedusaResponse<VendorMemberResponse>\n) => {\n const { id } = req.params\n await validateSellerMember(req.scope, req.auth_context.actor_id, id!)\n\n const query = req.scope.resolve(ContainerRegistrationKeys.QUERY)\n\n await updateMemberWorkflow(req.scope).run({\n input: {\n id: id!,\n ...req.validatedBody,\n },\n })\n\n const {\n data: [member],\n } = await query.graph(\n {\n entity: \"member\",\n fields: req.queryConfig.fields,\n filters: { id },\n },\n { throwIfKeyNotFound: true }\n )\n\n res.json({ member })\n}\n\nexport const DELETE = async (\n req: AuthenticatedMedusaRequest,\n res: MedusaResponse\n) => {\n const { id } = req.params\n await validateSellerMember(req.scope, req.auth_context.actor_id, id!)\n\n await deleteMemberWorkflow(req.scope).run({\n input: id,\n })\n\n res.json({\n id,\n object: \"member\",\n deleted: true,\n })\n}\n",
"type": "registry:api"
},
{
"path": "team-management/api/vendor/members/me/route.ts",
- "content": "import {\n AuthenticatedMedusaRequest,\n MedusaResponse,\n} from \"@medusajs/framework\"\nimport { ContainerRegistrationKeys } from \"@medusajs/framework/utils\"\n\nimport { VendorMemberResponse } from \"../../../../modules/member\"\n\nexport const GET = async (\n req: AuthenticatedMedusaRequest,\n res: MedusaResponse<VendorMemberResponse>\n) => {\n const memberId = req.auth_context.app_metadata.member_id as string\n\n const query = req.scope.resolve(ContainerRegistrationKeys.QUERY)\n const {\n data: [member],\n } = await query.graph(\n {\n entity: \"member\",\n fields: req.queryConfig.fields,\n filters: { id: memberId },\n },\n { throwIfKeyNotFound: true }\n )\n\n res.json({ member })\n}\n",
"type": "registry:api"
},
{
"path": "team-management/api/vendor/invites/query-config.ts",
- "content": "export const vendorMemberInviteFields = [\n \"id\",\n \"email\",\n \"role\",\n \"expires_at\",\n \"accepted\",\n \"seller_id\",\n]\n\nexport const vendorMemberInviteQueryConfig = {\n list: {\n defaults: vendorMemberInviteFields,\n isList: true,\n },\n retrieve: {\n defaults: vendorMemberInviteFields,\n isList: false,\n },\n}\n",
"type": "registry:api"
},
{
"path": "team-management/api/vendor/invites/validators.ts",
- "content": "import { z } from \"zod\"\n\nimport { createFindParams } from \"@medusajs/medusa/api/utils/validators\"\n\nexport type VendorGetMemberInviteParamsType = z.infer<\n typeof VendorGetMemberInviteParams\n>\nexport const VendorGetMemberInviteParams = createFindParams({\n offset: 0,\n limit: 50,\n})\n\nexport type VendorInviteMemberType = z.infer<typeof VendorInviteMember>\nexport const VendorInviteMember = z\n .object({\n email: z.string().email(),\n role: z.enum([\"owner\", \"admin\", \"member\"]),\n })\n .strict()\n\nexport type VendorAcceptMemberInviteType = z.infer<\n typeof VendorAcceptMemberInvite\n>\nexport const VendorAcceptMemberInvite = z\n .object({\n token: z.string(),\n name: z.string(),\n })\n .strict()\n",
"type": "registry:api"
},
{
"path": "team-management/api/vendor/invites/middlewares.ts",
- "content": "import {\n authenticate,\n validateAndTransformBody,\n validateAndTransformQuery,\n} from \"@medusajs/framework\"\nimport {\n AuthenticatedMedusaRequest,\n MedusaNextFunction,\n MedusaResponse,\n MiddlewareRoute,\n} from \"@medusajs/framework/http\"\n\nimport { vendorMemberInviteQueryConfig } from \"./query-config\"\nimport {\n VendorAcceptMemberInvite,\n VendorGetMemberInviteParams,\n VendorInviteMember,\n} from \"./validators\"\n\nconst applySellerInviteFilter = (\n req: AuthenticatedMedusaRequest,\n _res: MedusaResponse,\n next: MedusaNextFunction\n) => {\n req.filterableFields.seller_id = req.auth_context.actor_id\n next()\n}\n\nexport const vendorInvitesMiddlewares: MiddlewareRoute[] = [\n {\n method: [\"GET\"],\n matcher: \"/vendor/invites\",\n middlewares: [\n validateAndTransformQuery(\n VendorGetMemberInviteParams,\n vendorMemberInviteQueryConfig.list\n ),\n applySellerInviteFilter,\n ],\n },\n {\n method: [\"POST\"],\n matcher: \"/vendor/invites\",\n middlewares: [\n validateAndTransformBody(VendorInviteMember),\n validateAndTransformQuery(\n VendorGetMemberInviteParams,\n vendorMemberInviteQueryConfig.retrieve\n ),\n ],\n },\n {\n method: [\"POST\"],\n matcher: \"/vendor/invites/accept\",\n middlewares: [\n authenticate(\"seller\", [\"bearer\", \"session\"], {\n allowUnregistered: true,\n }),\n validateAndTransformBody(VendorAcceptMemberInvite),\n validateAndTransformQuery(\n VendorGetMemberInviteParams,\n vendorMemberInviteQueryConfig.retrieve\n ),\n ],\n },\n]\n",
"type": "registry:api"
},
{
"path": "team-management/api/vendor/invites/route.ts",
- "content": "import {\n AuthenticatedMedusaRequest,\n MedusaResponse,\n} from \"@medusajs/framework\"\nimport { ContainerRegistrationKeys } from \"@medusajs/framework/utils\"\n\nimport { VendorMemberInviteListResponse, VendorMemberInviteResponse } from \"../../../modules/member\"\nimport { inviteMemberWorkflow } from \"../../../workflows/member/workflows/invite-member\"\nimport { VendorInviteMemberType } from \"./validators\"\n\nexport const POST = async (\n req: AuthenticatedMedusaRequest<VendorInviteMemberType>,\n res: MedusaResponse<VendorMemberInviteResponse>\n) => {\n const query = req.scope.resolve(ContainerRegistrationKeys.QUERY)\n\n // actor_id IS seller_id (set by core-plugin auth)\n const sellerId = req.auth_context.actor_id\n\n const { result: created } = await inviteMemberWorkflow(req.scope).run({\n input: {\n ...req.validatedBody,\n seller_id: sellerId,\n },\n })\n\n const {\n data: [invite],\n } = await query.graph(\n {\n entity: \"member_invite\",\n fields: req.queryConfig.fields,\n filters: { id: created.id },\n },\n { throwIfKeyNotFound: true }\n )\n\n res.status(201).json({ invite })\n}\n\nexport const GET = async (\n req: AuthenticatedMedusaRequest,\n res: MedusaResponse<VendorMemberInviteListResponse>\n) => {\n const query = req.scope.resolve(ContainerRegistrationKeys.QUERY)\n\n const { data: invites, metadata } = await query.graph({\n entity: \"member_invite\",\n fields: req.queryConfig.fields,\n filters: req.filterableFields,\n pagination: req.queryConfig.pagination,\n })\n\n res.json({\n invites,\n count: metadata?.count ?? 0,\n offset: metadata?.skip ?? 0,\n limit: metadata?.take ?? 0,\n })\n}\n",
"type": "registry:api"
},
{
"path": "team-management/api/vendor/invites/accept/route.ts",
- "content": "import {\n AuthenticatedMedusaRequest,\n MedusaResponse,\n} from \"@medusajs/framework\"\nimport { ContainerRegistrationKeys } from \"@medusajs/framework/utils\"\n\nimport { VendorMemberInviteResponse } from \"../../../../modules/member\"\nimport { acceptMemberInviteWorkflow } from \"../../../../workflows/member/workflows/accept-member-invite\"\nimport { VendorAcceptMemberInviteType } from \"../validators\"\n\nexport const AUTHENTICATE = false\n\nexport const POST = async (\n req: AuthenticatedMedusaRequest<VendorAcceptMemberInviteType>,\n res: MedusaResponse<VendorMemberInviteResponse>\n) => {\n const query = req.scope.resolve(ContainerRegistrationKeys.QUERY)\n\n const { result } = await acceptMemberInviteWorkflow(req.scope).run({\n input: {\n invite: req.validatedBody,\n authIdentityId: req.auth_context.auth_identity_id,\n },\n })\n\n const {\n data: [invite],\n } = await query.graph(\n {\n entity: \"member_invite\",\n fields: req.queryConfig.fields,\n filters: { id: result.id },\n },\n { throwIfKeyNotFound: true }\n )\n\n res.json({ invite })\n}\n",
"type": "registry:api"
},
{
"path": "team-management/vendor/hooks/api/members.tsx",
- "content": "import {\n useMutation,\n useQuery,\n useQueryClient,\n} from \"@tanstack/react-query\"\nimport type { UseMutationOptions, UseQueryOptions } from \"@tanstack/react-query\"\nimport { queryKeysFactory } from \"@mercurjs/dashboard-shared\"\nimport { client } from \"../../lib/client\"\nimport type { ClientError, InferClientInput, InferClientOutput } from \"@mercurjs/client\"\n\nconst MEMBERS_QUERY_KEY = \"vendor_members\" as const\nexport const membersQueryKeys = queryKeysFactory(MEMBERS_QUERY_KEY)\n\nexport type MemberDTO = InferClientOutput<\n typeof client.vendor.members.$id.query\n>[\"member\"]\n\nexport const useMembers = (\n query?: InferClientInput<typeof client.vendor.members.query>,\n options?: Omit<\n UseQueryOptions<\n unknown,\n ClientError,\n InferClientOutput<typeof client.vendor.members.query>\n >,\n \"queryKey\" | \"queryFn\"\n >\n) => {\n const { data, ...rest } = useQuery({\n queryKey: membersQueryKeys.list(query),\n queryFn: async () =>\n client.vendor.members.query({\n ...query,\n }),\n ...options,\n })\n\n return { ...data, ...rest }\n}\n\nexport const useMember = (\n id: string,\n query?: InferClientInput<typeof client.vendor.members.$id.query>,\n options?: Omit<\n UseQueryOptions<\n unknown,\n ClientError,\n InferClientOutput<typeof client.vendor.members.$id.query>\n >,\n \"queryKey\" | \"queryFn\"\n >\n) => {\n const { data, ...rest } = useQuery({\n queryKey: membersQueryKeys.detail(id, query),\n queryFn: async () =>\n client.vendor.members.$id.query({\n $id: id,\n ...query,\n }),\n ...options,\n })\n\n return { ...data, ...rest }\n}\n\nexport const useUpdateMember = (\n id: string,\n options?: UseMutationOptions<\n InferClientOutput<typeof client.vendor.members.$id.mutate>,\n ClientError,\n Omit<InferClientInput<typeof client.vendor.members.$id.mutate>, \"$id\">\n >\n) => {\n const queryClient = useQueryClient()\n\n return useMutation({\n mutationFn: async (payload) =>\n client.vendor.members.$id.mutate({\n ...payload,\n $id: id,\n }),\n onSuccess: (data, variables, context) => {\n queryClient.invalidateQueries({\n queryKey: membersQueryKeys.detail(id),\n })\n queryClient.invalidateQueries({\n queryKey: membersQueryKeys.lists(),\n })\n options?.onSuccess?.(data, variables, context)\n },\n ...options,\n })\n}\n\nexport const useDeleteMember = (\n id: string,\n options?: UseMutationOptions<\n InferClientOutput<typeof client.vendor.members.$id.delete>,\n ClientError\n >\n) => {\n const queryClient = useQueryClient()\n\n return useMutation({\n mutationFn: async () =>\n client.vendor.members.$id.delete({\n $id: id,\n }),\n onSuccess: (data, variables, context) => {\n queryClient.invalidateQueries({\n queryKey: membersQueryKeys.detail(id),\n })\n queryClient.invalidateQueries({\n queryKey: membersQueryKeys.lists(),\n })\n options?.onSuccess?.(data, variables, context)\n },\n ...options,\n })\n}\n",
"type": "registry:vendor"
},
{
"path": "team-management/vendor/hooks/api/invites.tsx",
- "content": "import {\n useMutation,\n useQuery,\n useQueryClient,\n} from \"@tanstack/react-query\"\nimport type { UseMutationOptions, UseQueryOptions } from \"@tanstack/react-query\"\nimport { queryKeysFactory } from \"@mercurjs/dashboard-shared\"\nimport { client } from \"../../lib/client\"\nimport type { ClientError, InferClientInput, InferClientOutput } from \"@mercurjs/client\"\n\nconst INVITES_QUERY_KEY = \"vendor_invites\" as const\nexport const invitesQueryKeys = queryKeysFactory(INVITES_QUERY_KEY)\n\nexport const useInvites = (\n query?: InferClientInput<typeof client.vendor.invites.query>,\n options?: Omit<\n UseQueryOptions<\n unknown,\n ClientError,\n InferClientOutput<typeof client.vendor.invites.query>\n >,\n \"queryKey\" | \"queryFn\"\n >\n) => {\n const { data, ...rest } = useQuery({\n queryKey: invitesQueryKeys.list(query),\n queryFn: async () =>\n client.vendor.invites.query({\n ...query,\n }),\n ...options,\n })\n\n return { ...data, ...rest }\n}\n\nexport const useCreateInvite = (\n options?: UseMutationOptions<\n InferClientOutput<typeof client.vendor.invites.mutate>,\n ClientError,\n { email: string }\n >\n) => {\n const queryClient = useQueryClient()\n\n return useMutation({\n mutationFn: async (payload) =>\n client.vendor.invites.mutate({\n ...payload,\n role: \"member\",\n }),\n onSuccess: (data, variables, context) => {\n queryClient.invalidateQueries({\n queryKey: invitesQueryKeys.lists(),\n })\n options?.onSuccess?.(data, variables, context)\n },\n ...options,\n })\n}\n\nexport const useSignUpForInvite = (\n options?: UseMutationOptions<\n InferClientOutput<typeof client.auth.$actorType.$authProvider.register.mutate>,\n ClientError,\n Omit<\n InferClientInput<typeof client.auth.$actorType.$authProvider.register.mutate>,\n \"$actorType\" | \"$authProvider\"\n >\n >\n) => {\n return useMutation({\n mutationFn: (payload) =>\n client.auth.$actorType.$authProvider.register.mutate({\n $actorType: \"seller\",\n $authProvider: \"emailpass\",\n ...payload,\n }),\n ...options,\n })\n}\n\nexport const useAcceptInvite = (\n inviteToken: string,\n options?: UseMutationOptions<\n unknown,\n ClientError,\n { name: string; auth_token: string }\n >\n) => {\n return useMutation({\n mutationFn: async (payload) => {\n const { auth_token, ...rest } = payload\n\n return client.vendor.invites.accept.mutate({\n token: inviteToken,\n ...rest,\n fetchOptions: {\n headers: {\n Authorization: `Bearer ${auth_token}`,\n },\n },\n })\n },\n ...options,\n })\n}\n",
"type": "registry:vendor"
},
{
"path": "team-management/vendor/hooks/table/columns/use-member-table-columns.tsx",
- "content": "import { createColumnHelper } from \"@tanstack/react-table\"\nimport { useMemo } from \"react\"\nimport { Text } from \"@medusajs/ui\"\nimport type { MemberDTO } from \"../../api/members\"\n\nconst columnHelper = createColumnHelper<MemberDTO>()\n\nexport const useMemberTableColumns = () => {\n return useMemo(\n () => [\n columnHelper.accessor(\"email\", {\n header: () => (\n <div className=\"flex h-full w-full items-center\">\n <span className=\"truncate\">Email</span>\n </div>\n ),\n cell: ({ getValue }) => {\n const email = getValue()\n return (\n <Text size=\"small\" leading=\"compact\" className=\"text-ui-fg-subtle\">\n {email || \"-\"}\n </Text>\n )\n },\n }),\n columnHelper.accessor(\"name\", {\n header: () => (\n <div className=\"flex h-full w-full items-center\">\n <span className=\"truncate\">Name</span>\n </div>\n ),\n cell: ({ getValue }) => {\n const name = getValue()\n return (\n <Text size=\"small\" leading=\"compact\" className=\"text-ui-fg-subtle\">\n {name || \"-\"}\n </Text>\n )\n },\n }),\n ],\n []\n )\n}\n",
"type": "registry:vendor"
},
{
"path": "team-management/vendor/hooks/table/query/use-member-table-query.tsx",
- "content": "import { useQueryParams } from \"@mercurjs/dashboard-shared\"\n\ntype UseMemberTableQueryProps = {\n prefix?: string\n pageSize?: number\n}\n\nexport const useMemberTableQuery = ({\n prefix,\n pageSize = 20,\n}: UseMemberTableQueryProps) => {\n const queryObject = useQueryParams(\n [\"offset\", \"q\", \"order\"],\n prefix\n )\n\n const { offset, q, order } = queryObject\n\n const searchParams: Record<string, any> = {\n limit: pageSize,\n offset: offset ? Number(offset) : 0,\n order: order ? order : \"-created_at\",\n q,\n }\n\n return {\n searchParams,\n raw: queryObject,\n }\n}\n",
"type": "registry:vendor"
},
{
"path": "team-management/vendor/routes/settings/users/page.tsx",
- "content": "import { keepPreviousData } from \"@tanstack/react-query\"\nimport { Container, Heading, Button } from \"@medusajs/ui\"\nimport { Link } from \"react-router-dom\"\nimport { PlusMini, Users } from \"@medusajs/icons\"\n\nimport { _DataTable, SingleColumnPage } from \"@mercurjs/dashboard-shared\"\nimport { useDataTable } from \"@mercurjs/dashboard-shared\"\nimport { useMembers } from \"../../../hooks/api/members\"\nimport { useMemberTableColumns } from \"../../../hooks/table/columns/use-member-table-columns\"\nimport { useMemberTableQuery } from \"../../../hooks/table/query/use-member-table-query\"\n\nexport const config = {\n label: \"Team\",\n icon: Users,\n}\n\nconst PAGE_SIZE = 20\n\nconst UserListPage = () => {\n const { raw, searchParams } = useMemberTableQuery({\n pageSize: PAGE_SIZE,\n })\n\n const { members, count, isError, error, isLoading } = useMembers(\n searchParams,\n {\n placeholderData: keepPreviousData,\n }\n )\n\n const columns = useMemberTableColumns()\n\n const { table } = useDataTable({\n data: members ?? [],\n columns,\n enablePagination: true,\n count: count,\n pageSize: PAGE_SIZE,\n })\n\n if (isError) {\n throw error\n }\n\n return (\n <SingleColumnPage>\n <Container className=\"divide-y p-0\">\n <div className=\"flex items-center justify-between px-6 py-4\">\n <Heading>Team Members</Heading>\n <Link to=\"/settings/users/invite\">\n <Button variant=\"secondary\" size=\"small\">\n <PlusMini />\n Invite\n </Button>\n </Link>\n </div>\n <_DataTable\n columns={columns}\n table={table}\n pagination\n search\n navigateTo={(row) => `/settings/users/${row.original.id}`}\n count={count}\n isLoading={isLoading}\n pageSize={PAGE_SIZE}\n orderBy={[\n {\n key: \"name\",\n label: \"Name\",\n },\n {\n key: \"email\",\n label: \"Email\",\n },\n ]}\n queryObject={raw}\n noRecords={{\n message: \"No team members found\",\n }}\n />\n </Container>\n </SingleColumnPage>\n )\n}\n\nexport default UserListPage\n",
"type": "registry:vendor"
},
{
"path": "team-management/vendor/routes/settings/users/[id]/page.tsx",
- "content": "import { useParams, useNavigate } from \"react-router-dom\"\nimport { Container, Heading, Text, usePrompt } from \"@medusajs/ui\"\n\nimport {\n SingleColumnPageSkeleton,\n SingleColumnPage,\n ActionMenu,\n} from \"@mercurjs/dashboard-shared\"\nimport { useMember, useDeleteMember } from \"../../../../hooks/api/members\"\nimport type { MemberDTO } from \"../../../../hooks/api/members\"\nimport { PencilSquare, Trash } from \"@medusajs/icons\"\n\nconst MemberGeneralSection = ({ member }: { member: MemberDTO }) => {\n const navigate = useNavigate()\n const prompt = usePrompt()\n const { mutateAsync: deleteMember } = useDeleteMember(member.id)\n\n const handleDelete = async () => {\n const confirmed = await prompt({\n title: \"Delete team member\",\n description: \"Are you sure you want to remove this team member?\",\n confirmText: \"Delete\",\n cancelText: \"Cancel\",\n })\n\n if (confirmed) {\n await deleteMember()\n navigate(\"/settings/users\", { replace: true })\n }\n }\n\n return (\n <Container className=\"divide-y p-0\">\n <div className=\"flex items-center justify-between px-6 py-4\">\n <Heading>{member.email || member.name}</Heading>\n <ActionMenu\n groups={[\n {\n actions: [\n {\n label: \"Edit\",\n icon: <PencilSquare />,\n to: `/settings/users/${member.id}/edit`,\n },\n ],\n },\n {\n actions: [\n {\n label: \"Delete\",\n icon: <Trash />,\n onClick: handleDelete,\n },\n ],\n },\n ]}\n />\n </div>\n <div className=\"text-ui-fg-subtle grid grid-cols-2 items-center px-6 py-4\">\n <Text size=\"small\" leading=\"compact\" weight=\"plus\">\n Name\n </Text>\n <Text size=\"small\" leading=\"compact\">\n {member.name || \"-\"}\n </Text>\n </div>\n <div className=\"text-ui-fg-subtle grid grid-cols-2 items-center px-6 py-4\">\n <Text size=\"small\" leading=\"compact\" weight=\"plus\">\n Role\n </Text>\n <Text size=\"small\" leading=\"compact\">\n {member.role.charAt(0).toUpperCase() + member.role.slice(1)}\n </Text>\n </div>\n <div className=\"text-ui-fg-subtle grid grid-cols-2 items-center px-6 py-4\">\n <Text size=\"small\" leading=\"compact\" weight=\"plus\">\n Email\n </Text>\n <Text size=\"small\" leading=\"compact\">\n {member.email || \"-\"}\n </Text>\n </div>\n <div className=\"text-ui-fg-subtle grid grid-cols-2 items-center px-6 py-4\">\n <Text size=\"small\" leading=\"compact\" weight=\"plus\">\n Phone\n </Text>\n <Text size=\"small\" leading=\"compact\">\n {member.phone || \"-\"}\n </Text>\n </div>\n </Container>\n )\n}\n\nconst UserDetailPage = () => {\n const { id } = useParams()\n\n const { member, isLoading, isError, error } = useMember(id!)\n\n if (isLoading || !member) {\n return <SingleColumnPageSkeleton sections={1} />\n }\n\n if (isError) {\n throw error\n }\n\n return (\n <SingleColumnPage>\n <MemberGeneralSection member={member} />\n </SingleColumnPage>\n )\n}\n\nexport default UserDetailPage\n",
"type": "registry:vendor"
},
{
"path": "team-management/vendor/routes/settings/users/[id]/breadcrumb.tsx",
- "content": "import type { UIMatch } from \"react-router-dom\"\n\nimport { useMember } from \"../../../../hooks/api/members\"\n\nexport const Breadcrumb = (props: UIMatch) => {\n const { id } = props.params || {}\n\n const { member } = useMember(id!, undefined, {\n enabled: Boolean(id),\n })\n\n if (!member) {\n return null\n }\n\n return <span>{member.name || member.email || member.id}</span>\n}\n",
"type": "registry:vendor"
},
{
"path": "team-management/vendor/routes/settings/users/[id]/edit/page.tsx",
- "content": "import { useParams } from \"react-router-dom\"\nimport { useForm } from \"react-hook-form\"\nimport { zodResolver } from \"@hookform/resolvers/zod\"\nimport { z } from \"zod\"\nimport { Button, Input } from \"@medusajs/ui\"\n\nimport { RouteDrawer, useRouteModal } from \"@mercurjs/dashboard-shared\"\nimport { useMember, useUpdateMember } from \"../../../../../hooks/api/members\"\n\nconst EditMemberSchema = z.object({\n name: z.string().min(1, \"Name is required\"),\n})\n\ntype EditMemberFormValues = z.infer<typeof EditMemberSchema>\n\nconst EditMemberForm = ({\n member,\n}: {\n member: { id: string; name: string }\n}) => {\n const { handleSuccess } = useRouteModal()\n const { mutateAsync: updateMember, isPending } = useUpdateMember(member.id)\n\n const form = useForm<EditMemberFormValues>({\n resolver: zodResolver(EditMemberSchema),\n defaultValues: {\n name: member.name || \"\",\n },\n })\n\n const handleSubmit = form.handleSubmit(async (values) => {\n await updateMember(values)\n handleSuccess()\n })\n\n return (\n <form onSubmit={handleSubmit} className=\"flex flex-1 flex-col\">\n <RouteDrawer.Body>\n <div className=\"flex flex-col gap-y-4\">\n <div className=\"flex flex-col gap-y-2\">\n <label htmlFor=\"name\" className=\"text-ui-fg-subtle txt-small\">\n Name\n </label>\n <Input id=\"name\" {...form.register(\"name\")} />\n {form.formState.errors.name && (\n <span className=\"text-ui-fg-error txt-small\">\n {form.formState.errors.name.message}\n </span>\n )}\n </div>\n </div>\n </RouteDrawer.Body>\n <RouteDrawer.Footer>\n <div className=\"flex items-center justify-end gap-x-2\">\n <RouteDrawer.Close asChild>\n <Button variant=\"secondary\" size=\"small\">\n Cancel\n </Button>\n </RouteDrawer.Close>\n <Button\n type=\"submit\"\n size=\"small\"\n isLoading={isPending}\n >\n Save\n </Button>\n </div>\n </RouteDrawer.Footer>\n </form>\n )\n}\n\nconst EditUserPage = () => {\n const { id } = useParams()\n const { member, isLoading } = useMember(id!)\n\n return (\n <RouteDrawer>\n <RouteDrawer.Header>\n <RouteDrawer.Title>Edit Team Member</RouteDrawer.Title>\n </RouteDrawer.Header>\n {!isLoading && member && <EditMemberForm member={member} />}\n </RouteDrawer>\n )\n}\n\nexport default EditUserPage\n",
"type": "registry:vendor"
},
{
"path": "team-management/vendor/routes/settings/users/invite/page.tsx",
- "content": "import { useForm } from \"react-hook-form\"\nimport { zodResolver } from \"@hookform/resolvers/zod\"\nimport { z } from \"zod\"\nimport { Button, Input, StatusBadge, Text, toast } from \"@medusajs/ui\"\n\nimport { RouteDrawer } from \"@mercurjs/dashboard-shared\"\nimport { useCreateInvite, useInvites } from \"../../../../hooks/api/invites\"\n\nconst InviteSchema = z.object({\n email: z.string().email(\"Please enter a valid email address\"),\n})\n\ntype InviteFormValues = z.infer<typeof InviteSchema>\n\nconst InviteUserPage = () => {\n const { mutateAsync: createInvite, isPending } = useCreateInvite()\n const { invites } = useInvites()\n\n const form = useForm<InviteFormValues>({\n resolver: zodResolver(InviteSchema),\n defaultValues: {\n email: \"\",\n },\n })\n\n const handleSubmit = form.handleSubmit(async (values) => {\n try {\n await createInvite({ email: values.email })\n form.reset()\n toast.success(\"Invitation sent successfully\")\n } catch (e: any) {\n toast.error(e?.message || \"Failed to send invitation\")\n }\n })\n\n const getStatusBadge = (invite: any) => {\n if (invite.accepted) {\n return <StatusBadge color=\"green\">Accepted</StatusBadge>\n }\n if (new Date(invite.expires_at) < new Date()) {\n return <StatusBadge color=\"red\">Expired</StatusBadge>\n }\n return <StatusBadge color=\"orange\">Pending</StatusBadge>\n }\n\n return (\n <RouteDrawer>\n <RouteDrawer.Header>\n <RouteDrawer.Title>Invite Team Member</RouteDrawer.Title>\n </RouteDrawer.Header>\n <RouteDrawer.Body>\n <form onSubmit={handleSubmit} className=\"flex flex-col gap-y-6\">\n <div className=\"flex gap-x-2\">\n <div className=\"flex-1\">\n <Input\n placeholder=\"[email protected]\"\n {...form.register(\"email\")}\n />\n {form.formState.errors.email && (\n <span className=\"text-ui-fg-error txt-small mt-1\">\n {form.formState.errors.email.message}\n </span>\n )}\n </div>\n <Button\n type=\"submit\"\n variant=\"secondary\"\n size=\"small\"\n isLoading={isPending}\n >\n Send Invite\n </Button>\n </div>\n\n {invites && invites.length > 0 && (\n <div className=\"flex flex-col gap-y-2\">\n <Text size=\"small\" weight=\"plus\" className=\"text-ui-fg-subtle\">\n Pending Invitations\n </Text>\n <div className=\"divide-y rounded-lg border\">\n {invites.map((invite: any) => (\n <div\n key={invite.id}\n className=\"flex items-center justify-between px-4 py-3\"\n >\n <Text size=\"small\" className=\"text-ui-fg-subtle\">\n {invite.email}\n </Text>\n {getStatusBadge(invite)}\n </div>\n ))}\n </div>\n </div>\n )}\n </form>\n </RouteDrawer.Body>\n <RouteDrawer.Footer>\n <div className=\"flex items-center justify-end\">\n <RouteDrawer.Close asChild>\n <Button variant=\"secondary\" size=\"small\">\n Close\n </Button>\n </RouteDrawer.Close>\n </div>\n </RouteDrawer.Footer>\n </RouteDrawer>\n )\n}\n\nexport default InviteUserPage\n",
"type": "registry:vendor"
},
{
"path": "team-management/vendor/routes/invite/page.tsx",
- "content": "import { zodResolver } from \"@hookform/resolvers/zod\";\nimport { Alert, Button, Heading, Hint, Input, Text } from \"@medusajs/ui\";\nimport { useState } from \"react\";\nimport { useForm } from \"react-hook-form\";\nimport { decodeToken } from \"react-jwt\";\nimport { Link, useSearchParams } from \"react-router-dom\";\nimport { z } from \"zod\";\n\nimport { useSignUpForInvite, useAcceptInvite } from \"../../hooks/api/invites\";\n\nexport const config = {\n public: true,\n};\n\nconst CreateAccountSchema = z\n .object({\n email: z.string().email(),\n first_name: z.string().min(1, \"First name is required\"),\n last_name: z.string().min(1, \"Last name is required\"),\n password: z.string().min(1, \"Password is required\"),\n repeat_password: z.string().min(1, \"Please repeat password\"),\n })\n .superRefine(({ password, repeat_password }, ctx) => {\n if (password !== repeat_password) {\n ctx.addIssue({\n code: z.ZodIssueCode.custom,\n message: \"Passwords do not match\",\n path: [\"repeat_password\"],\n });\n }\n });\n\ntype DecodedInvite = {\n id: string;\n exp: number;\n iat: number;\n};\n\nconst InviteSchema = z.object({\n id: z.string(),\n exp: z.number(),\n iat: z.number(),\n});\n\nconst validateDecodedInvite = (decoded: unknown): decoded is DecodedInvite => {\n return InviteSchema.safeParse(decoded).success;\n};\n\nconst InviteAcceptPage = () => {\n const [searchParams] = useSearchParams();\n const [success, setSuccess] = useState(false);\n\n const token = searchParams.get(\"token\") || null;\n const invite: DecodedInvite | null = token ? decodeToken(token) : null;\n const isValidInvite = invite && validateDecodedInvite(invite);\n\n return (\n <div className=\"bg-ui-bg-subtle relative flex min-h-dvh w-dvw items-center justify-center p-4\">\n <div className=\"flex w-full max-w-[360px] flex-col items-center\">\n {isValidInvite ? (\n !success ? (\n <CreateView onSuccess={() => setSuccess(true)} token={token!} />\n ) : (\n <SuccessView />\n )\n ) : (\n <InvalidView />\n )}\n </div>\n </div>\n );\n};\n\nconst LoginLink = () => (\n <div className=\"flex w-full flex-col items-center\">\n <div className=\"my-6 h-px w-full border-b border-dotted\" />\n <Link\n to=\"/login\"\n className=\"txt-small text-ui-fg-base transition-fg hover:text-ui-fg-base-hover font-medium outline-none\"\n >\n Back to login\n </Link>\n </div>\n);\n\nconst InvalidView = () => (\n <div className=\"flex flex-col items-center\">\n <div className=\"flex flex-col items-center gap-y-1\">\n <Heading>Invalid invite</Heading>\n <Text size=\"small\" className=\"text-ui-fg-subtle text-center\">\n The invite link is invalid or has expired. Please request a new invite.\n </Text>\n </div>\n <LoginLink />\n </div>\n);\n\nconst CreateView = ({\n onSuccess,\n token,\n}: {\n onSuccess: () => void;\n token: string;\n}) => {\n const [invalid, setInvalid] = useState(false);\n\n const form = useForm<z.infer<typeof CreateAccountSchema>>({\n resolver: zodResolver(CreateAccountSchema),\n defaultValues: {\n email: \"\",\n first_name: \"\",\n last_name: \"\",\n password: \"\",\n repeat_password: \"\",\n },\n });\n\n const { mutateAsync: signUp, isPending: isCreating } = useSignUpForInvite();\n const { mutateAsync: acceptInvite, isPending: isAccepting } =\n useAcceptInvite(token);\n\n const handleSubmit = form.handleSubmit(async (data) => {\n try {\n const authToken = await signUp({\n email: data.email,\n password: data.password,\n });\n\n await acceptInvite({\n name: `${data.first_name} ${data.last_name}`,\n auth_token: (authToken as { token: string }).token,\n });\n\n onSuccess();\n } catch (error: any) {\n if (error?.status === 400) {\n form.setError(\"root\", {\n type: \"manual\",\n message: \"This invite is no longer valid.\",\n });\n setInvalid(true);\n return;\n }\n form.setError(\"root\", {\n type: \"manual\",\n message: error.message || \"Something went wrong\",\n });\n }\n });\n\n const serverError = form.formState.errors.root?.message;\n const validationError =\n form.formState.errors.email?.message ||\n form.formState.errors.first_name?.message ||\n form.formState.errors.last_name?.message ||\n form.formState.errors.password?.message ||\n form.formState.errors.repeat_password?.message;\n\n return (\n <div className=\"flex w-full flex-col items-center\">\n <div className=\"mb-4 flex flex-col items-center\">\n <Heading>Create your account</Heading>\n <Text size=\"small\" className=\"text-ui-fg-subtle text-center\">\n Enter your details to accept the invitation and join the team.\n </Text>\n </div>\n <form onSubmit={handleSubmit} className=\"flex w-full flex-col gap-y-6\">\n <div className=\"flex flex-col gap-y-2\">\n <Input\n autoComplete=\"off\"\n placeholder=\"Email\"\n className=\"bg-ui-bg-field-component\"\n {...form.register(\"email\")}\n />\n <Input\n autoComplete=\"given-name\"\n placeholder=\"First name\"\n className=\"bg-ui-bg-field-component\"\n {...form.register(\"first_name\")}\n />\n <Input\n autoComplete=\"family-name\"\n placeholder=\"Last name\"\n className=\"bg-ui-bg-field-component\"\n {...form.register(\"last_name\")}\n />\n <Input\n autoComplete=\"new-password\"\n type=\"password\"\n placeholder=\"Password\"\n className=\"bg-ui-bg-field-component\"\n {...form.register(\"password\")}\n />\n <Input\n autoComplete=\"off\"\n type=\"password\"\n placeholder=\"Repeat password\"\n className=\"bg-ui-bg-field-component\"\n {...form.register(\"repeat_password\")}\n />\n {validationError && (\n <div className=\"mt-2 text-center\">\n <Hint variant=\"error\">{validationError}</Hint>\n </div>\n )}\n {serverError && (\n <Alert\n className=\"bg-ui-bg-base items-center p-2\"\n dismissible\n variant=\"error\"\n >\n {serverError}\n </Alert>\n )}\n </div>\n <Button\n className=\"w-full\"\n type=\"submit\"\n isLoading={isCreating || isAccepting}\n disabled={invalid}\n >\n Create account\n </Button>\n </form>\n <LoginLink />\n </div>\n );\n};\n\nconst SuccessView = () => (\n <div className=\"flex w-full flex-col items-center gap-y-6\">\n <div className=\"flex flex-col items-center gap-y-1\">\n <Heading className=\"text-center\">Account created!</Heading>\n <Text size=\"small\" className=\"text-ui-fg-subtle text-center\">\n Your account has been created. You can now log in.\n </Text>\n </div>\n <Button variant=\"secondary\" asChild className=\"w-full\">\n <Link to=\"/login\" replace>\n Go to login\n </Link>\n </Button>\n </div>\n);\n\nexport default InviteAcceptPage;\n",
"type": "registry:vendor"
}
]
diff --git a/packages/registry/registry.json b/packages/registry/registry.json
index 991a14c0d..ffcd12086 100644
--- a/packages/registry/registry.json
+++ b/packages/registry/registry.json
@@ -297,185 +297,6 @@
"vendor"
]
},
- {
- "name": "team-management",
- "description": "Team member management with invitations, roles, and vendor portal pages.",
- "dependencies": [
- "jsonwebtoken",
- "@types/jsonwebtoken",
- "react-jwt"
- ],
- "registryDependencies": [],
- "docs": "## Configuration\n\nAdd the member module to your `medusa-config.ts`:\n\n```ts\nimport { ContainerRegistrationKeys } from \"@medusajs/framework/utils\"\n\nmodules: [\n {\n resolve: './modules/member',\n dependencies: [ContainerRegistrationKeys.QUERY],\n },\n]\n```\n\n## Middlewares\n\nAdd the team management middlewares to your `api/middlewares.ts`:\n\n```ts\nimport { defineMiddlewares } from \"@medusajs/medusa\";\nimport { vendorMembersMiddlewares } from \"./vendor/members/middlewares\";\nimport { vendorInvitesMiddlewares } from \"./vendor/invites/middlewares\";\n\nexport default defineMiddlewares({\n routes: [...vendorMembersMiddlewares, ...vendorInvitesMiddlewares],\n});\n```\n\nIf you already have a `middlewares.ts` file, merge the middleware imports and spread them into your existing `routes` array.\n\n## Database Migrations\n\nAfter installing the block and adding the module configuration, generate and run the migrations to create the necessary tables in your database:\n\n```bash\nnpx medusa db:generate member\nnpx medusa db:migrate\n```\n\n## Run codegen\n\nAfter installing the block, regenerate SDK types:\n\n```bash\nnpx @mercurjs/cli@latest codegen\n```",
- "files": [
- {
- "path": "team-management/modules/member/index.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/modules/member/service.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/modules/member/types.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/modules/member/models/member.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/modules/member/models/member-invite.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/workflows/member/steps/create-member.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/workflows/member/steps/update-member.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/workflows/member/steps/delete-member.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/workflows/member/steps/create-member-invite.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/workflows/member/steps/validate-member-invite.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/workflows/member/steps/update-member-invite.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/workflows/member/steps/delete-member-invite.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/workflows/member/workflows/invite-member.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/workflows/member/workflows/accept-member-invite.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/workflows/member/workflows/update-member.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/workflows/member/workflows/delete-member.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/workflows/member/workflows/delete-member-invite.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/workflows/hooks/seller-created.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/api/vendor/members/helpers.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/api/vendor/members/query-config.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/api/vendor/members/validators.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/api/vendor/members/middlewares.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/api/vendor/members/route.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/api/vendor/members/[id]/route.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/api/vendor/members/me/route.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/api/vendor/invites/query-config.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/api/vendor/invites/validators.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/api/vendor/invites/middlewares.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/api/vendor/invites/route.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/api/vendor/invites/accept/route.ts",
- "type": "registry:api"
- },
- {
- "path": "team-management/vendor/hooks/api/members.tsx",
- "type": "registry:vendor"
- },
- {
- "path": "team-management/vendor/hooks/api/invites.tsx",
- "type": "registry:vendor"
- },
- {
- "path": "team-management/vendor/hooks/table/columns/use-member-table-columns.tsx",
- "type": "registry:vendor"
- },
- {
- "path": "team-management/vendor/hooks/table/query/use-member-table-query.tsx",
- "type": "registry:vendor"
- },
- {
- "path": "team-management/vendor/routes/settings/users/page.tsx",
- "type": "registry:vendor"
- },
- {
- "path": "team-management/vendor/routes/settings/users/[id]/page.tsx",
- "type": "registry:vendor"
- },
- {
- "path": "team-management/vendor/routes/settings/users/[id]/breadcrumb.tsx",
- "type": "registry:vendor"
- },
- {
- "path": "team-management/vendor/routes/settings/users/[id]/edit/page.tsx",
- "type": "registry:vendor"
- },
- {
- "path": "team-management/vendor/routes/settings/users/invite/page.tsx",
- "type": "registry:vendor"
- },
- {
- "path": "team-management/vendor/routes/invite/page.tsx",
- "type": "registry:vendor"
- }
- ],
- "categories": [
- "module",
- "workflow",
- "api",
- "vendor"
- ]
- },
{
"name": "wishlist",
"description": "Customer wishlist with product bookmarking, pricing context, and store API endpoints.",