@vue-stripe/vue-stripe 4.5.0 → 5.1.1

package/dist/types/components/index.d.ts

@@ -0,0 +1,12 @@
+export { default as VueStripeProvider } from './VueStripeProvider.vue';
+export { default as VueStripeElements } from './VueStripeElements.vue';
+export { default as VueStripePaymentElement } from './VueStripePaymentElement.vue';
+export { default as VueStripeExpressCheckoutElement } from './VueStripeExpressCheckoutElement.vue';
+export { default as VueStripeCardElement } from './VueStripeCardElement.vue';
+export { default as VueStripeCardNumberElement } from './VueStripeCardNumberElement.vue';
+export { default as VueStripeCardExpiryElement } from './VueStripeCardExpiryElement.vue';
+export { default as VueStripeCardCvcElement } from './VueStripeCardCvcElement.vue';
+export { default as VueStripeLinkAuthenticationElement } from './VueStripeLinkAuthenticationElement.vue';
+export { default as VueStripeAddressElement } from './VueStripeAddressElement.vue';
+export { default as VueStripeCheckout } from './VueStripeCheckout.vue';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AACtE,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAGtE,OAAO,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,+BAA+B,CAAA;AAClF,OAAO,EAAE,OAAO,IAAI,+BAA+B,EAAE,MAAM,uCAAuC,CAAA;AAGlG,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAC5E,OAAO,EAAE,OAAO,IAAI,0BAA0B,EAAE,MAAM,kCAAkC,CAAA;AACxF,OAAO,EAAE,OAAO,IAAI,0BAA0B,EAAE,MAAM,kCAAkC,CAAA;AACxF,OAAO,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,+BAA+B,CAAA;AAGlF,OAAO,EAAE,OAAO,IAAI,kCAAkC,EAAE,MAAM,0CAA0C,CAAA;AACxG,OAAO,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,+BAA+B,CAAA;AAGlF,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,yBAAyB,CAAA"}

package/dist/types/composables/index.d.ts

@@ -0,0 +1,6 @@
+export { useStripe } from './useStripe';
+export { usePaymentIntent } from './usePaymentIntent';
+export { useSetupIntent } from './useSetupIntent';
+export { useStripeCheckout, useStripeCheckout as useCheckout } from './useStripeCheckout';
+export { useStripeElements, useStripeElements as useElements } from './useStripeElements';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/composables/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/composables/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,IAAI,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACzF,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,IAAI,WAAW,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/types/composables/usePaymentIntent.d.ts

@@ -0,0 +1,45 @@
+import { ConfirmPaymentData, StripeElements } from '@stripe/stripe-js';
+import { UsePaymentIntentReturn } from '../types';
+/**
+ * Options for confirming a payment
+ */
+export interface ConfirmPaymentOptions {
+    /** Client secret from the PaymentIntent */
+    clientSecret: string;
+    /** Additional confirmation parameters */
+    confirmParams?: ConfirmPaymentData;
+    /** Whether to redirect (defaults to 'if_required') */
+    redirect?: 'if_required' | 'always';
+    /** Optional elements override (uses injected elements if not provided) */
+    elements?: StripeElements;
+    /** Skip elements.submit() validation (not recommended, defaults to false) */
+    skipSubmit?: boolean;
+}
+/**
+ * Composable for handling payment intents
+ * Provides a convenient way to confirm payments
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { usePaymentIntent } from '@vue-stripe/vue-stripe'
+ *
+ * const { confirmPayment, loading, error } = usePaymentIntent()
+ *
+ * const handleSubmit = async () => {
+ *   const result = await confirmPayment({
+ *     clientSecret: 'pi_xxx_secret_xxx',
+ *     confirmParams: {
+ *       return_url: 'https://example.com/checkout/complete',
+ *     },
+ *   })
+ *
+ *   if (result.error) {
+ *     // Handle error
+ *   }
+ * }
+ * </script>
+ * ```
+ */
+export declare function usePaymentIntent(): UsePaymentIntentReturn;
+//# sourceMappingURL=usePaymentIntent.d.ts.map

