brainerce 1.36.3 → 1.36.4

package/README.md

@@ -2206,7 +2206,8 @@ interface Checkout {
   subtotal: string;
   discountAmount: string;
   shippingAmount: string;
-  taxAmount: string;
+  taxAmount: string;          // "0" in inclusive (VAT) mode — see taxBreakdown.totalTax
+  taxBreakdown?: TaxBreakdown | null; // { totalTax, pricesIncludeTax, breakdown[] }
   total: string;
   couponCode?: string | null;
   items: CheckoutLineItem[];

package/dist/index.d.mts

@@ -1139,8 +1139,15 @@ interface Order {
     }> | null;
     /** Shipping cost */
     shippingAmount?: string | null;
-    /** Tax amount */
+    /** Tax amount. In inclusive (VAT) mode this is `"0"` — read the included VAT
+     *  from {@link Order.taxBreakdown}.totalTax instead. */
     taxAmount?: string | null;
+    /**
+     * Frozen tax breakdown snapshot. In inclusive (VAT) pricing `taxAmount` is 0
+     * and the real VAT lives here (`taxBreakdown.totalTax`, with
+     * `pricesIncludeTax: true`). Use it to display "incl. VAT" on receipts.
+     */
+    taxBreakdown?: TaxBreakdown | null;
     createdAt: string;
     /** Payment method used (e.g., "card", "paypal", "cash_on_delivery"). */
     paymentMethod?: string | null;
@@ -2204,6 +2211,12 @@ interface TaxBreakdown {
     total: number;
     /** Itemized tax breakdown */
     breakdown: TaxBreakdownItem[];
+    /**
+     * True when the store's prices already include tax (inclusive/VAT mode). In
+     * that mode `totalTax` is the VAT backed out of the displayed price — it is
+     * already part of `total`, not added on top. Display it as "incl. VAT".
+     */
+    pricesIncludeTax?: boolean;
     /** Currency code */
     currency?: string;
 }

package/dist/index.d.ts

@@ -1139,8 +1139,15 @@ interface Order {
     }> | null;
     /** Shipping cost */
     shippingAmount?: string | null;
-    /** Tax amount */
+    /** Tax amount. In inclusive (VAT) mode this is `"0"` — read the included VAT
+     *  from {@link Order.taxBreakdown}.totalTax instead. */
     taxAmount?: string | null;
+    /**
+     * Frozen tax breakdown snapshot. In inclusive (VAT) pricing `taxAmount` is 0
+     * and the real VAT lives here (`taxBreakdown.totalTax`, with
+     * `pricesIncludeTax: true`). Use it to display "incl. VAT" on receipts.
+     */
+    taxBreakdown?: TaxBreakdown | null;
     createdAt: string;
     /** Payment method used (e.g., "card", "paypal", "cash_on_delivery"). */
     paymentMethod?: string | null;
@@ -2204,6 +2211,12 @@ interface TaxBreakdown {
     total: number;
     /** Itemized tax breakdown */
     breakdown: TaxBreakdownItem[];
+    /**
+     * True when the store's prices already include tax (inclusive/VAT mode). In
+     * that mode `totalTax` is the VAT backed out of the displayed price — it is
+     * already part of `total`, not added on top. Display it as "incl. VAT".
+     */
+    pricesIncludeTax?: boolean;
     /** Currency code */
     currency?: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brainerce",
-  "version": "1.36.3",
+  "version": "1.36.4",
   "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",