@behio/storefront-sdk 0.3.0 → 0.5.0

package/README.md

@@ -83,7 +83,8 @@ function ProductList() {
 | `customer` | Profile, addresses, password change |
 | `wishlist` | Add, remove, check |
 | `reviews` | Submit, list, vote helpful |
-| `addresses` | Google Places autocomplete with debounce hook |
+| `addresses` | Address autocomplete with debounce hook |
+| `shipping` | List shipping methods and fetch live carrier quotes (Zaslat.cz + extensible) |
 | `returns` | Submit return requests |
 | `consent` | Cookie consent (GDPR) |
 | `quotes` | B2B quote requests |

package/dist/{chunk-45FTJKSW.mjs → chunk-3GOQSB25.mjs}

@@ -72,6 +72,40 @@ var BehioNetworkError = class extends Error {
     this.code = isTimeout ? "TIMEOUT" : "NETWORK_ERROR";
   }
 };
+function ok(data) {
+  return { data, error: null };
+}
+function err(error) {
+  return { data: null, error };
+}
+function toSdkError(err2) {
+  if (err2 instanceof BehioApiError) {
+    return {
+      code: err2.code,
+      message: err2.message,
+      status: err2.status,
+      body: err2.body,
+      isRetryable: err2.isRetryable,
+      cause: err2
+    };
+  }
+  if (err2 instanceof BehioNetworkError) {
+    return {
+      code: err2.code,
+      message: err2.message,
+      status: null,
+      isRetryable: err2.isRetryable,
+      cause: err2
+    };
+  }
+  return {
+    code: "UNKNOWN",
+    message: err2 instanceof Error ? err2.message : String(err2),
+    status: null,
+    isRetryable: false,
+    cause: err2
+  };
+}
 
 // src/client.ts
 var BehioStorefront = class {
@@ -108,6 +142,7 @@ var BehioStorefront = class {
     this.consent = new ConsentModule(this);
     this.quotes = new QuotesModule(this);
     this.addresses = new AddressModule(this);
+    this.shipping = new ShippingModule(this);
   }
   // --- Public methods ---
   /** Get basic shop info */
@@ -197,11 +232,17 @@ var BehioStorefront = class {
     this.isRefreshing = true;
     this.refreshPromise = (async () => {
       try {
-        await this.auth.refresh();
+        const res = await this.auth.refresh();
+        if (res.error) {
+          this.clearTokens();
+          this.emit("auth:token-refresh-failed");
+          throw new BehioApiError(401, null, "Token refresh failed");
+        }
         this.emit("auth:token-refresh");
-      } catch {
+      } catch (err2) {
         this.clearTokens();
         this.emit("auth:token-refresh-failed");
+        if (err2 instanceof BehioApiError) throw err2;
         throw new BehioApiError(401, null, "Token refresh failed");
       } finally {
         this.isRefreshing = false;
@@ -210,9 +251,29 @@ var BehioStorefront = class {
     })();
     return this.refreshPromise;
   }
-  // --- Internal fetch ---
-  /** @internal */
+  // --- Public request wrapper (SdkResult) ---
+  /**
+   * Every public module method funnels through here. Internally calls
+   * `rawRequest` (which throws on failure) and maps thrown errors to
+   * `SdkError` so the public surface can return `SdkResult<T>`.
+   *
+   * @internal — don't call from outside the SDK; use the typed module
+   * methods (behio.catalog.*, behio.cart.*, …) instead.
+   */
   async request(method, path, options) {
+    try {
+      const data = await this.rawRequest(method, path, options);
+      return ok(data);
+    } catch (err2) {
+      return { data: null, error: toSdkError(err2) };
+    }
+  }
+  /**
+   * Throws on failure (API error / network / timeout). Kept private so
+   * internal auth refresh recursion keeps its existing control flow —
+   * public callers must go through `request()` which returns Result.
+   */
+  async rawRequest(method, path, options) {
     const params = new URLSearchParams();
     if (options?.query) {
       for (const [key, value] of Object.entries(options.query)) {
@@ -275,11 +336,11 @@ var BehioStorefront = class {
           body: interceptedConfig.body,
           signal: controller.signal
         });
-      } catch (err) {
+      } catch (err2) {
         clearTimeout(timeoutId);
-        const isAbort = err instanceof DOMException && err.name === "AbortError";
+        const isAbort = err2 instanceof DOMException && err2.name === "AbortError";
         const networkErr = new BehioNetworkError(
-          isAbort ? "Request timed out" : err.message || "Network error",
+          isAbort ? "Request timed out" : err2.message || "Network error",
           isAbort
         );
         this.emit("error", networkErr);
@@ -305,7 +366,7 @@ var BehioStorefront = class {
         if (res.status === 401 && this.refreshToken && options?.auth !== false && !options?._isRetryAfterRefresh) {
           try {
             await this.handleTokenRefresh();
-            return this.request(method, path, { ...options, _isRetryAfterRefresh: true });
+            return this.rawRequest(method, path, { ...options, _isRetryAfterRefresh: true });
           } catch {
             this.emit("error", apiError);
             throw apiError;
@@ -371,7 +432,8 @@ var CatalogModule = class {
   /** Get category tree */
   async getCategories(locale) {
     const res = await this.client.request("GET", "/catalog/categories", { query: { locale } });
-    return { categories: res.categories || res.items || [] };
+    if (res.error) return res;
+    return ok({ categories: res.data.categories || res.data.items || [] });
   }
   /** Get category detail by slug */
   async getCategory(slug, locale) {
@@ -392,7 +454,8 @@ var CatalogModule = class {
   /** Get all labels */
   async getLabels(locale) {
     const res = await this.client.request("GET", "/catalog/labels", { query: { locale } });
-    return { labels: res.labels || res.items || [] };
+    if (res.error) return res;
+    return ok({ labels: res.data.labels || res.data.items || [] });
   }
   /** Get featured products */
   async getFeatured(options) {
@@ -418,7 +481,10 @@ var CatalogModule = class {
   }
   /** Cross-sell / related / upsell products for a product */
   async getCrossSell(productSlug) {
-    return this.client.request("GET", `/catalog/products/${productSlug}/cross-sell`);
+    return this.client.request(
+      "GET",
+      `/catalog/products/${productSlug}/cross-sell`
+    );
   }
   /** Active promotions applicable to a product (with countdown end time) */
   async getProductPromotions(productSlug) {
@@ -435,44 +501,57 @@ var AuthModule = class {
   }
   /** Register a new customer */
   async register(input) {
-    const tokens = await this.client.request("POST", "/auth/register", {
+    const res = await this.client.request("POST", "/auth/register", {
       body: input,
       auth: false
     });
-    this.client.setTokens(tokens);
+    if (res.error) return res;
+    this.client.setTokens(res.data);
     this.client.emit("auth:login", { email: input.email });
-    return tokens;
+    return res;
   }
   /** Login with email and password */
   async login(input) {
-    const tokens = await this.client.request("POST", "/auth/login", {
+    const res = await this.client.request("POST", "/auth/login", {
       body: input,
       auth: false
     });
-    this.client.setTokens(tokens);
+    if (res.error) return res;
+    this.client.setTokens(res.data);
     this.client.emit("auth:login", { email: input.email });
-    return tokens;
+    return res;
   }
   /** Refresh access token using refresh token */
   async refresh(refreshToken) {
     const token = refreshToken || this.client.getRefreshToken();
-    if (!token) throw new Error("No refresh token available");
-    const tokens = await this.client.request("POST", "/auth/refresh", {
+    if (!token) {
+      return {
+        data: null,
+        error: {
+          code: "UNAUTHORIZED",
+          message: "No refresh token available",
+          status: null,
+          isRetryable: false
+        }
+      };
+    }
+    const res = await this.client.request("POST", "/auth/refresh", {
       body: { refreshToken: token },
       auth: false
     });
-    this.client.setTokens(tokens);
-    return tokens;
+    if (res.error) return res;
+    this.client.setTokens(res.data);
+    return res;
   }
   /** Logout (invalidate refresh token) */
   async logout(refreshToken) {
     const token = refreshToken || this.client.getRefreshToken();
-    const result = await this.client.request("POST", "/auth/logout", {
+    const res = await this.client.request("POST", "/auth/logout", {
       body: { refreshToken: token }
     });
     this.client.clearTokens();
     this.client.emit("auth:logout");
-    return result;
+    return res;
   }
   /** Request password reset email */
   async forgotPassword(email) {
@@ -510,90 +589,124 @@ var CartModule = class {
   }
   /** Add item to cart */
   async addItem(input) {
-    const result = await this.client.request("POST", "/cart/items", {
+    const res = await this.client.request("POST", "/cart/items", {
       body: { whItemId: input.productId, quantity: input.quantity }
     });
-    if (result.newSessionToken) {
-      this.client.setCartSession(result.newSessionToken);
+    if (res.error) return res;
+    if (res.data.newSessionToken) {
+      this.client.setCartSession(res.data.newSessionToken);
     }
-    this.client.emit("cart:updated", result);
-    return result;
+    this.client.emit("cart:updated", res.data);
+    return res;
   }
   /** Update item quantity */
   async updateQuantity(itemId, quantity) {
-    const result = await this.client.request("PATCH", `/cart/items/${itemId}`, {
+    const res = await this.client.request("PATCH", `/cart/items/${itemId}`, {
       body: { quantity }
     });
-    this.client.emit("cart:updated", result);
-    return result;
+    if (res.error) return res;
+    this.client.emit("cart:updated", res.data);
+    return res;
   }
   /** Remove item from cart */
   async removeItem(itemId) {
-    const result = await this.client.request("DELETE", `/cart/items/${itemId}`);
-    this.client.emit("cart:updated", result);
-    return result;
+    const res = await this.client.request("DELETE", `/cart/items/${itemId}`);
+    if (res.error) return res;
+    this.client.emit("cart:updated", res.data);
+    return res;
   }
   /** Clear entire cart */
   async clear() {
-    const result = await this.client.request("DELETE", "/cart");
+    const res = await this.client.request("DELETE", "/cart");
+    if (res.error) return res;
     this.client.emit("cart:cleared");
-    return result;
+    return res;
   }
   /** Apply a gift card code to the cart. Balance is deducted at checkout. */
   async applyGiftCard(code) {
-    const result = await this.client.request("POST", "/cart/gift-card", {
+    const res = await this.client.request("POST", "/cart/gift-card", {
       body: { code }
     });
-    this.client.emit("cart:updated", result);
-    return result;
+    if (res.error) return res;
+    this.client.emit("cart:updated", res.data);
+    return res;
   }
   /** Remove a gift card from the cart */
   async removeGiftCard() {
-    const result = await this.client.request("DELETE", "/cart/gift-card");
-    this.client.emit("cart:updated", result);
-    return result;
-  }
-  /** Add a bundle to the cart (price is locked at the bundle's current price) */
-  async addBundle(bundleId, quantity = 1) {
-    const result = await this.client.request("POST", "/cart/bundles", {
-      body: { bundleId, quantity }
-    });
-    this.client.emit("cart:updated", result);
-    return result;
+    const res = await this.client.request("DELETE", "/cart/gift-card");
+    if (res.error) return res;
+    this.client.emit("cart:updated", res.data);
+    return res;
+  }
+  /**
+   * Add a bundle to the cart. Price is snapshotted at the bundle's current
+   * price. Pass either the bundle id or its slug — slug is more ergonomic
+   * for static storefront wiring (`behio.cart.addBundle({slug: "morning-set"})`).
+   *
+   * Respects the bundle's `minQuantity`, `maxQuantity`, and `stockLimit`:
+   * the request rejects with HTTP 400 if the resulting cart line would
+   * violate any of them. The returned error includes the relevant field
+   * (`minQuantity`, `maxQuantity`, or `remaining`) so the storefront can
+   * surface a meaningful message.
+   *
+   * @param identifier Either `{id: bundleId}` or `{slug: bundleSlug}`. As a
+   *                   convenience, passing a plain string is treated as the
+   *                   bundle id for backwards compatibility.
+   * @param quantity   How many bundles to add (defaults to 1). Capped by
+   *                   the bundle's `maxQuantity` if set.
+   */
+  async addBundle(identifier, quantity = 1) {
+    const body = { quantity };
+    if (typeof identifier === "string") {
+      body.bundleId = identifier;
+    } else if ("id" in identifier) {
+      body.bundleId = identifier.id;
+    } else {
+      body.bundleSlug = identifier.slug;
+    }
+    const res = await this.client.request("POST", "/cart/bundles", { body });
+    if (res.error) return res;
+    this.client.emit("cart:updated", res.data);
+    return res;
   }
   /** Update quantity of a bundle already in the cart */
   async updateBundleQuantity(bundleId, quantity) {
-    const result = await this.client.request("PATCH", `/cart/bundles/${bundleId}`, {
+    const res = await this.client.request("PATCH", `/cart/bundles/${bundleId}`, {
       body: { quantity }
     });
-    this.client.emit("cart:updated", result);
-    return result;
+    if (res.error) return res;
+    this.client.emit("cart:updated", res.data);
+    return res;
   }
   /** Remove a bundle from the cart */
   async removeBundle(bundleId) {
-    const result = await this.client.request("DELETE", `/cart/bundles/${bundleId}`);
-    this.client.emit("cart:updated", result);
-    return result;
+    const res = await this.client.request("DELETE", `/cart/bundles/${bundleId}`);
+    if (res.error) return res;
+    this.client.emit("cart:updated", res.data);
+    return res;
   }
   /** Merge anonymous cart into authenticated customer cart */
   async merge() {
-    const result = await this.client.request("POST", "/cart/merge");
-    this.client.emit("cart:updated", result);
-    return result;
+    const res = await this.client.request("POST", "/cart/merge");
+    if (res.error) return res;
+    this.client.emit("cart:updated", res.data);
+    return res;
   }
   /** Apply discount code */
   async applyDiscount(code) {
-    const result = await this.client.request("POST", "/cart/discount", {
+    const res = await this.client.request("POST", "/cart/discount", {
       body: { code }
     });
-    this.client.emit("cart:updated", result);
-    return result;
+    if (res.error) return res;
+    this.client.emit("cart:updated", res.data);
+    return res;
   }
   /** Remove discount code */
   async removeDiscount() {
-    const result = await this.client.request("DELETE", "/cart/discount");
-    this.client.emit("cart:updated", result);
-    return result;
+    const res = await this.client.request("DELETE", "/cart/discount");
+    if (res.error) return res;
+    this.client.emit("cart:updated", res.data);
+    return res;
   }
 };
 var CheckoutModule = class {
@@ -602,13 +715,14 @@ var CheckoutModule = class {
   }
   /** Create order from cart */
   async createOrder(input) {
-    const result = await this.client.request("POST", "/checkout", {
+    const res = await this.client.request("POST", "/checkout", {
       body: input
     });
+    if (res.error) return res;
     this.client.clearCartSession();
-    this.client.emit("order:created", result);
+    this.client.emit("order:created", res.data);
     this.client.emit("cart:cleared");
-    return result;
+    return res;
   }
 };
 var OrdersModule = class {
@@ -760,7 +874,7 @@ var AddressModule = class {
   }
   /** Search for address suggestions (debounce on your side, or use the React hook) */
   async autocomplete(query, country) {
-    if (!query || query.length < 2) return { suggestions: [] };
+    if (!query || query.length < 2) return ok({ suggestions: [] });
     return this.client.request("GET", "/addresses/autocomplete", {
       query: { q: query, country }
     });
@@ -772,6 +886,49 @@ var AddressModule = class {
     });
   }
 };
+var ShippingModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Return the configured shipping methods that pass the current
+   * currency + country filter. Fixed-price methods come back with
+   * their `pricing[]` row resolved; live-quote methods come back with
+   * `price` 0 here — call `quote()` to get the real live price.
+   */
+  async listMethods(opts) {
+    const query = {};
+    if (opts?.currency) query.currency = opts.currency;
+    if (opts?.country) query.country = opts.country;
+    if (opts?.cartTotal != null) query.cartTotal = String(opts.cartTotal);
+    if (opts?.cartWeightKg != null) query.cartWeightKg = String(opts.cartWeightKg);
+    return this.client.request(
+      "GET",
+      "/catalog/shipping-methods",
+      { query }
+    );
+  }
+  /**
+   * Quote shipping for a destination address + cart contents. Each
+   * configured method is evaluated:
+   *   - `priceStrategy="fixed"` → resolved from the merchant's per-currency
+   *     `pricing[]` rows + free-shipping threshold check.
+   *   - `priceStrategy="live_quote"` → dispatched to the upstream
+   *     meta-provider (Zaslat, future Shippo / Sendcloud / …) and run
+   *     through the merchant's markup/rounding rules.
+   *
+   * Filter `available: true` for the checkout picker; `available: false`
+   * rows carry a `reason` (`"no_rate_returned"`, `"live_quote_not_implemented"`,
+   * …) you can log but should not display.
+   */
+  async quote(input) {
+    return this.client.request(
+      "POST",
+      "/catalog/shipping/quote",
+      { body: input }
+    );
+  }
+};
 
 export {
   ProductSort,
@@ -781,5 +938,8 @@ export {
   AddressTypes,
   BehioApiError,
   BehioNetworkError,
+  ok,
+  err,
+  toSdkError,
   BehioStorefront
 };