stripe 22.6.0-alpha.2 → 22.6.0

package/cjs/Types.d.ts

@@ -5,7 +5,6 @@ import { HttpClientResponseError } from './RequestSender.js';
 import { StripeContext } from './StripeContext.js';
 import { Stripe } from './stripe.core.js';
 import { AppInfo } from './lib.js';
-import { GiftCardOperation } from './resources/GiftCardOperations.js';
 import { PaymentIntent } from './resources/PaymentIntents.js';
 import { PaymentMethod } from './resources/PaymentMethods.js';
 import { SetupIntent } from './resources/SetupIntents.js';
@@ -33,6 +32,10 @@ export type V2RuntimeSchema = {
 } | {
     kind: 'nullable';
     inner: V2RuntimeSchema;
+} | {
+    kind: 'discriminatedUnion';
+    discriminator: string;
+    variants: Record<string, V2RuntimeSchema>;
 };
 export type MethodSpec = {
     method: string;
@@ -53,7 +56,7 @@ export type MethodSpec = {
     responseSchema?: V2RuntimeSchema;
 };
 export type MultipartRequestData = RequestData | StreamingFile | BufferedFile;
-export type RawErrorType = 'card_error' | 'invalid_request_error' | 'api_error' | 'idempotency_error' | 'rate_limit_error' | 'authentication_error' | 'invalid_grant' | 'invalid_client' | 'invalid_request' | 'invalid_scope' | 'unsupported_grant_type' | 'unsupported_response_type' | 'already_canceled' | 'already_exists' | 'blocked_by_stripe' | 'cannot_proceed' | 'controlled_by_alternate_resource' | 'controlled_by_dashboard' | 'feature_not_enabled' | 'financial_account_not_open' | 'fx_quote_expired' | 'fx_quote_needs_refresh' | 'insufficient_funds' | 'invalid_payment_method' | 'invalid_payout_method' | 'non_zero_balance' | 'not_cancelable' | 'quota_exceeded' | 'rate_limit' | 'recipient_not_notifiable' | 'temporary_session_expired';
+export type RawErrorType = 'card_error' | 'invalid_request_error' | 'api_error' | 'idempotency_error' | 'rate_limit_error' | 'authentication_error' | 'invalid_grant' | 'invalid_client' | 'invalid_request' | 'invalid_scope' | 'unsupported_grant_type' | 'unsupported_response_type' | 'rate_limit' | 'temporary_session_expired';
 export type RequestArgs = Array<any>;
 export type StripeRequest = {
     host: string;
@@ -66,7 +69,7 @@ export type StripeRequest = {
 };
 export type RequestAuthenticator = (request: StripeRequest) => Promise<void>;
 export type RequestCallback = (this: void, error: Error | null, response?: any) => RequestCallbackReturn;
-export type RequestCallbackReturn = void;
+export type RequestCallbackReturn = any;
 export type RequestData = Record<string, any>;
 export type RequestEvent = {
     api_version?: string;
@@ -79,7 +82,6 @@ export type RequestEvent = {
     usage?: Array<string>;
 };
 export type RequestHeaders = Record<string, string | number | string[]>;
-export type APIMode = 'preview' | 'standard';
 /**
  * this is similar but distinct from the user-facing `RequestOptions`
  */
@@ -100,7 +102,6 @@ export type RequestOpts = {
     host: string | null;
     streaming: boolean;
     settings: RequestSettings;
-    apiMode?: APIMode;
     usage: Array<string>;
 };
 export type RequestSettings = {
@@ -150,10 +151,6 @@ export type StripeRawError = {
      * A URL to more information about the [error code](https://docs.stripe.com/error-codes) reported.
      */
     doc_url?: string;
-    /**
-     * The GiftCardOperation object for errors returned on a request involving a GiftCardOperation.
-     */
-    gift_card_operation?: GiftCardOperation;
     /**
      * A human-readable message providing more details about the error. For card errors, these messages can be shown to your users.
      */

package/cjs/Types.js.map

@@ -1 +1 @@
-{"version":3,"file":"Types.js","sourceRoot":"","sources":["../src/Types.ts"],"names":[],"mappings":";;;AAsBa,QAAA,sBAAsB,GAAgC;IACjE,GAAG,EAAE,gBAAgB;IACrB,KAAK,EAAE,kBAAkB;IACzB,OAAO,EAAE,oBAAoB;IAC7B,YAAY,EAAE,yBAAyB;CACxC,CAAC"}
+{"version":3,"file":"Types.js","sourceRoot":"","sources":["../src/Types.ts"],"names":[],"mappings":";;;AAqBa,QAAA,sBAAsB,GAAgC;IACjE,GAAG,EAAE,gBAAgB;IACrB,KAAK,EAAE,kBAAkB;IACzB,OAAO,EAAE,oBAAoB;IAC7B,YAAY,EAAE,yBAAyB;CACxC,CAAC"}

package/cjs/V2Coercion.js

@@ -2,6 +2,41 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.coerceV2ResponseData = exports.coerceV2RequestData = void 0;
 const Decimal_js_1 = require("./Decimal.js");
+const coerceV2RequestDiscriminatedUnion = (data, schema) => {
+    if (typeof data !== 'object' || Array.isArray(data)) {
+        return data;
+    }
+    const obj = data;
+    const discriminatorValue = obj[schema.discriminator];
+    // A discriminator that is absent, or present but not a string, is equally
+    // unusable: either way there is no way to pick a variant schema. Skipping
+    // coercion silently sends int64_string fields as raw JSON numbers and loses
+    // precision above Number.MAX_SAFE_INTEGER, so fail instead.
+    if (typeof discriminatorValue !== 'string') {
+        throw new Error(`Missing or invalid discriminator \`${schema.discriminator}\` for a polymorphic ` +
+            `parameter. Stripe uses this field to determine the shape of the value, so we ` +
+            `cannot encode the request without it. Provide \`${schema.discriminator}\` with ` +
+            `one of: ${Object.keys(schema.variants).join(', ')}.`);
+    }
+    // An unrecognized discriminator passes through untouched: we support sending
+    // undocumented params when the caller uses the right shape.
+    const variant = schema.variants[discriminatorValue];
+    return variant ? (0, exports.coerceV2RequestData)(data, variant) : data;
+};
+const coerceV2RequestObject = (data, schema) => {
+    if (typeof data !== 'object' || Array.isArray(data)) {
+        return data;
+    }
+    const obj = data;
+    const result = {};
+    for (const key of Object.keys(obj)) {
+        const fieldSchema = schema.fields[key];
+        result[key] = fieldSchema
+            ? (0, exports.coerceV2RequestData)(obj[key], fieldSchema)
+            : obj[key];
+    }
+    return result;
+};
 /**
  * Coerces outbound V2 request data by converting bigint (or number)
  * int64_string fields to strings, matching the wire format expected by the API.
@@ -25,18 +60,7 @@ const coerceV2RequestData = (data, schema) => {
                 ? data.toString()
                 : data;
         case 'object': {
-            if (typeof data !== 'object' || Array.isArray(data)) {
-                return data;
-            }
-            const obj = data;
-            const result = {};
-            for (const key of Object.keys(obj)) {
-                const fieldSchema = schema.fields[key];
-                result[key] = fieldSchema
-                    ? (0, exports.coerceV2RequestData)(obj[key], fieldSchema)
-                    : obj[key];
-            }
-            return result;
+            return coerceV2RequestObject(data, schema);
         }
         case 'array': {
             if (!Array.isArray(data)) {
@@ -46,9 +70,39 @@ const coerceV2RequestData = (data, schema) => {
         }
         case 'nullable':
             return (0, exports.coerceV2RequestData)(data, schema.inner);
+        case 'discriminatedUnion': {
+            return coerceV2RequestDiscriminatedUnion(data, schema);
+        }
     }
 };
 exports.coerceV2RequestData = coerceV2RequestData;
+// NOTE: these are separate from the request flavors above
+// because the caller to coerceV2ResponseData expects data
+// to be modified in place
+const coerceV2ResponseDiscriminatedUnion = (data, schema) => {
+    if (typeof data !== 'object' || Array.isArray(data)) {
+        return data;
+    }
+    const obj = data;
+    const discriminatorValue = obj[schema.discriminator];
+    if (typeof discriminatorValue === 'string' &&
+        discriminatorValue in schema.variants) {
+        return (0, exports.coerceV2ResponseData)(data, schema.variants[discriminatorValue]);
+    }
+    return data;
+};
+const coerceV2ResponseObject = (data, schema) => {
+    if (typeof data !== 'object' || Array.isArray(data)) {
+        return data;
+    }
+    const obj = data;
+    for (const key of Object.keys(schema.fields)) {
+        if (key in obj) {
+            obj[key] = (0, exports.coerceV2ResponseData)(obj[key], schema.fields[key]);
+        }
+    }
+    return obj;
+};
 /**
  * Coerces inbound V2 response data by converting string int64_string fields
  * to bigints, matching the SDK's public type contract.
@@ -82,16 +136,7 @@ const coerceV2ResponseData = (data, schema) => {
             }
             return data;
         case 'object': {
-            if (typeof data !== 'object' || Array.isArray(data)) {
-                return data;
-            }
-            const obj = data;
-            for (const key of Object.keys(schema.fields)) {
-                if (key in obj) {
-                    obj[key] = (0, exports.coerceV2ResponseData)(obj[key], schema.fields[key]);
-                }
-            }
-            return obj;
+            return coerceV2ResponseObject(data, schema);
         }
         case 'array': {
             if (!Array.isArray(data)) {
@@ -104,6 +149,9 @@ const coerceV2ResponseData = (data, schema) => {
         }
         case 'nullable':
             return (0, exports.coerceV2ResponseData)(data, schema.inner);
+        case 'discriminatedUnion': {
+            return coerceV2ResponseDiscriminatedUnion(data, schema);
+        }
     }
 };
 exports.coerceV2ResponseData = coerceV2ResponseData;

package/cjs/V2Coercion.js.map

@@ -1 +1 @@
-{"version":3,"file":"V2Coercion.js","sourceRoot":"","sources":["../src/V2Coercion.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"V2Coercion.js","sourceRoot":"","sources":["../src/V2Coercion.ts"],"names":[],"mappings":"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"}

package/cjs/Webhooks.d.ts

@@ -11,7 +11,7 @@ import { Event } from './resources/Events.js';
  * since express should never return this header as an array,
  * only a string.
  */
-type WebhookHeader = string | string[] | Uint8Array;
+export type WebhookHeader = string | string[] | Uint8Array;
 export type WebhookTestHeaderOptions = {
     timestamp?: number;
     payload: string;
@@ -20,7 +20,7 @@ export type WebhookTestHeaderOptions = {
     signature?: string;
     cryptoProvider?: CryptoProvider;
 };
-type WebhookPayload = string | Uint8Array;
+export type WebhookPayload = string | Uint8Array;
 export type WebhookSignatureObject = {
     /**
      * Verifies the authenticity (and recency) of a webhook, throwing a `SignatureVerificationError`
@@ -75,4 +75,3 @@ export type WebhookObject = {
     generateTestHeaderStringAsync: (opts: WebhookTestHeaderOptions) => Promise<string>;
 };
 export declare function createWebhooks(platformFunctions: PlatformFunctions): WebhookObject;
-export {};

package/cjs/apiVersion.d.ts

@@ -1,2 +1,2 @@
-export declare const ApiVersion = "2026-08-12.preview";
-export declare const ApiMajorVersion = "";
+export declare const ApiVersion = "2026-08-26.dahlia";
+export declare const ApiMajorVersion = "dahlia";

package/cjs/apiVersion.js

@@ -2,6 +2,6 @@
 // File generated from our OpenAPI spec
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ApiMajorVersion = exports.ApiVersion = void 0;
-exports.ApiVersion = '2026-08-12.preview';
-exports.ApiMajorVersion = '';
+exports.ApiVersion = '2026-08-26.dahlia';
+exports.ApiMajorVersion = 'dahlia';
 //# sourceMappingURL=apiVersion.js.map

package/cjs/apiVersion.js.map

@@ -1 +1 @@
-{"version":3,"file":"apiVersion.js","sourceRoot":"","sources":["../src/apiVersion.ts"],"names":[],"mappings":";AAAA,uCAAuC;;;AAE1B,QAAA,UAAU,GAAG,oBAAoB,CAAC;AAClC,QAAA,eAAe,GAAG,EAAE,CAAC"}
+{"version":3,"file":"apiVersion.js","sourceRoot":"","sources":["../src/apiVersion.ts"],"names":[],"mappings":";AAAA,uCAAuC;;;AAE1B,QAAA,UAAU,GAAG,mBAAmB,CAAC;AACjC,QAAA,eAAe,GAAG,QAAQ,CAAC"}

package/cjs/net/FetchHttpClient.d.ts

@@ -1,5 +1,16 @@
 import { RequestHeaders, ResponseHeaders } from '../Types.js';
 import { HttpClient, HttpClientResponse, FetchHttpClientInterface, FetchHttpClientResponseInterface } from './HttpClient.js';
+/**
+ * Keeps the request timeout applicable to work that happens after the response
+ * headers arrive, so that `timeout` bounds the whole request rather than just
+ * the time to headers.
+ */
+type RequestTimeout = {
+    /** Applies the remaining timeout to reading the response body. */
+    guard: <T>(promise: Promise<T>) => Promise<T>;
+    /** Disarms the timeout; call once the body is read or handed off. */
+    release: () => void;
+};
 /**
  * HTTP client which uses a `fetch` function to issue requests.
  *
@@ -19,9 +30,11 @@ export declare class FetchHttpClient extends HttpClient implements FetchHttpClie
 }
 export declare class FetchHttpClientResponse extends HttpClientResponse implements FetchHttpClientResponseInterface {
     _res: Response;
-    constructor(res: Response);
+    _requestTimeout: RequestTimeout;
+    constructor(res: Response, requestTimeout?: RequestTimeout);
     getRawResponse(): Response;
     toStream(streamCompleteCallback: () => void): ReadableStream<Uint8Array> | null;
     toJSON(): Promise<any>;
     static _transformHeadersToObject(headers: Headers): ResponseHeaders;
 }
+export {};

package/cjs/net/FetchHttpClient.js

@@ -3,6 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.FetchHttpClientResponse = exports.FetchHttpClient = void 0;
 const utils_js_1 = require("../utils.js");
 const HttpClient_js_1 = require("./HttpClient.js");
+const NOOP_REQUEST_TIMEOUT = {
+    guard: (promise) => promise,
+    release: () => { },
+};
 /**
  * HTTP client which uses a `fetch` function to issue requests.
  *
@@ -37,7 +41,7 @@ class FetchHttpClient extends HttpClient_js_1.HttpClient {
         }
     }
     static makeFetchWithRaceTimeout(fetchFn) {
-        return (url, init, timeout) => {
+        return async (url, init, timeout) => {
             let pendingTimeoutId;
             const timeoutPromise = new Promise((_, reject) => {
                 pendingTimeoutId = setTimeout(() => {
@@ -45,12 +49,29 @@ class FetchHttpClient extends HttpClient_js_1.HttpClient {
                     reject(HttpClient_js_1.HttpClient.makeTimeoutError());
                 }, timeout);
             });
-            const fetchPromise = fetchFn(url, init);
-            return Promise.race([fetchPromise, timeoutPromise]).finally(() => {
+            // The timeout keeps racing against the body read below, so make sure its
+            // rejection is always observed even if nothing is racing it any more.
+            timeoutPromise.catch(() => { });
+            const release = () => {
                 if (pendingTimeoutId) {
                     clearTimeout(pendingTimeoutId);
+                    pendingTimeoutId = null;
                 }
-            });
+            };
+            const requestTimeout = {
+                // Racing cannot cancel the underlying read, but it does stop the
+                // request from hanging past the timeout.
+                guard: (promise) => Promise.race([promise, timeoutPromise]),
+                release,
+            };
+            try {
+                const res = await Promise.race([fetchFn(url, init), timeoutPromise]);
+                return { res, requestTimeout };
+            }
+            catch (err) {
+                release();
+                throw err;
+            }
         };
     }
     static makeFetchWithAbortTimeout(fetchFn) {
@@ -61,27 +82,39 @@ class FetchHttpClient extends HttpClient_js_1.HttpClient {
                 timeoutId = null;
                 abort.abort(HttpClient_js_1.HttpClient.makeTimeoutError());
             }, timeout);
+            const release = () => {
+                if (timeoutId) {
+                    clearTimeout(timeoutId);
+                    timeoutId = null;
+                }
+            };
+            // Some implementations, like node-fetch, do not respect the reason passed to AbortController.abort()
+            // and instead it always throws an AbortError
+            // We catch this case to normalise all timeout errors
+            const normalizeAbortError = (err) => {
+                if (err?.name === 'AbortError') {
+                    throw HttpClient_js_1.HttpClient.makeTimeoutError();
+                }
+                throw err;
+            };
+            const requestTimeout = {
+                // The signal stays armed after the headers arrive, so aborting it also
+                // interrupts the body read.
+                guard: (promise) => promise.catch(normalizeAbortError),
+                release,
+            };
             try {
-                return await fetchFn(url, {
+                const res = await fetchFn(url, {
                     ...init,
                     signal: abort.signal,
                 });
+                return { res, requestTimeout };
             }
             catch (err) {
-                // Some implementations, like node-fetch, do not respect the reason passed to AbortController.abort()
-                // and instead it always throws an AbortError
-                // We catch this case to normalise all timeout errors
-                if (err.name === 'AbortError') {
-                    throw HttpClient_js_1.HttpClient.makeTimeoutError();
-                }
-                else {
-                    throw err;
-                }
-            }
-            finally {
-                if (timeoutId) {
-                    clearTimeout(timeoutId);
-                }
+                // Only release on failure; a successful response still needs the
+                // timeout armed while its body is read.
+                release();
+                return normalizeAbortError(err);
             }
         };
     }
@@ -102,24 +135,29 @@ class FetchHttpClient extends HttpClient_js_1.HttpClient {
         // for more details.
         const methodHasPayload = method == 'POST' || method == 'PUT' || method == 'PATCH';
         const body = requestData || (methodHasPayload ? '' : undefined);
-        const res = await this._fetchFn(url.toString(), {
+        const { res, requestTimeout } = await this._fetchFn(url.toString(), {
             method,
             headers: (0, utils_js_1.parseHeadersForFetch)(headers),
             body: body,
         }, timeout);
-        return new FetchHttpClientResponse(res);
+        return new FetchHttpClientResponse(res, requestTimeout);
     }
 }
 exports.FetchHttpClient = FetchHttpClient;
 class FetchHttpClientResponse extends HttpClient_js_1.HttpClientResponse {
-    constructor(res) {
+    constructor(res, requestTimeout) {
         super(res.status, FetchHttpClientResponse._transformHeadersToObject(res.headers));
         this._res = res;
+        this._requestTimeout = requestTimeout ?? NOOP_REQUEST_TIMEOUT;
     }
     getRawResponse() {
         return this._res;
     }
     toStream(streamCompleteCallback) {
+        // The caller consumes this stream on its own schedule, and a legitimate
+        // download may well outlast `timeout`, so hand ownership of the body over
+        // rather than aborting it.
+        this._requestTimeout.release();
         // Unfortunately `fetch` does not have event handlers for when the stream is
         // completely read. We therefore invoke the streamCompleteCallback right
         // away. This callback emits a response event with metadata and completes
@@ -129,8 +167,22 @@ class FetchHttpClientResponse extends HttpClient_js_1.HttpClientResponse {
         // Fetch's `body` property is expected to be a readable stream of the body.
         return this._res.body;
     }
-    toJSON() {
-        return this._res.text().then((text) => this._parseResponseBody(text));
+    async toJSON() {
+        let text;
+        try {
+            // `timeout` is meant to cover the entire request, so it has to stay armed
+            // while the body is read. Otherwise a connection that stalls or drops
+            // after the headers arrive hangs forever.
+            // See https://github.com/stripe/stripe-node/issues/2814.
+            text = await this._requestTimeout.guard(this._res.text());
+        }
+        catch (e) {
+            throw HttpClient_js_1.HttpClient.makeResponseBodyError(e);
+        }
+        finally {
+            this._requestTimeout.release();
+        }
+        return this._parseResponseBody(text);
     }
     static _transformHeadersToObject(headers) {
         // Fetch uses a Headers instance so this must be converted to a barebones

package/cjs/net/FetchHttpClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"FetchHttpClient.js","sourceRoot":"","sources":["../../src/net/FetchHttpClient.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"FetchHttpClient.js","sourceRoot":"","sources":["../../src/net/FetchHttpClient.ts"],"names":[],"mappings":"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"}

package/cjs/net/HttpClient.d.ts

@@ -49,6 +49,11 @@ export declare class HttpClient implements HttpClientInterface {
     makeRequest(host: string, port: string, path: string, method: string, headers: RequestHeaders, requestData: string, protocol: string, timeout: number): Promise<HttpClientResponseInterface>;
     /** Helper to make a consistent timeout error across implementations. */
     static makeTimeoutError(): TimeoutError;
+    /**
+     * Helper to wrap a failure that occurred while reading a response body, so
+     * that implementations can report one consistently.
+     */
+    static makeResponseBodyError(exception: unknown): HttpClientResponseBodyError;
 }
 export declare class HttpClientResponse implements HttpClientResponseInterface {
     _statusCode: number;
@@ -63,4 +68,17 @@ export declare class HttpClientResponse implements HttpClientResponseInterface {
 }
 export declare class HttpClientRuntimeError extends Error {
 }
+/**
+ * Raised when the response body could not be read to completion, e.g. because
+ * the connection stalled or was severed after the headers arrived. This is
+ * distinct from a body that was received in full but is not valid JSON, so that
+ * a transport failure can be surfaced as a connection error rather than as a
+ * parsing error.
+ */
+export declare class HttpClientResponseBodyError extends Error {
+    /** The error code of the underlying failure, when the runtime supplies one. */
+    code?: string;
+    /** The underlying failure, when the runtime supplies one. */
+    exception?: unknown;
+}
 export {};

package/cjs/net/HttpClient.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HttpClientRuntimeError = exports.HttpClientResponse = exports.HttpClient = void 0;
+exports.HttpClientResponseBodyError = exports.HttpClientRuntimeError = exports.HttpClientResponse = exports.HttpClient = void 0;
 /**
  * Encapsulates the logic for issuing a request to the Stripe API.
  *
@@ -24,6 +24,18 @@ class HttpClient {
         timeoutErr.code = HttpClient.TIMEOUT_ERROR_CODE;
         return timeoutErr;
     }
+    /**
+     * Helper to wrap a failure that occurred while reading a response body, so
+     * that implementations can report one consistently.
+     */
+    static makeResponseBodyError(exception) {
+        const error = new HttpClientResponseBodyError('Failed to read the response body');
+        error.exception = exception;
+        if (exception && typeof exception.code === 'string') {
+            error.code = exception.code;
+        }
+        return error;
+    }
 }
 exports.HttpClient = HttpClient;
 // Public API accessible via Stripe.HttpClient
@@ -65,4 +77,14 @@ exports.HttpClientResponse = HttpClientResponse;
 class HttpClientRuntimeError extends Error {
 }
 exports.HttpClientRuntimeError = HttpClientRuntimeError;
+/**
+ * Raised when the response body could not be read to completion, e.g. because
+ * the connection stalled or was severed after the headers arrived. This is
+ * distinct from a body that was received in full but is not valid JSON, so that
+ * a transport failure can be surfaced as a connection error rather than as a
+ * parsing error.
+ */
+class HttpClientResponseBodyError extends Error {
+}
+exports.HttpClientResponseBodyError = HttpClientResponseBodyError;
 //# sourceMappingURL=HttpClient.js.map

package/cjs/net/HttpClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"HttpClient.js","sourceRoot":"","sources":["../../src/net/HttpClient.ts"],"names":[],"mappings":";;;AAwEA;;;;;;;;GAQG;AACH,MAAa,UAAU;IAIrB,4CAA4C;IAC5C,aAAa;QACX,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,WAAW,CACT,IAAY,EACZ,IAAY,EACZ,IAAY,EACZ,MAAc,EACd,OAAuB,EACvB,WAAmB,EACnB,QAAgB,EAChB,OAAe;QAEf,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;IAED,wEAAwE;IACxE,MAAM,CAAC,gBAAgB;QACrB,MAAM,UAAU,GAAiB,IAAI,SAAS,CAC5C,UAAU,CAAC,kBAAkB,CAC9B,CAAC;QACF,UAAU,CAAC,IAAI,GAAG,UAAU,CAAC,kBAAkB,CAAC;QAChD,OAAO,UAAU,CAAC;IACpB,CAAC;CACF;AA9BD,gCA8BC;AAED,8CAA8C;AAC9C,UAAU,CAAC,6BAA6B,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;AACnE,UAAU,CAAC,kBAAkB,GAAG,WAAW,CAAC;AAE5C,MAAa,kBAAkB;IAI7B,YAAY,UAAkB,EAAE,OAAwB;QACtD,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,cAAc;QACZ,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;IAED,QAAQ,CAAC,sBAAkC;QACzC,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM;QACJ,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IAES,kBAAkB,CAAC,IAAY;QACvC,IAAI;YACF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;SACzB;QAAC,OAAO,CAAC,EAAE;YACV,IAAI,CAAC,YAAY,KAAK,EAAE;gBACrB,CAAS,CAAC,OAAO,GAAG,IAAI,CAAC;aAC3B;YACD,MAAM,CAAC,CAAC;SACT;IACH,CAAC;CACF;AAvCD,gDAuCC;AAED,MAAa,sBAAuB,SAAQ,KAAK;CAAG;AAApD,wDAAoD"}
+{"version":3,"file":"HttpClient.js","sourceRoot":"","sources":["../../src/net/HttpClient.ts"],"names":[],"mappings":";;;AAwEA;;;;;;;;GAQG;AACH,MAAa,UAAU;IAIrB,4CAA4C;IAC5C,aAAa;QACX,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,WAAW,CACT,IAAY,EACZ,IAAY,EACZ,IAAY,EACZ,MAAc,EACd,OAAuB,EACvB,WAAmB,EACnB,QAAgB,EAChB,OAAe;QAEf,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;IAED,wEAAwE;IACxE,MAAM,CAAC,gBAAgB;QACrB,MAAM,UAAU,GAAiB,IAAI,SAAS,CAC5C,UAAU,CAAC,kBAAkB,CAC9B,CAAC;QACF,UAAU,CAAC,IAAI,GAAG,UAAU,CAAC,kBAAkB,CAAC;QAChD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,qBAAqB,CAC1B,SAAkB;QAElB,MAAM,KAAK,GAAG,IAAI,2BAA2B,CAC3C,kCAAkC,CACnC,CAAC;QACF,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;QAC5B,IAAI,SAAS,IAAI,OAAQ,SAA8B,CAAC,IAAI,KAAK,QAAQ,EAAE;YACzE,KAAK,CAAC,IAAI,GAAI,SAA4B,CAAC,IAAI,CAAC;SACjD;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AA/CD,gCA+CC;AAED,8CAA8C;AAC9C,UAAU,CAAC,6BAA6B,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;AACnE,UAAU,CAAC,kBAAkB,GAAG,WAAW,CAAC;AAE5C,MAAa,kBAAkB;IAI7B,YAAY,UAAkB,EAAE,OAAwB;QACtD,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,cAAc;QACZ,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;IAED,QAAQ,CAAC,sBAAkC;QACzC,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM;QACJ,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IAES,kBAAkB,CAAC,IAAY;QACvC,IAAI;YACF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;SACzB;QAAC,OAAO,CAAC,EAAE;YACV,IAAI,CAAC,YAAY,KAAK,EAAE;gBACrB,CAAS,CAAC,OAAO,GAAG,IAAI,CAAC;aAC3B;YACD,MAAM,CAAC,CAAC;SACT;IACH,CAAC;CACF;AAvCD,gDAuCC;AAED,MAAa,sBAAuB,SAAQ,KAAK;CAAG;AAApD,wDAAoD;AAEpD;;;;;;GAMG;AACH,MAAa,2BAA4B,SAAQ,KAAK;CAKrD;AALD,kEAKC"}

package/cjs/net/NodeHttpClient.js

@@ -43,11 +43,34 @@ class NodeHttpClient extends HttpClient_js_1.HttpClient {
                 headers,
                 ciphers: 'DEFAULT:!aNULL:!eNULL:!LOW:!EXPORT:!SSLv2:!MD5',
             });
+            let res = null;
             req.setTimeout(timeout, () => {
-                req.destroy(HttpClient_js_1.HttpClient.makeTimeoutError());
+                const timeoutError = HttpClient_js_1.HttpClient.makeTimeoutError();
+                // The socket timeout stays armed while the body is being read, but
+                // tearing down the request alone surfaces on the response as a
+                // generic ECONNRESET. Destroying the response with the timeout error
+                // first lets a stalled body be reported as the timeout it is.
+                //
+                // The cost is that this is the same error a toStream() caller sees, so
+                // a stalled download now emits an ETIMEDOUT TypeError where it used to
+                // emit an ECONNRESET Error with the message "aborted". The timing is
+                // unchanged and 'aborted' still fires either way.
+                // TODO(DEVSDK-3247): decouple the two by dropping this destroy() and
+                // instead recording that the timeout fired (e.g. a getter handed to
+                // NodeHttpClientResponse), so only toJSON() translates the teardown
+                // into a timeout and the stream keeps its original error. Dropping
+                // this destroy() on its own is not enough: the request teardown does
+                // still reach toJSON's listeners at the same time, but as a generic
+                // failure, which the response body error then reports as a
+                // StripeAPIError instead of a timeout.
+                if (res && !res.complete) {
+                    res.destroy(timeoutError);
+                }
+                req.destroy(timeoutError);
             });
-            req.on('response', (res) => {
-                resolve(new NodeHttpClientResponse(res));
+            req.on('response', (response) => {
+                res = response;
+                resolve(new NodeHttpClientResponse(response));
             });
             req.on('error', (error) => {
                 reject(error);
@@ -94,6 +117,20 @@ class NodeHttpClientResponse extends HttpClient_js_1.HttpClientResponse {
             this._res.on('data', (chunk) => {
                 response += chunk;
             });
+            // Node only emits 'error' on an IncomingMessage when a listener is
+            // attached; without one, a connection that stalls or drops after the
+            // headers arrive never emits 'end' either, and this promise would hang
+            // forever. See https://github.com/stripe/stripe-node/issues/2814.
+            this._res.once('error', (error) => {
+                reject(HttpClient_js_1.HttpClient.makeResponseBodyError(error));
+            });
+            // Not every truncated response emits an 'error', so treat closing before
+            // the body is complete as a failure too.
+            this._res.once('close', () => {
+                if (!this._res.complete) {
+                    reject(HttpClient_js_1.HttpClient.makeResponseBodyError(null));
+                }
+            });
             this._res.once('end', () => {
                 try {
                     resolve(this._parseResponseBody(response));