@nextcommerce/campaigns-os 1.61.0 → 1.62.0

package/campaign-spec/dist/rules/checkout-path-has-packages.js

@@ -0,0 +1,79 @@
+/**
+ * CheckoutPathHasPackages — every path from an entry page to a Checkout passes
+ * at least one page that sells a main-cart package (campaigns-os#711, #206).
+ *
+ * A Checkout the shopper reaches with nothing in the cart cannot take an
+ * order, and until this rule nothing said so before a test order failed. The
+ * selling page may be any page on the path up to and including the Checkout:
+ * a select page's bundle picker, a landing page's package cards, a checkout
+ * step, or the Checkout's own selector. So the rule counts per path, never per
+ * page: a Checkout with no packages of its own passes when every path into it
+ * sells first.
+ *
+ * "Main-cart package" is the ratified #206 contract (checkout-flow.ts
+ * `isMainCartPackage`, docs/template-family-contracts.md "Main-cart entry"):
+ * an entry with neither `is_upsell: true` nor `is_order_bump: true`. Bump rows
+ * alone sell nothing, `default_selected` never changes the role, and entries
+ * on upsell, downsell or thank-you pages never count.
+ *
+ * Paths are walked the way OneCheckoutPerPath walks them: both edges a page
+ * can traverse (routing.ts), starting at the funnel's entry pages
+ * (checkout-flow.ts `entryPages`). No page order or name is consulted. The
+ * search runs, per entry page, over (page, sold yet) states and stops at the
+ * first Checkout, so each empty Checkout is reported once per entry however
+ * many of that entry's paths reach it. A second Checkout on one path is
+ * OneCheckoutPerPath's to report.
+ *
+ * With build_scope.mode === 'partial' the finding is a warning: a partial
+ * build may ship a Checkout that a page outside the build fills.
+ */
+import { outgoingEdgeIds } from "../routing.js";
+import { entryPages, isPaymentPage, resolveRouteTargetPage, sellsMainCartPackage } from "../checkout-flow.js";
+export const CheckoutPathHasPackages = {
+    id: 'CheckoutPathHasPackages',
+    severity: 'error',
+    tags: ['structure', 'spec-only'],
+    check(spec) {
+        const violations = [];
+        const partial = spec.build_scope?.mode === 'partial';
+        spec.funnels.forEach((funnel, funnelIdx) => {
+            const pages = (funnel.pages ?? []).filter((page) => page && page.enabled !== false);
+            const indexOf = new Map();
+            (funnel.pages ?? []).forEach((page, idx) => indexOf.set(page, idx));
+            for (const entry of entryPages(funnel)) {
+                const seen = new Set();
+                const reported = new Set();
+                const stack = [[entry, false]];
+                while (stack.length) {
+                    const [page, before] = stack.pop();
+                    const sold = before || sellsMainCartPackage(page);
+                    const key = `${indexOf.get(page)}:${sold}`;
+                    if (seen.has(key))
+                        continue;
+                    seen.add(key);
+                    if (isPaymentPage(page)) {
+                        if (!sold && !reported.has(page)) {
+                            reported.add(page);
+                            violations.push({
+                                ruleId: 'CheckoutPathHasPackages',
+                                severity: partial ? 'warning' : 'error',
+                                message: `A path from entry page "${entry.id}" reaches Checkout "${page.id}" without passing a page that sells a main-cart package, so the cart is empty and no order can be placed. ` +
+                                    'Add a package entry not marked is_upsell or is_order_bump to the Checkout or a page before it on this path.' +
+                                    (partial ? ' Valid for partial builds when a page outside this build fills the cart.' : ''),
+                                path: `/funnels/${funnelIdx}/pages/${indexOf.get(page)}`,
+                                data: { pageId: page.id, entryPageId: entry.id, isPartialScope: partial },
+                            });
+                        }
+                        continue;
+                    }
+                    for (const target of outgoingEdgeIds(page)) {
+                        const next = resolveRouteTargetPage(pages, target);
+                        if (next)
+                            stack.push([next, sold]);
+                    }
+                }
+            }
+        });
+        return violations;
+    },
+};

package/campaign-spec/dist/rules/index.d.ts

