stripe 16.13.0-beta.1 → 17.0.0

package/esm/resources/Quotes.js

@@ -16,11 +16,6 @@ export const Quotes = 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',
@@ -31,37 +26,10 @@ export const Quotes = 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/esm/resources/SubscriptionSchedules.js

@@ -19,10 +19,6 @@ export const SubscriptionSchedules = 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/esm/resources/Terminal/Readers.js

@@ -24,18 +24,6 @@ export const Readers = 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/esm/resources/V2/Billing/MeterEventAdjustments.js

@@ -0,0 +1,9 @@
+// File generated from our OpenAPI spec
+import { StripeResource } from '../../../StripeResource.js';
+const stripeMethod = StripeResource.method;
+export const MeterEventAdjustments = StripeResource.extend({
+    create: stripeMethod({
+        method: 'POST',
+        fullPath: '/v2/billing/meter_event_adjustments',
+    }),
+});

package/esm/resources/V2/Billing/MeterEventSession.js

@@ -0,0 +1,9 @@
+// File generated from our OpenAPI spec
+import { StripeResource } from '../../../StripeResource.js';
+const stripeMethod = StripeResource.method;
+export const MeterEventSession = StripeResource.extend({
+    create: stripeMethod({
+        method: 'POST',
+        fullPath: '/v2/billing/meter_event_session',
+    }),
+});

package/esm/resources/V2/Billing/MeterEventStream.js

@@ -0,0 +1,10 @@
+// File generated from our OpenAPI spec
+import { StripeResource } from '../../../StripeResource.js';
+const stripeMethod = StripeResource.method;
+export const MeterEventStream = StripeResource.extend({
+    create: stripeMethod({
+        method: 'POST',
+        fullPath: '/v2/billing/meter_event_stream',
+        host: 'meter-events.stripe.com',
+    }),
+});

package/esm/resources/V2/Billing/MeterEvents.js

@@ -0,0 +1,6 @@
+// File generated from our OpenAPI spec
+import { StripeResource } from '../../../StripeResource.js';
+const stripeMethod = StripeResource.method;
+export const MeterEvents = StripeResource.extend({
+    create: stripeMethod({ method: 'POST', fullPath: '/v2/billing/meter_events' }),
+});

package/esm/resources/V2/Billing.js

@@ -0,0 +1,15 @@
+// File generated from our OpenAPI spec
+import { StripeResource } from '../../StripeResource.js';
+import { MeterEventSession } from './Billing/MeterEventSession.js';
+import { MeterEventAdjustments } from './Billing/MeterEventAdjustments.js';
+import { MeterEventStream } from './Billing/MeterEventStream.js';
+import { MeterEvents } from './Billing/MeterEvents.js';
+export const Billing = StripeResource.extend({
+    constructor: function (...args) {
+        StripeResource.apply(this, args);
+        this.meterEventSession = new MeterEventSession(...args);
+        this.meterEventAdjustments = new MeterEventAdjustments(...args);
+        this.meterEventStream = new MeterEventStream(...args);
+        this.meterEvents = new MeterEvents(...args);
+    },
+});

package/esm/resources/V2/Core/Events.js

@@ -0,0 +1,11 @@
+// File generated from our OpenAPI spec
+import { StripeResource } from '../../../StripeResource.js';
+const stripeMethod = StripeResource.method;
+export const Events = StripeResource.extend({
+    retrieve: stripeMethod({ method: 'GET', fullPath: '/v2/core/events/{id}' }),
+    list: stripeMethod({
+        method: 'GET',
+        fullPath: '/v2/core/events',
+        methodType: 'list',
+    }),
+});

package/esm/resources/V2/Core.js

@@ -0,0 +1,9 @@
+// File generated from our OpenAPI spec
+import { StripeResource } from '../../StripeResource.js';
+import { Events } from './Core/Events.js';
+export const Core = StripeResource.extend({
+    constructor: function (...args) {
+        StripeResource.apply(this, args);
+        this.events = new Events(...args);
+    },
+});

package/esm/resources/V2.js

@@ -0,0 +1,11 @@
+// File generated from our OpenAPI spec
+import { StripeResource } from '../StripeResource.js';
+import { Billing } from './V2/Billing.js';
+import { Core } from './V2/Core.js';
+export const V2 = StripeResource.extend({
+    constructor: function (...args) {
+        StripeResource.apply(this, args);
+        this.billing = new Billing(...args);
+        this.core = new Core(...args);
+    },
+});

