@wocart/storefront 1.17.0 → 1.18.0

package/CHANGELOG.md

@@ -5,6 +5,21 @@ follows [semantic versioning](https://semver.org/): breaking changes ship only
 in a new major version, and an export is marked `@deprecated` for at least one
 minor release before a major removes it.
 
+## 1.18.0 — 2026-10-21
+
+The basket carries the offer a shopper chose for a line, so a quantity tier
+that two offers share is priced as the shopper picked it.
+
+### Added
+
+- `BasketLine.offerId` (optional): the offer chosen for the line. `addLine`
+  keeps it; a plain add to the line keeps the chosen offer, and a later explicit
+  choice replaces it. A stored offer survives a reload; a value that is not a
+  string is dropped.
+- `toOrderItems` and `BasketStore.toOrderItems()` send `offerId` with the line,
+  so checkout and cart validation receive the choice. A line that chose no offer
+  sends none.
+
 ## 1.17.0 — 2026-10-18
 
 ### Added

package/dist/basket.js

@@ -107,6 +107,7 @@ function sanitizeLine(raw, maxQuantity) {
         unitPrice: Number.isFinite(unitPrice) && unitPrice >= 0 ? unitPrice : 0,
         href: typeof line.href === "string" ? line.href : undefined,
         image: typeof line.image === "string" ? line.image : undefined,
+        offerId: typeof line.offerId === "string" && line.offerId ? line.offerId : undefined,
     };
 }
 function normalizeLines(lines, maxLines, maxQuantity) {
@@ -119,6 +120,8 @@ function normalizeLines(lines, maxLines, maxQuantity) {
             existing.variantLabel ??= line.variantLabel;
             existing.image ??= line.image;
             existing.href ??= line.href;
+            // The newest explicit choice of offer wins; a plain add keeps the one chosen.
+            existing.offerId = line.offerId ?? existing.offerId;
         }
         else {
             merged.set(key, { ...line });
@@ -143,6 +146,7 @@ export function toOrderItems(lines) {
         variantLabel: line.variantLabel ?? undefined,
         quantity: line.quantity,
         pricePerUnit: line.unitPrice,
+        ...(line.offerId !== undefined ? { offerId: line.offerId } : {}),
     }));
 }
 /**

package/dist/domain.d.ts

@@ -75,6 +75,7 @@ export declare const BasketLineSchema: z.ZodObject<{
     unitPrice: z.ZodNumber;
     href: z.ZodOptional<z.ZodString>;
     image: z.ZodOptional<z.ZodString>;
+    offerId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type BasketLine = z.infer<typeof BasketLineSchema>;
 /**
@@ -106,6 +107,7 @@ export declare const BasketSchema: z.ZodObject<{
         unitPrice: z.ZodNumber;
         href: z.ZodOptional<z.ZodString>;
         image: z.ZodOptional<z.ZodString>;
+        offerId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type Basket = z.infer<typeof BasketSchema>;

package/dist/domain.js

@@ -31,6 +31,11 @@ export const BasketLineSchema = z.object({
     unitPrice: z.number().finite().nonnegative(),
     href: z.string().min(1).optional(),
     image: z.string().min(1).optional(),
+    /**
+     * The offer the shopper chose for this line, when they picked a tier. The
+     * server still applies it only if it holds for the quantity.
+     */
+    offerId: z.string().min(1).max(200).optional(),
 });
 /**
  * The server-facing projection of a basket line. UI-only fields are omitted,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wocart/storefront",
-  "version": "1.17.0",
+  "version": "1.18.0",
   "description": "Typed, validated SDK for Wocart cash-on-delivery storefronts: catalog reads, basket, checkout, OTP and order tracking, with Astro adapters.",
   "keywords": [
     "wocart",