@funnelsgrove/cli 0.1.157 → 0.1.163

package/funnel-contract-compatibility.json

@@ -4,10 +4,10 @@
   "minimumCliVersion": "0.1.20",
   "entries": [
     {
-      "repositoryCliVersion": "0.1.157",
+      "repositoryCliVersion": "0.1.163",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.147",
+        "bundleVersion": "2.0.154",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -37,7 +37,7 @@
           },
           {
             "path": "docs/funnelsgrove/contracts/payments.md",
-            "sha256": "3e91737d0d9aef3f9e7842d87b5a4e6a922fc68a3f88da7ff4a09538f5f3e36d"
+            "sha256": "f1422b3651a5f3a4207203791b95fe61d7be491ea28556d70039f2e1f103aae0"
           },
           {
             "path": "docs/funnelsgrove/contracts/step-metadata.md",
@@ -45,7 +45,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "89613b9ce40d257a90436833d3e852a77f2680bf9ec7cd23cf9b4eb2d760267e"
+            "sha256": "cf6e4c283e7f58d652cc3e60ba96e6fbba37d66fa3d551c4ee391d97611543e0"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -57,7 +57,7 @@
           },
           {
             "path": "docs/funnelsgrove/qa/paywall-checkout.md",
-            "sha256": "982f18d6e150606dcabe947cea95b654b643b8200f873a56fe7fe43321359b83"
+            "sha256": "73a55f2723c0ae4729466297f975b767f718b93614a947b1c0f002ba05b57e88"
           },
           {
             "path": "docs/funnelsgrove/qa/publish.md",
@@ -101,7 +101,7 @@
           },
           {
             "path": "docs/funnelsgrove/steps/paywall_offer.md",
-            "sha256": "0fe7260fa4c22f10cb218193bbb870da5f48753d964b8a9250ecc79158dd5462"
+            "sha256": "0cf35f69c7d7bfaf3a53ef41cbb833393231ac5dab779f8ace5c529ed3a5d2e8"
           },
           {
             "path": "docs/funnelsgrove/steps/progress_interstitial.md",
@@ -145,16 +145,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "5c1285eeb0761b07f559899336ea7a9e502f178d9b93c58c2a033af07473c509"
+            "sha256": "74ce5972ef02799de47a7a5b8eb13e33605d286f58e5a9dd7348cea2c8e2b764"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.156",
+      "repositoryCliVersion": "0.1.162",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.146",
+        "bundleVersion": "2.0.153",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -184,7 +184,7 @@
           },
           {
             "path": "docs/funnelsgrove/contracts/payments.md",
-            "sha256": "3e91737d0d9aef3f9e7842d87b5a4e6a922fc68a3f88da7ff4a09538f5f3e36d"
+            "sha256": "f1422b3651a5f3a4207203791b95fe61d7be491ea28556d70039f2e1f103aae0"
           },
           {
             "path": "docs/funnelsgrove/contracts/step-metadata.md",
@@ -192,7 +192,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "4955bf4528d2fe830b0d97453dd73427a4abad6beecd580c4669151957ee776e"
+            "sha256": "2daa198043f2c83556b10b70285d1d69eb4a4bcc897ca9fe5391e53d31ccc51e"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -204,7 +204,7 @@
           },
           {
             "path": "docs/funnelsgrove/qa/paywall-checkout.md",
-            "sha256": "982f18d6e150606dcabe947cea95b654b643b8200f873a56fe7fe43321359b83"
+            "sha256": "73a55f2723c0ae4729466297f975b767f718b93614a947b1c0f002ba05b57e88"
           },
           {
             "path": "docs/funnelsgrove/qa/publish.md",
@@ -248,7 +248,7 @@
           },
           {
             "path": "docs/funnelsgrove/steps/paywall_offer.md",
-            "sha256": "0fe7260fa4c22f10cb218193bbb870da5f48753d964b8a9250ecc79158dd5462"
+            "sha256": "0cf35f69c7d7bfaf3a53ef41cbb833393231ac5dab779f8ace5c529ed3a5d2e8"
           },
           {
             "path": "docs/funnelsgrove/steps/progress_interstitial.md",
@@ -292,16 +292,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "99b5cbb86f8379bba4752f373980c62c4a97e75d4e770b32a0a26c96be5e99c6"
+            "sha256": "0c74ea380f8ecb8d33db827799b5e135fa274814cea68d0a3573c31fb639c4ab"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.155",
+      "repositoryCliVersion": "0.1.161",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.145",
+        "bundleVersion": "2.0.152",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -331,7 +331,7 @@
           },
           {
             "path": "docs/funnelsgrove/contracts/payments.md",
-            "sha256": "3e91737d0d9aef3f9e7842d87b5a4e6a922fc68a3f88da7ff4a09538f5f3e36d"
+            "sha256": "f1422b3651a5f3a4207203791b95fe61d7be491ea28556d70039f2e1f103aae0"
           },
           {
             "path": "docs/funnelsgrove/contracts/step-metadata.md",
@@ -339,7 +339,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "2a465d3c47537b0010569b7dc384a0458e4724026beb2a0e2216fdd89c916a2e"
+            "sha256": "50f7badea548c53011111f6af408fc1597b7bc0f6a3c45b9461d8b41e282c4b0"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -351,7 +351,7 @@
           },
           {
             "path": "docs/funnelsgrove/qa/paywall-checkout.md",
-            "sha256": "982f18d6e150606dcabe947cea95b654b643b8200f873a56fe7fe43321359b83"
+            "sha256": "73a55f2723c0ae4729466297f975b767f718b93614a947b1c0f002ba05b57e88"
           },
           {
             "path": "docs/funnelsgrove/qa/publish.md",
@@ -395,7 +395,7 @@
           },
           {
             "path": "docs/funnelsgrove/steps/paywall_offer.md",
-            "sha256": "0fe7260fa4c22f10cb218193bbb870da5f48753d964b8a9250ecc79158dd5462"
+            "sha256": "0cf35f69c7d7bfaf3a53ef41cbb833393231ac5dab779f8ace5c529ed3a5d2e8"
           },
           {
             "path": "docs/funnelsgrove/steps/progress_interstitial.md",
@@ -439,16 +439,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "000cea4a6781729d92b9c93e6a2edd8fc9eff087008a36cc189900d971c2f980"
+            "sha256": "c3c5f40cbf36f50789192af33a24dc3afff4a1983d5e477e08007b54eb2836e1"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.154",
+      "repositoryCliVersion": "0.1.160",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.144",
+        "bundleVersion": "2.0.151",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -486,7 +486,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "935a7a8acba3bcfcabcecde76e666b4b651e99ed6e676ec1cee134b6b31762e6"
+            "sha256": "7931d72733f40afe34a8ea32618d1daecec9cdefe898bb830a22d5d6f130cb9d"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -586,16 +586,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "6f6717766d4705476b0a8609a63541795cd2ab3e19c7639ae057285ffb9e078e"
+            "sha256": "b22cae1581ff4e5910d99cb970f50b0874c5dfb066e5f3e8f23e9b7a78dd3ce5"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.153",
+      "repositoryCliVersion": "0.1.159",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.143",
+        "bundleVersion": "2.0.149",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -633,7 +633,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "8f171c06f31fcf958fedfa424dfac98744536e71ccf5dee1a4d9115532f3c208"
+            "sha256": "6e52eb1353390147be78cc3d3653c25a831bc0d18bfc7f7ef80b1559b11b6068"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -733,16 +733,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "1faef087e033f8c9077f8b13e6e80ffd625dfbc5caab2a142e3d160def616c71"
+            "sha256": "3a4014ffceb45bc158109d34afbcd31c0497ca1885dc1db85af3aa46f50769a1"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.152",
+      "repositoryCliVersion": "0.1.158",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.142",
+        "bundleVersion": "2.0.148",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -780,7 +780,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "f2d02a29bc4c7fc3587f71ebc48f23d0c5a6f7bd06e53ab81db375be0fee5fcb"
+            "sha256": "a21348978d4642a5464815068fae3a6bd96c3a394e51e5c1ba90b3d00ab4708c"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -880,16 +880,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "50ed231287a2dab10fa48820feea1b1c8f97bda954ec318d0461d1b991e51562"
+            "sha256": "528bb076f11c7466876f30d1b438301f953edb291a339822fe75f633afc38ba8"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.151",
+      "repositoryCliVersion": "0.1.157",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.141",
+        "bundleVersion": "2.0.147",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -927,7 +927,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "6c4de9587b222ba0f23682905c1ed31c5771c3f8bacab92a13da91653ed79346"
+            "sha256": "89613b9ce40d257a90436833d3e852a77f2680bf9ec7cd23cf9b4eb2d760267e"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -1027,7 +1027,7 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "d86023b1611bec2e43eb57e1ed2f7b9c870b88e7db51f0bfdb8d30e7e51d05c9"
+            "sha256": "5c1285eeb0761b07f559899336ea7a9e502f178d9b93c58c2a033af07473c509"
           }
         ]
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@funnelsgrove/cli",
-  "version": "0.1.157",
+  "version": "0.1.163",
   "description": "FunnelsGrove command-line tools for editing, syncing, and publishing funnels",
   "repository": {
     "type": "git",
@@ -34,13 +34,13 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@funnelsgrove/runtime": "0.8.0",
+    "@funnelsgrove/runtime": "0.10.0",
     "commander": "^12.0.0",
     "typescript": "^5.8.3"
   },
   "devDependencies": {
-    "@funnelsgrove/analytics": "0.1.81",
-    "@funnelsgrove/payments": "0.8.0",
+    "@funnelsgrove/analytics": "0.1.83",
+    "@funnelsgrove/payments": "0.10.0",
     "vitest": "^3.0.0"
   }
 }

