brainerce 1.44.0 → 1.45.0

package/README.md

@@ -32,28 +32,28 @@ yarn add brainerce
 
 Every Brainerce storefront must include **all mandatory features** below. Features auto-hide when the underlying capability is disabled, so build them all anyway — they'll appear the moment the store owner enables them.
 
-| Feature                                                 | SDK entry point                                                                                               | Mandatory   |
-| ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | ----------- |
-| Product list with search, filter, pagination            | `client.getProducts()`, `client.getSearchSuggestions(query)`                                                  | ✅          |
-| Product detail with variant picker, stock, price        | `client.getProductBySlug()` + helpers                                                                         | ✅          |
-| Buyer customization fields (engraving, uploads, select) | `product.customizationFields`, `client.uploadCustomizationFile()`                                             | ✅          |
-| Cart (add, update, remove, coupon, totals)              | `client.addToCart()`, `getCartTotals(cart)`                                                                   | ✅          |
-| Inventory reservation countdown                         | Cart expiry timestamp from `client.getCart()`                                                                 | ✅          |
-| Full checkout end-to-end with payment                   | `setShippingAddress → selectShippingMethod → getPaymentProviders → pay → handlePaymentSuccess → waitForOrder` | ✅          |
-| Order confirmation (clear cart + wait for real order)   | `client.handlePaymentSuccess()`, `client.waitForOrder()`                                                      | ✅          |
-| Register + email verification flow                      | `client.registerCustomer()`, `client.verifyEmail()`                                                           | ✅          |
-| Login + verification branch                             | `client.loginCustomer()`                                                                                      | ✅          |
-| Forgot / reset password                                 | `client.forgotPassword()`, `client.resetPassword()`                                                           | ✅          |
-| OAuth sign-in buttons + callback handler                | `client.getAvailableOAuthProviders()`                                                                         | ✅          |
-| Account area (profile + order history)                  | `client.getMyProfile()`, `client.getMyOrders()`                                                               | ✅          |
+| Feature                                                 | SDK entry point                                                                                                             | Mandatory   |
+| ------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | ----------- |
+| Product list with search, filter, pagination            | `client.getProducts()`, `client.getSearchSuggestions(query)`                                                                | ✅          |
+| Product detail with variant picker, stock, price        | `client.getProductBySlug()` + helpers                                                                                       | ✅          |
+| Buyer customization fields (engraving, uploads, select) | `product.customizationFields`, `client.uploadCustomizationFile()`                                                           | ✅          |
+| Cart (add, update, remove, coupon, totals)              | `client.addToCart()`, `getCartTotals(cart)`                                                                                 | ✅          |
+| Inventory reservation countdown                         | Cart expiry timestamp from `client.getCart()`                                                                               | ✅          |
+| Full checkout end-to-end with payment                   | `setShippingAddress → selectShippingMethod → getPaymentProviders → pay → handlePaymentSuccess → waitForOrder`               | ✅          |
+| Order confirmation (clear cart + wait for real order)   | `client.handlePaymentSuccess()`, `client.waitForOrder()`                                                                    | ✅          |
+| Register + email verification flow                      | `client.registerCustomer()`, `client.verifyEmail()`                                                                         | ✅          |
+| Login + verification branch                             | `client.loginCustomer()`                                                                                                    | ✅          |
+| Forgot / reset password                                 | `client.forgotPassword()`, `client.resetPassword()`                                                                         | ✅          |
+| OAuth sign-in buttons + callback handler                | `client.getAvailableOAuthProviders()`                                                                                       | ✅          |
+| Account area (profile + order history)                  | `client.getMyProfile()`, `client.getMyOrders()`                                                                             | ✅          |
 | Loyalty & rewards (points balance + tiers + redeem)     | `client.getLoyaltyStatus()`, `client.getAvailableRewards()`, `client.redeemLoyaltyReward(id)`, `client.reportSocialShare()` | conditional |
-| Global header: cart count + search autocomplete         | `client.getCart()`, `client.getSearchSuggestions(query)`                                                      | ✅          |
-| Discount banners + product badges                       | `client.getDiscountBanners()`, `client.getProductDiscountBadge(productId)`                                    | ✅          |
-| Product reviews on PDP + JSON-LD aggregateRating        | `client.listProductReviews(id)`, `client.submitProductReview(id, …)`                                          | ✅          |
-| Site chrome (header + footer + announcement bar)        | `client.content.header.get()`, `client.content.footer.get()`, `client.content.announcement.list()`            | ✅          |
-| FAQ page                                                | `client.content.faq.get('main', locale)`                                                                      | conditional |
-| Static pages catch-all (`/pages/[slug]`)                | `client.content.page.getBySlug(slug, locale)`                                                                 | conditional |
-| Multi-language + RTL (when i18n enabled)                | `client.setLocale()`, `client.getStoreDirection(locale)`                                                      | conditional |
+| Global header: cart count + search autocomplete         | `client.getCart()`, `client.getSearchSuggestions(query)`                                                                    | ✅          |
+| Discount banners + product badges                       | `client.getDiscountBanners()`, `client.getProductDiscountBadge(productId)`                                                  | ✅          |
+| Product reviews on PDP + JSON-LD aggregateRating        | `client.listProductReviews(id)`, `client.submitProductReview(id, …)`                                                        | ✅          |
+| Site chrome (header + footer + announcement bar)        | `client.content.header.get()`, `client.content.footer.get()`, `client.content.announcement.list()`                          | ✅          |
+| FAQ page                                                | `client.content.faq.get('main', locale)`                                                                                    | conditional |
+| Static pages catch-all (`/pages/[slug]`)                | `client.content.page.getBySlug(slug, locale)`                                                                               | conditional |
+| Multi-language + RTL (when i18n enabled)                | `client.setLocale()`, `client.getStoreDirection(locale)`                                                                    | conditional |
 
 ---
 
@@ -185,9 +185,22 @@ These sequences are non-negotiable. The order of SDK calls matters.
 
 1. Read `checkoutId` from URL or session.
 2. `await client.handlePaymentSuccess(checkoutId)` — mandatory, clears cart so purchased items don't show on next visit.
-3. `const order = await client.waitForOrder(checkoutId)` — polls until the webhook writes the order.
+3. `const result = await client.waitForOrder(checkoutId)` — polls until the webhook writes the order. `result.status.orderNumber` / `result.status.orderId` are available on success.
 4. Show a spinner during step 3 (webhook may lag). On timeout: show "we're still processing, check your email" with a link to order history — the order WILL appear there.
-5. On success: render order number and line items from the returned `order` object.
+5. On success: render the order number, or — if your design wants more than that — fetch full details:
+
+```typescript
+const result = await client.waitForOrder(checkoutId);
+if (result.success) {
+  const order = await client.getOrderByCheckout(checkoutId);
+  // order.items, order.shippingAddress, order.notes (the shopper's own
+  // order note, read-only), order.subtotal, order.shippingAmount,
+  // order.taxAmount / order.taxBreakdown, order.totalAmount
+}
+```
+
+`getOrderByCheckout` works for guests too — possession of the checkout id is
+the credential, no customer token needed.
 
 ### Password reset flow
 
