Merge pull request #2567 from stripe/latest-codegen-private-preview

Update generated code for private-preview

Author: stripe-openapi[bot]

CHANGELOG.md

@@ -19,6 +19,33 @@ This release changes the pinned API version to `2026-01-28.preview`.
   * Add support for `subtotal` on `InvoiceLineItem`
   * Add support for `billing_cadence` on `SubscriptionListParams`
 
+## 20.3.0 - 2026-01-28
+This release changes the pinned API version to `2026-01-28.clover`.
+
+* [#2564](https://github.com/stripe/stripe-node/pull/2564) Update generated code
+  * Add support for new resource `Radar.PaymentEvaluation`
+  * Add support for `create` method on resource `Radar.PaymentEvaluation`
+  * Add support for `adjustable_quantity` on `LineItem`
+  * Add support for new value `risk_reserved` on enum `BalanceTransaction.balance_type`
+  * Add support for new values `reserve_hold` and `reserve_release` on enum `BalanceTransaction.type`
+  * Add support for new values `2.3.0` and `2.3.1` on enums `Charge.payment_method_details.card.three_d_secure.version`, `PaymentIntentConfirmParams.payment_method_options.card.three_d_secure.version`, `PaymentIntentCreateParams.payment_method_options.card.three_d_secure.version`, `PaymentIntentUpdateParams.payment_method_options.card.three_d_secure.version`, `SetupAttempt.payment_method_details.card.three_d_secure.version`, `SetupIntentConfirmParams.payment_method_options.card.three_d_secure.version`, `SetupIntentCreateParams.payment_method_options.card.three_d_secure.version`, and `SetupIntentUpdateParams.payment_method_options.card.three_d_secure.version`
+  * Add support for new value `adyen` on enums `Charge.payment_method_details.ideal.bank`, `ConfirmationToken.payment_method_preview.ideal.bank`, `ConfirmationTokenCreateParams.testHelpers.payment_method_data.ideal.bank`, `PaymentAttemptRecord.payment_method_details.ideal.bank`, `PaymentIntentConfirmParams.payment_method_data.ideal.bank`, `PaymentIntentCreateParams.payment_method_data.ideal.bank`, `PaymentIntentUpdateParams.payment_method_data.ideal.bank`, `PaymentMethod.ideal.bank`, `PaymentMethodCreateParams.ideal.bank`, `PaymentRecord.payment_method_details.ideal.bank`, `SetupAttempt.payment_method_details.ideal.bank`, `SetupIntentConfirmParams.payment_method_data.ideal.bank`, `SetupIntentCreateParams.payment_method_data.ideal.bank`, and `SetupIntentUpdateParams.payment_method_data.ideal.bank`
+  * Add support for new value `ADYBNL2A` on enums `Charge.payment_method_details.ideal.bic`, `ConfirmationToken.payment_method_preview.ideal.bic`, `PaymentAttemptRecord.payment_method_details.ideal.bic`, `PaymentMethod.ideal.bic`, `PaymentRecord.payment_method_details.ideal.bic`, and `SetupAttempt.payment_method_details.ideal.bic`
+  * Add support for new value `pl_nip` on enums `Checkout.Session.customer_details.tax_ids[].type`, `Invoice.customer_tax_ids[].type`, `Tax.Calculation.customer_details.tax_ids[].type`, `Tax.Transaction.customer_details.tax_ids[].type`, and `TaxId.type`
+  * Add support for new value `pl_nip` on enums `CustomerCreateParams.tax_id_data[].type`, `CustomerCreateTaxIdParams.type`, `InvoiceCreatePreviewParams.customer_details.tax_ids[].type`, `Tax.CalculationCreateParams.customer_details.tax_ids[].type`, and `TaxIdCreateParams.type`
+  * Change `Invoice.payment_settings.payment_method_options.payto` and `Subscription.payment_settings.payment_method_options.payto` to be required
+  * Add support for `enforce_arithmetic_validation` on `PaymentIntentCaptureParams.amount_details`, `PaymentIntentConfirmParams.amount_details`, `PaymentIntentCreateParams.amount_details`, `PaymentIntentIncrementAuthorizationParams.amount_details`, and `PaymentIntentUpdateParams.amount_details`
+  * Add support for `error` on `PaymentIntent.amount_details`
+  * Remove support for `bgn` on `Terminal.Configuration.tipping`, `Terminal.ConfigurationCreateParams.tipping`, and `Terminal.ConfigurationUpdateParams.tipping`
+  * Add support for `topup` on `Treasury.ReceivedDebit.linked_flows`
+  * Add support for `contact_phone` on `V2.Core.AccountCreateParams`, `V2.Core.AccountTokenCreateParams`, `V2.Core.AccountUpdateParams`, and `V2.Core.Account`
+  * Add support for `registration_date` on `V2.Core.Account.identity.business_details`, `V2.Core.AccountCreateParams.identity.business_details`, `V2.Core.AccountTokenCreateParams.identity.business_details`, and `V2.Core.AccountUpdateParams.identity.business_details`
+  * Add support for new value `gb_vat` on enums `V2.Core.Account.identity.business_details.id_numbers[].type`, `V2.Core.AccountCreateParams.identity.business_details.id_numbers[].type`, `V2.Core.AccountTokenCreateParams.identity.business_details.id_numbers[].type`, and `V2.Core.AccountUpdateParams.identity.business_details.id_numbers[].type`
+  * Add support for error code `request_blocked` on `Invoice.last_finalization_error`, `PaymentIntent.last_payment_error`, `SetupAttempt.setup_error`, `SetupIntent.last_setup_error`, and `StripeError`
+* [#2558](https://github.com/stripe/stripe-node/pull/2558) Remove `qs` dependency
+  - Remove the `qs` dependency, addressing [Issue #2117](https://github.com/stripe/stripe-node/issues/2117).
+* [#2562](https://github.com/stripe/stripe-node/pull/2562) Document usage of undocumented API parameters
+
 ## 20.3.0-alpha.1 - 2026-01-21
 * [#2559](https://github.com/stripe/stripe-node/pull/2559) Update generated code for private-preview
   * Remove support for `pause` method on resource `Subscription`

CODEGEN_VERSION

@@ -1 +1 @@
-529796460735eb8ef64a29787291f1b4d4b29f1c
+74913070eb5bc81c058d07ad167346b6d68d8b0b

OPENAPI_VERSION

@@ -1 +1 @@
-v2160
+v2164

src/autoPagination.ts

@@ -146,8 +146,9 @@ class V1SearchIterator<T> extends V1Iterator<T> {
 }
 
 class V2ListIterator<T> implements AsyncIterator<T> {
-  private currentPageIterator: Promise<Iterator<T>>;
-  private nextPageUrl: Promise<string | null>;
+  private firstPagePromise: Promise<PageResult<T>> | null;
+  private currentPageIterator: Iterator<T> | null;
+  private nextPageUrl: string | null;
   private requestArgs: RequestArgs;
   private spec: MethodSpec;
   private stripeResource: StripeResourceObject;
@@ -157,32 +158,33 @@ class V2ListIterator<T> implements AsyncIterator<T> {
     spec: MethodSpec,
     stripeResource: StripeResourceObject
   ) {
-    this.currentPageIterator = (async (): Promise<Iterator<T>> => {
-      const page = await firstPagePromise;
-      return page.data[Symbol.iterator]();
-    })();
-
-    this.nextPageUrl = (async (): Promise<string | null> => {
-      const page = await firstPagePromise;
-      return page.next_page_url || null;
-    })();
-
+    this.firstPagePromise = firstPagePromise;
+    this.currentPageIterator = null;
+    this.nextPageUrl = null;
     this.requestArgs = requestArgs;
     this.spec = spec;
     this.stripeResource = stripeResource;
   }
+  private async initFirstPage(): Promise<void> {
+    if (this.firstPagePromise) {
+      const page = await this.firstPagePromise;
+      this.firstPagePromise = null;
+      this.currentPageIterator = page.data[Symbol.iterator]();
+      this.nextPageUrl = page.next_page_url || null;
+    }
+  }
   private async turnPage(): Promise<Iterator<T> | null> {
-    const nextPageUrl = await this.nextPageUrl;
-    if (!nextPageUrl) return null;
-    this.spec.fullPath = nextPageUrl;
+    if (!this.nextPageUrl) return null;
+    this.spec.fullPath = this.nextPageUrl;
     const page = await this.stripeResource._makeRequest([], this.spec, {});
-    this.nextPageUrl = Promise.resolve(page.next_page_url);
-    this.currentPageIterator = Promise.resolve(page.data[Symbol.iterator]());
+    this.nextPageUrl = page.next_page_url || null;
+    this.currentPageIterator = page.data[Symbol.iterator]();
     return this.currentPageIterator;
   }
   async next(): Promise<IteratorResult<T>> {
-    {
-      const result = (await this.currentPageIterator).next();
+    await this.initFirstPage();
+    if (this.currentPageIterator) {
+      const result = this.currentPageIterator.next();
       if (!result.done) return {done: false, value: result.value};
     }
     const nextPageIterator = await this.turnPage();

src/resources.ts

@@ -26,6 +26,7 @@ import {CollectionSettings as V2BillingCollectionSettings} from './resources/V2/
 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 {ConnectionSessions as V2CoreConnectionSessions} from './resources/V2/Core/ConnectionSessions.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';
@@ -389,6 +390,7 @@ export const V2 = resourceNamespace('v2', {
     AccountTokens: V2CoreAccountTokens,
     Accounts: V2CoreAccounts,
     ClaimableSandboxes: V2CoreClaimableSandboxes,
+    ConnectionSessions: V2CoreConnectionSessions,
     EventDestinations: V2CoreEventDestinations,
     Events: V2CoreEvents,
     Vault: resourceNamespace('vault', {

src/resources/V2/Core/ConnectionSessions.ts

@@ -0,0 +1,14 @@
+// File generated from our OpenAPI spec
+
+import {StripeResource} from '../../../StripeResource.js';
+const stripeMethod = StripeResource.method;
+export const ConnectionSessions = StripeResource.extend({
+  create: stripeMethod({
+    method: 'POST',
+    fullPath: '/v2/core/connection_sessions',
+  }),
+  retrieve: stripeMethod({
+    method: 'GET',
+    fullPath: '/v2/core/connection_sessions/{id}',
+  }),
+});

src/resources/V2/Payments/SettlementAllocationIntents.ts

@@ -20,6 +20,11 @@ export const SettlementAllocationIntents = StripeResource.extend({
     method: 'POST',
     fullPath: '/v2/payments/settlement_allocation_intents/{id}',
   }),
+  list: stripeMethod({
+    method: 'GET',
+    fullPath: '/v2/payments/settlement_allocation_intents',
+    methodType: 'list',
+  }),
   cancel: stripeMethod({
     method: 'POST',
     fullPath: '/v2/payments/settlement_allocation_intents/{id}/cancel',

src/resources/V2/Payments/SettlementAllocationIntents/Splits.ts

@@ -13,6 +13,12 @@ export const Splits = StripeResource.extend({
     fullPath:
       '/v2/payments/settlement_allocation_intents/{settlement_allocation_intent_id}/splits/{id}',
   }),
+  list: stripeMethod({
+    method: 'GET',
+    fullPath:
+      '/v2/payments/settlement_allocation_intents/{settlement_allocation_intent_id}/splits',
+    methodType: 'list',
+  }),
   cancel: stripeMethod({
     method: 'POST',
     fullPath:

test/autoPagination.spec.ts

@@ -6,6 +6,7 @@ import {makeAutoPaginationMethods} from '../src/autoPagination.js';
 import {StripeResource} from '../src/StripeResource.js';
 import {getMockStripe} from './testUtils.js';
 import {MethodSpec} from '../src/Types.js';
+import {StripeAPIError} from '../src/Error.js';
 
 describe('auto pagination', () => {
   const testCase = (mockPaginationFn) => ({
@@ -841,6 +842,52 @@ describe('auto pagination', () => {
         ],
       });
     });
+
+    it('handles firstPagePromise rejection without unhandled promise rejection', async () => {
+      const spec = {
+        method: 'GET',
+        fullPath: '/v2/items',
+        methodType: 'list',
+      };
+
+      const mockStripe = getMockStripe({}, () => {});
+      const resource = new StripeResource(mockStripe);
+
+      // Track unhandled rejections
+      const unhandledRejections: Error[] = [];
+      const unhandledRejectionHandler = (reason: Error): void => {
+        unhandledRejections.push(reason);
+      };
+      process.on('unhandledRejection', unhandledRejectionHandler);
+
+      const error = new StripeAPIError({message: 'Something went wrong'});
+      const rejectingPromise = Promise.reject(error);
+
+      const paginator = makeAutoPaginationMethods(
+        resource,
+        {},
+        spec,
+        rejectingPromise
+      );
+
+      // User code catches the error via autoPagingToArray
+      try {
+        await paginator.autoPagingToArray({limit: 10});
+        expect.fail('Should have thrown an error');
+      } catch (e) {
+        expect(e.message).to.equal('Something went wrong');
+      }
+
+      // Give the event loop a chance to process any unhandled rejections
+      await new Promise((resolve) => setTimeout(resolve, 10));
+
+      process.off('unhandledRejection', unhandledRejectionHandler);
+
+      expect(
+        unhandledRejections,
+        'Should not have any unhandled promise rejections'
+      ).to.have.length(0);
+    });
   });
 });