package/template_docs/.funnelsgrove-docs.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "bundleVersion": "2.0.147",
+  "bundleVersion": "2.0.154",
   "stepContractVersion": 3,
   "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
   "managedFiles": [
@@ -30,7 +30,7 @@
     },
     {
       "path": "docs/funnelsgrove/contracts/payments.md",
-      "sha256": "3e91737d0d9aef3f9e7842d87b5a4e6a922fc68a3f88da7ff4a09538f5f3e36d"
+      "sha256": "f1422b3651a5f3a4207203791b95fe61d7be491ea28556d70039f2e1f103aae0"
     },
     {
       "path": "docs/funnelsgrove/contracts/step-metadata.md",
@@ -38,7 +38,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "89613b9ce40d257a90436833d3e852a77f2680bf9ec7cd23cf9b4eb2d760267e"
+      "sha256": "cf6e4c283e7f58d652cc3e60ba96e6fbba37d66fa3d551c4ee391d97611543e0"
     },
     {
       "path": "docs/funnelsgrove/qa/analytics.md",
@@ -50,7 +50,7 @@
     },
     {
       "path": "docs/funnelsgrove/qa/paywall-checkout.md",
-      "sha256": "982f18d6e150606dcabe947cea95b654b643b8200f873a56fe7fe43321359b83"
+      "sha256": "73a55f2723c0ae4729466297f975b767f718b93614a947b1c0f002ba05b57e88"
     },
     {
       "path": "docs/funnelsgrove/qa/publish.md",
@@ -94,7 +94,7 @@
     },
     {
       "path": "docs/funnelsgrove/steps/paywall_offer.md",
-      "sha256": "0fe7260fa4c22f10cb218193bbb870da5f48753d964b8a9250ecc79158dd5462"
+      "sha256": "0cf35f69c7d7bfaf3a53ef41cbb833393231ac5dab779f8ace5c529ed3a5d2e8"
     },
     {
       "path": "docs/funnelsgrove/steps/progress_interstitial.md",
@@ -138,7 +138,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "5c1285eeb0761b07f559899336ea7a9e502f178d9b93c58c2a033af07473c509"
+      "sha256": "74ce5972ef02799de47a7a5b8eb13e33605d286f58e5a9dd7348cea2c8e2b764"
     }
   ]
 }

