@vue-stripe/vue-stripe 5.0.0 → 5.1.1

package/dist/types/components/VueStripeCheckout.vue.d.ts

@@ -1,7 +1,20 @@
-import { RedirectToCheckoutOptions } from '@stripe/stripe-js';
-import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue-demi';
+import { DefineComponent, Ref, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue-demi';
 interface Props {
+    /**
+     * Checkout Session ID (starts with cs_).
+     * When provided, redirects to the session's checkout page.
+     */
     sessionId?: string;
+    /**
+     * Checkout Session URL from Stripe API.
+     * For @stripe/stripe-js v8.x compatibility where redirectToCheckout is removed.
+     * When provided, this takes precedence over sessionId.
+     */
+    sessionUrl?: string;
+    /**
+     * Price ID for client-side session creation (legacy, requires redirectToCheckout).
+     * @deprecated Use sessionUrl with server-side session creation for v8.x compatibility.
+     */
     priceId?: string;
     mode?: 'payment' | 'subscription';
     successUrl?: string;
@@ -9,7 +22,6 @@ interface Props {
     customerEmail?: string;
     clientReferenceId?: string;
     submitType?: 'auto' | 'book' | 'donate' | 'pay';
-    options?: Partial<RedirectToCheckoutOptions>;
     buttonText?: string;
     loadingText?: string;
     disabled?: boolean;
@@ -18,28 +30,40 @@ interface Props {
 declare function __VLS_template(): {
     attrs: Partial<{}>;
     slots: {
-        default?(_: {}): any;
-        loading?(_: {}): any;
+        default?(_: {
+            checkout: () => Promise<void>;
+            loading: boolean;
+            disabled: boolean | undefined;
+        }): any;
     };
     refs: {};
-    rootEl: HTMLButtonElement;
+    rootEl: any;
 };
 type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
-declare const __VLS_component: DefineComponent<Props, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+declare const __VLS_component: DefineComponent<Props, {
+    checkout: () => Promise<void>;
+    loading: Ref<boolean, boolean>;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
     error: (error: Error) => any;
-    click: () => any;
+    checkout: () => any;
     success: () => any;
+    "before-redirect": (data: {
+        url: string;
+    }) => any;
 }, string, PublicProps, Readonly<Props> & Readonly<{
     onError?: (error: Error) => any;
-    onClick?: () => any;
+    onCheckout?: () => any;
     onSuccess?: () => any;
+    "onBefore-redirect"?: (data: {
+        url: string;
+    }) => any;
 }>, {
     mode: "payment" | "subscription";
     buttonText: string;
     loadingText: string;
     disabled: boolean;
     buttonClass: string;
-}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLButtonElement>;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export default _default;
 type __VLS_WithTemplateSlots<T, S> = T & {

package/dist/types/components/VueStripeCheckout.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VueStripeCheckout.vue.d.ts","sourceRoot":"","sources":["../../../src/components/VueStripeCheckout.vue"],"names":[],"mappings":";AA+JA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAA;AAIlE,UAAU,KAAK;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,SAAS,GAAG,cAAc,CAAA;IACjC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAA;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,CAAA;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAyFD,iBAAS,cAAc;WA2CT,OAAO,IAA6B;;yBAXrB,GAAG;yBACH,GAAG;;;;EAe/B;AAYD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe;;;;;;;;;UAjKZ,SAAS,GAAG,cAAc;gBAOpB,MAAM;iBACL,MAAM;cACT,OAAO;iBACJ,MAAM;gGAgKpB,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAYpG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}
+{"version":3,"file":"VueStripeCheckout.vue.d.ts","sourceRoot":"","sources":["../../../src/components/VueStripeCheckout.vue"],"names":[],"mappings":";AAsPA,UAAU,KAAK;IACb;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,SAAS,GAAG,cAAc,CAAA;IACjC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAA;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAkJD,iBAAS,cAAc;WAoDT,OAAO,IAA6B;;;;;;YAVrB,GAAG;;;;EAe/B;AAaD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe;;;;;;;;aAnNiB,MAAM;;;;;;;aAAN,MAAM;;;UAhBnC,SAAS,GAAG,cAAc;gBAMpB,MAAM;iBACL,MAAM;cACT,OAAO;iBACJ,MAAM;kFAmOpB,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAYpG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}

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

@@ -1,9 +1,72 @@
 import { Ref } from 'vue-demi';
-import { RedirectToCheckoutOptions } from '@stripe/stripe-js';
+/**
+ * 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 {
-    redirectToCheckout: (options: RedirectToCheckoutOptions) => Promise<void>;
+    /**
+     * 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

@@ -1 +1 @@
-{"version":3,"file":"useStripeCheckout.d.ts","sourceRoot":"","sources":["../../../src/composables/useStripeCheckout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,GAAG,EAAE,MAAM,UAAU,CAAA;AAClD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAA;AAIlE,MAAM,WAAW,uBAAuB;IACtC,kBAAkB,EAAE,CAAC,OAAO,EAAE,yBAAyB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACzE,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,wBAAgB,iBAAiB,IAAI,uBAAuB,CAoC3D"}
+{"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"}