@appfunnel-dev/sdk 0.7.0 → 0.9.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { A as AppFunnelConfig, P as PageDefinition, V as VariableValue, U as UserState, L as LocaleState, T as TranslationState, N as NavigationState, a as ProductsState, b as TrackingState, c as PaymentState, D as DeviceInfo, d as PageData, F as FunnelState } from './internal-C7seLJBr.cjs';
-export { C as ConditionConfig, e as ConditionGroupConfig, f as FunnelProvider, g as FunnelProviderProps, h as FunnelSettings, i as PageConfig, j as PageState, k as PageType, l as ProductConfig, m as ProductsConfig, n as Progress, R as RouteConfig, o as RuntimeProduct, p as VariableConfig, q as VariableType } from './internal-C7seLJBr.cjs';
+import { A as AppFunnelConfig, P as PageDefinition, V as VariableValue, U as UserState, L as LocaleState, T as TranslationState, N as NavigationState, a as ProductsState, b as TrackingState, c as PaymentState, D as DeviceInfo, d as PageData, F as FunnelState } from './internal-C9MOEdND.cjs';
+export { C as ConditionConfig, e as ConditionGroupConfig, f as FunnelProvider, g as FunnelProviderProps, h as FunnelSettings, i as PageConfig, j as PageState, k as PageType, l as ProductConfig, m as ProductsConfig, n as Progress, R as RouteConfig, o as RuntimeProduct, p as VariableConfig, q as VariableType } from './internal-C9MOEdND.cjs';
 import * as react from 'react';
 import { Appearance } from '@stripe/stripe-js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
@@ -190,12 +190,12 @@ declare function useNavigation(): NavigationState;
 declare function useProducts(): ProductsState;
 
 /**
- * Tracking hook — fire events and identify users.
+ * Tracking hook — fire custom events.
  */
 declare function useTracking(): TrackingState;
 
 /**
- * Payment hook — reads payment-related variables.
+ * Payment hook — reads payment-related variables and provides a purchase action.
  *
  * Only re-renders when payment/card variables change.
  */
@@ -283,11 +283,19 @@ interface StripePaymentFormProps {
     mode?: 'checkout' | 'validate-only';
     /** "elements" for PaymentElement, "embedded" for Stripe Embedded Checkout */
     variant?: 'elements' | 'embedded';
-    /** Called on successful payment */
+    /** Page key to redirect to after successful embedded checkout (required for embedded variant) */
+    successPageKey?: string;
+    /** Enable Stripe automatic tax calculation (embedded variant only) */
+    automaticTax?: boolean;
+    /** Enable Stripe managed payments — Stripe controls tax, payment methods, etc. (embedded variant only, forces embedded mode) */
+    managedPayments?: boolean;
+    /** Allow promotion codes in checkout (embedded variant only) */
+    allowPromotionCodes?: boolean;
+    /** Called on successful payment (elements variant only — embedded uses returnUrl redirect) */
     onSuccess?: () => void;
-    /** Called on payment error */
+    /** Called on payment error (elements variant only) */
     onError?: (error: string) => void;
-    /** Called when the Stripe form is ready to accept submissions */
+    /** Called when the Stripe form is ready to accept submissions (elements variant only) */
     onReady?: () => void;
     /** Additional CSS class */
     className?: string;
@@ -299,6 +307,9 @@ interface StripePaymentFormProps {
 /**
  * Stripe payment component supporting PaymentElement and Embedded Checkout.
  *
+ * In dev mode (`globalThis.__APPFUNNEL_DEV__`), renders a demo form that
+ * simulates Stripe UI and emulates purchases without real Stripe calls.
+ *
  * Use a ref to submit the form from an external button:
  * ```tsx
  * const paymentRef = useRef<StripePaymentHandle>(null)

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { A as AppFunnelConfig, P as PageDefinition, V as VariableValue, U as UserState, L as LocaleState, T as TranslationState, N as NavigationState, a as ProductsState, b as TrackingState, c as PaymentState, D as DeviceInfo, d as PageData, F as FunnelState } from './internal-C7seLJBr.js';
-export { C as ConditionConfig, e as ConditionGroupConfig, f as FunnelProvider, g as FunnelProviderProps, h as FunnelSettings, i as PageConfig, j as PageState, k as PageType, l as ProductConfig, m as ProductsConfig, n as Progress, R as RouteConfig, o as RuntimeProduct, p as VariableConfig, q as VariableType } from './internal-C7seLJBr.js';
+import { A as AppFunnelConfig, P as PageDefinition, V as VariableValue, U as UserState, L as LocaleState, T as TranslationState, N as NavigationState, a as ProductsState, b as TrackingState, c as PaymentState, D as DeviceInfo, d as PageData, F as FunnelState } from './internal-C9MOEdND.js';
+export { C as ConditionConfig, e as ConditionGroupConfig, f as FunnelProvider, g as FunnelProviderProps, h as FunnelSettings, i as PageConfig, j as PageState, k as PageType, l as ProductConfig, m as ProductsConfig, n as Progress, R as RouteConfig, o as RuntimeProduct, p as VariableConfig, q as VariableType } from './internal-C9MOEdND.js';
 import * as react from 'react';
 import { Appearance } from '@stripe/stripe-js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
@@ -190,12 +190,12 @@ declare function useNavigation(): NavigationState;
 declare function useProducts(): ProductsState;
 
 /**
- * Tracking hook — fire events and identify users.
+ * Tracking hook — fire custom events.
  */
 declare function useTracking(): TrackingState;
 
 /**
- * Payment hook — reads payment-related variables.
+ * Payment hook — reads payment-related variables and provides a purchase action.
  *
  * Only re-renders when payment/card variables change.
  */
@@ -283,11 +283,19 @@ interface StripePaymentFormProps {
     mode?: 'checkout' | 'validate-only';
     /** "elements" for PaymentElement, "embedded" for Stripe Embedded Checkout */
     variant?: 'elements' | 'embedded';
-    /** Called on successful payment */
+    /** Page key to redirect to after successful embedded checkout (required for embedded variant) */
+    successPageKey?: string;
+    /** Enable Stripe automatic tax calculation (embedded variant only) */
+    automaticTax?: boolean;
+    /** Enable Stripe managed payments — Stripe controls tax, payment methods, etc. (embedded variant only, forces embedded mode) */
+    managedPayments?: boolean;
+    /** Allow promotion codes in checkout (embedded variant only) */
+    allowPromotionCodes?: boolean;
+    /** Called on successful payment (elements variant only — embedded uses returnUrl redirect) */
     onSuccess?: () => void;
-    /** Called on payment error */
+    /** Called on payment error (elements variant only) */
     onError?: (error: string) => void;
-    /** Called when the Stripe form is ready to accept submissions */
+    /** Called when the Stripe form is ready to accept submissions (elements variant only) */
     onReady?: () => void;
     /** Additional CSS class */
     className?: string;
@@ -299,6 +307,9 @@ interface StripePaymentFormProps {
 /**
  * Stripe payment component supporting PaymentElement and Embedded Checkout.
  *
+ * In dev mode (`globalThis.__APPFUNNEL_DEV__`), renders a demo form that
+ * simulates Stripe UI and emulates purchases without real Stripe calls.
+ *
  * Use a ref to submit the form from an external button:
  * ```tsx
  * const paymentRef = useRef<StripePaymentHandle>(null)