@@ -35,11 +35,13 @@ export { CheckoutForwardTarget } from './checkout-forward-target.ts';
 export { PrePaymentForwardTarget } from './pre-payment-forward-target.ts';
 export { CheckoutStepReachesCheckout } from './checkout-step-reaches-checkout.ts';
 export { OneCheckoutPerPath } from './one-checkout-per-path.ts';
+export { CheckoutPathHasPackages } from './checkout-path-has-packages.ts';
 export { UpsellWithoutCheckout } from './upsell-without-checkout.ts';
 export { DownsellWithoutUpsell } from './downsell-without-upsell.ts';
 export { PackagePricingSanity } from './package-pricing-sanity.ts';
 export { ShippingMethodsPresent } from './shipping-methods-present.ts';
 export { ShippingCountriesShape } from './shipping-countries-shape.ts';
+export { CampaignCurrencies } from './campaign-currencies.ts';
 export { OfferRefIntegrity } from './offer-ref-integrity.ts';
 export { ExitIntentValidation } from './exit-intent-validation.ts';
 export { PromoCodeInputValidation } from './promo-code-input-validation.ts';

package/campaign-spec/dist/rules/index.js

@@ -34,11 +34,13 @@ import { CheckoutForwardTarget } from "./checkout-forward-target.js";
 import { PrePaymentForwardTarget } from "./pre-payment-forward-target.js";
 import { CheckoutStepReachesCheckout } from "./checkout-step-reaches-checkout.js";
 import { OneCheckoutPerPath } from "./one-checkout-per-path.js";
+import { CheckoutPathHasPackages } from "./checkout-path-has-packages.js";
 import { UpsellWithoutCheckout } from "./upsell-without-checkout.js";
 import { DownsellWithoutUpsell } from "./downsell-without-upsell.js";
 import { CampaignMetadata } from "./campaign-metadata.js";
 import { ShippingMethodsPresent } from "./shipping-methods-present.js";
 import { ShippingCountriesShape } from "./shipping-countries-shape.js";
+import { CampaignCurrencies } from "./campaign-currencies.js";
 import { PackagePricingSanity } from "./package-pricing-sanity.js";
 import { OfferRefIntegrity } from "./offer-ref-integrity.js";
 import { ExitIntentValidation } from "./exit-intent-validation.js";
@@ -69,11 +71,13 @@ export { CheckoutForwardTarget } from "./checkout-forward-target.js";
 export { PrePaymentForwardTarget } from "./pre-payment-forward-target.js";
 export { CheckoutStepReachesCheckout } from "./checkout-step-reaches-checkout.js";
 export { OneCheckoutPerPath } from "./one-checkout-per-path.js";
+export { CheckoutPathHasPackages } from "./checkout-path-has-packages.js";
 export { UpsellWithoutCheckout } from "./upsell-without-checkout.js";
 export { DownsellWithoutUpsell } from "./downsell-without-upsell.js";
 export { PackagePricingSanity } from "./package-pricing-sanity.js";
 export { ShippingMethodsPresent } from "./shipping-methods-present.js";
 export { ShippingCountriesShape } from "./shipping-countries-shape.js";
+export { CampaignCurrencies } from "./campaign-currencies.js";
 export { OfferRefIntegrity } from "./offer-ref-integrity.js";
 export { ExitIntentValidation } from "./exit-intent-validation.js";
 export { PromoCodeInputValidation } from "./promo-code-input-validation.js";
