@sergdudko/stripe-js 1.3.20 → 2.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 Siarhei Dudko
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -8,16 +8,32 @@ Supercharge Your Stripe Integration with Enhanced Methods for stripe-js: Take Fu
 ![GitHub last commit](https://img.shields.io/github/last-commit/siarheidudko/stripe-js.svg)
 ![GitHub release](https://img.shields.io/github/release/siarheidudko/stripe-js.svg)
 
+## 🚀 What's New in v2.0.0
+
+- ✅ **Dual Package**: Full support for both CommonJS and ES Modules
+- ✅ **TypeScript**: Complete type definitions and TypeScript source
+- ✅ **Optimized Types**: Shared type definitions for smaller bundle size
+- ✅ **TypeScript Tests**: All tests converted to TypeScript with `node --test --import tsx`
+- ✅ **Better Tree-shaking**: Optimized module structure for better bundling
+
 ## Usage
 
-### `loadStripe`
+### ES Modules (Recommended)
 
-```js
+```typescript
 import { loadStripe } from "@sergdudko/stripe-js";
 
 const stripe = await loadStripe("pk_test_TYooMQauvdEDq54NiTphI7jx");
 ```
 
+### CommonJS
+
+```javascript
+const { loadStripe } = require("@sergdudko/stripe-js");
+
+const stripe = await loadStripe("pk_test_TYooMQauvdEDq54NiTphI7jx");
+```
+
 ## Stripe.js Documentation
 
 - [Stripe.js Docs](https://stripe.com/docs/stripe-js)
@@ -118,3 +134,28 @@ stripe.setDefaultPaymentMethod(
 - To run build `npm run build`.
 - To run testing `npm run test`.
 - To create docs `npm run doc`.
+
+## 📄 License
+
+MIT License - see [LICENSE](./LICENSE) file for details.
+
+## 🆘 Support
+
+- 📝 **Issues**: [GitHub Issues](https://github.com/siarheidudko/stripe-js/issues)
+- 💬 **Discussions**: [GitHub Discussions](https://github.com/siarheidudko/stripe-js/discussions)
+- 📧 **Email**: [siarhei@dudko.dev](mailto:siarhei@dudko.dev)
+
+## 💝 Support This Project
+
+If my Stripe JS Extension helps you build amazing applications, consider supporting its development:
+
+- ☕ **[Buy me a coffee](https://www.buymeacoffee.com/dudko.dev)**
+- 💳 **[PayPal](https://paypal.me/dudkodev)**
+- 🎯 **[Patreon](https://patreon.com/dudko_dev)**
+- 🌐 **[More options](http://dudko.dev/donate)**
+
+Your support helps maintain and improve Redux Cluster for the entire community!
+
+---
+
+**Made with ❤️ by [Siarhei Dudko](https://github.com/siarheidudko)**

package/dist/cjs/esm.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadStripe = void 0;
+var index_1 = require("./index");
+Object.defineProperty(exports, "loadStripe", { enumerable: true, get: function () { return index_1.loadStripe; } });
+//# sourceMappingURL=esm.js.map

package/{lib → dist/cjs}/index.js

@@ -11,7 +11,7 @@ const index_1 = require("./methods/index");
  * @returns
  */
 const loadStripe = async (publishableKey, options) => {
-    const stripeDefault = await (0, stripe_js_1.loadStripe)(publishableKey, options);
+    const stripeDefault = await (0, stripe_js_1.loadStripe)(`${publishableKey}`, options);
     if (stripeDefault === null ||
         // eslint-disable-next-line no-underscore-dangle
         typeof stripeDefault?._apiKey !== "string")

package/{lib → dist/cjs}/methods/index.js

@@ -8,6 +8,7 @@ const deleteSourceFromCustomer_1 = require("./deleteSourceFromCustomer");
 const getAllCards_1 = require("./getAllCards");
 const getCustomer_1 = require("./getCustomer");
 const setDefaultCard_1 = require("./setDefaultCard");
+const getDefaultCard_1 = require("./getDefaultCard");
 const addPaymentMethodToCustomer_1 = require("./addPaymentMethodToCustomer");
 const deletePaymentMethodFromCustomer_1 = require("./deletePaymentMethodFromCustomer");
 const getAllPaymentMethods_1 = require("./getAllPaymentMethods");
@@ -24,6 +25,7 @@ class StripeExtension {
         this.getAllCards = getAllCards_1.getAllCards;
         this.getCustomer = getCustomer_1.getCustomer;
         this.setDefaultCard = setDefaultCard_1.setDefaultCard;
+        this.getDefaultCard = getDefaultCard_1.getDefaultCard;
         this.addPaymentMethodToCustomer = addPaymentMethodToCustomer_1.addPaymentMethodToCustomer;
         this.deletePaymentMethodFromCustomer = deletePaymentMethodFromCustomer_1.deletePaymentMethodFromCustomer;
         this.getAllPaymentMethods = getAllPaymentMethods_1.getAllPaymentMethods;

package/dist/cjs/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/{lib → dist/cjs}/utils/constants.js

@@ -2,5 +2,5 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.stripeApiVersion = exports.stripeApiUrl = void 0;
 exports.stripeApiUrl = "https://api.stripe.com/v1";
-exports.stripeApiVersion = "2025-05-28.basil";
+exports.stripeApiVersion = "2025-08-27.basil";
 //# sourceMappingURL=constants.js.map

package/dist/esm/esm.js

@@ -0,0 +1,2 @@
+export { loadStripe } from "./index";
+//# sourceMappingURL=esm.js.map

package/dist/esm/index.js

@@ -0,0 +1,22 @@
+import { loadStripe as loadStripeDefault, } from "@stripe/stripe-js";
+import { StripeExtension } from "./methods/index";
+/**
+ * Initialize stripe
+ *
+ * @param publishableKey - stripe public key, like pk_...
+ * @param options - stripe initialization options
+ * @returns
+ */
+export const loadStripe = async (publishableKey, options) => {
+    const stripeDefault = await loadStripeDefault(`${publishableKey}`, options);
+    if (stripeDefault === null ||
+        // eslint-disable-next-line no-underscore-dangle
+        typeof stripeDefault?._apiKey !== "string")
+        throw new Error("Initialization error.");
+    const stripeExtension = new StripeExtension(
+    // eslint-disable-next-line no-underscore-dangle
+    stripeDefault._apiKey);
+    const stripe = Object.assign(stripeDefault, stripeExtension);
+    return stripe;
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/methods/addPaymentMethodToCustomer.js

@@ -0,0 +1,26 @@
+import { responseHandler } from "../utils/handlers";
+import { stripeApiUrl, stripeApiVersion } from "../utils/constants";
+/**
+ * Add payment method to customer.
+ *
+ * @param paymentMethodId - payment method id (see: https://stripe.com/docs/api/customers/object#payment_method_object-id)
+ * @param customerId - customer id (see: https://stripe.com/docs/api/customers/object#customer_object-id)
+ * @param ephemeralKey - customer ephemeral key
+ * @returns
+ */
+export const addPaymentMethodToCustomer = async function (paymentMethodId, customerId, ephemeralKey) {
+    const stripeApiKey = this._apiKey;
+    if (typeof stripeApiKey !== "string")
+        throw new Error("Initialization failed.");
+    // make request
+    return fetch(`${stripeApiUrl}/payment_methods/${paymentMethodId}/attach`, {
+        body: `customer=${customerId}`,
+        headers: {
+            Authorization: `Bearer ${ephemeralKey}`,
+            "Content-Type": "application/x-www-form-urlencoded",
+            "Stripe-Version": `${stripeApiVersion}`,
+        },
+        method: "POST",
+    }).then(responseHandler);
+};
+//# sourceMappingURL=addPaymentMethodToCustomer.js.map

package/dist/esm/methods/addSourceToCustomer.js

@@ -0,0 +1,26 @@
+import { responseHandler } from "../utils/handlers";
+import { stripeApiUrl, stripeApiVersion } from "../utils/constants";
+/**
+ * Add card to customer (from source or token).
+ *
+ * @param token - source or token string (see: https://stripe.com/docs/api/sources/object)
+ * @param customerId - customer id (see: https://stripe.com/docs/api/customers/object#customer_object-id)
+ * @param ephemeralKey - customer ephemeral key
+ * @returns
+ */
+export const addSourceToCustomer = async function (token, customerId, ephemeralKey) {
+    const stripeApiKey = this._apiKey;
+    if (typeof stripeApiKey !== "string")
+        throw new Error("Initialization failed.");
+    // make request
+    return fetch(`${stripeApiUrl}/customers/${customerId}/sources`, {
+        body: `source=${token}`,
+        headers: {
+            Authorization: `Bearer ${ephemeralKey}`,
+            "Content-Type": "application/x-www-form-urlencoded",
+            "Stripe-Version": `${stripeApiVersion}`,
+        },
+        method: "POST",
+    }).then(responseHandler);
+};
+//# sourceMappingURL=addSourceToCustomer.js.map

package/dist/esm/methods/confirmPaymentIntentByCard.js

@@ -0,0 +1,26 @@
+import { responseHandler } from "../utils/handlers";
+import { stripeApiUrl, stripeApiVersion } from "../utils/constants";
+/**
+ * Confirm payment intent by customer's card
+ *
+ * @param paymentIntentSecret - stripe payment intent secret (see: https://stripe.com/docs/api/payment_intents/object#payment_intent_object-client_secret)
+ * @param paymentMethodId - stripe customer payment method id (see: https://stripe.com/docs/api/cards/object#card_object-id)
+ * @returns
+ */
+export const confirmPaymentIntentByCard = async function (paymentIntentSecret, paymentMethodId, returnUrl) {
+    const stripeApiKey = this._apiKey;
+    if (typeof stripeApiKey !== "string")
+        throw new Error("Initialization failed.");
+    // make request
+    const paymentIntentId = paymentIntentSecret.replace(/_secret_.+$/i, "");
+    return fetch(`${stripeApiUrl}/payment_intents/${paymentIntentId}/confirm?client_secret=${paymentIntentSecret}`, {
+        body: `payment_method=${paymentMethodId}${typeof returnUrl === 'string' ? `&return_url=${returnUrl}` : ''}`,
+        headers: {
+            Authorization: `Bearer ${stripeApiKey}`,
+            "Content-Type": `application/x-www-form-urlencoded`,
+            "Stripe-Version": `${stripeApiVersion}`,
+        },
+        method: `POST`,
+    }).then(responseHandler);
+};
+//# sourceMappingURL=confirmPaymentIntentByCard.js.map

package/dist/esm/methods/confirmPaymentIntentByPaymentMethod.js

@@ -0,0 +1,10 @@
+import { confirmPaymentIntentByCard } from "./confirmPaymentIntentByCard";
+/**
+ * Confirm payment intent by customer's payment method
+ *
+ * @param paymentIntentSecret - stripe payment intent secret (see: https://stripe.com/docs/api/payment_intents/object#payment_intent_object-client_secret)
+ * @param paymentMethodId - stripe customer payment method id (see: https://stripe.com/docs/api/cards/object#card_object-id)
+ * @returns
+ */
+export const confirmPaymentIntentByPaymentMethod = confirmPaymentIntentByCard;
+//# sourceMappingURL=confirmPaymentIntentByPaymentMethod.js.map

package/dist/esm/methods/deletePaymentMethodFromCustomer.js

@@ -0,0 +1,24 @@
+import { responseHandler } from "../utils/handlers";
+import { stripeApiUrl, stripeApiVersion } from "../utils/constants";
+/**
+ * Delete payment method from customer.
+ *
+ * @param paymentMethodId - payment method id (see: https://stripe.com/docs/api/customers/object#payment_method_object-id)
+ * @param ephemeralKey - customer ephemeral key
+ * @returns
+ */
+export const deletePaymentMethodFromCustomer = async function (paymentMethodId, ephemeralKey) {
+    const stripeApiKey = this._apiKey;
+    if (typeof stripeApiKey !== "string")
+        throw new Error("Initialization failed.");
+    // make request
+    return fetch(`${stripeApiUrl}/payment_methods/${paymentMethodId}/detach`, {
+        headers: {
+            Authorization: `Bearer ${ephemeralKey}`,
+            "Content-Type": "application/x-www-form-urlencoded",
+            "Stripe-Version": `${stripeApiVersion}`,
+        },
+        method: "POST",
+    }).then(responseHandler);
+};
+//# sourceMappingURL=deletePaymentMethodFromCustomer.js.map

package/dist/esm/methods/deleteSourceFromCustomer.js

@@ -0,0 +1,24 @@
+import { responseHandler } from "../utils/handlers";
+import { stripeApiUrl, stripeApiVersion } from "../utils/constants";
+/**
+ * Delete card from customer.
+ *
+ * @param sourceId - source or card id (see: https://stripe.com/docs/api/sources/object#source_object-id)
+ * @param customerId - customer id (see: https://stripe.com/docs/api/customers/object#customer_object-id)
+ * @param ephemeralKey - customer ephemeral key
+ * @returns
+ */
+export const deleteSourceFromCustomer = async function (sourceId, customerId, ephemeralKey) {
+    const stripeApiKey = this._apiKey;
+    if (typeof stripeApiKey !== "string")
+        throw new Error("Initialization failed.");
+    // make request
+    return await fetch(`${stripeApiUrl}/customers/${customerId}/sources/${sourceId}`, {
+        headers: {
+            Authorization: `Bearer ${ephemeralKey}`,
+            "Stripe-Version": stripeApiVersion,
+        },
+        method: "DELETE",
+    }).then(responseHandler);
+};
+//# sourceMappingURL=deleteSourceFromCustomer.js.map

package/dist/esm/methods/getAllCards.js

@@ -0,0 +1,23 @@
+import { responseHandler } from "../utils/handlers";
+import { stripeApiUrl, stripeApiVersion } from "../utils/constants";
+/**
+ * Get all customer's card
+ *
+ * @param customerId - customer id (see: https://stripe.com/docs/api/customers/object#customer_object-id)
+ * @param ephemeralKey - customer ephemeral key
+ * @returns
+ */
+export const getAllCards = async function (customerId, ephemeralKey) {
+    const stripeApiKey = this._apiKey;
+    if (typeof stripeApiKey !== "string")
+        throw new Error("Initialization failed.");
+    // make request
+    return fetch(`${stripeApiUrl}/payment_methods?customer=${customerId}&type=card&limit=100`, {
+        headers: {
+            Authorization: `Bearer ${ephemeralKey}`,
+            "Stripe-Version": stripeApiVersion,
+        },
+        method: "GET",
+    }).then(responseHandler);
+};
+//# sourceMappingURL=getAllCards.js.map

package/dist/esm/methods/getAllPaymentMethods.js

@@ -0,0 +1,23 @@
+import { responseHandler } from "../utils/handlers";
+import { stripeApiUrl, stripeApiVersion } from "../utils/constants";
+/**
+ * Get all customer's payment methods
+ *
+ * @param customerId - customer id (see: https://stripe.com/docs/api/customers/object#customer_object-id)
+ * @param ephemeralKey - customer ephemeral key
+ * @returns
+ */
+export const getAllPaymentMethods = async function (customerId, ephemeralKey) {
+    const stripeApiKey = this._apiKey;
+    if (typeof stripeApiKey !== "string")
+        throw new Error("Initialization failed.");
+    // make request
+    return fetch(`${stripeApiUrl}/payment_methods?customer=${customerId}&type=card&limit=100`, {
+        headers: {
+            Authorization: `Bearer ${ephemeralKey}`,
+            "Stripe-Version": stripeApiVersion,
+        },
+        method: "GET",
+    }).then(responseHandler);
+};
+//# sourceMappingURL=getAllPaymentMethods.js.map

package/dist/esm/methods/getCustomer.js

@@ -0,0 +1,22 @@
+import { responseHandler } from "../utils/handlers";
+import { stripeApiUrl, stripeApiVersion } from "../utils/constants";
+/**
+ * Get customer data
+ *
+ * @param customerId - customer id (see: https://stripe.com/docs/api/customers/object#customer_object-id)
+ * @param ephemeralKey - customer ephemeral key
+ * @returns
+ */
+export const getCustomer = async function (customerId, ephemeralKey) {
+    const stripeApiKey = this._apiKey;
+    if (typeof stripeApiKey !== "string")
+        throw new Error("Initialization failed.");
+    // make request
+    return fetch(`${stripeApiUrl}/customers/${customerId}`, {
+        headers: {
+            Authorization: `Bearer ${ephemeralKey}`,
+            "Stripe-Version": stripeApiVersion,
+        },
+    }).then(responseHandler);
+};
+//# sourceMappingURL=getCustomer.js.map

package/dist/esm/methods/getDefaultCard.js

@@ -0,0 +1,24 @@
+import { responseHandler } from "../utils/handlers";
+import { stripeApiUrl, stripeApiVersion } from "../utils/constants";
+/**
+ * Get customer's default card id
+ *
+ * @param customerId - customer id (see: https://stripe.com/docs/api/customers/object#customer_object-id)
+ * @param ephemeralKey - customer ephemeral key
+ * @returns
+ */
+export const getDefaultCard = async function (customerId, ephemeralKey) {
+    const stripeApiKey = this._apiKey;
+    if (typeof stripeApiKey !== "string")
+        throw new Error("Initialization failed.");
+    // make request
+    return fetch(`${stripeApiUrl}/customers/${customerId}`, {
+        headers: {
+            Authorization: `Bearer ${ephemeralKey}`,
+            "Stripe-Version": stripeApiVersion,
+        },
+    })
+        .then(responseHandler)
+        .then((e) => (e?.default_source ? e.default_source : undefined));
+};
+//# sourceMappingURL=getDefaultCard.js.map

package/dist/esm/methods/index.js

@@ -0,0 +1,33 @@
+import { confirmPaymentIntentByCard } from "./confirmPaymentIntentByCard";
+import { confirmPaymentIntentByPaymentMethod } from "./confirmPaymentIntentByPaymentMethod";
+import { addSourceToCustomer } from "./addSourceToCustomer";
+import { deleteSourceFromCustomer } from "./deleteSourceFromCustomer";
+import { getAllCards } from "./getAllCards";
+import { getCustomer } from "./getCustomer";
+import { setDefaultCard } from "./setDefaultCard";
+import { getDefaultCard } from "./getDefaultCard";
+import { addPaymentMethodToCustomer } from "./addPaymentMethodToCustomer";
+import { deletePaymentMethodFromCustomer } from "./deletePaymentMethodFromCustomer";
+import { getAllPaymentMethods } from "./getAllPaymentMethods";
+import { setDefaultPaymentMethod } from "./setDefaultPaymentMethod";
+/**
+ * additional stripe methods
+ */
+export class StripeExtension {
+    constructor(apiKey) {
+        this.confirmPaymentIntentByCard = confirmPaymentIntentByCard;
+        this.confirmPaymentIntentByPaymentMethod = confirmPaymentIntentByPaymentMethod;
+        this.addSourceToCustomer = addSourceToCustomer;
+        this.deleteSourceFromCustomer = deleteSourceFromCustomer;
+        this.getAllCards = getAllCards;
+        this.getCustomer = getCustomer;
+        this.setDefaultCard = setDefaultCard;
+        this.getDefaultCard = getDefaultCard;
+        this.addPaymentMethodToCustomer = addPaymentMethodToCustomer;
+        this.deletePaymentMethodFromCustomer = deletePaymentMethodFromCustomer;
+        this.getAllPaymentMethods = getAllPaymentMethods;
+        this.setDefaultPaymentMethod = setDefaultPaymentMethod;
+        this._apiKey = apiKey;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/methods/setDefaultCard.js

@@ -0,0 +1,26 @@
+import { responseHandler } from "../utils/handlers";
+import { stripeApiUrl, stripeApiVersion } from "../utils/constants";
+/**
+ * Set default customer card
+ *
+ * @param cardId - card id (see: https://stripe.com/docs/api/customers/object#card_object-id)
+ * @param customerId - customer id (see: https://stripe.com/docs/api/customers/object#customer_object-id)
+ * @param ephemeralKey - customer ephemeral key
+ * @returns
+ */
+export const setDefaultCard = async function (cardId, customerId, ephemeralKey) {
+    const stripeApiKey = this._apiKey;
+    if (typeof stripeApiKey !== "string")
+        throw new Error("Initialization failed.");
+    // make request
+    return fetch(`${stripeApiUrl}/customers/${customerId}`, {
+        body: `default_source=${cardId}`,
+        headers: {
+            Authorization: `Bearer ${ephemeralKey}`,
+            "Content-Type": "application/x-www-form-urlencoded",
+            "Stripe-Version": stripeApiVersion,
+        },
+        method: "POST",
+    }).then(responseHandler);
+};
+//# sourceMappingURL=setDefaultCard.js.map

package/dist/esm/methods/setDefaultPaymentMethod.js

@@ -0,0 +1,26 @@
+import { responseHandler } from "../utils/handlers";
+import { stripeApiUrl, stripeApiVersion } from "../utils/constants";
+/**
+ * Set default customer payment method
+ *
+ * @param paymentMethodId - payment method id (see: https://stripe.com/docs/api/customers/object#payment_method_object-id)
+ * @param customerId - customer id (see: https://stripe.com/docs/api/customers/object#customer_object-id)
+ * @param ephemeralKey - customer ephemeral key
+ * @returns
+ */
+export const setDefaultPaymentMethod = async function (paymentMethodId, customerId, ephemeralKey) {
+    const stripeApiKey = this._apiKey;
+    if (typeof stripeApiKey !== "string")
+        throw new Error("Initialization failed.");
+    // make request for payment method api
+    return fetch(`${stripeApiUrl}/customers/${customerId}`, {
+        body: `invoice_settings[default_payment_method]=${paymentMethodId}`,
+        headers: {
+            Authorization: `Bearer ${ephemeralKey}`,
+            "Content-Type": "application/x-www-form-urlencoded",
+            "Stripe-Version": stripeApiVersion,
+        },
+        method: "POST",
+    }).then(responseHandler);
+};
+//# sourceMappingURL=setDefaultPaymentMethod.js.map

package/dist/esm/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/utils/constants.js

@@ -0,0 +1,3 @@
+export const stripeApiUrl = "https://api.stripe.com/v1";
+export const stripeApiVersion = "2025-08-27.basil";
+//# sourceMappingURL=constants.js.map

package/dist/esm/utils/handlers.js

@@ -0,0 +1,13 @@
+/**
+ * Response handler
+ *
+ * @param res - fetch response object
+ * @returns
+ */
+export const responseHandler = async (res) => {
+    const data = res.json();
+    if (!res.ok)
+        throw data;
+    return data;
+};
+//# sourceMappingURL=handlers.js.map

package/dist/types/esm.d.ts

@@ -0,0 +1,2 @@
+export { loadStripe } from "./index";
+export type { Stripe, StripeDefaultWithInternal } from "./types";

package/dist/types/index.d.ts

@@ -0,0 +1,11 @@
+import { StripeConstructorOptions } from "@stripe/stripe-js";
+import { Stripe } from "./types";
+/**
+ * Initialize stripe
+ *
+ * @param publishableKey - stripe public key, like pk_...
+ * @param options - stripe initialization options
+ * @returns
+ */
+export declare const loadStripe: (publishableKey: string, options?: StripeConstructorOptions) => Promise<Stripe>;
+export type { Stripe, StripeDefaultWithInternal } from "./types";

package/{lib → dist/types}/methods/index.d.ts

@@ -11,6 +11,7 @@ export declare class StripeExtension {
     getAllCards: (this: StripeExtension, customerId: string, ephemeralKey: string) => Promise<any>;
     getCustomer: (this: StripeExtension, customerId: string, ephemeralKey: string) => Promise<any>;
     setDefaultCard: (this: StripeExtension, cardId: string, customerId: string, ephemeralKey: string) => Promise<any>;
+    getDefaultCard: (this: StripeExtension, customerId: string, ephemeralKey: string) => Promise<string | undefined>;
     addPaymentMethodToCustomer: (this: StripeExtension, paymentMethodId: string, customerId: string, ephemeralKey: string) => Promise<import("@stripe/stripe-js").PaymentMethod | undefined>;
     deletePaymentMethodFromCustomer: (this: StripeExtension, paymentMethodId: string, ephemeralKey: string) => Promise<import("@stripe/stripe-js").PaymentMethod | undefined>;
     getAllPaymentMethods: (this: StripeExtension, customerId: string, ephemeralKey: string) => Promise<any>;

package/dist/types/types.d.ts

@@ -0,0 +1,72 @@
+import { StripeConstructorOptions, Stripe as StripeDefault } from "@stripe/stripe-js";
+/**
+ * Stripe default interface with internal properties
+ */
+export interface StripeDefaultWithInternal extends StripeDefault {
+    /**
+     * Stripe api key after initialization, like pk_...
+     */
+    _apiKey: string;
+}
+/**
+ * Base interface for Stripe extension methods
+ */
+export interface StripeExtensionMethods {
+    /**
+     * Confirm payment intent by card
+     */
+    confirmPaymentIntentByCard(clientSecret: string, cardId: string, returnUrl: string): Promise<any>;
+    /**
+     * Confirm payment intent by payment method
+     */
+    confirmPaymentIntentByPaymentMethod(clientSecret: string, paymentMethodId: string, returnUrl: string): Promise<any>;
+    /**
+     * Add source to customer
+     */
+    addSourceToCustomer(token: string, customerId: string, ephemeralKey: string): Promise<any>;
+    /**
+     * Delete source from customer
+     */
+    deleteSourceFromCustomer(sourceId: string, customerId: string, ephemeralKey: string): Promise<any>;
+    /**
+     * Get all cards for customer
+     */
+    getAllCards(customerId: string, ephemeralKey: string): Promise<any>;
+    /**
+     * Get customer data
+     */
+    getCustomer(customerId: string, ephemeralKey: string): Promise<any>;
+    /**
+     * Get default card
+     */
+    getDefaultCard(customerId: string, ephemeralKey: string): Promise<string | undefined>;
+    /**
+     * Set default card
+     */
+    setDefaultCard(cardId: string, customerId: string, ephemeralKey: string): Promise<any>;
+    /**
+     * Add payment method to customer
+     */
+    addPaymentMethodToCustomer(paymentMethodId: string, customerId: string, ephemeralKey: string): Promise<any>;
+    /**
+     * Delete payment method from customer
+     */
+    deletePaymentMethodFromCustomer(paymentMethodId: string, ephemeralKey: string): Promise<any>;
+    /**
+     * Get all payment methods for customer
+     */
+    getAllPaymentMethods(customerId: string, ephemeralKey: string): Promise<any>;
+    /**
+     * Set default payment method
+     */
+    setDefaultPaymentMethod(paymentMethodId: string, customerId: string, ephemeralKey: string): Promise<any>;
+}
+/**
+ * Extended Stripe interface combining default Stripe with extensions
+ */
+export interface Stripe extends StripeExtensionMethods, StripeDefault {
+}
+/**
+ * Load Stripe function type
+ */
+export type LoadStripeFunction = (publishableKey: string, options?: StripeConstructorOptions) => Promise<Stripe>;

package/{lib → dist/types}/utils/constants.d.ts

@@ -1,2 +1,2 @@
 export declare const stripeApiUrl = "https://api.stripe.com/v1";
-export declare const stripeApiVersion = "2025-05-28.basil";
+export declare const stripeApiVersion = "2025-08-27.basil";