@thorprovider/adapters 4.2.1 → 4.3.0

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import * as _thorprovider_types from '@thorprovider/types';
-import { BackendCapabilities, Money, PaymentMethod, FulfillmentOption, CartItem, StockLocation, InventoryLevel, StorefrontConfig, DashboardMetrics, ProviderTypeString, CommerceProvider, AuthProvider, ProviderConfig, AuthConfig, Product, GetProductsOptions, AdvancedSearchProductsOptions, SearchResultMeta, FilterConfig, Collection, GetCollectionsOptions, CollectionProductsOptions, ProductCategory, GetCategoriesOptions, Cart, CartLineInput, CartLineUpdate, GetOrdersOptions, Order, GetCustomersOptions, Customer, Address, Region, AdminProduct, PaymentMethodsOptions, StockValidation, StorefrontContext, DesignerConfig, DesignerHistoryEntry, ShippingMethod, Country } from '@thorprovider/types';
+import { BackendCapabilities, Money, PaymentMethod, FulfillmentOption, CartItem, StockLocation, InventoryLevel, StorefrontConfig, DashboardMetrics, ProviderTypeString, GetChannelCustomersOptions, GetChannelCustomersResponse, GetChannelApiKeysResponse, GetChannelCategoriesOptions, GetChannelCategoriesResponse, GetCategorySalesChannelsResponse, AssignCategoriesToChannelsBody, AssignCategoriesToChannelsResponse, UnassignCategoriesFromChannelsBody, UnassignCategoriesFromChannelsResponse, GetCollectionSalesChannelsResponse, AssignCollectionsToChannelsBody, AssignCollectionsToChannelsResponse, UnassignCollectionsFromChannelsBody, UnassignCollectionsFromChannelsResponse, GetAdminStorefrontConfigResponse, UpdateStorefrontConfigBody, UpdateStorefrontConfigResponse, GetAdminSiteConfigResponse, UpdateSiteConfigBody, UpdateSiteConfigResponse, GetAdminSiteConfigHistoryOptions, GetAdminSiteConfigHistoryResponse, RestoreSiteConfigResponse, CommerceProvider, AuthProvider, ProviderConfig, AuthConfig, Product, GetProductsOptions, AdvancedSearchProductsOptions, SearchResultMeta, FilterConfig, Collection, GetCollectionsOptions, CollectionProductsOptions, ProductCategory, GetCategoriesOptions, Cart, CartLineInput, CartLineUpdate, GetOrdersOptions, Order, GetCustomersOptions, Customer, Address, Region, AdminProduct, PaymentMethodsOptions, StockValidation, StorefrontContext, DesignerConfig, DesignerHistoryEntry, ShippingMethod, Country } from '@thorprovider/types';
 export * from '@thorprovider/types';
 export { BackendCapabilities, CommerceProvider, DesignerConfig, DesignerHistoryEntry, DesignerNavItem, DesignerThemeConfig, DesignerThemePreset, ProviderConfig, StorefrontConfig, StorefrontConfigError, StorefrontContext, StorefrontPlatformType, StorefrontSeoDefaults } from '@thorprovider/types';
 import Medusa from '@medusajs/js-sdk';