package/template_docs/docs/funnelsgrove/contracts/payments.md

@@ -30,7 +30,7 @@ A paywall presents purchasable plans. A reveal, loading state, calculation, or
 ## Payment rules
 
 - Resolve plans, prices, discounts, currencies, provider IDs, and payment mode from shared configuration.
-- Use `SharedStripeCheckoutV2Dialog` for card checkout and one `StripeSubscriptionWalletSurface` per simultaneously visible wallet placement. Never share a `useStripeSubscriptionCheckoutSession` result between card and wallet surfaces or between two visible wallet placements.
+- Use `SharedStripeCheckoutV2Dialog` for card checkout. Render one `StripeSubscriptionWalletSurface` per simultaneously visible subscription wallet placement and one `StripeOneTimeWalletSurface` per one-time placement. Never share a checkout hook result between card and wallet surfaces or between two visible wallet placements.
 - Pass `checkoutAnalytics` to every shared dialog and wallet surface. The payments package owns `checkout_started`, `add_payment_info`, and verified `checkout_completed`; do not call the corresponding `publicAnalyticsSdk` methods in funnel components.
 - Treat `onSuccess` as the first valid place to call `completeStep` for a purchase flow. Payment-info submission, dialog open, session creation, browser return, and provider-pending state are not lifecycle completion.
 - Use `completeStripeOneClickPayment` for one-click upsells. Do not duplicate the public one-click endpoint, Stripe loader, or `confirmPayment` inside a funnel.

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/runtime` `0.8.0` first, then `@funnelsgrove/analytics` `0.1.81`, then `@funnelsgrove/payments` `0.8.0`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.157`, 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/runtime` `0.10.0` first, then `@funnelsgrove/analytics` `0.1.83`, then `@funnelsgrove/payments` `0.10.0`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.163`, 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/docs/funnelsgrove/qa/paywall-checkout.md