package/dist/types/composables/usePaymentIntent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePaymentIntent.d.ts","sourceRoot":"","sources":["../../../src/composables/usePaymentIntent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAC3E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAA;AAItD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,2CAA2C;IAC3C,YAAY,EAAE,MAAM,CAAA;IACpB,yCAAyC;IACzC,aAAa,CAAC,EAAE,kBAAkB,CAAA;IAClC,sDAAsD;IACtD,QAAQ,CAAC,EAAE,aAAa,GAAG,QAAQ,CAAA;IACnC,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,cAAc,CAAA;IACzB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,gBAAgB,IAAI,sBAAsB,CAgEzD"}

package/dist/types/composables/useSetupIntent.d.ts

@@ -0,0 +1,62 @@
+import { StripeElements } from '@stripe/stripe-js';
+import { UseSetupIntentReturn } from '../types';
+/**
+ * Options for confirming a setup
+ */
+export interface ConfirmSetupOptions {
+    /** Client secret from the SetupIntent */
+    clientSecret: string;
+    /** Additional confirmation parameters */
+    confirmParams?: {
+        return_url?: string;
+        payment_method_data?: {
+            billing_details?: {
+                name?: string;
+                email?: string;
+                phone?: string;
+                address?: {
+                    line1?: string;
+                    line2?: string;
+                    city?: string;
+                    state?: string;
+                    postal_code?: string;
+                    country?: string;
+                };
+            };
+        };
+    };
+    /** Whether to redirect (defaults to 'if_required') */
+    redirect?: 'if_required' | 'always';
+    /** Optional elements override (uses injected elements if not provided) */
+    elements?: StripeElements;
+    /** Skip elements.submit() validation (not recommended, defaults to false) */
+    skipSubmit?: boolean;
+}
+/**
+ * Composable for handling setup intents
+ * Provides a convenient way to save payment methods for future use
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useSetupIntent } from '@vue-stripe/vue-stripe'
+ *
+ * const { confirmSetup, loading, error } = useSetupIntent()
+ *
+ * const handleSaveCard = async () => {
+ *   const result = await confirmSetup({
+ *     clientSecret: setupIntent.clientSecret,
+ *     confirmParams: {
+ *       return_url: 'https://example.com/account/cards',
+ *     },
+ *   })
+ *
+ *   if (result.error) {
+ *     // Handle error
+ *   }
+ * }
+ * </script>
+ * ```
+ */
+export declare function useSetupIntent(): UseSetupIntentReturn;
+//# sourceMappingURL=useSetupIntent.d.ts.map

package/dist/types/composables/useSetupIntent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSetupIntent.d.ts","sourceRoot":"","sources":["../../../src/composables/useSetupIntent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAIpD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAA;IACpB,yCAAyC;IACzC,aAAa,CAAC,EAAE;QACd,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,mBAAmB,CAAC,EAAE;YACpB,eAAe,CAAC,EAAE;gBAChB,IAAI,CAAC,EAAE,MAAM,CAAA;gBACb,KAAK,CAAC,EAAE,MAAM,CAAA;gBACd,KAAK,CAAC,EAAE,MAAM,CAAA;gBACd,OAAO,CAAC,EAAE;oBACR,KAAK,CAAC,EAAE,MAAM,CAAA;oBACd,KAAK,CAAC,EAAE,MAAM,CAAA;oBACd,IAAI,CAAC,EAAE,MAAM,CAAA;oBACb,KAAK,CAAC,EAAE,MAAM,CAAA;oBACd,WAAW,CAAC,EAAE,MAAM,CAAA;oBACpB,OAAO,CAAC,EAAE,MAAM,CAAA;iBACjB,CAAA;aACF,CAAA;SACF,CAAA;KACF,CAAA;IACD,sDAAsD;IACtD,QAAQ,CAAC,EAAE,aAAa,GAAG,QAAQ,CAAA;IACnC,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,cAAc,CAAA;IACzB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,cAAc,IAAI,oBAAoB,CAgErD"}

package/dist/types/composables/useStripe.d.ts