@@ -1560,7 +1573,7 @@ await client.addToCart(cartId, {
 ```typescript
 // Works for CartItem, CheckoutLineItem, and OrderItem — same shape
 const summary = Object.values(item.customizations ?? {})
-  .map(c => `${c.label}: ${Array.isArray(c.value) ? c.value.join(', ') : c.value}`)
+  .map((c) => `${c.label}: ${Array.isArray(c.value) ? c.value.join(', ') : c.value}`)
   .join(' | ');
 // e.g. "Frame color: Gold | Add-ons: Gift wrap, Engraving"
 ```
@@ -2144,6 +2157,7 @@ const checkout = await client.setCheckoutCustomer(checkoutId, {
   firstName: 'John',
   lastName: 'Doe',
   phone: '+1234567890', // Optional
+  notes: 'Please leave the package at the door', // Optional order note (max 2000 chars)
 });
 ```
 
@@ -2160,12 +2174,21 @@ const { checkout, rates } = await client.setShippingAddress(checkoutId, {
   postalCode: '10001',
   country: 'US',
   phone: '+1234567890', // Optional
+  notes: 'Please leave the package at the door', // Optional order note (max 2000 chars)
 });
 
 // rates contains available shipping options
 console.log(rates); // ShippingRate[]
 ```
 
+> **Order notes:** every checkout page should render an optional **"Order
+> notes"** textarea by default. Send its value via `notes` on either
+> `setCheckoutCustomer` or `setShippingAddress` (whichever call your flow
+> makes last) — max 2000 chars, empty string clears a previously-set note.
+> The note is copied onto the order at completion (merchant sees it in the
+> dashboard, it's included in the confirmation email) and echoed back
+> read-only as `Order.notes` on buyer order responses.
+
 #### Select Shipping Method
 
 ```typescript
@@ -2239,10 +2262,11 @@ interface Checkout {
   subtotal: string;
   discountAmount: string;
   shippingAmount: string;
-  taxAmount: string;          // "0" in inclusive (VAT) mode — see taxBreakdown.totalTax
+  taxAmount: string; // "0" in inclusive (VAT) mode — see taxBreakdown.totalTax
   taxBreakdown?: TaxBreakdown | null; // { totalTax, pricesIncludeTax, breakdown[] }
   total: string;
   couponCode?: string | null;
+  notes?: string | null; // Order note from setCheckoutCustomer/setShippingAddress
   items: CheckoutLineItem[];
   itemCount: number;
   availableShippingRates?: ShippingRate[];
@@ -2380,12 +2404,12 @@ const checkoutId = checkout.id;
 Use this method to get ALL enabled payment providers and build dynamic UI.
 
 **Primary vs. additive methods (Shopify-parity).** Each provider carries a
-`methodType`. A `CREDIT_CARD` provider is the *primary* card processor — the
+`methodType`. A `CREDIT_CARD` provider is the _primary_ card processor — the
 single method that settles the order (`defaultProvider`, `isAdditive: false`,
-`presentation: 'card_form'`). Everything else is *additive* (`isAdditive: true`),
+`presentation: 'card_form'`). Everything else is _additive_ (`isAdditive: true`),
 e.g. PayPal is a `'WALLET'` with `presentation: 'express_button'`. Render additive
 methods as accelerated-checkout **express buttons above the card form** — they sit
-*alongside* the primary, never replace it. (Exception: a wallet-only store has no
+_alongside_ the primary, never replace it. (Exception: a wallet-only store has no
 card processor, so its wallet becomes the `defaultProvider` and stands alone.)
 
 ```typescript
@@ -2943,8 +2967,9 @@ const rewards = await client.getAvailableRewards();
 // Redeem → spends points, returns a one-time coupon code to apply to the cart.
 // `discountType` tells you how to interpret `discountValue` (currency amount
 // for FIXED_DISCOUNT, 0-100 percent for PERCENT_DISCOUNT).
-const { couponCode, discountType, discountValue, pointsBalance } =
-  await client.redeemLoyaltyReward(rewards[0].id);
+const { couponCode, discountType, discountValue, pointsBalance } = await client.redeemLoyaltyReward(
+  rewards[0].id
+);
 await client.applyCoupon(cartId, couponCode);
 
 // Self-reported social share — grants the SOCIAL_SHARE bonus if configured
@@ -3521,8 +3546,8 @@ client.trackEvent({ eventType: 'pageview', path: '/products/shoes' });
 const params = new URLSearchParams(window.location.search);
 client.trackEvent({
   path: window.location.pathname,
-  utmSource:   params.get('utm_source')   ?? undefined,
-  utmMedium:   params.get('utm_medium')   ?? undefined,
+  utmSource: params.get('utm_source') ?? undefined,
+  utmMedium: params.get('utm_medium') ?? undefined,
   utmCampaign: params.get('utm_campaign') ?? undefined,
   screenWidth: window.innerWidth,
   lang: navigator.language,
@@ -3553,6 +3578,94 @@ const admin = new BrainerceClient({
 });
 ```
 
+### Product Management
+
+```typescript
+import type { Product, CreateProductDto, UpdateProductDto } from 'brainerce';
+
+// Create a simple product
+const product: Product = await client.createProduct({
+  name: 'Classic T-Shirt',
+  slug: 'classic-t-shirt', // Optional — auto-generated from name if omitted
+  sku: 'TSH-001',
+  description: 'Soft cotton tee.',
+  basePrice: 29.99,
+  salePrice: 24.99, // Optional
+  costPrice: 12.0, // Optional, internal — never synced to platforms
+  status: 'active', // 'active' | 'draft' (default: 'active')
+  type: 'SIMPLE', // 'SIMPLE' | 'VARIABLE' (default: 'SIMPLE')
+  categories: ['cat_id'], // Existing category IDs
+  categoryNames: ['Apparel'], // Or assign/auto-create by name — merged with `categories`
+  brands: ['brand_id'],
+  tags: ['sale', 'summer'],
+  images: [
+    {
+      url: 'https://cdn.example.com/tshirt.jpg',
+      position: 0,
+      isMain: true,
+      alt: 'Classic T-Shirt',
+    },
+  ],
+
+  // Cross-platform identifiers (Google Shopping / Facebook Catalog / TikTok).
+  // Provide gtin when the product has one; otherwise mpn + brand.
+  gtin: '012345678905', // EAN/UPC/ISBN — validated (GS1 mod-10 checksum)
+  mpn: 'MFR-TSH-001', // Manufacturer Part Number — used only when gtin is absent
+
+  // Google Merchant Center sale_price_effective_date — bounds when `salePrice`
+  // is actually active. Set both together, or omit both (sale always active).
+  salePriceStartsAt: '2026-06-01T00:00:00Z',
+  salePriceEndsAt: '2026-06-30T23:59:59Z',
+
+  // Shipping weight & dimensions — used for accurate shipping-cost
+  // calculation and Google Shopping's shipping_weight/shipping_length/etc.
+  shippingWeightValue: 0.3,
+  shippingWeightUnit: 'kg', // 'kg' | 'lb' | 'g' | 'oz'
+  shippingLengthValue: 30,
+  shippingWidthValue: 20,
+  shippingHeightValue: 2,
+  shippingDimensionUnit: 'cm', // 'cm' | 'in' — shared by length/width/height
+});
+
+// Update a product — every field is optional; only send what changed.
+// Pass `null` on gtin/mpn/salePriceStartsAt/salePriceEndsAt/shipping* to clear them.
+const updated: Product = await client.updateProduct('prod_123', {
+  salePrice: null, // End the sale
+  salePriceStartsAt: null,
+  salePriceEndsAt: null,
+} satisfies UpdateProductDto);
+
+// Delete a product (optionally also delete from synced platforms)
+await client.deleteProduct('prod_123', { platforms: ['SHOPIFY'] });
+
+// VARIABLE products: create the product with type: 'VARIABLE', then add variants
+const variableProduct = await client.createProduct({
+  name: 'Hoodie',
+  basePrice: 0,
+  type: 'VARIABLE',
+});
+await client.bulkSaveVariants(variableProduct.id, {
+  variants: [
+    {
+      sku: 'HOOD-S-BLK',
+      attributes: { Size: 'S', Color: 'Black' },
+      price: 49.99,
+      stock: 20,
+      isEnabled: true,
+    },
+    {
+      sku: 'HOOD-M-BLK',
+      attributes: { Size: 'M', Color: 'Black' },
+      price: 49.99,
+      stock: 15,
+      isEnabled: true,
+    },
+  ],
+});
+```
+
+**GTIN vs MPN:** these are two different identifiers, not interchangeable — GTIN (EAN/UPC/ISBN) is a universal barcode; MPN is manufacturer-specific and only meaningful paired with a brand. Provide GTIN when the product has one; otherwise brand + MPN. A product typically needs one or the other, not both.
+
 ### Taxonomy Management
 
 ```typescript
@@ -3674,6 +3787,37 @@ const euZone = await client.createShippingZone({
   regionIds: ['reg_eu'],
 });
 
+// Polygon zone ("draw on map") — a hand-drawn delivery area. GeoJSON
+// Polygon/MultiPolygon, [lng, lat] ring coordinates. Independent of
+// `countries`/`regions`/`postalCodes`: a zone matches if the address
+// satisfies *either* coverage, so both may be set on the same zone (this
+// example omits `countries` since the polygon is its only coverage).
+const polygonZone = await client.createShippingZone({
+  name: 'Tel Aviv Metro',
+  countries: [],
+  geometry: {
+    type: 'Polygon',
+    coordinates: [
+      [
+        [34.75, 32.05],
+        [34.75, 32.1],
+        [34.82, 32.1],
+        [34.82, 32.05],
+        [34.75, 32.05],
+      ],
+    ],
+  },
+});
+
+// Restrict a zone to specific sales channels — `SalesChannel.id` or the
+// public `vc_*` connectionId. Empty/omitted = every channel; a non-empty
+// list hides the zone unless the checkout came from one of them.
+const mobileOnlyZone = await client.createShippingZone({
+  name: 'US Domestic (mobile app only)',
+  countries: ['US'],
+  salesChannelIds: ['vc_abc123'],
+});
+
 // Shipping Rates
 const rates = await client.getZoneShippingRates('zone_id');
 await client.createZoneShippingRate('zone_id', {
@@ -3696,9 +3840,9 @@ const label = await admin.createShippingLabel(orderId, {
   shippoRateObjectId: 'rate_8f123456789abcdef', // Shippo rate.object_id from checkout rates
 });
 
-console.log(label.labelUrl);       // PDF label URL for printing
+console.log(label.labelUrl); // PDF label URL for printing
 console.log(label.trackingNumber); // Auto-populated on the order
-console.log(label.carrier);        // e.g. 'USPS', 'UPS', 'FedEx'
+console.log(label.carrier); // e.g. 'USPS', 'UPS', 'FedEx'
 ```
 
 The `trackingNumber` is stored on the `Order` automatically — customers see it in their
@@ -4023,6 +4167,43 @@ const preview = await client.previewEmailTemplate('template_id', {
 });
 ```
 
+### Storefront Bot Settings
+
+Requires an API key with the `bot-settings:read` / `bot-settings:write` scopes.
+
+```typescript
+// Every connection on the store + its current (or default) settings
+const { connections, settings } = await client.getBotSettings();
+
+// PATCH semantics — only the fields you pass are changed
+await client.updateBotSettings({
+  salesChannelId: connections[0].salesChannelId,
+  enabled: true,
+  displayName: 'Maya',
+  personaJson: {
+    greeting: 'Hi! Looking for something specific?',
+    tone: 'friendly', // 'friendly' | 'formal' | 'playful' | 'concise'
+    starterQuestions: ['What sizes do you carry?', "What's your return policy?"],
+    avoidTopics: 'Do not discuss competitor pricing or make medical claims.',
+    customInstructions: 'Always mention free shipping over $75.',
+    capabilities: { productQa: true, recommendations: true, returns: false },
+  },
+});
+```
+
+### Storefront Bot Conversations
+
+Studio inbox transcripts + on-demand summarization. Requires the `bot-conversations:read` / `bot-conversations:write` scopes.
+
+```typescript
+const { data: conversations } = await client.listBotConversations({ limit: 20 });
+const transcript = await client.getBotConversation(conversations[0].id);
+
+// Persists a summary on the conversation; short threads (10 or fewer messages)
+// are a no-op — { summarized: false, summary: null } — no credits charged.
+const { summarized, summary } = await client.summarizeBotConversation(conversations[0].id);
+```
+
 ### Sync Conflict Resolution
 
 ```typescript
@@ -5105,7 +5286,7 @@ const forms = await brainerce.contactForms.list();
 
 ## Storefront Bot (AI chat widget)
 
-Add the store's AI shopping assistant with one line. All configuration (name, avatar, colors, greeting, starter questions, guardrails) lives in the merchant dashboard — the widget renders nothing until the bot is switched Live there.
+Add the store's AI shopping assistant with one line. Configuration (name, avatar, colors, greeting, starter questions, guardrails) is normally set in the merchant dashboard — the widget renders nothing until the bot is switched Live there. Those same settings are also readable/writable via `client.getBotSettings()` / `client.updateBotSettings()`, and conversation transcripts + summarization via `client.listBotConversations()` / `client.summarizeBotConversation()` — see [Storefront Bot Settings](#storefront-bot-settings) and [Storefront Bot Conversations](#storefront-bot-conversations) in the Admin API Reference.
 
 ```html
 <!-- zero-code embed: keep the tag exactly this bare (no integrity/crossorigin) -->

package/dist/index.d.mts

@@ -1202,6 +1202,10 @@ interface CreateProductDto {
     name: string;
     slug?: string;
     sku?: string;
+    /** Global Trade Item Number (EAN/UPC/ISBN) — cross-platform identifier. */
+    gtin?: string;
+    /** Manufacturer Part Number — used by Google Shopping (with brand) when no GTIN exists. */
+    mpn?: string;
     description?: string;
     basePrice: number;
     salePrice?: number;
@@ -1219,11 +1223,26 @@ interface CreateProductDto {
     brandNames?: string[];
     tags?: string[];
     images?: ProductImage[];
+    /** Sale-price effective window (ISO 8601) — Google Merchant Center
+     *  sale_price_effective_date. Set both together, or neither applies. */
+    salePriceStartsAt?: string;
+    salePriceEndsAt?: string;
+    shippingWeightValue?: number;
+    shippingWeightUnit?: 'kg' | 'lb' | 'g' | 'oz';
+    shippingLengthValue?: number;
+    shippingWidthValue?: number;
+    shippingHeightValue?: number;
+    /** Unit shared by shippingLengthValue/shippingWidthValue/shippingHeightValue. */
+    shippingDimensionUnit?: 'cm' | 'in';
 }
 interface UpdateProductDto {
     name?: string;
     slug?: string;
     sku?: string;
+    /** Global Trade Item Number (EAN/UPC/ISBN). Pass `null` to clear. */
+    gtin?: string | null;
+    /** Manufacturer Part Number. Pass `null` to clear. */
+    mpn?: string | null;
     description?: string;
     basePrice?: number;
     salePrice?: number | null;
@@ -1240,6 +1259,15 @@ interface UpdateProductDto {
     brandNames?: string[];
     tags?: string[];
     images?: ProductImage[];
+    /** Sale-price effective window (ISO 8601). Pass `null` to clear either bound. */
+    salePriceStartsAt?: string | null;
+    salePriceEndsAt?: string | null;
+    shippingWeightValue?: number | null;
+    shippingWeightUnit?: 'kg' | 'lb' | 'g' | 'oz' | null;
+    shippingLengthValue?: number | null;
+    shippingWidthValue?: number | null;
+    shippingHeightValue?: number | null;
+    shippingDimensionUnit?: 'cm' | 'in' | null;
 }
 /**
  * Response from deleting a product
@@ -3643,6 +3671,10 @@ interface CreateCategoryDto {
     /** R2/S3 object key for `image`; powers asset-deletion cascade. */
     imageKey?: string;
     taxBehavior?: 'taxable' | 'exempt';
+    /** Merchant override for Google's numeric product taxonomy id (Merchant
+     *  Center `google_product_category`). Omit to let the name-based
+     *  auto-resolver assign one. */
+    googleTaxonomyId?: number;
 }
 interface UpdateCategoryDto {
     name?: string;
@@ -3652,6 +3684,10 @@ interface UpdateCategoryDto {
     /** R2/S3 object key for `image`; pass null to clear. */
     imageKey?: string | null;
     taxBehavior?: 'taxable' | 'exempt';
+    /** Merchant override for Google's numeric product taxonomy id. Pass a
+     *  valid id to pin it (protects it from auto-resolution forever); pass
+     *  `null` to clear the override and re-resolve automatically. */
+    googleTaxonomyId?: number | null;
 }
 /**
  * Brand entity for product organization
@@ -3888,6 +3924,14 @@ interface TaxonomyQueryParams {
 /**
  * Shipping zone with geographic restrictions
  */
+/** GeoJSON Polygon/MultiPolygon, [lng, lat] ring coordinates (RFC 7946). */
+type ShippingZoneGeometry = {
+    type: 'Polygon';
+    coordinates: number[][][];
+} | {
+    type: 'MultiPolygon';
+    coordinates: number[][][][];
+};
 interface ShippingZone {
     id: string;
     accountId: string;
@@ -3899,12 +3943,25 @@ interface ShippingZone {
     regions?: Record<string, string[]> | null;
     /** Postal code patterns */
     postalCodes?: Record<string, string[]> | null;
+    /**
+     * Polygon zone definition ("draw on map") — one or more hand-drawn shapes.
+     * Independent of countries/regions/postalCodes: a zone matches if the
+     * address satisfies *either* the country-list coverage *or* the polygon
+     * coverage, so both may be set on the same zone.
+     */
+    geometry?: ShippingZoneGeometry | null;
     /**
      * Region restriction (PRD §25). Region IDs this zone is limited to. Empty =
      * available for any region (default). Non-empty = the zone is only offered to
      * checkouts whose region is in the list.
      */
     regionIds: string[];
+    /**
+     * Sales-channel restriction. `SalesChannel.id` values. Empty = available
+     * on every channel (default). Non-empty = the zone is only offered to
+     * checkouts from a channel in the list.
+     */
+    salesChannelIds: string[];
     /** Zone priority (lower = higher priority) */
     priority: number;
     isActive: boolean;
@@ -3943,8 +4000,16 @@ interface CreateShippingZoneDto {
     countries: string[];
     regions?: Record<string, string[]>;
     postalCodes?: Record<string, string[]>;
+    /**
+     * Polygon zone definition ("draw on map") — one or more hand-drawn shapes,
+     * combined with countries/regions/postalCodes via OR (both may be set on
+     * the same zone).
+     */
+    geometry?: ShippingZoneGeometry;
     /** Region restriction (PRD §25). Region IDs; empty/omitted = any region. */
     regionIds?: string[];
+    /** Sales-channel restriction (SalesChannel.id, or vc_* connectionId). Empty/omitted = every channel. */
+    salesChannelIds?: string[];
     priority?: number;
     isActive?: boolean;
 }
@@ -3953,8 +4018,12 @@ interface UpdateShippingZoneDto {
     countries?: string[];
     regions?: Record<string, string[]> | null;
     postalCodes?: Record<string, string[]> | null;
+    /** Polygon zone definition ("draw on map"). Pass `null` to clear. Omit to leave unchanged. */
+    geometry?: ShippingZoneGeometry | null;
     /** Region restriction (PRD §25). Empty array = clear; omit = leave unchanged. */
     regionIds?: string[];
+    /** Sales-channel restriction. Empty array = clear (every channel); omit = leave unchanged. */
+    salesChannelIds?: string[];
     priority?: number;
     isActive?: boolean;
     platformSettings?: Record<string, unknown>;
@@ -4666,6 +4735,122 @@ interface UpdateEmailSettingsDto {
     hourlyRateLimit?: number;
     customDomainId?: string;
 }
+/** One FAQ entry the bot can answer from directly. */
+interface BotFaq {
+    q: string;
+    a: string;
+}
+/** Per-capability on/off toggles. */
+interface BotCapabilities {
+    productQa?: boolean;
+    recommendations?: boolean;
+    orderTracking?: boolean;
+    returns?: boolean;
+    cartRecovery?: boolean;
+    bundleNudges?: boolean;
+}
+/** Persona/behavior config — greeting, tone, starter questions, guardrails, capabilities. */
+interface PersonaConfig {
+    greeting?: string;
+    tone?: 'friendly' | 'formal' | 'playful' | 'concise';
+    accentColor?: string;
+    responseLength?: 'concise' | 'balanced' | 'detailed';
+    emoji?: boolean;
+    bubbleShape?: 'rounded' | 'square';
+    displayMode?: 'floating' | 'side_rail' | 'inline' | 'auto_open' | 'full_screen';
+    position?: 'start' | 'end';
+    allowExpand?: boolean;
+    /** Freeform merchant instructions injected into the bot's system prompt. */
+    customInstructions?: string;
+    faqs?: BotFaq[];
+    capabilities?: BotCapabilities;
+    languages?: ('en' | 'he' | 'ar' | 'es' | 'fr')[];
+    /** Starter questions shown as quick-reply chips before the shopper types. */
+    starterQuestions?: string[];
+    /** Freeform guardrail text — topics the bot should decline to discuss. */
+    avoidTopics?: string;
+    maxDiscountPct?: number | null;
+    minRecommend?: number | null;
+}
+/** One connection (SalesChannel) + its current (or default) bot settings. */
+interface BotSettings {
+    salesChannelId: string;
+    connectionId: string;
+    name: string;
+    enabled: boolean;
+    displayName: string;
+    avatarUrl: string | null;
+    personaJson: PersonaConfig;
+    escalationJson: Record<string, unknown>;
+    retentionJson: Record<string, unknown>;
+    localeJson: Record<string, unknown> | null;
+    dailySpendCeilingUsd: number | null;
+}
+interface BotSettingsConfigResponse {
+    connections: {
+        salesChannelId: string;
+        connectionId: string;
+        name: string;
+    }[];
+    settings: BotSettings[];
+}
+/** PATCH semantics — only fields present are changed. */
+interface UpdateBotSettingsDto {
+    salesChannelId: string;
+    enabled?: boolean;
+    displayName?: string;
+    avatarUrl?: string;
+    personaJson?: PersonaConfig;
+}
+interface BotConversationMessage {
+    id: string;
+    role: string;
+    content: string;
+    createdAt: string;
+}
+interface BotConversationListItem {
+    id: string;
+    salesChannelId: string;
+    title: string | null;
+    locale: string;
+    customerName: string | null;
+    lastMessage: {
+        role: string;
+        content: string;
+        createdAt: string;
+    } | null;
+    messageCount: number;
+    unread: boolean;
+    lastActivityAt: string;
+    createdAt: string;
+}
+interface BotConversationDetail {
+    id: string;
+    salesChannelId: string;
+    title: string | null;
+    locale: string;
+    customerName: string | null;
+    customerEmail: string | null;
+    merchantReadAt: string | null;
+    lastActivityAt: string;
+    createdAt: string;
+    messages: BotConversationMessage[];
+    /** Rolling summary from the most recent summarize() call, if any. */
+    summarizedHistory: string | null;
+}
+interface BotConversationsPage {
+    data: BotConversationListItem[];
+    meta: {
+        page: number;
+        limit: number;
+        total: number;
+        totalPages: number;
+    };
+}
+interface SummarizeBotConversationResult {
+    summarized: boolean;
+    summary: string | null;
+}
 /** Email template */
 interface EmailTemplate {
     id: string;
@@ -9891,6 +10076,38 @@ declare class BrainerceClient {
      * Requires Admin mode (apiKey)
      */
     updateEmailSettings(data: UpdateEmailSettingsDto): Promise<EmailSettings>;
+    /**
+     * Get Storefront Bot (AI Shopping Assistant) settings for every connection
+     * on the store — name, avatar, persona, starter questions, guardrails,
+     * capabilities. Requires Admin mode (apiKey).
+     */
+    getBotSettings(): Promise<BotSettingsConfigResponse>;
+    /**
+     * Create/update one connection's Storefront Bot settings. Only fields
+     * present in `data` are changed (PATCH semantics). Requires Admin mode
+     * (apiKey).
+     */
+    updateBotSettings(data: UpdateBotSettingsDto): Promise<BotSettings>;
+    /**
+     * Paginated Storefront Bot conversation inbox, optionally filtered to one
+     * connection. Requires Admin mode (apiKey).
+     */
+    listBotConversations(opts?: {
+        salesChannelId?: string;
+        page?: number;
+        limit?: number;
+    }): Promise<BotConversationsPage>;
+    /**
+     * Full transcript for one Storefront Bot conversation, including its
+     * summary if one was generated. Requires Admin mode (apiKey).
+     */
+    getBotConversation(conversationId: string): Promise<BotConversationDetail>;
+    /**
+     * Summarize a Storefront Bot conversation on demand and persist the
+     * summary. Short threads (10 or fewer messages) are a graceful no-op — no
+     * credits charged. Requires Admin mode (apiKey).
+     */
+    summarizeBotConversation(conversationId: string): Promise<SummarizeBotConversationResult>;
     /**
      * Get all email templates for the store, grouped by (eventType, language).
      * Response includes the store's primary language and supported languages so
@@ -10009,7 +10226,7 @@ declare class BrainerceError extends Error {
     constructor(message: string, statusCode: number, details?: unknown);
 }
 
-declare const SDK_VERSION = "1.42.0";
+declare const SDK_VERSION = "1.45.0";
 
 /**
  * Verify a webhook signature from Brainerce

package/dist/index.d.ts

@@ -1202,6 +1202,10 @@ interface CreateProductDto {
     name: string;
     slug?: string;
     sku?: string;
+    /** Global Trade Item Number (EAN/UPC/ISBN) — cross-platform identifier. */
+    gtin?: string;
+    /** Manufacturer Part Number — used by Google Shopping (with brand) when no GTIN exists. */
+    mpn?: string;
     description?: string;
     basePrice: number;
     salePrice?: number;
@@ -1219,11 +1223,26 @@ interface CreateProductDto {
     brandNames?: string[];
     tags?: string[];
     images?: ProductImage[];
+    /** Sale-price effective window (ISO 8601) — Google Merchant Center
+     *  sale_price_effective_date. Set both together, or neither applies. */
+    salePriceStartsAt?: string;
+    salePriceEndsAt?: string;
+    shippingWeightValue?: number;
+    shippingWeightUnit?: 'kg' | 'lb' | 'g' | 'oz';
+    shippingLengthValue?: number;
+    shippingWidthValue?: number;
+    shippingHeightValue?: number;
+    /** Unit shared by shippingLengthValue/shippingWidthValue/shippingHeightValue. */
+    shippingDimensionUnit?: 'cm' | 'in';
 }
 interface UpdateProductDto {
     name?: string;
     slug?: string;
     sku?: string;
+    /** Global Trade Item Number (EAN/UPC/ISBN). Pass `null` to clear. */
+    gtin?: string | null;
+    /** Manufacturer Part Number. Pass `null` to clear. */
+    mpn?: string | null;
     description?: string;
     basePrice?: number;
     salePrice?: number | null;
@@ -1240,6 +1259,15 @@ interface UpdateProductDto {
     brandNames?: string[];
     tags?: string[];
     images?: ProductImage[];
+    /** Sale-price effective window (ISO 8601). Pass `null` to clear either bound. */
+    salePriceStartsAt?: string | null;
+    salePriceEndsAt?: string | null;
+    shippingWeightValue?: number | null;
+    shippingWeightUnit?: 'kg' | 'lb' | 'g' | 'oz' | null;
+    shippingLengthValue?: number | null;
+    shippingWidthValue?: number | null;
+    shippingHeightValue?: number | null;
+    shippingDimensionUnit?: 'cm' | 'in' | null;
 }
 /**
  * Response from deleting a product
@@ -3643,6 +3671,10 @@ interface CreateCategoryDto {
     /** R2/S3 object key for `image`; powers asset-deletion cascade. */
     imageKey?: string;
     taxBehavior?: 'taxable' | 'exempt';
+    /** Merchant override for Google's numeric product taxonomy id (Merchant
+     *  Center `google_product_category`). Omit to let the name-based
+     *  auto-resolver assign one. */
+    googleTaxonomyId?: number;
 }
 interface UpdateCategoryDto {
     name?: string;
@@ -3652,6 +3684,10 @@ interface UpdateCategoryDto {
     /** R2/S3 object key for `image`; pass null to clear. */
     imageKey?: string | null;
     taxBehavior?: 'taxable' | 'exempt';
+    /** Merchant override for Google's numeric product taxonomy id. Pass a
+     *  valid id to pin it (protects it from auto-resolution forever); pass
+     *  `null` to clear the override and re-resolve automatically. */
+    googleTaxonomyId?: number | null;
 }
 /**
  * Brand entity for product organization
@@ -3888,6 +3924,14 @@ interface TaxonomyQueryParams {
 /**
  * Shipping zone with geographic restrictions
  */
+/** GeoJSON Polygon/MultiPolygon, [lng, lat] ring coordinates (RFC 7946). */
+type ShippingZoneGeometry = {
+    type: 'Polygon';
+    coordinates: number[][][];
+} | {
+    type: 'MultiPolygon';
+    coordinates: number[][][][];
+};
 interface ShippingZone {
     id: string;
     accountId: string;
@@ -3899,12 +3943,25 @@ interface ShippingZone {
     regions?: Record<string, string[]> | null;
     /** Postal code patterns */
     postalCodes?: Record<string, string[]> | null;
+    /**
+     * Polygon zone definition ("draw on map") — one or more hand-drawn shapes.
+     * Independent of countries/regions/postalCodes: a zone matches if the
+     * address satisfies *either* the country-list coverage *or* the polygon
+     * coverage, so both may be set on the same zone.
+     */
+    geometry?: ShippingZoneGeometry | null;
     /**
      * Region restriction (PRD §25). Region IDs this zone is limited to. Empty =
      * available for any region (default). Non-empty = the zone is only offered to
      * checkouts whose region is in the list.
      */
     regionIds: string[];
+    /**
+     * Sales-channel restriction. `SalesChannel.id` values. Empty = available
+     * on every channel (default). Non-empty = the zone is only offered to
+     * checkouts from a channel in the list.
+     */
+    salesChannelIds: string[];
     /** Zone priority (lower = higher priority) */
     priority: number;
     isActive: boolean;
@@ -3943,8 +4000,16 @@ interface CreateShippingZoneDto {
     countries: string[];
     regions?: Record<string, string[]>;
     postalCodes?: Record<string, string[]>;
+    /**
+     * Polygon zone definition ("draw on map") — one or more hand-drawn shapes,
+     * combined with countries/regions/postalCodes via OR (both may be set on
+     * the same zone).
+     */
+    geometry?: ShippingZoneGeometry;
     /** Region restriction (PRD §25). Region IDs; empty/omitted = any region. */
     regionIds?: string[];
+    /** Sales-channel restriction (SalesChannel.id, or vc_* connectionId). Empty/omitted = every channel. */
+    salesChannelIds?: string[];
     priority?: number;
     isActive?: boolean;
 }
@@ -3953,8 +4018,12 @@ interface UpdateShippingZoneDto {
     countries?: string[];
     regions?: Record<string, string[]> | null;
     postalCodes?: Record<string, string[]> | null;
+    /** Polygon zone definition ("draw on map"). Pass `null` to clear. Omit to leave unchanged. */
+    geometry?: ShippingZoneGeometry | null;
     /** Region restriction (PRD §25). Empty array = clear; omit = leave unchanged. */
     regionIds?: string[];
+    /** Sales-channel restriction. Empty array = clear (every channel); omit = leave unchanged. */
+    salesChannelIds?: string[];
     priority?: number;
     isActive?: boolean;
     platformSettings?: Record<string, unknown>;
@@ -4666,6 +4735,122 @@ interface UpdateEmailSettingsDto {
     hourlyRateLimit?: number;
     customDomainId?: string;
 }
+/** One FAQ entry the bot can answer from directly. */
+interface BotFaq {
+    q: string;
+    a: string;
+}
+/** Per-capability on/off toggles. */
+interface BotCapabilities {
+    productQa?: boolean;
+    recommendations?: boolean;
+    orderTracking?: boolean;
+    returns?: boolean;
+    cartRecovery?: boolean;
+    bundleNudges?: boolean;
+}
+/** Persona/behavior config — greeting, tone, starter questions, guardrails, capabilities. */
+interface PersonaConfig {
+    greeting?: string;
+    tone?: 'friendly' | 'formal' | 'playful' | 'concise';
+    accentColor?: string;
+    responseLength?: 'concise' | 'balanced' | 'detailed';
+    emoji?: boolean;
+    bubbleShape?: 'rounded' | 'square';
+    displayMode?: 'floating' | 'side_rail' | 'inline' | 'auto_open' | 'full_screen';
+    position?: 'start' | 'end';
+    allowExpand?: boolean;
+    /** Freeform merchant instructions injected into the bot's system prompt. */
+    customInstructions?: string;
+    faqs?: BotFaq[];
+    capabilities?: BotCapabilities;
+    languages?: ('en' | 'he' | 'ar' | 'es' | 'fr')[];
+    /** Starter questions shown as quick-reply chips before the shopper types. */
+    starterQuestions?: string[];
+    /** Freeform guardrail text — topics the bot should decline to discuss. */
+    avoidTopics?: string;
+    maxDiscountPct?: number | null;
+    minRecommend?: number | null;
+}
+/** One connection (SalesChannel) + its current (or default) bot settings. */
+interface BotSettings {
+    salesChannelId: string;
+    connectionId: string;
+    name: string;
+    enabled: boolean;
+    displayName: string;
+    avatarUrl: string | null;
+    personaJson: PersonaConfig;
+    escalationJson: Record<string, unknown>;
+    retentionJson: Record<string, unknown>;
+    localeJson: Record<string, unknown> | null;
+    dailySpendCeilingUsd: number | null;
+}
+interface BotSettingsConfigResponse {
+    connections: {
+        salesChannelId: string;
+        connectionId: string;
+        name: string;
+    }[];
+    settings: BotSettings[];
+}
+/** PATCH semantics — only fields present are changed. */
+interface UpdateBotSettingsDto {
+    salesChannelId: string;
+    enabled?: boolean;
+    displayName?: string;
+    avatarUrl?: string;
+    personaJson?: PersonaConfig;
+}
+interface BotConversationMessage {
+    id: string;
+    role: string;
+    content: string;
+    createdAt: string;
+}
+interface BotConversationListItem {
+    id: string;
+    salesChannelId: string;
+    title: string | null;
+    locale: string;
+    customerName: string | null;
+    lastMessage: {
+        role: string;
+        content: string;
+        createdAt: string;
+    } | null;
+    messageCount: number;
+    unread: boolean;
+    lastActivityAt: string;
+    createdAt: string;
+}
+interface BotConversationDetail {
+    id: string;
+    salesChannelId: string;
+    title: string | null;
+    locale: string;
+    customerName: string | null;
+    customerEmail: string | null;
+    merchantReadAt: string | null;
+    lastActivityAt: string;
+    createdAt: string;
+    messages: BotConversationMessage[];
+    /** Rolling summary from the most recent summarize() call, if any. */
+    summarizedHistory: string | null;
+}
+interface BotConversationsPage {
+    data: BotConversationListItem[];
+    meta: {
+        page: number;
+        limit: number;
+        total: number;
+        totalPages: number;
+    };
+}
+interface SummarizeBotConversationResult {
+    summarized: boolean;
+    summary: string | null;
+}
 /** Email template */
 interface EmailTemplate {
     id: string;
@@ -9891,6 +10076,38 @@ declare class BrainerceClient {
      * Requires Admin mode (apiKey)
      */
     updateEmailSettings(data: UpdateEmailSettingsDto): Promise<EmailSettings>;
+    /**
+     * Get Storefront Bot (AI Shopping Assistant) settings for every connection
+     * on the store — name, avatar, persona, starter questions, guardrails,
+     * capabilities. Requires Admin mode (apiKey).
+     */
+    getBotSettings(): Promise<BotSettingsConfigResponse>;
+    /**
+     * Create/update one connection's Storefront Bot settings. Only fields
+     * present in `data` are changed (PATCH semantics). Requires Admin mode
+     * (apiKey).
+     */
+    updateBotSettings(data: UpdateBotSettingsDto): Promise<BotSettings>;
+    /**
+     * Paginated Storefront Bot conversation inbox, optionally filtered to one
+     * connection. Requires Admin mode (apiKey).
+     */
+    listBotConversations(opts?: {
+        salesChannelId?: string;
+        page?: number;
+        limit?: number;
+    }): Promise<BotConversationsPage>;
+    /**
+     * Full transcript for one Storefront Bot conversation, including its
+     * summary if one was generated. Requires Admin mode (apiKey).
+     */
+    getBotConversation(conversationId: string): Promise<BotConversationDetail>;
+    /**
+     * Summarize a Storefront Bot conversation on demand and persist the
+     * summary. Short threads (10 or fewer messages) are a graceful no-op — no
+     * credits charged. Requires Admin mode (apiKey).
+     */
+    summarizeBotConversation(conversationId: string): Promise<SummarizeBotConversationResult>;
     /**
      * Get all email templates for the store, grouped by (eventType, language).
      * Response includes the store's primary language and supported languages so
@@ -10009,7 +10226,7 @@ declare class BrainerceError extends Error {
     constructor(message: string, statusCode: number, details?: unknown);
 }
 
-declare const SDK_VERSION = "1.42.0";
+declare const SDK_VERSION = "1.45.0";
 
 /**
  * Verify a webhook signature from Brainerce

package/dist/index.js

@@ -185,7 +185,7 @@ function isDevGuardsEnabled() {
 }
 
 // src/version.ts
-var SDK_VERSION = "1.42.0";
+var SDK_VERSION = "1.45.0";
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.brainerce.com";
@@ -5568,10 +5568,7 @@ var BrainerceClient = class {
         "order"
       );
     }
-    throw new BrainerceError(
-      "getOrderByCheckout() requires vibe-coded or storefront mode",
-      400
-    );
+    throw new BrainerceError("getOrderByCheckout() requires vibe-coded or storefront mode", 400);
   }
   /**
    * Check if localStorage is available (browser environment)
@@ -8392,6 +8389,55 @@ var BrainerceClient = class {
   async updateEmailSettings(data) {
     return this.adminRequest("PUT", "/api/v1/email/settings", data);
   }
+  /**
+   * Get Storefront Bot (AI Shopping Assistant) settings for every connection
+   * on the store — name, avatar, persona, starter questions, guardrails,
+   * capabilities. Requires Admin mode (apiKey).
+   */
+  async getBotSettings() {
+    return this.adminRequest("GET", "/api/v1/storefront-bot/settings");
+  }
+  /**
+   * Create/update one connection's Storefront Bot settings. Only fields
+   * present in `data` are changed (PATCH semantics). Requires Admin mode
+   * (apiKey).
+   */
+  async updateBotSettings(data) {
+    return this.adminRequest("PUT", "/api/v1/storefront-bot/settings", data);
+  }
+  /**
+   * Paginated Storefront Bot conversation inbox, optionally filtered to one
+   * connection. Requires Admin mode (apiKey).
+   */
+  async listBotConversations(opts) {
+    return this.adminRequest(
+      "GET",
+      "/api/v1/storefront-bot/conversations",
+      void 0,
+      opts
+    );
+  }
+  /**
+   * Full transcript for one Storefront Bot conversation, including its
+   * summary if one was generated. Requires Admin mode (apiKey).
+   */
+  async getBotConversation(conversationId) {
+    return this.adminRequest(
+      "GET",
+      `/api/v1/storefront-bot/conversations/${conversationId}`
+    );
+  }
+  /**
+   * Summarize a Storefront Bot conversation on demand and persist the
+   * summary. Short threads (10 or fewer messages) are a graceful no-op — no
+   * credits charged. Requires Admin mode (apiKey).
+   */
+  async summarizeBotConversation(conversationId) {
+    return this.adminRequest(
+      "POST",
+      `/api/v1/storefront-bot/conversations/${conversationId}/summarize`
+    );
+  }
   /**
    * Get all email templates for the store, grouped by (eventType, language).
    * Response includes the store's primary language and supported languages so

package/dist/index.mjs

@@ -115,7 +115,7 @@ function isDevGuardsEnabled() {
 }
 
 // src/version.ts
-var SDK_VERSION = "1.42.0";
+var SDK_VERSION = "1.45.0";
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.brainerce.com";
@@ -5498,10 +5498,7 @@ var BrainerceClient = class {
         "order"
       );
     }
-    throw new BrainerceError(
-      "getOrderByCheckout() requires vibe-coded or storefront mode",
-      400
-    );
+    throw new BrainerceError("getOrderByCheckout() requires vibe-coded or storefront mode", 400);
   }
   /**
    * Check if localStorage is available (browser environment)
@@ -8322,6 +8319,55 @@ var BrainerceClient = class {
   async updateEmailSettings(data) {
     return this.adminRequest("PUT", "/api/v1/email/settings", data);
   }
+  /**
+   * Get Storefront Bot (AI Shopping Assistant) settings for every connection
+   * on the store — name, avatar, persona, starter questions, guardrails,
+   * capabilities. Requires Admin mode (apiKey).
+   */
+  async getBotSettings() {
+    return this.adminRequest("GET", "/api/v1/storefront-bot/settings");
+  }
+  /**
+   * Create/update one connection's Storefront Bot settings. Only fields
+   * present in `data` are changed (PATCH semantics). Requires Admin mode
+   * (apiKey).
+   */
+  async updateBotSettings(data) {
+    return this.adminRequest("PUT", "/api/v1/storefront-bot/settings", data);
+  }
+  /**
+   * Paginated Storefront Bot conversation inbox, optionally filtered to one
+   * connection. Requires Admin mode (apiKey).
+   */
+  async listBotConversations(opts) {
+    return this.adminRequest(
+      "GET",
+      "/api/v1/storefront-bot/conversations",
+      void 0,
+      opts
+    );
+  }
+  /**
+   * Full transcript for one Storefront Bot conversation, including its
+   * summary if one was generated. Requires Admin mode (apiKey).
+   */
+  async getBotConversation(conversationId) {
+    return this.adminRequest(
+      "GET",
+      `/api/v1/storefront-bot/conversations/${conversationId}`
+    );
+  }
+  /**
+   * Summarize a Storefront Bot conversation on demand and persist the
+   * summary. Short threads (10 or fewer messages) are a graceful no-op — no
+   * credits charged. Requires Admin mode (apiKey).
+   */
+  async summarizeBotConversation(conversationId) {
+    return this.adminRequest(
+      "POST",
+      `/api/v1/storefront-bot/conversations/${conversationId}/summarize`
+    );
+  }
   /**
    * Get all email templates for the store, grouped by (eventType, language).
    * Response includes the store's primary language and supported languages so

package/package.json

@@ -1,81 +1,81 @@
-{
-  "name": "brainerce",
-  "version": "1.44.0",
-  "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",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "require": "./dist/index.js",
-      "import": "./dist/index.mjs"
-    },
-    "./bot": {
-      "types": "./dist/bot/index.d.ts",
-      "require": "./dist/bot/index.js",
-      "import": "./dist/bot/index.mjs"
-    }
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts && tsup src/bot/index.ts --format cjs,esm --dts --out-dir dist/bot && tsup src/bot/bootstrap.ts --format iife --minify --out-dir dist/bot",
-    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
-    "lint": "eslint \"src/**/*.ts\"",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "prepublishOnly": "pnpm build"
-  },
-  "keywords": [
-    "brainerce",
-    "e-commerce",
-    "ecommerce",
-    "sdk",
-    "vibe-coding",
-    "vibe-coded",
-    "ai-commerce",
-    "storefront",
-    "headless-commerce",
-    "multi-platform",
-    "shopify",
-    "tiktok",
-    "cursor",
-    "lovable",
-    "v0",
-    "cart",
-    "checkout",
-    "products",
-    "sync"
-  ],
-  "author": "Brainerce",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/brainerce/brainerce.git",
-    "directory": "packages/sdk"
-  },
-  "homepage": "https://brainerce.com",
-  "bugs": {
-    "url": "https://github.com/brainerce/brainerce/issues"
-  },
-  "devDependencies": {
-    "@types/node": "^25.0.3",
-    "@typescript-eslint/eslint-plugin": "^8.50.1",
-    "@typescript-eslint/parser": "^8.50.1",
-    "eslint": "^9.39.2",
-    "tsup": "^8.0.0",
-    "typescript": "^5.3.0",
-    "vitest": "^1.0.0"
-  },
-  "peerDependencies": {
-    "typescript": ">=4.7.0"
-  },
-  "peerDependenciesMeta": {
-    "typescript": {
-      "optional": true
-    }
-  }
-}
+{
+  "name": "brainerce",
+  "version": "1.45.0",
+  "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",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "import": "./dist/index.mjs"
+    },
+    "./bot": {
+      "types": "./dist/bot/index.d.ts",
+      "require": "./dist/bot/index.js",
+      "import": "./dist/bot/index.mjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts && tsup src/bot/index.ts --format cjs,esm --dts --out-dir dist/bot && tsup src/bot/bootstrap.ts --format iife --minify --out-dir dist/bot",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "lint": "eslint \"src/**/*.ts\"",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "pnpm build"
+  },
+  "keywords": [
+    "brainerce",
+    "e-commerce",
+    "ecommerce",
+    "sdk",
+    "vibe-coding",
+    "vibe-coded",
+    "ai-commerce",
+    "storefront",
+    "headless-commerce",
+    "multi-platform",
+    "shopify",
+    "tiktok",
+    "cursor",
+    "lovable",
+    "v0",
+    "cart",
+    "checkout",
+    "products",
+    "sync"
+  ],
+  "author": "Brainerce",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/brainerce/brainerce.git",
+    "directory": "packages/sdk"
+  },
+  "homepage": "https://brainerce.com",
+  "bugs": {
+    "url": "https://github.com/brainerce/brainerce/issues"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "@typescript-eslint/eslint-plugin": "^8.50.1",
+    "@typescript-eslint/parser": "^8.50.1",
+    "eslint": "^9.39.2",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
+  },
+  "peerDependencies": {
+    "typescript": ">=4.7.0"
+  },
+  "peerDependenciesMeta": {
+    "typescript": {
+      "optional": true
+    }
+  }
+}