@blamejs/blamejs-shop 0.3.8 → 0.3.9

package/CHANGELOG.md

@@ -8,6 +8,8 @@ upgrading across more than a few patches at a time.
 
 ## v0.3.x
 
+- v0.3.9 (2026-05-30) — **Automatic discounts now apply at checkout.** The automatic-discount rules you define in the admin console — an amount or percentage off a cart that meets a threshold — now reduce the order total at checkout. When a rule matches, the discount is applied (capped so it never exceeds the order subtotal) and shown in the quote the shopper pays; when no rule matches, or none are defined, the total is exactly as before, so a store that has not set up rules is unaffected. The admin screen for managing rules already shipped; this wires it through to the checkout quote and the charge. **Added:** *Automatic cart discounts at checkout* — When a cart matches a configured automatic-discount rule, the checkout reduces the order total by the rule's saving — capped to the order subtotal so the total is never negative — and the reduced amount is what the shopper is charged. With no matching rule, or no rules defined, the order total is unchanged, so the change stays invisible until you set rules up; any rule-engine error degrades to no discount rather than blocking checkout.
+
 - v0.3.8 (2026-05-30) — **Update the vendored blamejs runtime to v0.14.6.** Refreshes the vendored blamejs runtime from v0.14.5 to v0.14.6, a maintenance update. The createApp request-lifecycle security stack the shop composes — CSRF, fetch-metadata, body-parser, cookies, rate limiting — is unchanged in default behavior. v0.14.6 adds opt-in RFC 9457 problem+json and onDeny response hooks to the access-refusal middleware (defaults unchanged, so nothing the shop relies on shifts) and corrects a few internal export and bearer-scope paths. No operator action is required. **Changed:** *Vendored blamejs runtime updated to v0.14.6* — The pinned blamejs runtime moves from v0.14.5 to v0.14.6. The middleware the storefront and admin compose keeps its current default behavior; the release adds opt-in problem-details / onDeny response hooks to the refusal middleware and fixes internal export and bearer-scope paths. No behavior change for the shop.
 
 - v0.3.7 (2026-05-30) — **Shipping zones now apply at checkout.** The shipping zones you define in the admin console — per-region rates by destination, parcel weight, and order value — now drive the shipping options shown at checkout. When a cart's destination matches a zone, the shopper sees that zone's rates; when no zone matches, or none are defined, checkout falls back to the existing flat-rate table exactly as before, so a store that has not configured zones is entirely unaffected. A fully digital order is never quoted physical shipping. The admin screen for managing zones already shipped; this wires it through to the checkout quote. **Added:** *Zone-based shipping rates at checkout* — When a cart's destination matches a configured shipping zone, the checkout shipping quote uses that zone's rates — resolved by destination country and region, parcel weight, and order subtotal — instead of the flat-rate table. With no matching zone, or no zones defined, checkout returns the existing flat rates unchanged, so the change stays invisible until you set zones up; any lookup error degrades to the same flat fallback. A fully digital order (no shipping-requiring item) is never quoted physical shipping.

