@funnelsgrove/payments 0.9.0 → 0.9.1

package/README.md

@@ -106,11 +106,11 @@ Funnels should call `resolvePublishedBillingRuntime` once at their runtime-provi
 - Stripe owns real card fields and wallet controls. Local wallet buttons are placeholders until Stripe confirms availability.
 - Keep `planId` as the funnel plan key and send Stripe's price id only as `providerPlanId`; the API uses both fields to resolve the active test/live offer mapping.
 - Wallet unavailable state must fall back to card/manual checkout or disappear.
-- Count `checkout_started` only at shared UI boundaries: when a shared card dialog opens or when Stripe reports an Apple Pay / Google Pay button click.
+- Count `checkout_started` only at shared UI boundaries: when a shared card dialog opens or when Stripe reports Apple Pay / Google Pay intent. Checkout Sessions use confirmation as a fallback because Stripe omits their click callback.
 - Pass `checkoutAnalytics` to every current shared dialog and wallet surface. The package then owns `checkout_started`, `add_payment_info`, and verified `checkout_completed`, all deduplicated by the actual Checkout Session.
 - Call funnel lifecycle `completeStep` only from the shared checkout `onSuccess` callback. Payment-info submission is not step completion.
 - Wallet slots may create render-only Checkout Sessions on mount so Apple Pay and Google Pay render before the visitor taps. Session creation is technical preparation and must never emit `checkout_started`.
-- Shared checkout analytics deduplicates `checkout_started` by Checkout Session id. Card submit and wallet confirmation must not emit it again.
+- Shared checkout analytics deduplicates `checkout_started` by Checkout Session id. Wallet confirmation may retry the start signal when the click callback is unavailable, without creating a duplicate.
 - Do not call `publicAnalyticsSdk.trackCheckoutStarted`, `trackPaymentInfoSubmitted`, or `trackCheckoutCompleted` directly from funnel checkout components.
 - Funnel paywalls should style wallet buttons through the shared slot API: `className` for the Stripe button/placeholder, `slotClassName` for the outer slot, `appearance` for Stripe Elements appearance, and `options` for Stripe Express Checkout options.
 - Keep discount math reusable here, but keep offer activation timing in funnel code.

package/dist/providers/stripe/components/StripeCheckoutExpressCheckoutButton.js

@@ -95,8 +95,18 @@ export function StripeCheckoutExpressCheckoutButton({ beforeConfirm, checkoutAna
         }
         await (onSuccess === null || onSuccess === void 0 ? void 0 : onSuccess());
     };
+    const queueCheckoutStarted = (paymentMethod) => {
+        if (!checkoutAnalytics) {
+            return;
+        }
+        queueStripeSubscriptionCheckoutStarted(Object.assign(Object.assign({}, checkoutAnalytics), { checkoutSessionId, checkoutStartSource: 'wallet_click', paymentMethod }));
+    };
     const handleConfirm = async (event) => {
         var _a, _b, _c;
+        // Checkout Sessions omits the Express Checkout onClick callback. Confirmation
+        // is therefore the first reliable wallet-intent boundary for this provider.
+        // Session-based analytics deduplication keeps this idempotent if onClick fires.
+        queueCheckoutStarted(event.expressPaymentType);
         if (checkoutState.type !== 'success') {
             const message = checkoutState.type === 'error'
                 ? checkoutState.error.message
@@ -163,9 +173,7 @@ export function StripeCheckoutExpressCheckoutButton({ beforeConfirm, checkoutAna
         }
     };
     const handleClick = (event) => {
-        if (checkoutAnalytics) {
-            queueStripeSubscriptionCheckoutStarted(Object.assign(Object.assign({}, checkoutAnalytics), { checkoutSessionId, checkoutStartSource: 'wallet_click', paymentMethod: event.expressPaymentType }));
-        }
+        queueCheckoutStarted(event.expressPaymentType);
         event.resolve();
     };
     return (_jsxs(_Fragment, { children: [_jsx("div", { className: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@funnelsgrove/payments",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/The-Solid-Grove/funnelsgrove.git",