brainerce 1.12.0 → 1.14.0

package/dist/index.d.mts

@@ -1371,10 +1371,19 @@ interface CartItem {
      */
     unitPrice: string;
     /**
-     * Discount amount applied to this item as a string.
+     * Discount amount applied to this item as a string (from discount rules).
      * Use parseFloat() for calculations.
      */
     discountAmount: string;
+    /**
+     * Promo discount amount from bundle offers or order bumps as a string.
+     * Use parseFloat() for calculations.
+     */
+    promoDiscountAmount: string;
+    /** Promo source: "BUNDLE" or "ORDER_BUMP", null if no promo */
+    promoSource?: string | null;
+    /** ID of the BundleOffer or OrderBumpConfig that gave this discount */
+    promoSourceId?: string | null;
     /** Optional notes for this line item */
     notes?: string | null;
     /** Optional metadata for this line item */
@@ -1459,6 +1468,8 @@ interface Cart {
     couponCode?: string | null;
     /** Discount amount from automatic rules only (before coupon) */
     ruleDiscountAmount?: string;
+    /** Total promo discount from bundle offers and order bumps */
+    promoDiscountTotal?: string;
     /** Automatic discounts applied by discount rules */
     appliedDiscounts?: CartAppliedDiscount[];
     /** Nudges for nearly-qualifying discount rules */
@@ -2443,8 +2454,8 @@ interface CustomApiTestResult {
  * The frontend dynamically loads the SDK script and calls init/render methods.
  */
 interface PaymentClientSdk {
-    /** How the payment UI is rendered: 'sdk-widget' (JS SDK), 'iframe', or 'redirect' */
-    renderType: 'sdk-widget' | 'iframe' | 'redirect';
+    /** How the payment UI is rendered: 'sdk-widget' (JS SDK), 'iframe', 'redirect', or 'sandbox' (test orders) */
+    renderType: 'sdk-widget' | 'iframe' | 'redirect' | 'sandbox';
     /** URL of the main SDK script to load */
     scriptUrl?: string;
     /** Name of the global variable set by the SDK script (e.g., 'growPayment') */
@@ -4917,6 +4928,28 @@ declare class BrainerceClient {
      * @returns Updated cart
      */
     removeOrderBump(cartId: string, bumpConfigId: string): Promise<Cart>;
+    /**
+     * Add a bundle offer product to the cart with its discount applied.
+     *
+     * @param cartId - Cart ID
+     * @param bundleOfferId - Bundle offer ID
+     * @returns Updated cart
+     *
+     * @example
+     * ```typescript
+     * const { bundles } = await client.getCartBundles('cart_123');
+     * const cart = await client.addBundleToCart('cart_123', bundles[0].id);
+     * ```
+     */
+    addBundleToCart(cartId: string, bundleOfferId: string): Promise<Cart>;
+    /**
+     * Remove a bundle offer product from the cart.
+     *
+     * @param cartId - Cart ID
+     * @param bundleOfferId - Bundle offer ID
+     * @returns Updated cart
+     */
+    removeBundleFromCart(cartId: string, bundleOfferId: string): Promise<Cart>;
     /**
      * Check if customer is currently authenticated
      * Used internally by smart cart methods to determine storage strategy

package/dist/index.d.ts

@@ -1371,10 +1371,19 @@ interface CartItem {
      */
     unitPrice: string;
     /**
-     * Discount amount applied to this item as a string.
+     * Discount amount applied to this item as a string (from discount rules).
      * Use parseFloat() for calculations.
      */
     discountAmount: string;
+    /**
+     * Promo discount amount from bundle offers or order bumps as a string.
+     * Use parseFloat() for calculations.
+     */
+    promoDiscountAmount: string;
+    /** Promo source: "BUNDLE" or "ORDER_BUMP", null if no promo */
+    promoSource?: string | null;
+    /** ID of the BundleOffer or OrderBumpConfig that gave this discount */
+    promoSourceId?: string | null;
     /** Optional notes for this line item */
     notes?: string | null;
     /** Optional metadata for this line item */
@@ -1459,6 +1468,8 @@ interface Cart {
     couponCode?: string | null;
     /** Discount amount from automatic rules only (before coupon) */
     ruleDiscountAmount?: string;
+    /** Total promo discount from bundle offers and order bumps */
+    promoDiscountTotal?: string;
     /** Automatic discounts applied by discount rules */
     appliedDiscounts?: CartAppliedDiscount[];
     /** Nudges for nearly-qualifying discount rules */
@@ -2443,8 +2454,8 @@ interface CustomApiTestResult {
  * The frontend dynamically loads the SDK script and calls init/render methods.
  */
 interface PaymentClientSdk {
-    /** How the payment UI is rendered: 'sdk-widget' (JS SDK), 'iframe', or 'redirect' */
-    renderType: 'sdk-widget' | 'iframe' | 'redirect';
+    /** How the payment UI is rendered: 'sdk-widget' (JS SDK), 'iframe', 'redirect', or 'sandbox' (test orders) */
+    renderType: 'sdk-widget' | 'iframe' | 'redirect' | 'sandbox';
     /** URL of the main SDK script to load */
     scriptUrl?: string;
     /** Name of the global variable set by the SDK script (e.g., 'growPayment') */
@@ -4917,6 +4928,28 @@ declare class BrainerceClient {
      * @returns Updated cart
      */
     removeOrderBump(cartId: string, bumpConfigId: string): Promise<Cart>;
+    /**
+     * Add a bundle offer product to the cart with its discount applied.
+     *
+     * @param cartId - Cart ID
+     * @param bundleOfferId - Bundle offer ID
+     * @returns Updated cart
+     *
+     * @example
+     * ```typescript
+     * const { bundles } = await client.getCartBundles('cart_123');
+     * const cart = await client.addBundleToCart('cart_123', bundles[0].id);
+     * ```
+     */
+    addBundleToCart(cartId: string, bundleOfferId: string): Promise<Cart>;
+    /**
+     * Remove a bundle offer product from the cart.
+     *
+     * @param cartId - Cart ID
+     * @param bundleOfferId - Bundle offer ID
+     * @returns Updated cart
+     */
+    removeBundleFromCart(cartId: string, bundleOfferId: string): Promise<Cart>;
     /**
      * Check if customer is currently authenticated
      * Used internally by smart cart methods to determine storage strategy

package/dist/index.js

@@ -2519,6 +2519,44 @@ var BrainerceClient = class {
     }
     throw new BrainerceError("removeOrderBump() requires vibe-coded or storefront mode", 400);
   }
+  /**
+   * Add a bundle offer product to the cart with its discount applied.
+   *
+   * @param cartId - Cart ID
+   * @param bundleOfferId - Bundle offer ID
+   * @returns Updated cart
+   *
+   * @example
+   * ```typescript
+   * const { bundles } = await client.getCartBundles('cart_123');
+   * const cart = await client.addBundleToCart('cart_123', bundles[0].id);
+   * ```
+   */
+  async addBundleToCart(cartId, bundleOfferId) {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("POST", `/cart/${cartId}/bundle`, { bundleOfferId });
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("POST", `/cart/${cartId}/bundle`, { bundleOfferId });
+    }
+    throw new BrainerceError("addBundleToCart() requires vibe-coded or storefront mode", 400);
+  }
+  /**
+   * Remove a bundle offer product from the cart.
+   *
+   * @param cartId - Cart ID
+   * @param bundleOfferId - Bundle offer ID
+   * @returns Updated cart
+   */
+  async removeBundleFromCart(cartId, bundleOfferId) {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("DELETE", `/cart/${cartId}/bundle/${bundleOfferId}`);
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("DELETE", `/cart/${cartId}/bundle/${bundleOfferId}`);
+    }
+    throw new BrainerceError("removeBundleFromCart() requires vibe-coded or storefront mode", 400);
+  }
   // -------------------- Smart Cart (Auto-sync) --------------------
   /**
    * Check if customer is currently authenticated
@@ -3822,6 +3860,9 @@ var BrainerceClient = class {
         quantity: item.quantity,
         unitPrice: item.price || "0",
         discountAmount: "0",
+        promoDiscountAmount: "0",
+        promoSource: null,
+        promoSourceId: null,
         notes: null,
         metadata: null,
         product: {

package/dist/index.mjs

@@ -2459,6 +2459,44 @@ var BrainerceClient = class {
     }
     throw new BrainerceError("removeOrderBump() requires vibe-coded or storefront mode", 400);
   }
+  /**
+   * Add a bundle offer product to the cart with its discount applied.
+   *
+   * @param cartId - Cart ID
+   * @param bundleOfferId - Bundle offer ID
+   * @returns Updated cart
+   *
+   * @example
+   * ```typescript
+   * const { bundles } = await client.getCartBundles('cart_123');
+   * const cart = await client.addBundleToCart('cart_123', bundles[0].id);
+   * ```
+   */
+  async addBundleToCart(cartId, bundleOfferId) {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("POST", `/cart/${cartId}/bundle`, { bundleOfferId });
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("POST", `/cart/${cartId}/bundle`, { bundleOfferId });
+    }
+    throw new BrainerceError("addBundleToCart() requires vibe-coded or storefront mode", 400);
+  }
+  /**
+   * Remove a bundle offer product from the cart.
+   *
+   * @param cartId - Cart ID
+   * @param bundleOfferId - Bundle offer ID
+   * @returns Updated cart
+   */
+  async removeBundleFromCart(cartId, bundleOfferId) {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("DELETE", `/cart/${cartId}/bundle/${bundleOfferId}`);
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("DELETE", `/cart/${cartId}/bundle/${bundleOfferId}`);
+    }
+    throw new BrainerceError("removeBundleFromCart() requires vibe-coded or storefront mode", 400);
+  }
   // -------------------- Smart Cart (Auto-sync) --------------------
   /**
    * Check if customer is currently authenticated
@@ -3762,6 +3800,9 @@ var BrainerceClient = class {
         quantity: item.quantity,
         unitPrice: item.price || "0",
         discountAmount: "0",
+        promoDiscountAmount: "0",
+        promoSource: null,
+        promoSourceId: null,
         notes: null,
         metadata: null,
         product: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brainerce",
-  "version": "1.12.0",
+  "version": "1.14.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",