@aifeatures/backend 0.5.3 → 0.5.5

package/dist/index.d.cts

@@ -2373,6 +2373,14 @@ type OrderSessionStatus = {
      * The postage portion of `amount_total`, for showing the buyer a breakdown (0 renders as 'Free' — a met free-shipping threshold). Null when no postage was charged or none was recorded; render no shipping row at all then.
      */
     shipping_total: number | null;
+    /**
+     * The tax portion of `amount_total`, in minor units. Already INSIDE it — never add the two. Render a tax row ONLY when `tax_behavior` is 'exclusive' (Stripe priced tax on top of the goods); under 'inclusive' or a declared rate the tax already sits inside the line prices, so a row for it shows the buyer money they never paid separately. 0 means no tax was charged or recorded.
+     */
+    tax_total: number;
+    /**
+     * What `tax_total` MEANS — 'exclusive': charged on top of the goods, so it earns its own receipt row; 'inclusive': already inside the prices. Null when the order recorded no behavior (an unreadable stored value also reports null rather than guessing).
+     */
+    tax_behavior: "inclusive" | "exclusive";
     currency: string;
     /**
      * What was bought — a receipt-style summary. Still no buyer PII.
@@ -2383,6 +2391,14 @@ type OrderSessionStatus = {
          */
         name: string;
         quantity: number;
+        /**
+         * What ONE unit cost, in minor units of `currency`, snapshotted at checkout — multiply by `quantity` for the line total. Absent on rows written before the field existed. It is a LINE figure: the per-line values need not sum to `amount_total`, which also carries postage, exclusive tax, and any promotion-code discount — render `amount_total` as the total paid rather than adding lines up.
+         */
+        unit_amount?: number;
+        /**
+         * The product's first image at checkout time — the confirmation page's per-line thumbnail, the same snapshot the merchant's order page renders. Absent on imageless products and on older rows: render a placeholder, never a broken image.
+         */
+        image_url?: string;
         /**
          * The product bought — a stable id for branching the confirmation page per product type (absent only on legacy orders).
          */

package/dist/index.d.ts

@@ -2373,6 +2373,14 @@ type OrderSessionStatus = {
      * The postage portion of `amount_total`, for showing the buyer a breakdown (0 renders as 'Free' — a met free-shipping threshold). Null when no postage was charged or none was recorded; render no shipping row at all then.
      */
     shipping_total: number | null;
+    /**
+     * The tax portion of `amount_total`, in minor units. Already INSIDE it — never add the two. Render a tax row ONLY when `tax_behavior` is 'exclusive' (Stripe priced tax on top of the goods); under 'inclusive' or a declared rate the tax already sits inside the line prices, so a row for it shows the buyer money they never paid separately. 0 means no tax was charged or recorded.
+     */
+    tax_total: number;
+    /**
+     * What `tax_total` MEANS — 'exclusive': charged on top of the goods, so it earns its own receipt row; 'inclusive': already inside the prices. Null when the order recorded no behavior (an unreadable stored value also reports null rather than guessing).
+     */
+    tax_behavior: "inclusive" | "exclusive";
     currency: string;
     /**
      * What was bought — a receipt-style summary. Still no buyer PII.
@@ -2383,6 +2391,14 @@ type OrderSessionStatus = {
          */
         name: string;
         quantity: number;
+        /**
+         * What ONE unit cost, in minor units of `currency`, snapshotted at checkout — multiply by `quantity` for the line total. Absent on rows written before the field existed. It is a LINE figure: the per-line values need not sum to `amount_total`, which also carries postage, exclusive tax, and any promotion-code discount — render `amount_total` as the total paid rather than adding lines up.
+         */
+        unit_amount?: number;
+        /**
+         * The product's first image at checkout time — the confirmation page's per-line thumbnail, the same snapshot the merchant's order page renders. Absent on imageless products and on older rows: render a placeholder, never a broken image.
+         */
+        image_url?: string;
         /**
          * The product bought — a stable id for branching the confirmation page per product type (absent only on legacy orders).
          */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aifeatures/backend",
-  "version": "0.5.3",
+  "version": "0.5.5",
   "description": "TypeScript API client for aifeatures backend",
   "type": "module",
   "main": "./dist/index.cjs",