@spree/sdk 0.6.7 → 0.6.9

package/README.md

@@ -364,14 +364,37 @@ const completed = await client.store.orders.paymentSessions.complete(
 console.log(completed.status); // 'completed'
 ```
 
+### Markets
+
+```typescript
+// List all markets
+const { data: markets } = await client.store.markets.list();
+// [{ id: "mkt_xxx", name: "North America", currency: "USD", default_locale: "en", ... }]
+
+// Get a single market
+const market = await client.store.markets.get('mkt_xxx');
+
+// Resolve which market applies for a country
+const market = await client.store.markets.resolve('DE');
+// => { id: "mkt_xxx", name: "Europe", currency: "EUR", default_locale: "de", ... }
+
+// List countries in a market
+const { data: countries } = await client.store.markets.countries.list('mkt_xxx');
+
+// Get a country in a market (with states for address forms)
+const country = await client.store.markets.countries.get('mkt_xxx', 'DE', {
+  expand: ['states'],
+});
+```
+
 ### Geography
 
 ```typescript
 // List countries available for checkout
 const { data: countries } = await client.store.countries.list();
 
-// Get country by ISO code (includes states)
-const usa = await client.store.countries.get('US');
+// Get country by ISO code (with states)
+const usa = await client.store.countries.get('US', { expand: ['states'] });
 console.log(usa.states); // Array of states
 ```
 
@@ -501,6 +524,7 @@ The SDK uses a resource builder pattern for nested resources:
 | `store.customer` | `addresses` | `list`, `get`, `create`, `update`, `delete`, `markAsDefault` |
 | `store.customer` | `creditCards` | `list`, `get`, `delete` |
 | `store.customer` | `giftCards` | `list`, `get` |
+| `store.markets` | `countries` | `list`, `get` |
 | `store.taxons` | `products` | `list` |
 | `store.wishlists` | `items` | `create`, `update`, `delete` |
 
@@ -511,6 +535,7 @@ await client.store.orders.lineItems.create(orderId, params, options);
 await client.store.orders.payments.list(orderId, options);
 await client.store.orders.shipments.update(orderId, shipmentId, params, options);
 await client.store.customer.addresses.list({}, options);
+await client.store.markets.countries.list(marketId);
 await client.store.taxons.products.list(taxonId, params, options);
 await client.store.wishlists.items.create(wishlistId, params, options);
 ```
@@ -608,6 +633,7 @@ The SDK exports all Store API types:
 - `StoreState` - State/province
 - `StoreAddress` - Customer address
 - `StoreCustomer` - Customer profile
+- `StoreMarket` - Market configuration (currency, locales, countries)
 - `StoreStore` - Store configuration
 
 ### Commerce Types

package/dist/index.cjs

@@ -21,20 +21,23 @@ function calculateDelay(attempt, config) {
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
-function shouldRetryOnStatus(method, status, config) {
-  const isIdempotent = method === "GET" || method === "HEAD";
+function generateIdempotencyKey() {
+  return `spree-sdk-retry-${crypto.randomUUID()}`;
+}
+function shouldRetryOnStatus(method, status, config, hasIdempotencyKey) {
+  const isIdempotent = method === "GET" || method === "HEAD" || hasIdempotencyKey;
   if (isIdempotent) {
     return config.retryOnStatus.includes(status);
   }
   return status === 429;
 }
-function shouldRetryOnNetworkError(method, config) {
+function shouldRetryOnNetworkError(method, config, hasIdempotencyKey) {
   if (!config.retryOnNetworkError) return false;
-  return method === "GET" || method === "HEAD";
+  return method === "GET" || method === "HEAD" || hasIdempotencyKey;
 }
 function createRequestFn(config, basePath, auth, defaults) {
   return async function request(method, path, options = {}) {
-    const { token, orderToken, headers = {}, body, params } = options;
+    const { token, orderToken, idempotencyKey, headers = {}, body, params } = options;
     const locale = options.locale ?? defaults?.locale;
     const currency = options.currency ?? defaults?.currency;
     const country = options.country ?? defaults?.country;
@@ -50,14 +53,13 @@ function createRequestFn(config, basePath, auth, defaults) {
         }
       });
     }
-    if (orderToken) {
-      url.searchParams.set("order_token", orderToken);
-    }
     const requestHeaders = {
       "Content-Type": "application/json",
-      [auth.headerName]: auth.headerValue,
       ...headers
     };
+    if (auth.headerName && auth.headerValue) {
+      requestHeaders[auth.headerName] = auth.headerValue;
+    }
     if (token) {
       requestHeaders["Authorization"] = `Bearer ${token}`;
     }
@@ -73,6 +75,12 @@ function createRequestFn(config, basePath, auth, defaults) {
     if (country) {
       requestHeaders["x-spree-country"] = country;
     }
+    const isMutating = method !== "GET" && method !== "HEAD";
+    const effectiveIdempotencyKey = idempotencyKey ?? (isMutating && config.retryConfig ? generateIdempotencyKey() : void 0);
+    if (effectiveIdempotencyKey) {
+      requestHeaders["Idempotency-Key"] = effectiveIdempotencyKey;
+    }
+    const hasIdempotencyKey = !!effectiveIdempotencyKey;
     const maxAttempts = config.retryConfig ? config.retryConfig.maxRetries + 1 : 1;
     for (let attempt = 0; attempt < maxAttempts; attempt++) {
       try {
@@ -83,7 +91,7 @@ function createRequestFn(config, basePath, auth, defaults) {
         });
         if (!response.ok) {
           const isLastAttempt = attempt >= maxAttempts - 1;
-          if (!isLastAttempt && config.retryConfig && shouldRetryOnStatus(method, response.status, config.retryConfig)) {
+          if (!isLastAttempt && config.retryConfig && shouldRetryOnStatus(method, response.status, config.retryConfig, hasIdempotencyKey)) {
             const retryAfter = response.headers.get("Retry-After");
             const delay = retryAfter ? Math.min(parseInt(retryAfter, 10) * 1e3, config.retryConfig.maxDelay) : calculateDelay(attempt, config.retryConfig);
             await sleep(delay);
@@ -101,7 +109,7 @@ function createRequestFn(config, basePath, auth, defaults) {
           throw error;
         }
         const isLastAttempt = attempt >= maxAttempts - 1;
-        if (!isLastAttempt && config.retryConfig && shouldRetryOnNetworkError(method, config.retryConfig)) {
+        if (!isLastAttempt && config.retryConfig && shouldRetryOnNetworkError(method, config.retryConfig, hasIdempotencyKey)) {
           const delay = calculateDelay(attempt, config.retryConfig);
           await sleep(delay);
           continue;
@@ -114,7 +122,7 @@ function createRequestFn(config, basePath, auth, defaults) {
 }
 
 // src/params.ts
-var PASSTHROUGH_KEYS = /* @__PURE__ */ new Set(["page", "limit", "expand", "sort"]);
+var PASSTHROUGH_KEYS = /* @__PURE__ */ new Set(["page", "limit", "expand", "sort", "fields"]);
 function transformListParams(params) {
   const result = {};
   for (const [key, value] of Object.entries(params)) {
@@ -138,9 +146,12 @@ function transformListParams(params) {
 }
 
 // src/store-client.ts
-function expandParams(params) {
-  if (!params?.expand?.length) return void 0;
-  return { expand: params.expand.join(",") };
+function getParams(params) {
+  if (!params) return void 0;
+  const result = {};
+  if (params.expand?.length) result.expand = params.expand.join(",");
+  if (params.fields?.length) result.fields = params.fields.join(",");
+  return Object.keys(result).length > 0 ? result : void 0;
 }
 var StoreClient = class {
   request;
@@ -165,15 +176,6 @@ var StoreClient = class {
     refresh: (options) => this.request("POST", "/auth/refresh", options)
   };
   // ============================================
-  // Store
-  // ============================================
-  store = {
-    /**
-     * Get current store information
-     */
-    get: (options) => this.request("GET", "/store", options)
-  };
-  // ============================================
   // Products
   // ============================================
   products = {
@@ -182,14 +184,14 @@ var StoreClient = class {
      */
     list: (params, options) => this.request("GET", "/products", {
       ...options,
-      params: params ? transformListParams(params) : void 0
+      params: transformListParams({ ...params })
     }),
     /**
      * Get a product by ID or slug
      */
     get: (idOrSlug, params, options) => this.request("GET", `/products/${idOrSlug}`, {
       ...options,
-      params: expandParams(params)
+      params: getParams(params)
     }),
     /**
      * Get available filters for products
@@ -209,14 +211,14 @@ var StoreClient = class {
      */
     list: (params, options) => this.request("GET", "/taxonomies", {
       ...options,
-      params
+      params: transformListParams({ ...params })
     }),
     /**
      * Get a taxonomy by ID
      */
     get: (id, params, options) => this.request("GET", `/taxonomies/${id}`, {
       ...options,
-      params: expandParams(params)
+      params: getParams(params)
     })
   };
   taxons = {
@@ -225,14 +227,14 @@ var StoreClient = class {
      */
     list: (params, options) => this.request("GET", "/taxons", {
       ...options,
-      params: params ? transformListParams(params) : void 0
+      params: transformListParams({ ...params })
     }),
     /**
      * Get a taxon by ID or permalink
      */
     get: (idOrPermalink, params, options) => this.request("GET", `/taxons/${idOrPermalink}`, {
       ...options,
-      params: expandParams(params)
+      params: getParams(params)
     }),
     /**
      * Nested resource: Products in a taxon
@@ -247,7 +249,7 @@ var StoreClient = class {
         `/taxons/${taxonId}/products`,
         {
           ...options,
-          params: params ? transformListParams(params) : void 0
+          params: transformListParams({ ...params })
         }
       )
     }
@@ -268,7 +270,7 @@ var StoreClient = class {
      */
     get: (iso, params, options) => this.request("GET", `/countries/${iso}`, {
       ...options,
-      params: expandParams(params)
+      params: getParams(params)
     })
   };
   currencies = {
@@ -325,7 +327,7 @@ var StoreClient = class {
       get: (marketId, iso, params, options) => this.request(
         "GET",
         `/markets/${marketId}/countries/${iso}`,
-        { ...options, params: expandParams(params) }
+        { ...options, params: getParams(params) }
       )
     }
   };
@@ -362,7 +364,7 @@ var StoreClient = class {
      */
     get: (idOrNumber, params, options) => this.request("GET", `/orders/${idOrNumber}`, {
       ...options,
-      params: expandParams(params)
+      params: getParams(params)
     }),
     /**
      * Update an order
@@ -580,7 +582,7 @@ var StoreClient = class {
       list: (params, options) => this.request(
         "GET",
         "/customer/addresses",
-        { ...options, params }
+        { ...options, params: transformListParams({ ...params }) }
       ),
       /**
        * Get an address by ID
@@ -622,7 +624,7 @@ var StoreClient = class {
       list: (params, options) => this.request(
         "GET",
         "/customer/credit_cards",
-        { ...options, params }
+        { ...options, params: transformListParams({ ...params }) }
       ),
       /**
        * Get a credit card by ID
@@ -644,7 +646,7 @@ var StoreClient = class {
       list: (params, options) => this.request(
         "GET",
         "/customer/gift_cards",
-        { ...options, params }
+        { ...options, params: transformListParams({ ...params }) }
       ),
       /**
        * Get a gift card by ID
@@ -660,7 +662,7 @@ var StoreClient = class {
        */
       list: (params, options) => this.request("GET", "/customer/orders", {
         ...options,
-        params: params ? transformListParams(params) : void 0
+        params: transformListParams({ ...params })
       })
     },
     /**
@@ -700,14 +702,14 @@ var StoreClient = class {
      */
     list: (params, options) => this.request("GET", "/wishlists", {
       ...options,
-      params
+      params: transformListParams({ ...params })
     }),
     /**
      * Get a wishlist by ID
      */
     get: (id, params, options) => this.request("GET", `/wishlists/${id}`, {
       ...options,
-      params: expandParams(params)
+      params: getParams(params)
     }),
     /**
      * Create a wishlist
@@ -776,6 +778,9 @@ var SpreeClient = class {
   admin;
   _defaults;
   constructor(config) {
+    if (!config.publishableKey && !config.secretKey) {
+      throw new Error("SpreeClient requires at least one of publishableKey or secretKey");
+    }
     const baseUrl = config.baseUrl.replace(/\/$/, "");
     const fetchFn = config.fetch || fetch.bind(globalThis);
     this._defaults = {
@@ -799,7 +804,7 @@ var SpreeClient = class {
     const storeRequestFn = createRequestFn(
       requestConfig,
       "/api/v3/store",
-      { headerName: "x-spree-api-key", headerValue: config.publishableKey },
+      config.publishableKey ? { headerName: "x-spree-api-key", headerValue: config.publishableKey } : { headerName: "", headerValue: "" },
       this._defaults
     );
     const adminRequestFn = createRequestFn(