package/lib/asset-manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.3.8",
+  "version": "0.3.9",
   "assets": {
     "css/admin.css": {
       "integrity": "sha384-1SIn6oAf1DjECbRfKENZasdKHJiywGdXR58wn0hsFGcdVHzUmvfgMkEz5ANIAZJ3",

package/lib/checkout.js

@@ -146,6 +146,17 @@ function create(deps) {
   // server-authoritative computation the cart page renders, so the
   // "review your order" subtotal and the charged amount agree.
   var quantityDiscounts = deps.quantityDiscounts || null;
+  // Optional automatic-discount engine. When wired, the quote consults
+  // every operator-authored auto-discount rule against the resolved
+  // cart and reduces the subtotal by the matched savings (clamped to
+  // [0, subtotal] so a rule can never drive the order negative or
+  // charge more than the cart is worth). Disabled when absent — the
+  // discount is zero and every total is identical to the un-wired
+  // flow, so production stays unchanged until a rule is defined. Only
+  // subtotal-reducing savings feed `discount_minor`; a `free_shipping`
+  // rule's savings are a shipping concern and are left to the shipping
+  // primitive, not folded into the subtotal discount here.
+  var autoDiscount  = deps.autoDiscount || null;
 
   // Reprice a list of cart lines through the quantity-discount engine.
   // Returns a shallow copy with `unit_amount_minor` overwritten by the
@@ -179,6 +190,72 @@ function create(deps) {
     return out;
   }
 
+  // Resolve the automatic-discount effect for a priced cart. Builds
+  // the engine's cart shape from the resolved lines + subtotal, asks
+  // the engine which operator-authored rules apply, and returns the
+  // subtotal-reducing savings (clamped to [0, subtotal]) plus the
+  // per-rule breakdown the post-commit recorder replays.
+  //
+  // FALLBACK (zero regression): no engine wired, a non-finite or
+  // negative aggregate, an empty result, or ANY throw collapses to
+  // `{ discount_minor: 0, applied: [] }` — byte-identical to the
+  // un-wired flow. The engine is consulted but never trusted to keep
+  // the buy path alive.
+  //
+  // PAYMENT SAFETY: the returned discount is clamped to
+  // [0, subtotalMinor] so it can never be negative and never exceeds
+  // the subtotal — the order total can therefore never go negative,
+  // and a customer can never be charged less than zero or credited
+  // more than the cart is worth.
+  async function _resolveAutoDiscount(lines, subtotalMinor, customerId) {
+    if (!autoDiscount || typeof autoDiscount.evaluate !== "function") {
+      return { discount_minor: 0, applied: [] };
+    }
+    try {
+      var evalLines = [];
+      for (var i = 0; i < lines.length; i += 1) {
+        var l = lines[i];
+        evalLines.push({
+          sku:              l.sku,
+          quantity:         l.qty,
+          unit_price_minor: l.unit_amount_minor,
+        });
+      }
+      var res = await autoDiscount.evaluate({
+        cart: {
+          subtotal_minor: subtotalMinor,
+          lines:          evalLines,
+        },
+        customer_id: customerId || undefined,
+      });
+      var appliedRaw = res && Array.isArray(res.applied) ? res.applied : [];
+      var total   = 0;
+      var applied = [];
+      for (var j = 0; j < appliedRaw.length; j += 1) {
+        var entry = appliedRaw[j];
+        // A `free_shipping` rule's savings are a shipping reduction,
+        // not a subtotal discount — excluded so the subtotal-level
+        // `discount_minor` stays a pure subtotal reduction (the
+        // shipping primitive owns the shipping side).
+        if (!entry || entry.value_kind === "free_shipping") continue;
+        var s = entry.savings_minor;
+        if (!Number.isInteger(s) || s <= 0) continue;
+        total += s;
+        applied.push({ rule_slug: entry.rule_slug, savings_minor: s });
+      }
+      if (!Number.isFinite(total) || total <= 0) {
+        return { discount_minor: 0, applied: [] };
+      }
+      // Clamp to the subtotal floor: the discount can reduce the
+      // subtotal to zero but never past it.
+      if (total > subtotalMinor) total = subtotalMinor;
+      return { discount_minor: total, applied: applied };
+    } catch (_e) {
+      // Any engine failure -> no discount, never a 5xx on the buy path.
+      return { discount_minor: 0, applied: [] };
+    }
+  }
+
   // Validate a gift-card code against a priced quote: the card exists,
   // is active, not expired, and matches the order currency. Returns
   // the credit to apply (capped at the grand total so an order total
@@ -336,6 +413,33 @@ function create(deps) {
     });
   }
 
+  // Record each applied auto-discount rule against a committed order
+  // so the engine's redemption counter + event log reflect the use.
+  // Best-effort / drop-silent: the customer has already been charged
+  // (or the order is otherwise placed) by the time this runs, so a
+  // recording failure must NEVER fail or reverse the order. Each
+  // record is isolated in its own try/catch so one bad row can't stop
+  // the rest. No-op when the engine isn't wired or nothing applied.
+  async function _recordAutoDiscounts(quote, orderId, customerId) {
+    if (!autoDiscount || typeof autoDiscount.recordApplication !== "function") return;
+    var applied = quote && Array.isArray(quote.auto_discounts) ? quote.auto_discounts : [];
+    for (var i = 0; i < applied.length; i += 1) {
+      var a = applied[i];
+      if (!a || !a.rule_slug) continue;
+      try {
+        await autoDiscount.recordApplication({
+          rule_slug:     a.rule_slug,
+          order_id:      orderId,
+          savings_minor: a.savings_minor,
+          customer_id:   customerId || undefined,
+        });
+      } catch (_e) {
+        // drop-silent — by design: the order is already placed; a
+        // failed redemption record must not surface to the buyer.
+      }
+    }
+  }
+
   // Compose a quote from a cart + ship-to + (optional) selected
   // shipping service. Pure read — no DB writes.
   async function _buildQuote(input) {
@@ -390,10 +494,18 @@ function create(deps) {
     }
 
     var shippingMinor = selected ? selected.amount_minor : 0;
+
+    // Automatic discounts: consult the operator-authored rule engine
+    // (when wired) for the subtotal reduction this cart earns. The
+    // resolver clamps the result to [0, subtotal] and falls back to 0
+    // on any failure, so the total math below is identical to the
+    // un-wired flow whenever no rule applies.
+    var autoDisc = await _resolveAutoDiscount(lines, sub.amount_minor, c.customer_id || null);
+
     var totals = pricing.totals(c, lines, {
       tax_minor:      taxRow.tax_minor,
       shipping_minor: shippingMinor,
-      discount_minor: 0,
+      discount_minor: autoDisc.discount_minor,
     });
 
     return {
@@ -405,6 +517,10 @@ function create(deps) {
       shipping_rates:    ratesRow.services,
       selected_shipping: selected,
       totals:            totals,
+      // Per-rule breakdown that fed `totals.discount_minor`, replayed
+      // by confirm()'s post-commit recorder. Empty when no rule
+      // applied (or no engine wired).
+      auto_discounts:    autoDisc.applied,
     };
   }
 
@@ -499,6 +615,10 @@ function create(deps) {
         });
         if (gc) await _redeemGiftCard(gc, paidOrder.id);
         if (loy) await _redeemLoyalty(loy, loyaltyCustomerId, paidOrder.id);
+        // Best-effort: record the auto-discount redemptions against the
+        // placed order. Runs post-commit so a recording failure can't
+        // reverse an order that's already paid.
+        await _recordAutoDiscounts(quote, paidOrder.id, cartRow.customer_id || null);
         await cart.setStatus(quote.cart_id, "converted");
         var settled = await order.transition(paidOrder.id, "mark_paid", {
           reason: loy && !gc ? "loyalty:full" : "gift_card:full",
@@ -552,6 +672,10 @@ function create(deps) {
       // guard.
       if (gc) await _redeemGiftCard(gc, createdOrder.id);
       if (loy) await _redeemLoyalty(loy, loyaltyCustomerId, createdOrder.id);
+      // Best-effort: record the auto-discount redemptions against the
+      // placed order. Runs post-commit so a recording failure can't
+      // reverse or fail an order whose PaymentIntent already exists.
+      await _recordAutoDiscounts(quote, createdOrder.id, cartRow.customer_id || null);
 
       // Mark the cart converted so a refresh of the storefront
       // doesn't accidentally re-quote the same cart.

package/lib/storefront.js

@@ -7139,7 +7139,7 @@ function mount(router, deps) {
 
   // Compute the cart/checkout totals the shopper sees BEFORE paying.
   // Composes the SAME tax + shipping primitives the charge runs through
-  // (via checkout.quote, which prices tax against the post-discount
+  // (via checkout.quote, which prices tax against the pre-discount
   // subtotal + picks shipping rates for the destination), so the
   // displayed grand total agrees with what Stripe is later asked to
   // charge for that destination. Returns:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blamejs/blamejs-shop",
-  "version": "0.3.8",
+  "version": "0.3.9",
   "description": "Open-source framework built on blamejs. Vendored stack, zero npm runtime deps, PQC-first crypto, security-on by default.",
   "main": "lib/index.js",
   "scripts": {