@thorprovider/medusa-extended 1.0.0 → 1.1.0

package/dist/index.js

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
+  DropshipperClient: () => DropshipperClient,
   MedusaAdminClient: () => MedusaAdminClient
 });
 module.exports = __toCommonJS(src_exports);
@@ -308,8 +309,764 @@ var MedusaAdminClient = class {
     );
   }
 };
+
+// src/dropshipper.ts
+var import_adapters2 = require("@thorprovider/adapters");
+var DropshipperClient = class {
+  baseUrl;
+  token;
+  logger;
+  constructor(config) {
+    this.baseUrl = config.baseUrl.replace(/\/$/, "");
+    this.token = config.token;
+    this.logger = (0, import_adapters2.createLogger)("DropshipperClient", config.debug);
+  }
+  // -------------------------------------------------------------------------
+  // Private — HTTP helper
+  // -------------------------------------------------------------------------
+  async request(method, path, body) {
+    const url = `${this.baseUrl}${path}`;
+    this.logger.debug(`[dropshipper] ${method} ${path}`);
+    const headers = {
+      Authorization: `Bearer ${this.token}`,
+      "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_adapters2.ProviderAPIError(
+        `[dropshipper] 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_adapters2.ProviderAPIError(
+        `[dropshipper] ${method} ${path} failed: ${message}`,
+        `DROPSHIPPER_API_${response.status}`,
+        response.status
+      );
+    }
+    return response.json();
+  }
+  // -------------------------------------------------------------------------
+  // Onboarding (Solo X)
+  // -------------------------------------------------------------------------
+  /**
+   * Create a new dropshipper account (sales channel + user + price list).
+   *
+   * `POST /admin/thor/dropshipper/onboard`
+   */
+  async onboardDropshipper(body) {
+    return this.request(
+      "POST",
+      "/admin/thor/dropshipper/onboard",
+      body
+    );
+  }
+  // -------------------------------------------------------------------------
+  // Variant Costs (Solo X)
+  // -------------------------------------------------------------------------
+  /**
+   * List variant cost records, optionally filtered by account/variant/currency.
+   *
+   * `GET /admin/thor/dropshipper/variant-costs`
+   */
+  async getVariantCosts(options = {}) {
+    const { account_id, variant_id, currency_code, limit = 20, offset = 0 } = options;
+    const qs = new URLSearchParams({
+      limit: String(limit),
+      offset: String(offset),
+      ...account_id ? { account_id } : {},
+      ...variant_id ? { variant_id } : {},
+      ...currency_code ? { currency_code } : {}
+    });
+    return this.request(
+      "GET",
+      `/admin/thor/dropshipper/variant-costs?${qs}`
+    );
+  }
+  /**
+   * Upsert a single variant cost record.
+   *
+   * `POST /admin/thor/dropshipper/variant-costs`
+   */
+  async createVariantCost(body) {
+    return this.request(
+      "POST",
+      "/admin/thor/dropshipper/variant-costs",
+      body
+    );
+  }
+  /**
+   * Batch-upsert variant costs for a given account and currency.
+   *
+   * `POST /admin/thor/dropshipper/variant-costs/batch`
+   */
+  async batchVariantCosts(body) {
+    return this.request(
+      "POST",
+      "/admin/thor/dropshipper/variant-costs/batch",
+      body
+    );
+  }
+  /**
+   * Delete a variant cost record by ID.
+   *
+   * `DELETE /admin/thor/dropshipper/variant-costs/:id`
+   */
+  async deleteVariantCost(id) {
+    return this.request(
+      "DELETE",
+      `/admin/thor/dropshipper/variant-costs/${id}`
+    );
+  }
+  // -------------------------------------------------------------------------
+  // Products (Solo Y)
+  // -------------------------------------------------------------------------
+  /**
+   * List products available in Y's channel with cost/margin data.
+   *
+   * `GET /admin/thor/dropshipper/products`
+   */
+  async getProducts(options = {}) {
+    const { q, category_id, status, in_stock, limit = 20, offset = 0 } = options;
+    const qs = new URLSearchParams({
+      limit: String(limit),
+      offset: String(offset),
+      ...q ? { q } : {},
+      ...category_id ? { category_id } : {},
+      ...status ? { status } : {},
+      ...in_stock !== void 0 ? { in_stock: String(in_stock) } : {}
+    });
+    return this.request(
+      "GET",
+      `/admin/thor/dropshipper/products?${qs}`
+    );
+  }
+  // -------------------------------------------------------------------------
+  // Prices (Solo Y)
+  // -------------------------------------------------------------------------
+  /**
+   * Bulk-update sale prices on Y's channel price list.
+   *
+   * `PUT /admin/thor/dropshipper/prices`
+   */
+  async updatePrices(body) {
+    return this.request(
+      "PUT",
+      "/admin/thor/dropshipper/prices",
+      body
+    );
+  }
+  // -------------------------------------------------------------------------
+  // Orders (Y + X for set-payment-collector)
+  // -------------------------------------------------------------------------
+  /**
+   * Paginated list of orders in Y's channel.
+   *
+   * `GET /admin/thor/dropshipper/orders`
+   */
+  async getOrders(options = {}) {
+    const { status, payment_collector, settlement_status, from, to, q, limit = 20, offset = 0 } = options;
+    const qs = new URLSearchParams({
+      limit: String(limit),
+      offset: String(offset),
+      ...status ? { status } : {},
+      ...payment_collector ? { payment_collector } : {},
+      ...settlement_status ? { settlement_status } : {},
+      ...from ? { from } : {},
+      ...to ? { to } : {},
+      ...q ? { q } : {}
+    });
+    return this.request(
+      "GET",
+      `/admin/thor/dropshipper/orders?${qs}`
+    );
+  }
+  /**
+   * Full detail for a single order with profit breakdown.
+   *
+   * `GET /admin/thor/dropshipper/orders/:id`
+   */
+  async getOrder(orderId) {
+    return this.request(
+      "GET",
+      `/admin/thor/dropshipper/orders/${orderId}`
+    );
+  }
+  /**
+   * Manually create an order on behalf of a customer.
+   *
+   * `POST /admin/thor/dropshipper/orders`
+   */
+  async createOrder(body) {
+    return this.request(
+      "POST",
+      "/admin/thor/dropshipper/orders",
+      body
+    );
+  }
+  /**
+   * Set who collects payment for an order (Solo X).
+   *
+   * `POST /admin/thor/dropshipper/orders/:id/set-payment-collector`
+   */
+  async setPaymentCollector(orderId, body) {
+    return this.request(
+      "POST",
+      `/admin/thor/dropshipper/orders/${orderId}/set-payment-collector`,
+      body
+    );
+  }
+  // -------------------------------------------------------------------------
+  // Order Cancel & Edits (Solo Y) — B-04
+  // -------------------------------------------------------------------------
+  /**
+   * Cancel a dropshipper order.
+   *
+   * `POST /admin/thor/dropshipper/orders/:id/cancel`
+   */
+  async cancelOrder(orderId) {
+    return this.request(
+      "POST",
+      `/admin/thor/dropshipper/orders/${orderId}/cancel`
+    );
+  }
+  /**
+   * Create an order edit for a dropshipper order.
+   *
+   * `POST /admin/thor/dropshipper/orders/:id/edit`
+   */
+  async createOrderEdit(orderId, body = {}) {
+    return this.request(
+      "POST",
+      `/admin/thor/dropshipper/orders/${orderId}/edit`,
+      body
+    );
+  }
+  /**
+   * Add an item to the active order edit.
+   *
+   * `POST /admin/thor/dropshipper/orders/:id/edit/items`
+   */
+  async addOrderEditItem(orderId, body) {
+    return this.request(
+      "POST",
+      `/admin/thor/dropshipper/orders/${orderId}/edit/items`,
+      body
+    );
+  }
+  /**
+   * Confirm the active order edit, applying changes to the order.
+   *
+   * `POST /admin/thor/dropshipper/orders/:id/edit/confirm`
+   */
+  async confirmOrderEdit(orderId) {
+    return this.request(
+      "POST",
+      `/admin/thor/dropshipper/orders/${orderId}/edit/confirm`
+    );
+  }
+  /**
+     * Get all notes for an order.
+  *
+  * `GET /admin/thor/dropshipper/orders/:id/notes`
+  */
+  async getOrderNotes(orderId) {
+    return this.request(
+      "GET",
+      `/admin/thor/dropshipper/orders/${orderId}/notes`
+    );
+  }
+  /**
+   * Create a new note for an order.
+   *
+   * `POST /admin/thor/dropshipper/orders/:id/notes`
+   */
+  async createOrderNote(orderId, body) {
+    return this.request(
+      "POST",
+      `/admin/thor/dropshipper/orders/${orderId}/notes`,
+      body
+    );
+  }
+  /**
+   * Delete a note from an order.
+   *
+   * `DELETE /admin/thor/dropshipper/orders/:id/notes/:noteId`
+   */
+  async deleteOrderNote(orderId, noteId) {
+    return this.request(
+      "DELETE",
+      `/admin/thor/dropshipper/orders/${orderId}/notes/${noteId}`
+    );
+  }
+  // -------------------------------------------------------------------------
+  // Custom Categories (Solo Y)
+  // -------------------------------------------------------------------------
+  /**
+   * List Y's custom product categories.
+   *
+   * `GET /admin/thor/dropshipper/categories`
+   */
+  async getCategories(options = {}) {
+    const { parent_id, include_children } = options;
+    const qs = new URLSearchParams({
+      ...parent_id ? { parent_id } : {},
+      ...include_children !== void 0 ? { include_children: String(include_children) } : {}
+    });
+    const query = qs.toString() ? `?${qs}` : "";
+    return this.request(
+      "GET",
+      `/admin/thor/dropshipper/categories${query}`
+    );
+  }
+  /**
+   * Create a custom category in Y's channel.
+   *
+   * `POST /admin/thor/dropshipper/categories`
+   */
+  async createCategory(body) {
+    return this.request(
+      "POST",
+      "/admin/thor/dropshipper/categories",
+      body
+    );
+  }
+  /**
+   * Update a custom category.
+   *
+   * `PUT /admin/thor/dropshipper/categories/:id`
+   */
+  async updateCategory(categoryId, body) {
+    return this.request(
+      "PUT",
+      `/admin/thor/dropshipper/categories/${categoryId}`,
+      body
+    );
+  }
+  /**
+   * Delete a custom category.
+   *
+   * `DELETE /admin/thor/dropshipper/categories/:id`
+   */
+  async deleteCategory(categoryId) {
+    return this.request(
+      "DELETE",
+      `/admin/thor/dropshipper/categories/${categoryId}`
+    );
+  }
+  /**
+   * Map a product to a custom category.
+   *
+   * `POST /admin/thor/dropshipper/category-mappings`
+   */
+  async createCategoryMapping(body) {
+    return this.request(
+      "POST",
+      "/admin/thor/dropshipper/category-mappings",
+      body
+    );
+  }
+  /**
+   * Remove a product-to-category mapping.
+   *
+   * `DELETE /admin/thor/dropshipper/category-mappings/:id`
+   */
+  async deleteCategoryMapping(mappingId) {
+    return this.request(
+      "DELETE",
+      `/admin/thor/dropshipper/category-mappings/${mappingId}`
+    );
+  }
+  // -------------------------------------------------------------------------
+  // Customers (Solo Y)
+  // -------------------------------------------------------------------------
+  /**
+   * Paginated list of customers in Y's channel.
+   *
+   * `GET /admin/thor/dropshipper/customers`
+   */
+  async getCustomers(options = {}) {
+    const { q, has_orders, from, limit = 20, offset = 0 } = options;
+    const qs = new URLSearchParams({
+      limit: String(limit),
+      offset: String(offset),
+      ...q ? { q } : {},
+      ...has_orders !== void 0 ? { has_orders: String(has_orders) } : {},
+      ...from ? { from } : {}
+    });
+    return this.request(
+      "GET",
+      `/admin/thor/dropshipper/customers?${qs}`
+    );
+  }
+  /**
+   * Full detail for a single customer.
+   *
+   * `GET /admin/thor/dropshipper/customers/:id`
+   */
+  async getCustomer(customerId) {
+    return this.request(
+      "GET",
+      `/admin/thor/dropshipper/customers/${customerId}`
+    );
+  }
+  /**
+   * Create a customer scoped to Y's channel.
+   *
+   * `POST /admin/thor/dropshipper/customers`
+   */
+  async createCustomer(body) {
+    return this.request(
+      "POST",
+      "/admin/thor/dropshipper/customers",
+      body
+    );
+  }
+  // -------------------------------------------------------------------------
+  // Customer Addresses (Solo Y) — B-06
+  // -------------------------------------------------------------------------
+  /**
+   * List addresses for a customer in Y's channel.
+   *
+   * `GET /admin/thor/dropshipper/customers/:id/addresses`
+   */
+  async getCustomerAddresses(customerId) {
+    return this.request(
+      "GET",
+      `/admin/thor/dropshipper/customers/${customerId}/addresses`
+    );
+  }
+  /**
+   * Create a new address for a customer.
+   *
+   * `POST /admin/thor/dropshipper/customers/:id/addresses`
+   */
+  async createCustomerAddress(customerId, body) {
+    return this.request(
+      "POST",
+      `/admin/thor/dropshipper/customers/${customerId}/addresses`,
+      body
+    );
+  }
+  /**
+   * Update an existing customer address.
+   *
+   * `PUT /admin/thor/dropshipper/customers/:id/addresses/:addressId`
+   */
+  async updateCustomerAddress(customerId, addressId, body) {
+    return this.request(
+      "PUT",
+      `/admin/thor/dropshipper/customers/${customerId}/addresses/${addressId}`,
+      body
+    );
+  }
+  /**
+   * Delete a customer address.
+   *
+   * `DELETE /admin/thor/dropshipper/customers/:id/addresses/:addressId`
+   */
+  async deleteCustomerAddress(customerId, addressId) {
+    return this.request(
+      "DELETE",
+      `/admin/thor/dropshipper/customers/${customerId}/addresses/${addressId}`
+    );
+  }
+  // -------------------------------------------------------------------------
+  // Account & Settlements (Y read-only)
+  // -------------------------------------------------------------------------
+  /**
+   * Y's account info with current balance.
+   *
+   * `GET /admin/thor/dropshipper/account`
+   */
+  async getAccount() {
+    return this.request(
+      "GET",
+      "/admin/thor/dropshipper/account"
+    );
+  }
+  /**
+   * Orders where Y owes money to X (Y collected payment, needs to pay costs).
+   *
+   * `GET /admin/thor/dropshipper/account/payable`
+   */
+  async getPayable() {
+    return this.request(
+      "GET",
+      "/admin/thor/dropshipper/account/payable"
+    );
+  }
+  /**
+   * Orders where X owes money to Y (X collected COD, needs to transfer profit).
+   *
+   * `GET /admin/thor/dropshipper/account/receivable`
+   */
+  async getReceivable() {
+    return this.request(
+      "GET",
+      "/admin/thor/dropshipper/account/receivable"
+    );
+  }
+  /**
+   * List settlements (Y sees own; X can filter by account_id).
+   *
+   * `GET /admin/thor/dropshipper/settlements`
+   */
+  async getSettlements(options = {}) {
+    const { status, type, account_id, limit = 20, offset = 0 } = options;
+    const qs = new URLSearchParams({
+      limit: String(limit),
+      offset: String(offset),
+      ...status ? { status } : {},
+      ...type ? { type } : {},
+      ...account_id ? { account_id } : {}
+    });
+    return this.request(
+      "GET",
+      `/admin/thor/dropshipper/settlements?${qs}`
+    );
+  }
+  /**
+   * Full detail for a single settlement record.
+   *
+   * `GET /admin/thor/dropshipper/settlements/:id`
+   */
+  async getSettlement(settlementId) {
+    return this.request(
+      "GET",
+      `/admin/thor/dropshipper/settlements/${settlementId}`
+    );
+  }
+  // -------------------------------------------------------------------------
+  // Admin Settlements (Solo X)
+  // -------------------------------------------------------------------------
+  /**
+   * Create a settlement record for a dropshipper account.
+   *
+   * `POST /admin/thor/dropshipper/admin/settlements`
+   */
+  async createSettlement(body) {
+    return this.request(
+      "POST",
+      "/admin/thor/dropshipper/admin/settlements",
+      body
+    );
+  }
+  /**
+   * Confirm a pending settlement (marks it as paid/received).
+   *
+   * `POST /admin/thor/dropshipper/admin/settlements/:id/confirm`
+   */
+  async confirmSettlement(settlementId, body = {}) {
+    return this.request(
+      "POST",
+      `/admin/thor/dropshipper/admin/settlements/${settlementId}/confirm`,
+      body
+    );
+  }
+  /**
+   * Cancel a pending settlement.
+   *
+   * `POST /admin/thor/dropshipper/admin/settlements/:id/cancel`
+   */
+  async cancelSettlement(settlementId, body = {}) {
+    return this.request(
+      "POST",
+      `/admin/thor/dropshipper/admin/settlements/${settlementId}/cancel`,
+      body
+    );
+  }
+  // -------------------------------------------------------------------------
+  // Admin Settlements — list (Solo X)
+  // -------------------------------------------------------------------------
+  /**
+   * X views all settlement records across all dropshipper accounts.
+   *
+   * `GET /admin/thor/dropshipper/admin/settlements`
+   */
+  async getAdminSettlements(options = {}) {
+    const { status, type, account_id, limit = 20, offset = 0 } = options;
+    const qs = new URLSearchParams({
+      limit: String(limit),
+      offset: String(offset),
+      ...status ? { status } : {},
+      ...type ? { type } : {},
+      ...account_id ? { account_id } : {}
+    });
+    return this.request(
+      "GET",
+      `/admin/thor/dropshipper/admin/settlements?${qs}`
+    );
+  }
+  // -------------------------------------------------------------------------
+  // Admin Account Management (Solo X)
+  // -------------------------------------------------------------------------
+  /**
+   * List all dropshipper accounts.
+   *
+   * `GET /admin/thor/dropshipper/admin/accounts`
+   */
+  async getAdminAccounts() {
+    return this.request(
+      "GET",
+      "/admin/thor/dropshipper/admin/accounts"
+    );
+  }
+  /**
+   * Full balance detail for a specific dropshipper account.
+   *
+   * `GET /admin/thor/dropshipper/admin/accounts/:id/balance`
+   */
+  async getAdminAccountBalance(accountId) {
+    return this.request(
+      "GET",
+      `/admin/thor/dropshipper/admin/accounts/${accountId}/balance`
+    );
+  }
+  /**
+   * List all dropshipper price lists.
+   *
+   * `GET /admin/thor/dropshipper/admin/price-lists`
+   */
+  async getAdminPriceLists() {
+    return this.request(
+      "GET",
+      "/admin/thor/dropshipper/admin/price-lists"
+    );
+  }
+  /**
+   * Utility: look up which sales channel a user belongs to.
+   *
+   * `GET /admin/thor/dropshipper/admin/user-channel`
+   */
+  async getUserChannel() {
+    return this.request(
+      "GET",
+      "/admin/thor/dropshipper/admin/user-channel"
+    );
+  }
+  // -------------------------------------------------------------------------
+  // Promotions (Solo Y)
+  // -------------------------------------------------------------------------
+  /**
+   * List Y's promotions (discount codes).
+   *
+   * `GET /admin/thor/dropshipper/promotions`
+   */
+  async getPromotions(options = {}) {
+    const { type, limit = 20, offset = 0 } = options;
+    const qs = new URLSearchParams({
+      limit: String(limit),
+      offset: String(offset),
+      ...type ? { type } : {}
+    });
+    return this.request(
+      "GET",
+      `/admin/thor/dropshipper/promotions?${qs}`
+    );
+  }
+  /**
+   * Create a promotion for Y's channel.
+   *
+   * `POST /admin/thor/dropshipper/promotions`
+   */
+  async createPromotion(body) {
+    return this.request(
+      "POST",
+      "/admin/thor/dropshipper/promotions",
+      body
+    );
+  }
+  /**
+   * Get a single promotion by ID.
+   *
+   * `GET /admin/thor/dropshipper/promotions/:id`
+   */
+  async getPromotion(promotionId) {
+    return this.request(
+      "GET",
+      `/admin/thor/dropshipper/promotions/${promotionId}`
+    );
+  }
+  /**
+   * Update an existing promotion.
+   *
+   * `PUT /admin/thor/dropshipper/promotions/:id`
+   */
+  async updatePromotion(promotionId, body) {
+    return this.request(
+      "PUT",
+      `/admin/thor/dropshipper/promotions/${promotionId}`,
+      body
+    );
+  }
+  /**
+   * Delete a promotion.
+   *
+   * `DELETE /admin/thor/dropshipper/promotions/:id`
+   */
+  async deletePromotion(promotionId) {
+    return this.request(
+      "DELETE",
+      `/admin/thor/dropshipper/promotions/${promotionId}`
+    );
+  }
+  // -------------------------------------------------------------------------
+  // Dashboard (Solo Y)
+  // -------------------------------------------------------------------------
+  /**
+   * Aggregate stats for Y's dashboard (revenue, profit, top products).
+   *
+   * `GET /admin/thor/dropshipper/dashboard/stats`
+   */
+  async getDashboardStats(options = {}) {
+    const { period, from, to, currency_code } = options;
+    const qs = new URLSearchParams({
+      ...period ? { period } : {},
+      ...from ? { from } : {},
+      ...to ? { to } : {},
+      ...currency_code ? { currency_code } : {}
+    });
+    const query = qs.toString() ? `?${qs}` : "";
+    return this.request(
+      "GET",
+      `/admin/thor/dropshipper/dashboard/stats${query}`
+    );
+  }
+  // -------------------------------------------------------------------------
+  // Storefront (V — end customer, uses publishable API key)
+  // -------------------------------------------------------------------------
+  /**
+   * Public endpoint: dropshipper-scoped categories for the storefront.
+   * Typically called with a publishable API key rather than a JWT.
+   *
+   * `GET /store/thor/dropshipper-categories`
+   */
+  async getStorefrontCategories() {
+    return this.request(
+      "GET",
+      "/store/thor/dropshipper-categories"
+    );
+  }
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  DropshipperClient,
   MedusaAdminClient
 });
 //# sourceMappingURL=index.js.map