brainerce 1.37.0 → 1.37.2

package/README.md

@@ -2055,32 +2055,33 @@ const checkout = await client.createCheckout({
 
 #### Region display pricing (`getProducts({ regionId })`)
 
-Product reads accept an optional `regionId`. When set, each product/variant that
-a region [price list](#price-lists) resolves gains additive fields —
-`resolvedPrice`, `resolvedCurrency`, `resolvedCompareAtPrice`, and `priceSource`
-(`'variant-entry'` | `'product-entry'`). Your existing `basePrice` / `salePrice`
-stay in the store currency; the fields appear **only** when a region entry
-actually applies, so an omitted/invalid region (or a catalog-price fallback)
-leaves the response byte-identical.
+All three product reads accept an optional `regionId` — `getProducts`,
+`getProduct(id)`, **and** `getProductBySlug(slug)` (the PDP path). When set and the
+region's currency differs from the store currency, each product/variant gains
+additive FX-display fields — `displayPrice`, `displaySalePrice`, and
+`displayCurrency` (plus `displayPriceMin` / `displayPriceMax` on storefront-mode
+list reads). Your `basePrice` / `salePrice` stay in the store currency; the
+display fields appear **only** when an FX rate applies, so an omitted/invalid
+region or a same-currency region leaves the response byte-identical.
 
 ```typescript
 const { data: products } = await client.getProducts({ regionId: 'region_eu' });
 const p = products[0];
-const display = p.resolvedPrice
-  ? `${p.resolvedPrice} ${p.resolvedCurrency}` // e.g. "27.00 EUR"
-  : p.basePrice; // store-currency catalog price
+const display = p.displayPrice
+  ? `${p.displayPrice} ${p.displayCurrency}` // e.g. "27.00 EUR"
+  : p.basePrice; // store-currency price (no FX rate / same currency)
 
-// Single product (id or slug) takes the same option:
+// Single product by id OR slug takes the same option:
 await client.getProduct('prod_tshirt', { regionId: 'region_eu' });
+await client.getProductBySlug('blue-shirt', { regionId: 'region_eu' });
 ```
 
 > **Display-only** — like checkout, `regionId` here does not charge the region
-> price; it only changes what you render until currency-lock ships. **Mode note:**
-> the additive FX display overlay (`displayPrice` / `displayCurrency`, see
-> [Regions](/docs/concepts/regions)) now applies in vibe-coded
-> (`vc_*`/`salesChannelId`) mode too — previously it was populated on storefront
-> (`storeId`) and admin (`apiKey`) reads only. Pass `regionId` and the response
-> gains `displayPrice` whenever a daily FX rate exists for the store→region pair.
+> currency; it only changes what you render until currency-lock ships. Works in
+> **all three modes** — vibe-coded (`vc_*`/`salesChannelId`), storefront (`storeId`),
+> and admin (`apiKey`). The response gains `displayPrice` whenever a daily FX rate
+> exists for the store/region currency pair in **either** direction (the overlay
+> inverts the stored rate when needed). See [Regions](/docs/concepts/regions).
 
 #### Partial Checkout (AliExpress-style)
 

package/dist/index.d.mts

@@ -5493,6 +5493,7 @@ declare class BrainerceClient {
      */
     getProductBySlug(slug: string, options?: {
         locale?: string;
+        regionId?: string;
     }): Promise<Product>;
     /**
      * Get available categories for filtering products

package/dist/index.d.ts

@@ -5493,6 +5493,7 @@ declare class BrainerceClient {
      */
     getProductBySlug(slug: string, options?: {
         locale?: string;
+        regionId?: string;
     }): Promise<Product>;
     /**
      * Get available categories for filtering products

package/dist/index.js

@@ -1192,13 +1192,14 @@ var BrainerceClient = class {
    */
   async getProductBySlug(slug, options) {
     const headerOverrides = options?.locale ? { "Accept-Language": options.locale } : void 0;
+    const queryParams = options?.regionId ? { regionId: options.regionId } : void 0;
     const encodedSlug = encodePathSegment(slug);
     if (this.isVibeCodedMode()) {
       return this.vibeCodedRequest(
         "GET",
         `/products/slug/${encodedSlug}`,
         void 0,
-        void 0,
+        queryParams,
         headerOverrides
       );
     }
@@ -1207,11 +1208,16 @@ var BrainerceClient = class {
         "GET",
         `/products/slug/${encodedSlug}`,
         void 0,
-        void 0,
+        queryParams,
         headerOverrides
       );
     }
-    return this.adminRequest("GET", `/api/v1/products/by-slug/${encodedSlug}`);
+    return this.adminRequest(
+      "GET",
+      `/api/v1/products/by-slug/${encodedSlug}`,
+      void 0,
+      queryParams
+    );
   }
   /**
    * Get available categories for filtering products

package/dist/index.mjs

@@ -1122,13 +1122,14 @@ var BrainerceClient = class {
    */
   async getProductBySlug(slug, options) {
     const headerOverrides = options?.locale ? { "Accept-Language": options.locale } : void 0;
+    const queryParams = options?.regionId ? { regionId: options.regionId } : void 0;
     const encodedSlug = encodePathSegment(slug);
     if (this.isVibeCodedMode()) {
       return this.vibeCodedRequest(
         "GET",
         `/products/slug/${encodedSlug}`,
         void 0,
-        void 0,
+        queryParams,
         headerOverrides
       );
     }
@@ -1137,11 +1138,16 @@ var BrainerceClient = class {
         "GET",
         `/products/slug/${encodedSlug}`,
         void 0,
-        void 0,
+        queryParams,
         headerOverrides
       );
     }
-    return this.adminRequest("GET", `/api/v1/products/by-slug/${encodedSlug}`);
+    return this.adminRequest(
+      "GET",
+      `/api/v1/products/by-slug/${encodedSlug}`,
+      void 0,
+      queryParams
+    );
   }
   /**
    * Get available categories for filtering products

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brainerce",
-  "version": "1.37.0",
+  "version": "1.37.2",
   "description": "Official SDK for building e-commerce storefronts with Brainerce Platform. Perfect for vibe-coded sites, AI-built stores (Cursor, Lovable, v0), and custom storefronts.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",