@depup/stripe 21.0.0-depup.0

package/cjs/RequestSender.js

@@ -0,0 +1,469 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestSender = void 0;
+const Error_js_1 = require("./Error.js");
+const HttpClient_js_1 = require("./net/HttpClient.js");
+const utils_js_1 = require("./utils.js");
+const MAX_RETRY_AFTER_WAIT = 60;
+class RequestSender {
+    constructor(stripe, maxBufferedRequestMetric) {
+        this._stripe = stripe;
+        this._maxBufferedRequestMetric = maxBufferedRequestMetric;
+    }
+    _normalizeStripeContext(optsContext, clientContext) {
+        if (optsContext) {
+            return optsContext.toString() || null; // return null for empty strings
+        }
+        return clientContext?.toString() || null; // return null for empty strings
+    }
+    _addHeadersDirectlyToObject(obj, headers) {
+        // For convenience, make some headers easily accessible on
+        // lastResponse.
+        // NOTE: Stripe responds with lowercase header names/keys.
+        obj.requestId = headers['request-id'];
+        obj.stripeAccount = obj.stripeAccount || headers['stripe-account'];
+        obj.apiVersion = obj.apiVersion || headers['stripe-version'];
+        obj.idempotencyKey = obj.idempotencyKey || headers['idempotency-key'];
+    }
+    _makeResponseEvent(requestEvent, statusCode, headers) {
+        const requestEndTime = Date.now();
+        const requestDurationMs = requestEndTime - requestEvent.request_start_time;
+        return (0, utils_js_1.removeNullish)({
+            api_version: headers['stripe-version'],
+            account: headers['stripe-account'],
+            idempotency_key: headers['idempotency-key'],
+            method: requestEvent.method,
+            path: requestEvent.path,
+            status: statusCode,
+            request_id: this._getRequestId(headers),
+            elapsed: requestDurationMs,
+            request_start_time: requestEvent.request_start_time,
+            request_end_time: requestEndTime,
+        });
+    }
+    _getRequestId(headers) {
+        return headers['request-id'];
+    }
+    /**
+     * Used by methods with spec.streaming === true. For these methods, we do not
+     * buffer successful responses into memory or do parse them into stripe
+     * objects, we delegate that all of that to the user and pass back the raw
+     * http.Response object to the callback.
+     *
+     * (Unsuccessful responses shouldn't make it here, they should
+     * still be buffered/parsed and handled by _jsonResponseHandler -- see
+     * makeRequest)
+     */
+    _streamingResponseHandler(requestEvent, usage, callback) {
+        return (res) => {
+            const headers = res.getHeaders();
+            const streamCompleteCallback = () => {
+                const responseEvent = this._makeResponseEvent(requestEvent, res.getStatusCode(), headers);
+                this._stripe._emitter.emit('response', responseEvent);
+                this._recordRequestMetrics(this._getRequestId(headers), responseEvent.elapsed, usage);
+            };
+            const stream = res.toStream(streamCompleteCallback);
+            // This is here for backwards compatibility, as the stream is a raw
+            // HTTP response in Node and the legacy behavior was to mutate this
+            // response.
+            this._addHeadersDirectlyToObject(stream, headers);
+            return callback(null, stream);
+        };
+    }
+    /**
+     * Default handler for Stripe responses. Buffers the response into memory,
+     * parses the JSON and returns it (i.e. passes it to the callback) if there
+     * is no "error" field. Otherwise constructs/passes an appropriate Error.
+     */
+    _jsonResponseHandler(requestEvent, apiMode, usage, callback) {
+        return (res) => {
+            const headers = res.getHeaders();
+            const requestId = this._getRequestId(headers);
+            const statusCode = res.getStatusCode();
+            const responseEvent = this._makeResponseEvent(requestEvent, statusCode, headers);
+            this._stripe._emitter.emit('response', responseEvent);
+            res
+                .toJSON()
+                .then((jsonResponse) => {
+                if (jsonResponse.error) {
+                    const isOAuth = typeof jsonResponse.error === 'string';
+                    if (isOAuth) {
+                        jsonResponse.error = {
+                            type: jsonResponse.error,
+                            message: jsonResponse.error_description,
+                        };
+                    }
+                    jsonResponse.error.headers = headers;
+                    jsonResponse.error.statusCode = statusCode;
+                    jsonResponse.error.requestId = requestId;
+                    let err;
+                    if (isOAuth) {
+                        err = (0, Error_js_1.generateOAuthError)(jsonResponse.error);
+                    }
+                    else if (apiMode === 'v2') {
+                        err = (0, Error_js_1.generateV2Error)(jsonResponse.error);
+                    }
+                    else {
+                        err = (0, Error_js_1.generateV1Error)(jsonResponse.error);
+                    }
+                    throw err;
+                }
+                return jsonResponse;
+            }, (e) => {
+                throw new Error_js_1.StripeAPIError({
+                    message: 'Invalid JSON received from the Stripe API',
+                    exception: e,
+                    requestId: headers['request-id'],
+                });
+            })
+                .then((jsonResponse) => {
+                this._recordRequestMetrics(requestId, responseEvent.elapsed, usage);
+                // Expose raw response object.
+                const rawResponse = res.getRawResponse();
+                this._addHeadersDirectlyToObject(rawResponse, headers);
+                Object.defineProperty(jsonResponse, 'lastResponse', {
+                    enumerable: false,
+                    writable: false,
+                    value: rawResponse,
+                });
+                callback(null, jsonResponse);
+            }, (e) => callback(e, null));
+        };
+    }
+    static _generateConnectionErrorMessage(requestRetries) {
+        return `An error occurred with our connection to Stripe.${requestRetries > 0 ? ` Request was retried ${requestRetries} times.` : ''}`;
+    }
+    // For more on when and how to retry API requests, see https://stripe.com/docs/error-handling#safely-retrying-requests-with-idempotency
+    static _shouldRetry(res, numRetries, maxRetries, error) {
+        if (error &&
+            numRetries === 0 &&
+            HttpClient_js_1.HttpClient.CONNECTION_CLOSED_ERROR_CODES.includes(error.code)) {
+            return true;
+        }
+        // Do not retry if we are out of retries.
+        if (numRetries >= maxRetries) {
+            return false;
+        }
+        // Retry on connection error.
+        if (!res) {
+            return true;
+        }
+        // The API may ask us not to retry (e.g., if doing so would be a no-op)
+        // or advise us to retry (e.g., in cases of lock timeouts); we defer to that.
+        if (res.getHeaders()['stripe-should-retry'] === 'false') {
+            return false;
+        }
+        if (res.getHeaders()['stripe-should-retry'] === 'true') {
+            return true;
+        }
+        // Retry on conflict errors.
+        if (res.getStatusCode() === 409) {
+            return true;
+        }
+        // Retry on 500, 503, and other internal errors.
+        //
+        // Note that we expect the stripe-should-retry header to be false
+        // in most cases when a 500 is returned, since our idempotency framework
+        // would typically replay it anyway.
+        if (res.getStatusCode() >= 500) {
+            return true;
+        }
+        return false;
+    }
+    _getSleepTimeInMS(numRetries, retryAfter = null) {
+        const initialNetworkRetryDelay = this._stripe.getInitialNetworkRetryDelay();
+        const maxNetworkRetryDelay = this._stripe.getMaxNetworkRetryDelay();
+        // Apply exponential backoff with initialNetworkRetryDelay on the
+        // number of numRetries so far as inputs. Do not allow the number to exceed
+        // maxNetworkRetryDelay.
+        let sleepSeconds = Math.min(initialNetworkRetryDelay * Math.pow(2, numRetries - 1), maxNetworkRetryDelay);
+        // Apply some jitter by randomizing the value in the range of
+        // (sleepSeconds / 2) to (sleepSeconds).
+        sleepSeconds *= 0.5 * (1 + Math.random());
+        // But never sleep less than the base sleep seconds.
+        sleepSeconds = Math.max(initialNetworkRetryDelay, sleepSeconds);
+        // And never sleep less than the time the API asks us to wait, assuming it's a reasonable ask.
+        if (Number.isInteger(retryAfter) && retryAfter <= MAX_RETRY_AFTER_WAIT) {
+            sleepSeconds = Math.max(sleepSeconds, retryAfter);
+        }
+        return sleepSeconds * 1000;
+    }
+    // Max retries can be set on a per request basis. Favor those over the global setting
+    _getMaxNetworkRetries(settings = {}) {
+        return settings.maxNetworkRetries !== undefined &&
+            Number.isInteger(settings.maxNetworkRetries)
+            ? settings.maxNetworkRetries
+            : this._stripe.getMaxNetworkRetries();
+    }
+    _defaultIdempotencyKey(method, settings, apiMode) {
+        // If this is a POST and we allow multiple retries, ensure an idempotency key.
+        const maxRetries = this._getMaxNetworkRetries(settings);
+        const genKey = () => `stripe-node-retry-${this._stripe._platformFunctions.uuid4()}`;
+        // more verbose than it needs to be, but gives clear separation between V1 and V2 behavior
+        if (apiMode === 'v2') {
+            if (method === 'POST' || method === 'DELETE') {
+                return genKey();
+            }
+        }
+        else if (apiMode === 'v1') {
+            if (method === 'POST' && maxRetries > 0) {
+                return genKey();
+            }
+        }
+        return null;
+    }
+    _makeHeaders({ contentType, contentLength, apiVersion, clientUserAgent, method, userSuppliedHeaders, userSuppliedSettings, stripeAccount, stripeContext, apiMode, }) {
+        const defaultHeaders = {
+            Accept: 'application/json',
+            'Content-Type': contentType,
+            'User-Agent': this._getUserAgentString(apiMode),
+            'X-Stripe-Client-User-Agent': clientUserAgent,
+            'X-Stripe-Client-Telemetry': this._getTelemetryHeader(),
+            'Stripe-Version': apiVersion,
+            'Stripe-Account': stripeAccount,
+            'Stripe-Context': stripeContext,
+            'Idempotency-Key': this._defaultIdempotencyKey(method, userSuppliedSettings, apiMode),
+        };
+        // As per https://datatracker.ietf.org/doc/html/rfc7230#section-3.3.2:
+        //   A user agent SHOULD send a Content-Length in a request message when
+        //   no Transfer-Encoding is sent and the request method defines a meaning
+        //   for an enclosed payload body.  For example, a Content-Length header
+        //   field is normally sent in a POST request even when the value is 0
+        //   (indicating an empty payload body).  A user agent SHOULD NOT send a
+        //   Content-Length header field when the request message does not contain
+        //   a payload body and the method semantics do not anticipate such a
+        //   body.
+        //
+        // These method types are expected to have bodies and so we should always
+        // include a Content-Length.
+        const methodHasPayload = method == 'POST' || method == 'PUT' || method == 'PATCH';
+        // If a content length was specified, we always include it regardless of
+        // whether the method semantics anticipate such a body. This keeps us
+        // consistent with historical behavior. We do however want to warn on this
+        // and fix these cases as they are semantically incorrect.
+        if (methodHasPayload || contentLength) {
+            if (!methodHasPayload) {
+                (0, utils_js_1.emitWarning)(`${method} method had non-zero contentLength but no payload is expected for this verb`);
+            }
+            defaultHeaders['Content-Length'] = contentLength;
+        }
+        return Object.assign((0, utils_js_1.removeNullish)(defaultHeaders), 
+        // If the user supplied, say 'idempotency-key', override instead of appending by ensuring caps are the same.
+        (0, utils_js_1.normalizeHeaders)(userSuppliedHeaders));
+    }
+    _getUserAgentString(apiMode) {
+        const packageVersion = this._stripe.getConstant('PACKAGE_VERSION');
+        const appInfo = this._stripe._appInfo
+            ? this._stripe.getAppInfoAsString()
+            : '';
+        const aiAgent = this._stripe.getConstant('AI_AGENT');
+        let uaString = `Stripe/${apiMode} NodeBindings/${packageVersion}`;
+        if (appInfo) {
+            uaString += ` ${appInfo}`;
+        }
+        if (aiAgent) {
+            uaString += ` AIAgent/${aiAgent}`;
+        }
+        return uaString;
+    }
+    _getTelemetryHeader() {
+        if (this._stripe.getTelemetryEnabled() &&
+            this._stripe._prevRequestMetrics.length > 0) {
+            const metrics = this._stripe._prevRequestMetrics.shift();
+            return JSON.stringify({
+                last_request_metrics: metrics,
+            });
+        }
+    }
+    _recordRequestMetrics(requestId, requestDurationMs, usage) {
+        if (this._stripe.getTelemetryEnabled() && requestId) {
+            if (this._stripe._prevRequestMetrics.length > this._maxBufferedRequestMetric) {
+                (0, utils_js_1.emitWarning)('Request metrics buffer is full, dropping telemetry message.');
+            }
+            else {
+                const m = {
+                    request_id: requestId,
+                    request_duration_ms: requestDurationMs,
+                };
+                if (usage && usage.length > 0) {
+                    m.usage = usage;
+                }
+                this._stripe._prevRequestMetrics.push(m);
+            }
+        }
+    }
+    _rawRequest(method, path, params, options, usage) {
+        const requestPromise = new Promise((resolve, reject) => {
+            let opts;
+            try {
+                const requestMethod = method.toUpperCase();
+                if (requestMethod !== 'POST' &&
+                    params &&
+                    Object.keys(params).length !== 0) {
+                    throw new Error('rawRequest only supports params on POST requests. Please pass null and add your parameters to path.');
+                }
+                const args = [].slice.call([params, options]);
+                // Pull request data and options (headers, auth) from args.
+                const dataFromArgs = (0, utils_js_1.getDataFromArgs)(args);
+                const data = requestMethod === 'POST' ? Object.assign({}, dataFromArgs) : null;
+                const calculatedOptions = (0, utils_js_1.getOptionsFromArgs)(args);
+                const headers = calculatedOptions.headers;
+                // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+                const authenticator = calculatedOptions.authenticator;
+                opts = {
+                    requestMethod,
+                    requestPath: path,
+                    bodyData: data,
+                    queryData: {},
+                    authenticator,
+                    headers,
+                    host: calculatedOptions.host,
+                    streaming: !!calculatedOptions.streaming,
+                    settings: {},
+                    // We use this for thin event internals, so we should record the more specific `usage`, when available
+                    usage: usage || ['raw_request'],
+                };
+            }
+            catch (err) {
+                reject(err);
+                return;
+            }
+            function requestCallback(err, response) {
+                if (err) {
+                    reject(err);
+                }
+                else {
+                    resolve(response);
+                }
+            }
+            const { headers, settings } = opts;
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            const authenticator = opts.authenticator;
+            this._request(opts.requestMethod, opts.host, path, opts.bodyData, authenticator, { headers, settings, streaming: opts.streaming }, opts.usage, requestCallback);
+        });
+        return requestPromise;
+    }
+    _getContentLength(data) {
+        // if we calculate this wrong, the server treats it as invalid json
+        // or if content length is too big, the request never finishes and it
+        // times out.
+        return typeof data === 'string'
+            ? new TextEncoder().encode(data).length
+            : data.length;
+    }
+    _request(method, host, path, data, authenticator, options, usage = [], callback, requestDataProcessor = null) {
+        let requestData;
+        authenticator = authenticator ?? this._stripe._authenticator ?? null;
+        const apiMode = (0, utils_js_1.getAPIMode)(path);
+        const retryRequest = (requestFn, apiVersion, headers, requestRetries, retryAfter) => {
+            return setTimeout(requestFn, this._getSleepTimeInMS(requestRetries, retryAfter), apiVersion, headers, requestRetries + 1);
+        };
+        const makeRequest = (apiVersion, headers, numRetries) => {
+            // timeout can be set on a per-request basis. Favor that over the global setting
+            const timeout = options.settings &&
+                options.settings.timeout &&
+                Number.isInteger(options.settings.timeout) &&
+                options.settings.timeout >= 0
+                ? options.settings.timeout
+                : this._stripe.getApiField('timeout');
+            const request = {
+                host: host || this._stripe.getApiField('host'),
+                port: this._stripe.getApiField('port'),
+                path: path,
+                method: method,
+                headers: Object.assign({}, headers),
+                body: requestData,
+                protocol: this._stripe.getApiField('protocol'),
+            };
+            authenticator(request)
+                .then(() => {
+                const req = this._stripe
+                    .getApiField('httpClient')
+                    .makeRequest(request.host, request.port, request.path, request.method, request.headers, request.body, request.protocol, timeout);
+                const requestStartTime = Date.now();
+                const requestEvent = (0, utils_js_1.removeNullish)({
+                    api_version: apiVersion,
+                    account: (0, utils_js_1.parseHttpHeaderAsString)(headers['Stripe-Account']),
+                    idempotency_key: (0, utils_js_1.parseHttpHeaderAsString)(headers['Idempotency-Key']),
+                    method,
+                    path,
+                    request_start_time: requestStartTime,
+                });
+                const requestRetries = numRetries || 0;
+                const maxRetries = this._getMaxNetworkRetries(options.settings || {});
+                this._stripe._emitter.emit('request', requestEvent);
+                req
+                    .then((res) => {
+                    if (RequestSender._shouldRetry(res, requestRetries, maxRetries)) {
+                        return retryRequest(makeRequest, apiVersion, headers, requestRetries, (0, utils_js_1.parseHttpHeaderAsNumber)(res.getHeaders()['retry-after']));
+                    }
+                    else if (options.streaming && res.getStatusCode() < 400) {
+                        return this._streamingResponseHandler(requestEvent, usage, callback)(res);
+                    }
+                    else {
+                        return this._jsonResponseHandler(requestEvent, apiMode, usage, callback)(res);
+                    }
+                })
+                    .catch((error) => {
+                    if (RequestSender._shouldRetry(null, requestRetries, maxRetries, error)) {
+                        return retryRequest(makeRequest, apiVersion, headers, requestRetries, null);
+                    }
+                    else {
+                        const isTimeoutError = error.code && error.code === HttpClient_js_1.HttpClient.TIMEOUT_ERROR_CODE;
+                        return callback(new Error_js_1.StripeConnectionError({
+                            message: isTimeoutError
+                                ? `Request aborted due to timeout being reached (${timeout}ms)`
+                                : RequestSender._generateConnectionErrorMessage(requestRetries),
+                            detail: error,
+                        }));
+                    }
+                });
+            })
+                .catch((e) => {
+                throw new Error_js_1.StripeError({
+                    message: 'Unable to authenticate the request',
+                    exception: e,
+                });
+            });
+        };
+        const prepareAndMakeRequest = (error, data) => {
+            if (error) {
+                return callback(error);
+            }
+            requestData = data;
+            this._stripe.getClientUserAgent((clientUserAgent) => {
+                const apiVersion = this._stripe.getApiField('version');
+                const headers = this._makeHeaders({
+                    contentType: apiMode == 'v2'
+                        ? 'application/json'
+                        : 'application/x-www-form-urlencoded',
+                    contentLength: this._getContentLength(data),
+                    apiVersion: apiVersion,
+                    clientUserAgent,
+                    method,
+                    // other callers expect null, but .headers being optional means it's undefined if not supplied. So we normalize to null.
+                    userSuppliedHeaders: options.headers ?? null,
+                    userSuppliedSettings: options.settings ?? {},
+                    stripeAccount: options.stripeAccount ?? this._stripe.getApiField('stripeAccount'),
+                    stripeContext: this._normalizeStripeContext(options.stripeContext, this._stripe.getApiField('stripeContext')),
+                    apiMode: apiMode,
+                });
+                makeRequest(apiVersion, headers, 0);
+            });
+        };
+        if (requestDataProcessor) {
+            requestDataProcessor(method, data, options.headers, prepareAndMakeRequest);
+        }
+        else {
+            let stringifiedData;
+            if (apiMode == 'v2') {
+                stringifiedData = data ? (0, utils_js_1.jsonStringifyRequestData)(data) : '';
+            }
+            else {
+                stringifiedData = (0, utils_js_1.queryStringifyRequestData)(data || {});
+            }
+            prepareAndMakeRequest(null, stringifiedData);
+        }
+    }
+}
+exports.RequestSender = RequestSender;

