stripe-node v12

README.md

@@ -97,8 +97,7 @@ We therefore encourage [upgrading your API version][api-version-upgrading]
 if you would like to take advantage of Stripe's TypeScript definitions.
 
 If you are on an older API version (e.g., `2019-10-17`) and not able to upgrade,
-you may pass another version or `apiVersion: null` to use your account's default API version,
-and use a comment like `// @ts-ignore stripe-version-2019-10-17` to silence type errors here
+you may pass another version and use a comment like `// @ts-ignore stripe-version-2019-10-17` to silence type errors here
 and anywhere the types differ between your API version and the latest.
 When you upgrade, you should remove these comments.
 
@@ -176,7 +175,7 @@ const stripe = Stripe('sk_test_...', {
 
 | Option              | Default            | Description                                                                                                                                                                                                                                       |
 | ------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `apiVersion`        | `null`             | Stripe API version to be used. If not set the account's default version will be used.                                                                                                                                                             |
+| `apiVersion`        | `null`             | Stripe API version to be used. If not set, stripe-node will use the latest version at the time of release.                                                                                                                                        |
 | `maxNetworkRetries` | 0                  | The amount of times a request should be [retried](#network-retries).                                                                                                                                                                              |
 | `httpAgent`         | `null`             | [Proxy](#configuring-a-proxy) agent to be used by the library.                                                                                                                                                                                    |
 | `timeout`           | 80000              | [Maximum time each request can take in ms.](#configuring-timeout)                                                                                                                                                                                 |

src/stripe.core.ts

@@ -1,4 +1,5 @@
 import * as _Error from './Error.js';
+import * as apiVersion from './apiVersion.js';
 import * as resources from './resources.js';
 import {HttpClient, HttpClientResponse} from './net/HttpClient.js';
 import {
@@ -16,7 +17,7 @@ import {StripeObject, AppInfo, UserProvidedConfig} from './Types.js';
 const DEFAULT_HOST = 'api.stripe.com';
 const DEFAULT_PORT = '443';
 const DEFAULT_BASE_PATH = '/v1/';
-const DEFAULT_API_VERSION = (null as unknown) as string;
+const DEFAULT_API_VERSION = apiVersion.ApiVersion;
 
 const DEFAULT_TIMEOUT = 80000;
 
@@ -63,11 +64,6 @@ export function createStripe(
   Stripe.HttpClientResponse = HttpClientResponse;
   Stripe.CryptoProvider = CryptoProvider;
 
-  // For backwards compatibiblity after moving to separate CJS and ESM entrypoints.
-  // To be removed in the next major version.
-  Stripe.Stripe = Stripe;
-  Stripe.default = Stripe;
-
   function Stripe(
     this: StripeObject,
     key: string,

test/stripe.spec.ts

@@ -6,6 +6,7 @@ import {FetchHttpClient} from '../cjs/net/FetchHttpClient.js';
 import {NodeHttpClient} from '../cjs/net/NodeHttpClient.js';
 import {createStripe} from '../cjs/stripe.core.js';
 import {getMockPlatformFunctions} from './testUtils.js';
+import {ApiVersion} from '../cjs/apiVersion.js';
 
 const testUtils = require('./testUtils.js');
 const Stripe = require('../cjs/stripe.cjs.node.js');
@@ -119,7 +120,7 @@ describe('Stripe Module', function() {
 
       cases.forEach((item) => {
         const newStripe = Stripe(testUtils.getUserStripeKey(), item);
-        expect(newStripe.getApiField('version')).to.equal(null);
+        expect(newStripe.getApiField('version')).to.equal(ApiVersion);
       });
     });
 

testProjects/mjs/index.js

@@ -41,9 +41,6 @@ assert(Stripe.StripeResource.MAX_BUFFERED_REQUEST_METRICS);
 assert(Stripe.webhooks);
 assert(Stripe.resources);
 
-assert(Stripe.Stripe);
-assert(Stripe.default);
-
 const stripe = new Stripe(process.argv[2]);
 const defaultStripe = new DefaultStripe(process.argv[2]);