@funnelsgrove/payments 0.11.2 → 0.11.4

package/README.md

@@ -108,11 +108,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 Apple Pay / Google Pay intent. Checkout Sessions use confirmation as a fallback because Stripe omits their click callback.
+- 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 or cancellation as a fallback because Stripe omits their click callback. Cancellation recovers the start with `checkout_start_source: wallet_cancel`; its timestamp is dismissal time, not wallet-open time. Closing the browser before either callback is still unobservable. Cancel has no payment-method field, so the method is included only when the element enables exactly one method.
 - 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. Wallet confirmation may retry the start signal when the click callback is unavailable, without creating a duplicate.
+- Shared checkout analytics deduplicates `checkout_started` by Checkout Session id. Wallet confirmation and cancellation may retry the start signal when the click callback is unavailable, without creating a duplicate. Cancellation never emits payment-info or purchase completion events.
 - 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,16 +95,18 @@ export function StripeCheckoutExpressCheckoutButton({ beforeConfirm, checkoutAna
         }
         await (onSuccess === null || onSuccess === void 0 ? void 0 : onSuccess());
     };
-    const queueCheckoutStarted = (paymentMethod) => {
+    const queueCheckoutStarted = (paymentMethod, checkoutStartSource = 'wallet_click') => {
         if (!checkoutAnalytics) {
             return;
         }
-        queueStripeSubscriptionCheckoutStarted(Object.assign(Object.assign({}, checkoutAnalytics), { checkoutSessionId, checkoutStartSource: 'wallet_click', paymentMethod }));
+        queueStripeSubscriptionCheckoutStarted(Object.assign(Object.assign({}, checkoutAnalytics), { checkoutSessionId,
+            checkoutStartSource,
+            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.
+        // and cancellation are the reliable wallet-intent boundaries for this provider.
         // Session-based analytics deduplication keeps this idempotent if onClick fires.
         queueCheckoutStarted(event.expressPaymentType);
         if (checkoutState.type !== 'success') {
@@ -176,13 +178,22 @@ export function StripeCheckoutExpressCheckoutButton({ beforeConfirm, checkoutAna
         queueCheckoutStarted(event.expressPaymentType);
         event.resolve();
     };
+    const handleCancel = () => {
+        var _a;
+        // Dismissal proves the wallet was opened, even when Stripe omitted onClick.
+        // Cancel has no method field; only single-method placements can identify it.
+        const enabledMethods = Object.entries((_a = resolvedOptions.paymentMethods) !== null && _a !== void 0 ? _a : {})
+            .filter(([, availability]) => availability !== 'never');
+        queueCheckoutStarted(enabledMethods.length === 1 ? enabledMethods[0][0] : undefined, 'wallet_cancel');
+        onCancel === null || onCancel === void 0 ? void 0 : onCancel();
+    };
     return (_jsxs(_Fragment, { children: [_jsx("div", { className: [
                     'stripe-express-checkout-button',
                     className !== null && className !== void 0 ? className : '',
                     effectiveWalletAvailable === false ? 'is-hidden' : '',
                 ]
                     .filter(Boolean)
-                    .join(' '), children: _jsx(ExpressCheckoutElementWithCancel, { options: resolvedOptions, onCancel: onCancel, onClick: handleClick, onConfirm: (event) => void handleConfirm(event), onLoadError: ({ error }) => {
+                    .join(' '), children: _jsx(ExpressCheckoutElementWithCancel, { options: resolvedOptions, onCancel: handleCancel, onClick: handleClick, onConfirm: (event) => void handleConfirm(event), onLoadError: ({ error }) => {
                         setWalletAvailable(false);
                         onAvailabilityChange === null || onAvailabilityChange === void 0 ? void 0 : onAvailabilityChange(false);
                         onError === null || onError === void 0 ? void 0 : onError(error.message || 'Unable to load wallet checkout.');

package/dist/providers/stripe/services/checkoutCompletionAnalytics.service.d.ts

@@ -12,7 +12,7 @@ export type StripeSubscriptionCheckoutAnalyticsContext = {
 };
 export type TrackStripeSubscriptionCheckoutStartedInput = StripeSubscriptionCheckoutAnalyticsContext & {
     checkoutSessionId?: string | null;
-    checkoutStartSource?: 'card_form_open' | 'wallet_click';
+    checkoutStartSource?: 'card_form_open' | 'wallet_click' | 'wallet_cancel';
     paymentMethod?: unknown;
 };
 export type TrackPaidStripeSubscriptionCheckoutCompletedInput = StripeSubscriptionCheckoutAnalyticsContext & {

package/dist/providers/stripe/services/stripe.service.js

@@ -284,10 +284,44 @@ const currentCheckoutUrl = () => {
     }
     return sanitizeCheckoutUrl((_a = window.location) === null || _a === void 0 ? void 0 : _a.href);
 };
+const readMetaCookieValue = (name) => {
+    var _a;
+    if (typeof document === 'undefined') {
+        return undefined;
+    }
+    let cookieHeader;
+    try {
+        cookieHeader = document.cookie;
+    }
+    catch (_b) {
+        return undefined;
+    }
+    const encodedValue = (_a = cookieHeader
+        .split(';')
+        .map((part) => part.trim())
+        .find((part) => part.startsWith(`${name}=`))) === null || _a === void 0 ? void 0 : _a.slice(name.length + 1);
+    if (!encodedValue) {
+        return undefined;
+    }
+    try {
+        const value = decodeURIComponent(encodedValue).trim();
+        return value && value.length <= 2048 ? value : undefined;
+    }
+    catch (_c) {
+        const value = encodedValue.trim();
+        return value && value.length <= 2048 ? value : undefined;
+    }
+};
 const normalizeAnalyticsMetadata = (metadata) => {
     const normalized = Object.fromEntries(Object.entries(isRecord(metadata) ? metadata : {}).filter(([, value]) => value !== undefined && value !== null && value !== ''));
+    const fbc = asTrimmedStringOrNull(normalized.fbc)
+        || asTrimmedStringOrNull(normalized._fbc)
+        || readMetaCookieValue('_fbc');
+    const fbp = asTrimmedStringOrNull(normalized.fbp)
+        || asTrimmedStringOrNull(normalized._fbp)
+        || readMetaCookieValue('_fbp');
     const checkoutUrl = sanitizeCheckoutUrl(normalized.url) || currentCheckoutUrl();
-    const withCheckoutUrl = checkoutUrl ? Object.assign(Object.assign({}, normalized), { url: checkoutUrl }) : normalized;
+    const withCheckoutUrl = Object.assign(Object.assign(Object.assign(Object.assign({}, normalized), (fbc ? { fbc } : {})), (fbp ? { fbp } : {})), (checkoutUrl ? { url: checkoutUrl } : {}));
     return Object.keys(withCheckoutUrl).length > 0 ? withCheckoutUrl : undefined;
 };
 const normalizeCheckoutAnalyticsMetadata = (metadata, plan) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@funnelsgrove/payments",
-  "version": "0.11.2",
+  "version": "0.11.4",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/The-Solid-Grove/funnelsgrove.git",
@@ -32,8 +32,8 @@
     "test:run": "vitest run --passWithNoTests"
   },
   "dependencies": {
-    "@funnelsgrove/analytics": "^0.1.85",
-    "@funnelsgrove/runtime": "^0.11.1",
+    "@funnelsgrove/analytics": "^0.1.86",
+    "@funnelsgrove/runtime": "^0.11.2",
     "@solidgate/react-sdk": "1.34.0",
     "@stripe/react-stripe-js": "^5.6.0",
     "@stripe/stripe-js": "^8.7.0",