@@ -114,11 +118,13 @@ export const allRules = [
     PrePaymentForwardTarget,
     CheckoutStepReachesCheckout,
     OneCheckoutPerPath,
+    CheckoutPathHasPackages,
     UpsellWithoutCheckout,
     DownsellWithoutUpsell,
     PackagePricingSanity,
     ShippingMethodsPresent,
     ShippingCountriesShape,
+    CampaignCurrencies,
     OfferRefIntegrity,
     ExitIntentValidation,
     PromoCodeInputValidation,

package/campaign-spec/dist/types.d.ts

@@ -519,12 +519,17 @@ export interface Campaign {
  *
  * Modeled on real production-funnel usage, NOT the idealized "SDK fires the
  * canonical dl_* set" view. The field reality the block must express:
- *   - Events fire from three sources: SDK auto, SDK-blocked-then-manual
- *     (`blockedEvents` suppresses the SDK event, a side script re-fires it via
- *     raw fbq/gtag to control timing), and fully out-of-band pixels loaded via
- *     GTM (Everflow / TriplePixel / Northbeam / RudderStack) that never touch
- *     the dataLayer. So outbound pixel fires — not dataLayer events — are the
- *     QA source of truth.
+ *   - Events reach vendors four ways: SDK providers (`providers`: GTM, Meta,
+ *     RudderStack, a custom endpoint, configured through config.js);
+ *     SDK-blocked-then-manual (`blockedEvents` suppresses the SDK event, a
+ *     side script re-fires it via raw fbq/gtag to control timing); the starter
+ *     templates' vendor adapters (`vendors`: GA4, Axon, Taboola, Triple Whale,
+ *     TikTok, Northbeam, Snapchat, Pinterest, switched on by a campaigns.json
+ *     key, riding the SDK's dl_* stream through the template forwarder); and
+ *     out-of-band pixels a merchant loads some other way, typically through
+ *     their own GTM container (`out_of_band_pixels`, e.g. Everflow), which
+ *     never touch the dataLayer. So outbound pixel fires, not dataLayer
+ *     events, are the QA source of truth.
  *   - A custom provider may carry an endpoint + transform (cookie injection).
  *   - Querystring params split into two classes: CONTENT (param.* → visibility
  *     via data-next-hide) and TRACKING (utm params, gclid, fbclid, subN, click-ids that
@@ -549,8 +554,33 @@ export interface AnalyticsProvider {
     blockedEvents?: string[];
     [key: string]: unknown;
 }
-/** A pixel/tag fired OUTSIDE the SDK (via GTM or a raw snippet) — QA must still
- * expect it on a live run even though it never appears in the dataLayer. */
+/**
+ * One starter-template vendor adapter, keyed in `analytics.vendors` by the
+ * vendor key (ga4 | axon | taboola | triplewhale | tiktok | northbeam | snap |
+ * pinterest; registry: analytics-vendors.ts). This is the shape the Map
+ * Builder emits; its spec compiler writes the matching flat keys into the
+ * campaign's `_data/campaigns.json` entry, and `spec derive` mirrors the id
+ * back from there.
+ */
+export interface AnalyticsVendor {
+    /** false turns the vendor off (no campaigns.json key is compiled). */
+    enabled?: boolean;
+    /** The vendor id: the value of the vendor's campaigns.json id key (`ga4_id`, `triplewhale_name`, …). */
+    id?: string;
+    /** Triple Whale only: `triplewhale_platform` (e.g. SHOPIFY). The template default, custom-msp, is omitted. */
+    platform?: string;
+    /** Turns on the vendor's identity / advanced-matching flag (raw email and phone; the `*_enabled` key). */
+    identityEnabled?: boolean;
+    /** dl_* events the adapter forwards (`<vendor>_allowed_events`); absent means all. */
+    allowedEvents?: string[];
+    /** dl_* events the adapter drops (`<vendor>_blocked_events`), e.g. purchases on a Shop Sync store. */
+    blockedEvents?: string[];
+    [key: string]: unknown;
+}
+/** A pixel/tag fired OUTSIDE the SDK and the template adapters (via the
+ * merchant's GTM container or a raw snippet). QA must still expect it on a
+ * live run even though it never appears in the dataLayer. A vendor the starter
+ * templates ship an adapter for belongs in `vendors`, not here. */
 export interface OutOfBandPixel {
     vendor: string;
     loaded_via?: 'gtm' | 'script' | (string & {});
@@ -595,9 +625,13 @@ export interface UtmTransfer {
     excludedDomains?: string[];
 }
 export interface AnalyticsContract {
+    /** false turns the whole contract off, as mode "disabled" does. */
+    enabled?: boolean;
     mode?: AnalyticsMode;
-    /** Keyed by provider kind: gtm | facebook | rudderstack | custom | … */
+    /** SDK providers, keyed by provider kind: gtm | facebook | rudderstack | custom | … */
     providers?: Record<string, AnalyticsProvider>;
+    /** Starter-template vendor adapters, keyed by vendor key (see AnalyticsVendor). */
+    vendors?: Record<string, AnalyticsVendor>;
     out_of_band_pixels?: OutOfBandPixel[];
     manual_events?: ManualEvent[];
     utmTransfer?: UtmTransfer;

package/compatibility.json

@@ -1,6 +1,6 @@
 {
   "package": "@nextcommerce/campaigns-os",
-  "version": "1.61.0",
+  "version": "1.62.0",
   "status": "developer-preview",
   "contracts": {
     "campaign_spec": "4.2-5.0",

package/contracts/commerce-surface-catalog.json

@@ -93,20 +93,18 @@
       "agentRule": "Replace starter refs from the target CampaignSpec/API. Remove optional bump surfaces when the referenced prepurchase package is absent."
     },
     "shipping_methods": {
-      "purpose": "Named Campaigns App shipping method ref_ids used by checkout selector cards.",
+      "purpose": "Named Campaigns App shipping method ref_ids used by checkout selector cards. Starter checkouts use ONE method (the campaign's single storefront method, priced at the highest tier rate) on every card.",
       "canonicalKeys": [
-        "standard",
-        "free"
+        "standard"
       ],
       "sourceOfTruth": [
         "CampaignSpec shipping_methods[]",
         "Campaigns API shipping_options[].ref_id"
       ],
       "demoOnlyValues": [
-        2,
         1
       ],
-      "agentRule": "Use only on checkout/cart selector surfaces. Do not carry starter refs between campaigns; remove shipping_method rows when the target campaign has no matching method."
+      "agentRule": "Use only on checkout/cart selector surfaces. Do not carry starter refs between campaigns. A campaign lists each storefront shipping method once: price differences between tiers are shipping coupons on the cards (bundles[].vouchers / variant_slots[].vouchers), not a second method. Map a second key only to a genuinely different storefront method (e.g. Express)."
     },
     "bundles": {
       "purpose": "Checkout bundle-card rows for package quantity tiers.",
@@ -114,6 +112,7 @@
         "id",
         "quantity",
         "shipping_method",
+        "vouchers",
         "selected",
         "title_prefix",
         "badge_text",
@@ -123,7 +122,7 @@
         "CampaignSpec checkout page packages/offers",
         "Campaigns API package and shipping refs"
       ],
-      "agentRule": "Prefer package_id plus quantity. Use explicit items_json only for genuinely custom item sets."
+      "agentRule": "Prefer package_id plus quantity. Use explicit items_json only for genuinely custom item sets. `vouchers` (string or list) renders data-next-bundle-vouchers: the coupon applied while that card is selected — use a shipping_percentage Code Offer for tier shipping price."
     },
     "variant_slots": {
       "purpose": "MV/configurable bundle slots for selector rows and later variant choice stages.",
@@ -131,6 +130,7 @@
         "id",
         "quantity",
         "shipping_method",
+        "vouchers",
         "selected",
         "title",
         "label_text",
@@ -608,7 +608,7 @@
           ],
           "optionalWhenSupported": [
             "cart_summary_variant",
-            "shipping_methods.free",
+            "bundles[].vouchers",
             "order_bump_variant",
             "order_bump",
             "packages.prepurchase_1",
@@ -623,8 +623,8 @@
             "packages.main_package=1",
             "packages.prepurchase_1=7",
             "packages.prepurchase_2=9",
-            "shipping_methods.standard=2",
-            "shipping_methods.free=1",
+            "shipping_methods.standard=1",
+            "bundles[].vouchers=FREESHIP",
             "upsell_offer.package_id=3",
             "upsell_offer.vouchers_json=[\"UP50\"]",
             "upsell_bundle_tiers packageId=3"
@@ -633,13 +633,14 @@
             "packages.*",
             "shipping_methods.*",
             "bundles[].shipping_method",
+            "bundles[].vouchers",
             "order_bump.*.package_id",
             "upsell_offer.*",
             "upsell_bundle_tiers[].items_json",
             "upsell_bundle_tiers[].vouchers_json"
           ],
           "removeWhenUnsupported": [
-            "bundles[].shipping_method when no tier-specific shipping exists",
+            "bundles[].vouchers when no tier-specific shipping price exists",
             "bump includes when prepurchase packages are absent",
             "unsupported payment method rows",
             "upsell pages not present in the funnel"
@@ -850,8 +851,8 @@
       },
       "verification": {
         "sdk_version": "0.4.43",
-        "verified_at": "2026-10-21T04:05:46Z",
-        "evidence": "sdk-0.4.43-2026-10-21.2",
+        "verified_at": "2026-10-24T04:58:52Z",
+        "evidence": "sdk-0.4.43-2026-10-24",
         "status": "certified",
         "source": "template-verification.json"
       }
@@ -861,8 +862,8 @@
       "templateReference": {
         "id": "template-reference-apollo",
         "family": "apollo",
-        "version": "sdk-0.4.38-composable-upsells-2026-09-25",
-        "source_commit": "03f5982d703e07f8dc6beaedc121d55093373e4d",
+        "version": "sdk-0.4.43-shipping-coupon-tiers-2026-10-23",
+        "source_commit": "11af184434963340df74bee96a1f8559fcbf9028",
         "provenance_url": "https://raw.githubusercontent.com/NextCommerceCo/campaign-cart-starter-templates/main/docs/template-references/apollo/README.md",
         "contract_path": "contracts/commerce-surface-catalog.json",
         "standard_viewport_refs": [
@@ -872,10 +873,10 @@
             "url": "https://raw.githubusercontent.com/NextCommerceCo/campaign-cart-starter-templates/main/docs/template-references/apollo/checkout-desktop.png",
             "width": 1440,
             "height": 1491,
-            "sha256": "7595630f9e3dd4da09c395f7681c1ff546011141d3981412d5f76a1ffe2d5c90",
+            "sha256": "3a619d34f9fc8507b3a606db50218936c4d44bd1c2a21a2e8f87af3efa545fa7",
             "device_profile": "Desktop 1440",
             "browser": "chromium",
-            "captured_at": "2026-09-25T00:10:12.000Z"
+            "captured_at": "2026-10-23T22:04:21.000Z"
           },
           {
             "id": "apollo-checkout-mobile",
@@ -883,10 +884,10 @@
             "url": "https://raw.githubusercontent.com/NextCommerceCo/campaign-cart-starter-templates/main/docs/template-references/apollo/checkout-mobile.png",
             "width": 390,
             "height": 2648,
-            "sha256": "1d797be266beefb10cf7ec4502d8f8c97286a0861b969695986ebfc1ac29ce63",
+            "sha256": "5a8dc7560c89e7c9e162ed41a64af94a2324b0b725ff1c167719dc259ebf59a6",
             "device_profile": "Mobile 390",
             "browser": "chromium",
-            "captured_at": "2026-09-25T00:10:12.000Z"
+            "captured_at": "2026-10-23T22:04:21.000Z"
           }
         ]
       },
@@ -977,7 +978,7 @@
           "optionalWhenSupported": [
             "bundle_card_style",
             "cart_summary_variant",
-            "shipping_methods.free",
+            "bundles[].vouchers",
             "selector_order_bump_variant",
             "order_bump_variant",
             "order_bump",
@@ -1010,8 +1011,8 @@
             "packages.main_package=1",
             "packages.prepurchase_1=7",
             "packages.prepurchase_2=9",
-            "shipping_methods.standard=2",
-            "shipping_methods.free=1",
+            "shipping_methods.standard=1",
+            "bundles[].vouchers=FREESHIP",
             "bundle_card_style=product",
             "selector_order_bump_variant=check03",
             "order_bump_variant=check01+switch01",
@@ -1024,13 +1025,14 @@
             "packages.*",
             "shipping_methods.*",
             "bundles[].shipping_method",
+            "bundles[].vouchers",
             "order_bump.*.package_id",
             "upsell_offer.*",
             "upsell_bundle_tiers[].items_json",
             "upsell_bundle_tiers[].vouchers_json"
           ],
           "removeWhenUnsupported": [
-            "bundles[].shipping_method when no tier-specific shipping exists",
+            "bundles[].vouchers when no tier-specific shipping price exists",
             "selector_order_bump_variant when no selector-area bump package exists",
             "bump includes when prepurchase packages are absent",
             "unsupported payment method rows",
@@ -1274,8 +1276,8 @@
       },
       "verification": {
         "sdk_version": "0.4.43",
-        "verified_at": "2026-10-21T04:05:46Z",
-        "evidence": "sdk-0.4.43-2026-10-21.2",
+        "verified_at": "2026-10-24T04:58:52Z",
+        "evidence": "sdk-0.4.43-2026-10-24",
         "status": "certified",
         "source": "template-verification.json"
       }
@@ -1366,7 +1368,7 @@
             "bundles[].shipping_method"
           ],
           "optionalWhenSupported": [
-            "shipping_methods.free",
+            "bundles[].vouchers",
             "cart_summary_variant",
             "order_bump_variant",
             "upsell_offer",
@@ -1375,8 +1377,8 @@
           ],
           "demoOnlyValues": [
             "packages.main_package=1",
-            "shipping_methods.standard=2",
-            "shipping_methods.free=1",
+            "shipping_methods.standard=1",
+            "bundles[].vouchers=FREESHIP",
             "packages.prepurchase_1=7",
             "packages.prepurchase_2=9"
           ],
@@ -1384,12 +1386,13 @@
             "packages.*",
             "shipping_methods.*",
             "bundles[].shipping_method",
+            "bundles[].vouchers",
             "order_bump.*.package_id",
             "upsell_offer.package_id",
             "upsell_bundle_tiers[].items_json"
           ],
           "removeWhenUnsupported": [
-            "bundles[].shipping_method when no tier-specific shipping exists",
+            "bundles[].vouchers when no tier-specific shipping price exists",
             "order bump variants when prepurchase packages are absent"
           ]
         },
@@ -1585,8 +1588,8 @@
       },
       "verification": {
         "sdk_version": "0.4.43",
-        "verified_at": "2026-10-21T04:05:46Z",
-        "evidence": "sdk-0.4.43-2026-10-21.2",
+        "verified_at": "2026-10-24T04:58:52Z",
+        "evidence": "sdk-0.4.43-2026-10-24",
         "status": "certified",
         "source": "template-verification.json"
       }