package/esm/resources.js

@@ -3,34 +3,28 @@ import { resourceNamespace } from './ResourceNamespace.js';
 import { Accounts as FinancialConnectionsAccounts } from './resources/FinancialConnections/Accounts.js';
 import { ActiveEntitlements as EntitlementsActiveEntitlements } from './resources/Entitlements/ActiveEntitlements.js';
 import { Alerts as BillingAlerts } from './resources/Billing/Alerts.js';
-import { Associations as TaxAssociations } from './resources/Tax/Associations.js';
 import { Authorizations as TestHelpersIssuingAuthorizations } from './resources/TestHelpers/Issuing/Authorizations.js';
 import { Authorizations as IssuingAuthorizations } from './resources/Issuing/Authorizations.js';
 import { Calculations as TaxCalculations } from './resources/Tax/Calculations.js';
 import { Cardholders as IssuingCardholders } from './resources/Issuing/Cardholders.js';
 import { Cards as TestHelpersIssuingCards } from './resources/TestHelpers/Issuing/Cards.js';
-import { Cards as GiftCardsCards } from './resources/GiftCards/Cards.js';
 import { Cards as IssuingCards } from './resources/Issuing/Cards.js';
 import { Configurations as BillingPortalConfigurations } from './resources/BillingPortal/Configurations.js';
 import { Configurations as TerminalConfigurations } from './resources/Terminal/Configurations.js';
 import { ConfirmationTokens as TestHelpersConfirmationTokens } from './resources/TestHelpers/ConfirmationTokens.js';
 import { ConnectionTokens as TerminalConnectionTokens } from './resources/Terminal/ConnectionTokens.js';
+import { CreditBalanceSummary as BillingCreditBalanceSummary } from './resources/Billing/CreditBalanceSummary.js';
+import { CreditBalanceTransactions as BillingCreditBalanceTransactions } from './resources/Billing/CreditBalanceTransactions.js';
+import { CreditGrants as BillingCreditGrants } from './resources/Billing/CreditGrants.js';
 import { CreditReversals as TreasuryCreditReversals } from './resources/Treasury/CreditReversals.js';
-import { CreditUnderwritingRecords as IssuingCreditUnderwritingRecords } from './resources/Issuing/CreditUnderwritingRecords.js';
 import { Customers as TestHelpersCustomers } from './resources/TestHelpers/Customers.js';
 import { DebitReversals as TreasuryDebitReversals } from './resources/Treasury/DebitReversals.js';
-import { DisputeSettlementDetails as IssuingDisputeSettlementDetails } from './resources/Issuing/DisputeSettlementDetails.js';
 import { Disputes as IssuingDisputes } from './resources/Issuing/Disputes.js';
 import { EarlyFraudWarnings as RadarEarlyFraudWarnings } from './resources/Radar/EarlyFraudWarnings.js';
 import { Features as EntitlementsFeatures } from './resources/Entitlements/Features.js';
 import { FinancialAccounts as TreasuryFinancialAccounts } from './resources/Treasury/FinancialAccounts.js';
-import { FinancingOffers as CapitalFinancingOffers } from './resources/Capital/FinancingOffers.js';
-import { FinancingSummary as CapitalFinancingSummary } from './resources/Capital/FinancingSummary.js';
-import { FinancingTransactions as CapitalFinancingTransactions } from './resources/Capital/FinancingTransactions.js';
-import { Forms as TaxForms } from './resources/Tax/Forms.js';
 import { InboundTransfers as TestHelpersTreasuryInboundTransfers } from './resources/TestHelpers/Treasury/InboundTransfers.js';
 import { InboundTransfers as TreasuryInboundTransfers } from './resources/Treasury/InboundTransfers.js';
-import { Institutions as FinancialConnectionsInstitutions } from './resources/FinancialConnections/Institutions.js';
 import { Locations as TerminalLocations } from './resources/Terminal/Locations.js';
 import { MeterEventAdjustments as BillingMeterEventAdjustments } from './resources/Billing/MeterEventAdjustments.js';
 import { MeterEvents as BillingMeterEvents } from './resources/Billing/MeterEvents.js';
@@ -44,7 +38,6 @@ import { PersonalizationDesigns as TestHelpersIssuingPersonalizationDesigns } fr
 import { PersonalizationDesigns as IssuingPersonalizationDesigns } from './resources/Issuing/PersonalizationDesigns.js';
 import { PhysicalBundles as IssuingPhysicalBundles } from './resources/Issuing/PhysicalBundles.js';
 import { Products as ClimateProducts } from './resources/Climate/Products.js';
