stripe 21.1.0-beta.2 → 22.0.1

package/cjs/StripeResource.js

@@ -2,167 +2,69 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StripeResource = void 0;
 const utils_js_1 = require("./utils.js");
-const StripeMethod_js_1 = require("./StripeMethod.js");
 const V2Coercion_js_1 = require("./V2Coercion.js");
-// Provide extension mechanism for Stripe Resource Sub-Classes
-StripeResource.extend = utils_js_1.protoExtend;
-// Expose method-creator
-StripeResource.method = StripeMethod_js_1.stripeMethod;
-StripeResource.MAX_BUFFERED_REQUEST_METRICS = 100;
+const autoPagination_js_1 = require("./autoPagination.js");
 /**
  * Encapsulates request logic for a Stripe Resource
  */
-function StripeResource(stripe, deprecatedUrlData) {
-    this._stripe = stripe;
-    if (deprecatedUrlData) {
-        throw new Error('Support for curried url params was dropped in stripe-node v7.0.0. Instead, pass two ids.');
+class StripeResource {
+    constructor(stripe, deprecatedUrlData) {
+        this.resourcePath = '';
+        // Function to override the default data processor. This allows full control
+        // over how a StripeResource's request data will get converted into an HTTP
+        // body. This is useful for non-standard HTTP requests. The function should
+        // take method name, data, and headers as arguments.
+        this.requestDataProcessor = null;
+        this._stripe = stripe;
+        if (deprecatedUrlData) {
+            throw new Error('Support for curried url params was dropped in stripe-node v7.0.0. Instead, pass two ids.');
+        }
+        this.basePath = (0, utils_js_1.makeURLInterpolator)(
+        // @ts-expect-error changing type of basePath
+        this.basePath || stripe.getApiField('basePath'));
+        // @ts-ignore changing type of path - path comes from prototype as string, convert to interpolator
+        const rawPath = this.path || '';
+        this.resourcePath = rawPath;
+        this.path = (0, utils_js_1.makeURLInterpolator)(rawPath);
+        this.initialize(stripe, deprecatedUrlData);
     }
-    this.basePath = (0, utils_js_1.makeURLInterpolator)(
-    // @ts-ignore changing type of basePath
-    this.basePath || stripe.getApiField('basePath'));
-    // @ts-ignore changing type of path
-    this.resourcePath = this.path;
-    // @ts-ignore changing type of path
-    this.path = (0, utils_js_1.makeURLInterpolator)(this.path);
-    this.initialize(...arguments);
-}
-exports.StripeResource = StripeResource;
-StripeResource.prototype = {
-    _stripe: null,
-    // @ts-ignore the type of path changes in ctor
-    path: '',
-    resourcePath: '',
-    // Methods that don't use the API's default '/v1' path can override it with this setting.
-    basePath: null,
-    initialize() { },
-    // Function to override the default data processor. This allows full control
-    // over how a StripeResource's request data will get converted into an HTTP
-    // body. This is useful for non-standard HTTP requests. The function should
-    // take method name, data, and headers as arguments.
-    requestDataProcessor: null,
-    // Function to add a validation checks before sending the request, errors should
-    // be thrown, and they will be passed to the callback/promise.
-    validateRequest: null,
-    createFullPath(commandPath, urlData) {
-        const urlParts = [this.basePath(urlData), this.path(urlData)];
-        if (typeof commandPath === 'function') {
-            const computedCommandPath = commandPath(urlData);
-            // If we have no actual command path, we just omit it to avoid adding a
-            // trailing slash. This is important for top-level listing requests, which
-            // do not have a command path.
-            if (computedCommandPath) {
-                urlParts.push(computedCommandPath);
+    initialize(_stripe, _deprecatedUrlData) { }
+    _makeRequest(method, path, params, options, spec) {
+        const requestMethod = method.toUpperCase();
+        const encode = spec?.encode || ((data) => data);
+        const data = encode(params ? { ...params } : {});
+        const processed = (0, utils_js_1.processOptions)(options);
+        const apiBase = processed.apiBase || spec?.apiBase || null;
+        const host = apiBase ? this._stripe.resolveBaseAddress(apiBase) : null;
+        const streaming = processed.streaming || !!spec?.streaming;
+        const headers = Object.assign(processed.headers, spec?.headers);
+        const usage = spec?.usage || [];
+        const dataInQuery = requestMethod === 'GET' || requestMethod === 'DELETE';
+        let bodyData = dataInQuery ? null : data;
+        const queryData = dataInQuery ? data : {};
+        try {
+            if (spec?.validator) {
+                spec.validator(data, { headers });
             }
-        }
-        else {
-            urlParts.push(commandPath);
-        }
-        return this._joinUrlParts(urlParts);
-    },
-    // Creates a relative resource path with symbols left in (unlike
-    // createFullPath which takes some data to replace them with). For example it
-    // might produce: /invoices/{id}
-    createResourcePathWithSymbols(pathWithSymbols) {
-        // If there is no path beyond the resource path, we want to produce just
-        // /<resource path> rather than /<resource path>/.
-        if (pathWithSymbols) {
-            return `/${this._joinUrlParts([this.resourcePath, pathWithSymbols])}`;
-        }
-        else {
-            return `/${this.resourcePath}`;
-        }
-    },
-    _joinUrlParts(parts) {
-        // Replace any accidentally doubled up slashes. This previously used
-        // path.join, which would do this as well. Unfortunately we need to do this
-        // as the functions for creating paths are technically part of the public
-        // interface and so we need to preserve backwards compatibility.
-        return parts.join('/').replace(/\/{2,}/g, '/');
-    },
-    _getRequestOpts(requestArgs, spec, overrideData) {
-        // Extract spec values with defaults.
-        const requestMethod = (spec.method || 'GET').toUpperCase();
-        const usage = spec.usage || [];
-        const urlParams = spec.urlParams || [];
-        const encode = spec.encode || ((data) => data);
-        const isUsingFullPath = !!spec.fullPath;
-        const commandPath = (0, utils_js_1.makeURLInterpolator)(isUsingFullPath ? spec.fullPath : spec.path || '');
-        // When using fullPath, we ignore the resource path as it should already be
-        // fully qualified.
-        const path = isUsingFullPath
-            ? spec.fullPath
-            : this.createResourcePathWithSymbols(spec.path);
-        // Don't mutate args externally.
-        const args = [].slice.call(requestArgs);
-        // Generate and validate url params.
-        const urlData = urlParams.reduce((urlData, param) => {
-            const arg = args.shift();
-            if (typeof arg !== 'string') {
-                throw new Error(`Stripe: Argument "${param}" must be a string, but got: ${arg} (on API request to \`${requestMethod} ${path}\`)`);
+            // Coerce int64_string/decimal_string fields in request body
+            if (spec?.requestSchema && bodyData) {
+                bodyData = (0, V2Coercion_js_1.coerceV2RequestData)(bodyData, spec.requestSchema);
             }
-            urlData[param] = arg;
-            return urlData;
-        }, {});
-        // Pull request data and options (headers, auth) from args.
-        const dataFromArgs = (0, utils_js_1.getDataFromArgs)(args);
-        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 || !!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}\`)`);
         }
-        // When using full path, we can just invoke the URL interpolator directly
-        // as we don't need to use the resource to create a full path.
-        const requestPath = isUsingFullPath
-            ? commandPath(urlData)
-            : this.createFullPath(commandPath, urlData);
-        const headers = Object.assign(options.headers, spec.headers);
-        if (spec.validator) {
-            spec.validator(data, { headers });
+        catch (err) {
+            return Promise.reject(err);
         }
-        const dataInQuery = spec.method === 'GET' || spec.method === 'DELETE';
-        const bodyData = dataInQuery ? null : data;
-        const queryData = dataInQuery ? data : {};
-        return {
-            requestMethod,
-            requestPath,
-            bodyData,
-            queryData,
-            authenticator: options.authenticator ?? null,
-            headers,
-            host: host ?? null,
-            streaming,
-            settings: options.settings,
-            usage,
-        };
-    },
-    _makeRequest(requestArgs, spec, overrideData) {
-        return new Promise((resolve, reject) => {
-            let opts;
-            try {
-                opts = this._getRequestOpts(requestArgs, spec, overrideData);
-            }
-            catch (err) {
-                reject(err);
-                return;
-            }
-            // Coerce int64_string/decimal_string fields in request body: number/Decimal → string
-            if (spec.requestSchema && opts.bodyData) {
-                opts.bodyData = (0, V2Coercion_js_1.coerceV2RequestData)(opts.bodyData, spec.requestSchema);
-            }
+        const innerPromise = new Promise((resolve, reject) => {
             function requestCallback(err, response) {
                 if (err) {
                     reject(err);
                 }
                 else {
-                    // Coerce int64_string/decimal_string fields in response: string → bigint/Decimal
                     try {
-                        if (spec.responseSchema) {
+                        if (spec?.responseSchema) {
                             (0, V2Coercion_js_1.coerceV2ResponseData)(response, spec.responseSchema);
                         }
-                        resolve(spec.transformResponseData
+                        resolve(spec?.transformResponseData
                             ? spec.transformResponseData(response)
                             : response);
                     }
@@ -171,18 +73,25 @@ StripeResource.prototype = {
                     }
                 }
             }
-            const emptyQuery = Object.keys(opts.queryData).length === 0;
-            const path = [
-                opts.requestPath,
+            const emptyQuery = Object.keys(queryData).length === 0;
+            const fullPath = [
+                path,
                 emptyQuery ? '' : '?',
-                (0, utils_js_1.queryStringifyRequestData)(opts.queryData),
+                (0, utils_js_1.queryStringifyRequestData)(queryData),
             ].join('');
-            const { headers, settings } = opts;
-            this._stripe._requestSender._request(opts.requestMethod, opts.host, path, opts.bodyData, opts.authenticator, {
+            this._stripe._requestSender._request(requestMethod, host, fullPath, bodyData, processed.authenticator, {
                 headers,
-                settings,
-                streaming: opts.streaming,
-            }, opts.usage, requestCallback, this.requestDataProcessor?.bind(this));
+                settings: processed.settings,
+                streaming,
+            }, usage, requestCallback, this.requestDataProcessor?.bind(this));
         });
-    },
-};
+        // Attach auto-pagination methods for list/search endpoints
+        if (spec?.methodType) {
+            Object.assign(innerPromise, (0, autoPagination_js_1.makeAutoPaginationMethods)(this, params ? { ...params } : {}, options, requestMethod, path, spec, innerPromise));
+        }
+        return innerPromise;
+    }
+}
+exports.StripeResource = StripeResource;
+StripeResource.MAX_BUFFERED_REQUEST_METRICS = 100;
+//# sourceMappingURL=StripeResource.js.map

package/cjs/StripeResource.js.map

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

package/cjs/Types.d.ts

@@ -0,0 +1,188 @@
+/// <reference types="node" />
+import { EventEmitter } from 'events';
+import { HttpClientInterface, HttpClientResponseInterface } from './net/HttpClient.js';
+import { HttpClientResponseError } from './RequestSender.js';
+import { StripeContext } from './StripeContext.js';
+import { Stripe } from './stripe.core.js';
+import { AppInfo } from './lib.js';
+export type ApiMode = 'v1' | 'v2';
+export type BaseAddress = 'api' | 'files' | 'connect' | 'meter_events';
+export declare const DEFAULT_BASE_ADDRESSES: Record<BaseAddress, string>;
+export type BufferedFile = {
+    name: string;
+    type: string;
+    file: {
+        data: Uint8Array;
+    };
+};
+export type V2RuntimeSchema = {
+    kind: 'int64_string';
+} | {
+    kind: 'decimal_string';
+} | {
+    kind: 'object';
+    fields: Record<string, V2RuntimeSchema>;
+} | {
+    kind: 'array';
+    element: V2RuntimeSchema;
+} | {
+    kind: 'nullable';
+    inner: V2RuntimeSchema;
+};
+export type MethodSpec = {
+    method: string;
+    methodType?: string;
+    urlParams?: Array<string>;
+    path?: string;
+    fullPath?: string;
+    encode?: (data: RequestData) => RequestData;
+    validator?: (data: RequestData, options: {
+        headers: RequestHeaders;
+    }) => void;
+    headers?: Record<string, string>;
+    streaming?: boolean;
+    apiBase?: BaseAddress;
+    transformResponseData?: (response: HttpClientResponseInterface) => any;
+    usage?: Array<string>;
+    requestSchema?: V2RuntimeSchema;
+    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' | 'rate_limit' | 'temporary_session_expired';
+export type RequestArgs = Array<any>;
+export type StripeRequest = {
+    host: string;
+    port: string;
+    path: string;
+    method: string;
+    headers: RequestHeaders;
+    body: string;
+    protocol: string;
+};
+export type RequestAuthenticator = (request: StripeRequest) => Promise<void>;
+export type RequestCallback = (this: void, error: Error | null, response?: any) => RequestCallbackReturn;
+export type RequestCallbackReturn = any;
+export type RequestData = Record<string, any>;
+export type RequestEvent = {
+    api_version?: string;
+    account?: string;
+    idempotency_key?: string;
+    method?: string;
+    path?: string;
+    request_start_time: number;
+    usage?: Array<string>;
+};
+export type RequestHeaders = Record<string, string | number | string[]>;
+/**
+ * this is similar but distinct from the user-facing `RequestOptions`
+ */
+export type InternalRequestOptions = {
+    settings?: RequestSettings;
+    streaming?: boolean;
+    headers?: RequestHeaders;
+    stripeContext?: string | StripeContext;
+    stripeAccount?: string;
+};
+export type RequestOpts = {
+    authenticator: RequestAuthenticator | null;
+    requestMethod: string;
+    requestPath: string;
+    bodyData: RequestData | null;
+    queryData: RequestData;
+    headers: RequestHeaders;
+    host: string | null;
+    streaming: boolean;
+    settings: RequestSettings;
+    usage: Array<string>;
+};
+export type RequestSettings = {
+    timeout?: number;
+    maxNetworkRetries?: number;
+};
+export type ResponseEvent = {
+    api_version?: string;
+    account?: string;
+    idempotency_key?: string;
+    method?: string;
+    path?: string;
+    status?: number;
+    request_id?: string;
+    elapsed: number;
+    request_start_time?: number;
+    request_end_time?: number;
+};
+export type ResponseHeaderValue = string | string[];
+export type ResponseHeaders = Record<string, ResponseHeaderValue>;
+export type StreamingFile = {
+    name: string;
+    type: string;
+    file: {
+        data: EventEmitter;
+    };
+};
+export type StripeRawError = {
+    message?: string;
+    user_message?: string;
+    type?: RawErrorType;
+    headers?: {
+        [header: string]: string;
+    };
+    statusCode?: number;
+    requestId?: string;
+    code?: string;
+    doc_url?: string;
+    decline_code?: string;
+    param?: string;
+    detail?: string | Error | HttpClientResponseError;
+    charge?: string;
+    payment_method_type?: string;
+    payment_intent?: any;
+    payment_method?: any;
+    setup_intent?: any;
+    source?: any;
+    exception?: any;
+};
+/**
+ * Stripe-generated ways to affect how a request works.
+ */
+export type MakeRequestSpec = {
+    methodType?: 'search' | 'list';
+    streaming?: boolean;
+    validator?: (data: RequestData, options: {
+        headers: RequestHeaders;
+    }) => void;
+    headers?: Record<string, string>;
+    apiBase?: BaseAddress;
+    encode?: (data: RequestData) => RequestData;
+    usage?: Array<string>;
+    requestSchema?: V2RuntimeSchema;
+    responseSchema?: V2RuntimeSchema;
+    transformResponseData?: (response: HttpClientResponseInterface) => any;
+};
+export type StripeResourceObject = {
+    _stripe: Stripe;
+    basePath: UrlInterpolator;
+    path: UrlInterpolator;
+    resourcePath: string;
+    initialize: (...args: Array<any>) => void;
+    requestDataProcessor: null | RequestDataProcessor;
+    _makeRequest(method: string, path: string, params: RequestData | undefined, options: import('./lib.js').RequestOptions | undefined, spec?: MakeRequestSpec): Promise<any>;
+};
+export type RequestDataProcessor = (method: string, data: RequestData | null, headers: RequestHeaders | undefined, prepareAndMakeRequest: (error: Error | null, data: string) => void) => void;
+export type UrlInterpolator = (params: Record<string, unknown>) => string;
+export type UserProvidedConfig = {
+    authenticator?: RequestAuthenticator;
+    apiVersion?: string;
+    protocol?: string;
+    host?: string;
+    httpAgent?: any;
+    timeout?: number;
+    port?: string | number;
+    maxNetworkRetries?: number;
+    httpClient?: HttpClientInterface;
+    stripeAccount?: string;
+    stripeContext?: string | StripeContext;
+    typescript?: boolean;
+    telemetry?: boolean;
+    appInfo?: AppInfo;
+};

package/cjs/Types.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_BASE_ADDRESSES = void 0;
+exports.DEFAULT_BASE_ADDRESSES = {
+    api: 'api.stripe.com',
+    files: 'files.stripe.com',
+    connect: 'connect.stripe.com',
+    meter_events: 'meter-events.stripe.com',
+};
+//# sourceMappingURL=Types.js.map

package/cjs/Types.js.map

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

package/cjs/V2Coercion.d.ts

@@ -0,0 +1,17 @@
+import { V2RuntimeSchema } from './Types.js';
+/**
+ * Coerces outbound V2 request data by converting bigint (or number)
+ * int64_string fields to strings, matching the wire format expected by the API.
+ *
+ * Walks the schema tree and only touches fields that are marked as
+ * int64_string. All other values are left unchanged.
+ */
+export declare const coerceV2RequestData: (data: unknown, schema: V2RuntimeSchema) => unknown;
+/**
+ * Coerces inbound V2 response data by converting string int64_string fields
+ * to bigints, matching the SDK's public type contract.
+ *
+ * Walks the schema tree and only touches fields that are marked as
+ * int64_string. All other values are left unchanged.
+ */
+export declare const coerceV2ResponseData: (data: unknown, schema: V2RuntimeSchema) => unknown;

package/cjs/V2Coercion.js

@@ -107,3 +107,4 @@ const coerceV2ResponseData = (data, schema) => {
     }
 };
 exports.coerceV2ResponseData = coerceV2ResponseData;
+//# sourceMappingURL=V2Coercion.js.map

package/cjs/V2Coercion.js.map

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

package/cjs/Webhooks.d.ts

@@ -0,0 +1,37 @@
+import { CryptoProvider } from './crypto/CryptoProvider.js';
+import { PlatformFunctions } from './platform/PlatformFunctions.js';
+import { Event } from './resources/Events.js';
+/**
+ * Value of the `stripe-signature` header from Stripe.
+ * Typically a string.
+ *
+ * Note that this is typed to accept an array of strings
+ * so that it works seamlessly with express's types,
+ * but will throw if an array is passed in practice
+ * since express should never return this header as an array,
+ * only a string.
+ */
+type WebhookHeader = string | string[] | Uint8Array;
+type WebhookTestHeaderOptions = {
+    timestamp: number;
+    payload: string;
+    secret: string;
+    scheme: string;
+    signature: string;
+    cryptoProvider: CryptoProvider;
+};
+type WebhookPayload = string | Uint8Array;
+type WebhookSignatureObject = {
+    verifyHeader: (encodedPayload: WebhookPayload, encodedHeader: WebhookHeader, secret: string, tolerance: number, cryptoProvider: CryptoProvider, receivedAt?: number) => boolean;
+    verifyHeaderAsync: (encodedPayload: WebhookPayload, encodedHeader: WebhookHeader, secret: string, tolerance: number, cryptoProvider: CryptoProvider, receivedAt?: number) => Promise<boolean>;
+};
+export type WebhookObject = {
+    DEFAULT_TOLERANCE: number;
+    signature: WebhookSignatureObject | null;
+    constructEvent: (payload: WebhookPayload, header: WebhookHeader, secret: string, tolerance?: number, cryptoProvider?: CryptoProvider, receivedAt?: number) => Event;
+    constructEventAsync: (payload: WebhookPayload, header: WebhookHeader, secret: string, tolerance?: number, cryptoProvider?: CryptoProvider, receivedAt?: number) => Promise<Event>;
+    generateTestHeaderString: (opts: WebhookTestHeaderOptions) => string;
+    generateTestHeaderStringAsync: (opts: WebhookTestHeaderOptions) => Promise<string>;
+};
+export declare function createWebhooks(platformFunctions: PlatformFunctions): WebhookObject;
+export {};

package/cjs/Webhooks.js

@@ -12,6 +12,7 @@ function createWebhooks(platformFunctions) {
                 if (!this.signature) {
                     throw new Error('ERR: missing signature helper, unable to verify');
                 }
+                cryptoProvider = cryptoProvider || getCryptoProvider();
                 this.signature.verifyHeader(payload, header, secret, tolerance || Webhook.DEFAULT_TOLERANCE, cryptoProvider, receivedAt);
             }
             catch (e) {
@@ -33,6 +34,7 @@ function createWebhooks(platformFunctions) {
             if (!this.signature) {
                 throw new Error('ERR: missing signature helper, unable to verify');
             }
+            cryptoProvider = cryptoProvider || getCryptoProvider();
             await this.signature.verifyHeaderAsync(payload, header, secret, tolerance || Webhook.DEFAULT_TOLERANCE, cryptoProvider, receivedAt);
             const jsonPayload = payload instanceof Uint8Array
                 ? JSON.parse(new TextDecoder('utf8').decode(payload))
@@ -88,6 +90,13 @@ function createWebhooks(platformFunctions) {
         return `${details.timestamp}.${payload}`;
     }
     function parseEventDetails(encodedPayload, encodedHeader, expectedScheme) {
+        // Express's type for `Request#headers` is `string | []string`
+        // which is because the `set-cookie` header is an array,
+        // but no other headers are an array (docs: https://nodejs.org/api/http.html#http_message_headers)
+        // (Express's Request class is an extension of http.IncomingMessage, and doesn't appear to be relevantly modified: https://github.com/expressjs/express/blob/master/lib/request.js#L31)
+        if (Array.isArray(encodedHeader)) {
+            throw new Error('Unexpected: An array was passed as a header, which should not be possible for the stripe-signature header.');
+        }
         if (!encodedPayload) {
             throw new Error_js_1.StripeSignatureVerificationError(encodedHeader, encodedPayload, {
                 message: 'No webhook payload was provided.',
@@ -99,13 +108,6 @@ function createWebhooks(platformFunctions) {
         const decodedPayload = encodedPayload instanceof Uint8Array
             ? textDecoder.decode(encodedPayload)
             : encodedPayload;
-        // Express's type for `Request#headers` is `string | []string`
-        // which is because the `set-cookie` header is an array,
-        // but no other headers are an array (docs: https://nodejs.org/api/http.html#http_message_headers)
-        // (Express's Request class is an extension of http.IncomingMessage, and doesn't appear to be relevantly modified: https://github.com/expressjs/express/blob/master/lib/request.js#L31)
-        if (Array.isArray(encodedHeader)) {
-            throw new Error('Unexpected: An array was passed as a header, which should not be possible for the stripe-signature header.');
-        }
         if (encodedHeader == null || encodedHeader == '') {
             throw new Error_js_1.StripeSignatureVerificationError(encodedHeader, encodedPayload, {
                 message: 'No stripe-signature header value was provided.',
@@ -223,3 +225,4 @@ function createWebhooks(platformFunctions) {
     return Webhook;
 }
 exports.createWebhooks = createWebhooks;
+//# sourceMappingURL=Webhooks.js.map

package/cjs/Webhooks.js.map

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

package/cjs/apiVersion.d.ts

@@ -0,0 +1,2 @@
+export declare const ApiVersion = "2026-03-25.dahlia";
+export declare const ApiMajorVersion = "dahlia";

package/cjs/apiVersion.js

@@ -1,5 +1,7 @@
 "use strict";
 // File generated from our OpenAPI spec
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ApiVersion = void 0;
-exports.ApiVersion = '2026-03-25.preview';
+exports.ApiMajorVersion = exports.ApiVersion = void 0;
+exports.ApiVersion = '2026-03-25.dahlia';
+exports.ApiMajorVersion = 'dahlia';
+//# sourceMappingURL=apiVersion.js.map

package/cjs/apiVersion.js.map

@@ -0,0 +1 @@
+{"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/autoPagination.d.ts

@@ -0,0 +1,25 @@
+import { RequestData, StripeResourceObject, MakeRequestSpec } from './Types.js';
+import { RequestOptions } from './lib.js';
+type IterationDoneCallback = (err?: any, result?: any) => void;
+type IterationItemCallback<T> = (item: T, next: any) => void | boolean | Promise<void | boolean>;
+type AutoPagingEach<T> = (onItem: IterationItemCallback<T>, onDone?: IterationDoneCallback) => Promise<void>;
+type AutoPagingToArrayOptions = {
+    limit?: number;
+};
+type AutoPagingToArray<T> = (opts: AutoPagingToArrayOptions, onDone: IterationDoneCallback) => Promise<Array<T>>;
+type AutoPaginationMethods<T> = {
+    autoPagingEach: AutoPagingEach<T>;
+    autoPagingToArray: AutoPagingToArray<T>;
+    next: () => Promise<IteratorResult<T>>;
+    return: () => void;
+};
+type PageResult<T> = {
+    data: Array<T>;
+    has_more: boolean;
+    next_page?: string | null;
+    next_page_url?: string | null;
+};
+export declare const makeAutoPaginationMethods: <TItem extends {
+    id: string;
+}>(stripeResource: StripeResourceObject, params: RequestData, options: RequestOptions | undefined, method: string, path: string, spec: MakeRequestSpec | undefined, firstPagePromise: Promise<PageResult<TItem>>) => AutoPaginationMethods<TItem> | null;
+export {};