@sinch/sdk-client 1.4.2 → 1.6.0

package/dist/client/api-fetch-client.js

@@ -1,16 +1,16 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ApiFetchClient = void 0;
 const version_1 = require("../plugins/version");
 const exception_1 = require("../plugins/exception");
 const api_client_1 = require("../api/api-client");
 const api_errors_1 = require("../api/api-errors");
-const node_fetch_1 = __importDefault(require("node-fetch"));
 const api_client_helpers_1 = require("./api-client-helpers");
+const logger_1 = require("../logger");
+const domain_1 = require("../domain");
+const fetch_1 = require("../http/fetch");
 const api_client_pagination_helper_1 = require("./api-client-pagination-helper");
+const retry_policy_1 = require("./retry-policy");
 /** Client to process the call to the API using Fetch API */
 class ApiFetchClient extends api_client_1.ApiClient {
     /**
@@ -21,14 +21,25 @@ class ApiFetchClient extends api_client_1.ApiClient {
      * @param {ApiClientOptions} options - Configuration options for the API Client.
      */
     constructor(options) {
-        super({
+        const logger = (0, logger_1.resolveLogger)(options.logger);
+        const retry = (0, retry_policy_1.resolveRetryConfig)(options);
+        const resolvedOptions = {
             ...options,
-            requestPlugins: [new version_1.VersionRequest(), ...(options.requestPlugins || [])],
+            logger,
+            timeoutSeconds: (0, domain_1.resolveTimeoutSeconds)(options.timeoutSeconds),
+            retryPolicy: retry.retryPolicy,
+            maxRetryCount: retry.maxRetryCount,
+            exponentialBackoff: retry.exponentialBackoff,
+        };
+        super({
+            ...resolvedOptions,
+            requestPlugins: [new version_1.VersionRequest(), ...(resolvedOptions.requestPlugins || [])],
             responsePlugins: [
-                new exception_1.ExceptionResponse(),
-                ...(options.responsePlugins || []),
+                new exception_1.ExceptionResponse(undefined),
+                ...(resolvedOptions.responsePlugins || []),
             ],
         });
+        this.httpTransport = new fetch_1.FetchHttpTransport();
     }
     /** @inheritdoc */
     async processCall(apiCallParameters) {
@@ -54,10 +65,11 @@ class ApiFetchClient extends api_client_1.ApiClient {
     async executeRequest(apiCallParameters, isFileDownload = false) {
         const errorContext = (0, api_client_helpers_1.buildErrorContext)(apiCallParameters);
         try {
-            const response = await this.sinchFetch(apiCallParameters, errorContext);
-            const body = isFileDownload ? undefined : await response.text();
+            const httpResponse = await this.sinchFetch(apiCallParameters, errorContext);
+            const body = isFileDownload ? undefined : await httpResponse.content.asString();
             return {
-                response,
+                httpResponse,
+                response: this.httpTransport.getNativeResponse(httpResponse),
                 body,
                 apiCallParameters,
                 errorContext,
@@ -68,6 +80,7 @@ class ApiFetchClient extends api_client_1.ApiClient {
         }
     }
     async processResponse(context) {
+        this.logFailedResponse(context);
         const pluginContext = await this.parseAndValidateResponse(context);
         const transformedResponse = await this.applyResponsePlugins(pluginContext);
         if (pluginContext.exception) {
@@ -87,47 +100,66 @@ class ApiFetchClient extends api_client_1.ApiClient {
         return { result, exception, responseContext: context };
     }
     async processFileResponse(context) {
-        if (!context.response || !context.response.ok) {
-            throw this.buildFetchError(new Error('No response received'), context.errorContext);
+        if (!context.response.ok) {
+            throw this.buildFetchError(new Error(`HTTP ${context.httpResponse.status}`), context.errorContext);
         }
-        const buffer = await context.response.buffer();
-        const fileName = this.extractFileName(context.response.headers, 'pdf');
+        const buffer = await context.httpResponse.content.asBytes();
+        const fileName = this.extractFileName(context.httpResponse.headers, 'pdf');
         if (!buffer || !fileName) {
             throw new Error('An error occurred while downloading the file');
         }
         return { fileName, buffer };
     }
     async processCSVResponse(context) {
-        if (!context.response || !context.response.ok) {
-            throw this.buildFetchError(new Error('No response received'), context.errorContext);
+        if (!context.response.ok) {
+            throw this.buildFetchError(new Error(`HTTP ${context.httpResponse.status}`), context.errorContext);
         }
-        const responseText = await context.response.text();
-        const fileName = this.extractFileName(context.response.headers, 'csv');
+        const responseText = await context.httpResponse.content.asString();
+        const fileName = this.extractFileName(context.httpResponse.headers, 'csv');
         if (!responseText || !fileName) {
             throw new Error('An error occurred while downloading the file');
         }
         return { fileName, data: responseText };
     }
     /**
-     * Handle fetch request with token refresh mechanism
+     * Handle fetch request with token refresh and retry.
      * @param {ApiCallParameters} apiCallParameters
      * @param {ErrorContext} errorContext
      */
     async sinchFetch(apiCallParameters, errorContext) {
-        let response = await (0, node_fetch_1.default)(apiCallParameters.url, apiCallParameters.requestOptions);
-        if (this.isTokenExpired(response)) {
+        const retryConfig = (0, retry_policy_1.resolveRetryConfig)(this.apiClientOptions);
+        let requestOptions = apiCallParameters.requestOptions;
+        let httpRequest = (0, fetch_1.toHttpRequest)(apiCallParameters, requestOptions);
+        let httpResponse = await this.send(httpRequest, requestOptions.timeout);
+        if (this.isTokenExpired(httpResponse)) {
             // Capture the JWT used by the failing request so the OAuth2 plugin can
             // refuse to clear a cached token that has since been refreshed by another caller.
-            const failingAuth = apiCallParameters.requestOptions.headers.get('Authorization') || '';
-            const failingJwt = failingAuth.startsWith('Bearer ') ? failingAuth.slice('Bearer '.length) : undefined;
-            const requestOptions = await (0, api_client_helpers_1.manageExpiredToken)(apiCallParameters, errorContext, this.apiClientOptions.requestPlugins, failingJwt);
-            response = await (0, node_fetch_1.default)(apiCallParameters.url, requestOptions);
+            const failingAuth = httpRequest.headers.getAll('Authorization')[0] || '';
+            const failingJwt = failingAuth.startsWith('Bearer ')
+                ? failingAuth.slice('Bearer '.length)
+                : undefined;
+            this.httpTransport.release(httpResponse);
+            requestOptions = await (0, api_client_helpers_1.manageExpiredToken)(apiCallParameters, errorContext, this.apiClientOptions.requestPlugins, failingJwt);
+            httpRequest = (0, fetch_1.toHttpRequest)(apiCallParameters, requestOptions);
+            httpResponse = await this.send(httpRequest, requestOptions.timeout);
+        }
+        for (let attempt = 0;; attempt++) {
+            const retryAfterMs = (0, retry_policy_1.parseRetryAfterMs)(httpResponse.headers.getAll('retry-after')[0]);
+            if (!(0, retry_policy_1.shouldRetryRateLimit)(httpResponse.status, attempt, retryConfig, retryAfterMs)) {
+                break;
+            }
+            await (0, retry_policy_1.sleep)((0, retry_policy_1.computeRateLimitBackoffMs)(attempt, retryConfig, retryAfterMs));
+            this.httpTransport.release(httpResponse);
+            httpResponse = await this.send(httpRequest, requestOptions.timeout);
         }
-        return response;
+        return httpResponse;
     }
-    isTokenExpired(response) {
-        return response.status === 401
-            && response.headers.get('www-authenticate')?.includes('expired') === true;
+    send(request, timeout) {
+        return this.httpTransport.send(request, { timeout });
+    }
+    isTokenExpired(httpResponse) {
+        return httpResponse.status === 401
+            && httpResponse.headers.getAll('www-authenticate')[0]?.includes('expired') === true;
     }
     async applyResponsePlugins(context) {
         const plugins = this.loadResponsePlugins(this.apiClientOptions.responsePlugins, context.responseContext);
@@ -157,6 +189,20 @@ class ApiFetchClient extends api_client_1.ApiClient {
             nextPage: () => (0, api_client_pagination_helper_1.createNextPageMethod)(this, paginationContext, apiCallParameters.requestOptions, nextPage),
         };
     }
+    logFailedResponse(context) {
+        if (!context.response.ok) {
+            const { apiCallParameters } = context;
+            this.apiClientOptions.logger.debug(() => `[${apiCallParameters.apiName}][${apiCallParameters.operationId}][${context.httpResponse.status}]\n`
+                + `HTTP method: ${apiCallParameters.requestOptions.method}\n`
+                + `URL: ${apiCallParameters.url}\n`
+                + `Response Headers: ${this.formatResponseHeaders(context.httpResponse.headers)}`);
+        }
+    }
+    formatResponseHeaders(headers) {
+        return [...headers.entries()]
+            .map(([key, value]) => `${key}=${String(value)}`)
+            .join(', ');
+    }
     buildFetchError(error, errorContext) {
         if (error instanceof api_errors_1.GenericError) {
             return new api_errors_1.GenericError(error.message, errorContext);
@@ -166,7 +212,7 @@ class ApiFetchClient extends api_client_1.ApiClient {
         }
     }
     extractFileName(headers, extension) {
-        const contentDisposition = headers.get('content-disposition');
+        const contentDisposition = headers.getAll('content-disposition')[0];
         let fileName = 'default-name.' + extension;
         if (contentDisposition) {
             // Support both quoted and unquoted filenames

package/dist/client/api-fetch-client.js.map

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

package/dist/client/index.d.ts

@@ -1,2 +1,3 @@
 export * from './api-fetch-client';
 export * from './api-client-pagination-helper';
+export * from './lazy-api-client';

package/dist/client/index.js

@@ -16,4 +16,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./api-fetch-client"), exports);
 __exportStar(require("./api-client-pagination-helper"), exports);
+__exportStar(require("./lazy-api-client"), exports);
 //# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,iEAA+C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,iEAA+C;AAC/C,oDAAkC"}

package/dist/client/lazy-api-client.d.ts

@@ -0,0 +1,9 @@
+import { ResolvedSinchClientParameters } from '../domain';
+import { ApiFetchClient } from './api-fetch-client';
+/** @internal Base class for domain lazy clients that share resolved SDK configuration. */
+export declare abstract class LazyApiClient {
+    apiFetchClient?: ApiFetchClient;
+    sharedConfig: ResolvedSinchClientParameters;
+    constructor(sharedConfig: ResolvedSinchClientParameters);
+    resetApiClient(): void;
+}

package/dist/client/lazy-api-client.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LazyApiClient = void 0;
+/** @internal Base class for domain lazy clients that share resolved SDK configuration. */
+class LazyApiClient {
+    constructor(sharedConfig) {
+        this.sharedConfig = sharedConfig;
+    }
+    resetApiClient() {
+        this.apiFetchClient = undefined;
+    }
+}
+exports.LazyApiClient = LazyApiClient;
+//# sourceMappingURL=lazy-api-client.js.map

package/dist/client/lazy-api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy-api-client.js","sourceRoot":"","sources":["../../src/client/lazy-api-client.ts"],"names":[],"mappings":";;;AAGA,0FAA0F;AAC1F;IAIE,YAAY,YAA2C;QACrD,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAEM,cAAc;QACnB,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;IAClC,CAAC;CACF"}

package/dist/client/retry-policy.d.ts

@@ -0,0 +1,33 @@
+import { SupportedRetryPolicy, WithRetryPolicy } from '../domain';
+/** Base delay for full-jitter exponential backoff (1 second). */
+export declare const RATE_LIMIT_RETRY_BASE_MS = 1000;
+/** @internal */
+export interface ResolvedRetryConfig {
+    retryPolicy: SupportedRetryPolicy;
+    maxRetryCount: number;
+    exponentialBackoff: number;
+}
+/** @internal */
+export declare const resolveRetryConfig: (partial?: WithRetryPolicy) => ResolvedRetryConfig;
+/**
+ * Parse an RFC 7231 `Retry-After` value (delta-seconds or HTTP-date) to milliseconds.
+ * Negative delta-seconds are ignored. Returns undefined when the value is absent or invalid.
+ */
+/** @internal */
+export declare const parseRetryAfterMs: (value: string | null | undefined) => number | undefined;
+/**
+ * Whether the SDK should retry this response for the given attempt index (0 = first retry).
+ * `retryAfterMs` is the already-parsed `Retry-After` delay (undefined if absent/invalid).
+ */
+/** @internal */
+export declare const shouldRetryRateLimit: (status: number, attempt: number, config: ResolvedRetryConfig, retryAfterMs?: number) => boolean;
+/**
+ * Backoff delay for a rate-limit retry, respecting the configured policy.
+ * - DEFAULT: Retry-After (+ 0–250ms jitter) when parseable, else full-jitter exponential
+ * - RETRY_AFTER: Retry-After (+ jitter) only (caller must have validated the header)
+ * - BACKOFF: full-jitter exponential only
+ */
+/** @internal */
+export declare const computeRateLimitBackoffMs: (attempt: number, config: ResolvedRetryConfig, retryAfterMs?: number) => number;
+/** @internal */
+export declare const sleep: (ms: number) => Promise<void>;

package/dist/client/retry-policy.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sleep = exports.computeRateLimitBackoffMs = exports.shouldRetryRateLimit = exports.parseRetryAfterMs = exports.resolveRetryConfig = exports.RATE_LIMIT_RETRY_BASE_MS = void 0;
+const domain_1 = require("../domain");
+/** Base delay for full-jitter exponential backoff (1 second). */
+exports.RATE_LIMIT_RETRY_BASE_MS = 1_000;
+const DEFAULT_MAX_RETRY_COUNT = 3;
+const DEFAULT_EXPONENTIAL_BACKOFF = 4;
+const isSupportedRetryPolicy = (value) => value === domain_1.SupportedRetryPolicy.DEFAULT
+    || value === domain_1.SupportedRetryPolicy.RETRY_AFTER
+    || value === domain_1.SupportedRetryPolicy.BACKOFF
+    || value === domain_1.SupportedRetryPolicy.NONE;
+/** @internal */
+const resolveRetryConfig = (partial) => {
+    const retryPolicy = partial?.retryPolicy ?? domain_1.SupportedRetryPolicy.DEFAULT;
+    if (!isSupportedRetryPolicy(retryPolicy)) {
+        throw new Error('Invalid configuration: "retryPolicy" must be DEFAULT, RETRY_AFTER, BACKOFF, or NONE');
+    }
+    const maxRetryCount = partial?.maxRetryCount ?? DEFAULT_MAX_RETRY_COUNT;
+    if (!Number.isInteger(maxRetryCount) || maxRetryCount < 0) {
+        throw new Error('Invalid configuration: "maxRetryCount" must be a non-negative integer');
+    }
+    const exponentialBackoff = partial?.exponentialBackoff ?? DEFAULT_EXPONENTIAL_BACKOFF;
+    if (!Number.isFinite(exponentialBackoff) || exponentialBackoff <= 0) {
+        throw new Error('Invalid configuration: "exponentialBackoff" must be a positive number');
+    }
+    return { retryPolicy, maxRetryCount, exponentialBackoff };
+};
+exports.resolveRetryConfig = resolveRetryConfig;
+/**
+ * ANSI C asctime() form from RFC 7231 §7.1.1.1 (`Sun Nov  6 08:49:37 1994`).
+ * It has no timezone; the spec treats it as GMT. `Date.parse` otherwise uses local time.
+ */
+const ASCTIME_HTTP_DATE = /^[A-Za-z]{3} [A-Za-z]{3} [\d ]\d \d{2}:\d{2}:\d{2} \d{4}$/;
+const toParseableHttpDate = (value) => ASCTIME_HTTP_DATE.test(value) ? `${value} GMT` : value;
+/**
+ * Parse an RFC 7231 `Retry-After` value (delta-seconds or HTTP-date) to milliseconds.
+ * Negative delta-seconds are ignored. Returns undefined when the value is absent or invalid.
+ */
+/** @internal */
+const parseRetryAfterMs = (value) => {
+    if (value === null || value === undefined) {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    if (trimmed === '') {
+        return undefined;
+    }
+    const asNumber = Number(trimmed);
+    if (Number.isFinite(asNumber)) {
+        // Negative delta-seconds are ignored per the retry policy spec.
+        if (asNumber < 0) {
+            return undefined;
+        }
+        return Math.floor(asNumber * 1000);
+    }
+    const asDate = Date.parse(toParseableHttpDate(trimmed));
+    if (!Number.isNaN(asDate)) {
+        return Math.max(0, asDate - Date.now());
+    }
+    return undefined;
+};
+exports.parseRetryAfterMs = parseRetryAfterMs;
+/**
+ * Whether the SDK should retry this response for the given attempt index (0 = first retry).
+ * `retryAfterMs` is the already-parsed `Retry-After` delay (undefined if absent/invalid).
+ */
+/** @internal */
+const shouldRetryRateLimit = (status, attempt, config, retryAfterMs) => {
+    if (status !== 429) {
+        return false;
+    }
+    if (config.retryPolicy === domain_1.SupportedRetryPolicy.NONE) {
+        return false;
+    }
+    if (attempt >= config.maxRetryCount) {
+        return false;
+    }
+    if (config.retryPolicy === domain_1.SupportedRetryPolicy.RETRY_AFTER) {
+        return retryAfterMs !== undefined;
+    }
+    return config.retryPolicy === domain_1.SupportedRetryPolicy.DEFAULT
+        || config.retryPolicy === domain_1.SupportedRetryPolicy.BACKOFF;
+};
+exports.shouldRetryRateLimit = shouldRetryRateLimit;
+/**
+ * Backoff delay for a rate-limit retry, respecting the configured policy.
+ * - DEFAULT: Retry-After (+ 0–250ms jitter) when parseable, else full-jitter exponential
+ * - RETRY_AFTER: Retry-After (+ jitter) only (caller must have validated the header)
+ * - BACKOFF: full-jitter exponential only
+ */
+/** @internal */
+const computeRateLimitBackoffMs = (attempt, config, retryAfterMs) => {
+    const useRetryAfter = config.retryPolicy === domain_1.SupportedRetryPolicy.DEFAULT
+        || config.retryPolicy === domain_1.SupportedRetryPolicy.RETRY_AFTER;
+    const useBackoff = config.retryPolicy === domain_1.SupportedRetryPolicy.DEFAULT
+        || config.retryPolicy === domain_1.SupportedRetryPolicy.BACKOFF;
+    if (useRetryAfter && retryAfterMs !== undefined) {
+        // Small jitter so concurrent SinchClient instances don't all wake together.
+        return retryAfterMs + Math.floor(Math.random() * 250);
+    }
+    if (useBackoff) {
+        const ceilingMs = exports.RATE_LIMIT_RETRY_BASE_MS * Math.pow(config.exponentialBackoff, attempt);
+        return Math.floor(Math.random() * ceilingMs);
+    }
+    return 0;
+};
+exports.computeRateLimitBackoffMs = computeRateLimitBackoffMs;
+/** @internal */
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+exports.sleep = sleep;
+//# sourceMappingURL=retry-policy.js.map

package/dist/client/retry-policy.js.map

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

package/dist/domain/domain-helper.d.ts

@@ -1,14 +1,29 @@
+/** @internal */
 export declare const REGION_PATTERN = "{region}";
+/** @internal */
 export declare const AUTH_HOSTNAME = "https://auth.sinch.com";
+/** @internal */
 export declare const CONVERSATION_HOSTNAME = "https://{region}conversation.api.sinch.com";
+/** @internal */
 export declare const CONVERSATION_TEMPLATES_HOSTNAME = "https://{region}template.api.sinch.com";
+/** @internal @deprecated Elastic SIP Trunking support will be removed in version 2 of the SDK. */
 export declare const ELASTIC_SIP_TRUNKING_HOSTNAME = "https://elastic-trunking.api.sinch.com";
+/** @internal */
 export declare const FAX_HOSTNAME = "https://fax.api.sinch.com";
+/** @internal @deprecated*/
 export declare const MAILGUN_HOSTNAME = "https://api.{region}mailgun.net";
+/** @internal */
 export declare const NUMBERS_HOSTNAME = "https://numbers.api.sinch.com";
+/** @internal */
 export declare const SMS_HOSTNAME = "https://{region}sms.api.sinch.com";
+/** @internal */
 export declare const VERIFICATION_HOSTNAME = "https://verification.api.sinch.com";
+/** @internal */
 export declare const VOICE_HOSTNAME = "https://calling{region}.api.sinch.com";
+/** @internal */
 export declare const VOICE_APPLICATION_MANAGEMENT_HOSTNAME = "https://callingapi.sinch.com";
+/** @internal */
 export declare const NUMBER_LOOKUP_HOSTNAME = "https://lookup.api.sinch.com";
+export declare const PROVISIONING_HOSTNAME = "https://provisioning.api.sinch.com";
+/** @internal */
 export declare const formatRegionalizedHostname: (hostnamePattern: string, region: string) => string;

package/dist/domain/domain-helper.js

@@ -1,19 +1,34 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatRegionalizedHostname = exports.NUMBER_LOOKUP_HOSTNAME = exports.VOICE_APPLICATION_MANAGEMENT_HOSTNAME = exports.VOICE_HOSTNAME = exports.VERIFICATION_HOSTNAME = exports.SMS_HOSTNAME = exports.NUMBERS_HOSTNAME = exports.MAILGUN_HOSTNAME = exports.FAX_HOSTNAME = exports.ELASTIC_SIP_TRUNKING_HOSTNAME = exports.CONVERSATION_TEMPLATES_HOSTNAME = exports.CONVERSATION_HOSTNAME = exports.AUTH_HOSTNAME = exports.REGION_PATTERN = void 0;
+exports.formatRegionalizedHostname = exports.PROVISIONING_HOSTNAME = exports.NUMBER_LOOKUP_HOSTNAME = exports.VOICE_APPLICATION_MANAGEMENT_HOSTNAME = exports.VOICE_HOSTNAME = exports.VERIFICATION_HOSTNAME = exports.SMS_HOSTNAME = exports.NUMBERS_HOSTNAME = exports.MAILGUN_HOSTNAME = exports.FAX_HOSTNAME = exports.ELASTIC_SIP_TRUNKING_HOSTNAME = exports.CONVERSATION_TEMPLATES_HOSTNAME = exports.CONVERSATION_HOSTNAME = exports.AUTH_HOSTNAME = exports.REGION_PATTERN = void 0;
+/** @internal */
 exports.REGION_PATTERN = '{region}';
+/** @internal */
 exports.AUTH_HOSTNAME = 'https://auth.sinch.com';
+/** @internal */
 exports.CONVERSATION_HOSTNAME = `https://${exports.REGION_PATTERN}conversation.api.sinch.com`;
+/** @internal */
 exports.CONVERSATION_TEMPLATES_HOSTNAME = `https://${exports.REGION_PATTERN}template.api.sinch.com`;
+/** @internal @deprecated Elastic SIP Trunking support will be removed in version 2 of the SDK. */
 exports.ELASTIC_SIP_TRUNKING_HOSTNAME = 'https://elastic-trunking.api.sinch.com';
+/** @internal */
 exports.FAX_HOSTNAME = 'https://fax.api.sinch.com';
+/** @internal @deprecated*/
 exports.MAILGUN_HOSTNAME = `https://api.${exports.REGION_PATTERN}mailgun.net`;
+/** @internal */
 exports.NUMBERS_HOSTNAME = 'https://numbers.api.sinch.com';
+/** @internal */
 exports.SMS_HOSTNAME = `https://${exports.REGION_PATTERN}sms.api.sinch.com`;
+/** @internal */
 exports.VERIFICATION_HOSTNAME = 'https://verification.api.sinch.com';
+/** @internal */
 exports.VOICE_HOSTNAME = `https://calling${exports.REGION_PATTERN}.api.sinch.com`;
+/** @internal */
 exports.VOICE_APPLICATION_MANAGEMENT_HOSTNAME = 'https://callingapi.sinch.com';
+/** @internal */
 exports.NUMBER_LOOKUP_HOSTNAME = 'https://lookup.api.sinch.com';
+exports.PROVISIONING_HOSTNAME = 'https://provisioning.api.sinch.com';
+/** @internal */
 const formatRegionalizedHostname = (hostnamePattern, region) => {
     return hostnamePattern.replace(exports.REGION_PATTERN, region);
 };

package/dist/domain/domain-helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"domain-helper.js","sourceRoot":"","sources":["../../src/domain/domain-helper.ts"],"names":[],"mappings":";;;AAAa,QAAA,cAAc,GAAG,UAAU,CAAC;AAE5B,QAAA,aAAa,GAAG,wBAAwB,CAAC;AACzC,QAAA,qBAAqB,GAAG,WAAW,sBAAc,4BAA4B,CAAC;AAC9E,QAAA,+BAA+B,GAAG,WAAW,sBAAc,wBAAwB,CAAC;AACpF,QAAA,6BAA6B,GAAG,wCAAwC,CAAC;AACzE,QAAA,YAAY,GAAG,2BAA2B,CAAC;AAC3C,QAAA,gBAAgB,GAAG,eAAe,sBAAc,aAAa,CAAC;AAC9D,QAAA,gBAAgB,GAAG,+BAA+B,CAAC;AACnD,QAAA,YAAY,GAAG,WAAW,sBAAc,mBAAmB,CAAC;AAC5D,QAAA,qBAAqB,GAAG,oCAAoC,CAAC;AAC7D,QAAA,cAAc,GAAG,kBAAkB,sBAAc,gBAAgB,CAAC;AAClE,QAAA,qCAAqC,GAAG,8BAA8B,CAAC;AACvE,QAAA,sBAAsB,GAAG,8BAA8B,CAAC;AAE9D,MAAM,0BAA0B,GAAG,CAAC,eAAuB,EAAE,MAAc,EAAE,EAAE;IACpF,OAAO,eAAe,CAAC,OAAO,CAAC,sBAAc,EAAE,MAAM,CAAC,CAAC;AACzD,CAAC,CAAC;AAFW,QAAA,0BAA0B,8BAErC"}
+{"version":3,"file":"domain-helper.js","sourceRoot":"","sources":["../../src/domain/domain-helper.ts"],"names":[],"mappings":";;;AAAA,gBAAgB;AACH,QAAA,cAAc,GAAG,UAAU,CAAC;AAEzC,gBAAgB;AACH,QAAA,aAAa,GAAG,wBAAwB,CAAC;AACtD,gBAAgB;AACH,QAAA,qBAAqB,GAAG,WAAW,QAAA,cAAc,4BAA4B,CAAC;AAC3F,gBAAgB;AACH,QAAA,+BAA+B,GAAG,WAAW,QAAA,cAAc,wBAAwB,CAAC;AACjG,kGAAkG;AACrF,QAAA,6BAA6B,GAAG,wCAAwC,CAAC;AACtF,gBAAgB;AACH,QAAA,YAAY,GAAG,2BAA2B,CAAC;AACxD,2BAA2B;AACd,QAAA,gBAAgB,GAAG,eAAe,QAAA,cAAc,aAAa,CAAC;AAC3E,gBAAgB;AACH,QAAA,gBAAgB,GAAG,+BAA+B,CAAC;AAChE,gBAAgB;AACH,QAAA,YAAY,GAAG,WAAW,QAAA,cAAc,mBAAmB,CAAC;AACzE,gBAAgB;AACH,QAAA,qBAAqB,GAAG,oCAAoC,CAAC;AAC1E,gBAAgB;AACH,QAAA,cAAc,GAAG,kBAAkB,QAAA,cAAc,gBAAgB,CAAC;AAC/E,gBAAgB;AACH,QAAA,qCAAqC,GAAG,8BAA8B,CAAC;AACpF,gBAAgB;AACH,QAAA,sBAAsB,GAAG,8BAA8B,CAAC;AACxD,QAAA,qBAAqB,GAAG,oCAAoC,CAAC;AAE1E,gBAAgB;AACT,MAAM,0BAA0B,GAAG,CAAC,eAAuB,EAAE,MAAc,EAAE,EAAE;IACpF,OAAO,eAAe,CAAC,OAAO,CAAC,QAAA,cAAc,EAAE,MAAM,CAAC,CAAC;AACzD,CAAC,CAAC;AAFW,QAAA,0BAA0B,GAA1B,0BAA0B,CAErC"}