Merge pull request #2039 from stripe/latest-codegen-beta

Update generated code for beta

.gitignore

@@ -7,5 +7,6 @@ tags
 coverage
 .idea
 testProjects/**/node_modules
+testProjects/**/dist
 testProjects/**/package-lock.json
 testProjects/**/_worker.*

OPENAPI_VERSION

@@ -1 +1 @@
-v879
+v896

src/Error.ts

@@ -49,9 +49,9 @@ export class StripeError extends Error {
   readonly setup_intent?: any;
   readonly source?: any;
 
-  constructor(raw: StripeRawError = {}) {
+  constructor(raw: StripeRawError = {}, type: string | null = null) {
     super(raw.message);
-    this.type = this.constructor.name;
+    this.type = type || this.constructor.name;
 
     this.raw = raw;
     this.rawType = raw.type;
@@ -86,47 +86,75 @@ export class StripeError extends Error {
  * CardError is raised when a user enters a card that can't be charged for
  * some reason.
  */
-export class StripeCardError extends StripeError {}
+export class StripeCardError extends StripeError {
+  constructor(raw: StripeRawError = {}) {
+    super(raw, 'StripeCardError');
+  }
+}
 
 /**
  * InvalidRequestError is raised when a request is initiated with invalid
  * parameters.
  */
-export class StripeInvalidRequestError extends StripeError {}
+export class StripeInvalidRequestError extends StripeError {
+  constructor(raw: StripeRawError = {}) {
+    super(raw, 'StripeInvalidRequestError');
+  }
+}
 
 /**
  * APIError is a generic error that may be raised in cases where none of the
  * other named errors cover the problem. It could also be raised in the case
  * that a new error has been introduced in the API, but this version of the
  * Node.JS SDK doesn't know how to handle it.
  */
-export class StripeAPIError extends StripeError {}
+export class StripeAPIError extends StripeError {
+  constructor(raw: StripeRawError = {}) {
+    super(raw, 'StripeAPIError');
+  }
+}
 
 /**
  * AuthenticationError is raised when invalid credentials are used to connect
  * to Stripe's servers.
  */
-export class StripeAuthenticationError extends StripeError {}
+export class StripeAuthenticationError extends StripeError {
+  constructor(raw: StripeRawError = {}) {
+    super(raw, 'StripeAuthenticationError');
+  }
+}
 
 /**
  * PermissionError is raised in cases where access was attempted on a resource
  * that wasn't allowed.
  */
-export class StripePermissionError extends StripeError {}
+export class StripePermissionError extends StripeError {
+  constructor(raw: StripeRawError = {}) {
+    super(raw, 'StripePermissionError');
+  }
+}
 
 /**
  * RateLimitError is raised in cases where an account is putting too much load
  * on Stripe's API servers (usually by performing too many requests). Please
  * back off on request rate.
  */
-export class StripeRateLimitError extends StripeError {}
+export class StripeRateLimitError extends StripeError {
+  constructor(raw: StripeRawError = {}) {
+    super(raw, 'StripeRateLimitError');
+  }
+}
 
 /**
  * StripeConnectionError is raised in the event that the SDK can't connect to
  * Stripe's servers. That can be for a variety of different reasons from a
  * downed network to a bad TLS certificate.
  */
-export class StripeConnectionError extends StripeError {}
+export class StripeConnectionError extends StripeError {
+  constructor(raw: StripeRawError = {}) {
+    super(raw, 'StripeConnectionError');
+  }
+}
 
 /**
  * SignatureVerificationError is raised when the signature verification for a
@@ -141,7 +169,7 @@ export class StripeSignatureVerificationError extends StripeError {
     payload: string | Uint8Array,
     raw: StripeRawError = {}
   ) {
-    super(raw);
+    super(raw, 'StripeSignatureVerificationError');
     this.header = header;
     this.payload = payload;
   }
@@ -151,17 +179,29 @@ export class StripeSignatureVerificationError extends StripeError {
  * IdempotencyError is raised in cases where an idempotency key was used
  * improperly.
  */
-export class StripeIdempotencyError extends StripeError {}
+export class StripeIdempotencyError extends StripeError {
+  constructor(raw: StripeRawError = {}) {
+    super(raw, 'StripeIdempotencyError');
+  }
+}
 
 /**
  * InvalidGrantError is raised when a specified code doesn't exist, is
  * expired, has been used, or doesn't belong to you; a refresh token doesn't
  * exist, or doesn't belong to you; or if an API key's mode (live or test)
  * doesn't match the mode of a code or refresh token.
  */
-export class StripeInvalidGrantError extends StripeError {}
+export class StripeInvalidGrantError extends StripeError {
+  constructor(raw: StripeRawError = {}) {
+    super(raw, 'StripeInvalidGrantError');
+  }
+}
 
 /**
  * Any other error from Stripe not specifically captured above
  */
-export class StripeUnknownError extends StripeError {}
+export class StripeUnknownError extends StripeError {
+  constructor(raw: StripeRawError = {}) {
+    super(raw, 'StripeUnknownError');
+  }
+}

src/apiVersion.ts

@@ -1,4 +1,4 @@
 // File generated from our OpenAPI spec
 
 export const ApiVersion = '2023-10-16';
-export const PreviewVersion = '2024-02-15.preview-v2';
+export const PreviewVersion = '2024-03-20.preview-v2';

src/resources.ts

@@ -2,6 +2,7 @@
 
 import {resourceNamespace} from './ResourceNamespace.js';
 import {Accounts as FinancialConnectionsAccounts} from './resources/FinancialConnections/Accounts.js';
+import {ActiveEntitlements as EntitlementsActiveEntitlements} from './resources/Entitlements/ActiveEntitlements.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';
@@ -50,6 +51,7 @@ import {Refunds as TestHelpersRefunds} from './resources/TestHelpers/Refunds.js'
 import {Registrations as TaxRegistrations} from './resources/Tax/Registrations.js';
 import {ReportRuns as ReportingReportRuns} from './resources/Reporting/ReportRuns.js';
 import {ReportTypes as ReportingReportTypes} from './resources/Reporting/ReportTypes.js';
+import {Requests as ForwardingRequests} from './resources/Forwarding/Requests.js';
 import {ScheduledQueryRuns as SigmaScheduledQueryRuns} from './resources/Sigma/ScheduledQueryRuns.js';
 import {Secrets as AppsSecrets} from './resources/Apps/Secrets.js';
 import {Sessions as BillingPortalSessions} from './resources/BillingPortal/Sessions.js';
@@ -150,13 +152,17 @@ export const Climate = resourceNamespace('climate', {
   Suppliers: ClimateSuppliers,
 });
 export const Entitlements = resourceNamespace('entitlements', {
+  ActiveEntitlements: EntitlementsActiveEntitlements,
   Features: EntitlementsFeatures,
 });
 export const FinancialConnections = resourceNamespace('financialConnections', {
   Accounts: FinancialConnectionsAccounts,
   Sessions: FinancialConnectionsSessions,
   Transactions: FinancialConnectionsTransactions,
 });
+export const Forwarding = resourceNamespace('forwarding', {
+  Requests: ForwardingRequests,
+});
 export const GiftCards = resourceNamespace('giftCards', {
   Cards: GiftCardsCards,
   Transactions: GiftCardsTransactions,

src/resources/Customers.ts

@@ -50,11 +50,6 @@ export const Customers = StripeResource.extend({
     fullPath: '/v1/customers/{customer}/cash_balance_transactions',
     methodType: 'list',
   }),
-  listEntitlements: stripeMethod({
-    method: 'GET',
-    fullPath: '/v1/customers/{customer}/entitlements',
-    methodType: 'list',
-  }),
   listPaymentMethods: stripeMethod({
     method: 'GET',
     fullPath: '/v1/customers/{customer}/payment_methods',
@@ -83,10 +78,6 @@ export const Customers = StripeResource.extend({
     fullPath:
       '/v1/customers/{customer}/cash_balance_transactions/{transaction}',
   }),
-  retrieveEntitlementSummary: stripeMethod({
-    method: 'GET',
-    fullPath: '/v1/customers/{customer}/entitlement_summary',
-  }),
   retrievePaymentMethod: stripeMethod({
     method: 'GET',
     fullPath: '/v1/customers/{customer}/payment_methods/{payment_method}',

src/resources/Entitlements/ActiveEntitlements.ts

@@ -0,0 +1,11 @@
+// File generated from our OpenAPI spec
+
+import {StripeResource} from '../../StripeResource.js';
+const stripeMethod = StripeResource.method;
+export const ActiveEntitlements = StripeResource.extend({
+  list: stripeMethod({
+    method: 'GET',
+    fullPath: '/v1/entitlements/active_entitlements',
+    methodType: 'list',
+  }),
+});

src/resources/Forwarding/Requests.ts

@@ -0,0 +1,16 @@
+// File generated from our OpenAPI spec
+
+import {StripeResource} from '../../StripeResource.js';
+const stripeMethod = StripeResource.method;
+export const Requests = StripeResource.extend({
+  create: stripeMethod({method: 'POST', fullPath: '/v1/forwarding/requests'}),
+  retrieve: stripeMethod({
+    method: 'GET',
+    fullPath: '/v1/forwarding/requests/{id}',
+  }),
+  list: stripeMethod({
+    method: 'GET',
+    fullPath: '/v1/forwarding/requests',
+    methodType: 'list',
+  }),
+});

src/resources/Products.ts

@@ -12,6 +12,19 @@ export const Products = StripeResource.extend({
     methodType: 'list',
   }),
   del: stripeMethod({method: 'DELETE', fullPath: '/v1/products/{id}'}),
+  createFeature: stripeMethod({
+    method: 'POST',
+    fullPath: '/v1/products/{product}/features',
+  }),
+  deleteFeature: stripeMethod({
+    method: 'DELETE',
+    fullPath: '/v1/products/{product}/features/{id}',
+  }),
+  listFeatures: stripeMethod({
+    method: 'GET',
+    fullPath: '/v1/products/{product}/features',
+    methodType: 'list',
+  }),
   search: stripeMethod({
     method: 'GET',
     fullPath: '/v1/products/search',

test/Error.spec.ts

@@ -58,7 +58,17 @@ describe('Error', () => {
       expect(e).to.have.property('statusCode', 400);
     });
 
-    it('has subclasses which provide `.type` as their name', () => {
+    it('respects subclasses overriding `.type` in constructor', () => {
+      class Foo extends Error.StripeError {
+        constructor(raw: any) {
+          super(raw, 'Foo');
+        }
+      }
+      const err = new Foo({message: 'hi'});
+      expect(err).to.have.property('type', 'Foo');
+    });
+
+    it('defaults setting `.type` to subclass name', () => {
       class Foo extends Error.StripeError {}
       const err = new Foo({message: 'hi'});
       expect(err).to.have.property('type', 'Foo');

test/Integration.spec.ts

@@ -55,6 +55,22 @@ describe('Integration test', function() {
     await runTestProject('mjs-ts');
   });
 
+  describe('esbuild', () => {
+    it('should not change error.type when minified', async function() {
+      // Node supports ES Modules starting at v12
+      if (nodeVersion <= 12) {
+        this.skip();
+      }
+
+      await testExec(`
+        cd testProjects/esbuild && rm -rf node_modules && rm -rf dist
+        npm install &&
+        npm run build &&
+        npm run start
+      `);
+    });
+  });
+
   const runTestCloudflareProject = (projectName: string): Promise<void> => {
     if (process.versions.node < '16.13') {
       console.log('Wrangler requires at least node.js v16.13.0, skipping test');

testProjects/esbuild/index.js

@@ -0,0 +1,35 @@
+import {Stripe} from 'stripe';
+import assert from 'assert';
+
+// API key is null to trigger an authentication error
+const stripe = new Stripe(null, {
+    host: process.env.STRIPE_MOCK_HOST || 'localhost',
+    port: process.env.STRIPE_MOCK_PORT || 12111,
+    protocol: 'http',
+});
+
+try {
+  throw new stripe.errors.StripeUnknownError({
+    charge: 'foo',
+    unknown_prop: 'bar',
+  });
+} catch (e) {
+  assert (e instanceof stripe.errors.StripeUnknownError);
+  assert (e.type === 'StripeUnknownError');
+}
+
+async function exampleFunction(args) {
+  try {
+    await stripe.paymentIntents.create(args);
+  } catch (e) {
+    assert (e instanceof stripe.errors.StripeAuthenticationError);
+    assert (e.type === 'StripeAuthenticationError');
+  }
+}
+
+exampleFunction({
+  // The required parameter currency is missing
+  amount: 2000,
+  confirm: true,
+  payment_method: 'pm_card_visa',
+});

testProjects/esbuild/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "mjs",
+  "version": "1.0.0",
+  "description": "",
+  "main": "index.js",
+  "dependencies": {
+    "stripe": "file:../../"
+  },
+  "scripts": {
+    "clean": "rm -rf node_modules && rm -rf dist",
+    "build": "esbuild index.js --bundle --platform=node --minify --target=es2020 --outdir=dist",
+    "start": "node dist/index.js"
+  },
+  "devDependencies": {
+    "esbuild": "^0.20.2"
+  }
+}

types/Accounts.d.ts

@@ -328,6 +328,11 @@ declare module 'stripe' {
          */
         link_payments?: Capabilities.LinkPayments;
 
+        /**
+         * The status of the MobilepPay capability of the account, or whether the account can directly process MobilePay charges.
+         */
+        mobilepay_payments?: Capabilities.MobilepayPayments;
+
         /**
          * The status of the OXXO payments capability of the account, or whether the account can directly process OXXO charges.
          */
@@ -463,6 +468,8 @@ declare module 'stripe' {
 
         type LinkPayments = 'active' | 'inactive' | 'pending';
 
+        type MobilepayPayments = 'active' | 'inactive' | 'pending';
+
         type OxxoPayments = 'active' | 'inactive' | 'pending';
 
         type P24Payments = 'active' | 'inactive' | 'pending';