@@ -1888,8 +1891,8 @@
       },
       "verification": {
         "sdk_version": "0.4.43",
-        "verified_at": "2026-10-21T04:05:46Z",
-        "evidence": "sdk-0.4.43-2026-10-21.2",
+        "verified_at": "2026-10-24T04:58:52Z",
+        "evidence": "sdk-0.4.43-2026-10-24",
         "status": "certified",
         "source": "template-verification.json"
       }
@@ -1980,7 +1983,7 @@
             "variant_slots[].shipping_method"
           ],
           "optionalWhenSupported": [
-            "shipping_methods.free",
+            "variant_slots[].vouchers",
             "checkout_step.selector_layout",
             "swiper_slides",
             "swiper_thumbs",
@@ -1993,8 +1996,8 @@
           ],
           "demoOnlyValues": [
             "packages.main_package=1",
-            "shipping_methods.standard=2",
-            "shipping_methods.free=1",
+            "shipping_methods.standard=1",
+            "variant_slots[].vouchers=FREESHIP",
             "upsell_offer.package_id=1",
             "upsell_offer.package_id=3",
             "upsell_mv_tiers vouchers_json=[\"UP80TSHIRT\"]",
@@ -2005,6 +2008,7 @@
             "packages.main_package",
             "shipping_methods.*",
             "variant_slots[].shipping_method",
+            "variant_slots[].vouchers",
             "upsell_offer.*",
             "upsell_mv_tiers[].vouchers_json",
             "slot_personalization",
@@ -2013,7 +2017,7 @@
           ],
           "removeWhenUnsupported": [
             "variant slot rows unsupported by the target spec/API",
-            "free shipping row if no free method exists",
+            "variant_slots[].vouchers when no tier-specific shipping price exists",
             "upsell pages not present in the funnel"
           ]
         },
