@funnelsgrove/cli 0.1.280 → 0.1.282

package/funnel-contract-compatibility.json

@@ -4,10 +4,10 @@
   "minimumCliVersion": "0.1.20",
   "entries": [
     {
-      "repositoryCliVersion": "0.1.280",
+      "repositoryCliVersion": "0.1.282",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.273",
+        "bundleVersion": "2.0.275",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -45,7 +45,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "0d5fc0fbb91286906cdfe5edd317ce970cd20b9210cea694d6b5ed630b2f8a3e"
+            "sha256": "291485278a2071a4e73422412e8f81e6ef64bc8b5aa3837b5a9e6dec54501607"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -145,16 +145,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "ca45c7be882af24d09999ab0ee7130645f9bfe4fb56addd2f7966bb31807e610"
+            "sha256": "b1ed6276f1565a432a9f48036669b15ed4edfb7c955bf74b312a2b5502f128eb"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.279",
+      "repositoryCliVersion": "0.1.281",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.272",
+        "bundleVersion": "2.0.274",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -192,7 +192,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "038a83e26aa4d24ad4ad6ec78a548cc7a2f2bc84d67adde6e9cc03bc11795a09"
+            "sha256": "3d6d1dc040dc64ba2b0d99d568d161efb621ddfc8e03b79e5fea72eb407cc086"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -292,22 +292,22 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "3eacc262001aadac7bdc68e58d69fa8a102ef919cbdd09178f5be90812468747"
+            "sha256": "9f2c2f20da1c0e9cc714a563041e01a3bd80d416a3965be6237c6036a6ab1f4d"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.278",
+      "repositoryCliVersion": "0.1.280",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.271",
+        "bundleVersion": "2.0.273",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
           {
             "path": "AGENTS.md",
-            "sha256": "3860d21f4a3f9b0c25ca54f7a87762d801f14b82a181b4c0b941c57187908f99"
+            "sha256": "b7dc496d1dcfea176fb5a57e6d17f64abdcff77afeccfcecbbe1790d11da7386"
           },
           {
             "path": "CLAUDE.md",
@@ -315,7 +315,7 @@
           },
           {
             "path": "docs/funnelsgrove/START-HERE.md",
-            "sha256": "ef7525739aa0cd5ea42906fca2ae6ca0327465e6939956f9567e3029148a0bd5"
+            "sha256": "5442274f8ca7ddded834147a693677e203a9c223e1db4260e56bf498ec06a362"
           },
           {
             "path": "docs/funnelsgrove/contracts/analytics-events.md",
@@ -323,7 +323,7 @@
           },
           {
             "path": "docs/funnelsgrove/contracts/content-answers.md",
-            "sha256": "38cd477fa65cb00718c6609ede520bc5b7538f331072c888a6cc32e8d0130d27"
+            "sha256": "efd912eb405e4c64b33becb1cf9a397ba5fe9afc2d4e2aea115a0f5e0703ca87"
           },
           {
             "path": "docs/funnelsgrove/contracts/flow-routing.md",
@@ -339,7 +339,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "012ef8788fdb0b5f7b8acc283ee9d0c3c9e23f68d944327ed8c2d9378de94585"
+            "sha256": "0d5fc0fbb91286906cdfe5edd317ce970cd20b9210cea694d6b5ed630b2f8a3e"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -439,22 +439,22 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "580a792c8650972c8016c0052bec88f7a5331445a8a039bb35912c2da4c645a0"
+            "sha256": "ca45c7be882af24d09999ab0ee7130645f9bfe4fb56addd2f7966bb31807e610"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.277",
+      "repositoryCliVersion": "0.1.279",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.270",
+        "bundleVersion": "2.0.272",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
           {
             "path": "AGENTS.md",
-            "sha256": "3860d21f4a3f9b0c25ca54f7a87762d801f14b82a181b4c0b941c57187908f99"
+            "sha256": "b7dc496d1dcfea176fb5a57e6d17f64abdcff77afeccfcecbbe1790d11da7386"
           },
           {
             "path": "CLAUDE.md",
@@ -462,7 +462,7 @@
           },
           {
             "path": "docs/funnelsgrove/START-HERE.md",
-            "sha256": "ef7525739aa0cd5ea42906fca2ae6ca0327465e6939956f9567e3029148a0bd5"
+            "sha256": "5442274f8ca7ddded834147a693677e203a9c223e1db4260e56bf498ec06a362"
           },
           {
             "path": "docs/funnelsgrove/contracts/analytics-events.md",
@@ -470,7 +470,7 @@
           },
           {
             "path": "docs/funnelsgrove/contracts/content-answers.md",
-            "sha256": "38cd477fa65cb00718c6609ede520bc5b7538f331072c888a6cc32e8d0130d27"
+            "sha256": "efd912eb405e4c64b33becb1cf9a397ba5fe9afc2d4e2aea115a0f5e0703ca87"
           },
           {
             "path": "docs/funnelsgrove/contracts/flow-routing.md",
@@ -486,7 +486,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "b15776c8ec0ecbc1f9369ccd56daee4160c533f7b34285cd1c5013db38fd411f"
+            "sha256": "038a83e26aa4d24ad4ad6ec78a548cc7a2f2bc84d67adde6e9cc03bc11795a09"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -586,16 +586,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "bdc9354312747f58fa96e201ec2b69b289dfbb21452f33866b3b7d2628490cd6"
+            "sha256": "3eacc262001aadac7bdc68e58d69fa8a102ef919cbdd09178f5be90812468747"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.276",
+      "repositoryCliVersion": "0.1.278",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.269",
+        "bundleVersion": "2.0.271",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -633,7 +633,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "fbff72ea55bddc1e2e58a66bfbf15677574868bfed25538507d169fd820f0202"
+            "sha256": "012ef8788fdb0b5f7b8acc283ee9d0c3c9e23f68d944327ed8c2d9378de94585"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -733,16 +733,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "2415311f4118e042c33855343708800e74c9f2433443f61ec4a44325f9a4dbc2"
+            "sha256": "580a792c8650972c8016c0052bec88f7a5331445a8a039bb35912c2da4c645a0"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.275",
+      "repositoryCliVersion": "0.1.277",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.268",
+        "bundleVersion": "2.0.270",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -780,7 +780,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "63b9bffafc0e408b769ce39764c84a45f55218e890782496f6b6aceed18e1569"
+            "sha256": "b15776c8ec0ecbc1f9369ccd56daee4160c533f7b34285cd1c5013db38fd411f"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -880,16 +880,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "1fcfbd34138904d3ef4213e7950e2c1b124289d1a95fb42c29075ca7512db676"
+            "sha256": "bdc9354312747f58fa96e201ec2b69b289dfbb21452f33866b3b7d2628490cd6"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.274",
+      "repositoryCliVersion": "0.1.276",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.267",
+        "bundleVersion": "2.0.269",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -927,7 +927,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "c0ca8f28f9da2e9444d3895197d5d0528e0ca869d8de1240b3355c418dddcbf0"
+            "sha256": "fbff72ea55bddc1e2e58a66bfbf15677574868bfed25538507d169fd820f0202"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -1027,7 +1027,7 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "a27ba0ce92c1fb2819b5cf4e18acbed6e8c02abe61feb234731b80d4e213de0c"
+            "sha256": "2415311f4118e042c33855343708800e74c9f2433443f61ec4a44325f9a4dbc2"
           }
         ]
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@funnelsgrove/cli",
-  "version": "0.1.280",
+  "version": "0.1.282",
   "description": "FunnelsGrove command-line tools for editing, syncing, and publishing funnels",
   "repository": {
     "type": "git",
@@ -34,14 +34,14 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@funnelsgrove/runtime": "0.29.0",
+    "@funnelsgrove/runtime": "0.30.0",
     "commander": "^12.0.0",
     "ignore": "^7.0.8",
     "typescript": "^5.8.3"
   },
   "devDependencies": {
-    "@funnelsgrove/analytics": "0.11.0",
-    "@funnelsgrove/payments": "0.36.0",
+    "@funnelsgrove/analytics": "0.12.0",
+    "@funnelsgrove/payments": "0.37.0",
     "vitest": "^3.0.0"
   }
 }

package/template_docs/.funnelsgrove-docs.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "bundleVersion": "2.0.273",
+  "bundleVersion": "2.0.275",
   "stepContractVersion": 3,
   "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
   "managedFiles": [
@@ -38,7 +38,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "0d5fc0fbb91286906cdfe5edd317ce970cd20b9210cea694d6b5ed630b2f8a3e"
+      "sha256": "291485278a2071a4e73422412e8f81e6ef64bc8b5aa3837b5a9e6dec54501607"
     },
     {
       "path": "docs/funnelsgrove/qa/analytics.md",
@@ -138,7 +138,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "ca45c7be882af24d09999ab0ee7130645f9bfe4fb56addd2f7966bb31807e610"
+      "sha256": "b1ed6276f1565a432a9f48036669b15ed4edfb7c955bf74b312a2b5502f128eb"
     }
   ]
 }

