@funnelsgrove/payments 0.11.24 → 0.12.0

package/README.md

@@ -17,7 +17,8 @@ Render every visible wallet placement with `StripeSubscriptionWalletSurface` or
 
 - Each surface owns one private Checkout Session per simultaneously visible wallet placement, isolated by its own `surfaceId`.
 - Simultaneously visible placements may use the same plan and coupon; nothing is shared because each surface keeps its own session.
-- When the selected plan changes, the surface updates the existing Checkout Session in place without changing `surfaceId`, React `key`, `clientSecret`, `CheckoutProvider`, or the Express Checkout iframe.
+- Changing the selected plan replaces the surface’s Checkout Session and `clientSecret`. A stable `surfaceId` identifies the placement; it does not guarantee that the Stripe iframe survives a plan change.
+- If payment confirmation is already in flight when the selection changes, the success callback remains bound to the original confirmed Checkout Session.
 
 Use these for new subscription paywalls:
 
@@ -54,7 +55,6 @@ provider-neutral status endpoint finds canonical shared-ledger payment evidence.
 
 Keep these exports available for saved drafts, old published artifacts, and controlled migrations. Do not use them for new subscription checkout work:
 
-- `createStripePaymentIntent`
 - `SharedStripeCheckoutDialog`
 - `ApplePaySubscribeButton`
 - `GooglePaySubscribeButton`
@@ -92,7 +92,7 @@ When a live funnel still uses one of these, migrate the funnel deliberately with
 - `services/runtimeBillingPlanCatalog.service`: test/live runtime catalog selection.
 - `services/paywallOffer.service`: timed discount and display-plan helpers.
 - `providers/paymentProvider.types`: provider-neutral checkout state shared by every adapter.
-- `providers/stripe/services/*`: Stripe loader, Checkout Session, hosted checkout, one-click, analytics, and deprecated PaymentIntent compatibility clients.
+- `providers/stripe/services/*`: Stripe loader, Checkout Session, hosted checkout, one-click, analytics, and one-click completion.
 - `providers/stripe/hooks/*`: Stripe-backed plan resolution and isolated card/wallet checkout-session state.
 - `providers/stripe/components/*`: plan selector, checkout dialogs, Express Checkout wrappers, wallet slots, placeholders, and trust assets.
 - `providers/stripe/testing/*`: Stripe wallet checkout smoke assertions.
@@ -111,16 +111,22 @@ service just to resolve or display plans. Shared config/services are checked for
 provider dependencies in `paymentBoundaries.test.ts`.
 
 Stripe browser operations live in `providers/stripe/services/checkout/`,
-`hostedCheckout/`, `oneClick/` and the compatibility-only `paymentIntent/`.
+`hostedCheckout/` and `oneClick/`.
 Keep request mappers (`requests.ts`) beside the short async operation functions;
 common validation and metadata normalization belong in the local `shared/` folder.
 `stripeClient.ts` owns the Stripe.js cache. One-click orchestration calls the
 charge and confirmation functions in its own folder, without a workflow layer.
 
-`stripe.service.ts` remains a compatibility export facade. All existing root
-exports, signatures, SDK payloads, errors and confirmation behavior remain intact.
-HTTP transport and V1/V2 endpoint choice belong to the runtime SDK, not payments.
-No automatic charge retry, V1 fallback, or extra conversion event is introduced.
+`stripe.service.ts` is the public export facade. From 0.12.0, all payment
+transport uses V2. `createStripePaymentIntent` is removed: migrate to
+`createStripeOneTimeCheckout` and its Checkout Session UI. Keep legacy published
+bundles on their pinned releases until their own migration passes checkout QA.
+Hosted checkout uses `createStripeCheckoutSession` with published profile,
+provider and plan selection plus `successUrl` and `cancelUrl`. Deploy hosted V2
+support before releasing this SDK. Subscription mutation callers forward the
+listed `subscriptionRef`; no provider ownership is reconstructed in the browser.
+HTTP transport belongs to the runtime SDK. No charge retry, V1 fallback or extra
+conversion event is introduced.
 
 ## Engineering Rules
 