package/cjs/ResourceNamespace.js

@@ -0,0 +1,21 @@
+"use strict";
+// ResourceNamespace allows you to create nested resources, i.e. `stripe.issuing.cards`.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resourceNamespace = void 0;
+// It also works recursively, so you could do i.e. `stripe.billing.invoicing.pay`.
+function ResourceNamespace(stripe, resources) {
+    for (const name in resources) {
+        if (!Object.prototype.hasOwnProperty.call(resources, name)) {
+            continue;
+        }
+        const camelCaseName = name[0].toLowerCase() + name.substring(1);
+        const resource = new resources[name](stripe);
+        this[camelCaseName] = resource;
+    }
+}
+function resourceNamespace(namespace, resources) {
+    return function (stripe) {
+        return new ResourceNamespace(stripe, resources);
+    };
+}
+exports.resourceNamespace = resourceNamespace;

package/cjs/StripeContext.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StripeContext = void 0;
+/**
+ * The StripeContext class provides an immutable container and convenience methods for interacting with the `Stripe-Context` header. All methods return a new instance of StripeContext.
+ * You can use it whenever you're initializing a `Stripe` instance or sending `stripeContext` with a request. It's also found in the `EventNotification.context` property.
+ */
+class StripeContext {
+    /**
+     * Creates a new StripeContext with the given segments.
+     */
+    constructor(segments = []) {
+        this._segments = [...segments];
+    }
+    /**
+     * Gets a copy of the segments of this Context.
+     */
+    get segments() {
+        return [...this._segments];
+    }
+    /**
+     * Creates a new StripeContext with an additional segment appended.
+     */
+    push(segment) {
+        if (!segment) {
+            throw new Error('Segment cannot be null or undefined');
+        }
+        return new StripeContext([...this._segments, segment]);
+    }
+    /**
+     * Creates a new StripeContext with the last segment removed.
+     * If there are no segments, throws an error.
+     */
+    pop() {
+        if (this._segments.length === 0) {
+            throw new Error('Cannot pop from an empty context');
+        }
+        return new StripeContext(this._segments.slice(0, -1));
+    }
+    /**
+     * Converts this context to its string representation.
+     */
+    toString() {
+        return this._segments.join('/');
+    }
+    /**
+     * Parses a context string into a StripeContext instance.
+     */
+    static parse(contextStr) {
+        if (!contextStr) {
+            return new StripeContext([]);
+        }
+        return new StripeContext(contextStr.split('/'));
+    }
+}
+exports.StripeContext = StripeContext;