@@ -0,0 +1,27 @@
+import { UseStripeReturn } from '../types';
+/**
+ * Composable to access the Stripe instance
+ * Must be used within a VueStripeProvider component
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useStripe } from '@vue-stripe/vue-stripe'
+ *
+ * const { stripe, loading, error } = useStripe()
+ *
+ * const handlePayment = async () => {
+ *   if (!stripe.value) return
+ *
+ *   const result = await stripe.value.confirmPayment({
+ *     elements,
+ *     confirmParams: {
+ *       return_url: 'https://example.com/checkout/complete',
+ *     },
+ *   })
+ * }
+ * </script>
+ * ```
+ */
+export declare function useStripe(): UseStripeReturn;
+//# sourceMappingURL=useStripe.d.ts.map

package/dist/types/composables/useStripe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStripe.d.ts","sourceRoot":"","sources":["../../../src/composables/useStripe.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAI/C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,SAAS,IAAI,eAAe,CAkB3C"}

package/dist/types/composables/useStripeCheckout.d.ts

@@ -0,0 +1,72 @@
+import { Ref } from 'vue-demi';
+/**
+ * Options for URL-based checkout redirect (v8.x compatible)
+ */
+export interface CheckoutRedirectOptions {
+    /** The checkout session URL from your server */
+    url: string;
+}
+/**
+ * Options for legacy redirectToCheckout (v7.x only)
+ * @deprecated Use CheckoutRedirectOptions with URL redirect instead
+ */
+export interface LegacyCheckoutOptions {
+    /** Checkout Session ID */
+    sessionId?: string;
+    /** Line items for client-side session creation */
+    lineItems?: Array<{
+        price: string;
+        quantity: number;
+    }>;
+    /** Checkout mode */
+    mode?: 'payment' | 'subscription' | 'setup';
+    /** Success redirect URL */
+    successUrl?: string;
+    /** Cancel redirect URL */
+    cancelUrl?: string;
+}
+export interface UseStripeCheckoutReturn {
+    /**
+     * Redirect to Stripe Checkout using session URL (v8.x compatible, recommended)
+     */
+    redirectToCheckout: (options: CheckoutRedirectOptions | LegacyCheckoutOptions) => Promise<void>;
+    /**
+     * Redirect to checkout using session URL (v8.x compatible)
+     */
+    redirectToUrl: (url: string) => void;
+    loading: Readonly<Ref<boolean>>;
+    error: Readonly<Ref<string | null>>;
+}
+/**
+ * Composable for handling Stripe Checkout redirects.
+ *
+ * Supports both @stripe/stripe-js v7.x (redirectToCheckout) and v8.x (URL redirect).
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useStripeCheckout } from '@vue-stripe/vue-stripe'
+ *
+ * const { redirectToCheckout, redirectToUrl, loading, error } = useStripeCheckout()
+ *
+ * // v8.x compatible (recommended)
+ * const handleCheckout = async () => {
+ *   const response = await fetch('/api/create-checkout-session', {
+ *     method: 'POST',
+ *     body: JSON.stringify({ priceId: 'price_xxx' })
+ *   })
+ *   const { url } = await response.json()
+ *   redirectToUrl(url)
+ * }
+ *
+ * // Or using redirectToCheckout with URL
+ * const handleCheckoutAlt = async () => {
+ *   const response = await fetch('/api/create-checkout-session')
+ *   const { url } = await response.json()
+ *   await redirectToCheckout({ url })
+ * }
+ * </script>
+ * ```
+ */
+export declare function useStripeCheckout(): UseStripeCheckoutReturn;
+//# sourceMappingURL=useStripeCheckout.d.ts.map

package/dist/types/composables/useStripeCheckout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStripeCheckout.d.ts","sourceRoot":"","sources":["../../../src/composables/useStripeCheckout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,GAAG,EAAE,MAAM,UAAU,CAAA;AAIlD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kDAAkD;IAClD,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACtD,oBAAoB;IACpB,IAAI,CAAC,EAAE,SAAS,GAAG,cAAc,GAAG,OAAO,CAAA;IAC3C,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,kBAAkB,EAAE,CAAC,OAAO,EAAE,uBAAuB,GAAG,qBAAqB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/F;;OAEG;IACH,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IACpC,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAA;IAC/B,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAA;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,iBAAiB,IAAI,uBAAuB,CAiF3D"}

