@thorprovider/medusa-extended 1.0.0

package/dist/index.d.mts

@@ -0,0 +1,150 @@
+import { GetChannelCustomersOptions, GetChannelCustomersResponse, GetChannelApiKeysResponse, GetChannelCategoriesOptions, GetChannelCategoriesResponse, GetCategorySalesChannelsResponse, AssignCategoriesToChannelsBody, AssignCategoriesToChannelsResponse, UnassignCategoriesFromChannelsBody, UnassignCategoriesFromChannelsResponse, GetCollectionSalesChannelsResponse, AssignCollectionsToChannelsBody, AssignCollectionsToChannelsResponse, UnassignCollectionsFromChannelsBody, UnassignCollectionsFromChannelsResponse, GetAdminStorefrontConfigResponse, UpdateStorefrontConfigBody, UpdateStorefrontConfigResponse, GetAdminSiteConfigResponse, UpdateSiteConfigBody, UpdateSiteConfigResponse, GetAdminSiteConfigHistoryOptions, GetAdminSiteConfigHistoryResponse, RestoreSiteConfigResponse } from '@thorprovider/types';
+
+/**
+ * @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>;
+}
+
+export { MedusaAdminClient, type MedusaAdminClientConfig };

package/dist/index.d.ts

@@ -0,0 +1,150 @@
+import { GetChannelCustomersOptions, GetChannelCustomersResponse, GetChannelApiKeysResponse, GetChannelCategoriesOptions, GetChannelCategoriesResponse, GetCategorySalesChannelsResponse, AssignCategoriesToChannelsBody, AssignCategoriesToChannelsResponse, UnassignCategoriesFromChannelsBody, UnassignCategoriesFromChannelsResponse, GetCollectionSalesChannelsResponse, AssignCollectionsToChannelsBody, AssignCollectionsToChannelsResponse, UnassignCollectionsFromChannelsBody, UnassignCollectionsFromChannelsResponse, GetAdminStorefrontConfigResponse, UpdateStorefrontConfigBody, UpdateStorefrontConfigResponse, GetAdminSiteConfigResponse, UpdateSiteConfigBody, UpdateSiteConfigResponse, GetAdminSiteConfigHistoryOptions, GetAdminSiteConfigHistoryResponse, RestoreSiteConfigResponse } from '@thorprovider/types';
+
+/**
+ * @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>;
+}
+
+export { MedusaAdminClient, type MedusaAdminClientConfig };

package/dist/index.js

@@ -0,0 +1,315 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  MedusaAdminClient: () => MedusaAdminClient
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/admin.ts
+var import_adapters = require("@thorprovider/adapters");
+var MedusaAdminClient = class {
+  baseUrl;
+  apiKey;
+  logger;
+  constructor(config) {
+    this.baseUrl = config.baseUrl.replace(/\/$/, "");
+    this.apiKey = config.apiKey;
+    this.logger = (0, import_adapters.createLogger)("MedusaAdminClient", config.debug);
+  }
+  // -----------------------------------------------------------------------
+  // Private — HTTP helper
+  // -----------------------------------------------------------------------
+  async request(method, path, body) {
+    const url = `${this.baseUrl}${path}`;
+    this.logger.debug(`[admin] ${method} ${path}`);
+    const headers = {
+      "x-medusa-access-token": this.apiKey,
+      "Content-Type": "application/json"
+    };
+    const init = {
+      method,
+      headers,
+      ...body !== void 0 ? { body: JSON.stringify(body) } : {}
+    };
+    let response;
+    try {
+      response = await fetch(url, init);
+    } catch (networkError) {
+      throw new import_adapters.ProviderAPIError(
+        `[admin] Network error on ${method} ${path}: ${networkError.message}`,
+        "NETWORK_ERROR",
+        networkError
+      );
+    }
+    if (!response.ok) {
+      let message = `HTTP ${response.status}`;
+      try {
+        const json = await response.json();
+        message = json?.message ?? message;
+      } catch {
+      }
+      throw new import_adapters.ProviderAPIError(
+        `[admin] ${method} ${path} failed: ${message}`,
+        `ADMIN_API_${response.status}`,
+        response.status
+      );
+    }
+    return response.json();
+  }
+  // -----------------------------------------------------------------------
+  // 3.1 — Sales Channel: Customers
+  // -----------------------------------------------------------------------
+  /**
+   * Paginated list of customers linked to a sales channel.
+   *
+   * `GET /admin/thor/sales-channels/:id/customers`
+   */
+  async getChannelCustomers(salesChannelId, options = {}) {
+    const { limit = 20, offset = 0 } = options;
+    return this.request(
+      "GET",
+      `/admin/thor/sales-channels/${salesChannelId}/customers?limit=${limit}&offset=${offset}`
+    );
+  }
+  // -----------------------------------------------------------------------
+  // 3.2 — Sales Channel: API Keys
+  // -----------------------------------------------------------------------
+  /**
+   * Publishable API keys associated with a sales channel.
+   *
+   * `GET /admin/thor/sales-channels/:id/api-keys`
+   */
+  async getChannelApiKeys(salesChannelId) {
+    return this.request(
+      "GET",
+      `/admin/thor/sales-channels/${salesChannelId}/api-keys`
+    );
+  }
+  // -----------------------------------------------------------------------
+  // 3.3 — Sales Channel: Categories
+  // -----------------------------------------------------------------------
+  /**
+   * Product categories assigned to a sales channel.
+   *
+   * `GET /admin/thor/sales-channels/:id/categories`
+   */
+  async getChannelCategories(salesChannelId, options = {}) {
+    const { limit = 20, offset = 0, include_descendants = false } = options;
+    const qs = new URLSearchParams({
+      limit: String(limit),
+      offset: String(offset),
+      include_descendants: String(include_descendants)
+    });
+    return this.request(
+      "GET",
+      `/admin/thor/sales-channels/${salesChannelId}/categories?${qs}`
+    );
+  }
+  // -----------------------------------------------------------------------
+  // 3.4 — Category: Sales Channels
+  // -----------------------------------------------------------------------
+  /**
+   * Sales channels to which a category is assigned.
+   *
+   * `GET /admin/thor/categories/:id/sales-channels`
+   */
+  async getCategorySalesChannels(categoryId) {
+    return this.request(
+      "GET",
+      `/admin/thor/categories/${categoryId}/sales-channels`
+    );
+  }
+  // -----------------------------------------------------------------------
+  // 3.5 — Category: Assign to Sales Channels
+  // -----------------------------------------------------------------------
+  /**
+   * Assign a category to one or more sales channels (idempotent).
+   *
+   * `POST /admin/thor/categories/:id/sales-channels`
+   */
+  async assignCategoryToChannels(categoryId, body) {
+    return this.request(
+      "POST",
+      `/admin/thor/categories/${categoryId}/sales-channels`,
+      body
+    );
+  }
+  // -----------------------------------------------------------------------
+  // 3.6 — Category: Unassign from Sales Channels
+  // -----------------------------------------------------------------------
+  /**
+   * Remove category assignment from one or more sales channels (idempotent).
+   *
+   * `DELETE /admin/thor/categories/:id/sales-channels`
+   */
+  async unassignCategoryFromChannels(categoryId, body) {
+    return this.request(
+      "DELETE",
+      `/admin/thor/categories/${categoryId}/sales-channels`,
+      body
+    );
+  }
+  // -----------------------------------------------------------------------
+  // 3.7 — Collection: Sales Channels
+  // -----------------------------------------------------------------------
+  /**
+   * Sales channels to which a collection is assigned.
+   *
+   * `GET /admin/thor/collections/:id/sales-channels`
+   */
+  async getCollectionSalesChannels(collectionId) {
+    return this.request(
+      "GET",
+      `/admin/thor/collections/${collectionId}/sales-channels`
+    );
+  }
+  // -----------------------------------------------------------------------
+  // 3.8 — Collection: Assign to Sales Channels
+  // -----------------------------------------------------------------------
+  /**
+   * Assign a collection to one or more sales channels (idempotent).
+   *
+   * `POST /admin/thor/collections/:id/sales-channels`
+   */
+  async assignCollectionToChannels(collectionId, body) {
+    return this.request(
+      "POST",
+      `/admin/thor/collections/${collectionId}/sales-channels`,
+      body
+    );
+  }
+  // -----------------------------------------------------------------------
+  // 3.9 — Collection: Unassign from Sales Channels
+  // -----------------------------------------------------------------------
+  /**
+   * Remove collection assignment from one or more sales channels (idempotent).
+   *
+   * `DELETE /admin/thor/collections/:id/sales-channels`
+   */
+  async unassignCollectionFromChannels(collectionId, body) {
+    return this.request(
+      "DELETE",
+      `/admin/thor/collections/${collectionId}/sales-channels`,
+      body
+    );
+  }
+  // -----------------------------------------------------------------------
+  // 3.10 — Storefront Config: Read
+  // -----------------------------------------------------------------------
+  /**
+   * Read the visual storefront configuration for a channel.
+   * `:id` is the `sales_channel_id`.
+   *
+   * `GET /admin/thor/storefront-config/:id`
+   */
+  async getStorefrontConfig(salesChannelId) {
+    return this.request(
+      "GET",
+      `/admin/thor/storefront-config/${salesChannelId}`
+    );
+  }
+  // -----------------------------------------------------------------------
+  // 3.11 — Storefront Config: Update
+  // -----------------------------------------------------------------------
+  /**
+   * Update the visual storefront configuration for a channel.
+   * Triggers the `storefront_config.updated` event → ISR webhook.
+   *
+   * `PUT /admin/thor/storefront-config/:id`
+   */
+  async updateStorefrontConfig(salesChannelId, body) {
+    return this.request(
+      "PUT",
+      `/admin/thor/storefront-config/${salesChannelId}`,
+      body
+    );
+  }
+  // -----------------------------------------------------------------------
+  // 3.12 — Site Designer Config: Read
+  // -----------------------------------------------------------------------
+  /**
+   * Read the active Site Designer configuration for a channel, including the
+   * last 10 history entries.
+   *
+   * `GET /admin/thor/site-config/:sales_channel_id`
+   */
+  async getSiteConfig(salesChannelId) {
+    return this.request(
+      "GET",
+      `/admin/thor/site-config/${salesChannelId}`
+    );
+  }
+  // -----------------------------------------------------------------------
+  // 3.13 — Site Designer Config: Update
+  // -----------------------------------------------------------------------
+  /**
+   * Update the Site Designer configuration for a channel.
+   * Creates a new history entry on every PUT.
+   *
+   * `PUT /admin/thor/site-config/:sales_channel_id`
+   */
+  async updateSiteConfig(salesChannelId, body) {
+    return this.request(
+      "PUT",
+      `/admin/thor/site-config/${salesChannelId}`,
+      body
+    );
+  }
+  // -----------------------------------------------------------------------
+  // 3.14 — Site Designer Config: History
+  // -----------------------------------------------------------------------
+  /**
+   * 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`
+   */
+  async getSiteConfigHistory(salesChannelId, options = {}) {
+    const { limit = 20, offset = 0 } = options;
+    return this.request(
+      "GET",
+      `/admin/thor/site-config/${salesChannelId}/history?limit=${limit}&offset=${offset}`
+    );
+  }
+  // -----------------------------------------------------------------------
+  // 3.15 — Site Designer Config: Restore
+  // -----------------------------------------------------------------------
+  /**
+   * 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`
+   */
+  async restoreSiteConfig(salesChannelId, version) {
+    return this.request(
+      "POST",
+      `/admin/thor/site-config/${salesChannelId}/restore/${encodeURIComponent(version)}`
+    );
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MedusaAdminClient
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/admin.ts"],"sourcesContent":["/**\n * @thorprovider/medusa-extended\n * Thor Commerce multi-tenant admin extensions for Medusa\n */\n\nexport { MedusaAdminClient } from './admin';\nexport type { MedusaAdminClientConfig } from './admin';\n","/**\n * @fileoverview Medusa Multi-Tenant Admin Client\n * @module @thorprovider/adapters/providers/medusa/admin\n *\n * Wrapper methods for all `/admin/thor/` endpoints defined in the Thor Commerce\n * multi-tenant API contract.  Requires an admin API key (`adminConfig.apiKey`)\n * to be provided when creating the Medusa provider.\n *\n * Every method performs a raw `fetch` against the Medusa backend using the\n * admin API key (`x-medusa-access-token`) — the Medusa JS-SDK's admin client\n * does not expose these custom Thor plugin routes, so we use direct HTTP calls.\n *\n * Endpoint reference: `multitenant-api-contract.md`\n */\n\nimport type {\n  GetChannelCustomersOptions,\n  GetChannelCustomersResponse,\n  GetChannelApiKeysResponse,\n  GetChannelCategoriesOptions,\n  GetChannelCategoriesResponse,\n  GetCategorySalesChannelsResponse,\n  AssignCategoriesToChannelsBody,\n  AssignCategoriesToChannelsResponse,\n  UnassignCategoriesFromChannelsBody,\n  UnassignCategoriesFromChannelsResponse,\n  GetCollectionSalesChannelsResponse,\n  AssignCollectionsToChannelsBody,\n  AssignCollectionsToChannelsResponse,\n  UnassignCollectionsFromChannelsBody,\n  UnassignCollectionsFromChannelsResponse,\n  GetAdminStorefrontConfigResponse,\n  UpdateStorefrontConfigBody,\n  UpdateStorefrontConfigResponse,\n  GetAdminSiteConfigResponse,\n  UpdateSiteConfigBody,\n  UpdateSiteConfigResponse,\n  GetAdminSiteConfigHistoryOptions,\n  GetAdminSiteConfigHistoryResponse,\n  RestoreSiteConfigResponse,\n} from '@thorprovider/types';\nimport { createLogger, ProviderAPIError } from '@thorprovider/adapters';\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\ntype FetchMethod = 'GET' | 'POST' | 'PUT' | 'DELETE';\n\n/**\n * Configuration required to instantiate the admin client.\n */\nexport interface MedusaAdminClientConfig {\n  /** Medusa backend base URL */\n  baseUrl: string;\n  /** Secret admin API key (x-medusa-access-token) */\n  apiKey: string;\n  /** Enable debug logging */\n  debug?: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// MedusaAdminClient\n// ---------------------------------------------------------------------------\n\n/**\n * HTTP client for Thor Commerce multi-tenant admin endpoints (`/admin/thor/`).\n *\n * All methods throw `ProviderAPIError` on non-2xx responses.\n *\n * @example\n * ```typescript\n * const admin = new MedusaAdminClient({\n *   baseUrl: process.env.MEDUSA_BACKEND_URL!,\n *   apiKey: process.env.MEDUSA_ADMIN_API_KEY!,\n * });\n *\n * const { customers } = await admin.getChannelCustomers('sc_01JXXXXX');\n * ```\n */\nexport class MedusaAdminClient {\n  private baseUrl: string;\n  private apiKey: string;\n  private logger: ReturnType<typeof createLogger>;\n\n  constructor(config: MedusaAdminClientConfig) {\n    this.baseUrl = config.baseUrl.replace(/\\/$/, '');\n    this.apiKey = config.apiKey;\n    this.logger = createLogger('MedusaAdminClient', config.debug);\n  }\n\n  // -----------------------------------------------------------------------\n  // Private — HTTP helper\n  // -----------------------------------------------------------------------\n\n  private async request<T>(\n    method: FetchMethod,\n    path: string,\n    body?: unknown,\n  ): Promise<T> {\n    const url = `${this.baseUrl}${path}`;\n    this.logger.debug(`[admin] ${method} ${path}`);\n\n    const headers: Record<string, string> = {\n      'x-medusa-access-token': this.apiKey,\n      'Content-Type': 'application/json',\n    };\n\n    const init: RequestInit = {\n      method,\n      headers,\n      ...(body !== undefined ? { body: JSON.stringify(body) } : {}),\n    };\n\n    let response: Response;\n    try {\n      response = await fetch(url, init);\n    } catch (networkError: any) {\n      throw new ProviderAPIError(\n        `[admin] Network error on ${method} ${path}: ${networkError.message}`,\n        'NETWORK_ERROR',\n        networkError,\n      );\n    }\n\n    if (!response.ok) {\n      let message = `HTTP ${response.status}`;\n      try {\n        const json = await response.json();\n        message = json?.message ?? message;\n      } catch {\n        // ignore parse errors\n      }\n      throw new ProviderAPIError(\n        `[admin] ${method} ${path} failed: ${message}`,\n        `ADMIN_API_${response.status}`,\n        response.status,\n      );\n    }\n\n    return response.json() as Promise<T>;\n  }\n\n  // -----------------------------------------------------------------------\n  // 3.1 — Sales Channel: Customers\n  // -----------------------------------------------------------------------\n\n  /**\n   * Paginated list of customers linked to a sales channel.\n   *\n   * `GET /admin/thor/sales-channels/:id/customers`\n   */\n  async getChannelCustomers(\n    salesChannelId: string,\n    options: GetChannelCustomersOptions = {},\n  ): Promise<GetChannelCustomersResponse> {\n    const { limit = 20, offset = 0 } = options;\n    return this.request<GetChannelCustomersResponse>(\n      'GET',\n      `/admin/thor/sales-channels/${salesChannelId}/customers?limit=${limit}&offset=${offset}`,\n    );\n  }\n\n  // -----------------------------------------------------------------------\n  // 3.2 — Sales Channel: API Keys\n  // -----------------------------------------------------------------------\n\n  /**\n   * Publishable API keys associated with a sales channel.\n   *\n   * `GET /admin/thor/sales-channels/:id/api-keys`\n   */\n  async getChannelApiKeys(salesChannelId: string): Promise<GetChannelApiKeysResponse> {\n    return this.request<GetChannelApiKeysResponse>(\n      'GET',\n      `/admin/thor/sales-channels/${salesChannelId}/api-keys`,\n    );\n  }\n\n  // -----------------------------------------------------------------------\n  // 3.3 — Sales Channel: Categories\n  // -----------------------------------------------------------------------\n\n  /**\n   * Product categories assigned to a sales channel.\n   *\n   * `GET /admin/thor/sales-channels/:id/categories`\n   */\n  async getChannelCategories(\n    salesChannelId: string,\n    options: GetChannelCategoriesOptions = {},\n  ): Promise<GetChannelCategoriesResponse> {\n    const { limit = 20, offset = 0, include_descendants = false } = options;\n    const qs = new URLSearchParams({\n      limit: String(limit),\n      offset: String(offset),\n      include_descendants: String(include_descendants),\n    });\n    return this.request<GetChannelCategoriesResponse>(\n      'GET',\n      `/admin/thor/sales-channels/${salesChannelId}/categories?${qs}`,\n    );\n  }\n\n  // -----------------------------------------------------------------------\n  // 3.4 — Category: Sales Channels\n  // -----------------------------------------------------------------------\n\n  /**\n   * Sales channels to which a category is assigned.\n   *\n   * `GET /admin/thor/categories/:id/sales-channels`\n   */\n  async getCategorySalesChannels(\n    categoryId: string,\n  ): Promise<GetCategorySalesChannelsResponse> {\n    return this.request<GetCategorySalesChannelsResponse>(\n      'GET',\n      `/admin/thor/categories/${categoryId}/sales-channels`,\n    );\n  }\n\n  // -----------------------------------------------------------------------\n  // 3.5 — Category: Assign to Sales Channels\n  // -----------------------------------------------------------------------\n\n  /**\n   * Assign a category to one or more sales channels (idempotent).\n   *\n   * `POST /admin/thor/categories/:id/sales-channels`\n   */\n  async assignCategoryToChannels(\n    categoryId: string,\n    body: AssignCategoriesToChannelsBody,\n  ): Promise<AssignCategoriesToChannelsResponse> {\n    return this.request<AssignCategoriesToChannelsResponse>(\n      'POST',\n      `/admin/thor/categories/${categoryId}/sales-channels`,\n      body,\n    );\n  }\n\n  // -----------------------------------------------------------------------\n  // 3.6 — Category: Unassign from Sales Channels\n  // -----------------------------------------------------------------------\n\n  /**\n   * Remove category assignment from one or more sales channels (idempotent).\n   *\n   * `DELETE /admin/thor/categories/:id/sales-channels`\n   */\n  async unassignCategoryFromChannels(\n    categoryId: string,\n    body: UnassignCategoriesFromChannelsBody,\n  ): Promise<UnassignCategoriesFromChannelsResponse> {\n    return this.request<UnassignCategoriesFromChannelsResponse>(\n      'DELETE',\n      `/admin/thor/categories/${categoryId}/sales-channels`,\n      body,\n    );\n  }\n\n  // -----------------------------------------------------------------------\n  // 3.7 — Collection: Sales Channels\n  // -----------------------------------------------------------------------\n\n  /**\n   * Sales channels to which a collection is assigned.\n   *\n   * `GET /admin/thor/collections/:id/sales-channels`\n   */\n  async getCollectionSalesChannels(\n    collectionId: string,\n  ): Promise<GetCollectionSalesChannelsResponse> {\n    return this.request<GetCollectionSalesChannelsResponse>(\n      'GET',\n      `/admin/thor/collections/${collectionId}/sales-channels`,\n    );\n  }\n\n  // -----------------------------------------------------------------------\n  // 3.8 — Collection: Assign to Sales Channels\n  // -----------------------------------------------------------------------\n\n  /**\n   * Assign a collection to one or more sales channels (idempotent).\n   *\n   * `POST /admin/thor/collections/:id/sales-channels`\n   */\n  async assignCollectionToChannels(\n    collectionId: string,\n    body: AssignCollectionsToChannelsBody,\n  ): Promise<AssignCollectionsToChannelsResponse> {\n    return this.request<AssignCollectionsToChannelsResponse>(\n      'POST',\n      `/admin/thor/collections/${collectionId}/sales-channels`,\n      body,\n    );\n  }\n\n  // -----------------------------------------------------------------------\n  // 3.9 — Collection: Unassign from Sales Channels\n  // -----------------------------------------------------------------------\n\n  /**\n   * Remove collection assignment from one or more sales channels (idempotent).\n   *\n   * `DELETE /admin/thor/collections/:id/sales-channels`\n   */\n  async unassignCollectionFromChannels(\n    collectionId: string,\n    body: UnassignCollectionsFromChannelsBody,\n  ): Promise<UnassignCollectionsFromChannelsResponse> {\n    return this.request<UnassignCollectionsFromChannelsResponse>(\n      'DELETE',\n      `/admin/thor/collections/${collectionId}/sales-channels`,\n      body,\n    );\n  }\n\n  // -----------------------------------------------------------------------\n  // 3.10 — Storefront Config: Read\n  // -----------------------------------------------------------------------\n\n  /**\n   * Read the visual storefront configuration for a channel.\n   * `:id` is the `sales_channel_id`.\n   *\n   * `GET /admin/thor/storefront-config/:id`\n   */\n  async getStorefrontConfig(\n    salesChannelId: string,\n  ): Promise<GetAdminStorefrontConfigResponse> {\n    return this.request<GetAdminStorefrontConfigResponse>(\n      'GET',\n      `/admin/thor/storefront-config/${salesChannelId}`,\n    );\n  }\n\n  // -----------------------------------------------------------------------\n  // 3.11 — Storefront Config: Update\n  // -----------------------------------------------------------------------\n\n  /**\n   * Update the visual storefront configuration for a channel.\n   * Triggers the `storefront_config.updated` event → ISR webhook.\n   *\n   * `PUT /admin/thor/storefront-config/:id`\n   */\n  async updateStorefrontConfig(\n    salesChannelId: string,\n    body: UpdateStorefrontConfigBody,\n  ): Promise<UpdateStorefrontConfigResponse> {\n    return this.request<UpdateStorefrontConfigResponse>(\n      'PUT',\n      `/admin/thor/storefront-config/${salesChannelId}`,\n      body,\n    );\n  }\n\n  // -----------------------------------------------------------------------\n  // 3.12 — Site Designer Config: Read\n  // -----------------------------------------------------------------------\n\n  /**\n   * Read the active Site Designer configuration for a channel, including the\n   * last 10 history entries.\n   *\n   * `GET /admin/thor/site-config/:sales_channel_id`\n   */\n  async getSiteConfig(salesChannelId: string): Promise<GetAdminSiteConfigResponse> {\n    return this.request<GetAdminSiteConfigResponse>(\n      'GET',\n      `/admin/thor/site-config/${salesChannelId}`,\n    );\n  }\n\n  // -----------------------------------------------------------------------\n  // 3.13 — Site Designer Config: Update\n  // -----------------------------------------------------------------------\n\n  /**\n   * Update the Site Designer configuration for a channel.\n   * Creates a new history entry on every PUT.\n   *\n   * `PUT /admin/thor/site-config/:sales_channel_id`\n   */\n  async updateSiteConfig(\n    salesChannelId: string,\n    body: UpdateSiteConfigBody,\n  ): Promise<UpdateSiteConfigResponse> {\n    return this.request<UpdateSiteConfigResponse>(\n      'PUT',\n      `/admin/thor/site-config/${salesChannelId}`,\n      body,\n    );\n  }\n\n  // -----------------------------------------------------------------------\n  // 3.14 — Site Designer Config: History\n  // -----------------------------------------------------------------------\n\n  /**\n   * Full paginated history of Site Designer versions for a channel.\n   * Entries are immutable — they are never deleted.\n   *\n   * `GET /admin/thor/site-config/:sales_channel_id/history`\n   */\n  async getSiteConfigHistory(\n    salesChannelId: string,\n    options: GetAdminSiteConfigHistoryOptions = {},\n  ): Promise<GetAdminSiteConfigHistoryResponse> {\n    const { limit = 20, offset = 0 } = options;\n    return this.request<GetAdminSiteConfigHistoryResponse>(\n      'GET',\n      `/admin/thor/site-config/${salesChannelId}/history?limit=${limit}&offset=${offset}`,\n    );\n  }\n\n  // -----------------------------------------------------------------------\n  // 3.15 — Site Designer Config: Restore\n  // -----------------------------------------------------------------------\n\n  /**\n   * Restore a previous Site Designer version.\n   * Internally runs the update workflow with the stored config of the target\n   * version — this creates a **new** history entry and does NOT mutate past\n   * entries.\n   *\n   * `POST /admin/thor/site-config/:sales_channel_id/restore/:version`\n   */\n  async restoreSiteConfig(\n    salesChannelId: string,\n    version: string,\n  ): Promise<RestoreSiteConfigResponse> {\n    return this.request<RestoreSiteConfigResponse>(\n      'POST',\n      `/admin/thor/site-config/${salesChannelId}/restore/${encodeURIComponent(version)}`,\n    );\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACyCA,sBAA+C;AAuCxC,IAAM,oBAAN,MAAwB;AAAA,EACrB;AAAA,EACA;AAAA,EACA;AAAA,EAER,YAAY,QAAiC;AAC3C,SAAK,UAAU,OAAO,QAAQ,QAAQ,OAAO,EAAE;AAC/C,SAAK,SAAS,OAAO;AACrB,SAAK,aAAS,8BAAa,qBAAqB,OAAO,KAAK;AAAA,EAC9D;AAAA;AAAA;AAAA;AAAA,EAMA,MAAc,QACZ,QACA,MACA,MACY;AACZ,UAAM,MAAM,GAAG,KAAK,OAAO,GAAG,IAAI;AAClC,SAAK,OAAO,MAAM,WAAW,MAAM,IAAI,IAAI,EAAE;AAE7C,UAAM,UAAkC;AAAA,MACtC,yBAAyB,KAAK;AAAA,MAC9B,gBAAgB;AAAA,IAClB;AAEA,UAAM,OAAoB;AAAA,MACxB;AAAA,MACA;AAAA,MACA,GAAI,SAAS,SAAY,EAAE,MAAM,KAAK,UAAU,IAAI,EAAE,IAAI,CAAC;AAAA,IAC7D;AAEA,QAAI;AACJ,QAAI;AACF,iBAAW,MAAM,MAAM,KAAK,IAAI;AAAA,IAClC,SAAS,cAAmB;AAC1B,YAAM,IAAI;AAAA,QACR,4BAA4B,MAAM,IAAI,IAAI,KAAK,aAAa,OAAO;AAAA,QACnE;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAEA,QAAI,CAAC,SAAS,IAAI;AAChB,UAAI,UAAU,QAAQ,SAAS,MAAM;AACrC,UAAI;AACF,cAAM,OAAO,MAAM,SAAS,KAAK;AACjC,kBAAU,MAAM,WAAW;AAAA,MAC7B,QAAQ;AAAA,MAER;AACA,YAAM,IAAI;AAAA,QACR,WAAW,MAAM,IAAI,IAAI,YAAY,OAAO;AAAA,QAC5C,aAAa,SAAS,MAAM;AAAA,QAC5B,SAAS;AAAA,MACX;AAAA,IACF;AAEA,WAAO,SAAS,KAAK;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,MAAM,oBACJ,gBACA,UAAsC,CAAC,GACD;AACtC,UAAM,EAAE,QAAQ,IAAI,SAAS,EAAE,IAAI;AACnC,WAAO,KAAK;AAAA,MACV;AAAA,MACA,8BAA8B,cAAc,oBAAoB,KAAK,WAAW,MAAM;AAAA,IACxF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,MAAM,kBAAkB,gBAA4D;AAClF,WAAO,KAAK;AAAA,MACV;AAAA,MACA,8BAA8B,cAAc;AAAA,IAC9C;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,MAAM,qBACJ,gBACA,UAAuC,CAAC,GACD;AACvC,UAAM,EAAE,QAAQ,IAAI,SAAS,GAAG,sBAAsB,MAAM,IAAI;AAChE,UAAM,KAAK,IAAI,gBAAgB;AAAA,MAC7B,OAAO,OAAO,KAAK;AAAA,MACnB,QAAQ,OAAO,MAAM;AAAA,MACrB,qBAAqB,OAAO,mBAAmB;AAAA,IACjD,CAAC;AACD,WAAO,KAAK;AAAA,MACV;AAAA,MACA,8BAA8B,cAAc,eAAe,EAAE;AAAA,IAC/D;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,MAAM,yBACJ,YAC2C;AAC3C,WAAO,KAAK;AAAA,MACV;AAAA,MACA,0BAA0B,UAAU;AAAA,IACtC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,MAAM,yBACJ,YACA,MAC6C;AAC7C,WAAO,KAAK;AAAA,MACV;AAAA,MACA,0BAA0B,UAAU;AAAA,MACpC;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,MAAM,6BACJ,YACA,MACiD;AACjD,WAAO,KAAK;AAAA,MACV;AAAA,MACA,0BAA0B,UAAU;AAAA,MACpC;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,MAAM,2BACJ,cAC6C;AAC7C,WAAO,KAAK;AAAA,MACV;AAAA,MACA,2BAA2B,YAAY;AAAA,IACzC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,MAAM,2BACJ,cACA,MAC8C;AAC9C,WAAO,KAAK;AAAA,MACV;AAAA,MACA,2BAA2B,YAAY;AAAA,MACvC;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,MAAM,+BACJ,cACA,MACkD;AAClD,WAAO,KAAK;AAAA,MACV;AAAA,MACA,2BAA2B,YAAY;AAAA,MACvC;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAM,oBACJ,gBAC2C;AAC3C,WAAO,KAAK;AAAA,MACV;AAAA,MACA,iCAAiC,cAAc;AAAA,IACjD;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAM,uBACJ,gBACA,MACyC;AACzC,WAAO,KAAK;AAAA,MACV;AAAA,MACA,iCAAiC,cAAc;AAAA,MAC/C;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAM,cAAc,gBAA6D;AAC/E,WAAO,KAAK;AAAA,MACV;AAAA,MACA,2BAA2B,cAAc;AAAA,IAC3C;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAM,iBACJ,gBACA,MACmC;AACnC,WAAO,KAAK;AAAA,MACV;AAAA,MACA,2BAA2B,cAAc;AAAA,MACzC;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAM,qBACJ,gBACA,UAA4C,CAAC,GACD;AAC5C,UAAM,EAAE,QAAQ,IAAI,SAAS,EAAE,IAAI;AACnC,WAAO,KAAK;AAAA,MACV;AAAA,MACA,2BAA2B,cAAc,kBAAkB,KAAK,WAAW,MAAM;AAAA,IACnF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,MAAM,kBACJ,gBACA,SACoC;AACpC,WAAO,KAAK;AAAA,MACV;AAAA,MACA,2BAA2B,cAAc,YAAY,mBAAmB,OAAO,CAAC;AAAA,IAClF;AAAA,EACF;AACF;","names":[]}