package/cjs/StripeEmitter.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StripeEmitter = void 0;
+/**
+ * @private
+ * (For internal use in stripe-node.)
+ * Wrapper around the Event Web API.
+ */
+class _StripeEvent extends Event {
+    constructor(eventName, data) {
+        super(eventName);
+        this.data = data;
+    }
+}
+/** Minimal EventEmitter wrapper around EventTarget. */
+class StripeEmitter {
+    constructor() {
+        this.eventTarget = new EventTarget();
+        this.listenerMapping = new Map();
+    }
+    on(eventName, listener) {
+        const listenerWrapper = (event) => {
+            listener(event.data);
+        };
+        this.listenerMapping.set(listener, listenerWrapper);
+        return this.eventTarget.addEventListener(eventName, listenerWrapper);
+    }
+    removeListener(eventName, listener) {
+        const listenerWrapper = this.listenerMapping.get(listener);
+        this.listenerMapping.delete(listener);
+        return this.eventTarget.removeEventListener(eventName, listenerWrapper);
+    }
+    once(eventName, listener) {
+        const listenerWrapper = (event) => {
+            listener(event.data);
+        };
+        this.listenerMapping.set(listener, listenerWrapper);
+        return this.eventTarget.addEventListener(eventName, listenerWrapper, {
+            once: true,
+        });
+    }
+    emit(eventName, data) {
+        return this.eventTarget.dispatchEvent(new _StripeEvent(eventName, data));
+    }
+}
+exports.StripeEmitter = StripeEmitter;