package/dist/types/composables/useStripeElements.d.ts

@@ -0,0 +1,26 @@
+import { UseStripeElementsReturn } from '../types';
+/**
+ * Composable for accessing Stripe Elements instance
+ * Must be used within VueStripeElements component
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useStripeElements } from '@vue-stripe/vue-stripe'
+ *
+ * const { elements, submit, loading, error } = useStripeElements()
+ *
+ * const handleSubmit = async () => {
+ *   // Trigger form validation and wallet collection
+ *   const { error: submitError } = await submit()
+ *   if (submitError) {
+ *     console.error(submitError)
+ *     return
+ *   }
+ *   // Proceed with payment confirmation...
+ * }
+ * </script>
+ * ```
+ */
+export declare function useStripeElements(): UseStripeElementsReturn;
+//# sourceMappingURL=useStripeElements.d.ts.map

package/dist/types/composables/useStripeElements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStripeElements.d.ts","sourceRoot":"","sources":["../../../src/composables/useStripeElements.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAA;AAIvD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,iBAAiB,IAAI,uBAAuB,CA6B3D"}

package/dist/types/index.d.ts

@@ -0,0 +1,7 @@
+export type { VueStripeOptions, VueStripeElement, VueStripeProviderProps, VueStripeElementsProps, VueStripeElementEvents, UseStripeReturn, UseStripeElementsReturn, UsePaymentIntentReturn, UseSetupIntentReturn, PaymentElementType, ExpressCheckoutType, VueStripeError, VueStripeContext, VueStripeElementsContext, Stripe, StripeElements, StripeElement, StripeElementType, StripeElementsOptions, StripeElementChangeEvent, PaymentIntent, SetupIntent, ConfirmPaymentData, ConfirmCardSetupData, StripeCardElement, StripeCardNumberElement, StripeCardExpiryElement, StripeCardCvcElement, StripePaymentElement, StripeAddressElement, StripeLinkAuthenticationElement, StripeExpressCheckoutElement, StripeCardElementChangeEvent, StripePaymentElementChangeEvent, StripeAddressElementChangeEvent, StripeLinkAuthenticationElementChangeEvent, StripeExpressCheckoutElementConfirmEvent, StripeExpressCheckoutElementClickEvent } from './types';
+export * from './components';
+export * from './composables';
+export { VueStripeProviderError, VueStripeElementsError, VueStripeLoadError, createVueStripeError } from './utils/errors';
+export { createVueStripe } from './plugin';
+export { loadStripe } from '@stripe/stripe-js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAEA,YAAY,EAEV,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,eAAe,EACf,uBAAuB,EACvB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,wBAAwB,EAExB,MAAM,EACN,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,wBAAwB,EACxB,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,oBAAoB,EAEpB,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,+BAA+B,EAC/B,4BAA4B,EAE5B,4BAA4B,EAC5B,+BAA+B,EAC/B,+BAA+B,EAC/B,0CAA0C,EAC1C,wCAAwC,EACxC,sCAAsC,EACvC,MAAM,SAAS,CAAA;AAGhB,cAAc,cAAc,CAAA;AAG5B,cAAc,eAAe,CAAA;AAG7B,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,gBAAgB,CAAA;AAGvB,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAG1C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/types/plugin.d.ts

@@ -0,0 +1,23 @@
+import { Plugin } from 'vue-demi';
+import { VueStripeOptions } from './types';
+/**
+ * Vue Stripe Plugin
+ *
+ * @example
+ * ```ts
+ * import { createApp } from 'vue'
+ * import { createVueStripe } from '@vue-stripe/vue-stripe'
+ *
+ * const app = createApp(App)
+ * const vueStripe = createVueStripe({
+ *   publishableKey: 'pk_test_...',
+ *   stripeAccount: 'acct_...', // optional
+ *   apiVersion: '2023-10-16', // optional
+ *   locale: 'en' // optional
+ * })
+ *
+ * app.use(vueStripe)
+ * ```
+ */
+export declare function createVueStripe(options: VueStripeOptions): Plugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/types/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAO,MAAM,EAAE,MAAM,UAAU,CAAA;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAI/C;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CA6BjE"}