@funnelsgrove/payments 0.15.5 → 0.15.7

package/README.md

@@ -39,7 +39,7 @@ Use these for new one-time paywall plans:
 `variant='compact'` for a centered desktop modal with the same Stripe-owned wallet/card flow;
 mobile remains full-screen and all checkout analytics and verified-success behavior are unchanged.
 
-Use `completeStripeOneClickPayment` for normal post-checkout one-click upsells. It delegates the charge to `funnelSdkService.chargeOneClickPayment` and owns any required Stripe confirmation. `chargeStripeOneClickPayment` remains the lower-level charge-only primitive.
+Use `completeStripeOneClickPayment` for normal post-checkout one-click upsells. It delegates the charge to `funnelSdkService.chargeOneClickPayment` and owns any required Stripe confirmation. Pass its optional `checkoutAnalytics` context to let the shared package emit `checkout_completed` only after `succeeded`, including after required confirmation. The context uses `StripeSubscriptionCheckoutAnalyticsContext`; completion is deduplicated by PaymentIntent ID, and analytics failures do not fail the payment. Funnel code supplies the context and completes its step; the shared package owns the analytics callback. `chargeStripeOneClickPayment` remains the lower-level charge-only primitive.
 
 Solidgate browser checkout is available for controlled provider-routed funnels through
 `SolidgateCheckoutDialog`, `prepareSolidgateCheckout`, and `pollSolidgateCheckoutStatus`. The dialog
@@ -136,6 +136,7 @@ conversion event is introduced.
 - 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 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.