@@ -1368,6 +1368,153 @@ declare function validateChannelScopeAssignment(entityId: string, channelId: str
  */
 declare function assertEntityBelongsToChannel(entity: ChannelScopeable, expectedChannelId: string): void;
 
+/**
+ * @fileoverview Medusa Multi-Tenant Admin Client
+ * @module @thorprovider/adapters/providers/medusa/admin
+ *
+ * Wrapper methods for all `/admin/thor/` endpoints defined in the Thor Commerce
+ * multi-tenant API contract.  Requires an admin API key (`adminConfig.apiKey`)
+ * to be provided when creating the Medusa provider.
+ *
+ * Every method performs a raw `fetch` against the Medusa backend using the
+ * admin API key (`x-medusa-access-token`) — the Medusa JS-SDK's admin client
+ * does not expose these custom Thor plugin routes, so we use direct HTTP calls.
+ *
+ * Endpoint reference: `multitenant-api-contract.md`
+ */
+
+/**
+ * Configuration required to instantiate the admin client.
+ */
+interface MedusaAdminClientConfig {
+    /** Medusa backend base URL */
+    baseUrl: string;
+    /** Secret admin API key (x-medusa-access-token) */
+    apiKey: string;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+/**
+ * HTTP client for Thor Commerce multi-tenant admin endpoints (`/admin/thor/`).
+ *
+ * All methods throw `ProviderAPIError` on non-2xx responses.
+ *
+ * @example
+ * ```typescript
+ * const admin = new MedusaAdminClient({
+ *   baseUrl: process.env.MEDUSA_BACKEND_URL!,
+ *   apiKey: process.env.MEDUSA_ADMIN_API_KEY!,
+ * });
+ *
+ * const { customers } = await admin.getChannelCustomers('sc_01JXXXXX');
+ * ```
+ */
+declare class MedusaAdminClient {
+    private baseUrl;
+    private apiKey;
+    private logger;
+    constructor(config: MedusaAdminClientConfig);
+    private request;
+    /**
+     * Paginated list of customers linked to a sales channel.
+     *
+     * `GET /admin/thor/sales-channels/:id/customers`
+     */
+    getChannelCustomers(salesChannelId: string, options?: GetChannelCustomersOptions): Promise<GetChannelCustomersResponse>;
+    /**
+     * Publishable API keys associated with a sales channel.
+     *
+     * `GET /admin/thor/sales-channels/:id/api-keys`
+     */
+    getChannelApiKeys(salesChannelId: string): Promise<GetChannelApiKeysResponse>;
+    /**
+     * Product categories assigned to a sales channel.
+     *
+     * `GET /admin/thor/sales-channels/:id/categories`
+     */
+    getChannelCategories(salesChannelId: string, options?: GetChannelCategoriesOptions): Promise<GetChannelCategoriesResponse>;
+    /**
+     * Sales channels to which a category is assigned.
+     *
+     * `GET /admin/thor/categories/:id/sales-channels`
+     */
+    getCategorySalesChannels(categoryId: string): Promise<GetCategorySalesChannelsResponse>;
+    /**
+     * Assign a category to one or more sales channels (idempotent).
+     *
+     * `POST /admin/thor/categories/:id/sales-channels`
+     */
+    assignCategoryToChannels(categoryId: string, body: AssignCategoriesToChannelsBody): Promise<AssignCategoriesToChannelsResponse>;
+    /**
+     * Remove category assignment from one or more sales channels (idempotent).
+     *
+     * `DELETE /admin/thor/categories/:id/sales-channels`
+     */
+    unassignCategoryFromChannels(categoryId: string, body: UnassignCategoriesFromChannelsBody): Promise<UnassignCategoriesFromChannelsResponse>;
+    /**
+     * Sales channels to which a collection is assigned.
+     *
+     * `GET /admin/thor/collections/:id/sales-channels`
+     */
+    getCollectionSalesChannels(collectionId: string): Promise<GetCollectionSalesChannelsResponse>;
+    /**
+     * Assign a collection to one or more sales channels (idempotent).
+     *
+     * `POST /admin/thor/collections/:id/sales-channels`
+     */
+    assignCollectionToChannels(collectionId: string, body: AssignCollectionsToChannelsBody): Promise<AssignCollectionsToChannelsResponse>;
+    /**
+     * Remove collection assignment from one or more sales channels (idempotent).
+     *
+     * `DELETE /admin/thor/collections/:id/sales-channels`
+     */
+    unassignCollectionFromChannels(collectionId: string, body: UnassignCollectionsFromChannelsBody): Promise<UnassignCollectionsFromChannelsResponse>;
+    /**
+     * Read the visual storefront configuration for a channel.
+     * `:id` is the `sales_channel_id`.
+     *
+     * `GET /admin/thor/storefront-config/:id`
+     */
+    getStorefrontConfig(salesChannelId: string): Promise<GetAdminStorefrontConfigResponse>;
+    /**
+     * Update the visual storefront configuration for a channel.
+     * Triggers the `storefront_config.updated` event → ISR webhook.
+     *
+     * `PUT /admin/thor/storefront-config/:id`
+     */
+    updateStorefrontConfig(salesChannelId: string, body: UpdateStorefrontConfigBody): Promise<UpdateStorefrontConfigResponse>;
+    /**
+     * Read the active Site Designer configuration for a channel, including the
+     * last 10 history entries.
+     *
+     * `GET /admin/thor/site-config/:sales_channel_id`
+     */
+    getSiteConfig(salesChannelId: string): Promise<GetAdminSiteConfigResponse>;
+    /**
+     * Update the Site Designer configuration for a channel.
+     * Creates a new history entry on every PUT.
+     *
+     * `PUT /admin/thor/site-config/:sales_channel_id`
+     */
+    updateSiteConfig(salesChannelId: string, body: UpdateSiteConfigBody): Promise<UpdateSiteConfigResponse>;
+    /**
+     * Full paginated history of Site Designer versions for a channel.
+     * Entries are immutable — they are never deleted.
+     *
+     * `GET /admin/thor/site-config/:sales_channel_id/history`
+     */
+    getSiteConfigHistory(salesChannelId: string, options?: GetAdminSiteConfigHistoryOptions): Promise<GetAdminSiteConfigHistoryResponse>;
+    /**
+     * Restore a previous Site Designer version.
+     * Internally runs the update workflow with the stored config of the target
+     * version — this creates a **new** history entry and does NOT mutate past
+     * entries.
+     *
+     * `POST /admin/thor/site-config/:sales_channel_id/restore/:version`
+     */
+    restoreSiteConfig(salesChannelId: string, version: string): Promise<RestoreSiteConfigResponse>;
+}
+
 /**
  * Medusa provider configuration
  */
@@ -1459,6 +1606,18 @@ declare class MedusaProvider implements CommerceProvider {
      * Only created when adminConfig.apiKey is provided.
      */
     private sdkAdmin?;
+    /**
+     * Admin client for Thor multi-tenant endpoints (`/admin/thor/`).
+     * Available when `adminConfig.apiKey` is provided.
+     *
+     * @example
+     * ```typescript
+     * const { customers } = await commerce.admin.getChannelCustomers('sc_01JXXXXX');
+     * const { api_keys } = await commerce.admin.getChannelApiKeys('sc_01JXXXXX');
+     * await commerce.admin.updateStorefrontConfig('sc_01JXXXXX', { theme_accent_color: '#EF4444', ... });
+     * ```
+     */
+    readonly admin?: MedusaAdminClient;
     /** Cached distinct product status values — rarely changes, cached for process lifetime */
     private _cachedProductStatuses;
     /**

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _thorprovider_types from '@thorprovider/types';
-import { BackendCapabilities, Money, PaymentMethod, FulfillmentOption, CartItem, StockLocation, InventoryLevel, StorefrontConfig, DashboardMetrics, ProviderTypeString, CommerceProvider, AuthProvider, ProviderConfig, AuthConfig, Product, GetProductsOptions, AdvancedSearchProductsOptions, SearchResultMeta, FilterConfig, Collection, GetCollectionsOptions, CollectionProductsOptions, ProductCategory, GetCategoriesOptions, Cart, CartLineInput, CartLineUpdate, GetOrdersOptions, Order, GetCustomersOptions, Customer, Address, Region, AdminProduct, PaymentMethodsOptions, StockValidation, StorefrontContext, DesignerConfig, DesignerHistoryEntry, ShippingMethod, Country } from '@thorprovider/types';
+import { BackendCapabilities, Money, PaymentMethod, FulfillmentOption, CartItem, StockLocation, InventoryLevel, StorefrontConfig, DashboardMetrics, ProviderTypeString, GetChannelCustomersOptions, GetChannelCustomersResponse, GetChannelApiKeysResponse, GetChannelCategoriesOptions, GetChannelCategoriesResponse, GetCategorySalesChannelsResponse, AssignCategoriesToChannelsBody, AssignCategoriesToChannelsResponse, UnassignCategoriesFromChannelsBody, UnassignCategoriesFromChannelsResponse, GetCollectionSalesChannelsResponse, AssignCollectionsToChannelsBody, AssignCollectionsToChannelsResponse, UnassignCollectionsFromChannelsBody, UnassignCollectionsFromChannelsResponse, GetAdminStorefrontConfigResponse, UpdateStorefrontConfigBody, UpdateStorefrontConfigResponse, GetAdminSiteConfigResponse, UpdateSiteConfigBody, UpdateSiteConfigResponse, GetAdminSiteConfigHistoryOptions, GetAdminSiteConfigHistoryResponse, RestoreSiteConfigResponse, CommerceProvider, AuthProvider, ProviderConfig, AuthConfig, Product, GetProductsOptions, AdvancedSearchProductsOptions, SearchResultMeta, FilterConfig, Collection, GetCollectionsOptions, CollectionProductsOptions, ProductCategory, GetCategoriesOptions, Cart, CartLineInput, CartLineUpdate, GetOrdersOptions, Order, GetCustomersOptions, Customer, Address, Region, AdminProduct, PaymentMethodsOptions, StockValidation, StorefrontContext, DesignerConfig, DesignerHistoryEntry, ShippingMethod, Country } from '@thorprovider/types';
 export * from '@thorprovider/types';
 export { BackendCapabilities, CommerceProvider, DesignerConfig, DesignerHistoryEntry, DesignerNavItem, DesignerThemeConfig, DesignerThemePreset, ProviderConfig, StorefrontConfig, StorefrontConfigError, StorefrontContext, StorefrontPlatformType, StorefrontSeoDefaults } from '@thorprovider/types';
 import Medusa from '@medusajs/js-sdk';
@@ -1368,6 +1368,153 @@ declare function validateChannelScopeAssignment(entityId: string, channelId: str
  */
 declare function assertEntityBelongsToChannel(entity: ChannelScopeable, expectedChannelId: string): void;
 
+/**
+ * @fileoverview Medusa Multi-Tenant Admin Client
+ * @module @thorprovider/adapters/providers/medusa/admin
+ *
+ * Wrapper methods for all `/admin/thor/` endpoints defined in the Thor Commerce
+ * multi-tenant API contract.  Requires an admin API key (`adminConfig.apiKey`)
+ * to be provided when creating the Medusa provider.
+ *
+ * Every method performs a raw `fetch` against the Medusa backend using the
+ * admin API key (`x-medusa-access-token`) — the Medusa JS-SDK's admin client
+ * does not expose these custom Thor plugin routes, so we use direct HTTP calls.
+ *
+ * Endpoint reference: `multitenant-api-contract.md`
+ */
+
+/**
+ * Configuration required to instantiate the admin client.
+ */
+interface MedusaAdminClientConfig {
+    /** Medusa backend base URL */
+    baseUrl: string;
+    /** Secret admin API key (x-medusa-access-token) */
+    apiKey: string;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+/**
+ * HTTP client for Thor Commerce multi-tenant admin endpoints (`/admin/thor/`).
+ *
+ * All methods throw `ProviderAPIError` on non-2xx responses.
+ *
+ * @example
+ * ```typescript
+ * const admin = new MedusaAdminClient({
+ *   baseUrl: process.env.MEDUSA_BACKEND_URL!,
+ *   apiKey: process.env.MEDUSA_ADMIN_API_KEY!,
+ * });
+ *
+ * const { customers } = await admin.getChannelCustomers('sc_01JXXXXX');
+ * ```
+ */
+declare class MedusaAdminClient {
+    private baseUrl;
+    private apiKey;
+    private logger;
+    constructor(config: MedusaAdminClientConfig);
+    private request;
+    /**
+     * Paginated list of customers linked to a sales channel.
+     *
+     * `GET /admin/thor/sales-channels/:id/customers`
+     */
+    getChannelCustomers(salesChannelId: string, options?: GetChannelCustomersOptions): Promise<GetChannelCustomersResponse>;
+    /**
+     * Publishable API keys associated with a sales channel.
+     *
+     * `GET /admin/thor/sales-channels/:id/api-keys`
+     */
+    getChannelApiKeys(salesChannelId: string): Promise<GetChannelApiKeysResponse>;
+    /**
+     * Product categories assigned to a sales channel.
+     *
+     * `GET /admin/thor/sales-channels/:id/categories`
+     */
+    getChannelCategories(salesChannelId: string, options?: GetChannelCategoriesOptions): Promise<GetChannelCategoriesResponse>;
+    /**
+     * Sales channels to which a category is assigned.
+     *
+     * `GET /admin/thor/categories/:id/sales-channels`
+     */
+    getCategorySalesChannels(categoryId: string): Promise<GetCategorySalesChannelsResponse>;
+    /**
+     * Assign a category to one or more sales channels (idempotent).
+     *
+     * `POST /admin/thor/categories/:id/sales-channels`
+     */
+    assignCategoryToChannels(categoryId: string, body: AssignCategoriesToChannelsBody): Promise<AssignCategoriesToChannelsResponse>;
+    /**
+     * Remove category assignment from one or more sales channels (idempotent).
+     *
+     * `DELETE /admin/thor/categories/:id/sales-channels`
+     */
+    unassignCategoryFromChannels(categoryId: string, body: UnassignCategoriesFromChannelsBody): Promise<UnassignCategoriesFromChannelsResponse>;
+    /**
+     * Sales channels to which a collection is assigned.
+     *
+     * `GET /admin/thor/collections/:id/sales-channels`
+     */
+    getCollectionSalesChannels(collectionId: string): Promise<GetCollectionSalesChannelsResponse>;
+    /**
+     * Assign a collection to one or more sales channels (idempotent).
+     *
+     * `POST /admin/thor/collections/:id/sales-channels`
+     */
+    assignCollectionToChannels(collectionId: string, body: AssignCollectionsToChannelsBody): Promise<AssignCollectionsToChannelsResponse>;
+    /**
+     * Remove collection assignment from one or more sales channels (idempotent).
+     *
+     * `DELETE /admin/thor/collections/:id/sales-channels`
+     */
+    unassignCollectionFromChannels(collectionId: string, body: UnassignCollectionsFromChannelsBody): Promise<UnassignCollectionsFromChannelsResponse>;
+    /**
+     * Read the visual storefront configuration for a channel.
+     * `:id` is the `sales_channel_id`.
+     *
+     * `GET /admin/thor/storefront-config/:id`
+     */
+    getStorefrontConfig(salesChannelId: string): Promise<GetAdminStorefrontConfigResponse>;
+    /**
+     * Update the visual storefront configuration for a channel.
+     * Triggers the `storefront_config.updated` event → ISR webhook.
+     *
+     * `PUT /admin/thor/storefront-config/:id`
+     */
+    updateStorefrontConfig(salesChannelId: string, body: UpdateStorefrontConfigBody): Promise<UpdateStorefrontConfigResponse>;
+    /**
+     * Read the active Site Designer configuration for a channel, including the
+     * last 10 history entries.
+     *
+     * `GET /admin/thor/site-config/:sales_channel_id`
+     */
+    getSiteConfig(salesChannelId: string): Promise<GetAdminSiteConfigResponse>;
+    /**
+     * Update the Site Designer configuration for a channel.
+     * Creates a new history entry on every PUT.
+     *
+     * `PUT /admin/thor/site-config/:sales_channel_id`
+     */
+    updateSiteConfig(salesChannelId: string, body: UpdateSiteConfigBody): Promise<UpdateSiteConfigResponse>;
+    /**
+     * Full paginated history of Site Designer versions for a channel.
+     * Entries are immutable — they are never deleted.
+     *
+     * `GET /admin/thor/site-config/:sales_channel_id/history`
+     */
+    getSiteConfigHistory(salesChannelId: string, options?: GetAdminSiteConfigHistoryOptions): Promise<GetAdminSiteConfigHistoryResponse>;
+    /**
+     * Restore a previous Site Designer version.
+     * Internally runs the update workflow with the stored config of the target
+     * version — this creates a **new** history entry and does NOT mutate past
+     * entries.
+     *
+     * `POST /admin/thor/site-config/:sales_channel_id/restore/:version`
+     */
+    restoreSiteConfig(salesChannelId: string, version: string): Promise<RestoreSiteConfigResponse>;
+}
+
 /**
  * Medusa provider configuration
  */
@@ -1459,6 +1606,18 @@ declare class MedusaProvider implements CommerceProvider {
      * Only created when adminConfig.apiKey is provided.
      */
     private sdkAdmin?;
+    /**
+     * Admin client for Thor multi-tenant endpoints (`/admin/thor/`).
+     * Available when `adminConfig.apiKey` is provided.
+     *
+     * @example
+     * ```typescript
+     * const { customers } = await commerce.admin.getChannelCustomers('sc_01JXXXXX');
+     * const { api_keys } = await commerce.admin.getChannelApiKeys('sc_01JXXXXX');
+     * await commerce.admin.updateStorefrontConfig('sc_01JXXXXX', { theme_accent_color: '#EF4444', ... });
+     * ```
+     */
+    readonly admin?: MedusaAdminClient;
     /** Cached distinct product status values — rarely changes, cached for process lifetime */
     private _cachedProductStatuses;
     /**