@tryfinch/finch-api 1.1.0 → 3.0.0

package/core.js

@@ -0,0 +1,683 @@
+'use strict';
+var __createBinding =
+  (this && this.__createBinding) ||
+  (Object.create ?
+    function (o, m, k, k2) {
+      if (k2 === undefined) k2 = k;
+      var desc = Object.getOwnPropertyDescriptor(m, k);
+      if (!desc || ('get' in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+        desc = {
+          enumerable: true,
+          get: function () {
+            return m[k];
+          },
+        };
+      }
+      Object.defineProperty(o, k2, desc);
+    }
+  : function (o, m, k, k2) {
+      if (k2 === undefined) k2 = k;
+      o[k2] = m[k];
+    });
+var __setModuleDefault =
+  (this && this.__setModuleDefault) ||
+  (Object.create ?
+    function (o, v) {
+      Object.defineProperty(o, 'default', { enumerable: true, value: v });
+    }
+  : function (o, v) {
+      o['default'] = v;
+    });
+var __importStar =
+  (this && this.__importStar) ||
+  function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null)
+      for (var k in mod)
+        if (k !== 'default' && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+  };
+var __classPrivateFieldSet =
+  (this && this.__classPrivateFieldSet) ||
+  function (receiver, state, value, kind, f) {
+    if (kind === 'm') throw new TypeError('Private method is not writable');
+    if (kind === 'a' && !f) throw new TypeError('Private accessor was defined without a setter');
+    if (typeof state === 'function' ? receiver !== state || !f : !state.has(receiver))
+      throw new TypeError('Cannot write private member to an object whose class did not declare it');
+    return (
+      kind === 'a' ? f.call(receiver, value)
+      : f ? (f.value = value)
+      : state.set(receiver, value),
+      value
+    );
+  };
+var __classPrivateFieldGet =
+  (this && this.__classPrivateFieldGet) ||
+  function (receiver, state, kind, f) {
+    if (kind === 'a' && !f) throw new TypeError('Private accessor was defined without a getter');
+    if (typeof state === 'function' ? receiver !== state || !f : !state.has(receiver))
+      throw new TypeError('Cannot read private member from an object whose class did not declare it');
+    return (
+      kind === 'm' ? f
+      : kind === 'a' ? f.call(receiver)
+      : f ? f.value
+      : state.get(receiver)
+    );
+  };
+var _AbstractPage_client;
+Object.defineProperty(exports, '__esModule', { value: true });
+exports.getHeader =
+  exports.isHeadersProtocol =
+  exports.hasOwn =
+  exports.isEmptyObj =
+  exports.coerceBoolean =
+  exports.coerceFloat =
+  exports.coerceInteger =
+  exports.ensurePresent =
+  exports.castToError =
+  exports.safeJSON =
+  exports.isRequestOptions =
+  exports.createResponseHeaders =
+  exports.PagePromise =
+  exports.AbstractPage =
+  exports.APIResource =
+  exports.APIClient =
+  exports.createForm =
+  exports.multipartFormRequestOptions =
+  exports.maybeMultipartFormRequestOptions =
+    void 0;
+const qs = __importStar(require('qs'));
+const version_1 = require('./version.js');
+const streaming_1 = require('./streaming.js');
+const error_1 = require('./error.js');
+const agent_1 = require('@tryfinch/finch-api/_shims/agent');
+const fetch_1 = require('@tryfinch/finch-api/_shims/fetch');
+const uploads_1 = require('./uploads.js');
+var uploads_2 = require('./uploads.js');
+Object.defineProperty(exports, 'maybeMultipartFormRequestOptions', {
+  enumerable: true,
+  get: function () {
+    return uploads_2.maybeMultipartFormRequestOptions;
+  },
+});
+Object.defineProperty(exports, 'multipartFormRequestOptions', {
+  enumerable: true,
+  get: function () {
+    return uploads_2.multipartFormRequestOptions;
+  },
+});
+Object.defineProperty(exports, 'createForm', {
+  enumerable: true,
+  get: function () {
+    return uploads_2.createForm;
+  },
+});
+const MAX_RETRIES = 2;
+class APIClient {
+  constructor({
+    baseURL,
+    maxRetries,
+    timeout = 60 * 1000, // 60s
+    httpAgent,
+  }) {
+    this.baseURL = baseURL;
+    this.maxRetries = validatePositiveInteger(
+      'maxRetries',
+      maxRetries !== null && maxRetries !== void 0 ? maxRetries : MAX_RETRIES,
+    );
+    this.timeout = validatePositiveInteger('timeout', timeout);
+    this.httpAgent = httpAgent;
+    this.fetch = fetch_1.fetch;
+  }
+  authHeaders() {
+    return {};
+  }
+  /**
+   * Override this to add your own default headers, for example:
+   *
+   *  {
+   *    ...super.defaultHeaders(),
+   *    Authorization: 'Bearer 123',
+   *  }
+   */
+  defaultHeaders() {
+    return {
+      Accept: 'application/json',
+      'Content-Type': 'application/json',
+      'User-Agent': this.getUserAgent(),
+      ...getPlatformHeaders(),
+      ...this.authHeaders(),
+    };
+  }
+  /**
+   * Override this to add your own headers validation:
+   */
+  validateHeaders(headers, customHeaders) {}
+  /**
+   * Override this to add your own qs.stringify options, for example:
+   *
+   *  {
+   *    ...super.qsOptions(),
+   *    strictNullHandling: true,
+   *  }
+   */
+  qsOptions() {
+    return {};
+  }
+  defaultIdempotencyKey() {
+    return `stainless-node-retry-${uuid4()}`;
+  }
+  get(path, opts) {
+    return this.request({ method: 'get', path, ...opts });
+  }
+  post(path, opts) {
+    return this.request({ method: 'post', path, ...opts });
+  }
+  patch(path, opts) {
+    return this.request({ method: 'patch', path, ...opts });
+  }
+  put(path, opts) {
+    return this.request({ method: 'put', path, ...opts });
+  }
+  delete(path, opts) {
+    return this.request({ method: 'delete', path, ...opts });
+  }
+  getAPIList(path, Page, opts) {
+    return this.requestAPIList(Page, { method: 'get', path, ...opts });
+  }
+  buildRequest(options) {
+    var _a, _b, _c;
+    const { method, path, query, headers: headers = {} } = options;
+    const body =
+      (0, uploads_1.isMultipartBody)(options.body) ? options.body.body
+      : options.body ? JSON.stringify(options.body, null, 2)
+      : null;
+    const contentLength = typeof body === 'string' ? body.length.toString() : null;
+    const url = this.buildURL(path, query);
+    const httpAgent =
+      (
+        (_b = (_a = options.httpAgent) !== null && _a !== void 0 ? _a : this.httpAgent) !== null &&
+        _b !== void 0
+      ) ?
+        _b
+      : (0, agent_1.getDefaultAgent)(url);
+    const timeout = (_c = options.timeout) !== null && _c !== void 0 ? _c : this.timeout;
+    validatePositiveInteger('timeout', timeout);
+    if (this.idempotencyHeader && method !== 'get') {
+      if (!options.idempotencyKey) options.idempotencyKey = this.defaultIdempotencyKey();
+      headers[this.idempotencyHeader] = options.idempotencyKey;
+    }
+    const reqHeaders = {
+      ...(contentLength && { 'Content-Length': contentLength }),
+      ...this.defaultHeaders(),
+      ...headers,
+    };
+    // let builtin fetch set the Content-Type for multipart bodies
+    if ((0, uploads_1.isMultipartBody)(options.body) && !fetch_1.isPolyfilled) {
+      delete reqHeaders['Content-Type'];
+    }
+    // Strip any headers being explicitly omitted with null
+    Object.keys(reqHeaders).forEach((key) => reqHeaders[key] === null && delete reqHeaders[key]);
+    const req = {
+      method,
+      ...(body && { body: body }),
+      headers: reqHeaders,
+      ...(httpAgent && { agent: httpAgent }),
+    };
+    this.validateHeaders(reqHeaders, headers);
+    return { req, url, timeout };
+  }
+  /**
+   * 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 }) {}
+  makeStatusError(status, error, message, headers) {
+    return error_1.APIError.generate(status, error, message, headers);
+  }
+  async request(options, retriesRemaining) {
+    var _a;
+    if (retriesRemaining === void 0) {
+      retriesRemaining = (_a = options.maxRetries) !== null && _a !== void 0 ? _a : this.maxRetries;
+    }
+    const { req, url, timeout } = this.buildRequest(options);
+    await this.prepareRequest(req, { url });
+    this.debug('request', url, options, req.headers);
+    const controller = new AbortController();
+    const response = await this.fetchWithTimeout(url, req, timeout, controller).catch(exports.castToError);
+    if (response instanceof Error) {
+      if (retriesRemaining) return this.retryRequest(options, retriesRemaining);
+      if (response.name === 'AbortError') throw new error_1.APIConnectionTimeoutError();
+      throw new error_1.APIConnectionError({ cause: response });
+    }
+    const responseHeaders = (0, exports.createResponseHeaders)(response.headers);
+    if (!response.ok) {
+      if (retriesRemaining && this.shouldRetry(response)) {
+        return this.retryRequest(options, retriesRemaining, responseHeaders);
+      }
+      const errText = await response.text().catch(() => 'Unknown');
+      const errJSON = (0, exports.safeJSON)(errText);
+      const errMessage = errJSON ? undefined : errText;
+      this.debug('response', response.status, url, responseHeaders, errMessage);
+      const err = this.makeStatusError(response.status, errJSON, errMessage, responseHeaders);
+      throw err;
+    }
+    if (options.stream) {
+      // Note: there is an invariant here that isn't represented in the type system
+      // that if you set `stream: true` the response type must also be `Stream<T>`
+      return new streaming_1.Stream(response, controller);
+    }
+    const contentType = response.headers.get('content-type');
+    if (contentType === null || contentType === void 0 ? void 0 : contentType.includes('application/json')) {
+      const json = await response.json();
+      if (typeof json === 'object' && json != null) {
+        /** @deprecated – we expect to change this interface in the near future. */
+        Object.defineProperty(json, 'responseHeaders', {
+          enumerable: false,
+          writable: false,
+          value: responseHeaders,
+        });
+      }
+      this.debug('response', response.status, url, responseHeaders, json);
+      return json;
+    }
+    // TODO handle blob, arraybuffer, other content types, etc.
+    const text = response.text();
+    this.debug('response', response.status, url, responseHeaders, text);
+    return text;
+  }
+  requestAPIList(Page, options) {
+    const requestPromise = this.request(options);
+    return new PagePromise(this, requestPromise, options, Page);
+  }
+  buildURL(path, query) {
+    const url =
+      isAbsoluteURL(path) ?
+        new URL(path)
+      : new URL(this.baseURL + (this.baseURL.endsWith('/') && path.startsWith('/') ? path.slice(1) : path));
+    const defaultQuery = this.defaultQuery();
+    if (!isEmptyObj(defaultQuery)) {
+      query = { ...defaultQuery, ...query };
+    }
+    if (query) {
+      url.search = qs.stringify(query, this.qsOptions());
+    }
+    return url.toString();
+  }
+  async fetchWithTimeout(url, init, ms, controller) {
+    const { signal, ...options } = init || {};
+    if (signal) signal.addEventListener('abort', () => controller.abort());
+    const timeout = setTimeout(() => controller.abort(), ms);
+    return this.getRequestClient()
+      .fetch(url, { signal: controller.signal, ...options })
+      .finally(() => {
+        clearTimeout(timeout);
+      });
+  }
+  getRequestClient() {
+    return { fetch: this.fetch };
+  }
+  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 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, responseHeaders) {
+    var _a;
+    retriesRemaining -= 1;
+    // About the Retry-After header: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After
+    //
+    // TODO: we may want to handle the case where the header is using the http-date syntax: "Retry-After: <http-date>".
+    // See https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After#syntax for details.
+    const retryAfter = parseInt(
+      (responseHeaders === null || responseHeaders === void 0 ? void 0 : responseHeaders['retry-after']) ||
+        '',
+    );
+    const maxRetries = (_a = options.maxRetries) !== null && _a !== void 0 ? _a : this.maxRetries;
+    const timeout = this.calculateRetryTimeoutSeconds(retriesRemaining, retryAfter, maxRetries) * 1000;
+    await sleep(timeout);
+    return this.request(options, retriesRemaining);
+  }
+  calculateRetryTimeoutSeconds(retriesRemaining, retryAfter, maxRetries) {
+    const initialRetryDelay = 0.5;
+    const maxRetryDelay = 2;
+    // If the API asks us to wait a certain amount of time (and it's a reasonable amount),
+    // just do what it says.
+    if (Number.isInteger(retryAfter) && retryAfter <= 60) {
+      return retryAfter;
+    }
+    const numRetries = maxRetries - retriesRemaining;
+    // Apply exponential backoff, but not more than the max.
+    const sleepSeconds = Math.min(initialRetryDelay * Math.pow(numRetries - 1, 2), maxRetryDelay);
+    // Apply some jitter, plus-or-minus half a second.
+    const jitter = Math.random() - 0.5;
+    return sleepSeconds + jitter;
+  }
+  getUserAgent() {
+    return `${this.constructor.name}/JS ${version_1.VERSION}`;
+  }
+  debug(action, ...args) {
+    if (typeof process !== 'undefined' && process.env['DEBUG'] === 'true') {
+      console.log(`${this.constructor.name}:DEBUG:${action}`, ...args);
+    }
+  }
+}
+exports.APIClient = APIClient;
+class APIResource {
+  constructor(client) {
+    this.client = client;
+    this.get = client.get.bind(client);
+    this.post = client.post.bind(client);
+    this.patch = client.patch.bind(client);
+    this.put = client.put.bind(client);
+    this.delete = client.delete.bind(client);
+    this.getAPIList = client.getAPIList.bind(client);
+  }
+}
+exports.APIResource = APIResource;
+class AbstractPage {
+  constructor(client, response, options) {
+    _AbstractPage_client.set(this, void 0);
+    __classPrivateFieldSet(this, _AbstractPage_client, client, 'f');
+    this.options = options;
+  }
+  hasNextPage() {
+    const items = this.getPaginatedItems();
+    if (!items.length) return false;
+    return this.nextPageInfo() != null;
+  }
+  async getNextPage() {
+    const nextInfo = this.nextPageInfo();
+    if (!nextInfo) {
+      throw new Error(
+        'No next page expected; please check `.hasNextPage()` before calling `.getNextPage()`.',
+      );
+    }
+    const nextOptions = { ...this.options };
+    if ('params' in nextInfo) {
+      nextOptions.query = { ...nextOptions.query, ...nextInfo.params };
+    } else if ('url' in nextInfo) {
+      const params = [...Object.entries(nextOptions.query || {}), ...nextInfo.url.searchParams.entries()];
+      for (const [key, value] of params) {
+        nextInfo.url.searchParams.set(key, value);
+      }
+      nextOptions.query = undefined;
+      nextOptions.path = nextInfo.url.toString();
+    }
+    return await __classPrivateFieldGet(this, _AbstractPage_client, 'f').requestAPIList(
+      this.constructor,
+      nextOptions,
+    );
+  }
+  async *iterPages() {
+    // eslint-disable-next-line @typescript-eslint/no-this-alias
+    let page = this;
+    yield page;
+    while (page.hasNextPage()) {
+      page = await page.getNextPage();
+      yield page;
+    }
+  }
+  async *[((_AbstractPage_client = new WeakMap()), Symbol.asyncIterator)]() {
+    for await (const page of this.iterPages()) {
+      for (const item of page.getPaginatedItems()) {
+        yield item;
+      }
+    }
+  }
+}
+exports.AbstractPage = AbstractPage;
+class PagePromise extends Promise {
+  /**
+   * This subclass of Promise will resolve to an instantiated Page once the request completes.
+   */
+  constructor(client, requestPromise, options, Page) {
+    super((resolve, reject) =>
+      requestPromise.then((response) => resolve(new Page(client, response, options))).catch(reject),
+    );
+  }
+  /**
+   * Enable subclassing Promise.
+   * Ref: https://stackoverflow.com/a/60328122
+   */
+  static get [Symbol.species]() {
+    return Promise;
+  }
+  /**
+   * Allow auto-paginating iteration on an unawaited list call, eg:
+   *
+   *    for await (const item of client.items.list()) {
+   *      console.log(item)
+   *    }
+   */
+  async *[Symbol.asyncIterator]() {
+    const page = await this;
+    for await (const item of page) {
+      yield item;
+    }
+  }
+}
+exports.PagePromise = PagePromise;
+const createResponseHeaders = (headers) => {
+  return new Proxy(
+    Object.fromEntries(
+      // @ts-ignore
+      headers.entries(),
+    ),
+    {
+      get(target, name) {
+        const key = name.toString();
+        return target[key.toLowerCase()] || target[key];
+      },
+    },
+  );
+};
+exports.createResponseHeaders = createResponseHeaders;
+// This is required so that we can determine if a given object matches the RequestOptions
+// type at runtime. While this requires duplication, it is enforced by the TypeScript
+// compiler such that any missing / extraneous keys will cause an error.
+const requestOptionsKeys = {
+  method: true,
+  path: true,
+  query: true,
+  body: true,
+  headers: true,
+  maxRetries: true,
+  stream: true,
+  timeout: true,
+  httpAgent: true,
+  idempotencyKey: true,
+};
+const isRequestOptions = (obj) => {
+  return (
+    typeof obj === 'object' &&
+    obj !== null &&
+    !isEmptyObj(obj) &&
+    Object.keys(obj).every((k) => hasOwn(requestOptionsKeys, k))
+  );
+};
+exports.isRequestOptions = isRequestOptions;
+const getPlatformProperties = () => {
+  if (typeof Deno !== 'undefined' && Deno.build != null) {
+    return {
+      'X-Stainless-Lang': 'js',
+      'X-Stainless-Package-Version': version_1.VERSION,
+      'X-Stainless-OS': normalizePlatform(Deno.build.os),
+      'X-Stainless-Arch': normalizeArch(Deno.build.arch),
+      'X-Stainless-Runtime': 'deno',
+      'X-Stainless-Runtime-Version': Deno.version,
+    };
+  }
+  if (typeof EdgeRuntime !== 'undefined') {
+    return {
+      'X-Stainless-Lang': 'js',
+      'X-Stainless-Package-Version': version_1.VERSION,
+      'X-Stainless-OS': 'Unknown',
+      'X-Stainless-Arch': `other:${EdgeRuntime}`,
+      'X-Stainless-Runtime': 'edge',
+      'X-Stainless-Runtime-Version': process.version,
+    };
+  }
+  // Check if Node.js
+  if (Object.prototype.toString.call(typeof process !== 'undefined' ? process : 0) === '[object process]') {
+    return {
+      'X-Stainless-Lang': 'js',
+      'X-Stainless-Package-Version': version_1.VERSION,
+      'X-Stainless-OS': normalizePlatform(process.platform),
+      'X-Stainless-Arch': normalizeArch(process.arch),
+      'X-Stainless-Runtime': 'node',
+      'X-Stainless-Runtime-Version': process.version,
+    };
+  }
+  // TODO add support for Cloudflare workers, browsers, etc.
+  return {
+    'X-Stainless-Lang': 'js',
+    'X-Stainless-Package-Version': version_1.VERSION,
+    'X-Stainless-OS': 'Unknown',
+    'X-Stainless-Arch': 'unknown',
+    'X-Stainless-Runtime': 'unknown',
+    'X-Stainless-Runtime-Version': 'unknown',
+  };
+};
+const normalizeArch = (arch) => {
+  // Node docs:
+  // - https://nodejs.org/api/process.html#processarch
+  // Deno docs:
+  // - https://doc.deno.land/deno/stable/~/Deno.build
+  if (arch === 'x32') return 'x32';
+  if (arch === 'x86_64' || arch === 'x64') return 'x64';
+  if (arch === 'arm') return 'arm';
+  if (arch === 'aarch64' || arch === 'arm64') return 'arm64';
+  if (arch) return `other:${arch}`;
+  return 'unknown';
+};
+const normalizePlatform = (platform) => {
+  // Node platforms:
+  // - https://nodejs.org/api/process.html#processplatform
+  // Deno platforms:
+  // - https://doc.deno.land/deno/stable/~/Deno.build
+  // - https://github.com/denoland/deno/issues/14799
+  platform = platform.toLowerCase();
+  // NOTE: this iOS check is untested and may not work
+  // Node does not work natively on IOS, there is a fork at
+  // https://github.com/nodejs-mobile/nodejs-mobile
+  // however it is unknown at the time of writing how to detect if it is running
+  if (platform.includes('ios')) return 'iOS';
+  if (platform === 'android') return 'Android';
+  if (platform === 'darwin') return 'MacOS';
+  if (platform === 'win32') return 'Windows';
+  if (platform === 'freebsd') return 'FreeBSD';
+  if (platform === 'openbsd') return 'OpenBSD';
+  if (platform === 'linux') return 'Linux';
+  if (platform) return `Other:${platform}`;
+  return 'Unknown';
+};
+let _platformHeaders;
+const getPlatformHeaders = () => {
+  return _platformHeaders !== null && _platformHeaders !== void 0 ?
+      _platformHeaders
+    : (_platformHeaders = getPlatformProperties());
+};
+const safeJSON = (text) => {
+  try {
+    return JSON.parse(text);
+  } catch (err) {
+    return undefined;
+  }
+};
+exports.safeJSON = safeJSON;
+// https://stackoverflow.com/a/19709846
+const startsWithSchemeRegexp = new RegExp('^(?:[a-z]+:)?//', 'i');
+const isAbsoluteURL = (url) => {
+  return startsWithSchemeRegexp.test(url);
+};
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+const validatePositiveInteger = (name, n) => {
+  if (!Number.isInteger(n)) {
+    throw new Error(`${name} must be an integer`);
+  }
+  if (n < 0) {
+    throw new Error(`${name} must be a positive integer`);
+  }
+  return n;
+};
+const castToError = (err) => {
+  if (err instanceof Error) return err;
+  return new Error(err);
+};
+exports.castToError = castToError;
+const ensurePresent = (value) => {
+  if (value == null) throw new Error(`Expected a value to be given but received ${value} instead.`);
+  return value;
+};
+exports.ensurePresent = ensurePresent;
+const coerceInteger = (value) => {
+  if (typeof value === 'number') return Math.round(value);
+  if (typeof value === 'string') return parseInt(value, 10);
+  throw new Error(`Could not coerce ${value} (type: ${typeof value}) into a number`);
+};
+exports.coerceInteger = coerceInteger;
+const coerceFloat = (value) => {
+  if (typeof value === 'number') return value;
+  if (typeof value === 'string') return parseFloat(value);
+  throw new Error(`Could not coerce ${value} (type: ${typeof value}) into a number`);
+};
+exports.coerceFloat = coerceFloat;
+const coerceBoolean = (value) => {
+  if (typeof value === 'boolean') return value;
+  if (typeof value === 'string') return value === 'true';
+  return Boolean(value);
+};
+exports.coerceBoolean = coerceBoolean;
+// https://stackoverflow.com/a/34491287
+function isEmptyObj(obj) {
+  if (!obj) return true;
+  for (const _k in obj) return false;
+  return true;
+}
+exports.isEmptyObj = isEmptyObj;
+// https://eslint.org/docs/latest/rules/no-prototype-builtins
+function hasOwn(obj, key) {
+  return Object.prototype.hasOwnProperty.call(obj, key);
+}
+exports.hasOwn = hasOwn;
+/**
+ * https://stackoverflow.com/a/2117523
+ */
+const uuid4 = () => {
+  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+    const r = (Math.random() * 16) | 0;
+    const v = c === 'x' ? r : (r & 0x3) | 0x8;
+    return v.toString(16);
+  });
+};
+const isHeadersProtocol = (headers) => {
+  return typeof (headers === null || headers === void 0 ? void 0 : headers.get) === 'function';
+};
+exports.isHeadersProtocol = isHeadersProtocol;
+const getHeader = (headers, key) => {
+  const lowerKey = key.toLowerCase();
+  if ((0, exports.isHeadersProtocol)(headers)) return headers.get(key) || headers.get(lowerKey);
+  const value = headers[key] || headers[lowerKey];
+  if (Array.isArray(value)) {
+    if (value.length <= 1) return value[0];
+    console.warn(`Received ${value.length} entries for the ${key} header, using the first entry.`);
+    return value[0];
+  }
+  return value;
+};
+exports.getHeader = getHeader;
+//# sourceMappingURL=core.js.map