@@ -48,7 +48,7 @@ _Not a choice type._
 
 - Verify every plan, price, currency, discount, and eligibility rule.
 - Test card and every enabled wallet.
-- Confirm every visible wallet placement has its own `StripeSubscriptionWalletSurface` session and the card dialog has a separate `useStripeSubscriptionCheckoutSession`.
+- Confirm every visible wallet placement uses the shared wallet surface matching its payment mode, owns its own Checkout Session, and remains isolated from the card dialog session.
 - Test validation, decline, retry, cancel, double-submit, and provider delay.
 - Verify named checkout events, complete metadata, one event ID, and retry deduplication.
 - Verify payment-info submission does not call `completeStep`; verified `onSuccess` does.

package/template_docs/docs/funnelsgrove/steps/paywall_offer.md

@@ -85,11 +85,11 @@ The controller owns view/start/completion/exit lifecycle. Closing or leaving wit
 
 ## Required semantic conversions
 
-Pass `checkoutAnalytics` into `SharedStripeCheckoutV2Dialog` and every `StripeSubscriptionWalletSurface`. Those shared components emit checkout started, payment info, and verified checkout completed with the real Checkout Session identity. Do not call the analytics SDK methods directly.
+Pass `checkoutAnalytics` into `SharedStripeCheckoutV2Dialog` and every `StripeSubscriptionWalletSurface` or `StripeOneTimeWalletSurface`. Those shared components emit checkout started, payment info, and verified checkout completed with the real Checkout Session identity. Do not call the analytics SDK methods directly.
 
 ## Approved shared helpers
 
-Use shared plan resolution, `useStripeSubscriptionCheckoutSession` for the card dialog, `SharedStripeCheckoutV2Dialog`, and one private-session `StripeSubscriptionWalletSurface` per visible wallet placement. Call `completeStep` only from `onSuccess`.
+Use shared plan resolution, the checkout hook matching the resolved payment mode for the card dialog, `SharedStripeCheckoutV2Dialog`, and one private-session wallet surface matching that payment mode per visible placement. Call `completeStep` only from `onSuccess`.
 
 ## MUST rules
 

package/template_docs/funnel-docs.config.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "bundleVersion": "2.0.147",
+  "bundleVersion": "2.0.154",
   "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.147",
+  "bundleVersion": "2.0.154",
   "stepContractVersion": 3,
   "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
   "managedFiles": [
@@ -30,7 +30,7 @@
     },
     {
       "path": "docs/funnelsgrove/contracts/payments.md",
-      "sha256": "3e91737d0d9aef3f9e7842d87b5a4e6a922fc68a3f88da7ff4a09538f5f3e36d"
+      "sha256": "f1422b3651a5f3a4207203791b95fe61d7be491ea28556d70039f2e1f103aae0"
     },
     {
       "path": "docs/funnelsgrove/contracts/step-metadata.md",
@@ -38,7 +38,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "89613b9ce40d257a90436833d3e852a77f2680bf9ec7cd23cf9b4eb2d760267e"
+      "sha256": "cf6e4c283e7f58d652cc3e60ba96e6fbba37d66fa3d551c4ee391d97611543e0"
     },
     {
       "path": "docs/funnelsgrove/qa/analytics.md",
@@ -50,7 +50,7 @@
     },
     {
       "path": "docs/funnelsgrove/qa/paywall-checkout.md",
-      "sha256": "982f18d6e150606dcabe947cea95b654b643b8200f873a56fe7fe43321359b83"
+      "sha256": "73a55f2723c0ae4729466297f975b767f718b93614a947b1c0f002ba05b57e88"
     },
     {
       "path": "docs/funnelsgrove/qa/publish.md",
@@ -94,7 +94,7 @@
     },
     {
       "path": "docs/funnelsgrove/steps/paywall_offer.md",
-      "sha256": "0fe7260fa4c22f10cb218193bbb870da5f48753d964b8a9250ecc79158dd5462"
+      "sha256": "0cf35f69c7d7bfaf3a53ef41cbb833393231ac5dab779f8ace5c529ed3a5d2e8"
     },
     {
       "path": "docs/funnelsgrove/steps/progress_interstitial.md",
@@ -138,7 +138,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "5c1285eeb0761b07f559899336ea7a9e502f178d9b93c58c2a033af07473c509"
+      "sha256": "74ce5972ef02799de47a7a5b8eb13e33605d286f58e5a9dd7348cea2c8e2b764"
     }
   ]
 }

