stripe 18.1.0-beta.3 → 18.1.1

package/OPENAPI_VERSION

@@ -1 +1 @@
-v1697
+v1719

package/README.md

@@ -523,23 +523,23 @@ const stripe = new Stripe('sk_test_...', {
 });
 ```
 
-### Beta SDKs
+### Public Preview SDKs
 
-Stripe has features in the beta phase that can be accessed via the beta version of this package.
-We would love for you to try these and share feedback with us before these features reach the stable phase.
-The beta versions can be installed in one of two ways
+Stripe has features in the [public preview phase](https://docs.stripe.com/release-phases) that can be accessed via versions of this package that have the `-beta.X` suffix like `15.2.0-beta.2`.
+We would love for you to try these as we incrementally release new features and improve them based on your feedback.
 
-- To install the latest beta version, run the command `npm install stripe@beta --save`
-- To install a specific beta version, replace the term "beta" in the above command with the version number like `npm install stripe@1.2.3-beta.1 --save`
+To install, choose the version that includes support for the preview feature you are interested in by reviewing the [releases page](https://github.com/stripe/stripe-node/releases/) and use it in the below command
 
-> **Note**
-> There can be breaking changes between beta versions. Therefore we recommend pinning the package version to a specific beta version in your package.json file. This way you can install the same version each time without breaking changes unless you are intentionally looking for the latest beta version.
+```
+npm install stripe@<replace-with-the-version-of-your-choice> --save
+```
 
-We highly recommend keeping an eye on when the beta feature you are interested in goes from beta to stable so that you can move from using a beta version of the SDK to the stable version.
+> **Note**
+> There can be breaking changes between two versions of the public preview SDKs without a bump in the major version. Therefore we recommend pinning the package version to a specific version in your package.json file. This way you can install the same version each time without breaking changes unless you are intentionally looking for the latest public preview SDK.
 
-The versions tab on the [stripe page on npm](https://www.npmjs.com/package/stripe) lists the current tags in use. The `beta` tag here corresponds to the the latest beta version of the package.
+The versions tab on the [stripe page on npm](https://www.npmjs.com/package/stripe) lists the current tags in use. The `beta` tag here corresponds to the the latest public preview SDK.
 
-If your beta feature requires a `Stripe-Version` header to be sent, use the `apiVersion` property of `config` object to set it:
+Some preview features require a name and version to be set in the `Stripe-Version` header like `feature_beta=v3`. If your preview feature has this requirement, use the `apiVersion` property of `config` object to set it:
 
 ```js
 const stripe = new Stripe('sk_test_...', {
@@ -552,7 +552,6 @@ const stripe = new Stripe('sk_test_...', {
 If you would like to send a request to an undocumented API (for example you are in a private beta), or if you prefer to bypass the method definitions in the library and specify your request details directly, you can use the `rawRequest` method on the StripeClient object.
 
 ```javascript
-import Stripe from 'stripe';
 const client = new Stripe('sk_test_...');
 
 client.rawRequest(

package/VERSION

@@ -1 +1 @@
-18.1.0-beta.3
+18.1.1

package/cjs/Error.js

@@ -2,7 +2,7 @@
 /* eslint-disable camelcase */
 /* eslint-disable no-warning-comments */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.InvalidPaymentMethodError = exports.ControlledByDashboardError = exports.InvalidPayoutMethodError = exports.FeatureNotEnabledError = exports.RecipientNotNotifiableError = exports.QuotaExceededError = exports.InsufficientFundsError = exports.NotCancelableError = exports.AlreadyCanceledError = exports.BlockedByStripeError = exports.FinancialAccountNotOpenError = exports.TemporarySessionExpiredError = exports.StripeUnknownError = exports.StripeInvalidGrantError = exports.StripeIdempotencyError = exports.StripeSignatureVerificationError = exports.StripeConnectionError = exports.StripeRateLimitError = exports.StripePermissionError = exports.StripeAuthenticationError = exports.StripeAPIError = exports.StripeInvalidRequestError = exports.StripeCardError = exports.StripeError = exports.generateV2Error = exports.generateV1Error = void 0;
+exports.TemporarySessionExpiredError = exports.StripeUnknownError = exports.StripeInvalidGrantError = exports.StripeIdempotencyError = exports.StripeSignatureVerificationError = exports.StripeConnectionError = exports.StripeRateLimitError = exports.StripePermissionError = exports.StripeAuthenticationError = exports.StripeAPIError = exports.StripeInvalidRequestError = exports.StripeCardError = exports.StripeError = exports.generateV2Error = exports.generateV1Error = void 0;
 const generateV1Error = (rawStripeError) => {
     switch (rawStripeError.type) {
         case 'card_error':
@@ -30,28 +30,6 @@ const generateV2Error = (rawStripeError) => {
         // switchCases: The beginning of the section generated from our OpenAPI spec
         case 'temporary_session_expired':
             return new TemporarySessionExpiredError(rawStripeError);
-        case 'financial_account_not_open':
-            return new FinancialAccountNotOpenError(rawStripeError);
-        case 'blocked_by_stripe':
-            return new BlockedByStripeError(rawStripeError);
-        case 'already_canceled':
-            return new AlreadyCanceledError(rawStripeError);
-        case 'not_cancelable':
-            return new NotCancelableError(rawStripeError);
-        case 'insufficient_funds':
-            return new InsufficientFundsError(rawStripeError);
-        case 'quota_exceeded':
-            return new QuotaExceededError(rawStripeError);
-        case 'recipient_not_notifiable':
-            return new RecipientNotNotifiableError(rawStripeError);
-        case 'feature_not_enabled':
-            return new FeatureNotEnabledError(rawStripeError);
-        case 'invalid_payout_method':
-            return new InvalidPayoutMethodError(rawStripeError);
-        case 'controlled_by_dashboard':
-            return new ControlledByDashboardError(rawStripeError);
-        case 'invalid_payment_method':
-            return new InvalidPaymentMethodError(rawStripeError);
         // switchCases: The end of the section generated from our OpenAPI spec
     }
     // Special handling for requests with missing required fields in V2 APIs.
@@ -69,6 +47,7 @@ exports.generateV2Error = generateV2Error;
  */
 class StripeError extends Error {
     constructor(raw = {}, type = null) {
+        var _a;
         super(raw.message);
         this.type = type || this.constructor.name;
         this.raw = raw;
@@ -80,8 +59,7 @@ class StripeError extends Error {
         this.headers = raw.headers;
         this.requestId = raw.requestId;
         this.statusCode = raw.statusCode;
-        // @ts-ignore
-        this.message = raw.message;
+        this.message = (_a = raw.message) !== null && _a !== void 0 ? _a : '';
         this.userMessage = raw.user_message;
         this.charge = raw.charge;
         this.decline_code = raw.decline_code;
@@ -222,72 +200,4 @@ class TemporarySessionExpiredError extends StripeError {
     }
 }
 exports.TemporarySessionExpiredError = TemporarySessionExpiredError;
-class FinancialAccountNotOpenError extends StripeError {
-    constructor(rawStripeError = {}) {
-        super(rawStripeError, 'FinancialAccountNotOpenError');
-    }
-}
-exports.FinancialAccountNotOpenError = FinancialAccountNotOpenError;
-class BlockedByStripeError extends StripeError {
-    constructor(rawStripeError = {}) {
-        super(rawStripeError, 'BlockedByStripeError');
-    }
-}
-exports.BlockedByStripeError = BlockedByStripeError;
-class AlreadyCanceledError extends StripeError {
-    constructor(rawStripeError = {}) {
-        super(rawStripeError, 'AlreadyCanceledError');
-    }
-}
-exports.AlreadyCanceledError = AlreadyCanceledError;
-class NotCancelableError extends StripeError {
-    constructor(rawStripeError = {}) {
-        super(rawStripeError, 'NotCancelableError');
-    }
-}
-exports.NotCancelableError = NotCancelableError;
-class InsufficientFundsError extends StripeError {
-    constructor(rawStripeError = {}) {
-        super(rawStripeError, 'InsufficientFundsError');
-    }
-}
-exports.InsufficientFundsError = InsufficientFundsError;
-class QuotaExceededError extends StripeError {
-    constructor(rawStripeError = {}) {
-        super(rawStripeError, 'QuotaExceededError');
-    }
-}
-exports.QuotaExceededError = QuotaExceededError;
-class RecipientNotNotifiableError extends StripeError {
-    constructor(rawStripeError = {}) {
-        super(rawStripeError, 'RecipientNotNotifiableError');
-    }
-}
-exports.RecipientNotNotifiableError = RecipientNotNotifiableError;
-class FeatureNotEnabledError extends StripeError {
-    constructor(rawStripeError = {}) {
-        super(rawStripeError, 'FeatureNotEnabledError');
-    }
-}
-exports.FeatureNotEnabledError = FeatureNotEnabledError;
-class InvalidPayoutMethodError extends StripeError {
-    constructor(rawStripeError = {}) {
-        super(rawStripeError, 'InvalidPayoutMethodError');
-    }
-}
-exports.InvalidPayoutMethodError = InvalidPayoutMethodError;
-class ControlledByDashboardError extends StripeError {
-    constructor(rawStripeError = {}) {
-        super(rawStripeError, 'ControlledByDashboardError');
-    }
-}
-exports.ControlledByDashboardError = ControlledByDashboardError;
-class InvalidPaymentMethodError extends StripeError {
-    constructor(rawStripeError) {
-        super(rawStripeError, 'InvalidPaymentMethodError');
-        // @ts-ignore
-        this.invalid_param = this.raw.invalid_param;
-    }
-}
-exports.InvalidPaymentMethodError = InvalidPaymentMethodError;
 // classDefinitions: The end of the section generated from our OpenAPI spec

package/cjs/RequestSender.js

@@ -310,8 +310,8 @@ class RequestSender {
                     queryData: {},
                     authenticator,
                     headers,
-                    host: null,
-                    streaming: false,
+                    host: calculatedOptions.host,
+                    streaming: !!calculatedOptions.streaming,
                     settings: {},
                     usage: ['raw_request'],
                 };
@@ -366,11 +366,10 @@ class RequestSender {
                     .getApiField('httpClient')
                     .makeRequest(request.host, request.port, request.path, request.method, request.headers, request.body, request.protocol, timeout);
                 const requestStartTime = Date.now();
-                // @ts-ignore
                 const requestEvent = (0, utils_js_1.removeNullish)({
                     api_version: apiVersion,
-                    account: headers['Stripe-Account'],
-                    idempotency_key: headers['Idempotency-Key'],
+                    account: (0, utils_js_1.parseHttpHeaderAsString)(headers['Stripe-Account']),
+                    idempotency_key: (0, utils_js_1.parseHttpHeaderAsString)(headers['Idempotency-Key']),
                     method,
                     path,
                     request_start_time: requestStartTime,
@@ -381,9 +380,7 @@ class RequestSender {
                 req
                     .then((res) => {
                     if (RequestSender._shouldRetry(res, requestRetries, maxRetries)) {
-                        return retryRequest(makeRequest, apiVersion, headers, requestRetries, 
-                        // @ts-ignore
-                        res.getHeaders()['retry-after']);
+                        return retryRequest(makeRequest, apiVersion, headers, requestRetries, (0, utils_js_1.parseHttpHeaderAsNumber)(res.getHeaders()['retry-after']));
                     }
                     else if (options.streaming && res.getStatusCode() < 400) {
                         return this._streamingResponseHandler(requestEvent, usage, callback)(res);
@@ -402,7 +399,6 @@ class RequestSender {
                             message: isTimeoutError
                                 ? `Request aborted due to timeout being reached (${timeout}ms)`
                                 : RequestSender._generateConnectionErrorMessage(requestRetries),
-                            // @ts-ignore
                             detail: error,
                         }));
                     }

package/cjs/StripeResource.js

@@ -108,7 +108,7 @@ StripeResource.prototype = {
         const data = encode(Object.assign({}, dataFromArgs, overrideData));
         const options = (0, utils_js_1.getOptionsFromArgs)(args);
         const host = options.host || spec.host;
-        const streaming = !!spec.streaming;
+        const streaming = !!spec.streaming || !!options.streaming;
         // Validate that there are no more args.
         if (args.filter((x) => x != null).length) {
             throw new Error(`Stripe: Unknown arguments (${args}). Did you mean to pass an options object? See https://github.com/stripe/stripe-node/wiki/Passing-Options. (on API request to ${requestMethod} \`${path}\`)`);

package/cjs/Webhooks.js

@@ -6,10 +6,12 @@ const CryptoProvider_js_1 = require("./crypto/CryptoProvider.js");
 function createWebhooks(platformFunctions) {
     const Webhook = {
         DEFAULT_TOLERANCE: 300,
-        // @ts-ignore
         signature: null,
         constructEvent(payload, header, secret, tolerance, cryptoProvider, receivedAt) {
             try {
+                if (!this.signature) {
+                    throw new Error('ERR: missing signature helper, unable to verify');
+                }
                 this.signature.verifyHeader(payload, header, secret, tolerance || Webhook.DEFAULT_TOLERANCE, cryptoProvider, receivedAt);
             }
             catch (e) {
@@ -25,6 +27,9 @@ function createWebhooks(platformFunctions) {
             return jsonPayload;
         },
         async constructEventAsync(payload, header, secret, tolerance, cryptoProvider, receivedAt) {
+            if (!this.signature) {
+                throw new Error('ERR: missing signature helper, unable to verify');
+            }
             await this.signature.verifyHeaderAsync(payload, header, secret, tolerance || Webhook.DEFAULT_TOLERANCE, cryptoProvider, receivedAt);
             const jsonPayload = payload instanceof Uint8Array
                 ? JSON.parse(new TextDecoder('utf8').decode(payload))
@@ -151,7 +156,6 @@ function createWebhooks(platformFunctions) {
         }
         const timestampAge = Math.floor((typeof receivedAt === 'number' ? receivedAt : Date.now()) / 1000) - details.timestamp;
         if (tolerance > 0 && timestampAge > tolerance) {
-            // @ts-ignore
             throw new Error_js_1.StripeSignatureVerificationError(header, payload, {
                 message: 'Timestamp outside the tolerance zone',
             });

package/cjs/apiVersion.js

@@ -2,4 +2,4 @@
 // File generated from our OpenAPI spec
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ApiVersion = void 0;
-exports.ApiVersion = '2025-03-31.preview';
+exports.ApiVersion = '2025-04-30.basil';

package/cjs/net/FetchHttpClient.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FetchHttpClientResponse = exports.FetchHttpClient = void 0;
+const utils_js_1 = require("../utils.js");
 const HttpClient_js_1 = require("./HttpClient.js");
 /**
  * HTTP client which uses a `fetch` function to issue requests.
@@ -97,10 +98,8 @@ class FetchHttpClient extends HttpClient_js_1.HttpClient {
         const body = requestData || (methodHasPayload ? '' : undefined);
         const res = await this._fetchFn(url.toString(), {
             method,
-            // @ts-ignore
-            headers,
-            // @ts-ignore
-            body,
+            headers: (0, utils_js_1.parseHeadersForFetch)(headers),
+            body: typeof body === 'object' ? JSON.stringify(body) : body,
         }, timeout);
         return new FetchHttpClientResponse(res);
     }

package/cjs/resources/FinancialConnections/Accounts.js

@@ -18,11 +18,6 @@ exports.Accounts = StripeResource_js_1.StripeResource.extend({
         method: 'POST',
         fullPath: '/v1/financial_connections/accounts/{account}/disconnect',
     }),
-    listInferredBalances: stripeMethod({
-        method: 'GET',
-        fullPath: '/v1/financial_connections/accounts/{account}/inferred_balances',
-        methodType: 'list',
-    }),
     listOwners: stripeMethod({
         method: 'GET',
         fullPath: '/v1/financial_connections/accounts/{account}/owners',

package/cjs/resources/{PaymentAttemptRecords.js → InvoicePayments.js}

@@ -1,17 +1,17 @@
 "use strict";
 // File generated from our OpenAPI spec
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PaymentAttemptRecords = void 0;
+exports.InvoicePayments = void 0;
 const StripeResource_js_1 = require("../StripeResource.js");
 const stripeMethod = StripeResource_js_1.StripeResource.method;
-exports.PaymentAttemptRecords = StripeResource_js_1.StripeResource.extend({
+exports.InvoicePayments = StripeResource_js_1.StripeResource.extend({
     retrieve: stripeMethod({
         method: 'GET',
-        fullPath: '/v1/payment_attempt_records/{id}',
+        fullPath: '/v1/invoice_payments/{invoice_payment}',
     }),
     list: stripeMethod({
         method: 'GET',
-        fullPath: '/v1/payment_attempt_records',
+        fullPath: '/v1/invoice_payments',
         methodType: 'list',
     }),
 });

package/cjs/resources/Invoices.js

@@ -18,10 +18,6 @@ exports.Invoices = StripeResource_js_1.StripeResource.extend({
         method: 'POST',
         fullPath: '/v1/invoices/{invoice}/add_lines',
     }),
-    attachPayment: stripeMethod({
-        method: 'POST',
-        fullPath: '/v1/invoices/{invoice}/attach_payment',
-    }),
     createPreview: stripeMethod({
         method: 'POST',
         fullPath: '/v1/invoices/create_preview',

package/cjs/resources/PaymentIntents.js

@@ -35,28 +35,15 @@ exports.PaymentIntents = StripeResource_js_1.StripeResource.extend({
         method: 'POST',
         fullPath: '/v1/payment_intents/{intent}/confirm',
     }),
-    decrementAuthorization: stripeMethod({
-        method: 'POST',
-        fullPath: '/v1/payment_intents/{intent}/decrement_authorization',
-    }),
     incrementAuthorization: stripeMethod({
         method: 'POST',
         fullPath: '/v1/payment_intents/{intent}/increment_authorization',
     }),
-    listAmountDetailsLineItems: stripeMethod({
-        method: 'GET',
-        fullPath: '/v1/payment_intents/{intent}/amount_details_line_items',
-        methodType: 'list',
-    }),
     search: stripeMethod({
         method: 'GET',
         fullPath: '/v1/payment_intents/search',
         methodType: 'search',
     }),
-    triggerAction: stripeMethod({
-        method: 'POST',
-        fullPath: '/v1/test/payment_intents/{intent}/trigger_action',
-    }),
     verifyMicrodeposits: stripeMethod({
         method: 'POST',
         fullPath: '/v1/payment_intents/{intent}/verify_microdeposits',

package/cjs/resources/Quotes.js

@@ -19,11 +19,6 @@ exports.Quotes = StripeResource_js_1.StripeResource.extend({
         method: 'POST',
         fullPath: '/v1/quotes/{quote}/finalize',
     }),
-    listPreviewInvoiceLines: stripeMethod({
-        method: 'GET',
-        fullPath: '/v1/quotes/{quote}/preview_invoices/{preview_invoice}/lines',
-        methodType: 'list',
-    }),
     listComputedUpfrontLineItems: stripeMethod({
         method: 'GET',
         fullPath: '/v1/quotes/{quote}/computed_upfront_line_items',
@@ -34,37 +29,10 @@ exports.Quotes = StripeResource_js_1.StripeResource.extend({
         fullPath: '/v1/quotes/{quote}/line_items',
         methodType: 'list',
     }),
-    listLines: stripeMethod({
-        method: 'GET',
-        fullPath: '/v1/quotes/{quote}/lines',
-        methodType: 'list',
-    }),
-    listPreviewInvoices: stripeMethod({
-        method: 'GET',
-        fullPath: '/v1/quotes/{quote}/preview_invoices',
-        methodType: 'list',
-    }),
-    listPreviewSubscriptionSchedules: stripeMethod({
-        method: 'GET',
-        fullPath: '/v1/quotes/{quote}/preview_subscription_schedules',
-        methodType: 'list',
-    }),
-    markDraft: stripeMethod({
-        method: 'POST',
-        fullPath: '/v1/quotes/{quote}/mark_draft',
-    }),
-    markStale: stripeMethod({
-        method: 'POST',
-        fullPath: '/v1/quotes/{quote}/mark_stale',
-    }),
     pdf: stripeMethod({
         method: 'GET',
         fullPath: '/v1/quotes/{quote}/pdf',
         host: 'files.stripe.com',
         streaming: true,
     }),
-    reestimate: stripeMethod({
-        method: 'POST',
-        fullPath: '/v1/quotes/{quote}/reestimate',
-    }),
 });

package/cjs/resources/SubscriptionSchedules.js

@@ -22,10 +22,6 @@ exports.SubscriptionSchedules = StripeResource_js_1.StripeResource.extend({
         fullPath: '/v1/subscription_schedules',
         methodType: 'list',
     }),
-    amend: stripeMethod({
-        method: 'POST',
-        fullPath: '/v1/subscription_schedules/{schedule}/amend',
-    }),
     cancel: stripeMethod({
         method: 'POST',
         fullPath: '/v1/subscription_schedules/{schedule}/cancel',

package/cjs/resources/Terminal/Readers.js

@@ -27,18 +27,6 @@ exports.Readers = StripeResource_js_1.StripeResource.extend({
         method: 'POST',
         fullPath: '/v1/terminal/readers/{reader}/cancel_action',
     }),
-    collectInputs: stripeMethod({
-        method: 'POST',
-        fullPath: '/v1/terminal/readers/{reader}/collect_inputs',
-    }),
-    collectPaymentMethod: stripeMethod({
-        method: 'POST',
-        fullPath: '/v1/terminal/readers/{reader}/collect_payment_method',
-    }),
-    confirmPaymentIntent: stripeMethod({
-        method: 'POST',
-        fullPath: '/v1/terminal/readers/{reader}/confirm_payment_intent',
-    }),
     processPaymentIntent: stripeMethod({
         method: 'POST',
         fullPath: '/v1/terminal/readers/{reader}/process_payment_intent',

package/cjs/resources/TestHelpers/Terminal/Readers.js

@@ -9,12 +9,4 @@ exports.Readers = StripeResource_js_1.StripeResource.extend({
         method: 'POST',
         fullPath: '/v1/test_helpers/terminal/readers/{reader}/present_payment_method',
     }),
-    succeedInputCollection: stripeMethod({
-        method: 'POST',
-        fullPath: '/v1/test_helpers/terminal/readers/{reader}/succeed_input_collection',
-    }),
-    timeoutInputCollection: stripeMethod({
-        method: 'POST',
-        fullPath: '/v1/test_helpers/terminal/readers/{reader}/timeout_input_collection',
-    }),
 });