package/template_docs/docs/funnelsgrove/migrations/step-contract-v3.md

@@ -17,7 +17,7 @@ Supported read versions: `1`, `2`, `3`. Authoring and publish target version `3`
 
 ### Package release order
 
-Release `@funnelsgrove/sdk` `0.4.0` first, then `@funnelsgrove/runtime` `0.30.0`, then `@funnelsgrove/analytics` `0.12.0`, then `@funnelsgrove/payments` `0.37.0`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.280`, and only then promotes the candidate to production traffic. The serving API must never advertise an unpublished preferred CLI. Publishing packages and deploying production remain separately approved operational actions.
+Release `@funnelsgrove/sdk` `0.4.0` first, then `@funnelsgrove/runtime` `0.30.0`, then `@funnelsgrove/analytics` `0.12.0`, then `@funnelsgrove/payments` `0.37.0`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.282`, and only then promotes the candidate to production traffic. The serving API must never advertise an unpublished preferred CLI. Publishing packages and deploying production remain separately approved operational actions.
 <!-- funnelsgrove:generated:end contract-v3/migration/step-contract-v3 -->
 
 ## Version-last policy

package/template_docs/funnel-docs.config.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "bundleVersion": "2.0.273",
+  "bundleVersion": "2.0.275",
   "contractSource": "funnelsgrove-repository://apps/funnel-runtime/contracts/step-contract-v2.json",
   "fullyGenerated": [
     ".funnelsgrove-docs.json",

package/template_scaffold/.funnelsgrove-docs.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "bundleVersion": "2.0.273",
+  "bundleVersion": "2.0.275",
   "stepContractVersion": 3,
   "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
   "managedFiles": [
@@ -38,7 +38,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "0d5fc0fbb91286906cdfe5edd317ce970cd20b9210cea694d6b5ed630b2f8a3e"
+      "sha256": "291485278a2071a4e73422412e8f81e6ef64bc8b5aa3837b5a9e6dec54501607"
     },
     {
       "path": "docs/funnelsgrove/qa/analytics.md",
@@ -138,7 +138,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "ca45c7be882af24d09999ab0ee7130645f9bfe4fb56addd2f7966bb31807e610"
+      "sha256": "b1ed6276f1565a432a9f48036669b15ed4edfb7c955bf74b312a2b5502f128eb"
     }
   ]
 }