-import { ReaderCollectedData as TerminalReaderCollectedData } from './resources/Terminal/ReaderCollectedData.js';
 import { Readers as TestHelpersTerminalReaders } from './resources/TestHelpers/Terminal/Readers.js';
 import { Readers as TerminalReaders } from './resources/Terminal/Readers.js';
 import { ReceivedCredits as TestHelpersTreasuryReceivedCredits } from './resources/TestHelpers/Treasury/ReceivedCredits.js';
@@ -68,7 +61,6 @@ import { Tokens as IssuingTokens } from './resources/Issuing/Tokens.js';
 import { TransactionEntries as TreasuryTransactionEntries } from './resources/Treasury/TransactionEntries.js';
 import { Transactions as TestHelpersIssuingTransactions } from './resources/TestHelpers/Issuing/Transactions.js';
 import { Transactions as FinancialConnectionsTransactions } from './resources/FinancialConnections/Transactions.js';
-import { Transactions as GiftCardsTransactions } from './resources/GiftCards/Transactions.js';
 import { Transactions as IssuingTransactions } from './resources/Issuing/Transactions.js';
 import { Transactions as TaxTransactions } from './resources/Tax/Transactions.js';
 import { Transactions as TreasuryTransactions } from './resources/Treasury/Transactions.js';
@@ -78,7 +70,6 @@ import { VerificationReports as IdentityVerificationReports } from './resources/
 import { VerificationSessions as IdentityVerificationSessions } from './resources/Identity/VerificationSessions.js';
 export { Accounts as Account } from './resources/Accounts.js';
 export { AccountLinks } from './resources/AccountLinks.js';
-export { AccountNotices } from './resources/AccountNotices.js';
 export { AccountSessions } from './resources/AccountSessions.js';
 export { Accounts } from './resources/Accounts.js';
 export { ApplePayDomains } from './resources/ApplePayDomains.js';
@@ -102,9 +93,7 @@ export { InvoiceItems } from './resources/InvoiceItems.js';
 export { InvoiceRenderingTemplates } from './resources/InvoiceRenderingTemplates.js';
 export { Invoices } from './resources/Invoices.js';
 export { Mandates } from './resources/Mandates.js';
-export { Margins } from './resources/Margins.js';
 export { OAuth } from './resources/OAuth.js';
-export { Orders } from './resources/Orders.js';
 export { PaymentIntents } from './resources/PaymentIntents.js';
 export { PaymentLinks } from './resources/PaymentLinks.js';
 export { PaymentMethodConfigurations } from './resources/PaymentMethodConfigurations.js';
@@ -131,10 +120,14 @@ export { TaxRates } from './resources/TaxRates.js';
 export { Tokens } from './resources/Tokens.js';
 export { Topups } from './resources/Topups.js';
 export { Transfers } from './resources/Transfers.js';
