@spree/sdk 0.1.0

package/dist/index.cjs

@@ -0,0 +1,534 @@
+'use strict';
+
+// src/client.ts
+var SpreeError = class extends Error {
+  code;
+  status;
+  details;
+  constructor(response, status) {
+    super(response.error.message);
+    this.name = "SpreeError";
+    this.code = response.error.code;
+    this.status = status;
+    this.details = response.error.details;
+  }
+};
+var SpreeClient = class {
+  baseUrl;
+  apiKey;
+  fetchFn;
+  constructor(config) {
+    this.baseUrl = config.baseUrl.replace(/\/$/, "");
+    this.apiKey = config.apiKey;
+    this.fetchFn = config.fetch || fetch.bind(globalThis);
+  }
+  async request(method, path, options = {}) {
+    const { token, orderToken, locale, currency, headers = {}, body, params } = options;
+    const url = new URL(`${this.baseUrl}/api/v3/store${path}`);
+    if (params) {
+      Object.entries(params).forEach(([key, value]) => {
+        if (value !== void 0) {
+          if (Array.isArray(value)) {
+            value.forEach((v) => url.searchParams.append(key, String(v)));
+          } else {
+            url.searchParams.set(key, String(value));
+          }
+        }
+      });
+    }
+    if (orderToken) {
+      url.searchParams.set("order_token", orderToken);
+    }
+    const requestHeaders = {
+      "Content-Type": "application/json",
+      "x-spree-api-key": this.apiKey,
+      ...headers
+    };
+    if (token) {
+      requestHeaders["Authorization"] = `Bearer ${token}`;
+    }
+    if (orderToken) {
+      requestHeaders["x-spree-order-token"] = orderToken;
+    }
+    if (locale) {
+      requestHeaders["x-spree-locale"] = locale;
+    }
+    if (currency) {
+      requestHeaders["x-spree-currency"] = currency;
+    }
+    const response = await this.fetchFn(url.toString(), {
+      method,
+      headers: requestHeaders,
+      body: body ? JSON.stringify(body) : void 0
+    });
+    if (!response.ok) {
+      const errorBody = await response.json();
+      throw new SpreeError(errorBody, response.status);
+    }
+    if (response.status === 204) {
+      return void 0;
+    }
+    return response.json();
+  }
+  // ============================================
+  // Authentication
+  // ============================================
+  auth = {
+    /**
+     * Login with email and password
+     */
+    login: (credentials) => this.request("POST", "/auth/login", { body: credentials }),
+    /**
+     * Register a new customer account
+     */
+    register: (params) => this.request("POST", "/auth/register", { body: params }),
+    /**
+     * Refresh access token (requires valid Bearer token)
+     */
+    refresh: (options) => this.request("POST", "/auth/refresh", options)
+  };
+  // ============================================
+  // Store
+  // ============================================
+  store = {
+    /**
+     * Get current store information
+     */
+    get: (options) => this.request("GET", "/store", options)
+  };
+  // ============================================
+  // Products
+  // ============================================
+  products = {
+    /**
+     * List products
+     */
+    list: (params, options) => this.request("GET", "/products", {
+      ...options,
+      params
+    }),
+    /**
+     * Get a product by ID or slug
+     */
+    get: (idOrSlug, params, options) => this.request("GET", `/products/${idOrSlug}`, {
+      ...options,
+      params
+    }),
+    /**
+     * Get available filters for products
+     * Returns filter options (price range, availability, option types, taxons) with counts
+     */
+    filters: (params, options) => this.request("GET", "/products/filters", {
+      ...options,
+      params
+    })
+  };
+  // ============================================
+  // Taxonomies & Taxons
+  // ============================================
+  taxonomies = {
+    /**
+     * List taxonomies
+     */
+    list: (params, options) => this.request("GET", "/taxonomies", {
+      ...options,
+      params
+    }),
+    /**
+     * Get a taxonomy by ID
+     */
+    get: (id, params, options) => this.request("GET", `/taxonomies/${id}`, {
+      ...options,
+      params
+    })
+  };
+  taxons = {
+    /**
+     * List taxons
+     */
+    list: (params, options) => this.request("GET", "/taxons", {
+      ...options,
+      params
+    }),
+    /**
+     * Get a taxon by ID or permalink
+     */
+    get: (idOrPermalink, params, options) => this.request("GET", `/taxons/${idOrPermalink}`, {
+      ...options,
+      params
+    }),
+    /**
+     * Nested resource: Products in a taxon
+     */
+    products: {
+      /**
+       * List products in a taxon
+       * @param taxonId - Taxon ID (prefix_id) or permalink
+       */
+      list: (taxonId, params, options) => this.request(
+        "GET",
+        `/taxons/${taxonId}/products`,
+        {
+          ...options,
+          params
+        }
+      )
+    }
+  };
+  // ============================================
+  // Geography
+  // ============================================
+  countries = {
+    /**
+     * List countries available for checkout
+     * Returns countries from the store's checkout zone without states
+     */
+    list: (options) => this.request("GET", "/countries", options),
+    /**
+     * Get a country by ISO code with states
+     * @param iso - ISO 3166-1 alpha-2 code (e.g., "US", "DE")
+     */
+    get: (iso, options) => this.request("GET", `/countries/${iso}`, options)
+  };
+  // ============================================
+  // Cart (convenience wrapper for current incomplete order)
+  // ============================================
+  cart = {
+    /**
+     * Get current cart (returns null if none exists)
+     * Pass orderToken for guest checkout, or use JWT for authenticated users
+     */
+    get: (options) => this.request("GET", "/cart", options),
+    /**
+     * Create a new cart (alias for orders.create)
+     */
+    create: (options) => this.request("POST", "/orders", options),
+    /**
+     * Associate a guest cart with the currently authenticated user
+     * Requires both JWT token (for authentication) and orderToken (to identify the cart)
+     * @param options - Must include both `token` (JWT) and `orderToken` (guest cart token)
+     */
+    associate: (options) => this.request("PATCH", "/cart/associate", options)
+  };
+  // ============================================
+  // Orders (all orders - complete and incomplete)
+  // ============================================
+  orders = {
+    /**
+     * List orders for the authenticated customer
+     */
+    list: (params, options) => this.request("GET", "/orders", {
+      ...options,
+      params
+    }),
+    /**
+     * Create a new order (cart)
+     */
+    create: (options) => this.request("POST", "/orders", options),
+    /**
+     * Get an order by ID or number
+     */
+    get: (idOrNumber, params, options) => this.request("GET", `/orders/${idOrNumber}`, {
+      ...options,
+      params
+    }),
+    /**
+     * Update an order
+     */
+    update: (idOrNumber, params, options) => this.request("PATCH", `/orders/${idOrNumber}`, {
+      ...options,
+      body: params
+    }),
+    /**
+     * Advance order to next checkout step
+     */
+    next: (idOrNumber, options) => this.request("PATCH", `/orders/${idOrNumber}/next`, options),
+    /**
+     * Advance through all checkout steps
+     */
+    advance: (idOrNumber, options) => this.request("PATCH", `/orders/${idOrNumber}/advance`, options),
+    /**
+     * Complete the order
+     */
+    complete: (idOrNumber, options) => this.request("PATCH", `/orders/${idOrNumber}/complete`, options),
+    /**
+     * Add store credit to order
+     */
+    addStoreCredit: (idOrNumber, amount, options) => this.request("POST", `/orders/${idOrNumber}/store_credits`, {
+      ...options,
+      body: amount ? { amount } : void 0
+    }),
+    /**
+     * Remove store credit from order
+     */
+    removeStoreCredit: (idOrNumber, options) => this.request("DELETE", `/orders/${idOrNumber}/store_credits`, options),
+    /**
+     * Nested resource: Line items
+     */
+    lineItems: {
+      /**
+       * Add a line item to an order
+       */
+      create: (orderId, params, options) => this.request("POST", `/orders/${orderId}/line_items`, {
+        ...options,
+        body: params
+      }),
+      /**
+       * Update a line item
+       */
+      update: (orderId, lineItemId, params, options) => this.request(
+        "PATCH",
+        `/orders/${orderId}/line_items/${lineItemId}`,
+        { ...options, body: params }
+      ),
+      /**
+       * Remove a line item from an order
+       */
+      delete: (orderId, lineItemId, options) => this.request(
+        "DELETE",
+        `/orders/${orderId}/line_items/${lineItemId}`,
+        options
+      )
+    },
+    /**
+     * Nested resource: Payments
+     */
+    payments: {
+      /**
+       * List payments for an order
+       */
+      list: (orderId, options) => this.request(
+        "GET",
+        `/orders/${orderId}/payments`,
+        options
+      ),
+      /**
+       * Get a payment by ID
+       */
+      get: (orderId, paymentId, options) => this.request(
+        "GET",
+        `/orders/${orderId}/payments/${paymentId}`,
+        options
+      )
+    },
+    /**
+     * Nested resource: Payment methods
+     */
+    paymentMethods: {
+      /**
+       * List available payment methods for an order
+       */
+      list: (orderId, options) => this.request(
+        "GET",
+        `/orders/${orderId}/payment_methods`,
+        options
+      )
+    },
+    /**
+     * Nested resource: Coupon codes
+     */
+    couponCodes: {
+      /**
+       * Apply a coupon code to an order
+       */
+      apply: (orderId, code, options) => this.request("POST", `/orders/${orderId}/coupon_codes`, {
+        ...options,
+        body: { code }
+      }),
+      /**
+       * Remove a coupon code from an order
+       * @param promotionId - The promotion prefix_id (e.g., 'promo_xxx')
+       */
+      remove: (orderId, promotionId, options) => this.request(
+        "DELETE",
+        `/orders/${orderId}/coupon_codes/${promotionId}`,
+        options
+      )
+    },
+    /**
+     * Nested resource: Shipments
+     */
+    shipments: {
+      /**
+       * List shipments for an order
+       */
+      list: (orderId, options) => this.request(
+        "GET",
+        `/orders/${orderId}/shipments`,
+        options
+      ),
+      /**
+       * Update a shipment (e.g., select shipping rate)
+       */
+      update: (orderId, shipmentId, params, options) => this.request(
+        "PATCH",
+        `/orders/${orderId}/shipments/${shipmentId}`,
+        { ...options, body: params }
+      )
+    }
+  };
+  // ============================================
+  // Customer
+  // ============================================
+  customer = {
+    /**
+     * Get current customer profile
+     */
+    get: (options) => this.request("GET", "/customer", options),
+    /**
+     * Update current customer profile
+     */
+    update: (params, options) => this.request("PATCH", "/customer", {
+      ...options,
+      body: params
+    }),
+    /**
+     * Nested resource: Addresses
+     */
+    addresses: {
+      /**
+       * List customer addresses
+       */
+      list: (params, options) => this.request(
+        "GET",
+        "/customer/addresses",
+        { ...options, params }
+      ),
+      /**
+       * Get an address by ID
+       */
+      get: (id, options) => this.request("GET", `/customer/addresses/${id}`, options),
+      /**
+       * Create an address
+       */
+      create: (params, options) => this.request("POST", "/customer/addresses", {
+        ...options,
+        body: params
+      }),
+      /**
+       * Update an address
+       */
+      update: (id, params, options) => this.request("PATCH", `/customer/addresses/${id}`, {
+        ...options,
+        body: params
+      }),
+      /**
+       * Delete an address
+       */
+      delete: (id, options) => this.request("DELETE", `/customer/addresses/${id}`, options)
+    },
+    /**
+     * Nested resource: Credit Cards
+     */
+    creditCards: {
+      /**
+       * List customer credit cards
+       */
+      list: (params, options) => this.request(
+        "GET",
+        "/customer/credit_cards",
+        { ...options, params }
+      ),
+      /**
+       * Get a credit card by ID
+       */
+      get: (id, options) => this.request("GET", `/customer/credit_cards/${id}`, options),
+      /**
+       * Delete a credit card
+       */
+      delete: (id, options) => this.request("DELETE", `/customer/credit_cards/${id}`, options)
+    },
+    /**
+     * Nested resource: Gift Cards
+     */
+    giftCards: {
+      /**
+       * List customer gift cards
+       * Returns gift cards associated with the current user, ordered by newest first
+       */
+      list: (params, options) => this.request(
+        "GET",
+        "/customer/gift_cards",
+        { ...options, params }
+      ),
+      /**
+       * Get a gift card by ID
+       */
+      get: (id, options) => this.request("GET", `/customer/gift_cards/${id}`, options)
+    }
+  };
+  // ============================================
+  // Wishlists
+  // ============================================
+  wishlists = {
+    /**
+     * List wishlists
+     */
+    list: (params, options) => this.request("GET", "/wishlists", {
+      ...options,
+      params
+    }),
+    /**
+     * Get a wishlist by ID
+     */
+    get: (id, params, options) => this.request("GET", `/wishlists/${id}`, {
+      ...options,
+      params
+    }),
+    /**
+     * Create a wishlist
+     */
+    create: (params, options) => this.request("POST", "/wishlists", {
+      ...options,
+      body: params
+    }),
+    /**
+     * Update a wishlist
+     */
+    update: (id, params, options) => this.request("PATCH", `/wishlists/${id}`, {
+      ...options,
+      body: params
+    }),
+    /**
+     * Delete a wishlist
+     */
+    delete: (id, options) => this.request("DELETE", `/wishlists/${id}`, options),
+    /**
+     * Nested resource: Wishlist items
+     */
+    items: {
+      /**
+       * Add an item to a wishlist
+       */
+      create: (wishlistId, params, options) => this.request("POST", `/wishlists/${wishlistId}/items`, {
+        ...options,
+        body: params
+      }),
+      /**
+       * Update a wishlist item
+       */
+      update: (wishlistId, itemId, params, options) => this.request(
+        "PATCH",
+        `/wishlists/${wishlistId}/items/${itemId}`,
+        { ...options, body: params }
+      ),
+      /**
+       * Remove an item from a wishlist
+       */
+      delete: (wishlistId, itemId, options) => this.request(
+        "DELETE",
+        `/wishlists/${wishlistId}/items/${itemId}`,
+        options
+      )
+    }
+  };
+};
+function createSpreeClient(config) {
+  return new SpreeClient(config);
+}
+
+exports.SpreeClient = SpreeClient;
+exports.SpreeError = SpreeError;
+exports.createSpreeClient = createSpreeClient;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["import type {\n  AuthTokens,\n  LoginCredentials,\n  RegisterParams,\n  ErrorResponse,\n  PaginatedResponse,\n  ListParams,\n  ProductListParams,\n  ProductFiltersParams,\n  ProductFiltersResponse,\n  TaxonListParams,\n  OrderListParams,\n  AddLineItemParams,\n  UpdateLineItemParams,\n  UpdateOrderParams,\n  AddressParams,\n  StoreCreditCard,\n  StoreGiftCard,\n  StoreProduct,\n  StoreOrder,\n  StoreLineItem,\n  StoreCountry,\n  StoreTaxonomy,\n  StoreTaxon,\n  StorePayment,\n  StorePaymentMethod,\n  StoreShipment,\n  StoreStore,\n  StoreWishlist,\n  StoreWishedItem,\n  StoreAddress,\n  StoreUser,\n} from './types';\n\n// Re-export types for convenience\nexport type { AddressParams, StoreCreditCard };\n\nexport interface SpreeClientConfig {\n  /** Base URL of the Spree API (e.g., 'https://api.mystore.com') */\n  baseUrl: string;\n  /** Publishable API key for store access */\n  apiKey: string;\n  /** Custom fetch implementation (optional, defaults to global fetch) */\n  fetch?: typeof fetch;\n}\n\nexport interface RequestOptions {\n  /** Bearer token for authenticated requests */\n  token?: string;\n  /** Order token for guest checkout */\n  orderToken?: string;\n  /** Locale for translated content (e.g., 'en', 'fr') */\n  locale?: string;\n  /** Currency for prices (e.g., 'USD', 'EUR') */\n  currency?: string;\n  /** Custom headers */\n  headers?: Record<string, string>;\n}\n\nexport class SpreeError extends Error {\n  public readonly code: string;\n  public readonly status: number;\n  public readonly details?: Record<string, string[]>;\n\n  constructor(response: ErrorResponse, status: number) {\n    super(response.error.message);\n    this.name = 'SpreeError';\n    this.code = response.error.code;\n    this.status = status;\n    this.details = response.error.details;\n  }\n}\n\nexport class SpreeClient {\n  private readonly baseUrl: string;\n  private readonly apiKey: string;\n  private readonly fetchFn: typeof fetch;\n\n  constructor(config: SpreeClientConfig) {\n    this.baseUrl = config.baseUrl.replace(/\\/$/, '');\n    this.apiKey = config.apiKey;\n    // Bind fetch to globalThis to avoid \"Illegal invocation\" errors in browsers\n    this.fetchFn = config.fetch || fetch.bind(globalThis);\n  }\n\n  private async request<T>(\n    method: string,\n    path: string,\n    options: RequestOptions & {\n      body?: unknown;\n      params?: Record<string, string | number | undefined>;\n    } = {}\n  ): Promise<T> {\n    const { token, orderToken, locale, currency, headers = {}, body, params } = options;\n\n    // Build URL with query params\n    const url = new URL(`${this.baseUrl}/api/v3/store${path}`);\n    if (params) {\n      Object.entries(params).forEach(([key, value]) => {\n        if (value !== undefined) {\n          // Handle arrays by appending each value with the same key (Rails-style)\n          if (Array.isArray(value)) {\n            value.forEach((v) => url.searchParams.append(key, String(v)));\n          } else {\n            url.searchParams.set(key, String(value));\n          }\n        }\n      });\n    }\n    if (orderToken) {\n      url.searchParams.set('order_token', orderToken);\n    }\n\n    // Build headers\n    const requestHeaders: Record<string, string> = {\n      'Content-Type': 'application/json',\n      'x-spree-api-key': this.apiKey,\n      ...headers,\n    };\n\n    if (token) {\n      requestHeaders['Authorization'] = `Bearer ${token}`;\n    }\n\n    if (orderToken) {\n      requestHeaders['x-spree-order-token'] = orderToken;\n    }\n\n    if (locale) {\n      requestHeaders['x-spree-locale'] = locale;\n    }\n\n    if (currency) {\n      requestHeaders['x-spree-currency'] = currency;\n    }\n\n    const response = await this.fetchFn(url.toString(), {\n      method,\n      headers: requestHeaders,\n      body: body ? JSON.stringify(body) : undefined,\n    });\n\n    if (!response.ok) {\n      const errorBody = await response.json() as ErrorResponse;\n      throw new SpreeError(errorBody, response.status);\n    }\n\n    // Handle 204 No Content\n    if (response.status === 204) {\n      return undefined as T;\n    }\n\n    return response.json() as Promise<T>;\n  }\n\n  // ============================================\n  // Authentication\n  // ============================================\n\n  readonly auth = {\n    /**\n     * Login with email and password\n     */\n    login: (credentials: LoginCredentials): Promise<AuthTokens> =>\n      this.request<AuthTokens>('POST', '/auth/login', { body: credentials }),\n\n    /**\n     * Register a new customer account\n     */\n    register: (params: RegisterParams): Promise<AuthTokens> =>\n      this.request<AuthTokens>('POST', '/auth/register', { body: params }),\n\n    /**\n     * Refresh access token (requires valid Bearer token)\n     */\n    refresh: (options: RequestOptions): Promise<AuthTokens> =>\n      this.request<AuthTokens>('POST', '/auth/refresh', options),\n  };\n\n  // ============================================\n  // Store\n  // ============================================\n\n  readonly store = {\n    /**\n     * Get current store information\n     */\n    get: (options?: RequestOptions): Promise<StoreStore> =>\n      this.request<StoreStore>('GET', '/store', options),\n  };\n\n  // ============================================\n  // Products\n  // ============================================\n\n  readonly products = {\n    /**\n     * List products\n     */\n    list: (\n      params?: ProductListParams,\n      options?: RequestOptions\n    ): Promise<PaginatedResponse<StoreProduct>> =>\n      this.request<PaginatedResponse<StoreProduct>>('GET', '/products', {\n        ...options,\n        params: params as Record<string, string | number | undefined>,\n      }),\n\n    /**\n     * Get a product by ID or slug\n     */\n    get: (\n      idOrSlug: string,\n      params?: { includes?: string },\n      options?: RequestOptions\n    ): Promise<StoreProduct> =>\n      this.request<StoreProduct>('GET', `/products/${idOrSlug}`, {\n        ...options,\n        params,\n      }),\n\n    /**\n     * Get available filters for products\n     * Returns filter options (price range, availability, option types, taxons) with counts\n     */\n    filters: (\n      params?: ProductFiltersParams,\n      options?: RequestOptions\n    ): Promise<ProductFiltersResponse> =>\n      this.request<ProductFiltersResponse>('GET', '/products/filters', {\n        ...options,\n        params: params as Record<string, string | number | undefined>,\n      }),\n  };\n\n  // ============================================\n  // Taxonomies & Taxons\n  // ============================================\n\n  readonly taxonomies = {\n    /**\n     * List taxonomies\n     */\n    list: (\n      params?: ListParams,\n      options?: RequestOptions\n    ): Promise<PaginatedResponse<StoreTaxonomy>> =>\n      this.request<PaginatedResponse<StoreTaxonomy>>('GET', '/taxonomies', {\n        ...options,\n        params: params as Record<string, string | number | undefined>,\n      }),\n\n    /**\n     * Get a taxonomy by ID\n     */\n    get: (\n      id: string,\n      params?: { includes?: string },\n      options?: RequestOptions\n    ): Promise<StoreTaxonomy> =>\n      this.request<StoreTaxonomy>('GET', `/taxonomies/${id}`, {\n        ...options,\n        params,\n      }),\n  };\n\n  readonly taxons = {\n    /**\n     * List taxons\n     */\n    list: (\n      params?: TaxonListParams,\n      options?: RequestOptions\n    ): Promise<PaginatedResponse<StoreTaxon>> =>\n      this.request<PaginatedResponse<StoreTaxon>>('GET', '/taxons', {\n        ...options,\n        params: params as Record<string, string | number | undefined>,\n      }),\n\n    /**\n     * Get a taxon by ID or permalink\n     */\n    get: (\n      idOrPermalink: string,\n      params?: { includes?: string },\n      options?: RequestOptions\n    ): Promise<StoreTaxon> =>\n      this.request<StoreTaxon>('GET', `/taxons/${idOrPermalink}`, {\n        ...options,\n        params,\n      }),\n\n    /**\n     * Nested resource: Products in a taxon\n     */\n    products: {\n      /**\n       * List products in a taxon\n       * @param taxonId - Taxon ID (prefix_id) or permalink\n       */\n      list: (\n        taxonId: string,\n        params?: ProductListParams,\n        options?: RequestOptions\n      ): Promise<PaginatedResponse<StoreProduct>> =>\n        this.request<PaginatedResponse<StoreProduct>>(\n          'GET',\n          `/taxons/${taxonId}/products`,\n          {\n            ...options,\n            params: params as Record<string, string | number | undefined>,\n          }\n        ),\n    },\n  };\n\n  // ============================================\n  // Geography\n  // ============================================\n\n  readonly countries = {\n    /**\n     * List countries available for checkout\n     * Returns countries from the store's checkout zone without states\n     */\n    list: (options?: RequestOptions): Promise<{ data: StoreCountry[] }> =>\n      this.request<{ data: StoreCountry[] }>('GET', '/countries', options),\n\n    /**\n     * Get a country by ISO code with states\n     * @param iso - ISO 3166-1 alpha-2 code (e.g., \"US\", \"DE\")\n     */\n    get: (iso: string, options?: RequestOptions): Promise<StoreCountry> =>\n      this.request<StoreCountry>('GET', `/countries/${iso}`, options),\n  };\n\n  // ============================================\n  // Cart (convenience wrapper for current incomplete order)\n  // ============================================\n\n  readonly cart = {\n    /**\n     * Get current cart (returns null if none exists)\n     * Pass orderToken for guest checkout, or use JWT for authenticated users\n     */\n    get: (options?: RequestOptions): Promise<StoreOrder & { token: string }> =>\n      this.request<StoreOrder & { token: string }>('GET', '/cart', options),\n\n    /**\n     * Create a new cart (alias for orders.create)\n     */\n    create: (options?: RequestOptions): Promise<StoreOrder & { token: string }> =>\n      this.request<StoreOrder & { token: string }>('POST', '/orders', options),\n\n    /**\n     * Associate a guest cart with the currently authenticated user\n     * Requires both JWT token (for authentication) and orderToken (to identify the cart)\n     * @param options - Must include both `token` (JWT) and `orderToken` (guest cart token)\n     */\n    associate: (options: RequestOptions): Promise<StoreOrder & { token: string }> =>\n      this.request<StoreOrder & { token: string }>('PATCH', '/cart/associate', options),\n  };\n\n  // ============================================\n  // Orders (all orders - complete and incomplete)\n  // ============================================\n\n  readonly orders = {\n    /**\n     * List orders for the authenticated customer\n     */\n    list: (\n      params?: OrderListParams,\n      options?: RequestOptions\n    ): Promise<PaginatedResponse<StoreOrder>> =>\n      this.request<PaginatedResponse<StoreOrder>>('GET', '/orders', {\n        ...options,\n        params: params as Record<string, string | number | undefined>,\n      }),\n\n    /**\n     * Create a new order (cart)\n     */\n    create: (options?: RequestOptions): Promise<StoreOrder & { order_token: string }> =>\n      this.request<StoreOrder & { order_token: string }>('POST', '/orders', options),\n\n    /**\n     * Get an order by ID or number\n     */\n    get: (\n      idOrNumber: string,\n      params?: { includes?: string },\n      options?: RequestOptions\n    ): Promise<StoreOrder> =>\n      this.request<StoreOrder>('GET', `/orders/${idOrNumber}`, {\n        ...options,\n        params,\n      }),\n\n    /**\n     * Update an order\n     */\n    update: (\n      idOrNumber: string,\n      params: UpdateOrderParams,\n      options?: RequestOptions\n    ): Promise<StoreOrder> =>\n      this.request<StoreOrder>('PATCH', `/orders/${idOrNumber}`, {\n        ...options,\n        body: params,\n      }),\n\n    /**\n     * Advance order to next checkout step\n     */\n    next: (idOrNumber: string, options?: RequestOptions): Promise<StoreOrder> =>\n      this.request<StoreOrder>('PATCH', `/orders/${idOrNumber}/next`, options),\n\n    /**\n     * Advance through all checkout steps\n     */\n    advance: (idOrNumber: string, options?: RequestOptions): Promise<StoreOrder> =>\n      this.request<StoreOrder>('PATCH', `/orders/${idOrNumber}/advance`, options),\n\n    /**\n     * Complete the order\n     */\n    complete: (idOrNumber: string, options?: RequestOptions): Promise<StoreOrder> =>\n      this.request<StoreOrder>('PATCH', `/orders/${idOrNumber}/complete`, options),\n\n    /**\n     * Add store credit to order\n     */\n    addStoreCredit: (\n      idOrNumber: string,\n      amount?: number,\n      options?: RequestOptions\n    ): Promise<StoreOrder> =>\n      this.request<StoreOrder>('POST', `/orders/${idOrNumber}/store_credits`, {\n        ...options,\n        body: amount ? { amount } : undefined,\n      }),\n\n    /**\n     * Remove store credit from order\n     */\n    removeStoreCredit: (\n      idOrNumber: string,\n      options?: RequestOptions\n    ): Promise<StoreOrder> =>\n      this.request<StoreOrder>('DELETE', `/orders/${idOrNumber}/store_credits`, options),\n\n    /**\n     * Nested resource: Line items\n     */\n    lineItems: {\n      /**\n       * Add a line item to an order\n       */\n      create: (\n        orderId: string,\n        params: AddLineItemParams,\n        options?: RequestOptions\n      ): Promise<StoreLineItem> =>\n        this.request<StoreLineItem>('POST', `/orders/${orderId}/line_items`, {\n          ...options,\n          body: params,\n        }),\n\n      /**\n       * Update a line item\n       */\n      update: (\n        orderId: string,\n        lineItemId: string,\n        params: UpdateLineItemParams,\n        options?: RequestOptions\n      ): Promise<StoreLineItem> =>\n        this.request<StoreLineItem>(\n          'PATCH',\n          `/orders/${orderId}/line_items/${lineItemId}`,\n          { ...options, body: params }\n        ),\n\n      /**\n       * Remove a line item from an order\n       */\n      delete: (\n        orderId: string,\n        lineItemId: string,\n        options?: RequestOptions\n      ): Promise<void> =>\n        this.request<void>(\n          'DELETE',\n          `/orders/${orderId}/line_items/${lineItemId}`,\n          options\n        ),\n    },\n\n    /**\n     * Nested resource: Payments\n     */\n    payments: {\n      /**\n       * List payments for an order\n       */\n      list: (\n        orderId: string,\n        options?: RequestOptions\n      ): Promise<{ data: StorePayment[]; meta: object }> =>\n        this.request<{ data: StorePayment[]; meta: object }>(\n          'GET',\n          `/orders/${orderId}/payments`,\n          options\n        ),\n\n      /**\n       * Get a payment by ID\n       */\n      get: (\n        orderId: string,\n        paymentId: string,\n        options?: RequestOptions\n      ): Promise<StorePayment> =>\n        this.request<StorePayment>(\n          'GET',\n          `/orders/${orderId}/payments/${paymentId}`,\n          options\n        ),\n    },\n\n    /**\n     * Nested resource: Payment methods\n     */\n    paymentMethods: {\n      /**\n       * List available payment methods for an order\n       */\n      list: (\n        orderId: string,\n        options?: RequestOptions\n      ): Promise<PaginatedResponse<StorePaymentMethod>> =>\n        this.request<PaginatedResponse<StorePaymentMethod>>(\n          'GET',\n          `/orders/${orderId}/payment_methods`,\n          options\n        ),\n    },\n\n    /**\n     * Nested resource: Coupon codes\n     */\n    couponCodes: {\n      /**\n       * Apply a coupon code to an order\n       */\n      apply: (\n        orderId: string,\n        code: string,\n        options?: RequestOptions\n      ): Promise<StoreOrder> =>\n        this.request<StoreOrder>('POST', `/orders/${orderId}/coupon_codes`, {\n          ...options,\n          body: { code },\n        }),\n\n      /**\n       * Remove a coupon code from an order\n       * @param promotionId - The promotion prefix_id (e.g., 'promo_xxx')\n       */\n      remove: (\n        orderId: string,\n        promotionId: string,\n        options?: RequestOptions\n      ): Promise<StoreOrder> =>\n        this.request<StoreOrder>(\n          'DELETE',\n          `/orders/${orderId}/coupon_codes/${promotionId}`,\n          options\n        ),\n    },\n\n    /**\n     * Nested resource: Shipments\n     */\n    shipments: {\n      /**\n       * List shipments for an order\n       */\n      list: (\n        orderId: string,\n        options?: RequestOptions\n      ): Promise<{ data: StoreShipment[] }> =>\n        this.request<{ data: StoreShipment[] }>(\n          'GET',\n          `/orders/${orderId}/shipments`,\n          options\n        ),\n\n      /**\n       * Update a shipment (e.g., select shipping rate)\n       */\n      update: (\n        orderId: string,\n        shipmentId: string,\n        params: { selected_shipping_rate_id: string },\n        options?: RequestOptions\n      ): Promise<StoreShipment> =>\n        this.request<StoreShipment>(\n          'PATCH',\n          `/orders/${orderId}/shipments/${shipmentId}`,\n          { ...options, body: params }\n        ),\n    },\n  };\n\n  // ============================================\n  // Customer\n  // ============================================\n\n  readonly customer = {\n    /**\n     * Get current customer profile\n     */\n    get: (options?: RequestOptions): Promise<StoreUser> =>\n      this.request<StoreUser>('GET', '/customer', options),\n\n    /**\n     * Update current customer profile\n     */\n    update: (\n      params: { first_name?: string; last_name?: string; email?: string },\n      options?: RequestOptions\n    ): Promise<StoreUser> =>\n      this.request<StoreUser>('PATCH', '/customer', {\n        ...options,\n        body: params,\n      }),\n\n    /**\n     * Nested resource: Addresses\n     */\n    addresses: {\n      /**\n       * List customer addresses\n       */\n      list: (\n        params?: ListParams,\n        options?: RequestOptions\n      ): Promise<PaginatedResponse<StoreAddress>> =>\n        this.request<PaginatedResponse<StoreAddress>>(\n          'GET',\n          '/customer/addresses',\n          { ...options, params: params as Record<string, string | number | undefined> }\n        ),\n\n      /**\n       * Get an address by ID\n       */\n      get: (id: string, options?: RequestOptions): Promise<StoreAddress> =>\n        this.request<StoreAddress>('GET', `/customer/addresses/${id}`, options),\n\n      /**\n       * Create an address\n       */\n      create: (\n        params: AddressParams,\n        options?: RequestOptions\n      ): Promise<StoreAddress> =>\n        this.request<StoreAddress>('POST', '/customer/addresses', {\n          ...options,\n          body: params,\n        }),\n\n      /**\n       * Update an address\n       */\n      update: (\n        id: string,\n        params: Partial<AddressParams>,\n        options?: RequestOptions\n      ): Promise<StoreAddress> =>\n        this.request<StoreAddress>('PATCH', `/customer/addresses/${id}`, {\n          ...options,\n          body: params,\n        }),\n\n      /**\n       * Delete an address\n       */\n      delete: (id: string, options?: RequestOptions): Promise<void> =>\n        this.request<void>('DELETE', `/customer/addresses/${id}`, options),\n    },\n\n    /**\n     * Nested resource: Credit Cards\n     */\n    creditCards: {\n      /**\n       * List customer credit cards\n       */\n      list: (\n        params?: ListParams,\n        options?: RequestOptions\n      ): Promise<PaginatedResponse<StoreCreditCard>> =>\n        this.request<PaginatedResponse<StoreCreditCard>>(\n          'GET',\n          '/customer/credit_cards',\n          { ...options, params: params as Record<string, string | number | undefined> }\n        ),\n\n      /**\n       * Get a credit card by ID\n       */\n      get: (id: string, options?: RequestOptions): Promise<StoreCreditCard> =>\n        this.request<StoreCreditCard>('GET', `/customer/credit_cards/${id}`, options),\n\n      /**\n       * Delete a credit card\n       */\n      delete: (id: string, options?: RequestOptions): Promise<void> =>\n        this.request<void>('DELETE', `/customer/credit_cards/${id}`, options),\n    },\n\n    /**\n     * Nested resource: Gift Cards\n     */\n    giftCards: {\n      /**\n       * List customer gift cards\n       * Returns gift cards associated with the current user, ordered by newest first\n       */\n      list: (\n        params?: ListParams,\n        options?: RequestOptions\n      ): Promise<PaginatedResponse<StoreGiftCard>> =>\n        this.request<PaginatedResponse<StoreGiftCard>>(\n          'GET',\n          '/customer/gift_cards',\n          { ...options, params: params as Record<string, string | number | undefined> }\n        ),\n\n      /**\n       * Get a gift card by ID\n       */\n      get: (id: string, options?: RequestOptions): Promise<StoreGiftCard> =>\n        this.request<StoreGiftCard>('GET', `/customer/gift_cards/${id}`, options),\n    },\n  };\n\n  // ============================================\n  // Wishlists\n  // ============================================\n\n  readonly wishlists = {\n    /**\n     * List wishlists\n     */\n    list: (\n      params?: ListParams,\n      options?: RequestOptions\n    ): Promise<PaginatedResponse<StoreWishlist>> =>\n      this.request<PaginatedResponse<StoreWishlist>>('GET', '/wishlists', {\n        ...options,\n        params: params as Record<string, string | number | undefined>,\n      }),\n\n    /**\n     * Get a wishlist by ID\n     */\n    get: (\n      id: string,\n      params?: { includes?: string },\n      options?: RequestOptions\n    ): Promise<StoreWishlist> =>\n      this.request<StoreWishlist>('GET', `/wishlists/${id}`, {\n        ...options,\n        params,\n      }),\n\n    /**\n     * Create a wishlist\n     */\n    create: (\n      params: { name: string; is_private?: boolean; is_default?: boolean },\n      options?: RequestOptions\n    ): Promise<StoreWishlist> =>\n      this.request<StoreWishlist>('POST', '/wishlists', {\n        ...options,\n        body: params,\n      }),\n\n    /**\n     * Update a wishlist\n     */\n    update: (\n      id: string,\n      params: { name?: string; is_private?: boolean; is_default?: boolean },\n      options?: RequestOptions\n    ): Promise<StoreWishlist> =>\n      this.request<StoreWishlist>('PATCH', `/wishlists/${id}`, {\n        ...options,\n        body: params,\n      }),\n\n    /**\n     * Delete a wishlist\n     */\n    delete: (id: string, options?: RequestOptions): Promise<void> =>\n      this.request<void>('DELETE', `/wishlists/${id}`, options),\n\n    /**\n     * Nested resource: Wishlist items\n     */\n    items: {\n      /**\n       * Add an item to a wishlist\n       */\n      create: (\n        wishlistId: string,\n        params: { variant_id: string; quantity?: number },\n        options?: RequestOptions\n      ): Promise<StoreWishedItem> =>\n        this.request<StoreWishedItem>('POST', `/wishlists/${wishlistId}/items`, {\n          ...options,\n          body: params,\n        }),\n\n      /**\n       * Update a wishlist item\n       */\n      update: (\n        wishlistId: string,\n        itemId: string,\n        params: { quantity: number },\n        options?: RequestOptions\n      ): Promise<StoreWishedItem> =>\n        this.request<StoreWishedItem>(\n          'PATCH',\n          `/wishlists/${wishlistId}/items/${itemId}`,\n          { ...options, body: params }\n        ),\n\n      /**\n       * Remove an item from a wishlist\n       */\n      delete: (\n        wishlistId: string,\n        itemId: string,\n        options?: RequestOptions\n      ): Promise<void> =>\n        this.request<void>(\n          'DELETE',\n          `/wishlists/${wishlistId}/items/${itemId}`,\n          options\n        ),\n    },\n  };\n}\n\n/**\n * Create a new Spree SDK client\n */\nexport function createSpreeClient(config: SpreeClientConfig): SpreeClient {\n  return new SpreeClient(config);\n}\n"]}