@@ -2229,8 +2233,8 @@
       },
       "verification": {
         "sdk_version": "0.4.43",
-        "verified_at": "2026-10-21T04:05:46Z",
-        "evidence": "sdk-0.4.43-2026-10-21.2",
+        "verified_at": "2026-10-24T04:58:52Z",
+        "evidence": "sdk-0.4.43-2026-10-24",
         "status": "certified",
         "source": "template-verification.json"
       }
@@ -2334,7 +2338,7 @@
             "variant_slots[].shipping_method"
           ],
           "optionalWhenSupported": [
-            "shipping_methods.free",
+            "variant_slots[].vouchers",
             "checkout_step.selector_layout",
             "selector_order_bump_variant",
             "order_bump_variant",
@@ -2357,8 +2361,8 @@
           ],
           "demoOnlyValues": [
             "packages.main_package=1",
-            "shipping_methods.standard=2",
-            "shipping_methods.free=1",
+            "shipping_methods.standard=1",
+            "variant_slots[].vouchers=FREESHIP",
             "checkout_step.selector_layout=grid",
             "selector_order_bump_variant=check03",
             "order_bump_variant=check01",
@@ -2372,6 +2376,7 @@
             "packages.main_package",
             "shipping_methods.*",
             "variant_slots[].shipping_method",
+            "variant_slots[].vouchers",
             "upsell_offer.*",
             "upsell_mv_tiers[].vouchers_json",
             "slot_personalization",
@@ -2381,7 +2386,7 @@
           "removeWhenUnsupported": [
             "variant slot rows unsupported by the target spec/API",
             "selector_order_bump_variant when no selector-area bump package exists",
-            "free shipping row if no free method exists",
+            "variant_slots[].vouchers when no tier-specific shipping price exists",
             "upsell pages not present in the funnel"
           ]
         },