package/cjs/StripeMethod.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripeMethod = void 0;
+const utils_js_1 = require("./utils.js");
+const autoPagination_js_1 = require("./autoPagination.js");
+/**
+ * Create an API method from the declared spec.
+ *
+ * @param [spec.method='GET'] Request Method (POST, GET, DELETE, PUT)
+ * @param [spec.path=''] Path to be appended to the API BASE_PATH, joined with
+ *  the instance's path (e.g. 'charges' or 'customers')
+ * @param [spec.fullPath=''] Fully qualified path to the method (eg. /v1/a/b/c).
+ *  If this is specified, path should not be specified.
+ * @param [spec.urlParams=[]] Array of required arguments in the order that they
+ *  must be passed by the consumer of the API. Subsequent optional arguments are
+ *  optionally passed through a hash (Object) as the penultimate argument
+ *  (preceding the also-optional callback argument
+ * @param [spec.encode] Function for mutating input parameters to a method.
+ *  Usefully for applying transforms to data on a per-method basis.
+ * @param [spec.host] Hostname for the request.
+ *
+ * <!-- Public API accessible via Stripe.StripeResource.method -->
+ */
+function stripeMethod(spec) {
+    if (spec.path !== undefined && spec.fullPath !== undefined) {
+        throw new Error(`Method spec specified both a 'path' (${spec.path}) and a 'fullPath' (${spec.fullPath}).`);
+    }
+    return function (...args) {
+        const callback = typeof args[args.length - 1] == 'function' && args.pop();
+        spec.urlParams = (0, utils_js_1.extractUrlParams)(spec.fullPath || this.createResourcePathWithSymbols(spec.path || ''));
+        const requestPromise = (0, utils_js_1.callbackifyPromiseWithTimeout)(this._makeRequest(args, spec, {}), callback);
+        Object.assign(requestPromise, (0, autoPagination_js_1.makeAutoPaginationMethods)(this, args, spec, requestPromise));
+        return requestPromise;
+    };
+}
+exports.stripeMethod = stripeMethod;