package/dist/providers/solidgate/components/SolidgateCheckoutDialog.d.ts

@@ -1,67 +1,3 @@
-import type { FunnelSdkRuntimeConfigOverrides, FunnelStepType, RuntimeMode } from '@funnelsgrove/runtime';
-import { type PrepareSolidgateCheckoutInput, type SolidgateCheckoutPreparation } from '../services/solidgate.service.js';
-export type SolidgateCheckoutDialogState = 'collecting_email' | 'loading' | 'ready' | 'submitting' | 'verifying' | 'success' | 'recoverable_error' | 'expired';
-export type SolidgateCheckoutDialogContent = {
-    title: string;
-    closeAriaLabel: string;
-    loading: string;
-    submitting: string;
-    verifying: string;
-    success: string;
-    error: string;
-    expired: string;
-    retry: string;
-    resumeVerification: string;
-    customerEmailLabel: string;
-    customerEmailPlaceholder: string;
-    customerEmailInvalid: string;
-    customerEmailUnavailable: string;
-    customerEmailContinue: string;
-};
-export type SolidgateCheckoutDialogPresentation = {
-    buttonColor: string;
-    cardSubmitLabel: string;
-    countdownLabel: string;
-    discountAmountLabel: string;
-    discountLabel: string;
-    discountPercent: number;
-    originalPriceLabel: string;
-    originalPriceValue: string;
-    promoActive: boolean;
-    promoCode: string;
-    promoCodeLabel: string;
-    remainingSeconds: number;
-    satisfactionLabel: string;
-    satisfactionPercent: string;
-    savedLabel: string;
-    secureLabel: string;
-    themeColor: string;
-    title: string;
-    totalLabel: string;
-    totalValue: string;
-};
-export type SolidgateCheckoutDialogProps = {
-    open: boolean;
-    request: Omit<PrepareSolidgateCheckoutInput, 'signal'>;
-    customerEmail?: string | null;
-    checkoutAnalytics?: SolidgateCheckoutAnalyticsContext | null;
-    content?: Partial<SolidgateCheckoutDialogContent>;
-    presentation?: SolidgateCheckoutDialogPresentation;
-    onClose: () => void;
-    onCustomerEmailCommit?: (email: string) => Promise<string>;
-    onSuccess?: (checkout: SolidgateCheckoutPreparation) => void | Promise<void>;
-    onRetry?: () => void;
-    onError?: (message: string) => void;
-    onStateChange?: (state: SolidgateCheckoutDialogState) => void;
-};
-export type SolidgateCheckoutAnalyticsContext = {
-    environment?: RuntimeMode;
-    featureFlags?: Record<string, string | null | undefined>;
-    metadata?: Record<string, unknown> | null;
-    runtimeConfig?: FunnelSdkRuntimeConfigOverrides;
-    stepId: string;
-    stepName: string;
-    stepType: Extract<FunnelStepType, 'checkout' | 'paywall_offer' | 'upsell_offer'>;
-    stepContractVersion: number;
-};
+import type { SolidgateCheckoutDialogProps } from './SolidgateCheckoutDialog.types.js';
+export type { SolidgateCheckoutDialogState, SolidgateCheckoutDialogContent, SolidgateCheckoutDialogPresentation, SolidgateCheckoutDialogProps, SolidgateCheckoutAnalyticsContext, } from './SolidgateCheckoutDialog.types.js';
 export declare function SolidgateCheckoutDialog({ open, request, customerEmail, checkoutAnalytics, content, presentation, onClose, onCustomerEmailCommit, onSuccess, onRetry, onError, onStateChange, }: SolidgateCheckoutDialogProps): import("react/jsx-runtime").JSX.Element | null;