@nextcommerce/campaigns-os 1.50.0 → 1.53.0

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

@@ -8,7 +8,11 @@
  * a need to subset them. If that need shows up, split into
  * CampaignPaymentKey and CampaignRefId.
  *
- * Message text inherited verbatim from the pre-#110 validator at migration time.
+ * The ref_id message is inherited verbatim from the pre-#110 validator. The
+ * payment_env_key message keeps that validator's first sentence, which
+ * consumers match, and adds which field is empty and where its value comes
+ * from: a Campaigns API key in the spec (campaign.campaigns_api_key) is a
+ * different field and does not satisfy it.
  */
 export const CampaignMetadata = {
     id: 'CampaignMetadata',
@@ -21,7 +25,10 @@ export const CampaignMetadata = {
             violations.push({
                 ruleId: 'CampaignMetadata',
                 severity: 'warning',
-                message: 'No campaign loaded — campaign key required for spec export.',
+                message: 'No campaign loaded — campaign key required for spec export. ' +
+                    'campaign.payment_env_key is empty: copy it from the campaign retrieve body ' +
+                    '(docs/build-packet.md, "Reading package, offer and shipping refs"). ' +
+                    'A Campaigns API key in the spec does not fill this field.',
                 path: '/campaign/payment_env_key',
                 data: { missing: 'payment_env_key' },
             });

package/campaign-spec/dist/rules/design-source-shape.js

@@ -25,6 +25,10 @@
  * a build blocker. The export tool itself is the real validator at handoff
  * time; this rule keeps Map Builder authors honest while editing.
  */
+// design_source.type values with a producer (docs/entry-points.md). A page of
+// one of these types needs its file_url; any other type gets the hand-written
+// HTML way out as well.
+const DESIGN_TOOL_PRODUCERS = new Set(['figma', 'ai-generated']);
 const FIGMA_URL_PATTERN = /^https:\/\/(?:www\.)?figma\.com\//i;
 const ANY_URL_PATTERN = /^https?:\/\/\S+/i;
 function isNonEmptyString(value) {
@@ -44,6 +48,9 @@ export const DesignSourceShape = {
                     return;
                 const basePath = `/funnels/${funnelIdx}/pages/${pageIdx}/design_source`;
                 const pageLabel = page.label || page.id || '(unnamed page)';
+                // One normalization for every type comparison below, so "Figma" and
+                // " figma " are the same producer everywhere in this rule.
+                const designType = String(design.type ?? '').trim().toLowerCase();
                 // 1. type
                 if (!isNonEmptyString(design.type)) {
                     violations.push({
@@ -59,7 +66,10 @@ export const DesignSourceShape = {
                     violations.push({
                         ruleId: 'DesignSourceShape',
                         severity: 'warning',
-                        message: `"${pageLabel}" — design_source.file_url is missing; expected the design-tool file URL.`,
+                        message: `"${pageLabel}" — design_source.file_url is missing; expected the design-tool file URL.` +
+                            (DESIGN_TOOL_PRODUCERS.has(designType)
+                                ? ''
+                                : ' Hand-written or template HTML has no design tool: remove design_source from the page (see docs/entry-points.md).'),
                         path: `${basePath}/file_url`,
                         data: { pageId: page.id, check: 'file-url-missing' },
                     });
@@ -73,7 +83,7 @@ export const DesignSourceShape = {
                         data: { pageId: page.id, check: 'file-url-shape', value: design.file_url },
                     });
                 }
-                else if (design.type === 'figma' && !FIGMA_URL_PATTERN.test(design.file_url)) {
+                else if (designType === 'figma' && !FIGMA_URL_PATTERN.test(design.file_url)) {
                     // 3. figma-specific: must be a figma.com URL
                     violations.push({
                         ruleId: 'DesignSourceShape',
@@ -121,7 +131,7 @@ export const DesignSourceShape = {
                             });
                             continue;
                         }
-                        if (design.type === 'figma' && !FIGMA_URL_PATTERN.test(value)) {
+                        if (designType === 'figma' && !FIGMA_URL_PATTERN.test(value)) {
                             violations.push({
                                 ruleId: 'DesignSourceShape',
                                 severity: 'warning',

package/campaign-spec/dist/rules/sdk-version.js

@@ -47,7 +47,8 @@ export const SdkVersion = {
                 {
                     ruleId: 'SdkVersion',
                     severity: 'error',
-                    message: 'SDK version is required for spec export.',
+                    message: 'SDK version is required for spec export. Set global_config.sdk_version ' +
+                        'to the released Campaign Cart SDK version the pages load, in MAJOR.MINOR.PATCH form.',
                     path: '/global_config/sdk_version',
                 },
             ];

package/compatibility.json

@@ -1,6 +1,6 @@
 {
   "package": "@nextcommerce/campaigns-os",
-  "version": "1.50.0",
+  "version": "1.53.0",
   "status": "developer-preview",
   "contracts": {
     "campaign_spec": "4.2-4.3",

package/contracts/commerce-surface-catalog.json

@@ -849,8 +849,8 @@
       },
       "verification": {
         "sdk_version": "0.4.40",
-        "verified_at": "2026-10-01T16:01:10Z",
-        "evidence": "sdk-0.4.40-2026-10-01.2",
+        "verified_at": "2026-10-04T02:15:52Z",
+        "evidence": "sdk-0.4.40-2026-10-04",
         "status": "certified",
         "source": "template-verification.json"
       }
@@ -861,7 +861,7 @@
         "id": "template-reference-apollo",
         "family": "apollo",
         "version": "sdk-0.4.38-composable-upsells-2026-09-25",
-        "source_commit": "6c96525b6416872ad0e51918fe6ec82a9673808c",
+        "source_commit": "80f0e30f873b5a13a5232ffd76b20da53480ae57",
         "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": [
@@ -1273,8 +1273,8 @@
       },
       "verification": {
         "sdk_version": "0.4.40",
-        "verified_at": "2026-10-01T16:01:10Z",
-        "evidence": "sdk-0.4.40-2026-10-01.2",
+        "verified_at": "2026-10-04T02:15:52Z",
+        "evidence": "sdk-0.4.40-2026-10-04",
         "status": "certified",
         "source": "template-verification.json"
       }
@@ -1584,8 +1584,8 @@
       },
       "verification": {
         "sdk_version": "0.4.40",
-        "verified_at": "2026-10-01T16:01:10Z",
-        "evidence": "sdk-0.4.40-2026-10-01.2",
+        "verified_at": "2026-10-04T02:15:52Z",
+        "evidence": "sdk-0.4.40-2026-10-04",
         "status": "certified",
         "source": "template-verification.json"
       }
@@ -1887,8 +1887,8 @@
       },
       "verification": {
         "sdk_version": "0.4.40",
-        "verified_at": "2026-10-01T16:01:10Z",
-        "evidence": "sdk-0.4.40-2026-10-01.2",
+        "verified_at": "2026-10-04T02:15:52Z",
+        "evidence": "sdk-0.4.40-2026-10-04",
         "status": "certified",
         "source": "template-verification.json"
       }
@@ -2228,8 +2228,8 @@
       },
       "verification": {
         "sdk_version": "0.4.40",
-        "verified_at": "2026-10-01T16:01:10Z",
-        "evidence": "sdk-0.4.40-2026-10-01.2",
+        "verified_at": "2026-10-04T02:15:52Z",
+        "evidence": "sdk-0.4.40-2026-10-04",
         "status": "certified",
         "source": "template-verification.json"
       }
@@ -2667,8 +2667,8 @@
       },
       "verification": {
         "sdk_version": "0.4.40",
-        "verified_at": "2026-10-01T16:01:10Z",
-        "evidence": "sdk-0.4.40-2026-10-01.2",
+        "verified_at": "2026-10-04T02:15:52Z",
+        "evidence": "sdk-0.4.40-2026-10-04",
         "status": "certified",
         "source": "template-verification.json"
       }
@@ -3024,8 +3024,8 @@
       },
       "verification": {
         "sdk_version": "0.4.40",
-        "verified_at": "2026-10-01T16:01:10Z",
-        "evidence": "sdk-0.4.40-2026-10-01.2",
+        "verified_at": "2026-10-04T02:15:52Z",
+        "evidence": "sdk-0.4.40-2026-10-04",
         "status": "certified",
         "source": "template-verification.json"
       }
@@ -3314,8 +3314,8 @@
       },
       "verification": {
         "sdk_version": "0.4.40",
-        "verified_at": "2026-10-01T16:01:10Z",
-        "evidence": "sdk-0.4.40-2026-10-01.2",
+        "verified_at": "2026-10-04T02:15:52Z",
+        "evidence": "sdk-0.4.40-2026-10-04",
         "status": "certified",
         "source": "template-verification.json"
       }
@@ -3334,30 +3334,15 @@
           {
             "families": [
               "olympus",
-              "apollo"
-            ],
-            "note": "Single-package check-style bump."
-          },
-          {
-            "families": [
+              "apollo",
+              "demeter",
               "olympus-mv-single-step",
               "apollo-mv-single-step",
-              "olympus-mv-two-step"
-            ],
-            "note": "MV/configurable bump: quantity sync via data-next-product-sync (product_id), so it sums across variant swaps (SDK 0.4.25+). See CLAUDE.md."
-          },
-          {
-            "families": [
+              "olympus-mv-two-step",
               "shop-single-step",
               "shop-three-step"
             ],
-            "note": "Shop bump layout for selector-less checkouts."
-          },
-          {
-            "families": [
-              "demeter"
-            ],
-            "note": "Editorial bump styling."
+            "note": "GENERATED from _shared/checkout/_includes/ (sync:shared, byte-identical by construction, lint:shared-enforced) since the #194 consolidation — edit the _shared source, never a family copy. Superset contract: pricing_mode + legacy show_* bools; package_sync/sync_quantity AND product_sync (product_id match for MV mains, wins when both set); per-family demo values live in page frontmatter (order_bump.check01)."
           }
         ]
       },
@@ -3375,30 +3360,25 @@
               "shop-single-step",
               "shop-three-step"
             ],
-            "note": "Shared unsynced product-card bump with optional PackageToggle line-item property field (SDK 0.4.27+)."
+            "note": "GENERATED from _shared/checkout/_includes/ (sync:shared, byte-identical by construction, lint:shared-enforced) since the #194 consolidation — edit the _shared source, never a family copy. Unsynced product-card bump with optional PackageToggle line-item property field (SDK 0.4.27+)."
           }
         ]
       },
       "bump-switch01.html": {
         "surface": "orderBump",
         "lineages": [
-          {
-            "families": [
-              "demeter"
-            ],
-            "note": "Switch-style bump with demeter styling."
-          },
           {
             "families": [
               "olympus",
               "apollo",
+              "demeter",
               "olympus-mv-single-step",
               "apollo-mv-single-step",
               "olympus-mv-two-step",
               "shop-single-step",
               "shop-three-step"
             ],
-            "note": "Shared switch-style bump."
+            "note": "GENERATED from _shared/checkout/_includes/ (sync:shared, byte-identical by construction, lint:shared-enforced) since the #194 consolidation — edit the _shared source, never a family copy. Switch-style bump; intentionally never quantity-synced."
           }
         ]
       },
@@ -3524,6 +3504,6 @@
     }
   },
   "_synced_from_repo": "NextCommerceCo/campaign-cart-starter-templates",
-  "_synced_from_ref": "main",
-  "_synced_from_sha": "37a8d945db4c360739ded98348814cfd632da94f"
+  "_synced_from_ref": "2c618942391ae398fb4812f36fc93e6632054874",
+  "_synced_from_sha": "2c618942391ae398fb4812f36fc93e6632054874"
 }