+export { V2 } from './resources/V2.js';
 export { WebhookEndpoints } from './resources/WebhookEndpoints.js';
 export const Apps = resourceNamespace('apps', { Secrets: AppsSecrets });
 export const Billing = resourceNamespace('billing', {
     Alerts: BillingAlerts,
+    CreditBalanceSummary: BillingCreditBalanceSummary,
+    CreditBalanceTransactions: BillingCreditBalanceTransactions,
+    CreditGrants: BillingCreditGrants,
     MeterEventAdjustments: BillingMeterEventAdjustments,
     MeterEvents: BillingMeterEvents,
     Meters: BillingMeters,
@@ -143,11 +136,6 @@ export const BillingPortal = resourceNamespace('billingPortal', {
     Configurations: BillingPortalConfigurations,
     Sessions: BillingPortalSessions,
 });
-export const Capital = resourceNamespace('capital', {
-    FinancingOffers: CapitalFinancingOffers,
-    FinancingSummary: CapitalFinancingSummary,
-    FinancingTransactions: CapitalFinancingTransactions,
-});
 export const Checkout = resourceNamespace('checkout', {
     Sessions: CheckoutSessions,
 });
@@ -162,17 +150,12 @@ export const Entitlements = resourceNamespace('entitlements', {
 });
 export const FinancialConnections = resourceNamespace('financialConnections', {
     Accounts: FinancialConnectionsAccounts,
-    Institutions: FinancialConnectionsInstitutions,
     Sessions: FinancialConnectionsSessions,
     Transactions: FinancialConnectionsTransactions,
 });
 export const Forwarding = resourceNamespace('forwarding', {
     Requests: ForwardingRequests,
 });
-export const GiftCards = resourceNamespace('giftCards', {
-    Cards: GiftCardsCards,
-    Transactions: GiftCardsTransactions,
-});
 export const Identity = resourceNamespace('identity', {
     VerificationReports: IdentityVerificationReports,
     VerificationSessions: IdentityVerificationSessions,
@@ -181,8 +164,6 @@ export const Issuing = resourceNamespace('issuing', {
     Authorizations: IssuingAuthorizations,
     Cardholders: IssuingCardholders,
     Cards: IssuingCards,
-    CreditUnderwritingRecords: IssuingCreditUnderwritingRecords,
-    DisputeSettlementDetails: IssuingDisputeSettlementDetails,
     Disputes: IssuingDisputes,
     PersonalizationDesigns: IssuingPersonalizationDesigns,
     PhysicalBundles: IssuingPhysicalBundles,
@@ -202,9 +183,7 @@ export const Sigma = resourceNamespace('sigma', {
     ScheduledQueryRuns: SigmaScheduledQueryRuns,
 });
 export const Tax = resourceNamespace('tax', {
-    Associations: TaxAssociations,
     Calculations: TaxCalculations,
-    Forms: TaxForms,
     Registrations: TaxRegistrations,
     Settings: TaxSettings,
     Transactions: TaxTransactions,
@@ -213,7 +192,6 @@ export const Terminal = resourceNamespace('terminal', {
     Configurations: TerminalConfigurations,
     ConnectionTokens: TerminalConnectionTokens,
     Locations: TerminalLocations,
-    ReaderCollectedData: TerminalReaderCollectedData,
     Readers: TerminalReaders,
 });
 export const TestHelpers = resourceNamespace('testHelpers', {

package/esm/stripe.core.js

@@ -6,16 +6,17 @@ import { ApiVersion } from './apiVersion.js';
 import { CryptoProvider } from './crypto/CryptoProvider.js';
 import { HttpClient, HttpClientResponse } from './net/HttpClient.js';
 import * as resources from './resources.js';
-import { determineProcessUserAgentProperties, pascalToCamelCase, validateInteger, } from './utils.js';
+import { createApiKeyAuthenticator, determineProcessUserAgentProperties, pascalToCamelCase, validateInteger, } from './utils.js';
 const DEFAULT_HOST = 'api.stripe.com';
 const DEFAULT_PORT = '443';
 const DEFAULT_BASE_PATH = '/v1/';
 const DEFAULT_API_VERSION = ApiVersion;
 const DEFAULT_TIMEOUT = 80000;
-const MAX_NETWORK_RETRY_DELAY_SEC = 2;
+const MAX_NETWORK_RETRY_DELAY_SEC = 5;
 const INITIAL_NETWORK_RETRY_DELAY_SEC = 0.5;
 const APP_INFO_PROPERTIES = ['name', 'version', 'url', 'partner_id'];
 const ALLOWED_CONFIG_PROPERTIES = [
+    'authenticator',
     'apiVersion',
     'typescript',
     'maxNetworkRetries',
@@ -28,10 +29,11 @@ const ALLOWED_CONFIG_PROPERTIES = [
     'telemetry',
     'appInfo',
     'stripeAccount',
+    'stripeContext',
 ];
 const defaultRequestSenderFactory = (stripe) => new RequestSender(stripe, StripeResource.MAX_BUFFERED_REQUEST_METRICS);
 export function createStripe(platformFunctions, requestSender = defaultRequestSenderFactory) {
-    Stripe.PACKAGE_VERSION = '16.13.0-beta.1';
+    Stripe.PACKAGE_VERSION = '17.0.0';
     Stripe.USER_AGENT = Object.assign({ bindings_version: Stripe.PACKAGE_VERSION, lang: 'node', publisher: 'stripe', uname: null, typescript: false }, determineProcessUserAgentProperties());
     Stripe.StripeResource = StripeResource;
     Stripe.resources = resources;
@@ -66,14 +68,13 @@ export function createStripe(platformFunctions, requestSender = defaultRequestSe
         this.off = this._emitter.removeListener.bind(this._emitter);
         const agent = props.httpAgent || null;
         this._api = {
-            auth: null,
             host: props.host || DEFAULT_HOST,
             port: props.port || DEFAULT_PORT,
             protocol: props.protocol || 'https',
             basePath: DEFAULT_BASE_PATH,
             version: props.apiVersion || DEFAULT_API_VERSION,
             timeout: validateInteger('timeout', props.timeout, DEFAULT_TIMEOUT),
-            maxNetworkRetries: validateInteger('maxNetworkRetries', props.maxNetworkRetries, 1),
+            maxNetworkRetries: validateInteger('maxNetworkRetries', props.maxNetworkRetries, 2),
             agent: agent,
             httpClient: props.httpClient ||
                 (agent
@@ -81,6 +82,7 @@ export function createStripe(platformFunctions, requestSender = defaultRequestSe
                     : this._platformFunctions.createDefaultHttpClient()),
             dev: false,
             stripeAccount: props.stripeAccount || null,
+            stripeContext: props.stripeContext || null,
         };
         const typescript = props.typescript || false;
         if (typescript !== Stripe.USER_AGENT.typescript) {
@@ -94,7 +96,7 @@ export function createStripe(platformFunctions, requestSender = defaultRequestSe
             this._setAppInfo(props.appInfo);
         }
         this._prepResources();
-        this._setApiKey(key);
+        this._setAuthenticator(key, props.authenticator);
         this.errors = _Error;
         // Once Stripe.webhooks looses the factory function signature in a future release
         // then this should become this.webhooks = Stripe.webhooks
@@ -153,10 +155,16 @@ export function createStripe(platformFunctions, requestSender = defaultRequestSe
         /**
          * @private
          */
-        _setApiKey(key) {
-            if (key) {
-                this._setApiField('auth', `Bearer ${key}`);
+        _setAuthenticator(key, authenticator) {
+            if (key && authenticator) {
+                throw new Error("Can't specify both apiKey and authenticator");
             }
+            if (!key && !authenticator) {
+                throw new Error('Neither apiKey nor config.authenticator provided');
+            }
+            this._authenticator = key
+                ? createApiKeyAuthenticator(key)
+                : authenticator;
         },
         /**
          * @private
@@ -355,6 +363,10 @@ export function createStripe(platformFunctions, requestSender = defaultRequestSe
             }
             return config;
         },
+        parseThinEvent(payload, header, secret, tolerance, cryptoProvider, receivedAt) {
+            // parses and validates the event payload all in one go
+            return this.webhooks.constructEvent(payload, header, secret, tolerance, cryptoProvider, receivedAt);
+        },
     };
     return Stripe;
 }

package/esm/utils.js

@@ -7,7 +7,8 @@ const OPTIONS_KEYS = [
     'maxNetworkRetries',
     'timeout',
     'host',
-    'apiMode',
+    'authenticator',
+    'stripeContext',
     'additionalHeaders',
 ];
 export function isOptionsHash(o) {
@@ -19,10 +20,11 @@ export function isOptionsHash(o) {
  * Stringifies an Object, accommodating nested objects
  * (forming the conventional key 'parent[child]=value')
  */
-export function queryStringifyRequestData(data) {
+export function queryStringifyRequestData(data, apiMode) {
     return (qs
         .stringify(data, {
         serializeDate: (d) => Math.floor(d.getTime() / 1000).toString(),
+        arrayFormat: apiMode == 'v2' ? 'repeat' : 'indices',
     })
         // Don't use strict form encoding by changing the square bracket control
         // characters back to their literals. This is fine by the server, and
@@ -89,7 +91,6 @@ export function getDataFromArgs(args) {
  */
 export function getOptionsFromArgs(args) {
     const opts = {
-        auth: null,
         host: null,
         headers: {},
         settings: {},
@@ -97,7 +98,7 @@ export function getOptionsFromArgs(args) {
     if (args.length > 0) {
         const arg = args[args.length - 1];
         if (typeof arg === 'string') {
-            opts.auth = args.pop();
+            opts.authenticator = createApiKeyAuthenticator(args.pop());
         }
         else if (isOptionsHash(arg)) {
             const params = Object.assign({}, args.pop());
@@ -106,7 +107,7 @@ export function getOptionsFromArgs(args) {
                 emitWarning(`Invalid options found (${extraKeys.join(', ')}); ignoring.`);
             }
             if (params.apiKey) {
-                opts.auth = params.apiKey;
+                opts.authenticator = createApiKeyAuthenticator(params.apiKey);
             }
             if (params.idempotencyKey) {
                 opts.headers['Idempotency-Key'] = params.idempotencyKey;
@@ -114,6 +115,12 @@ export function getOptionsFromArgs(args) {
             if (params.stripeAccount) {
                 opts.headers['Stripe-Account'] = params.stripeAccount;
             }
+            if (params.stripeContext) {
+                if (opts.headers['Stripe-Account']) {
+                    throw new Error("Can't specify both stripeAccount and stripeContext.");
+                }
+                opts.headers['Stripe-Context'] = params.stripeContext;
+            }
             if (params.apiVersion) {
                 opts.headers['Stripe-Version'] = params.apiVersion;
             }
@@ -126,11 +133,15 @@ export function getOptionsFromArgs(args) {
             if (params.host) {
                 opts.host = params.host;
             }
-            if (params.apiMode) {
-                if (params.apiMode !== 'standard' && params.apiMode !== 'preview') {
-                    throw new Error(`Invalid apiMode: ${params.apiMode}. Must be one of 'standard' or 'preview'`);
+            if (params.authenticator) {
+                if (params.apiKey) {
+                    throw new Error("Can't specify both apiKey and authenticator.");
+                }
+                if (typeof params.authenticator !== 'function') {
+                    throw new Error('The authenticator must be a function ' +
+                        'receiving a request as the first parameter.');
                 }
-                opts.apiMode = params.apiMode;
+                opts.authenticator = params.authenticator;
             }
             if (params.additionalHeaders) {
                 opts.headers = params.additionalHeaders;
@@ -281,6 +292,15 @@ export function determineProcessUserAgentProperties() {
             platform: process.platform,
         };
 }
+export function createApiKeyAuthenticator(apiKey) {
+    const authenticator = (request) => {
+        request.headers.Authorization = 'Bearer ' + apiKey;
+        return Promise.resolve();
+    };
+    // For testing
+    authenticator._apiKey = apiKey;
+    return authenticator;
+}
 /**
  * Joins an array of Uint8Arrays into a single Uint8Array
  */
@@ -309,3 +329,12 @@ function dateTimeReplacer(key, value) {
 export function jsonStringifyRequestData(data) {
     return JSON.stringify(data, dateTimeReplacer);
 }
+/**
+ * Inspects the given path to determine if the endpoint is for v1 or v2 API
+ */
+export function getAPIMode(path) {
+    if (!path) {
+        return 'v1';
+    }
+    return path.startsWith('/v2') ? 'v2' : 'v1';
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stripe",
-  "version": "16.13.0-beta.1",
+  "version": "17.0.0",
   "description": "Stripe API wrapper",
   "keywords": [
     "stripe",

package/types/AccountLinksResource.d.ts

@@ -60,11 +60,7 @@ declare module 'stripe' {
         type FutureRequirements = 'include' | 'omit';
       }
 
-      type Type =
-        | 'account_onboarding'
-        | 'account_update'
-        | 'capital_financing_offer'
-        | 'capital_financing_reporting';
+      type Type = 'account_onboarding' | 'account_update';
     }
 
     class AccountLinksResource {

package/types/AccountSessions.d.ts

@@ -52,12 +52,6 @@ declare module 'stripe' {
 
         balances: Components.Balances;
 
-        capital_financing?: Components.CapitalFinancing | null;
-
-        capital_financing_application?: Components.CapitalFinancingApplication | null;
-
-        capital_financing_promotion?: Components.CapitalFinancingPromotion | null;
-
         documents: Components.Documents;
 
         notification_banner: Components.NotificationBanner;
@@ -145,45 +139,6 @@ declare module 'stripe' {
           }
         }
 
-        interface CapitalFinancing {
-          /**
-           * Whether the embedded component is enabled.
-           */
-          enabled: boolean;
-
-          features: CapitalFinancing.Features;
-        }
-
-        namespace CapitalFinancing {
-          interface Features {}
-        }
-
-        interface CapitalFinancingApplication {
-          /**
-           * Whether the embedded component is enabled.
-           */
-          enabled: boolean;
-
-          features: CapitalFinancingApplication.Features;
-        }
-
-        namespace CapitalFinancingApplication {
-          interface Features {}
-        }
-
-        interface CapitalFinancingPromotion {
-          /**
-           * Whether the embedded component is enabled.
-           */
-          enabled: boolean;
-
-          features: CapitalFinancingPromotion.Features;
-        }
-
-        namespace CapitalFinancingPromotion {
-          interface Features {}
-        }
-
         interface Documents {
           /**
            * Whether the embedded component is enabled.