package/template_scaffold/.funnelsgrove-scaffold.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
-  "sourceTreeHash": "fa8267d78fc7e44dbf9cc07562d215212316cbf699395c938232f82c9e2c5f88",
+  "sourceTreeHash": "de7842c56cf328b47126780ea9a5ecf8738805beff644884dd88bc0db0f9737b",
   "stepContractVersion": 3,
-  "docsBundleVersion": "2.0.147",
+  "docsBundleVersion": "2.0.154",
   "files": [
     {
       "path": ".env.example",
@@ -16,7 +16,7 @@
     },
     {
       "path": ".funnelsgrove-docs.json",
-      "sha256": "a7df5042715074ff61d0193dd28c2494411a2d13e1b078d9cac2aed975a36a01",
+      "sha256": "32babe53260db021faa61a35ec64fab5fbc9bc1aa4c1c858768205d82bc5988f",
       "mode": "100644"
     },
     {
@@ -91,7 +91,7 @@
     },
     {
       "path": "docs/funnelsgrove/contracts/payments.md",
-      "sha256": "3e91737d0d9aef3f9e7842d87b5a4e6a922fc68a3f88da7ff4a09538f5f3e36d",
+      "sha256": "f1422b3651a5f3a4207203791b95fe61d7be491ea28556d70039f2e1f103aae0",
       "mode": "100644"
     },
     {
@@ -101,7 +101,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "89613b9ce40d257a90436833d3e852a77f2680bf9ec7cd23cf9b4eb2d760267e",
+      "sha256": "cf6e4c283e7f58d652cc3e60ba96e6fbba37d66fa3d551c4ee391d97611543e0",
       "mode": "100644"
     },
     {
@@ -116,7 +116,7 @@
     },
     {
       "path": "docs/funnelsgrove/qa/paywall-checkout.md",
-      "sha256": "982f18d6e150606dcabe947cea95b654b643b8200f873a56fe7fe43321359b83",
+      "sha256": "73a55f2723c0ae4729466297f975b767f718b93614a947b1c0f002ba05b57e88",
       "mode": "100644"
     },
     {
@@ -171,7 +171,7 @@
     },
     {
       "path": "docs/funnelsgrove/steps/paywall_offer.md",
-      "sha256": "0fe7260fa4c22f10cb218193bbb870da5f48753d964b8a9250ecc79158dd5462",
+      "sha256": "0cf35f69c7d7bfaf3a53ef41cbb833393231ac5dab779f8ace5c529ed3a5d2e8",
       "mode": "100644"
     },
     {
@@ -236,7 +236,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "5c1285eeb0761b07f559899336ea7a9e502f178d9b93c58c2a033af07473c509",
+      "sha256": "74ce5972ef02799de47a7a5b8eb13e33605d286f58e5a9dd7348cea2c8e2b764",
       "mode": "100644"
     },
     {
@@ -261,12 +261,12 @@
     },
     {
       "path": "package-lock.json",
-      "sha256": "f3b137b615168b58568ca20b95f8d41e893c03d90cefa399434b9d4a5c8bacb3",
+      "sha256": "53cdac63493dafb3a94ba0780820745d1380fd3d2c391d7ffb58d16980406d4f",
       "mode": "100644"
     },
     {
       "path": "package.json",
-      "sha256": "66cb995f51302e0932bf990acd1d38e7f27e9623befa7ae8331d642087f06a6b",
+      "sha256": "d8aa1aa52569c7210bf297493ba5dc0a873d17ab769b7a19ee7c0c449d8ce79c",
       "mode": "100644"
     },
     {
@@ -551,7 +551,7 @@
     },
     {
       "path": "src/steps/step-32-paywall.tsx",
-      "sha256": "490ada07301b7ad1f2ee793e40fe31b7dfb73ac654f5cd691cca6438fd19ec7b",
+      "sha256": "7ff79178da7f72b1fedb384268d2686facf8f88d4d036aea496ac94b79c7876d",
       "mode": "100644"
     },
     {

package/template_scaffold/docs/funnelsgrove/contracts/payments.md

@@ -30,7 +30,7 @@ A paywall presents purchasable plans. A reveal, loading state, calculation, or
 ## Payment rules
 
 - Resolve plans, prices, discounts, currencies, provider IDs, and payment mode from shared configuration.
-- Use `SharedStripeCheckoutV2Dialog` for card checkout and one `StripeSubscriptionWalletSurface` per simultaneously visible wallet placement. Never share a `useStripeSubscriptionCheckoutSession` result between card and wallet surfaces or between two visible wallet placements.
+- Use `SharedStripeCheckoutV2Dialog` for card checkout. Render one `StripeSubscriptionWalletSurface` per simultaneously visible subscription wallet placement and one `StripeOneTimeWalletSurface` per one-time placement. Never share a checkout hook result between card and wallet surfaces or between two visible wallet placements.
 - Pass `checkoutAnalytics` to every shared dialog and wallet surface. The payments package owns `checkout_started`, `add_payment_info`, and verified `checkout_completed`; do not call the corresponding `publicAnalyticsSdk` methods in funnel components.
 - Treat `onSuccess` as the first valid place to call `completeStep` for a purchase flow. Payment-info submission, dialog open, session creation, browser return, and provider-pending state are not lifecycle completion.
 - Use `completeStripeOneClickPayment` for one-click upsells. Do not duplicate the public one-click endpoint, Stripe loader, or `confirmPayment` inside a funnel.

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/runtime` `0.8.0` first, then `@funnelsgrove/analytics` `0.1.81`, then `@funnelsgrove/payments` `0.8.0`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.157`, 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/runtime` `0.10.0` first, then `@funnelsgrove/analytics` `0.1.83`, then `@funnelsgrove/payments` `0.10.0`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.163`, 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/docs/funnelsgrove/qa/paywall-checkout.md

@@ -48,7 +48,7 @@ _Not a choice type._
 
 - Verify every plan, price, currency, discount, and eligibility rule.
 - Test card and every enabled wallet.
-- Confirm every visible wallet placement has its own `StripeSubscriptionWalletSurface` session and the card dialog has a separate `useStripeSubscriptionCheckoutSession`.
+- Confirm every visible wallet placement uses the shared wallet surface matching its payment mode, owns its own Checkout Session, and remains isolated from the card dialog session.
 - Test validation, decline, retry, cancel, double-submit, and provider delay.
 - Verify named checkout events, complete metadata, one event ID, and retry deduplication.
 - Verify payment-info submission does not call `completeStep`; verified `onSuccess` does.

package/template_scaffold/docs/funnelsgrove/steps/paywall_offer.md

@@ -85,11 +85,11 @@ The controller owns view/start/completion/exit lifecycle. Closing or leaving wit
 
 ## Required semantic conversions
 
-Pass `checkoutAnalytics` into `SharedStripeCheckoutV2Dialog` and every `StripeSubscriptionWalletSurface`. Those shared components emit checkout started, payment info, and verified checkout completed with the real Checkout Session identity. Do not call the analytics SDK methods directly.
+Pass `checkoutAnalytics` into `SharedStripeCheckoutV2Dialog` and every `StripeSubscriptionWalletSurface` or `StripeOneTimeWalletSurface`. Those shared components emit checkout started, payment info, and verified checkout completed with the real Checkout Session identity. Do not call the analytics SDK methods directly.
 
 ## Approved shared helpers
 
-Use shared plan resolution, `useStripeSubscriptionCheckoutSession` for the card dialog, `SharedStripeCheckoutV2Dialog`, and one private-session `StripeSubscriptionWalletSurface` per visible wallet placement. Call `completeStep` only from `onSuccess`.
+Use shared plan resolution, the checkout hook matching the resolved payment mode for the card dialog, `SharedStripeCheckoutV2Dialog`, and one private-session wallet surface matching that payment mode per visible placement. Call `completeStep` only from `onSuccess`.
 
 ## MUST rules
 

package/template_scaffold/funnel-docs.config.json

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

package/template_scaffold/package-lock.json

@@ -8,9 +8,9 @@
       "name": "funnel-template",
       "version": "0.1.0",
       "dependencies": {
-        "@funnelsgrove/analytics": "^0.1.81",
-        "@funnelsgrove/payments": "^0.8.0",
-        "@funnelsgrove/runtime": "^0.8.0",
+        "@funnelsgrove/analytics": "^0.1.83",
+        "@funnelsgrove/payments": "^0.10.0",
+        "@funnelsgrove/runtime": "^0.10.0",
         "@stripe/react-stripe-js": "^5.6.0",
         "@stripe/stripe-js": "^8.7.0",
         "lucide-react": "^0.553.0",
@@ -938,20 +938,20 @@
       }
     },
     "node_modules/@funnelsgrove/analytics": {
-      "version": "0.1.81",
-      "resolved": "https://registry.npmjs.org/@funnelsgrove/analytics/-/analytics-0.1.81.tgz",
-      "integrity": "sha512-ub6KkK0Vzf/JBZZ7gpC524zriqmV49s/t0ucsgoziXjD3oAwox4wwopFvWArkQSMWf3ayEzfNzznFys67oprDg==",
+      "version": "0.1.83",
+      "resolved": "https://registry.npmjs.org/@funnelsgrove/analytics/-/analytics-0.1.83.tgz",
+      "integrity": "sha512-KQPGCMxb+jcRjmCJ1Qd8WiWvc4hWAbdaCkAjVDnK0IxR06RSwDzMCUo9XcOFykGQr6Oar0V4FTFJhW2pHC5XFw==",
       "dependencies": {
-        "@funnelsgrove/runtime": "0.8.0"
+        "@funnelsgrove/runtime": "0.10.0"
       }
     },
     "node_modules/@funnelsgrove/payments": {
-      "version": "0.8.0",
-      "resolved": "https://registry.npmjs.org/@funnelsgrove/payments/-/payments-0.8.0.tgz",
-      "integrity": "sha512-Fs6z/I3x1Qla9QmCIudB+JXhK/a8C9cPfd5FXhLjB+b/8CjrHJc1zQ7b5puFxjNTr5uL0z5QKB8aUaBPWoXifw==",
+      "version": "0.10.0",
+      "resolved": "https://registry.npmjs.org/@funnelsgrove/payments/-/payments-0.10.0.tgz",
+      "integrity": "sha512-mv7CmawJb+AS83MbNvg48zO+FFU1LFyDSYzW6kD+f41oA3zz3d297o6jdjxYmkriVo6J/CHJ/xoI6ELnisks/g==",
       "dependencies": {
-        "@funnelsgrove/analytics": "^0.1.81",
-        "@funnelsgrove/runtime": "^0.8.0",
+        "@funnelsgrove/analytics": "^0.1.83",
+        "@funnelsgrove/runtime": "^0.10.0",
         "@solidgate/react-sdk": "1.34.0",
         "@stripe/react-stripe-js": "^5.6.0",
         "@stripe/stripe-js": "^8.7.0",
@@ -961,9 +961,9 @@
       }
     },
     "node_modules/@funnelsgrove/runtime": {
-      "version": "0.8.0",
-      "resolved": "https://registry.npmjs.org/@funnelsgrove/runtime/-/runtime-0.8.0.tgz",
-      "integrity": "sha512-ir29xHVJZyzjWMkXU2hzw5QBrLll/FiJYFYSUyegIxRmLCS+Ynpbq/CcZ9nXjhKsoHfMFy5uLp7m3jYQXnJqsQ==",
+      "version": "0.10.0",
+      "resolved": "https://registry.npmjs.org/@funnelsgrove/runtime/-/runtime-0.10.0.tgz",
+      "integrity": "sha512-YPJJtpKUbg/kHZzqgncCwYPMXPjxzYvlk+t/KCcM6YEhuL4fvGbjUqeScxjwTzAWYolD6xEZPX00/WgSWABcIw==",
       "dependencies": {
         "posthog-js": "^1.369.2",
         "react": "19.2.3",

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.1.81",
-    "@funnelsgrove/payments": "^0.8.0",
-    "@funnelsgrove/runtime": "^0.8.0",
+    "@funnelsgrove/analytics": "^0.1.83",
+    "@funnelsgrove/payments": "^0.10.0",
+    "@funnelsgrove/runtime": "^0.10.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

@@ -159,6 +159,15 @@ function StepPaywallRuntime({
     }),
     [checkoutMode, featureFlags, publishedRuntime.config],
   );
+  const activeCheckoutRuntimeConfig = useMemo(() => ({
+    ...checkoutRuntimeConfig,
+    funnelVersionId: publishedRuntime.config?.sourceVersionId ?? null,
+    paymentsApiVersion: activeBillingRuntime.paymentsApiVersion,
+  }), [
+    activeBillingRuntime.paymentsApiVersion,
+    checkoutRuntimeConfig,
+    publishedRuntime.config?.sourceVersionId,
+  ]);
   const activeBillingDiscounts = useMemo(
     () => activeBillingRuntime.discounts ?? (
       activeBillingRuntime.provider === 'stripe'
@@ -323,13 +332,20 @@ function StepPaywallRuntime({
       environment: checkoutMode,
       featureFlags,
       metadata: checkoutAnalyticsMetadata,
-      runtimeConfig: checkoutRuntimeConfig,
+      runtimeConfig: activeCheckoutRuntimeConfig,
       stepId: analyticsStepId,
       stepName: analyticsStepName,
       stepType: stepPaywall.type,
       stepContractVersion: funnelManifest.stepContractVersion,
     };
-  }, [analyticsStepId, analyticsStepName, checkoutAnalyticsMetadata, checkoutMode, featureFlags]);
+  }, [
+    activeCheckoutRuntimeConfig,
+    analyticsStepId,
+    analyticsStepName,
+    checkoutAnalyticsMetadata,
+    checkoutMode,
+    featureFlags,
+  ]);
   const successReturnUrl = useMemo(() => {
     if (typeof window === 'undefined') {
       return '';
@@ -359,7 +375,10 @@ function StepPaywallRuntime({
     onError: setError,
     plan: checkoutProvider === 'stripe' ? selectedPlan : null,
     returnUrl: successReturnUrl,
-    runtimeConfig: checkoutRuntimeConfig,
+    runtimeConfig: activeCheckoutRuntimeConfig,
+    runtimeConfigRevisionId: activeBillingRuntime.revisionId,
+    paymentProfileId: activeBillingRuntime.paymentProfileId,
+    provider: checkoutProvider === 'stripe' ? 'stripe' : null,
     stripePublishableKey: activeBillingRuntime.stripePublishableKey,
     userId: user.id,
   });
@@ -376,7 +395,10 @@ function StepPaywallRuntime({
       displayPlan: selectedDisplayPlan,
       plan: selectedPlan,
       returnUrl: successReturnUrl,
-      runtimeConfig: checkoutRuntimeConfig,
+      runtimeConfig: activeCheckoutRuntimeConfig,
+      runtimeConfigRevisionId: activeBillingRuntime.revisionId,
+      paymentProfileId: activeBillingRuntime.paymentProfileId,
+      provider: checkoutProvider === 'stripe' ? 'stripe' : null,
       stripePublishableKey: activeBillingRuntime.stripePublishableKey,
       userId: user.id,
     }),
@@ -386,6 +408,10 @@ function StepPaywallRuntime({
       checkoutMode,
       checkoutPromoActive,
       activeBillingRuntime.stripePublishableKey,
+      activeBillingRuntime.paymentProfileId,
+      activeBillingRuntime.revisionId,
+      activeCheckoutRuntimeConfig,
+      checkoutProvider,
       selectedDisplayPlan,
       selectedPlan,
       successReturnUrl,
@@ -721,7 +747,7 @@ function StepPaywallRuntime({
             offerSetId: activeBillingRuntime.offerSetId,
             funnelPlanKey: selectedPlan.funnelPlanKey,
             returnUrl: checkoutPageUrl,
-            runtimeConfig: checkoutRuntimeConfig,
+            runtimeConfig: activeCheckoutRuntimeConfig,
             successUrl: successReturnUrl,
           }}
           onClose={closeCheckoutDialog}