camara-sdk 0.1.1

package/client.mjs

@@ -0,0 +1,607 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+var _Camara_instances, _a, _Camara_encoder, _Camara_baseURLOverridden;
+import { __classPrivateFieldGet, __classPrivateFieldSet } from "./internal/tslib.mjs";
+import { uuid4 } from "./internal/utils/uuid.mjs";
+import { validatePositiveInteger, isAbsoluteURL, safeJSON } from "./internal/utils/values.mjs";
+import { sleep } from "./internal/utils/sleep.mjs";
+import { castToError, isAbortError } from "./internal/errors.mjs";
+import { getPlatformHeaders } from "./internal/detect-platform.mjs";
+import * as Shims from "./internal/shims.mjs";
+import * as Opts from "./internal/request-options.mjs";
+import { VERSION } from "./version.mjs";
+import * as Errors from "./core/error.mjs";
+import * as Uploads from "./core/uploads.mjs";
+import * as API from "./resources/index.mjs";
+import { APIPromise } from "./core/api-promise.mjs";
+import { Callforwardingsignal, } from "./resources/callforwardingsignal.mjs";
+import { Deviceidentifier, } from "./resources/deviceidentifier.mjs";
+import { Deviceswap, } from "./resources/deviceswap.mjs";
+import { Knowyourcustomerageverification, } from "./resources/knowyourcustomerageverification.mjs";
+import { KnowyourcustomerfillIn, } from "./resources/knowyourcustomerfill-in.mjs";
+import { Knowyourcustomermatch, } from "./resources/knowyourcustomermatch.mjs";
+import { Numberrecycling, } from "./resources/numberrecycling.mjs";
+import { Otpvalidation, } from "./resources/otpvalidation.mjs";
+import { Populationdensitydata, } from "./resources/populationdensitydata.mjs";
+import { Qualityondemand, } from "./resources/qualityondemand.mjs";
+import { Regiondevicecount, } from "./resources/regiondevicecount.mjs";
+import { Tenure } from "./resources/tenure.mjs";
+import { Connectednetworktype } from "./resources/connectednetworktype/connectednetworktype.mjs";
+import { Connectivityinsights } from "./resources/connectivityinsights/connectivityinsights.mjs";
+import { Customerinsights } from "./resources/customerinsights/customerinsights.mjs";
+import { Devicelocation } from "./resources/devicelocation/devicelocation.mjs";
+import { Devicereachabilitystatus } from "./resources/devicereachabilitystatus/devicereachabilitystatus.mjs";
+import { Deviceroamingstatus } from "./resources/deviceroamingstatus/deviceroamingstatus.mjs";
+import { Simswap } from "./resources/simswap/simswap.mjs";
+import { Webrtc } from "./resources/webrtc/webrtc.mjs";
+import { buildHeaders } from "./internal/headers.mjs";
+import { readEnv } from "./internal/utils/env.mjs";
+import { formatRequestDetails, loggerFor, parseLogLevel, } from "./internal/utils/log.mjs";
+import { isEmptyObj } from "./internal/utils/values.mjs";
+/**
+ * API Client for interfacing with the Camara API.
+ */
+export class Camara {
+    /**
+     * API Client for interfacing with the Camara API.
+     *
+     * @param {string | undefined} [opts.deviceLocationNotificationsAPIKey=process.env['CAMARA_DEVICE_LOCATION_NOTIFICATIONS_API_KEY'] ?? undefined]
+     * @param {string | undefined} [opts.notificationsAPIKey=process.env['CAMARA_NOTIFICATIONS_API_KEY'] ?? undefined]
+     * @param {string | undefined} [opts.populationDensityDataNotificationsAPIKey=process.env['CAMARA_POPULATION_DENSITY_DATA_NOTIFICATIONS_API_KEY'] ?? undefined]
+     * @param {string | undefined} [opts.regionDeviceCountNotificationsAPIKey=process.env['CAMARA_REGION_DEVICE_COUNT_NOTIFICATIONS_API_KEY'] ?? undefined]
+     * @param {string | undefined} [opts.connectivityInsightsNotificationsAPIKey=process.env['CAMARA_CONNECTIVITY_INSIGHTS_NOTIFICATIONS_API_KEY'] ?? undefined]
+     * @param {string | undefined} [opts.simSwapNotificationsAPIKey=process.env['CAMARA_SIM_SWAP_NOTIFICATIONS_API_KEY'] ?? undefined]
+     * @param {string | undefined} [opts.deviceRoamingStatusNotificationsAPIKey=process.env['CAMARA_DEVICE_ROAMING_STATUS_NOTIFICATIONS_API_KEY'] ?? undefined]
+     * @param {string | undefined} [opts.deviceReachabilityStatusNotificationsAPIKey=process.env['CAMARA_DEVICE_REACHABILITY_STATUS_NOTIFICATIONS_API_KEY'] ?? undefined]
+     * @param {string | undefined} [opts.connectedNetworkTypeNotificationsAPIKey=process.env['CAMARA_CONNECTED_NETWORK_TYPE_NOTIFICATIONS_API_KEY'] ?? undefined]
+     * @param {string} [opts.baseURL=process.env['CAMARA_BASE_URL'] ?? https://api.example.com/camara] - Override the default base URL for the API.
+     * @param {number} [opts.timeout=1 minute] - The maximum amount of time (in milliseconds) the client will wait for a response before timing out.
+     * @param {MergedRequestInit} [opts.fetchOptions] - Additional `RequestInit` options to be passed to `fetch` calls.
+     * @param {Fetch} [opts.fetch] - Specify a custom `fetch` function implementation.
+     * @param {number} [opts.maxRetries=2] - The maximum number of times the client will retry a request.
+     * @param {HeadersLike} opts.defaultHeaders - Default headers to include with every request to the API.
+     * @param {Record<string, string | undefined>} opts.defaultQuery - Default query parameters to include with every request to the API.
+     */
+    constructor({ baseURL = readEnv('CAMARA_BASE_URL'), deviceLocationNotificationsAPIKey = readEnv('CAMARA_DEVICE_LOCATION_NOTIFICATIONS_API_KEY'), notificationsAPIKey = readEnv('CAMARA_NOTIFICATIONS_API_KEY'), populationDensityDataNotificationsAPIKey = readEnv('CAMARA_POPULATION_DENSITY_DATA_NOTIFICATIONS_API_KEY'), regionDeviceCountNotificationsAPIKey = readEnv('CAMARA_REGION_DEVICE_COUNT_NOTIFICATIONS_API_KEY'), connectivityInsightsNotificationsAPIKey = readEnv('CAMARA_CONNECTIVITY_INSIGHTS_NOTIFICATIONS_API_KEY'), simSwapNotificationsAPIKey = readEnv('CAMARA_SIM_SWAP_NOTIFICATIONS_API_KEY'), deviceRoamingStatusNotificationsAPIKey = readEnv('CAMARA_DEVICE_ROAMING_STATUS_NOTIFICATIONS_API_KEY'), deviceReachabilityStatusNotificationsAPIKey = readEnv('CAMARA_DEVICE_REACHABILITY_STATUS_NOTIFICATIONS_API_KEY'), connectedNetworkTypeNotificationsAPIKey = readEnv('CAMARA_CONNECTED_NETWORK_TYPE_NOTIFICATIONS_API_KEY'), ...opts } = {}) {
+        _Camara_instances.add(this);
+        _Camara_encoder.set(this, void 0);
+        this.customerinsights = new API.Customerinsights(this);
+        this.deviceswap = new API.Deviceswap(this);
+        this.knowyourcustomerageverification = new API.Knowyourcustomerageverification(this);
+        this.knowyourcustomerfillIn = new API.KnowyourcustomerfillIn(this);
+        this.knowyourcustomermatch = new API.Knowyourcustomermatch(this);
+        this.tenure = new API.Tenure(this);
+        this.numberrecycling = new API.Numberrecycling(this);
+        this.otpvalidation = new API.Otpvalidation(this);
+        this.callforwardingsignal = new API.Callforwardingsignal(this);
+        this.devicelocation = new API.Devicelocation(this);
+        this.populationdensitydata = new API.Populationdensitydata(this);
+        this.regiondevicecount = new API.Regiondevicecount(this);
+        this.webrtc = new API.Webrtc(this);
+        this.connectivityinsights = new API.Connectivityinsights(this);
+        this.qualityondemand = new API.Qualityondemand(this);
+        this.deviceidentifier = new API.Deviceidentifier(this);
+        this.simswap = new API.Simswap(this);
+        this.deviceroamingstatus = new API.Deviceroamingstatus(this);
+        this.devicereachabilitystatus = new API.Devicereachabilitystatus(this);
+        this.connectednetworktype = new API.Connectednetworktype(this);
+        if (deviceLocationNotificationsAPIKey === undefined) {
+            throw new Errors.CamaraError("The CAMARA_DEVICE_LOCATION_NOTIFICATIONS_API_KEY environment variable is missing or empty; either provide it, or instantiate the Camara client with an deviceLocationNotificationsAPIKey option, like new Camara({ deviceLocationNotificationsAPIKey: 'My Device Location Notifications API Key' }).");
+        }
+        if (notificationsAPIKey === undefined) {
+            throw new Errors.CamaraError("The CAMARA_NOTIFICATIONS_API_KEY environment variable is missing or empty; either provide it, or instantiate the Camara client with an notificationsAPIKey option, like new Camara({ notificationsAPIKey: 'My Notifications API Key' }).");
+        }
+        if (populationDensityDataNotificationsAPIKey === undefined) {
+            throw new Errors.CamaraError("The CAMARA_POPULATION_DENSITY_DATA_NOTIFICATIONS_API_KEY environment variable is missing or empty; either provide it, or instantiate the Camara client with an populationDensityDataNotificationsAPIKey option, like new Camara({ populationDensityDataNotificationsAPIKey: 'My Population Density Data Notifications API Key' }).");
+        }
+        if (regionDeviceCountNotificationsAPIKey === undefined) {
+            throw new Errors.CamaraError("The CAMARA_REGION_DEVICE_COUNT_NOTIFICATIONS_API_KEY environment variable is missing or empty; either provide it, or instantiate the Camara client with an regionDeviceCountNotificationsAPIKey option, like new Camara({ regionDeviceCountNotificationsAPIKey: 'My Region Device Count Notifications API Key' }).");
+        }
+        if (connectivityInsightsNotificationsAPIKey === undefined) {
+            throw new Errors.CamaraError("The CAMARA_CONNECTIVITY_INSIGHTS_NOTIFICATIONS_API_KEY environment variable is missing or empty; either provide it, or instantiate the Camara client with an connectivityInsightsNotificationsAPIKey option, like new Camara({ connectivityInsightsNotificationsAPIKey: 'My Connectivity Insights Notifications API Key' }).");
+        }
+        if (simSwapNotificationsAPIKey === undefined) {
+            throw new Errors.CamaraError("The CAMARA_SIM_SWAP_NOTIFICATIONS_API_KEY environment variable is missing or empty; either provide it, or instantiate the Camara client with an simSwapNotificationsAPIKey option, like new Camara({ simSwapNotificationsAPIKey: 'My Sim Swap Notifications API Key' }).");
+        }
+        if (deviceRoamingStatusNotificationsAPIKey === undefined) {
+            throw new Errors.CamaraError("The CAMARA_DEVICE_ROAMING_STATUS_NOTIFICATIONS_API_KEY environment variable is missing or empty; either provide it, or instantiate the Camara client with an deviceRoamingStatusNotificationsAPIKey option, like new Camara({ deviceRoamingStatusNotificationsAPIKey: 'My Device Roaming Status Notifications API Key' }).");
+        }
+        if (deviceReachabilityStatusNotificationsAPIKey === undefined) {
+            throw new Errors.CamaraError("The CAMARA_DEVICE_REACHABILITY_STATUS_NOTIFICATIONS_API_KEY environment variable is missing or empty; either provide it, or instantiate the Camara client with an deviceReachabilityStatusNotificationsAPIKey option, like new Camara({ deviceReachabilityStatusNotificationsAPIKey: 'My Device Reachability Status Notifications API Key' }).");
+        }
+        if (connectedNetworkTypeNotificationsAPIKey === undefined) {
+            throw new Errors.CamaraError("The CAMARA_CONNECTED_NETWORK_TYPE_NOTIFICATIONS_API_KEY environment variable is missing or empty; either provide it, or instantiate the Camara client with an connectedNetworkTypeNotificationsAPIKey option, like new Camara({ connectedNetworkTypeNotificationsAPIKey: 'My Connected Network Type Notifications API Key' }).");
+        }
+        const options = {
+            deviceLocationNotificationsAPIKey,
+            notificationsAPIKey,
+            populationDensityDataNotificationsAPIKey,
+            regionDeviceCountNotificationsAPIKey,
+            connectivityInsightsNotificationsAPIKey,
+            simSwapNotificationsAPIKey,
+            deviceRoamingStatusNotificationsAPIKey,
+            deviceReachabilityStatusNotificationsAPIKey,
+            connectedNetworkTypeNotificationsAPIKey,
+            ...opts,
+            baseURL: baseURL || `https://api.example.com/camara`,
+        };
+        this.baseURL = options.baseURL;
+        this.timeout = options.timeout ?? _a.DEFAULT_TIMEOUT /* 1 minute */;
+        this.logger = options.logger ?? console;
+        const defaultLogLevel = 'warn';
+        // Set default logLevel early so that we can log a warning in parseLogLevel.
+        this.logLevel = defaultLogLevel;
+        this.logLevel =
+            parseLogLevel(options.logLevel, 'ClientOptions.logLevel', this) ??
+                parseLogLevel(readEnv('CAMARA_LOG'), "process.env['CAMARA_LOG']", this) ??
+                defaultLogLevel;
+        this.fetchOptions = options.fetchOptions;
+        this.maxRetries = options.maxRetries ?? 2;
+        this.fetch = options.fetch ?? Shims.getDefaultFetch();
+        __classPrivateFieldSet(this, _Camara_encoder, Opts.FallbackEncoder, "f");
+        this._options = options;
+        this.deviceLocationNotificationsAPIKey = deviceLocationNotificationsAPIKey;
+        this.notificationsAPIKey = notificationsAPIKey;
+        this.populationDensityDataNotificationsAPIKey = populationDensityDataNotificationsAPIKey;
+        this.regionDeviceCountNotificationsAPIKey = regionDeviceCountNotificationsAPIKey;
+        this.connectivityInsightsNotificationsAPIKey = connectivityInsightsNotificationsAPIKey;
+        this.simSwapNotificationsAPIKey = simSwapNotificationsAPIKey;
+        this.deviceRoamingStatusNotificationsAPIKey = deviceRoamingStatusNotificationsAPIKey;
+        this.deviceReachabilityStatusNotificationsAPIKey = deviceReachabilityStatusNotificationsAPIKey;
+        this.connectedNetworkTypeNotificationsAPIKey = connectedNetworkTypeNotificationsAPIKey;
+    }
+    /**
+     * Create a new client instance re-using the same options given to the current client with optional overriding.
+     */
+    withOptions(options) {
+        const client = new this.constructor({
+            ...this._options,
+            baseURL: this.baseURL,
+            maxRetries: this.maxRetries,
+            timeout: this.timeout,
+            logger: this.logger,
+            logLevel: this.logLevel,
+            fetch: this.fetch,
+            fetchOptions: this.fetchOptions,
+            deviceLocationNotificationsAPIKey: this.deviceLocationNotificationsAPIKey,
+            notificationsAPIKey: this.notificationsAPIKey,
+            populationDensityDataNotificationsAPIKey: this.populationDensityDataNotificationsAPIKey,
+            regionDeviceCountNotificationsAPIKey: this.regionDeviceCountNotificationsAPIKey,
+            connectivityInsightsNotificationsAPIKey: this.connectivityInsightsNotificationsAPIKey,
+            simSwapNotificationsAPIKey: this.simSwapNotificationsAPIKey,
+            deviceRoamingStatusNotificationsAPIKey: this.deviceRoamingStatusNotificationsAPIKey,
+            deviceReachabilityStatusNotificationsAPIKey: this.deviceReachabilityStatusNotificationsAPIKey,
+            connectedNetworkTypeNotificationsAPIKey: this.connectedNetworkTypeNotificationsAPIKey,
+            ...options,
+        });
+        return client;
+    }
+    defaultQuery() {
+        return this._options.defaultQuery;
+    }
+    validateHeaders({ values, nulls }) {
+        return;
+    }
+    async authHeaders(opts) {
+        return buildHeaders([
+            await this.deviceLocationnotificationsBearerAuth(opts),
+            await this.notificationsBearerAuth(opts),
+            await this.populationDensityDatanotificationsBearerAuth(opts),
+            await this.regionDeviceCountnotificationsBearerAuth(opts),
+            await this.connectivityInsightsnotificationsBearerAuth(opts),
+            await this.simSwapnotificationsBearerAuth(opts),
+            await this.deviceRoamingStatusnotificationsBearerAuth(opts),
+            await this.deviceReachabilityStatusnotificationsBearerAuth(opts),
+            await this.connectedNetworkTypenotificationsBearerAuth(opts),
+        ]);
+    }
+    async deviceLocationnotificationsBearerAuth(opts) {
+        return buildHeaders([{ Authorization: `Bearer ${this.deviceLocationNotificationsAPIKey}` }]);
+    }
+    async notificationsBearerAuth(opts) {
+        return buildHeaders([{ Authorization: `Bearer ${this.notificationsAPIKey}` }]);
+    }
+    async populationDensityDatanotificationsBearerAuth(opts) {
+        return buildHeaders([{ Authorization: `Bearer ${this.populationDensityDataNotificationsAPIKey}` }]);
+    }
+    async regionDeviceCountnotificationsBearerAuth(opts) {
+        return buildHeaders([{ Authorization: `Bearer ${this.regionDeviceCountNotificationsAPIKey}` }]);
+    }
+    async connectivityInsightsnotificationsBearerAuth(opts) {
+        return buildHeaders([{ Authorization: `Bearer ${this.connectivityInsightsNotificationsAPIKey}` }]);
+    }
+    async simSwapnotificationsBearerAuth(opts) {
+        return buildHeaders([{ Authorization: `Bearer ${this.simSwapNotificationsAPIKey}` }]);
+    }
+    async deviceRoamingStatusnotificationsBearerAuth(opts) {
+        return buildHeaders([{ Authorization: `Bearer ${this.deviceRoamingStatusNotificationsAPIKey}` }]);
+    }
+    async deviceReachabilityStatusnotificationsBearerAuth(opts) {
+        return buildHeaders([{ Authorization: `Bearer ${this.deviceReachabilityStatusNotificationsAPIKey}` }]);
+    }
+    async connectedNetworkTypenotificationsBearerAuth(opts) {
+        return buildHeaders([{ Authorization: `Bearer ${this.connectedNetworkTypeNotificationsAPIKey}` }]);
+    }
+    /**
+     * Basic re-implementation of `qs.stringify` for primitive types.
+     */
+    stringifyQuery(query) {
+        return Object.entries(query)
+            .filter(([_, value]) => typeof value !== 'undefined')
+            .map(([key, value]) => {
+            if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
+                return `${encodeURIComponent(key)}=${encodeURIComponent(value)}`;
+            }
+            if (value === null) {
+                return `${encodeURIComponent(key)}=`;
+            }
+            throw new Errors.CamaraError(`Cannot stringify type ${typeof value}; Expected string, number, boolean, or null. If you need to pass nested query parameters, you can manually encode them, e.g. { query: { 'foo[key1]': value1, 'foo[key2]': value2 } }, and please open a GitHub issue requesting better support for your use case.`);
+        })
+            .join('&');
+    }
+    getUserAgent() {
+        return `${this.constructor.name}/JS ${VERSION}`;
+    }
+    defaultIdempotencyKey() {
+        return `stainless-node-retry-${uuid4()}`;
+    }
+    makeStatusError(status, error, message, headers) {
+        return Errors.APIError.generate(status, error, message, headers);
+    }
+    buildURL(path, query, defaultBaseURL) {
+        const baseURL = (!__classPrivateFieldGet(this, _Camara_instances, "m", _Camara_baseURLOverridden).call(this) && defaultBaseURL) || this.baseURL;
+        const url = isAbsoluteURL(path) ?
+            new URL(path)
+            : new URL(baseURL + (baseURL.endsWith('/') && path.startsWith('/') ? path.slice(1) : path));
+        const defaultQuery = this.defaultQuery();
+        if (!isEmptyObj(defaultQuery)) {
+            query = { ...defaultQuery, ...query };
+        }
+        if (typeof query === 'object' && query && !Array.isArray(query)) {
+            url.search = this.stringifyQuery(query);
+        }
+        return url.toString();
+    }
+    /**
+     * Used as a callback for mutating the given `FinalRequestOptions` object.
+     */
+    async prepareOptions(options) { }
+    /**
+     * Used as a callback for mutating the given `RequestInit` object.
+     *
+     * This is useful for cases where you want to add certain headers based off of
+     * the request properties, e.g. `method` or `url`.
+     */
+    async prepareRequest(request, { url, options }) { }
+    get(path, opts) {
+        return this.methodRequest('get', path, opts);
+    }
+    post(path, opts) {
+        return this.methodRequest('post', path, opts);
+    }
+    patch(path, opts) {
+        return this.methodRequest('patch', path, opts);
+    }
+    put(path, opts) {
+        return this.methodRequest('put', path, opts);
+    }
+    delete(path, opts) {
+        return this.methodRequest('delete', path, opts);
+    }
+    methodRequest(method, path, opts) {
+        return this.request(Promise.resolve(opts).then((opts) => {
+            return { method, path, ...opts };
+        }));
+    }
+    request(options, remainingRetries = null) {
+        return new APIPromise(this, this.makeRequest(options, remainingRetries, undefined));
+    }
+    async makeRequest(optionsInput, retriesRemaining, retryOfRequestLogID) {
+        const options = await optionsInput;
+        const maxRetries = options.maxRetries ?? this.maxRetries;
+        if (retriesRemaining == null) {
+            retriesRemaining = maxRetries;
+        }
+        await this.prepareOptions(options);
+        const { req, url, timeout } = await this.buildRequest(options, {
+            retryCount: maxRetries - retriesRemaining,
+        });
+        await this.prepareRequest(req, { url, options });
+        /** Not an API request ID, just for correlating local log entries. */
+        const requestLogID = 'log_' + ((Math.random() * (1 << 24)) | 0).toString(16).padStart(6, '0');
+        const retryLogStr = retryOfRequestLogID === undefined ? '' : `, retryOf: ${retryOfRequestLogID}`;
+        const startTime = Date.now();
+        loggerFor(this).debug(`[${requestLogID}] sending request`, formatRequestDetails({
+            retryOfRequestLogID,
+            method: options.method,
+            url,
+            options,
+            headers: req.headers,
+        }));
+        if (options.signal?.aborted) {
+            throw new Errors.APIUserAbortError();
+        }
+        const controller = new AbortController();
+        const response = await this.fetchWithTimeout(url, req, timeout, controller).catch(castToError);
+        const headersTime = Date.now();
+        if (response instanceof globalThis.Error) {
+            const retryMessage = `retrying, ${retriesRemaining} attempts remaining`;
+            if (options.signal?.aborted) {
+                throw new Errors.APIUserAbortError();
+            }
+            // detect native connection timeout errors
+            // deno throws "TypeError: error sending request for url (https://example/): client error (Connect): tcp connect error: Operation timed out (os error 60): Operation timed out (os error 60)"
+            // undici throws "TypeError: fetch failed" with cause "ConnectTimeoutError: Connect Timeout Error (attempted address: example:443, timeout: 1ms)"
+            // others do not provide enough information to distinguish timeouts from other connection errors
+            const isTimeout = isAbortError(response) ||
+                /timed? ?out/i.test(String(response) + ('cause' in response ? String(response.cause) : ''));
+            if (retriesRemaining) {
+                loggerFor(this).info(`[${requestLogID}] connection ${isTimeout ? 'timed out' : 'failed'} - ${retryMessage}`);
+                loggerFor(this).debug(`[${requestLogID}] connection ${isTimeout ? 'timed out' : 'failed'} (${retryMessage})`, formatRequestDetails({
+                    retryOfRequestLogID,
+                    url,
+                    durationMs: headersTime - startTime,
+                    message: response.message,
+                }));
+                return this.retryRequest(options, retriesRemaining, retryOfRequestLogID ?? requestLogID);
+            }
+            loggerFor(this).info(`[${requestLogID}] connection ${isTimeout ? 'timed out' : 'failed'} - error; no more retries left`);
+            loggerFor(this).debug(`[${requestLogID}] connection ${isTimeout ? 'timed out' : 'failed'} (error; no more retries left)`, formatRequestDetails({
+                retryOfRequestLogID,
+                url,
+                durationMs: headersTime - startTime,
+                message: response.message,
+            }));
+            if (isTimeout) {
+                throw new Errors.APIConnectionTimeoutError();
+            }
+            throw new Errors.APIConnectionError({ cause: response });
+        }
+        const responseInfo = `[${requestLogID}${retryLogStr}] ${req.method} ${url} ${response.ok ? 'succeeded' : 'failed'} with status ${response.status} in ${headersTime - startTime}ms`;
+        if (!response.ok) {
+            const shouldRetry = await this.shouldRetry(response);
+            if (retriesRemaining && shouldRetry) {
+                const retryMessage = `retrying, ${retriesRemaining} attempts remaining`;
+                // We don't need the body of this response.
+                await Shims.CancelReadableStream(response.body);
+                loggerFor(this).info(`${responseInfo} - ${retryMessage}`);
+                loggerFor(this).debug(`[${requestLogID}] response error (${retryMessage})`, formatRequestDetails({
+                    retryOfRequestLogID,
+                    url: response.url,
+                    status: response.status,
+                    headers: response.headers,
+                    durationMs: headersTime - startTime,
+                }));
+                return this.retryRequest(options, retriesRemaining, retryOfRequestLogID ?? requestLogID, response.headers);
+            }
+            const retryMessage = shouldRetry ? `error; no more retries left` : `error; not retryable`;
+            loggerFor(this).info(`${responseInfo} - ${retryMessage}`);
+            const errText = await response.text().catch((err) => castToError(err).message);
+            const errJSON = safeJSON(errText);
+            const errMessage = errJSON ? undefined : errText;
+            loggerFor(this).debug(`[${requestLogID}] response error (${retryMessage})`, formatRequestDetails({
+                retryOfRequestLogID,
+                url: response.url,
+                status: response.status,
+                headers: response.headers,
+                message: errMessage,
+                durationMs: Date.now() - startTime,
+            }));
+            const err = this.makeStatusError(response.status, errJSON, errMessage, response.headers);
+            throw err;
+        }
+        loggerFor(this).info(responseInfo);
+        loggerFor(this).debug(`[${requestLogID}] response start`, formatRequestDetails({
+            retryOfRequestLogID,
+            url: response.url,
+            status: response.status,
+            headers: response.headers,
+            durationMs: headersTime - startTime,
+        }));
+        return { response, options, controller, requestLogID, retryOfRequestLogID, startTime };
+    }
+    async fetchWithTimeout(url, init, ms, controller) {
+        const { signal, method, ...options } = init || {};
+        if (signal)
+            signal.addEventListener('abort', () => controller.abort());
+        const timeout = setTimeout(() => controller.abort(), ms);
+        const isReadableBody = (globalThis.ReadableStream && options.body instanceof globalThis.ReadableStream) ||
+            (typeof options.body === 'object' && options.body !== null && Symbol.asyncIterator in options.body);
+        const fetchOptions = {
+            signal: controller.signal,
+            ...(isReadableBody ? { duplex: 'half' } : {}),
+            method: 'GET',
+            ...options,
+        };
+        if (method) {
+            // Custom methods like 'patch' need to be uppercased
+            // See https://github.com/nodejs/undici/issues/2294
+            fetchOptions.method = method.toUpperCase();
+        }
+        try {
+            // use undefined this binding; fetch errors if bound to something else in browser/cloudflare
+            return await this.fetch.call(undefined, url, fetchOptions);
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    async shouldRetry(response) {
+        // Note this is not a standard header.
+        const shouldRetryHeader = response.headers.get('x-should-retry');
+        // If the server explicitly says whether or not to retry, obey.
+        if (shouldRetryHeader === 'true')
+            return true;
+        if (shouldRetryHeader === 'false')
+            return false;
+        // Retry on request timeouts.
+        if (response.status === 408)
+            return true;
+        // Retry on lock timeouts.
+        if (response.status === 409)
+            return true;
+        // Retry on rate limits.
+        if (response.status === 429)
+            return true;
+        // Retry internal errors.
+        if (response.status >= 500)
+            return true;
+        return false;
+    }
+    async retryRequest(options, retriesRemaining, requestLogID, responseHeaders) {
+        let timeoutMillis;
+        // Note the `retry-after-ms` header may not be standard, but is a good idea and we'd like proactive support for it.
+        const retryAfterMillisHeader = responseHeaders?.get('retry-after-ms');
+        if (retryAfterMillisHeader) {
+            const timeoutMs = parseFloat(retryAfterMillisHeader);
+            if (!Number.isNaN(timeoutMs)) {
+                timeoutMillis = timeoutMs;
+            }
+        }
+        // About the Retry-After header: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After
+        const retryAfterHeader = responseHeaders?.get('retry-after');
+        if (retryAfterHeader && !timeoutMillis) {
+            const timeoutSeconds = parseFloat(retryAfterHeader);
+            if (!Number.isNaN(timeoutSeconds)) {
+                timeoutMillis = timeoutSeconds * 1000;
+            }
+            else {
+                timeoutMillis = Date.parse(retryAfterHeader) - Date.now();
+            }
+        }
+        // If the API asks us to wait a certain amount of time (and it's a reasonable amount),
+        // just do what it says, but otherwise calculate a default
+        if (!(timeoutMillis && 0 <= timeoutMillis && timeoutMillis < 60 * 1000)) {
+            const maxRetries = options.maxRetries ?? this.maxRetries;
+            timeoutMillis = this.calculateDefaultRetryTimeoutMillis(retriesRemaining, maxRetries);
+        }
+        await sleep(timeoutMillis);
+        return this.makeRequest(options, retriesRemaining - 1, requestLogID);
+    }
+    calculateDefaultRetryTimeoutMillis(retriesRemaining, maxRetries) {
+        const initialRetryDelay = 0.5;
+        const maxRetryDelay = 8.0;
+        const numRetries = maxRetries - retriesRemaining;
+        // Apply exponential backoff, but not more than the max.
+        const sleepSeconds = Math.min(initialRetryDelay * Math.pow(2, numRetries), maxRetryDelay);
+        // Apply some jitter, take up to at most 25 percent of the retry time.
+        const jitter = 1 - Math.random() * 0.25;
+        return sleepSeconds * jitter * 1000;
+    }
+    async buildRequest(inputOptions, { retryCount = 0 } = {}) {
+        const options = { ...inputOptions };
+        const { method, path, query, defaultBaseURL } = options;
+        const url = this.buildURL(path, query, defaultBaseURL);
+        if ('timeout' in options)
+            validatePositiveInteger('timeout', options.timeout);
+        options.timeout = options.timeout ?? this.timeout;
+        const { bodyHeaders, body } = this.buildBody({ options });
+        const reqHeaders = await this.buildHeaders({ options: inputOptions, method, bodyHeaders, retryCount });
+        const req = {
+            method,
+            headers: reqHeaders,
+            ...(options.signal && { signal: options.signal }),
+            ...(globalThis.ReadableStream &&
+                body instanceof globalThis.ReadableStream && { duplex: 'half' }),
+            ...(body && { body }),
+            ...(this.fetchOptions ?? {}),
+            ...(options.fetchOptions ?? {}),
+        };
+        return { req, url, timeout: options.timeout };
+    }
+    async buildHeaders({ options, method, bodyHeaders, retryCount, }) {
+        let idempotencyHeaders = {};
+        if (this.idempotencyHeader && method !== 'get') {
+            if (!options.idempotencyKey)
+                options.idempotencyKey = this.defaultIdempotencyKey();
+            idempotencyHeaders[this.idempotencyHeader] = options.idempotencyKey;
+        }
+        const headers = buildHeaders([
+            idempotencyHeaders,
+            {
+                Accept: 'application/json',
+                'User-Agent': this.getUserAgent(),
+                'X-Stainless-Retry-Count': String(retryCount),
+                ...(options.timeout ? { 'X-Stainless-Timeout': String(Math.trunc(options.timeout / 1000)) } : {}),
+                ...getPlatformHeaders(),
+            },
+            await this.authHeaders(options),
+            this._options.defaultHeaders,
+            bodyHeaders,
+            options.headers,
+        ]);
+        this.validateHeaders(headers);
+        return headers.values;
+    }
+    buildBody({ options: { body, headers: rawHeaders } }) {
+        if (!body) {
+            return { bodyHeaders: undefined, body: undefined };
+        }
+        const headers = buildHeaders([rawHeaders]);
+        if (
+        // Pass raw type verbatim
+        ArrayBuffer.isView(body) ||
+            body instanceof ArrayBuffer ||
+            body instanceof DataView ||
+            (typeof body === 'string' &&
+                // Preserve legacy string encoding behavior for now
+                headers.values.has('content-type')) ||
+            // `Blob` is superset of `File`
+            (globalThis.Blob && body instanceof globalThis.Blob) ||
+            // `FormData` -> `multipart/form-data`
+            body instanceof FormData ||
+            // `URLSearchParams` -> `application/x-www-form-urlencoded`
+            body instanceof URLSearchParams ||
+            // Send chunked stream (each chunk has own `length`)
+            (globalThis.ReadableStream && body instanceof globalThis.ReadableStream)) {
+            return { bodyHeaders: undefined, body: body };
+        }
+        else if (typeof body === 'object' &&
+            (Symbol.asyncIterator in body ||
+                (Symbol.iterator in body && 'next' in body && typeof body.next === 'function'))) {
+            return { bodyHeaders: undefined, body: Shims.ReadableStreamFrom(body) };
+        }
+        else {
+            return __classPrivateFieldGet(this, _Camara_encoder, "f").call(this, { body, headers });
+        }
+    }
+}
+_a = Camara, _Camara_encoder = new WeakMap(), _Camara_instances = new WeakSet(), _Camara_baseURLOverridden = function _Camara_baseURLOverridden() {
+    return this.baseURL !== 'https://api.example.com/camara';
+};
+Camara.Camara = _a;
+Camara.DEFAULT_TIMEOUT = 60000; // 1 minute
+Camara.CamaraError = Errors.CamaraError;
+Camara.APIError = Errors.APIError;
+Camara.APIConnectionError = Errors.APIConnectionError;
+Camara.APIConnectionTimeoutError = Errors.APIConnectionTimeoutError;
+Camara.APIUserAbortError = Errors.APIUserAbortError;
+Camara.NotFoundError = Errors.NotFoundError;
+Camara.ConflictError = Errors.ConflictError;
+Camara.RateLimitError = Errors.RateLimitError;
+Camara.BadRequestError = Errors.BadRequestError;
+Camara.AuthenticationError = Errors.AuthenticationError;
+Camara.InternalServerError = Errors.InternalServerError;
+Camara.PermissionDeniedError = Errors.PermissionDeniedError;
+Camara.UnprocessableEntityError = Errors.UnprocessableEntityError;
+Camara.toFile = Uploads.toFile;
+Camara.Customerinsights = Customerinsights;
+Camara.Deviceswap = Deviceswap;
+Camara.Knowyourcustomerageverification = Knowyourcustomerageverification;
+Camara.KnowyourcustomerfillIn = KnowyourcustomerfillIn;
+Camara.Knowyourcustomermatch = Knowyourcustomermatch;
+Camara.Tenure = Tenure;
+Camara.Numberrecycling = Numberrecycling;
+Camara.Otpvalidation = Otpvalidation;
+Camara.Callforwardingsignal = Callforwardingsignal;
+Camara.Devicelocation = Devicelocation;
+Camara.Populationdensitydata = Populationdensitydata;
+Camara.Regiondevicecount = Regiondevicecount;
+Camara.Webrtc = Webrtc;
+Camara.Connectivityinsights = Connectivityinsights;
+Camara.Qualityondemand = Qualityondemand;
+Camara.Deviceidentifier = Deviceidentifier;
+Camara.Simswap = Simswap;
+Camara.Deviceroamingstatus = Deviceroamingstatus;
+Camara.Devicereachabilitystatus = Devicereachabilitystatus;
+Camara.Connectednetworktype = Connectednetworktype;
+//# sourceMappingURL=client.mjs.map