+- Payment submission triggers, validation, declines, and retry identity follow [AE-BR-001–004](../../docs/product-specs/analytics-events.md#payment-information-submission). Keep that behavior inside shared checkout surfaces.
 - 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 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.

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

@@ -72,6 +72,7 @@ function SharedStripeCheckoutV2CheckoutSessionForm({ amountCents, buttonColor, c
     const [submitting, setSubmitting] = useState(false);
     const submitInFlightRef = useRef(false);
     const [paymentElementReady, setPaymentElementReady] = useState(false);
+    const [paymentElementComplete, setPaymentElementComplete] = useState(false);
     const [error, setError] = useState(null);
     const [billingCountry, setBillingCountry] = useState(null);
     const initialCustomerEmail = (customerEmail === null || customerEmail === void 0 ? void 0 : customerEmail.trim()) || '';
@@ -194,6 +195,7 @@ function SharedStripeCheckoutV2CheckoutSessionForm({ amountCents, buttonColor, c
     });
     const handlePaymentElementChange = (event) => {
         var _a, _b;
+        setPaymentElementComplete(event.complete);
         setBillingCountry((_b = (_a = event.value.billingDetails) === null || _a === void 0 ? void 0 : _a.address.country) !== null && _b !== void 0 ? _b : fixedBillingCountry);
     };
     const trackCheckoutSuccess = async () => {
@@ -282,7 +284,9 @@ function SharedStripeCheckoutV2CheckoutSessionForm({ amountCents, buttonColor, c
                 finishSubmitting();
                 return;
             }
-            await trackPaymentInfoSubmitted();
+            if (paymentElementComplete) {
+                await trackPaymentInfoSubmitted();
+            }
             const result = await checkoutState.checkout.confirm({
                 redirect: 'if_required',
             });

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

@@ -1,5 +1,6 @@
 import type { FunnelStepType, RuntimeMode } from '@funnelsgrove/runtime';
-import { type StripeRuntimeConfigOverrides } from './stripe.service.js';
+import type { StripeRuntimeConfigOverrides } from './shared/types.js';
+import type { ChargeOneClickPaymentResponse, CompleteStripeOneClickPaymentInput } from './oneClick/types.js';
 export type StripeSubscriptionCheckoutAnalyticsContext = {
     environment?: RuntimeMode;
     featureFlags?: Record<string, string | null | undefined>;
@@ -28,3 +29,4 @@ export declare function trackStripeSubscriptionCheckoutStarted(input: TrackStrip
 export declare function queueStripeSubscriptionCheckoutStarted(input: TrackStripeSubscriptionCheckoutStartedInput): void;
 export declare function trackStripeSubscriptionPaymentInfoSubmitted(input: TrackStripeSubscriptionPaymentInfoSubmittedInput): Promise<TrackStripeSubscriptionPaymentInfoSubmittedResult>;
 export declare function trackPaidStripeSubscriptionCheckoutCompleted(input: TrackPaidStripeSubscriptionCheckoutCompletedInput): Promise<TrackPaidStripeSubscriptionCheckoutCompletedResult>;
+export declare function trackPaidStripeOneClickPaymentCompleted(input: CompleteStripeOneClickPaymentInput, payment: ChargeOneClickPaymentResponse): Promise<void>;

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

@@ -10,7 +10,7 @@ var __rest = (this && this.__rest) || function (s, e) {
     return t;
 };
 import { publicAnalyticsSdk, } from '@funnelsgrove/analytics';
-import { verifyStripeSubscriptionCheckoutPayment, } from './stripe.service.js';
+import { verifyStripeSubscriptionCheckoutPayment } from './checkout/verifySubscriptionCheckoutPayment.js';
 import { toAnalyticsPaymentMethod } from '../../../services/paymentMethodAnalytics.service.js';
 const asRecord = (value) => {
     return value && typeof value === 'object' && !Array.isArray(value)
@@ -175,3 +175,41 @@ export async function trackPaidStripeSubscriptionCheckoutCompleted(input) {
         activeCheckoutCompletionKeys.delete(completionKey);
     }
 }
+export async function trackPaidStripeOneClickPaymentCompleted(input, payment) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+    const context = input.checkoutAnalytics;
+    const paymentIntentId = (_a = payment.paymentIntentId) === null || _a === void 0 ? void 0 : _a.trim();
+    if (!context || payment.status !== 'succeeded' || !paymentIntentId) {
+        return;
+    }
+    const runtimeConfig = (_b = input.runtimeConfig) !== null && _b !== void 0 ? _b : context.runtimeConfig;
+    const completionKey = buildCheckoutStorageKey('checkout_completed', paymentIntentId, runtimeConfig);
+    if (activeCheckoutCompletionKeys.has(completionKey)
+        || hasTrackedCheckoutSession('checkout_completed', paymentIntentId, runtimeConfig)) {
+        return;
+    }
+    activeCheckoutCompletionKeys.add(completionKey);
+    try {
+        const userId = ((_c = input.userId) === null || _c === void 0 ? void 0 : _c.trim()) || ((_d = input.user_id) === null || _d === void 0 ? void 0 : _d.trim());
+        const environment = (_f = (_e = payment.environment) !== null && _e !== void 0 ? _e : input.environment) !== null && _f !== void 0 ? _f : context.environment;
+        const eventId = publicAnalyticsSdk.trackCheckoutCompleted({
+            eventId: paymentIntentId,
+            userId,
+            environment,
+            stepId: context.stepId,
+            stepName: context.stepName,
+            stepType: context.stepType,
+            stepContractVersion: context.stepContractVersion,
+            featureFlags: context.featureFlags,
+            metadata: Object.assign(Object.assign(Object.assign({}, asRecord(input.analyticsMetadata)), asRecord(context.metadata)), { userId,
+                environment, amountCents: (_g = payment.amountCents) !== null && _g !== void 0 ? _g : input.amountCents, currency: (_j = (_h = payment.currency) !== null && _h !== void 0 ? _h : input.currency) !== null && _j !== void 0 ? _j : 'usd', planId: input.planId, providerPlanId: input.providerPlanId, payment_provider: 'stripe' }),
+        });
+        if (eventId) {
+            markCheckoutSessionTracked('checkout_completed', paymentIntentId, runtimeConfig);
+            await publicAnalyticsSdk.flush().catch(() => 0);
+        }
+    }
+    finally {
+        activeCheckoutCompletionKeys.delete(completionKey);
+    }
+}

package/dist/providers/stripe/services/oneClick/completePayment.js

@@ -1,13 +1,18 @@
 import { chargeStripeOneClickPayment } from './chargePayment.js';
 import { confirmOneClickPayment } from './confirmation.js';
+import { trackPaidStripeOneClickPaymentCompleted } from '../checkoutCompletionAnalytics.service.js';
 export const requiresStripeOneClickConfirmation = (status) => {
     return status === 'requires_action' || status === 'requires_confirmation';
 };
 export async function completeStripeOneClickPayment(input) {
     const payment = await chargeStripeOneClickPayment(input);
-    if (!requiresStripeOneClickConfirmation(payment.status)) {
-        return Object.assign(Object.assign({}, payment), { confirmationAttempted: false });
+    const confirmationAttempted = requiresStripeOneClickConfirmation(payment.status);
+    const result = Object.assign(Object.assign({}, payment), { status: confirmationAttempted ? await confirmOneClickPayment(payment, input) : payment.status, confirmationAttempted });
+    try {
+        await trackPaidStripeOneClickPaymentCompleted(input, result);
     }
-    const status = await confirmOneClickPayment(payment, input);
-    return Object.assign(Object.assign({}, payment), { status, confirmationAttempted: true });
+    catch (_a) {
+        // Analytics cannot turn a successful charge into a payment retry.
+    }
+    return result;
 }

package/dist/providers/stripe/services/oneClick/types.d.ts

@@ -1,5 +1,6 @@
 import type { RuntimeMode } from '@funnelsgrove/runtime';
 import type { StripeRuntimeConfigOverrides } from '../shared/types.js';
+import type { StripeSubscriptionCheckoutAnalyticsContext } from '../checkoutCompletionAnalytics.service.js';
 export type ChargeOneClickPaymentInput = {
     planId: string;
     planKey?: string | null;
@@ -34,6 +35,7 @@ export type ChargeOneClickPaymentResponse = {
 };
 export type CompleteStripeOneClickPaymentInput = ChargeOneClickPaymentInput & {
     returnUrl: string;
+    checkoutAnalytics?: StripeSubscriptionCheckoutAnalyticsContext;
 };
 export type CompleteStripeOneClickPaymentResponse = ChargeOneClickPaymentResponse & {
     confirmationAttempted: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@funnelsgrove/payments",
-  "version": "0.15.5",
+  "version": "0.15.7",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/The-Solid-Grove/funnelsgrove.git",
@@ -32,7 +32,7 @@
     "test:run": "vitest run --passWithNoTests"
   },
   "dependencies": {
-    "@funnelsgrove/analytics": "0.1.102",
+    "@funnelsgrove/analytics": "0.1.104",
     "@funnelsgrove/runtime": "0.14.2",
     "@solidgate/react-sdk": "1.34.0",
     "@stripe/react-stripe-js": "^5.6.0",