@behio/storefront-sdk 1.9.0 → 1.18.0

package/dist/{chunk-XMKY4RI5.mjs → chunk-W2P2D3EZ.mjs}

@@ -33,6 +33,38 @@ var AddressTypes = {
   SHIPPING: "SHIPPING",
   BILLING: "BILLING"
 };
+var BE_CODE_TO_ERROR = {
+  "be.storefront.cartIsEmpty": "CART_EMPTY",
+  "be.storefront.productNotFound": "PRODUCT_NOT_FOUND",
+  "be.storefront.productNotAvailable": "PRODUCT_NOT_FOUND",
+  "be.storefront.invalidEmailOrPassword": "INVALID_CREDENTIALS",
+  "be.storefront.currentPasswordIncorrect": "INVALID_CREDENTIALS",
+  "be.storefront.discountExpired": "DISCOUNT_EXPIRED",
+  "be.storefront.discountExpiredOrLimit": "DISCOUNT_EXPIRED",
+  "be.storefront.invalidDiscountCode": "INVALID_DISCOUNT",
+  "be.storefront.discountInvalid": "INVALID_DISCOUNT",
+  "be.storefront.discountInactive": "INVALID_DISCOUNT",
+  "be.storefront.discountWrongCurrency": "INVALID_DISCOUNT",
+  "be.storefront.discountNotApplicable": "INVALID_DISCOUNT",
+  "be.storefront.discountNotYetValid": "INVALID_DISCOUNT",
+  "be.storefront.discountUsageLimitReached": "INVALID_DISCOUNT",
+  "be.storefront.discountLimitedToGroups": "INVALID_DISCOUNT",
+  "be.storefront.tokenInvalid": "TOKEN_INVALID",
+  "be.storefront.orderAccessTokenInvalid": "TOKEN_INVALID",
+  "be.storefront.resetTokenInvalid": "TOKEN_INVALID",
+  "be.storefront.invalidVerificationToken": "TOKEN_INVALID",
+  "be.storefront.invalidRefreshToken": "TOKEN_INVALID",
+  "be.storefront.refreshTokenExpired": "TOKEN_EXPIRED",
+  "be.storefront.apiKeyExpired": "TOKEN_EXPIRED",
+  "be.storefront.customerEmailTaken": "EMAIL_ALREADY_EXISTS",
+  "be.storefront.orderNotCancellable": "ORDER_NOT_CANCELLABLE",
+  "be.storefront.orderCancelledNotReturnable": "ORDER_NOT_CANCELLABLE",
+  "be.validation.failed": "VALIDATION_ERROR",
+  "be.forms.formNotFound": "NOT_FOUND",
+  "be.forms.validationFailed": "VALIDATION_ERROR",
+  "be.forms.consentRequired": "VALIDATION_ERROR",
+  "be.forms.tooLarge": "VALIDATION_ERROR"
+};
 var BehioApiError = class _BehioApiError extends Error {
   constructor(status, body, message) {
     super(message || `API Error ${status}`);
@@ -49,6 +81,11 @@ var BehioApiError = class _BehioApiError extends Error {
     if (status === 409) return "EMAIL_ALREADY_EXISTS";
     if (status === 429) return "RATE_LIMITED";
     if (status >= 500) return "INTERNAL_ERROR";
+    const rawCode = body?.code;
+    if (typeof rawCode === "string") {
+      const mapped = BE_CODE_TO_ERROR[rawCode];
+      if (mapped) return mapped;
+    }
     const msg = (body?.message || "").toLowerCase();
     if (msg.includes("invalid") && msg.includes("password"))
       return "INVALID_CREDENTIALS";
@@ -157,6 +194,8 @@ var BehioStorefront = class {
     this.orders = new OrdersModule(this);
     this.customer = new CustomerModule(this);
     this.pages = new PagesModule(this);
+    this.blog = new BlogModule(this);
+    this.forms = new FormsModule(this);
     this.wishlist = new WishlistModule(this);
     this.reviews = new ReviewsModule(this);
     this.returns = new ReturnsModule(this);
@@ -605,6 +644,7 @@ var CatalogModule = class {
       if (query.priceMin) q.priceMin = query.priceMin;
       if (query.priceMax) q.priceMax = query.priceMax;
       if (query.currency) q.currency = query.currency;
+      if (query.country) q.country = query.country;
       if (query.locale) q.locale = query.locale;
       if (query.sort) q.sort = query.sort;
       if (query.inStock !== void 0) q.inStock = query.inStock;
@@ -637,7 +677,7 @@ var CatalogModule = class {
       "GET",
       `/catalog/products/${slug}`,
       {
-        query: { locale: options?.locale, currency: options?.currency }
+        query: { locale: options?.locale, currency: options?.currency, country: options?.country }
       }
     );
   }
@@ -859,16 +899,27 @@ var CatalogModule = class {
       { body: input }
     );
   }
-  /** List configured payment methods (filtered by currency). */
+  /**
+   * List configured payment methods (filtered by currency). `locale` picks the
+   * language of `instruments[].label` / `swifts[].label` (SDK 1.14.0); pass the
+   * locale of the page so the instrument tiles read in the shopper's language.
+   */
   async listPaymentMethods(opts) {
     const query = {};
     if (opts?.currency) query.currency = opts.currency;
+    if (opts?.locale) query.locale = opts.locale;
+    if (opts?.country) query.country = opts.country;
+    if (opts?.shippingMethodId) query.shippingMethodId = opts.shippingMethodId;
     return this.client.request(
       "GET",
       "/catalog/payment-methods",
       { query }
     );
   }
+  /** Alias of `listPaymentMethods` (SDK 1.14.0). */
+  paymentMethods(opts) {
+    return this.listPaymentMethods(opts);
+  }
 };
 var AuthModule = class {
   constructor(client) {
@@ -1022,6 +1073,26 @@ var CartModule = class {
     this.client.emit("cart:updated", res.data);
     return res;
   }
+  /**
+   * Tell the cart where the order will ship (and, for B2B, the buyer's VAT
+   * ID) so the VAT breakdown matches the checkout before the address form:
+   * destination-country rate (OSS), 0 % export outside the EU, or reverse
+   * charge for an EU business with a VIES-valid VAT ID. `cart.vatMode` says
+   * which rule applied. SDK 1.17.0.
+   *
+   * ```ts
+   * await client.cart.setDestination({ country: "SK" });
+   * await client.cart.setDestination({ vatId: "SK2020000001" }); // "" clears
+   * ```
+   */
+  async setDestination(input) {
+    const res = await this.client.request("PUT", "/cart/destination", {
+      body: input
+    });
+    if (res.error) return res;
+    this.client.emit("cart:updated", res.data);
+    return res;
+  }
   /** Update item quantity */
   async updateQuantity(itemId, quantity) {
     const res = await this.client.request(
@@ -1173,6 +1244,30 @@ var OrdersModule = class {
   constructor(client) {
     this.client = client;
   }
+  /**
+   * Ask the backend to re-check this order's payment with the gateway.
+   *
+   * Call it on the thank-you page the customer lands on after paying, BEFORE
+   * you read the order. Some gateways (Tatrapay+) have no server-to-server
+   * notification at all, so the customer's return is the only fast way the
+   * payment gets confirmed; for the others it is a safety net for a lost
+   * notification.
+   *
+   * The response is deliberately opaque (`{ok: true}` every time, even for an
+   * order number that does not exist): order numbers are sequential, so
+   * anything else would turn this into a probe for other people's orders.
+   * Read the actual state afterwards through a path that proves entitlement
+   * ({@link get}, {@link track} or the guest access-code flow).
+   *
+   * Never throws for a missing order and never blocks the page: treat a
+   * failure as "not confirmed yet", the backend poller catches up on its own.
+   */
+  async syncPaymentOnReturn(orderNumber) {
+    return this.client.request(
+      "POST",
+      `/payments/return/${orderNumber}`
+    );
+  }
   /** List customer orders (requires auth) */
   async list(options) {
     return this.client.request(
@@ -1299,7 +1394,10 @@ var CustomerModule = class {
       body: address
     });
   }
-  /** Update address */
+  /**
+   * Update address. Partial: `{isDefault: true}` alone is a valid body. A
+   * changed `vatId` or `country` re-runs the VIES check on the server.
+   */
   async updateAddress(addressId, data) {
     return this.client.request(
       "PATCH",
@@ -1525,6 +1623,59 @@ var PagesModule = class {
     });
   }
 };
+var BlogModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** List the site's blogs (active only). */
+  async list(locale) {
+    return this.client.request("GET", "/blogs", {
+      query: { locale }
+    });
+  }
+  /** Published posts of one blog, newest first (featured first), paginated. */
+  async posts(handle, query = {}) {
+    return this.client.request("GET", `/blogs/${handle}/posts`, {
+      query: {
+        locale: query.locale,
+        page: query.page,
+        limit: query.limit,
+        tag: query.tag
+      }
+    });
+  }
+  /** One published post with sanitised HTML content and related posts. */
+  async post(handle, slug, locale) {
+    return this.client.request("GET", `/blogs/${handle}/posts/${slug}`, {
+      query: { locale }
+    });
+  }
+};
+var FormsModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** Public definition of one form (fields + settings). 404 for an unknown or inactive slug. */
+  async get(slug) {
+    return this.client.request(
+      "GET",
+      `/forms/${encodeURIComponent(slug)}`
+    );
+  }
+  /**
+   * Submit a response. On `be.forms.validationFailed` the returned error
+   * carries per-field codes: read them with `formFieldErrors(error)`. Other
+   * rejections: `be.forms.consentRequired`, `be.forms.tooLarge`,
+   * `be.forms.formNotFound`; rate limit 10 submits per minute per visitor.
+   */
+  async submit(slug, input) {
+    return this.client.request(
+      "POST",
+      `/forms/${encodeURIComponent(slug)}/submit`,
+      { body: input, auth: false }
+    );
+  }
+};
 var WishlistModule = class {
   constructor(client) {
     this.client = client;