stripe 18.1.0 → 18.1.1

package/CHANGELOG.md

@@ -1,4 +1,18 @@
 # Changelog
+## 18.1.1 - 2025-05-19
+* [#2308](https://github.com/stripe/stripe-node/pull/2308) RawRequest can use custom host
+  * RawRequest now allows you set `host` and `streaming` in request options.
+  ```typescript
+  const file = await stripe.rawRequest(
+    'GET',
+    '/v1/files/file_123/contents',
+    {},
+    {host: 'files.stripe.com', streaming: true}
+  );
+  ```
+* [#2320](https://github.com/stripe/stripe-node/pull/2320) fix: examples/webhook-signing/nestjs/package.json to reduce vulnerabi…
+* [#2326](https://github.com/stripe/stripe-node/pull/2326) Adds CONTRIBUTING.md
+
 ## 18.1.0 - 2025-04-30
 
   This release changes the pinned API version to `2025-04-30.basil`.

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_...', {

package/VERSION

@@ -1 +1 @@
-18.1.0
+18.1.1

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'],
                 };

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/stripe.core.js

@@ -36,7 +36,7 @@ const ALLOWED_CONFIG_PROPERTIES = [
 ];
 const defaultRequestSenderFactory = (stripe) => new RequestSender_js_1.RequestSender(stripe, StripeResource_js_1.StripeResource.MAX_BUFFERED_REQUEST_METRICS);
 function createStripe(platformFunctions, requestSender = defaultRequestSenderFactory) {
-    Stripe.PACKAGE_VERSION = '18.1.0';
+    Stripe.PACKAGE_VERSION = '18.1.1';
     Stripe.USER_AGENT = Object.assign({ bindings_version: Stripe.PACKAGE_VERSION, lang: 'node', publisher: 'stripe', uname: null, typescript: false }, (0, utils_js_1.determineProcessUserAgentProperties)());
     Stripe.StripeResource = StripeResource_js_1.StripeResource;
     Stripe.resources = resources;

package/cjs/utils.js

@@ -13,6 +13,7 @@ const OPTIONS_KEYS = [
     'authenticator',
     'stripeContext',
     'additionalHeaders',
+    'streaming',
 ];
 function isOptionsHash(o) {
     return (o &&
@@ -107,6 +108,7 @@ function getOptionsFromArgs(args) {
         host: null,
         headers: {},
         settings: {},
+        streaming: false,
     };
     if (args.length > 0) {
         const arg = args[args.length - 1];
@@ -159,6 +161,9 @@ function getOptionsFromArgs(args) {
             if (params.additionalHeaders) {
                 opts.headers = params.additionalHeaders;
             }
+            if (params.streaming) {
+                opts.streaming = true;
+            }
         }
     }
     return opts;

package/esm/RequestSender.js

@@ -307,8 +307,8 @@ export class RequestSender {
                     queryData: {},
                     authenticator,
                     headers,
-                    host: null,
-                    streaming: false,
+                    host: calculatedOptions.host,
+                    streaming: !!calculatedOptions.streaming,
                     settings: {},
                     usage: ['raw_request'],
                 };

package/esm/StripeResource.js

@@ -104,7 +104,7 @@ StripeResource.prototype = {
         const data = encode(Object.assign({}, dataFromArgs, overrideData));
         const options = 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/esm/stripe.core.js

@@ -33,7 +33,7 @@ const ALLOWED_CONFIG_PROPERTIES = [
 ];
 const defaultRequestSenderFactory = (stripe) => new RequestSender(stripe, StripeResource.MAX_BUFFERED_REQUEST_METRICS);
 export function createStripe(platformFunctions, requestSender = defaultRequestSenderFactory) {
-    Stripe.PACKAGE_VERSION = '18.1.0';
+    Stripe.PACKAGE_VERSION = '18.1.1';
     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;

package/esm/utils.js

@@ -10,6 +10,7 @@ const OPTIONS_KEYS = [
     'authenticator',
     'stripeContext',
     'additionalHeaders',
+    'streaming',
 ];
 export function isOptionsHash(o) {
     return (o &&
@@ -100,6 +101,7 @@ export function getOptionsFromArgs(args) {
         host: null,
         headers: {},
         settings: {},
+        streaming: false,
     };
     if (args.length > 0) {
         const arg = args[args.length - 1];
@@ -152,6 +154,9 @@ export function getOptionsFromArgs(args) {
             if (params.additionalHeaders) {
                 opts.headers = params.additionalHeaders;
             }
+            if (params.streaming) {
+                opts.streaming = true;
+            }
         }
     }
     return opts;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stripe",
-  "version": "18.1.0",
+  "version": "18.1.1",
   "description": "Stripe API wrapper",
   "keywords": [
     "stripe",