@behio/storefront-sdk 0.3.0 → 0.4.0

package/README.md

@@ -83,7 +83,7 @@ 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 |
 | `returns` | Submit return requests |
 | `consent` | Cookie consent (GDPR) |
 | `quotes` | B2B quote requests |

package/dist/{chunk-45FTJKSW.mjs → chunk-L5KVNLTD.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 {
@@ -197,11 +231,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 +250,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 +335,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 +365,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 +431,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 +453,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 +480,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 +500,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 +588,102 @@ 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;
+    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 locked at the bundle's current price) */
   async addBundle(bundleId, quantity = 1) {
-    const result = await this.client.request("POST", "/cart/bundles", {
+    const res = await this.client.request("POST", "/cart/bundles", {
       body: { bundleId, quantity }
     });
-    this.client.emit("cart:updated", result);
-    return result;
+    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 +692,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 +851,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 }
     });
@@ -781,5 +872,8 @@ export {
   AddressTypes,
   BehioApiError,
   BehioNetworkError,
+  ok,
+  err,
+  toSdkError,
   BehioStorefront
 };