@@ -2668,8 +2673,8 @@
       },
       "verification": {
         "sdk_version": "0.4.43",
-        "verified_at": "2026-10-21T04:05:46Z",
-        "evidence": "sdk-0.4.43-2026-10-21.2",
+        "verified_at": "2026-10-24T04:58:52Z",
+        "evidence": "sdk-0.4.43-2026-10-24",
         "status": "certified",
         "source": "template-verification.json"
       }
@@ -2761,7 +2766,7 @@
             "select_step.selector_id"
           ],
           "optionalWhenSupported": [
-            "shipping_methods.free",
+            "variant_slots[].vouchers",
             "checkout_step.selector_id",
             "select_step.selector_layout",
             "swiper_slides",
@@ -2774,8 +2779,8 @@
           ],
           "demoOnlyValues": [
             "packages.main_package=1",
-            "shipping_methods.standard=2",
-            "shipping_methods.free=1",
+            "shipping_methods.standard=1",
+            "variant_slots[].vouchers=FREESHIP",
             "upsell_offer.package_id=1",
             "upsell_offer.package_id=3",
             "upsell_mv_tiers vouchers_json=[\"UP80TSHIRT\"]",
@@ -2786,6 +2791,7 @@
             "packages.main_package",
             "shipping_methods.*",
             "variant_slots[].shipping_method",
+            "variant_slots[].vouchers",
             "upsell_offer.*",
             "upsell_mv_tiers[].vouchers_json",
             "slot_personalization",
@@ -2794,7 +2800,7 @@
           ],
           "removeWhenUnsupported": [
             "variant slot rows unsupported by the target spec/API",
-            "free shipping row if no free method exists",
+            "variant_slots[].vouchers when no tier-specific shipping price exists",
             "upsell pages not present in the funnel"
           ]
         },
@@ -3024,8 +3030,8 @@
       },
       "verification": {
         "sdk_version": "0.4.43",
-        "verified_at": "2026-10-21T04:05:46Z",
-        "evidence": "sdk-0.4.43-2026-10-21.2",
+        "verified_at": "2026-10-24T04:58:52Z",
+        "evidence": "sdk-0.4.43-2026-10-24",
         "status": "certified",
         "source": "template-verification.json"
       }
@@ -3314,8 +3320,8 @@
       },
       "verification": {
         "sdk_version": "0.4.43",
-        "verified_at": "2026-10-21T04:05:46Z",
-        "evidence": "sdk-0.4.43-2026-10-21.2",
+        "verified_at": "2026-10-24T04:58:52Z",
+        "evidence": "sdk-0.4.43-2026-10-24",
         "status": "certified",
         "source": "template-verification.json"
       }
@@ -3505,5 +3511,5 @@
   },
   "_synced_from_repo": "NextCommerceCo/campaign-cart-starter-templates",
   "_synced_from_ref": "main",
-  "_synced_from_sha": "b38343e85a05ec2fe949e13e783057d4c717a8d6"
+  "_synced_from_sha": "5711e22345756c655f41c0ae71444478e4a8999e"
 }