@behio/storefront-sdk 0.4.0 → 0.6.0

package/README.md

@@ -84,6 +84,7 @@ function ProductList() {
 | `wishlist` | Add, remove, check |
 | `reviews` | Submit, list, vote helpful |
 | `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-YLKO3SUR.js → chunk-77TWIYZE.js}

@@ -142,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 */
@@ -493,6 +494,12 @@ var CatalogModule = class {
   async checkGiftCard(code) {
     return this.client.request("GET", `/catalog/gift-cards/${encodeURIComponent(code)}/check`);
   }
+  /** List configured payment methods (filtered by currency). */
+  async listPaymentMethods(opts) {
+    const query = {};
+    if (_optionalChain([opts, 'optionalAccess', _23 => _23.currency])) query.currency = opts.currency;
+    return this.client.request("GET", "/catalog/payment-methods", { query });
+  }
 };
 var AuthModule = class {
   constructor(client) {
@@ -637,11 +644,33 @@ var CartModule = class {
     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 res = await this.client.request("POST", "/cart/bundles", {
-      body: { bundleId, quantity }
-    });
+  /**
+   * 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;
@@ -709,7 +738,7 @@ var OrdersModule = class {
   /** List customer orders (requires auth) */
   async list(options) {
     return this.client.request("GET", "/orders", {
-      query: { page: _optionalChain([options, 'optionalAccess', _23 => _23.page]), limit: _optionalChain([options, 'optionalAccess', _24 => _24.limit]) }
+      query: { page: _optionalChain([options, 'optionalAccess', _24 => _24.page]), limit: _optionalChain([options, 'optionalAccess', _25 => _25.limit]) }
     });
   }
   /** Get order detail (requires auth) */
@@ -810,6 +839,16 @@ var ReturnsModule = class {
   constructor(client) {
     this.client = client;
   }
+  /**
+   * Guest order lookup for the EU withdrawal form: order number + the email
+   * used on the order resolve to the order id and per-item returnable
+   * quantities. POST so the email never appears in a URL.
+   */
+  async lookupOrder(orderNumber, email) {
+    return this.client.request("POST", "/returns/lookup-order", {
+      body: { orderNumber, email }
+    });
+  }
   async submit(input) {
     return this.client.request("POST", "/returns", { body: input });
   }
@@ -863,6 +902,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 (_optionalChain([opts, 'optionalAccess', _26 => _26.currency])) query.currency = opts.currency;
+    if (_optionalChain([opts, 'optionalAccess', _27 => _27.country])) query.country = opts.country;
+    if (_optionalChain([opts, 'optionalAccess', _28 => _28.cartTotal]) != null) query.cartTotal = String(opts.cartTotal);
+    if (_optionalChain([opts, 'optionalAccess', _29 => _29.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 }
+    );
+  }
+};
 
 
 

package/dist/{chunk-L5KVNLTD.mjs → chunk-COWHUXHJ.mjs}

@@ -142,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 */
@@ -493,6 +494,12 @@ var CatalogModule = class {
   async checkGiftCard(code) {
     return this.client.request("GET", `/catalog/gift-cards/${encodeURIComponent(code)}/check`);
   }
+  /** List configured payment methods (filtered by currency). */
+  async listPaymentMethods(opts) {
+    const query = {};
+    if (opts?.currency) query.currency = opts.currency;
+    return this.client.request("GET", "/catalog/payment-methods", { query });
+  }
 };
 var AuthModule = class {
   constructor(client) {
@@ -637,11 +644,33 @@ var CartModule = class {
     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 res = await this.client.request("POST", "/cart/bundles", {
-      body: { bundleId, quantity }
-    });
+  /**
+   * 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;
@@ -810,6 +839,16 @@ var ReturnsModule = class {
   constructor(client) {
     this.client = client;
   }
+  /**
+   * Guest order lookup for the EU withdrawal form: order number + the email
+   * used on the order resolve to the order id and per-item returnable
+   * quantities. POST so the email never appears in a URL.
+   */
+  async lookupOrder(orderNumber, email) {
+    return this.client.request("POST", "/returns/lookup-order", {
+      body: { orderNumber, email }
+    });
+  }
   async submit(input) {
     return this.client.request("POST", "/returns", { body: input });
   }
@@ -863,6 +902,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,