package/template_scaffold/.funnelsgrove-scaffold.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
-  "sourceTreeHash": "4b0643ddfdcd20c31293c52493ec2b200b1e945ddc40326632eef84c5dd02c87",
+  "sourceTreeHash": "b695f9d05e91e191e2053228b64bfc7b4d2c1e23b366b4fc9fa5a684ffcbf4a3",
   "stepContractVersion": 3,
-  "docsBundleVersion": "2.0.273",
+  "docsBundleVersion": "2.0.275",
   "files": [
     {
       "path": ".env.example",
@@ -16,7 +16,7 @@
     },
     {
       "path": ".funnelsgrove-docs.json",
-      "sha256": "aee17a66f685af3c6cdd2e47ef900189c1f1f9d2039a6e3a69a66f7e017b99db",
+      "sha256": "3a05839c27f66c2733c0a43d3b9d84ef202ec0c6a6b1dbe7815e69dd02abdcbc",
       "mode": "100644"
     },
     {
@@ -76,7 +76,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "0d5fc0fbb91286906cdfe5edd317ce970cd20b9210cea694d6b5ed630b2f8a3e",
+      "sha256": "291485278a2071a4e73422412e8f81e6ef64bc8b5aa3837b5a9e6dec54501607",
       "mode": "100644"
     },
     {
@@ -206,7 +206,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "ca45c7be882af24d09999ab0ee7130645f9bfe4fb56addd2f7966bb31807e610",
+      "sha256": "b1ed6276f1565a432a9f48036669b15ed4edfb7c955bf74b312a2b5502f128eb",
       "mode": "100644"
     },
     {
@@ -216,7 +216,7 @@
     },
     {
       "path": "funnel.runtime-capabilities.json",
-      "sha256": "3d74683170fced7afa9badfdf837706aac9c3d554690708b3ba31b009028a069",
+      "sha256": "50024a9d997506468094a938db5b34ed8d4c6d27e44de76b3417363c51b2c042",
       "mode": "100644"
     },
     {
@@ -236,12 +236,12 @@
     },
     {
       "path": "package-lock.json",
-      "sha256": "a049e5dea18468a6dc02da16fd8cd80ebec2283cf3b41be90d3d3c240bf186bd",
+      "sha256": "5d7d31d0f2fde5fdfed166440191ab8891d13460e01c56afa0c8362f35cab7c8",
       "mode": "100644"
     },
     {
       "path": "package.json",
-      "sha256": "e0b41a65cd79a4d40de18a8031f85c8496de08ba4d9f4ce00d2574dabcc1c085",
+      "sha256": "f6e66b75994b00ec61a0a9f48825c4c2197d0c0177504397f6faf88fc1a9eb95",
       "mode": "100644"
     },
     {
@@ -551,7 +551,7 @@
     },
     {
       "path": "src/steps/step-32-paywall.tsx",
-      "sha256": "43789583e91269b5427dbe5a054aafbe7cafac2a40d9a26f1c9414f1ae458b5c",
+      "sha256": "8a2903926e6476eef4901b240f7b6d054eb782292d72e84b1a11dcda65b200c4",
       "mode": "100644"
     },
     {

package/template_scaffold/docs/funnelsgrove/migrations/step-contract-v3.md

@@ -17,7 +17,7 @@ Supported read versions: `1`, `2`, `3`. Authoring and publish target version `3`
 
 ### Package release order
 
-Release `@funnelsgrove/sdk` `0.4.0` first, then `@funnelsgrove/runtime` `0.30.0`, then `@funnelsgrove/analytics` `0.12.0`, then `@funnelsgrove/payments` `0.37.0`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.280`, and only then promotes the candidate to production traffic. The serving API must never advertise an unpublished preferred CLI. Publishing packages and deploying production remain separately approved operational actions.
+Release `@funnelsgrove/sdk` `0.4.0` first, then `@funnelsgrove/runtime` `0.30.0`, then `@funnelsgrove/analytics` `0.12.0`, then `@funnelsgrove/payments` `0.37.0`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.282`, and only then promotes the candidate to production traffic. The serving API must never advertise an unpublished preferred CLI. Publishing packages and deploying production remain separately approved operational actions.
 <!-- funnelsgrove:generated:end contract-v3/migration/step-contract-v3 -->
 
 ## Version-last policy

package/template_scaffold/funnel-docs.config.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "bundleVersion": "2.0.273",
+  "bundleVersion": "2.0.275",
   "contractSource": "funnelsgrove-repository://apps/funnel-runtime/contracts/step-contract-v2.json",
   "fullyGenerated": [
     ".funnelsgrove-docs.json",

package/template_scaffold/funnel.runtime-capabilities.json

@@ -1,4 +1,5 @@
 {
   "moneyContractVersion": 1,
-  "localeContractVersion": 1
+  "localeContractVersion": 1,
+  "paypalCheckoutVersion": 1
 }

package/template_scaffold/package-lock.json

@@ -8,9 +8,9 @@
       "name": "funnel-template",
       "version": "0.1.0",
       "dependencies": {
-        "@funnelsgrove/analytics": "^0.11.0",
-        "@funnelsgrove/payments": "^0.36.0",
-        "@funnelsgrove/runtime": "^0.29.0",
+        "@funnelsgrove/analytics": "^0.12.0",
+        "@funnelsgrove/payments": "^0.37.0",
+        "@funnelsgrove/runtime": "^0.30.0",
         "@stripe/react-stripe-js": "^5.6.0",
         "@stripe/stripe-js": "^8.7.0",
         "lucide-react": "^0.553.0",
@@ -940,17 +940,17 @@
       }
     },
     "node_modules/@funnelsgrove/analytics": {
-      "version": "0.11.0",
-      "resolved": "https://registry.npmjs.org/@funnelsgrove/analytics/-/analytics-0.11.0.tgz",
-      "integrity": "sha512-u1WpXP8o+kZSB7i4m/KC3EYP/IA1rhd5Hu6VOyWxpgrBKdjKLoLBmtx4uHyKwpgNcA6FRjYBn3I+h/h4m47Tyw==",
+      "version": "0.12.0",
+      "resolved": "https://registry.npmjs.org/@funnelsgrove/analytics/-/analytics-0.12.0.tgz",
+      "integrity": "sha512-6f5UOWf8Dn3NYCFYLe1p3vtR0kKNQ6X3+8CVKl5nTqfBDxMwSCvothHTJIZnFpTNx5r6Hx+UJyePNrtFPC07Kw==",
       "peerDependencies": {
-        "@funnelsgrove/runtime": "^0.29.0"
+        "@funnelsgrove/runtime": "^0.30.0"
       }
     },
     "node_modules/@funnelsgrove/payments": {
-      "version": "0.36.0",
-      "resolved": "https://registry.npmjs.org/@funnelsgrove/payments/-/payments-0.36.0.tgz",
-      "integrity": "sha512-y837Km5jp/cfvCfdTIhDc0+XmwayaBh/slIDQFHuKBtHwoCH/ZfdCzF3Fil8EA1e4uFebQNYCawhH5AroD8f1A==",
+      "version": "0.37.0",
+      "resolved": "https://registry.npmjs.org/@funnelsgrove/payments/-/payments-0.37.0.tgz",
+      "integrity": "sha512-JPVeFQ3ewh0E2I8yl0CgTpZ02xKLKPLBRJabAmJYtvp6EO1zBDhnVbxqNvMlFou26DoU2e5ZqsCBhvgUcV4JjA==",
       "dependencies": {
         "@solidgate/react-sdk": "1.34.0",
         "@stripe/react-stripe-js": "^5.6.0",
@@ -960,14 +960,14 @@
         "stripe": "^20.3.1"
       },
       "peerDependencies": {
-        "@funnelsgrove/analytics": "^0.11.0",
-        "@funnelsgrove/runtime": "^0.29.0"
+        "@funnelsgrove/analytics": "^0.12.0",
+        "@funnelsgrove/runtime": "^0.30.0"
       }
     },
     "node_modules/@funnelsgrove/runtime": {
-      "version": "0.29.0",
-      "resolved": "https://registry.npmjs.org/@funnelsgrove/runtime/-/runtime-0.29.0.tgz",
-      "integrity": "sha512-QuhguLChZpL8L3ET8jVTUXzBvtG0eSy9PhkpPufNEKx9ObvJpGuwEgmze2Cw4zwlAzgwV7W7kEFpOH5h/owD+Q==",
+      "version": "0.30.0",
+      "resolved": "https://registry.npmjs.org/@funnelsgrove/runtime/-/runtime-0.30.0.tgz",
+      "integrity": "sha512-Vj5zzkEks+w62MR8Lpn6dOlqNIVde+cYtYzpkOyHvwFokjoxi0gsBb4rt7ko5p+9uPdhcFwN9ihCPFWq2jY2fg==",
       "dependencies": {
         "@funnelsgrove/sdk": "0.4.0",
         "posthog-js": "^1.369.2",

package/template_scaffold/package.json

@@ -12,9 +12,9 @@
     "validate:funnel": "vite-node --config src/contract/funnel-validator.vite.config.ts src/contract/validate-funnel.cli.ts"
   },
   "dependencies": {
-    "@funnelsgrove/analytics": "^0.11.0",
-    "@funnelsgrove/payments": "^0.36.0",
-    "@funnelsgrove/runtime": "^0.29.0",
+    "@funnelsgrove/analytics": "^0.12.0",
+    "@funnelsgrove/payments": "^0.37.0",
+    "@funnelsgrove/runtime": "^0.30.0",
     "@stripe/react-stripe-js": "^5.6.0",
     "@stripe/stripe-js": "^8.7.0",
     "lucide-react": "^0.553.0",

package/template_scaffold/src/steps/step-32-paywall.tsx

@@ -33,6 +33,9 @@ import { getPathForStep } from '@/runtime/funnel-runtime';
 import {
   SharedCheckoutSpecialOfferDialog,
   SolidgateCheckoutDialog,
+  PayPalCheckout,
+  PayPalCheckoutDialog,
+  readPendingPayPalCheckout,
   SharedStripeCheckoutV2Dialog,
   StripeSubscriptionWalletSurface,
   activateSecondPaywallDiscount,
@@ -140,7 +143,7 @@ function StepPaywallRuntime({
 }: StepPaywallProps = {}) {
   const [runtimeMode] = useRuntimeMode();
   const checkoutMode = runtimeMode;
-  const { user, setUser, attributes, featureFlags, completeStep, userBootstrapped } = useFunnel();
+  const { user, setUser, attributes, featureFlags, completeStep, goNext, userBootstrapped } = useFunnel();
   const publishedRuntime = useFunnelRuntimeConfig();
   const browserLocale = useBrowserOfferLocale();
   const content = usePreviewStepLocalizedContent(
@@ -179,7 +182,7 @@ function StepPaywallRuntime({
     activeBillingRuntime.sourceVersionId,
   ]);
   const activeBillingDiscounts = useMemo(
-    () => activeBillingRuntime.discounts ?? (
+    () => activeBillingRuntime.provider === 'paypal' ? inactiveBillingDiscounts : activeBillingRuntime.discounts ?? (
       activeBillingRuntime.provider === 'stripe'
         ? buildBillingDiscountCatalog(billingDiscountList)
         : inactiveBillingDiscounts
@@ -217,10 +220,16 @@ function StepPaywallRuntime({
       null,
     [activeBillingRuntime.defaultPlanKey, availablePlans],
   );
-  const [selectedPlanId, setSelectedPlanId] = useState<string | null>(
+  const [requestedPlanId, setSelectedPlanId] = useState<string | null>(
     initialPlanId,
   );
-  const [checkoutDialogOpen, setCheckoutDialogOpen] = useState(false);
+  const pendingPayPal = readPendingPayPalCheckout({ environment: checkoutMode, funnelEndUserId: user.id, runtimeConfig: activeCheckoutRuntimeConfig });
+  const hasPendingPayPal = Boolean(pendingPayPal);
+  const selectedPlanId = pendingPayPal
+    ? availablePlans.find(plan => plan.funnelPlanKey === pendingPayPal.funnelPlanKey)?.id ?? null
+    : requestedPlanId;
+  const [checkoutDialogOpen, setCheckoutDialogOpen] = useState(Boolean(pendingPayPal));
+  const [paypalPending, setPayPalPending] = useState(false);
   const [solidgateAttemptKey, setSolidgateAttemptKey] = useState<string | null>(null);
   const [specialOfferDialogOpen, setSpecialOfferDialogOpen] = useState(() => {
     if (typeof window === 'undefined') {
@@ -287,6 +296,7 @@ function StepPaywallRuntime({
   const checkoutSummaryLabel =
     selectedDisplayPlan?.checkoutSummaryLabel?.trim() || selectedDisplayPlan?.title || content.selectedPlanLabel;
   const checkoutProvider = activeBillingRuntime.provider;
+  const paypalOption = pendingPayPal?.option || (selectedPlan?.funnelPlanKey ? activeBillingRuntime.paypalOptionsByPlanKey?.[selectedPlan.funnelPlanKey] : null);
   const storyOptions = useMemo<readonly StoryOption[]>(
     () =>
       content.stories.items.map((item, index) => ({
@@ -390,7 +400,7 @@ function StepPaywallRuntime({
     }
     successUrl.searchParams.set(
       'source',
-      checkoutProvider === 'solidgate' ? 'solidgate' : 'stripe-elements',
+      checkoutProvider === 'stripe' ? 'stripe-elements' : checkoutProvider,
     );
 
     return successUrl.toString();
@@ -483,10 +493,10 @@ function StepPaywallRuntime({
     && activeBillingRuntime.offerSetId.trim()
     && selectedPlan?.funnelPlanKey?.trim(),
   );
-  const checkoutDisabled = !checkoutSelectionReady || !userBootstrapped || !selectedPlan || !selectedDisplayPlan || (
+  const checkoutDisabled = Boolean(pendingPayPal) || paypalPending || !checkoutSelectionReady || !userBootstrapped || !selectedPlan || !selectedDisplayPlan || (
     checkoutProvider === 'solidgate'
       ? !solidgateCheckoutConfigured
-      : !checkoutSession.configured
+      : checkoutProvider === 'paypal' ? !paypalOption : !checkoutSession.configured
   );
   const checkoutDialogReady =
     checkoutProvider === 'stripe' &&
@@ -539,10 +549,10 @@ function StepPaywallRuntime({
   }, [user.email]);
 
   useEffect(() => {
-    setCheckoutDialogOpen(false);
+    setCheckoutDialogOpen(hasPendingPayPal);
     setSolidgateAttemptKey(null);
     setError(null);
-  }, [selectedPlanId]);
+  }, [selectedPlanId, hasPendingPayPal]);
 
   useEffect(() => {
     if (
@@ -633,6 +643,7 @@ function StepPaywallRuntime({
     paywallWalletMethodWrapperClassNames[method];
 
   const startCheckout = async () => {
+    if (pendingPayPal || paypalPending) { setCheckoutDialogOpen(true); return; }
     if (checkoutDisabled) {
       return;
     }
@@ -642,6 +653,8 @@ function StepPaywallRuntime({
       return;
     }
 
+    if (checkoutProvider === 'paypal') { setCheckoutDialogOpen(true); return; }
+
     if (checkoutProvider === 'solidgate') {
       setSolidgateAttemptKey(crypto.randomUUID());
       setCheckoutDialogOpen(true);
@@ -684,6 +697,7 @@ function StepPaywallRuntime({
   };
 
   const openCardCheckoutFromUnavailableWallet = async () => {
+    if (pendingPayPal || paypalPending) { setCheckoutDialogOpen(true); return; }
     if (checkoutDisabled) {
       return;
     }
@@ -754,6 +768,27 @@ function StepPaywallRuntime({
     setCheckoutEmailPromptError(null);
   };
 
+  const paypalCheckout = (checkoutSelectionReady || pendingPayPal) && userBootstrapped && paypalOption && (selectedPlan?.funnelPlanKey || pendingPayPal) ? (
+    <PayPalCheckout
+      key={`${paypalOption.paymentProfileId}:${paypalOption.providerPlanId}:${checkoutMode}:${pendingPayPal?.funnelPlanKey || selectedPlan?.funnelPlanKey}`}
+      option={paypalOption}
+      environment={checkoutMode}
+      funnelEndUserId={user.id}
+      offerSetId={pendingPayPal?.offerSetId || activeBillingRuntime.offerSetId}
+      funnelPlanKey={pendingPayPal?.funnelPlanKey || selectedPlan?.funnelPlanKey || ''}
+      runtimeConfig={activeCheckoutRuntimeConfig}
+      onPreparationStart={billingSelection.pin}
+      onPendingChange={pending => {
+        setPayPalPending(pending);
+        if (!pending) billingSelection.reset();
+      }}
+      onSuccess={() => {
+        completeStep(analyticsStepId, { planId: selectedDisplayPlan?.id ?? pendingPayPal?.funnelPlanKey });
+        goNext();
+      }}
+    />
+  ) : undefined;
+
   const closeCheckoutDialog = () => {
     if (checkoutProvider === 'stripe') checkoutSession.reset();
     else billingSelection.reset();
@@ -903,6 +938,11 @@ function StepPaywallRuntime({
         />
       ) : null}
 
+      {checkoutDialogOpen && paypalCheckout && (checkoutProvider === 'paypal' || !checkoutSession.activeClientSecret) ? (
+        <PayPalCheckoutDialog title={content.checkout.title} closeAriaLabel={content.checkout.closeAriaLabel}
+          onClose={() => setCheckoutDialogOpen(false)}>{paypalCheckout}</PayPalCheckoutDialog>
+      ) : null}
+
       {checkoutDialogOpen &&
       checkoutProvider === 'stripe' &&
       checkoutSession.activeClientSecret &&
@@ -933,6 +973,8 @@ function StepPaywallRuntime({
           onError={checkoutSession.setError}
           onSuccess={handleCheckoutCompleted}
           paymentMethodLabels={content.checkout.paymentMethodLabels}
+          paypalCheckout={paypalCheckout}
+          paypalPending={paypalPending || Boolean(pendingPayPal)}
           paypalButtonLabel={content.checkout.paypalButtonLabel}
           paypalLabel={content.checkout.paypalLabel}
           promoActive={checkoutPromoActive}
@@ -1099,6 +1141,7 @@ function StepPaywallRuntime({
               ]
                 .filter(Boolean)
                 .join(' ')}
+              disabled={paypalPending || Boolean(pendingPayPal)}
               onClick={() => setSelectedPlanId(plan.id)}
             >
               {plan.featuredTag ? <span className='paywall-v2-plan-tag'>{plan.featuredTag}</span> : null}
@@ -1169,12 +1212,17 @@ function StepPaywallRuntime({
             type='button'
             className='paywall-v2-card-button paywall-v2-vibe-cta'
             onClick={() => void startCheckout()}
-            disabled={checkoutDisabled}
+            disabled={checkoutDisabled && !pendingPayPal && !paypalPending}
           >
             {content.plans.cardButtonLabel}
           </button>
-          <p className='paywall-v2-alt-meta'>{content.plans.metaLabels.join(' · ')}</p>
+          {checkoutProvider !== 'paypal' && !pendingPayPal ? (
+            <div aria-label='Card and wallet billing terms'>
+              {paypalOption ? <p className='paywall-v2-alt-meta'>Card and wallet terms</p> : null}
           <PaywallRenewalDisclaimer plan={selectedPlan} hasActiveDiscount={Boolean(activeCouponId)} copy={content.checkout} catalogLabels={content.catalogLabels} />
+            </div>
+          ) : null}
+          <p className='paywall-v2-alt-meta'>{content.plans.metaLabels.join(' · ')}</p>
           <p className='paywall-v2-support'>
             {content.checkout.supportText}{' '}
             <a href={`mailto:${supportEmail}`}>{supportEmail}</a>