lifecycleion 0.0.9 → 0.0.10

package/dist/lib/http-client-xhr/index.cjs

@@ -0,0 +1,323 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/http-client-xhr/index.ts
+var http_client_xhr_exports = {};
+__export(http_client_xhr_exports, {
+  XHRAdapter: () => XHRAdapter
+});
+module.exports = __toCommonJS(http_client_xhr_exports);
+
+// src/lib/http-client/consts.ts
+var XHR_BROWSER_TIMEOUT_FLAG = "_lifecycleion_xhr_browser_timeout";
+
+// src/lib/http-client/utils.ts
+var import_qs = __toESM(require("qs"), 1);
+
+// src/lib/domain-utils/domain-utils.ts
+var import_tldts = require("tldts");
+
+// src/lib/domain-utils/helpers.ts
+var import_tr46 = require("tr46");
+var INTERNAL_PSEUDO_TLDS = Object.freeze(
+  /* @__PURE__ */ new Set(["localhost", "local", "test", "internal"])
+);
+
+// src/lib/domain-utils/domain-utils.ts
+var import_tldts2 = require("tldts");
+
+// src/lib/http-client/utils.ts
+function resolveAbsoluteURL(url, baseURL) {
+  if (!url) {
+    return url;
+  }
+  try {
+    return new URL(url).href;
+  } catch {
+  }
+  if (baseURL) {
+    try {
+      const base = baseURL.endsWith("/") ? baseURL : `${baseURL}/`;
+      return new URL(url, base).href;
+    } catch {
+    }
+  }
+  return url;
+}
+function resolveAbsoluteURLForRuntime(url, baseURL, isBrowserRuntime) {
+  const resolved = resolveAbsoluteURL(url, baseURL);
+  if (!isBrowserRuntime || resolved.startsWith("http://") || resolved.startsWith("https://")) {
+    return resolved;
+  }
+  const browserBase = getBrowserResolutionBase();
+  if (!browserBase) {
+    return resolved;
+  }
+  return resolveAbsoluteURL(resolved, browserBase);
+}
+function getBrowserResolutionBase() {
+  if (typeof document !== "undefined" && typeof document.baseURI === "string" && document.baseURI) {
+    return document.baseURI;
+  }
+  if (typeof window !== "undefined" && window.location && typeof window.location.href === "string" && window.location.href) {
+    return window.location.href;
+  }
+  const globalLocation = globalThis.location;
+  if (globalLocation && typeof globalLocation.href === "string" && globalLocation.href) {
+    return globalLocation.href;
+  }
+  const selfLocation = globalThis.self?.location;
+  if (selfLocation && typeof selfLocation.href === "string" && selfLocation.href) {
+    return selfLocation.href;
+  }
+  return void 0;
+}
+
+// src/lib/http-client/adapters/xhr-adapter.ts
+var XHRAdapter = class {
+  getType() {
+    return "xhr";
+  }
+  send(request) {
+    return new Promise((resolve, reject) => {
+      const xhr = new XMLHttpRequest();
+      xhr.open(request.method, request.requestURL);
+      xhr.responseType = "arraybuffer";
+      xhr.timeout = 0;
+      for (const [key, value] of Object.entries(request.headers)) {
+        if (Array.isArray(value)) {
+          for (const v of value) {
+            xhr.setRequestHeader(key, v);
+          }
+        } else {
+          xhr.setRequestHeader(key, value);
+        }
+      }
+      if (request.signal) {
+        if (request.signal.aborted) {
+          reject(new DOMException("Request aborted", "AbortError"));
+          return;
+        }
+        request.signal.addEventListener(
+          "abort",
+          () => {
+            xhr.abort();
+          },
+          // once: true — the XHR is already done after the first abort, no
+          // need to keep the listener alive and risk a second call.
+          { once: true }
+        );
+      }
+      request.onUploadProgress?.({ loaded: 0, total: 0, progress: 0 });
+      let didFireUpload100 = false;
+      let uploadedBytes = 0;
+      let uploadTotalBytes = 0;
+      xhr.upload.addEventListener("progress", (event) => {
+        const progress = event.lengthComputable ? event.loaded / event.total : -1;
+        if (progress === 1) {
+          didFireUpload100 = true;
+        }
+        uploadedBytes = Math.max(uploadedBytes, event.loaded);
+        uploadTotalBytes = Math.max(uploadTotalBytes, event.total);
+        request.onUploadProgress?.({
+          loaded: event.loaded,
+          total: event.total || 0,
+          progress
+        });
+      });
+      let didUploadComplete = false;
+      xhr.upload.addEventListener("load", (event) => {
+        didUploadComplete = true;
+        uploadedBytes = Math.max(uploadedBytes, event.loaded);
+        uploadTotalBytes = Math.max(
+          uploadTotalBytes,
+          event.total || event.loaded
+        );
+        if (!didFireUpload100) {
+          const finalLoaded = uploadedBytes > 0 ? uploadedBytes : 1;
+          const finalTotal = uploadTotalBytes > 0 ? uploadTotalBytes : 1;
+          request.onUploadProgress?.({
+            loaded: finalLoaded,
+            total: finalTotal,
+            progress: 1
+          });
+        }
+      });
+      let didFireDownload100 = false;
+      let downloadedBytes = 0;
+      let downloadTotalBytes = 0;
+      xhr.addEventListener("progress", (event) => {
+        const progress = event.lengthComputable ? event.loaded / event.total : -1;
+        if (progress === 1) {
+          didFireDownload100 = true;
+        }
+        downloadedBytes = Math.max(downloadedBytes, event.loaded);
+        downloadTotalBytes = Math.max(downloadTotalBytes, event.total);
+        request.onDownloadProgress?.({
+          loaded: event.loaded,
+          total: event.total || 0,
+          progress
+        });
+      });
+      xhr.addEventListener("load", () => {
+        if (xhr.responseURL && didBrowserFollowRedirect(xhr.responseURL, request.requestURL)) {
+          if (!didUploadComplete && !didFireUpload100) {
+            request.onUploadProgress?.({
+              loaded: uploadedBytes,
+              total: uploadTotalBytes,
+              progress: 1
+            });
+          }
+          if (!didFireDownload100) {
+            request.onDownloadProgress?.({
+              loaded: downloadedBytes,
+              total: downloadTotalBytes,
+              progress: 1
+            });
+          }
+          resolve({
+            status: 0,
+            wasRedirectDetected: true,
+            // XHR exposes the post-redirect final URL via responseURL. Browser
+            // fetch opaque redirects do not, so this is intentionally
+            // adapter-specific and surfaced separately from requestURL.
+            detectedRedirectURL: xhr.responseURL,
+            headers: {},
+            body: null
+          });
+          return;
+        }
+        if (!didUploadComplete && !didFireUpload100) {
+          request.onUploadProgress?.({
+            loaded: uploadedBytes,
+            total: uploadTotalBytes,
+            progress: 1
+          });
+        }
+        const body = readResponseBody(request.method, xhr);
+        if (!didFireDownload100) {
+          request.onDownloadProgress?.({
+            loaded: body?.length ?? 0,
+            total: body?.length ?? 0,
+            progress: 1
+          });
+        }
+        resolve({
+          status: xhr.status,
+          headers: parseXHRResponseHeaders(xhr.getAllResponseHeaders()),
+          body
+        });
+      });
+      xhr.addEventListener("error", () => {
+        resolve({
+          status: 0,
+          isTransportError: true,
+          headers: {},
+          body: null,
+          errorCause: new Error("XHR network error")
+        });
+      });
+      xhr.addEventListener("timeout", () => {
+        reject(
+          Object.assign(new DOMException("Request timed out", "AbortError"), {
+            [XHR_BROWSER_TIMEOUT_FLAG]: true
+          })
+        );
+      });
+      xhr.addEventListener("abort", () => {
+        reject(new DOMException("Request aborted", "AbortError"));
+      });
+      xhr.send(prepareBody(request.body));
+    });
+  }
+};
+function readResponseBody(method, xhr) {
+  if (method === "HEAD" || xhr.status === 204 || xhr.status === 304) {
+    return null;
+  }
+  if (xhr.response instanceof ArrayBuffer) {
+    return new Uint8Array(xhr.response);
+  }
+  return null;
+}
+function prepareBody(body) {
+  if (body === null) {
+    return null;
+  }
+  return body;
+}
+function parseXHRResponseHeaders(raw) {
+  const result = {};
+  if (!raw) {
+    return result;
+  }
+  for (const line of raw.split("\r\n")) {
+    const colonIndex = line.indexOf(":");
+    if (colonIndex < 0) {
+      continue;
+    }
+    const key = line.slice(0, colonIndex).trim().toLowerCase();
+    const value = line.slice(colonIndex + 1).trim();
+    if (!key) {
+      continue;
+    }
+    if (key === "set-cookie") {
+      const existing = result["set-cookie"];
+      if (existing === void 0) {
+        result["set-cookie"] = [value];
+      } else if (Array.isArray(existing)) {
+        existing.push(value);
+      } else {
+        result["set-cookie"] = [existing, value];
+      }
+    } else {
+      result[key] = value;
+    }
+  }
+  return result;
+}
+function didBrowserFollowRedirect(responseURL, requestURL) {
+  try {
+    const normalizedResponse = new URL(responseURL);
+    normalizedResponse.hash = "";
+    const normalizedRequest = new URL(
+      resolveAbsoluteURLForRuntime(requestURL, void 0, true),
+      normalizedResponse.href
+    );
+    normalizedRequest.hash = "";
+    return normalizedResponse.href !== normalizedRequest.href;
+  } catch {
+    return responseURL !== requestURL;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  XHRAdapter
+});
+//# sourceMappingURL=index.cjs.map

package/dist/lib/http-client-xhr/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lib/http-client-xhr/index.ts","../../../src/lib/http-client/consts.ts","../../../src/lib/http-client/utils.ts","../../../src/lib/domain-utils/domain-utils.ts","../../../src/lib/domain-utils/helpers.ts","../../../src/lib/http-client/adapters/xhr-adapter.ts"],"sourcesContent":["export { XHRAdapter } from '../http-client/adapters/xhr-adapter';\n","import type { HTTPMethod } from './types';\n\n/**\n * HTTP responses that are plausibly transient and worth retrying when a retry\n * policy is explicitly enabled.\n *\n * `status === 0` is included on purpose because browser/XHR-style adapters can\n * surface \"no real HTTP response\" that way when the network is unavailable or\n * the request otherwise fails before a normal status code is received.\n */\nexport const RETRYABLE_STATUS_CODES: ReadonlySet<number> = new Set([\n  // 0: Browser/XHR-style \"no response\" status.\n  0,\n\n  // 408 Request Timeout\n  408,\n  // 429 Too Many Requests\n  429,\n\n  // 500 Internal Server Error\n  500,\n  // 502 Bad Gateway\n  502,\n  // 503 Service Unavailable\n  503,\n  // 504 Gateway Timeout\n  504,\n\n  // 507 Insufficient Storage\n  507,\n  // 509 Bandwidth Limit Exceeded (non-standard)\n  509,\n  // 520 Unknown Error (Cloudflare)\n  520,\n  // 521 Web Server Is Down (Cloudflare)\n  521,\n  // 522 Connection Timed Out (Cloudflare)\n  522,\n  // 523 Origin Is Unreachable (Cloudflare)\n  523,\n  // 524 A Timeout Occurred (Cloudflare)\n  524,\n  // 598 Network Read Timeout Error (non-standard)\n  598,\n  // 599 Network Connect Timeout Error (non-standard)\n  599,\n]);\n\nexport const DEFAULT_TIMEOUT_MS = 30_000;\n\nexport const DEFAULT_REQUEST_ID_HEADER = 'x-local-client-request-id';\n\nexport const DEFAULT_REQUEST_ATTEMPT_HEADER = 'x-local-client-request-attempt';\n\nexport const DEFAULT_USER_AGENT = 'lifecycleion-http-client';\n\nexport const NON_RETRYABLE_HTTP_CLIENT_CALLBACK_ERROR_FLAG =\n  '_lifecycleion_non_retryable_http_client_callback_error';\n\nexport const STREAM_FACTORY_ERROR_FLAG = '_lifecycleion_stream_factory_error';\n\n/**\n * Attached to the AbortError thrown when a StreamResponseFactory returns null\n * or `{ cancel: true, reason? }`. The value is the reason string if provided,\n * or `true` if the factory cancelled without a reason. Lets HTTPClient surface\n * the reason on HTTPClientError.cancelReason.\n */\nexport const STREAM_FACTORY_CANCEL_KEY =\n  '_lifecycleion_stream_factory_cancel_reason';\n\nexport const RESPONSE_STREAM_ABORT_FLAG = '_lifecycleion_response_stream_abort';\n\n/**\n * Set on the AbortError thrown by XHRAdapter's defensive `timeout` event\n * listener. Lets HTTPClient classify the error as a timeout (retryable) rather\n * than an unexpected abort (non-retryable cancel).\n */\nexport const XHR_BROWSER_TIMEOUT_FLAG = '_lifecycleion_xhr_browser_timeout';\n\nexport const HTTP_METHODS: ReadonlyArray<HTTPMethod> = [\n  'GET',\n  'POST',\n  'PUT',\n  'PATCH',\n  'DELETE',\n  'HEAD',\n];\n\n/**\n * Exact-match request headers that browsers either forbid outright or do not\n * let this client set reliably via plain Fetch/XHR headers.\n *\n * Prefix-based rules like `proxy-*` and `sec-*` are handled in `header-utils.ts`.\n */\nexport const BROWSER_RESTRICTED_HEADERS: ReadonlySet<string> = new Set([\n  // Encoding / CORS negotiation headers controlled by the browser.\n  'accept-charset',\n  'accept-encoding',\n  'access-control-request-headers',\n  'access-control-request-method',\n  'access-control-request-private-network',\n\n  // Connection-level transport headers.\n  'connection',\n  'content-length',\n  'date',\n  'expect',\n  'host',\n  'keep-alive',\n  'te',\n  'trailer',\n  'transfer-encoding',\n  'upgrade',\n  'via',\n\n  // Browser-managed request context / privacy headers.\n  'cookie',\n  'dnt',\n  'origin',\n  'referer',\n  'set-cookie',\n  'user-agent',\n]);\n\nexport const BROWSER_RESTRICTED_HEADER_PREFIXES: ReadonlyArray<string> = [\n  'proxy-',\n  'sec-',\n];\n\n/**\n * Headers that can tunnel the real method through POST. Browsers block these\n * when they try to smuggle forbidden transport methods.\n */\nexport const BROWSER_METHOD_OVERRIDE_HEADER_NAMES: ReadonlySet<string> =\n  new Set(['x-http-method', 'x-http-method-override', 'x-method-override']);\n\n/**\n * Methods that browsers do not allow request headers to tunnel via the\n * override headers above.\n */\nexport const BROWSER_FORBIDDEN_METHOD_OVERRIDE_VALUES: ReadonlySet<string> =\n  new Set(['connect', 'trace', 'track']);\n\nexport const DEFAULT_MAX_REDIRECTS = 5;\n\n/**\n * Redirect responses that carry a follow-up `Location` hop. `300` and `304`\n * are excluded because they do not represent an automatic redirect here.\n */\nexport const REDIRECT_STATUS_CODES: ReadonlySet<number> = new Set([\n  // 301 Moved Permanently\n  301,\n  // 302 Found\n  302,\n\n  // 303 See Other\n  303,\n\n  // 307 Temporary Redirect\n  307,\n  // 308 Permanent Redirect\n  308,\n]);\n","import qs from 'qs';\nimport {\n  matchesWildcardDomain,\n  normalizeDomain,\n} from '../domain-utils/domain-utils';\nimport type {\n  ContentType,\n  RequestPhaseName,\n  HTTPClientConfig,\n  AdapterType,\n} from './types';\n\n/**\n * If `path` is an absolute HTTP(S) URL, returns its canonical `href` (normalized\n * scheme/host casing). Otherwise `null`. Protocol-relative `//host` is handled\n * separately in `buildURL`.\n *\n * Rules differ from `resolveAbsoluteURL` (which accepts any absolute scheme).\n * One parse here per request is negligible next to network I/O.\n */\nfunction tryAbsoluteWebHref(path: string): string | null {\n  if (!path || path.startsWith('//')) {\n    return null;\n  }\n\n  try {\n    const u = new URL(path);\n    if (u.protocol === 'http:' || u.protocol === 'https:') {\n      return u.href;\n    }\n  } catch {\n    // not parseable as absolute\n  }\n\n  return null;\n}\n\n/**\n * Builds a request URL string from `baseURL`, `path`, and optional query params\n * (`qs` — nested objects and arrays supported).\n *\n * **Relative paths (usual case)** — When `baseURL` is set and `path` is not\n * absolute, `path` is joined to `baseURL` (leading slash normalized). Example:\n * `baseURL: https://api.test`, `path: /v1/users` → `https://api.test/v1/users`.\n *\n * **Absolute / protocol-relative `path` (escape hatch)** — If `path` is a full\n * `http:` or `https:` URL, it is **not** prefixed with `baseURL` (after\n * normalization via `URL#href`). The same applies to protocol-relative URLs\n * (`//cdn.example/x`): they are left for {@link resolveAbsoluteURL} to resolve\n * using the client `baseURL`’s scheme. Use this for one-off cross-origin calls,\n * CDN assets, or URLs returned by APIs; for strict per-origin clients, prefer\n * relative paths and a dedicated client or `HTTPClient.createSubClient()` per\n * origin.\n */\nexport function buildURL(\n  baseURL: string | undefined,\n  path: string,\n  params?: Record<string, unknown>,\n): string {\n  let url: string;\n\n  const absoluteHref = tryAbsoluteWebHref(path);\n\n  if (baseURL && absoluteHref === null && !path.startsWith('//')) {\n    // Avoid double slashes when joining base + path\n    const base = baseURL.endsWith('/') ? baseURL.slice(0, -1) : baseURL;\n    const p = path.startsWith('/') ? path : `/${path}`;\n    url = `${base}${p}`;\n  } else if (absoluteHref !== null) {\n    url = absoluteHref;\n  } else {\n    url = path;\n  }\n\n  if (params && Object.keys(params).length > 0) {\n    const [urlWithoutHash, hash = ''] = url.split('#', 2);\n    const queryStartIndex = urlWithoutHash.indexOf('?');\n\n    if (queryStartIndex === -1) {\n      const queryString = qs.stringify(params, { addQueryPrefix: true });\n      url = `${urlWithoutHash}${queryString}${hash ? `#${hash}` : ''}`;\n    } else {\n      const basePath = urlWithoutHash.slice(0, queryStartIndex);\n      const existingQuery = urlWithoutHash.slice(queryStartIndex + 1);\n      // Fragments are preserved only as part of the caller's URL string.\n      // They are not transmitted in HTTP requests, but keeping them intact\n      // makes buildURL safer as a general-purpose URL composition helper.\n      const mergedParams = {\n        ...qs.parse(existingQuery),\n        ...params,\n      };\n\n      const queryString = qs.stringify(mergedParams, { addQueryPrefix: true });\n      url = `${basePath}${queryString}${hash ? `#${hash}` : ''}`;\n    }\n  }\n\n  return url;\n}\n\n/**\n * Best-effort absolute URL for logging, redirects, and hop metadata.\n *\n * - If `url` parses as an absolute URL (has a scheme), returns normalized `href`.\n * - Otherwise, when `baseURL` is set, resolves `url` against it (path-relative,\n *   same-host relative, protocol-relative `//host`, query-only, etc.).\n * - If neither works, returns `url` unchanged (callers without `baseURL` may still\n *   see path-only strings).\n */\nexport function resolveAbsoluteURL(url: string, baseURL?: string): string {\n  if (!url) {\n    return url;\n  }\n\n  try {\n    return new URL(url).href;\n  } catch {\n    // Not a standalone absolute URL\n  }\n\n  if (baseURL) {\n    try {\n      const base = baseURL.endsWith('/') ? baseURL : `${baseURL}/`;\n      return new URL(url, base).href;\n    } catch {\n      // fall through\n    }\n  }\n\n  return url;\n}\n\n/**\n * Browser-aware absolute URL resolution used by HTTPClient before interceptors\n * and adapter dispatch. Starts with normal baseURL resolution, then falls back\n * to the current page/worker location when running in a browser-like runtime.\n */\nexport function resolveAbsoluteURLForRuntime(\n  url: string,\n  baseURL: string | undefined,\n  isBrowserRuntime: boolean,\n): string {\n  const resolved = resolveAbsoluteURL(url, baseURL);\n\n  if (\n    !isBrowserRuntime ||\n    resolved.startsWith('http://') ||\n    resolved.startsWith('https://')\n  ) {\n    return resolved;\n  }\n\n  const browserBase = getBrowserResolutionBase();\n\n  if (!browserBase) {\n    return resolved;\n  }\n\n  return resolveAbsoluteURL(resolved, browserBase);\n}\n\nfunction getBrowserResolutionBase(): string | undefined {\n  if (\n    typeof document !== 'undefined' &&\n    typeof document.baseURI === 'string' &&\n    document.baseURI\n  ) {\n    return document.baseURI;\n  }\n\n  if (\n    typeof window !== 'undefined' &&\n    window.location &&\n    typeof window.location.href === 'string' &&\n    window.location.href\n  ) {\n    return window.location.href;\n  }\n\n  const globalLocation = (globalThis as { location?: { href?: unknown } })\n    .location;\n\n  if (\n    globalLocation &&\n    typeof globalLocation.href === 'string' &&\n    globalLocation.href\n  ) {\n    return globalLocation.href;\n  }\n\n  const selfLocation = (\n    globalThis as { self?: { location?: { href?: unknown } } }\n  ).self?.location;\n\n  if (\n    selfLocation &&\n    typeof selfLocation.href === 'string' &&\n    selfLocation.href\n  ) {\n    return selfLocation.href;\n  }\n\n  return undefined;\n}\n\n/**\n * Normalizes header keys to lowercase.\n */\nexport function normalizeHeaders(\n  headers: Record<string, string>,\n): Record<string, string> {\n  const result: Record<string, string> = {};\n\n  for (const [key, value] of Object.entries(headers)) {\n    result[key.toLowerCase()] = value;\n  }\n\n  return result;\n}\n\n/**\n * Merges multiple request-header objects, normalizing keys to lowercase.\n * Later objects win on conflict. Array values replace earlier scalars/arrays\n * wholesale, and single-item arrays are collapsed back to a plain string.\n */\nexport function mergeHeaders(\n  ...headerSets: Array<Record<string, string | string[]> | undefined>\n): Record<string, string | string[]> {\n  const result: Record<string, string | string[]> = {};\n  for (const headers of headerSets) {\n    if (!headers) {\n      continue;\n    }\n\n    for (const [key, value] of Object.entries(headers)) {\n      result[key.toLowerCase()] = Array.isArray(value)\n        ? normalizeMergedHeaderArray(value)\n        : String(value);\n    }\n  }\n\n  return result;\n}\n\nfunction normalizeMergedHeaderArray(value: string[]): string | string[] {\n  const normalized = value.map((item) => String(item));\n  return normalized.length === 1 ? normalized[0] : normalized;\n}\n\nexport function mergeObservedHeaders(\n  ...headerSets: Array<Record<string, string | string[]> | undefined>\n): Record<string, string | string[]> {\n  const result: Record<string, string | string[]> = {};\n\n  for (const headers of headerSets) {\n    if (!headers) {\n      continue;\n    }\n\n    for (const [key, value] of Object.entries(headers)) {\n      result[key.toLowerCase()] = Array.isArray(value)\n        ? value.map((item) => String(item))\n        : String(value);\n    }\n  }\n\n  return result;\n}\n\n/**\n * Parses the Content-Type header into a ContentType enum value.\n */\nexport function parseContentType(\n  contentTypeHeader: string | undefined,\n): ContentType {\n  if (!contentTypeHeader) {\n    return 'binary';\n  } else {\n    const lower = contentTypeHeader.trim().toLowerCase();\n\n    if (lower.includes('application/json') || lower.includes('+json')) {\n      return 'json';\n    } else if (lower.startsWith('text/')) {\n      return 'text';\n    } else if (lower.includes('application/x-www-form-urlencoded')) {\n      return 'text';\n    } else {\n      return 'binary';\n    }\n  }\n}\n\n/**\n * Validates adapter/runtime combinations and redirect config before a client\n * is constructed, so unsupported browser-only/server-only options fail fast\n * with clear errors instead of surfacing later during request dispatch.\n */\nexport function assertSupportedAdapterRuntimeAndConfig(\n  config: HTTPClientConfig,\n  adapterType: AdapterType,\n  isBrowserRuntime: boolean,\n): void {\n  if (\n    config.baseURL !== undefined &&\n    requiresAbsoluteBaseURL(adapterType, isBrowserRuntime)\n  ) {\n    assertValidBaseURL(config.baseURL);\n  }\n\n  if (config.maxRedirects !== undefined && config.followRedirects !== true) {\n    throw new Error('HTTPClient maxRedirects requires followRedirects: true.');\n  }\n\n  if (\n    config.followRedirects === true &&\n    config.maxRedirects !== undefined &&\n    config.maxRedirects < 1\n  ) {\n    throw new Error(\n      'HTTPClient maxRedirects must be greater than or equal to 1 when followRedirects is true.',\n    );\n  }\n\n  if (adapterType === 'xhr' && config.followRedirects === true) {\n    throw new Error(\n      'HTTPClient redirect handling is not supported with XHR adapter. Set followRedirects: false or use a different adapter/runtime.',\n    );\n  }\n\n  if (adapterType === 'xhr' && !hasXMLHttpRequestGlobal()) {\n    throw new Error(\n      'HTTPClient XHR adapter is not supported when XMLHttpRequest is unavailable. Use a browser runtime, install a test shim, or switch to the FetchAdapter/NodeAdapter.',\n    );\n  }\n\n  if (!isBrowserRuntime) {\n    return;\n  }\n\n  if (adapterType === 'node') {\n    throw new Error(\n      'HTTPClient Node adapter is not supported in browser environments.',\n    );\n  }\n\n  // MockAdapter is intentionally allowed in browser runtimes: it is an\n  // in-memory test adapter, so cookie jars and redirect following are local\n  // simulation features rather than forbidden browser networking controls.\n  if ((adapterType === 'fetch' || adapterType === 'xhr') && config.cookieJar) {\n    throw new Error(\n      `HTTPClient cookieJar is not supported with ${adapterType === 'fetch' ? 'FetchAdapter' : 'XHR adapter'} in browser environments. Browsers manage cookies automatically.`,\n    );\n  }\n\n  if ((adapterType === 'fetch' || adapterType === 'xhr') && config.userAgent) {\n    throw new Error(\n      `HTTPClient userAgent is not supported with ${adapterType === 'fetch' ? 'FetchAdapter' : 'XHR adapter'} in browser environments. Browsers do not allow overriding the User-Agent header.`,\n    );\n  }\n\n  if (adapterType === 'fetch' && config.followRedirects === true) {\n    throw new Error(\n      'HTTPClient redirect handling is not supported with FetchAdapter in browser environments. Set followRedirects: false or use a server runtime.',\n    );\n  }\n}\n\nfunction requiresAbsoluteBaseURL(\n  adapterType: AdapterType,\n  isBrowserRuntime: boolean,\n): boolean {\n  if (adapterType === 'node' || adapterType === 'mock') {\n    return true;\n  }\n\n  if (adapterType === 'fetch' && !isBrowserRuntime) {\n    return true;\n  }\n\n  return false;\n}\n\nfunction hasXMLHttpRequestGlobal(): boolean {\n  return (\n    typeof globalThis !== 'undefined' &&\n    typeof (globalThis as { XMLHttpRequest?: unknown }).XMLHttpRequest ===\n      'function'\n  );\n}\n\n/**\n * Converts a Headers object (from fetch) into AdapterResponse headers.\n * `set-cookie` is extracted as `string[]` via `getSetCookie()` — the Fetch API\n * would otherwise incorrectly comma-join multiple Set-Cookie values.\n * All other headers are extracted as plain strings.\n */\nexport function extractFetchHeaders(\n  headers: Headers,\n): Record<string, string | string[]> {\n  const result: Record<string, string | string[]> = {};\n\n  for (const [key, value] of headers.entries()) {\n    const lower = key.toLowerCase();\n\n    if (lower !== 'set-cookie') {\n      result[lower] = value;\n    }\n  }\n\n  // Use getSetCookie() when available (Bun, Node 18.14+, modern browsers)\n  if (typeof headers.getSetCookie === 'function') {\n    const setCookies = headers.getSetCookie();\n\n    if (setCookies.length > 0) {\n      result['set-cookie'] = setCookies;\n    }\n  } else {\n    // Fallback: headers.get() comma-joins — split on ', ' is unreliable for\n    // cookies but better than nothing on older runtimes\n    const raw = headers.get('set-cookie');\n\n    if (raw) {\n      result['set-cookie'] = [raw];\n    }\n  }\n\n  return result;\n}\n\n/**\n * Lowercases all keys on adapter/response header objects. `HTTPClient` runs\n * this on each adapter response before {@link CookieJar.processResponseHeaders}.\n * The jar also normalizes so the same shapes work when feeding headers directly.\n *\n * - Non–`set-cookie` values: if an array appears (unexpected), the first\n *   element is kept when read via {@link scalarHeader}.\n * - `set-cookie`: stored as `string[]` — each array entry is one full\n *   `Set-Cookie` header line (one cookie). A single string value becomes a\n *   one-element array. If the same header appears under keys that differ only\n *   by case, those lines are appended in the order they appear on the input\n *   object.\n */\nexport function normalizeAdapterResponseHeaders(\n  headers: Record<string, string | string[]>,\n): Record<string, string | string[]> {\n  const result: Record<string, string | string[]> = {};\n\n  for (const [key, value] of Object.entries(headers)) {\n    const lower = key.toLowerCase();\n\n    if (lower === 'set-cookie') {\n      const chunk = Array.isArray(value) ? value : [value];\n      const existing = result[lower];\n\n      if (existing === undefined) {\n        result[lower] = chunk;\n      } else {\n        const existingLines = Array.isArray(existing) ? existing : [existing];\n        result[lower] = [...existingLines, ...chunk];\n      }\n    } else {\n      result[lower] = Array.isArray(value) ? (value[0] ?? '') : value;\n    }\n  }\n\n  return result;\n}\n\n/**\n * Reads a single-valued header when keys are already lowercase (e.g. after\n * {@link mergeHeaders} on requests or {@link normalizeAdapterResponseHeaders}\n * on responses). If the stored value is `string[]`, returns the first entry.\n */\nexport function scalarHeader(\n  headers: Record<string, string | string[]>,\n  lowercaseName: string,\n): string | undefined {\n  const v = headers[lowercaseName];\n\n  if (v === undefined) {\n    return undefined;\n  }\n\n  return Array.isArray(v) ? v[0] : v;\n}\n\n/**\n * Resolves a redirect target from response headers when the adapter can\n * observe a redirect response but the client may not follow it itself.\n */\nexport function resolveDetectedRedirectURL(\n  requestURL: string,\n  status: number,\n  headers: Record<string, string | string[]>,\n  baseURL?: string,\n): string | undefined {\n  if (![301, 302, 303, 307, 308].includes(status)) {\n    return undefined;\n  }\n\n  const location = scalarHeader(headers, 'location');\n\n  if (!location) {\n    return undefined;\n  }\n\n  try {\n    const absoluteRequestURL = resolveAbsoluteURL(requestURL, baseURL);\n    return new URL(location, absoluteRequestURL).toString();\n  } catch {\n    return location;\n  }\n}\n\nexport function assertValidBaseURL(\n  baseURL: string,\n  fieldName = 'baseURL',\n): void {\n  try {\n    const url = new URL(baseURL);\n\n    if (url.protocol !== 'http:' && url.protocol !== 'https:') {\n      throw new Error('unsupported protocol');\n    }\n  } catch {\n    throw new Error(\n      `HTTPClient ${fieldName} must be an absolute http(s) URL (for example \"https://api.example.com\").`,\n    );\n  }\n}\n\n/**\n * Detects whether the current runtime looks like a browser environment.\n */\nexport function isBrowserEnvironment(): boolean {\n  if (typeof globalThis === 'undefined') {\n    return false;\n  }\n\n  if ('window' in globalThis && 'document' in globalThis) {\n    return true;\n  }\n\n  const workerGlobalScope = (\n    globalThis as {\n      WorkerGlobalScope?: abstract new (...args: never[]) => unknown;\n    }\n  ).WorkerGlobalScope;\n\n  if (\n    typeof workerGlobalScope === 'function' &&\n    (globalThis as { self?: unknown }).self instanceof workerGlobalScope\n  ) {\n    return true;\n  }\n\n  const constructorName = globalThis.constructor?.name;\n\n  return (\n    !('window' in globalThis) &&\n    !('document' in globalThis) &&\n    typeof constructorName === 'string' &&\n    constructorName.endsWith('WorkerGlobalScope')\n  );\n}\n\n/**\n * Serializes the request body and returns the body + inferred content-type.\n * If `formData` is provided, it takes precedence over `body`.\n */\nexport function serializeBody(body: unknown): {\n  body: string | Uint8Array | FormData | null;\n  contentType: string | null;\n} {\n  assertSupportedRequestBody(body);\n\n  if (body instanceof FormData) {\n    return { body, contentType: null }; // browser/runtime sets multipart boundary automatically\n  } else if (body === undefined || body === null) {\n    return { body: null, contentType: null };\n  } else if (typeof body === 'string') {\n    return { body, contentType: 'text/plain; charset=utf-8' };\n  } else if (body instanceof Uint8Array) {\n    return { body, contentType: 'application/octet-stream' };\n  } else if (Array.isArray(body) || isPlainJSONBodyObject(body)) {\n    return {\n      body: JSON.stringify(body),\n      contentType: 'application/json; charset=utf-8',\n    };\n  } else {\n    throw new Error(\n      'Unsupported request body type. Supported types: string, Uint8Array, FormData, plain object, array, null, and undefined.',\n    );\n  }\n}\n\nexport function assertSupportedRequestBody(body: unknown): void {\n  if (\n    body === undefined ||\n    body === null ||\n    typeof body === 'string' ||\n    body instanceof Uint8Array ||\n    body instanceof FormData ||\n    Array.isArray(body) ||\n    isPlainJSONBodyObject(body)\n  ) {\n    return;\n  }\n\n  throw new Error(\n    'Unsupported request body type. Supported types: string, Uint8Array, FormData, plain object, array, null, and undefined.',\n  );\n}\n\nexport function isPlainJSONBodyObject(\n  value: unknown,\n): value is Record<string, unknown> {\n  if (value === null || typeof value !== 'object' || Array.isArray(value)) {\n    return false;\n  }\n\n  const prototype = Reflect.getPrototypeOf(value);\n  return prototype === Object.prototype || prototype === null;\n}\n\n/**\n * Extracts the hostname from a URL string. Returns empty string on failure.\n */\nexport function extractHostname(url: string): string {\n  try {\n    return new URL(url).hostname;\n  } catch {\n    return '';\n  }\n}\n\n/**\n * Wildcard hostname matching backed by {@link matchesWildcardDomain}.\n *\n * - `*` — global wildcard, matches any valid hostname including apex domains\n * - `*.example.com` — matches exactly one subdomain label (`api.example.com`) but not deeper levels or the apex\n * - `**.example.com` — matches one or more subdomain labels (`api.example.com`, `a.b.example.com`) but not the apex\n * - Exact patterns (no `*`) — normalized comparison, case-insensitive\n * - PSL tail guard active: `*.com`, `**.co.uk`, etc. never match\n * - Pseudo-TLD suffix wildcards are rejected just like PSL tails (`*.localhost`, `*.local`, etc.)\n */\nexport function matchesHostPattern(hostname: string, pattern: string): boolean {\n  if (pattern.includes('*')) {\n    return matchesWildcardDomain(hostname, pattern);\n  }\n\n  const normalizedHostname = normalizeDomain(hostname);\n  const normalizedPattern = normalizeDomain(pattern);\n  return normalizedHostname !== '' && normalizedHostname === normalizedPattern;\n}\n\n/**\n * Checks whether a dot-path key exists in a nested object.\n * Arrays are not traversed — only plain objects at each segment.\n */\nfunction hasNestedKey(obj: Record<string, unknown>, path: string): boolean {\n  const parts = path.split('.');\n  let current: unknown = obj;\n\n  for (const part of parts) {\n    if (!current || typeof current !== 'object' || Array.isArray(current)) {\n      return false;\n    }\n\n    if (!(part in (current as Record<string, unknown>))) {\n      return false;\n    }\n\n    current = (current as Record<string, unknown>)[part];\n  }\n\n  return true;\n}\n\nfunction normalizeMimeType(value: string): string {\n  return value.split(';', 1)[0].trim().toLowerCase();\n}\n\nfunction matchesContentTypePattern(\n  actualHeader: string,\n  pattern: string,\n): boolean {\n  const actual = normalizeMimeType(actualHeader);\n  const expected = normalizeMimeType(pattern);\n\n  if (!actual || !expected) {\n    return false;\n  }\n\n  if (expected.endsWith('/*')) {\n    const expectedType = expected.slice(0, -2);\n    const slashIndex = actual.indexOf('/');\n\n    if (slashIndex === -1) {\n      return false;\n    }\n\n    return actual.slice(0, slashIndex) === expectedType;\n  }\n\n  return actual === expected;\n}\n\n/**\n * Tests whether a request context matches an interceptor/observer filter.\n *\n * Each filter field is optional — omitting it skips that check entirely.\n * All specified fields must match for the function to return true.\n * Within each field, values are matched with OR logic (any one match is sufficient).\n *\n * - `phases`: **OR** allowlist on `phaseType` ({@link RequestPhaseName}). Skipped when\n *   `filter.phases` is omitted or empty.\n * - `statusCodes`: skipped if `context.status` is absent.\n * - `methods`: skipped if `context.method` is absent.\n * - `hosts`: supports exact hostnames and wildcard patterns. `*.example.com` matches\n *   exactly one subdomain label; `**.example.com` matches any depth. Neither matches the\n *   apex — list it explicitly. PSL tail guard prevents `*.com`-style patterns. `*` is a\n *   global wildcard that matches any valid hostname. Skipped if `context.requestURL` is absent.\n * - `schemes`: `'http'` or `'https'`. `requestURL` is absolute whenever the\n *   request could be resolved before dispatch. For `MockAdapter`, path-only\n *   requests without a client `baseURL` are materialized as `http://localhost/...`;\n *   browser adapters fall back to `window.location`, and the Node adapter requires\n *   absolute URLs. Skipped only when `requestURL` is absent.\n * - `bodyContainsKeys`: supports dot paths (e.g. `data.results`). Each segment in\n *   the path must resolve to a plain object for traversal to continue — the final\n *   value can be anything (array, string, null, etc). Array indexing is not supported.\n *   Skipped when `kind` is `'error'`.\n */\nexport function matchesFilter(\n  filter: {\n    statusCodes?: number[];\n    methods?: string[];\n    bodyContainsKeys?: string[];\n    hosts?: string[];\n    schemes?: ('http' | 'https')[];\n    phases?: RequestPhaseName[];\n    contentTypes?: ContentType[];\n    contentTypeHeaders?: string[];\n  },\n  context: {\n    status?: number;\n    method?: string;\n    body?: unknown;\n    requestURL?: string;\n    contentType?: ContentType;\n    contentTypeHeader?: string;\n  },\n  phaseType: RequestPhaseName,\n  kind: 'request' | 'response' | 'error',\n): boolean {\n  if (\n    filter.phases &&\n    filter.phases.length > 0 &&\n    !filter.phases.includes(phaseType)\n  ) {\n    return false;\n  }\n\n  if (filter.statusCodes && context.status !== undefined) {\n    if (!filter.statusCodes.includes(context.status)) {\n      return false;\n    }\n  }\n\n  if (filter.methods && context.method) {\n    if (!filter.methods.includes(context.method)) {\n      return false;\n    }\n  }\n\n  if (filter.contentTypes && filter.contentTypes.length > 0) {\n    if (\n      !context.contentType ||\n      !filter.contentTypes.includes(context.contentType)\n    ) {\n      return false;\n    }\n  }\n\n  if (filter.contentTypeHeaders && filter.contentTypeHeaders.length > 0) {\n    if (\n      !context.contentTypeHeader ||\n      !filter.contentTypeHeaders.some((pattern) =>\n        matchesContentTypePattern(context.contentTypeHeader as string, pattern),\n      )\n    ) {\n      return false;\n    }\n  }\n\n  if (\n    kind !== 'error' &&\n    filter.bodyContainsKeys &&\n    filter.bodyContainsKeys.length > 0\n  ) {\n    if (\n      !context.body ||\n      typeof context.body !== 'object' ||\n      Array.isArray(context.body)\n    ) {\n      return false;\n    }\n\n    const body = context.body as Record<string, unknown>;\n\n    if (!filter.bodyContainsKeys.some((k) => hasNestedKey(body, k))) {\n      return false;\n    }\n  }\n\n  if (filter.hosts && context.requestURL) {\n    const hostname = extractHostname(context.requestURL);\n\n    if (\n      !filter.hosts.some((pattern: string) =>\n        matchesHostPattern(hostname, pattern),\n      )\n    ) {\n      return false;\n    }\n  }\n\n  if (filter.schemes && filter.schemes.length > 0 && context.requestURL) {\n    let scheme: 'http' | 'https' | null = null;\n\n    try {\n      const parsedScheme = new URL(context.requestURL).protocol.replace(\n        ':',\n        '',\n      );\n\n      if (parsedScheme === 'http' || parsedScheme === 'https') {\n        scheme = parsedScheme;\n      }\n    } catch {\n      scheme = null;\n    }\n\n    if (!scheme || !filter.schemes.includes(scheme)) {\n      return false;\n    }\n  }\n\n  return true;\n}\n","import { getDomain, getSubdomain, getPublicSuffix } from 'tldts';\nimport {\n  isAllWildcards,\n  hasPartialLabelWildcard,\n  checkDNSLength,\n  normalizeDomain,\n  isIPv6,\n  toAsciiDots,\n  canonicalizeBracketedIPv6Content,\n  matchesMultiLabelPattern,\n  extractFixedTailAfterLastWildcard,\n  isIPAddress,\n  normalizeWildcardPattern,\n  INTERNAL_PSEUDO_TLDS,\n  INVALID_DOMAIN_CHARS,\n  MAX_LABELS,\n} from './helpers';\n\nexport function safeParseURL(input: string): URL | null {\n  try {\n    return new URL(input);\n  } catch {\n    return null;\n  }\n}\n\nfunction hasValidWildcardOriginHost(url: URL): boolean {\n  return normalizeDomain(url.hostname) !== '';\n}\n\nfunction extractAuthority(input: string, schemeIdx: number): string {\n  const afterScheme = input.slice(schemeIdx + 3);\n  const cut = Math.min(\n    ...[\n      afterScheme.indexOf('/'),\n      afterScheme.indexOf('?'),\n      afterScheme.indexOf('#'),\n    ].filter((i) => i !== -1),\n  );\n\n  return cut === Infinity ? afterScheme : afterScheme.slice(0, cut);\n}\n\nfunction hasDanglingPortInAuthority(input: string): boolean {\n  const schemeIdx = input.indexOf('://');\n  if (schemeIdx === -1) {\n    return false;\n  }\n\n  const authority = extractAuthority(input, schemeIdx);\n  const at = authority.lastIndexOf('@');\n  const hostPort = at === -1 ? authority : authority.slice(at + 1);\n\n  return hostPort.endsWith(':');\n}\n\n/**\n * Normalize a bare origin for consistent comparison.\n * Returns the canonical origin form with a normalized hostname,\n * lowercase scheme, no trailing slash, and default ports removed\n * (80 for http, 443 for https).\n */\nexport function normalizeOrigin(origin: string): string {\n  // Preserve literal \"null\" origin exactly; treat all other invalids as empty sentinel\n  if (origin === 'null') {\n    return 'null';\n  }\n\n  // Normalize Unicode dots before URL parsing for browser compatibility\n  // Chrome allows URLs like https://127。0。0。1\n  const normalizedOrigin = toAsciiDots(origin);\n  if (hasDanglingPortInAuthority(normalizedOrigin)) {\n    return '';\n  }\n\n  const url = safeParseURL(normalizedOrigin);\n  if (url) {\n    // Only normalize bare origins. Allow a single trailing slash so callers\n    // can pass values like \"https://example.com/\" without broadening real paths.\n    if (\n      url.username ||\n      url.password ||\n      (url.pathname && url.pathname !== '/') ||\n      url.search ||\n      url.hash\n    ) {\n      return '';\n    }\n\n    // Normalize hostname with punycode\n    const normalizedHostname = normalizeDomain(url.hostname);\n\n    // If hostname normalization fails (pathological IDN), return original origin\n    // to avoid emitting values like \"https://\" with an empty host.\n    if (normalizedHostname === '') {\n      return '';\n    }\n\n    // Preserve brackets for IPv6 hosts; avoid double-bracketing if already present\n    let host: string;\n    // Extract the raw bracketed host (if present) from the authority portion only\n    // to prevent matching brackets in path/query/fragment portions of full URLs.\n    const schemeSep = normalizedOrigin.indexOf('://');\n    const authority = extractAuthority(normalizedOrigin, schemeSep);\n    const bracketMatch = authority.match(/\\[([^\\]]+)\\]/);\n    const rawBracketContent = bracketMatch ? bracketMatch[1] : null;\n\n    // Decode only for IPv6 detection, not for output\n    const hostnameForIpv6Check = (\n      rawBracketContent ? rawBracketContent : normalizedHostname\n    )\n      .replace(/%25/g, '%')\n      .toLowerCase();\n\n    if (isIPv6(hostnameForIpv6Check)) {\n      // Canonicalize bracket content using shared helper (do not decode %25)\n      const raw = rawBracketContent\n        ? rawBracketContent\n        : normalizedHostname.replace(/^\\[|\\]$/g, '');\n\n      const canon = canonicalizeBracketedIPv6Content(raw);\n\n      host = `[${canon}]`;\n    } else {\n      host = normalizedHostname;\n    }\n\n    // Normalize default ports for http/https\n    let port = '';\n    const protocolLower = url.protocol.toLowerCase();\n    const defaultPort =\n      protocolLower === 'https:'\n        ? '443'\n        : protocolLower === 'http:'\n          ? '80'\n          : '';\n\n    if (url.port) {\n      // Remove default ports for known protocols\n      port = url.port === defaultPort ? '' : `:${url.port}`;\n    } else {\n      // Fallback: some URL implementations with exotic hosts might not populate url.port\n      // even if an explicit port exists in the original string. Detect and normalize manually.\n      // Handle potential userinfo (user:pass@) prefix for future compatibility\n\n      // Try IPv6 bracketed format first\n      let portMatch = authority.match(/^(?:[^@]*@)?\\[[^\\]]+\\]:(\\d+)$/);\n\n      if (portMatch) {\n        const explicit = portMatch[1];\n        port = explicit === defaultPort ? '' : `:${explicit}`;\n      } else {\n        // Fallback for non-IPv6 authorities: detect :port after host\n        portMatch = authority.match(/^(?:[^@]*@)?([^:]+):(\\d+)$/);\n        if (portMatch) {\n          const explicit = portMatch[2];\n          port = explicit === defaultPort ? '' : `:${explicit}`;\n        }\n      }\n    }\n\n    // Explicitly use lowercase protocol for consistency\n    return `${protocolLower}//${host}${port}`;\n  }\n\n  // If URL parsing fails, return empty sentinel (handles invalid URLs).\n  // Literal \"null\" is handled above.\n  return '';\n}\n\n/**\n * Smart wildcard matching for domains (apex must be explicit)\n *\n * Special case: a single \"*\" matches any host (domains and IPs).\n * For non-global patterns, apex domains must be listed explicitly.\n *\n * Pattern matching rules:\n * - \"*.example.com\" matches DIRECT subdomains only:\n *   - \"api.example.com\" ✅ (direct subdomain)\n *   - \"app.api.example.com\" ❌ (nested subdomain - use ** for this)\n * - \"**.example.com\" matches ALL subdomains (including nested):\n *   - \"api.example.com\" ✅ (direct subdomain)\n *   - \"app.api.example.com\" ✅ (nested subdomain)\n *   - \"v2.app.api.example.com\" ✅ (deep nesting)\n * - \"*.*.example.com\" matches exactly TWO subdomain levels:\n *   - \"a.b.example.com\" ✅ (two levels)\n *   - \"api.example.com\" ❌ (one level)\n *   - \"x.y.z.example.com\" ❌ (three levels)\n */\nexport function matchesWildcardDomain(\n  domain: string,\n  pattern: string,\n): boolean {\n  const normalizedDomain = normalizeDomain(domain);\n\n  if (normalizedDomain === '') {\n    return false; // invalid domain cannot match\n  }\n\n  // Normalize pattern preserving wildcard labels and trailing dot handling\n  const normalizedPattern = normalizeWildcardPattern(pattern);\n  if (!normalizedPattern) {\n    return false; // invalid pattern\n  }\n\n  // Check if pattern contains wildcards\n  if (!normalizedPattern.includes('*')) {\n    return false;\n  }\n\n  // Allow single \"*\" as global wildcard - matches both domains and IP addresses\n  if (normalizedPattern === '*') {\n    return true;\n  }\n\n  // Do not wildcard-match IP addresses with non-global patterns; only exact IP matches are supported elsewhere\n  if (isIPAddress(normalizedDomain)) {\n    return false;\n  }\n\n  // Reject other all-wildcards patterns (e.g., \"*.*\", \"**.*\")\n  if (isAllWildcards(normalizedPattern)) {\n    return false;\n  }\n\n  // PSL/IP tail guard: ensure the fixed tail is neither a PSL, a pseudo-TLD, nor an IP.\n  // This prevents patterns like \"*.com\" or \"**.co.uk\" from matching\n\n  const labels = normalizedPattern.split('.');\n  const { fixedTail: fixedTailLabels } =\n    extractFixedTailAfterLastWildcard(labels);\n  if (fixedTailLabels.length === 0) {\n    return false; // require a concrete tail\n  }\n\n  const tail = fixedTailLabels.join('.');\n\n  if (isIPAddress(tail)) {\n    return false; // no wildcarding around IPs\n  }\n\n  const ps = getPublicSuffix(tail);\n\n  if (INTERNAL_PSEUDO_TLDS.has(tail) || (ps && ps === tail)) {\n    return false; // no wildcarding around suffix-like tails\n  }\n\n  // \"**.\" requires at least one label before the remainder, so a domain that\n  // exactly equals the remainder can never match (e.g., \"**.example.com\" ≠ \"example.com\").\n  if (normalizedPattern.startsWith('**.')) {\n    if (normalizedDomain === normalizeDomain(normalizedPattern.slice(3))) {\n      return false;\n    }\n  }\n\n  return matchesMultiLabelPattern(normalizedDomain, normalizedPattern);\n}\n\n/**\n * Smart origin wildcard matching for CORS with URL parsing\n * Supports protocol-specific wildcards and domain wildcards:\n * - * - matches any valid HTTP(S) origin (global wildcard)\n * - https://* or http://* - matches any domain with specific protocol\n * - *.example.com - matches direct subdomains with any protocol (ignores port)\n * - **.example.com - matches all subdomains including nested with any protocol\n * - https://*.example.com or http://*.example.com - matches direct subdomains with specific protocol\n * - https://**.example.com or http://**.example.com - matches all subdomains including nested with specific protocol\n *\n * Protocol support:\n * - For CORS, only http/https are supported; non-HTTP(S) origins never match\n * - Invalid or non-HTTP(S) schemes are rejected early for security\n *\n * Special cases:\n * - \"null\" origins: Cannot be matched by wildcard patterns, only by exact string inclusion in arrays\n *   (Security note: sandboxed/file/data contexts can emit literal \"null\". Treat as lower trust; do not\n *   allow via \"*\" or host wildcards. Include the literal \"null\" explicitly if you want to allow it.)\n * - Apex domains (example.com) must be listed explicitly, wildcards ignore port numbers\n * - Invalid URLs that fail parsing are treated as literal strings (no wildcard matching)\n */\nexport function matchesWildcardOrigin(\n  origin: string,\n  pattern: string,\n): boolean {\n  // Normalize Unicode dots before URL parsing for consistency\n  const normalizedOrigin = toAsciiDots(origin);\n  const normalizedPattern = toAsciiDots(pattern);\n\n  if (hasDanglingPortInAuthority(normalizedOrigin)) {\n    return false;\n  }\n\n  // Parse once and reuse\n  const originURL = safeParseURL(normalizedOrigin);\n\n  // For CORS, only http/https are relevant; reject other schemes early when parsed.\n  if (originURL) {\n    const scheme = originURL.protocol.toLowerCase();\n    if (scheme !== 'http:' && scheme !== 'https:') {\n      return false;\n    }\n\n    if (\n      originURL.username ||\n      originURL.password ||\n      (originURL.pathname && originURL.pathname !== '/') ||\n      originURL.search ||\n      originURL.hash\n    ) {\n      return false;\n    }\n  }\n\n  // Global wildcard: single \"*\" matches any valid HTTP(S) origin\n  if (normalizedPattern === '*') {\n    return originURL !== null && hasValidWildcardOriginHost(originURL);\n  }\n\n  // Protocol-only wildcards: require valid URL parsing for security\n  const patternLower = normalizedPattern.toLowerCase();\n\n  if (patternLower === 'https://*' || patternLower === 'http://*') {\n    if (!originURL) {\n      return false; // must be a valid URL\n    }\n\n    const want = patternLower === 'https://*' ? 'https:' : 'http:';\n    return (\n      originURL.protocol.toLowerCase() === want &&\n      hasValidWildcardOriginHost(originURL)\n    );\n  }\n\n  // Remaining logic requires a parsed URL\n  if (!originURL) {\n    return false;\n  }\n\n  const normalizedHostname = normalizeDomain(originURL.hostname);\n\n  if (normalizedHostname === '') {\n    return false;\n  }\n\n  const originProtocol = originURL.protocol.slice(0, -1).toLowerCase(); // Remove trailing \":\" and lowercase\n\n  // Handle protocol-specific domain wildcards: https://*.example.com\n  if (normalizedPattern.includes('://')) {\n    const [patternProtocol, ...rest] = normalizedPattern.split('://');\n    const domainPattern = rest.join('://');\n\n    // Reject non-domain characters in the domain pattern portion\n    if (INVALID_DOMAIN_CHARS.test(domainPattern)) {\n      return false;\n    }\n\n    // Protocol must match exactly\n    if (originProtocol !== patternProtocol.toLowerCase()) {\n      return false;\n    }\n\n    // Fast reject: domain pattern must contain at least one wildcard and not be all-wildcards\n    if (!domainPattern.includes('*') || isAllWildcards(domainPattern)) {\n      return false;\n    }\n\n    // Check domain pattern using direct domain matching\n    return matchesWildcardDomain(normalizedHostname, domainPattern);\n  }\n\n  // Handle domain wildcard patterns (including multi-label patterns)\n  if (normalizedPattern.includes('*')) {\n    // Fast reject for invalid all-wildcards patterns (e.g., \"*.*\", \"**.*\")\n    // Note: single \"*\" is handled above as global wildcard\n    if (normalizedPattern !== '*' && isAllWildcards(normalizedPattern)) {\n      return false;\n    }\n\n    return matchesWildcardDomain(normalizedHostname, normalizedPattern);\n  }\n\n  return false;\n}\n\n/**\n * Check if a domain matches any pattern in a list\n * Supports exact matches, wildcards, and normalization\n *\n * Validation:\n * - Origin-style patterns (e.g., \"https://*.example.com\") are NOT allowed in domain lists.\n *   If any entry contains \"://\", an error will be thrown to surface misconfiguration early.\n * - Empty or whitespace-only entries are ignored.\n * Use `matchesOriginList` for origin-style patterns.\n */\nexport function matchesDomainList(\n  domain: string,\n  allowedDomains: string[],\n): boolean {\n  const normalizedDomain = normalizeDomain(domain);\n\n  // Early exit: invalid input cannot match any allowed domain\n  if (normalizedDomain === '') {\n    return false;\n  }\n\n  // Trim and filter out empty entries first\n  const cleaned = allowedDomains\n    .map((s) => s.trim())\n    .filter((s) => s.length > 0);\n\n  // Validate: throw if any origin-style patterns are present\n  const ORIGIN_LIKE = /^[a-z][a-z0-9+\\-.]*:\\/\\//i;\n  const originLike = cleaned.filter((s) => ORIGIN_LIKE.test(s));\n\n  if (originLike.length > 0) {\n    throw new Error(\n      `matchesDomainList: origin-style patterns are not allowed in domain lists: ${originLike.join(', ')}`,\n    );\n  }\n\n  for (const allowed of cleaned) {\n    if (allowed.includes('*')) {\n      if (matchesWildcardDomain(domain, allowed)) {\n        return true;\n      }\n      continue;\n    }\n\n    const normalizedAllowed = normalizeDomain(allowed);\n    if (\n      isAllowedExactHostname(normalizedAllowed) &&\n      normalizedDomain === normalizedAllowed\n    ) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\nfunction isAllowedExactHostname(normalizedHostname: string): boolean {\n  if (!normalizedHostname) {\n    return false;\n  }\n\n  // The literal string \"null\" is origin-only and must never match in domain context.\n  // Guard explicitly rather than relying on PSL classification of unknown single-label TLDs.\n  if (normalizedHostname === 'null') {\n    return false;\n  }\n\n  if (\n    isIPAddress(normalizedHostname) ||\n    INTERNAL_PSEUDO_TLDS.has(normalizedHostname)\n  ) {\n    return true;\n  }\n\n  const publicSuffix = getPublicSuffix(normalizedHostname);\n  return !(publicSuffix && publicSuffix === normalizedHostname);\n}\n\n/**\n * Validate a configuration entry for either domain or origin contexts.\n * Non-throwing: returns { valid, info? } where info can carry non-fatal hints.\n *\n * - Domain context: accepts exact domains and domain wildcard patterns.\n * - Origin context: accepts\n *   - exact origins,\n *   - protocol-only wildcards like \"https://*\",\n *   - protocol + domain wildcard like \"https://*.example.com\",\n *   - bare domains (treated like domain context).\n *\n * Common rules:\n * - Only full-label wildcards are allowed (\"*\" or \"**\"); partial label wildcards are invalid.\n * - All-wildcards domain patterns (e.g., \"*.*\") are invalid. The global \"*\" may be allowed\n *   in origin context when explicitly enabled via options.\n * - Wildcards cannot target IP tails.\n * - PSL tail guard also rejects pseudo-TLD suffix wildcards like `*.localhost`.\n */\nexport type WildcardKind = 'none' | 'global' | 'protocol' | 'subdomain';\n\nexport type ValidationResult = {\n  valid: boolean;\n  info?: string;\n  wildcardKind: WildcardKind;\n};\n\nfunction isValidPortString(port: string): boolean {\n  if (!/^\\d+$/.test(port)) {\n    return false;\n  }\n\n  const portNumber = Number(port);\n  return Number.isInteger(portNumber) && portNumber >= 0 && portNumber <= 65535;\n}\n\nexport function validateConfigEntry(\n  entry: string,\n  context: 'domain' | 'origin',\n  options?: { allowGlobalWildcard?: boolean; allowProtocolWildcard?: boolean },\n): ValidationResult {\n  const raw = (entry ?? '').trim();\n  const SCHEME_RE = /^[a-z][a-z0-9+\\-.]*$/i;\n  if (!raw) {\n    return { valid: false, info: 'empty entry', wildcardKind: 'none' };\n  }\n\n  // Normalize options with secure defaults\n  const opts = {\n    allowGlobalWildcard: false,\n    allowProtocolWildcard: true,\n    ...(options ?? {}),\n  } as Required<NonNullable<typeof options>> & {\n    allowGlobalWildcard: boolean;\n    allowProtocolWildcard: boolean;\n  };\n\n  // Helper: validate non-wildcard labels (punycode + DNS limits)\n  function validateConcreteLabels(pattern: string): boolean {\n    const labels = pattern.split('.');\n    const concrete: string[] = [];\n\n    for (const lbl of labels) {\n      if (lbl === '*' || lbl === '**') {\n        continue;\n      }\n\n      if (lbl.length > 63) {\n        return false;\n      }\n\n      const nd = normalizeDomain(lbl);\n\n      if (nd === '') {\n        return false;\n      }\n\n      concrete.push(nd);\n    }\n\n    if (concrete.length > 0) {\n      if (!checkDNSLength(concrete.join('.'))) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n\n  // Helper: PSL tail guard and IP-tail rejection for wildcard patterns\n  function wildcardTailIsInvalid(pattern: string): boolean {\n    const normalized = normalizeWildcardPattern(pattern);\n\n    const labels = normalized.split('.');\n\n    // Extract the fixed tail after the last wildcard\n    const { fixedTail: fixedTailLabels } =\n      extractFixedTailAfterLastWildcard(labels);\n    if (fixedTailLabels.length === 0) {\n      return true; // require a concrete tail\n    }\n\n    const tail = fixedTailLabels.join('.');\n    if (isIPAddress(tail)) {\n      return true; // no wildcarding around IPs\n    }\n    const ps = getPublicSuffix(tail);\n    if (INTERNAL_PSEUDO_TLDS.has(tail) || (ps && ps === tail)) {\n      return true;\n    }\n    return false;\n  }\n\n  // Helper: domain-wildcard structural checks (no URL chars, full labels, etc.)\n  function validateDomainWildcard(pattern: string): ValidationResult {\n    // Normalize Unicode dots and trim\n    const trimmed = pattern\n      .trim()\n      .normalize('NFC')\n      .replace(/[．。｡]/g, '.'); // normalize Unicode dot variants to ASCII\n\n    if (INVALID_DOMAIN_CHARS.test(trimmed)) {\n      return {\n        valid: false,\n        info: 'invalid characters in domain pattern',\n        wildcardKind: 'none',\n      };\n    }\n\n    if (hasPartialLabelWildcard(trimmed)) {\n      return {\n        valid: false,\n        info: 'partial-label wildcards are not allowed',\n        wildcardKind: 'none',\n      };\n    }\n\n    const normalized = normalizeWildcardPattern(trimmed);\n\n    if (!normalized) {\n      return {\n        valid: false,\n        info: 'invalid domain labels',\n        wildcardKind: 'none',\n      };\n    }\n\n    if (normalized.split('.').length > MAX_LABELS) {\n      return {\n        valid: false,\n        info: 'wildcard pattern exceeds label limit',\n        wildcardKind: 'none',\n      };\n    }\n\n    if (isAllWildcards(normalized)) {\n      return {\n        valid: false,\n        info: 'all-wildcards pattern is not allowed',\n        wildcardKind: 'none',\n      };\n    }\n\n    if (!validateConcreteLabels(normalized)) {\n      return {\n        valid: false,\n        info: 'invalid domain labels',\n        wildcardKind: 'none',\n      };\n    }\n\n    if (wildcardTailIsInvalid(normalized)) {\n      return {\n        valid: false,\n        info: 'wildcard tail targets public suffix or IP (disallowed)',\n        wildcardKind: 'none',\n      };\n    }\n\n    return { valid: true, wildcardKind: 'subdomain' };\n  }\n\n  // Helper: exact domain check (no protocols). Reject apex public suffixes.\n  function validateExactDomain(s: string): ValidationResult {\n    // The literal string \"null\" is origin-only; reject it explicitly\n    // rather than relying on PSL classification of unknown single-label TLDs.\n    if (s.toLowerCase() === 'null') {\n      return {\n        valid: false,\n        info: '\"null\" is not a valid domain entry',\n        wildcardKind: 'none',\n      };\n    }\n\n    // Check if it's an IP address first - if so, allow it (consistent with matchesDomainList)\n    // Normalize Unicode dots for consistent IP detection\n    const sDots = toAsciiDots(s);\n    if (isIPAddress(sDots)) {\n      return { valid: true, wildcardKind: 'none' };\n    }\n\n    // For non-IP addresses, reject URL-like characters\n    if (INVALID_DOMAIN_CHARS.test(s)) {\n      return {\n        valid: false,\n        info: 'invalid characters in domain',\n        wildcardKind: 'none',\n      };\n    }\n\n    const nd = normalizeDomain(s);\n\n    if (nd === '') {\n      return { valid: false, info: 'invalid domain', wildcardKind: 'none' };\n    }\n\n    const ps = getPublicSuffix(nd);\n\n    if (ps && ps === nd && !INTERNAL_PSEUDO_TLDS.has(nd)) {\n      return {\n        valid: false,\n        info: 'entry equals a public suffix (not registrable)',\n        wildcardKind: 'none',\n      };\n    }\n    return { valid: true, wildcardKind: 'none' };\n  }\n\n  // Domain context path\n  if (context === 'domain') {\n    // Reject any origin-style entries (with protocols) upfront\n    if (/^[a-z][a-z0-9+\\-.]*:\\/\\//i.test(raw)) {\n      return {\n        valid: false,\n        info: 'protocols are not allowed in domain context',\n        wildcardKind: 'none',\n      };\n    }\n\n    // Special-case: global wildcard in domain context (config-time validation)\n    if (raw === '*') {\n      return opts.allowGlobalWildcard\n        ? { valid: true, wildcardKind: 'global' }\n        : {\n            valid: false,\n            info: \"global wildcard '*' not allowed in this context\",\n            wildcardKind: 'none',\n          };\n    }\n\n    if (raw.includes('*')) {\n      return validateDomainWildcard(raw);\n    }\n    return validateExactDomain(raw);\n  }\n\n  // Origin context\n  // Special-case: literal \"null\" origin is allowed by exact inclusion\n  if (raw === 'null') {\n    return { valid: true, wildcardKind: 'none' };\n  }\n\n  // Special-case: global wildcard in origin context (config-time validation)\n  if (raw === '*') {\n    return opts.allowGlobalWildcard\n      ? { valid: true, wildcardKind: 'global' }\n      : {\n          valid: false,\n          info: \"global wildcard '*' not allowed in this context\",\n          wildcardKind: 'none',\n        };\n  }\n\n  const schemeIdx = raw.indexOf('://');\n  if (schemeIdx === -1) {\n    // Bare domain/or domain pattern allowed in origin lists; reuse domain rules\n    if (raw.includes('*')) {\n      return validateDomainWildcard(raw);\n    }\n    return validateExactDomain(raw);\n  }\n\n  const scheme = raw.slice(0, schemeIdx).toLowerCase();\n  const rest = raw.slice(schemeIdx + 3);\n\n  if (!SCHEME_RE.test(scheme)) {\n    return {\n      valid: false,\n      info: 'invalid scheme in origin',\n      wildcardKind: 'none',\n    };\n  }\n\n  let normalizedRest = rest;\n\n  // Disallow query/fragment in origin entries. Allow a single trailing slash\n  // for exact origins so copied values like \"https://example.com/\" validate\n  // the same way the runtime matchers normalize them.\n  if (normalizedRest.includes('#') || normalizedRest.includes('?')) {\n    return {\n      valid: false,\n      info: 'origin must not contain path, query, or fragment',\n      wildcardKind: 'none',\n    };\n  }\n\n  const slashIdx = normalizedRest.indexOf('/');\n  if (slashIdx !== -1) {\n    const authority = normalizedRest.slice(0, slashIdx);\n    const suffix = normalizedRest.slice(slashIdx);\n\n    if (suffix !== '/' || authority.includes('*')) {\n      return {\n        valid: false,\n        info: 'origin must not contain path, query, or fragment',\n        wildcardKind: 'none',\n      };\n    }\n\n    normalizedRest = authority;\n  }\n\n  if (!normalizedRest) {\n    return {\n      valid: false,\n      info: 'missing host in origin',\n      wildcardKind: 'none',\n    };\n  }\n\n  // Reject userinfo in origin entries for security and clarity\n  if (normalizedRest.includes('@')) {\n    return {\n      valid: false,\n      info: 'origin must not include userinfo',\n      wildcardKind: 'none',\n    };\n  }\n\n  // Protocol-only wildcard: scheme://*\n  if (normalizedRest === '*') {\n    if (scheme !== 'http' && scheme !== 'https') {\n      return {\n        valid: false,\n        info: 'wildcard origins require http or https scheme',\n        wildcardKind: 'none',\n      };\n    }\n\n    if (!opts.allowProtocolWildcard) {\n      return {\n        valid: false,\n        info: 'protocol wildcard not allowed',\n        wildcardKind: 'none',\n      };\n    }\n\n    const info =\n      scheme === 'http' || scheme === 'https'\n        ? undefined\n        : 'non-http(s) scheme; CORS may not match';\n    return { valid: true, info, wildcardKind: 'protocol' };\n  }\n\n  // Extract host (and optional port) while respecting IPv6 brackets\n  let host = normalizedRest;\n  let hasPort = false;\n\n  if (normalizedRest.startsWith('[')) {\n    const end = normalizedRest.indexOf(']');\n    if (end === -1) {\n      return {\n        valid: false,\n        info: 'unclosed IPv6 bracket',\n        wildcardKind: 'none',\n      };\n    }\n    host = normalizedRest.slice(0, end + 1);\n    const after = normalizedRest.slice(end + 1);\n    if (after.startsWith(':')) {\n      const port = after.slice(1);\n\n      if (!isValidPortString(port)) {\n        return {\n          valid: false,\n          info: 'invalid port in origin',\n          wildcardKind: 'none',\n        };\n      }\n\n      // port present -> allowed for exact origins, but reject with wildcard hosts below\n      // leave host as bracketed literal\n      hasPort = true;\n    } else if (after.length > 0) {\n      return {\n        valid: false,\n        info: 'unexpected characters after IPv6 host',\n        wildcardKind: 'none',\n      };\n    }\n  } else {\n    // strip port if present\n    const colon = normalizedRest.indexOf(':');\n    if (colon !== -1) {\n      host = normalizedRest.slice(0, colon);\n      const port = normalizedRest.slice(colon + 1);\n\n      if (!isValidPortString(port)) {\n        return {\n          valid: false,\n          info: 'invalid port in origin',\n          wildcardKind: 'none',\n        };\n      }\n\n      // optional port part is fine for exact origins\n      hasPort = true;\n    }\n  }\n\n  // If wildcard present in origin authority, treat as protocol+domain wildcard\n  if (host.includes('*')) {\n    if (scheme !== 'http' && scheme !== 'https') {\n      return {\n        valid: false,\n        info: 'wildcard origins require http or https scheme',\n        wildcardKind: 'none',\n      };\n    }\n\n    // Forbid ports/brackets with wildcard hosts\n    if (host.includes('[') || host.includes(']')) {\n      return {\n        valid: false,\n        info: 'wildcard host cannot be an IP literal',\n        wildcardKind: 'none',\n      };\n    }\n\n    if (hasPort) {\n      return {\n        valid: false,\n        info: 'ports are not allowed in wildcard origins',\n        wildcardKind: 'none',\n      };\n    }\n\n    // Validate as domain wildcard\n    const verdict = validateDomainWildcard(host);\n    if (!verdict.valid) {\n      return verdict;\n    }\n\n    const info =\n      scheme === 'http' || scheme === 'https'\n        ? undefined\n        : 'non-http(s) scheme; CORS may not match';\n    return { valid: true, info, wildcardKind: 'subdomain' };\n  }\n\n  // Exact origin: allow any scheme; validate host as domain or IP\n  if (host.startsWith('[')) {\n    const bracketContent = host.slice(1, -1);\n\n    if (!isIPv6(bracketContent)) {\n      return {\n        valid: false,\n        info: 'invalid IPv6 literal in origin',\n        wildcardKind: 'none',\n      };\n    }\n\n    const info =\n      scheme === 'http' || scheme === 'https'\n        ? undefined\n        : 'non-http(s) scheme; CORS may not match';\n\n    return { valid: true, info, wildcardKind: 'none' };\n  }\n\n  const hostDots = toAsciiDots(host);\n  if (isIPAddress(hostDots)) {\n    const info =\n      scheme === 'http' || scheme === 'https'\n        ? undefined\n        : 'non-http(s) scheme; CORS may not match';\n    return { valid: true, info, wildcardKind: 'none' };\n  }\n\n  // Domain host\n  const nd = normalizeDomain(host);\n\n  if (nd === '') {\n    return {\n      valid: false,\n      info: 'invalid domain in origin',\n      wildcardKind: 'none',\n    };\n  }\n  const ps = getPublicSuffix(nd);\n  if (ps && ps === nd && !INTERNAL_PSEUDO_TLDS.has(nd)) {\n    return {\n      valid: false,\n      info: 'origin host equals a public suffix (not registrable)',\n      wildcardKind: 'none',\n    };\n  }\n  const info =\n    scheme === 'http' || scheme === 'https'\n      ? undefined\n      : 'non-http(s) scheme; CORS may not match';\n  return { valid: true, info, wildcardKind: 'none' };\n}\n\n/**\n * Parse an exact origin for list matching.\n * Rejects userinfo, non-empty paths, queries, and fragments so malformed inputs\n * are not silently normalized into broader origins.\n */\nfunction parseExactOriginForMatching(entry: string): {\n  normalizedOrigin: string;\n  normalizedHostname: string;\n} | null {\n  if (entry === 'null') {\n    return { normalizedOrigin: 'null', normalizedHostname: '' };\n  }\n\n  const normalized = toAsciiDots(entry);\n  const schemeIdx = normalized.indexOf('://');\n\n  if (schemeIdx !== -1) {\n    const authority = extractAuthority(normalized, schemeIdx);\n    const at = authority.lastIndexOf('@');\n    const hostPort = at === -1 ? authority : authority.slice(at + 1);\n\n    if (hostPort.endsWith(':')) {\n      return null;\n    }\n  }\n\n  const url = safeParseURL(normalized);\n  if (!url) {\n    return null;\n  }\n\n  if (url.username || url.password) {\n    return null;\n  }\n\n  if (url.pathname && url.pathname !== '/') {\n    return null;\n  }\n\n  if (url.search || url.hash) {\n    return null;\n  }\n\n  const normalizedOrigin = normalizeOrigin(entry);\n  if (normalizedOrigin === '') {\n    return null;\n  }\n\n  return {\n    normalizedOrigin,\n    normalizedHostname: normalizeDomain(url.hostname),\n  };\n}\n\nfunction isCredentialsSafeWildcardOriginPattern(pattern: string): boolean {\n  const trimmed = pattern\n    .trim()\n    .normalize('NFC')\n    .replace(/[．。｡]/g, '.');\n\n  function isValidCredentialWildcardHost(hostPattern: string): boolean {\n    if (isAllWildcards(hostPattern)) {\n      return false;\n    }\n\n    if (INVALID_DOMAIN_CHARS.test(hostPattern)) {\n      return false;\n    }\n\n    if (hasPartialLabelWildcard(hostPattern)) {\n      return false;\n    }\n\n    const labels = hostPattern.split('.');\n    const concrete: string[] = [];\n\n    for (const lbl of labels) {\n      if (lbl === '*' || lbl === '**') {\n        continue;\n      }\n\n      if (lbl.length > 63) {\n        return false;\n      }\n\n      const nd = normalizeDomain(lbl);\n      if (nd === '') {\n        return false;\n      }\n\n      concrete.push(nd);\n    }\n\n    if (concrete.length > 0 && !checkDNSLength(concrete.join('.'))) {\n      return false;\n    }\n\n    const normalized = normalizeWildcardPattern(hostPattern);\n    const { fixedTail } = extractFixedTailAfterLastWildcard(\n      (normalized || hostPattern).split('.'),\n    );\n    if (!normalized || fixedTail.length === 0) {\n      return false;\n    }\n\n    const tail = fixedTail.join('.');\n    if (isIPAddress(tail)) {\n      return false;\n    }\n\n    const ps = getPublicSuffix(tail);\n    return !INTERNAL_PSEUDO_TLDS.has(tail) && !(ps && ps === tail);\n  }\n\n  if (!trimmed.includes('*')) {\n    return false;\n  }\n\n  const schemeIdx = trimmed.indexOf('://');\n  if (schemeIdx === -1) {\n    return isValidCredentialWildcardHost(trimmed);\n  }\n\n  const scheme = trimmed.slice(0, schemeIdx).toLowerCase();\n  const host = trimmed.slice(schemeIdx + 3);\n\n  if ((scheme !== 'http' && scheme !== 'https') || host === '*') {\n    return false;\n  }\n\n  return isValidCredentialWildcardHost(host);\n}\n\n/**\n * Helper function to check origin list with wildcard support.\n * Supports exact matches, wildcard matches, and normalization.\n *\n * Exact origins may use non-HTTP(S) schemes and are compared exactly.\n * Wildcard matching remains HTTP(S)-only.\n * Blank allowlist entries are ignored after trimming.\n * Special case: single \"*\" matches any valid HTTP(S) origin.\n *\n * @param origin - The origin to check (undefined for requests without Origin header)\n * @param allowedOrigins - Array of allowed origin patterns\n * @param opts - Options for handling edge cases\n * @param opts.treatNoOriginAsAllowed - If true, allows requests without Origin header when \"*\" is in the allowed list\n */\nexport function matchesOriginList(\n  origin: string | undefined,\n  allowedOrigins: string[],\n  opts: { treatNoOriginAsAllowed?: boolean } = {},\n): boolean {\n  const cleaned = allowedOrigins.map((s) => s.trim()).filter(Boolean);\n\n  if (!origin) {\n    // Only allow requests without Origin header if explicitly opted in AND \"*\" is in the list\n    return !!opts.treatNoOriginAsAllowed && cleaned.includes('*');\n  }\n\n  const parsedOrigin = parseExactOriginForMatching(origin);\n  if (!parsedOrigin) {\n    return false;\n  }\n\n  return cleaned.some((allowed) => {\n    // Global wildcard: single \"*\" matches any origin - delegate to matchesWildcardOrigin for proper validation\n    if (allowed === '*') {\n      return matchesWildcardOrigin(origin, '*');\n    }\n\n    if (allowed.includes('*')) {\n      // Avoid double-normalizing/parsing; wildcard matcher handles parsing + normalization itself\n      // We pass the raw origin/pattern here (vs normalized in the non-wildcard path) because\n      // the wildcard matcher needs to parse the origin as a URL for protocol/host extraction\n      return matchesWildcardOrigin(origin, allowed);\n    }\n\n    if (allowed === 'null') {\n      return parsedOrigin.normalizedOrigin === 'null';\n    }\n\n    if (!allowed.includes('://')) {\n      const normalizedAllowedDomain = normalizeDomain(allowed);\n\n      return (\n        isAllowedExactHostname(normalizedAllowedDomain) &&\n        parsedOrigin.normalizedHostname !== '' &&\n        parsedOrigin.normalizedHostname === normalizedAllowedDomain\n      );\n    }\n\n    const parsedAllowed = parseExactOriginForMatching(allowed);\n    if (!parsedAllowed) {\n      return false;\n    }\n\n    if (!isAllowedExactHostname(parsedAllowed.normalizedHostname)) {\n      return false;\n    }\n\n    return parsedOrigin.normalizedOrigin === parsedAllowed.normalizedOrigin;\n  });\n}\n\n/**\n * Helper function to check if origin matches any pattern in a list (credentials-safe).\n *\n * Exact origins may use non-HTTP(S) schemes and are compared exactly.\n * When `allowWildcardSubdomains` is enabled, only host subdomain wildcard\n * patterns are honored. Global \"*\" and protocol-only wildcards such as\n * \"https://*\" are intentionally not honored in credentials mode.\n * Blank allowlist entries are ignored after trimming.\n */\nexport function matchesCORSCredentialsList(\n  origin: string | undefined,\n  allowedOrigins: string[],\n  options: { allowWildcardSubdomains?: boolean } = {},\n): boolean {\n  if (!origin) {\n    return false;\n  }\n\n  const parsedOrigin = parseExactOriginForMatching(origin);\n  if (!parsedOrigin) {\n    return false;\n  }\n\n  const cleaned = allowedOrigins.map((s) => s.trim()).filter(Boolean);\n\n  const allowWildcard = !!options.allowWildcardSubdomains;\n\n  for (const allowed of cleaned) {\n    // Optional wildcard support for credentials lists (subdomain patterns only)\n    if (allowWildcard && allowed.includes('*')) {\n      if (\n        isCredentialsSafeWildcardOriginPattern(allowed) &&\n        matchesWildcardOrigin(origin, allowed)\n      ) {\n        return true;\n      }\n      continue;\n    }\n\n    if (allowed === 'null') {\n      if (parsedOrigin.normalizedOrigin === 'null') {\n        return true;\n      }\n\n      continue;\n    }\n\n    if (!allowed.includes('://')) {\n      const normalizedAllowedDomain = normalizeDomain(allowed);\n\n      if (\n        isAllowedExactHostname(normalizedAllowedDomain) &&\n        parsedOrigin.normalizedHostname !== '' &&\n        parsedOrigin.normalizedHostname === normalizedAllowedDomain\n      ) {\n        return true;\n      }\n\n      continue;\n    }\n\n    const parsedAllowed = parseExactOriginForMatching(allowed);\n    if (!parsedAllowed) {\n      continue;\n    }\n\n    if (!isAllowedExactHostname(parsedAllowed.normalizedHostname)) {\n      continue;\n    }\n\n    if (parsedOrigin.normalizedOrigin === parsedAllowed.normalizedOrigin) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Result of parsing a Host header\n */\nexport interface ParsedHost {\n  /** Domain/hostname with brackets stripped (e.g., \"[::1]\" → \"::1\") */\n  domain: string;\n  /** Port number as string, or empty string if no port specified */\n  port: string;\n}\n\n/**\n * Parse Host header into domain and port components\n * Supports IPv6 brackets and handles port extraction with strict validation\n *\n * This function is commonly used to parse the HTTP Host header,\n * which may contain:\n * - Regular hostnames: \"example.com\" or \"example.com:8080\"\n * - IPv6 addresses: \"[::1]\" or \"[::1]:8080\"\n * - IPv4 addresses: \"127.0.0.1\" or \"127.0.0.1:8080\"\n *\n * The returned domain has brackets stripped for normalization\n * (e.g., \"[::1]\" → \"::1\"), while port is returned separately.\n *\n * **Strict validation:** For bracketed IPv6 addresses, after the closing bracket `]`,\n * only the following are valid:\n * - Nothing (end of string): `[::1]` → valid\n * - Port with colon: `[::1]:8080` → valid\n * - Any other characters: `[::1]garbage`, `[::1][::2]` → returns empty (malformed)\n *\n * @param host - Host header value (hostname[:port] or [ipv6][:port])\n * @returns Object with domain (without brackets) and port (empty string if no port).\n *          Returns `{ domain: '', port: '' }` for malformed input.\n *\n * @example\n * parseHostHeader('example.com:8080')\n * // => { domain: 'example.com', port: '8080' }\n *\n * parseHostHeader('[::1]:8080')\n * // => { domain: '::1', port: '8080' }\n *\n * parseHostHeader('[2001:db8::1]')\n * // => { domain: '2001:db8::1', port: '' }\n *\n * parseHostHeader('localhost')\n * // => { domain: 'localhost', port: '' }\n *\n * parseHostHeader('[::1][::2]') // malformed\n * // => { domain: '', port: '' }\n */\nexport function parseHostHeader(host: string): ParsedHost {\n  const trimmedHost = host.trim();\n\n  if (!trimmedHost) {\n    return { domain: '', port: '' };\n  }\n\n  function parsePortOrFail(port: string): ParsedHost | null {\n    if (!isValidPortString(port)) {\n      return { domain: '', port: '' };\n    }\n\n    return null;\n  }\n\n  // Handle IPv6 brackets\n  if (trimmedHost.startsWith('[')) {\n    const end = trimmedHost.indexOf(']');\n\n    if (end !== -1) {\n      const domain = trimmedHost.slice(1, end); // Remove brackets for normalization\n      const rest = trimmedHost.slice(end + 1);\n\n      if (!isIPv6(domain)) {\n        return { domain: '', port: '' };\n      }\n\n      // Strict validation: after closing bracket, only allow empty or :port\n      if (rest === '') {\n        return { domain, port: '' };\n      }\n\n      if (rest.startsWith(':')) {\n        const invalid = parsePortOrFail(rest.slice(1));\n        if (invalid) {\n          return invalid;\n        }\n\n        return { domain, port: rest.slice(1) };\n      }\n\n      // Malformed: has junk after closing bracket (e.g., \"[::1]garbage\" or \"[::1][::2]\")\n      return { domain: '', port: '' };\n    }\n\n    // Malformed bracket - missing closing bracket\n    return { domain: '', port: '' };\n  }\n\n  // Regular hostname:port parsing\n  const idx = trimmedHost.indexOf(':');\n\n  if (idx === -1) {\n    return { domain: trimmedHost, port: '' };\n  }\n\n  if (idx === 0) {\n    return { domain: '', port: '' };\n  }\n\n  const invalid = parsePortOrFail(trimmedHost.slice(idx + 1));\n  if (invalid) {\n    return invalid;\n  }\n\n  return {\n    domain: trimmedHost.slice(0, idx),\n    port: trimmedHost.slice(idx + 1),\n  };\n}\n\n/**\n * Helper function to check if domain is apex (no subdomain)\n * Uses tldts to properly handle multi-part TLDs like .co.uk\n */\nexport function isApexDomain(domain: string): boolean {\n  const normalizedDomain = normalizeDomain(domain);\n\n  if (!normalizedDomain || isIPAddress(normalizedDomain)) {\n    return false;\n  }\n\n  // Handle pseudo-TLD domains before tldts, which doesn't know about them.\n  const labels = normalizedDomain.split('.');\n  const lastLabel = labels[labels.length - 1];\n  if (INTERNAL_PSEUDO_TLDS.has(lastLabel)) {\n    if (normalizedDomain === lastLabel) {\n      return true; // bare pseudo-TLD hostname (e.g. localhost, local) → apex\n    }\n    if (lastLabel === 'localhost') {\n      return false; // localhost is a hostname, not a TLD; sub.localhost is not apex\n    }\n    return labels.length === 2; // foo.local → apex; bar.foo.local → not\n  }\n\n  // Use tldts to properly detect apex domains vs subdomains\n  // This correctly handles multi-part TLDs like .co.uk, .com.au, etc.\n  const parsedDomain = getDomain(normalizedDomain);\n  const subdomain = getSubdomain(normalizedDomain);\n\n  // Guard against null returns from tldts for invalid hosts\n  if (!parsedDomain) {\n    return false;\n  }\n\n  // Domain is apex if it matches the parsed domain and has no subdomain\n  return parsedDomain === normalizedDomain && !subdomain;\n}\n\nexport {\n  normalizeDomain,\n  isIPAddress,\n  isIPv4,\n  isIPv6,\n  checkDNSLength,\n  canonicalizeBracketedIPv6Content,\n} from './helpers';\n\nexport { getDomain, getSubdomain } from 'tldts';\n","import { toASCII } from 'tr46';\n\n// Defense-in-depth: cap label processing to avoid pathological patterns\nexport const MAX_LABELS = 32;\n// Extra safety: cap recursive matching steps to avoid exponential blow-ups\nconst STEP_LIMIT = 10_000;\n\n// Invalid domain characters: ports, paths, fragments, brackets, userinfo, backslashes\nexport const INVALID_DOMAIN_CHARS = /[/?#:[\\]@\\\\]/;\n\n// Internal / special-use TLDs that we explicitly treat as non-PSL for wildcard-tail checks.\n// Keep this list explicit—do not guess.\n// Currently: 'localhost', 'local', 'test' (IANA special-use), and 'internal' (common in k8s/corporate).\n// If you want to allow other names (e.g., 'lan'), add them here deliberately.\nexport const INTERNAL_PSEUDO_TLDS = Object.freeze(\n  new Set<string>(['localhost', 'local', 'test', 'internal']),\n);\n\n// Helper functions for wildcard pattern validation\nexport function isAllWildcards(s: string): boolean {\n  return s.split('.').every((l) => l === '*' || l === '**');\n}\n\nexport function hasPartialLabelWildcard(s: string): boolean {\n  return s.split('.').some((l) => l.includes('*') && l !== '*' && l !== '**');\n}\n\n/**\n * Check DNS length constraints for hostnames (non-throwing):\n * - each label <= 63 octets\n * - total FQDN <= 255 octets\n * - max 127 labels (theoretical DNS limit)\n * Assumes ASCII input (post-TR46 processing).\n */\nexport function checkDNSLength(host: string): boolean {\n  const labels = host.split('.');\n\n  // Label count cap for domains (127 is theoretical DNS limit)\n  if (labels.length === 0 || labels.length > 127) {\n    return false;\n  }\n\n  let total = 0;\n  let i = 0;\n\n  for (const lbl of labels) {\n    const isLast = i++ === labels.length - 1;\n\n    if (lbl.length === 0) {\n      // Allow only a *trailing* empty label (for FQDN with a dot)\n      if (!isLast) {\n        return false;\n      }\n      continue;\n    }\n\n    if (lbl.length > 63) {\n      return false;\n    }\n\n    total += lbl.length + 1; // account for dot\n  }\n\n  return total > 0 ? total - 1 <= 255 : false;\n}\n\n// IPv6 regex pattern hoisted to module scope for performance\nconst IPV6_BASE_REGEX =\n  /^(([0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9]))$/;\n\n/**\n * Check if a string is an IPv4 address\n */\nexport function isIPv4(str: string): boolean {\n  const ipv4Regex =\n    /^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/;\n  return ipv4Regex.test(str);\n}\n\n/**\n * Check if a string is an IPv6 address\n */\nexport function isIPv6(str: string): boolean {\n  // Zone identifiers are intentionally rejected to keep behavior portable across\n  // Node, Bun, and browser-facing URL handling.\n  const cleaned = str.replace(/^\\[|\\]$/g, '');\n  if (cleaned.includes('%')) {\n    return false;\n  }\n\n  return IPV6_BASE_REGEX.test(cleaned);\n}\n\n/**\n * Check if a string is an IP address (IPv4 or IPv6)\n */\nexport function isIPAddress(str: string): boolean {\n  return isIPv4(str) || isIPv6(str);\n}\n\nfunction canonicalizeIPAddressLiteral(host: string): string | null {\n  const isIPAddressLike =\n    host.includes('.') ||\n    host.includes(':') ||\n    (host.startsWith('[') && host.endsWith(']'));\n\n  if (!isIPAddressLike) {\n    return null;\n  }\n\n  if (isIPv6(host)) {\n    return canonicalizeBracketedIPv6Content(host.replace(/^\\[|\\]$/g, ''));\n  }\n\n  try {\n    const url = new URL(`http://${host}/`);\n    const canonicalHostname = url.hostname.toLowerCase();\n\n    if (isIPv4(canonicalHostname)) {\n      return canonicalHostname;\n    }\n\n    if (isIPv6(canonicalHostname)) {\n      return canonicalHostname.replace(/^\\[|\\]$/g, '');\n    }\n  } catch {\n    // Fall through to regular domain normalization.\n  }\n\n  return null;\n}\n\n/**\n * Canonicalize IPv6 literal content for deterministic origin comparison.\n * Uses the platform URL parser so the result matches WHATWG URL origin semantics.\n */\nexport function canonicalizeBracketedIPv6Content(content: string): string {\n  try {\n    const url = new URL(`http://[${content}]/`);\n    return url.hostname.replace(/^\\[|\\]$/g, '');\n  } catch {\n    // Callers normally validate before canonicalizing; keep this helper\n    // non-throwing as a defensive fallback.\n    return content.toLowerCase();\n  }\n}\n\n/**\n * Extract the fixed tail (non-wildcard labels) after the last wildcard in a pattern.\n * Returns the labels that come after the rightmost wildcard in the pattern.\n *\n * @param patternLabels - Array of pattern labels (e.g., [\"*\", \"api\", \"example\", \"com\"])\n * @returns Object with fixedTailStart index and fixedTail labels array\n */\nexport function extractFixedTailAfterLastWildcard(patternLabels: string[]): {\n  fixedTailStart: number;\n  fixedTail: string[];\n} {\n  // Find the rightmost wildcard\n  let lastWildcardIdx = -1;\n  for (let i = patternLabels.length - 1; i >= 0; i--) {\n    const lbl = patternLabels[i];\n    if (lbl === '*' || lbl === '**') {\n      lastWildcardIdx = i;\n      break;\n    }\n  }\n\n  const fixedTailStart = lastWildcardIdx + 1;\n  const fixedTail = patternLabels.slice(fixedTailStart);\n\n  return { fixedTailStart, fixedTail };\n}\n\n/**\n * Internal recursive helper for wildcard label matching\n */\nfunction matchesWildcardLabelsInternal(\n  domainLabels: string[],\n  patternLabels: string[],\n  domainIndex: number,\n  patternIndex: number,\n  counter: { count: number },\n): boolean {\n  if (++counter.count > STEP_LIMIT) {\n    return false;\n  }\n\n  while (patternIndex < patternLabels.length) {\n    const patternLabel = patternLabels[patternIndex];\n\n    if (patternLabel === '**') {\n      const isLeftmost = patternIndex === 0;\n\n      // ** at index 0 means \"1+ labels\" while interior ** is \"0+\"\n      // If leftmost, require at least one domain label\n      if (isLeftmost) {\n        for (let i = domainIndex + 1; i <= domainLabels.length; i++) {\n          if (\n            matchesWildcardLabelsInternal(\n              domainLabels,\n              patternLabels,\n              i,\n              patternIndex + 1,\n              counter,\n            )\n          ) {\n            return true;\n          }\n        }\n        return false;\n      }\n\n      // Interior **: zero-or-more\n      if (\n        matchesWildcardLabelsInternal(\n          domainLabels,\n          patternLabels,\n          domainIndex,\n          patternIndex + 1,\n          counter,\n        )\n      ) {\n        return true;\n      }\n\n      // Try matching one or more labels\n      for (let i = domainIndex + 1; i <= domainLabels.length; i++) {\n        if (\n          matchesWildcardLabelsInternal(\n            domainLabels,\n            patternLabels,\n            i,\n            patternIndex + 1,\n            counter,\n          )\n        ) {\n          return true;\n        }\n      }\n      return false;\n    } else if (patternLabel === '*') {\n      // * matches exactly one label\n      if (domainIndex >= domainLabels.length) {\n        return false; // Not enough domain labels\n      }\n      domainIndex++;\n      patternIndex++;\n    } else {\n      // Exact label match\n      if (\n        domainIndex >= domainLabels.length ||\n        domainLabels[domainIndex] !== patternLabel\n      ) {\n        return false;\n      }\n      domainIndex++;\n      patternIndex++;\n    }\n  }\n\n  // All pattern labels matched, check if all domain labels are consumed\n  return domainIndex === domainLabels.length;\n}\n\n/**\n * Match domain labels against wildcard pattern labels\n */\nexport function matchesWildcardLabels(\n  domainLabels: string[],\n  patternLabels: string[],\n): boolean {\n  const counter = { count: 0 };\n  return matchesWildcardLabelsInternal(\n    domainLabels,\n    patternLabels,\n    0,\n    0,\n    counter,\n  );\n}\n\n/**\n * Helper function for label-wise wildcard matching\n * Supports patterns like *.example.com, **.example.com, *.*.example.com, etc.\n */\nexport function matchesMultiLabelPattern(\n  domain: string,\n  pattern: string,\n): boolean {\n  const domainLabels = domain.split('.');\n  const patternLabels = pattern.split('.');\n\n  // Guard against pathological label counts\n  if (domainLabels.length > MAX_LABELS || patternLabels.length > MAX_LABELS) {\n    return false;\n  }\n\n  // Pattern must have at least one non-wildcard label (the base domain)\n  if (\n    patternLabels.length === 0 ||\n    patternLabels.every((label) => label === '*' || label === '**')\n  ) {\n    return false;\n  }\n\n  // Extract the fixed tail after the last wildcard\n  const { fixedTailStart, fixedTail } =\n    extractFixedTailAfterLastWildcard(patternLabels);\n\n  // Domain must be at least as long as the fixed tail\n  if (domainLabels.length < fixedTail.length) {\n    return false;\n  }\n\n  // Match fixed tail exactly (right-aligned)\n  for (let i = 0; i < fixedTail.length; i++) {\n    const domainLabel =\n      domainLabels[domainLabels.length - fixedTail.length + i];\n    const patternLabel = fixedTail[i];\n    if (patternLabel !== domainLabel) {\n      return false;\n    }\n  }\n\n  // Now match the left side (which may include wildcards and fixed labels)\n  const remainingDomainLabels = domainLabels.slice(\n    0,\n    domainLabels.length - fixedTail.length,\n  );\n  const leftPatternLabels = patternLabels.slice(0, fixedTailStart);\n\n  if (leftPatternLabels.length === 0) {\n    // No left pattern, so only the fixed tail is required\n    return remainingDomainLabels.length === 0;\n  }\n\n  return matchesWildcardLabels(remainingDomainLabels, leftPatternLabels);\n}\n\n/**\n * Normalize Unicode dot variants to ASCII dots for consistent IP and domain handling\n * @param s - String that may contain Unicode dot variants\n * @returns String with Unicode dots normalized to ASCII dots\n */\nexport function toAsciiDots(s: string): string {\n  return s.replace(/[．。｡]/g, '.'); // fullwidth/japanese/halfwidth\n}\n\n/**\n * Normalize a domain name for consistent comparison\n * Handles trim, lowercase, a single trailing-dot FQDN form, NFC normalization,\n * and punycode conversion for IDN safety. Returns the canonical host form\n * without a trailing dot. Repeated trailing dots are rejected as invalid.\n * IP literals are canonicalized to a stable WHATWG URL-compatible form.\n */\nexport function normalizeDomain(domain: string): string {\n  let trimmed = domain.trim();\n\n  // Normalize Unicode dots BEFORE checking IP for consistent behavior\n  trimmed = toAsciiDots(trimmed);\n\n  // Allow a single trailing dot for FQDNs, but reject repeated trailing dots\n  if (/\\.\\.+$/.test(trimmed)) {\n    return '';\n  }\n\n  if (trimmed.endsWith('.')) {\n    trimmed = trimmed.slice(0, -1);\n  }\n\n  // Canonicalize IP literals up front so exact host checks line up with WHATWG URL parsing.\n  const canonicalIPAddress = canonicalizeIPAddressLiteral(trimmed);\n  if (canonicalIPAddress !== null) {\n    return canonicalIPAddress;\n  }\n\n  // Apply NFC normalization for Unicode domains\n  const normalized = trimmed.normalize('NFC').toLowerCase();\n\n  try {\n    // Use TR46/IDNA processing for robust Unicode domain handling that mirrors browser behavior\n    const ascii = toASCII(normalized, {\n      useSTD3ASCIIRules: true,\n      checkHyphens: true,\n      checkBidi: true,\n      checkJoiners: true,\n      transitionalProcessing: false, // matches modern browser behavior (non-transitional)\n      verifyDNSLength: false, // we already do our own length checks\n    });\n    if (!ascii) {\n      throw new Error('TR46 processing failed');\n    }\n    // Enforce DNS length constraints post-TR46\n    return checkDNSLength(ascii) ? ascii : ''; // return sentinel on invalid DNS lengths\n  } catch {\n    // On TR46 failure, return sentinel empty-string to signal invalid hostname\n    return '';\n  }\n}\n\n/**\n * Normalize a wildcard domain pattern by preserving wildcard labels\n * and punycode only non-wildcard labels. Also trims and removes\n * a trailing dot if present.\n */\nexport function normalizeWildcardPattern(pattern: string): string {\n  let trimmed = pattern\n    .trim()\n    .normalize('NFC')\n    .replace(/[．。｡]/g, '.'); // normalize Unicode dot variants to ASCII\n\n  // Refuse non-domain characters (ports, paths, fragments, brackets, userinfo, backslashes)\n  if (INVALID_DOMAIN_CHARS.test(trimmed)) {\n    return ''; // sentinel for invalid pattern\n  }\n\n  if (trimmed.endsWith('.')) {\n    trimmed = trimmed.slice(0, -1);\n  }\n\n  const labels = trimmed.split('.');\n\n  // Reject empty labels post-split early (e.g., *..example.com)\n  // This avoids double dots slipping to punycode\n  for (const lbl of labels) {\n    if (lbl.length === 0) {\n      return ''; // sentinel for invalid pattern (no empty labels)\n    }\n  }\n\n  const normalizedLabels = [];\n  for (const lbl of labels) {\n    if (lbl === '*' || lbl === '**') {\n      normalizedLabels.push(lbl);\n      continue;\n    }\n\n    // Pre-punycode check for obviously invalid labels\n    if (lbl.length > 63) {\n      return ''; // sentinel for invalid pattern\n    }\n\n    const nd = normalizeDomain(lbl);\n\n    if (nd === '') {\n      // Invalid label after normalization\n      return ''; // sentinel for invalid pattern\n    }\n\n    normalizedLabels.push(nd);\n  }\n\n  // Extract concrete (non-wildcard) labels and validate final ASCII length\n  const concreteLabels = normalizedLabels.filter(\n    (lbl) => lbl !== '*' && lbl !== '**',\n  );\n  if (concreteLabels.length > 0) {\n    const concretePattern = concreteLabels.join('.');\n    // Validate the ASCII length of the concrete parts to prevent pathological long IDNs\n    if (!checkDNSLength(concretePattern)) {\n      return ''; // sentinel for invalid pattern\n    }\n  }\n\n  return normalizedLabels.join('.');\n}\n","import { XHR_BROWSER_TIMEOUT_FLAG } from '../consts';\nimport type {\n  HTTPAdapter,\n  AdapterRequest,\n  AdapterResponse,\n  AdapterType,\n} from '../types';\nimport { resolveAbsoluteURLForRuntime } from '../utils';\n\n/**\n * XHR-based adapter for environments that expose `XMLHttpRequest`. Primary\n * advantage over FetchAdapter is real per-chunk upload and download progress\n * via `xhr.upload.onprogress` / `xhr.onprogress`. FetchAdapter only fires 0%\n * and 100% because the Fetch API has no streaming upload and requires\n * buffering the full response to read body bytes.\n *\n * XHR constraints compared to FetchAdapter and NodeAdapter:\n * - `followRedirects: false` is required — XHR offers no opt-out from\n *   automatic redirect following, so individual hops cannot be observed or\n *   controlled. Redirect following is unsupported and treated as an error.\n * - In browser runtimes, cookies, CORS, and restricted headers (e.g. Cookie,\n *   User-Agent) are browser-managed; `cookieJar` must not be passed there.\n */\nexport class XHRAdapter implements HTTPAdapter {\n  public getType(): AdapterType {\n    return 'xhr';\n  }\n\n  public send(request: AdapterRequest): Promise<AdapterResponse> {\n    return new Promise((resolve, reject) => {\n      const xhr = new XMLHttpRequest();\n\n      // responseType 'arraybuffer' gives us a raw ArrayBuffer on load,\n      // consistent with how FetchAdapter and NodeAdapter deliver body bytes.\n      xhr.open(request.method, request.requestURL);\n      xhr.responseType = 'arraybuffer';\n\n      // Timeout is managed by the client via the abort signal — the client's\n      // per-attempt timer fires AbortController.abort(), which propagates to\n      // xhr.abort() through the signal listener below. We disable XHR's own\n      // timeout mechanism (0 = no timeout) so the client retains full control.\n      // The 'timeout' event listener below is kept as a defensive fallback in\n      // case a browser fires it anyway (e.g. a hard-coded internal limit).\n      xhr.timeout = 0;\n\n      // --- Request headers ---\n      //\n      // Calling setRequestHeader multiple times for the same key causes XHR to\n      // combine values with \", \" per spec — which is correct for all headers\n      // the browser allows scripts to set. Cookie is a forbidden header name\n      // and is silently dropped by the browser regardless; the browser manages\n      // cookies on its own.\n      for (const [key, value] of Object.entries(request.headers)) {\n        if (Array.isArray(value)) {\n          for (const v of value) {\n            xhr.setRequestHeader(key, v);\n          }\n        } else {\n          xhr.setRequestHeader(key, value);\n        }\n      }\n\n      // --- Abort signal ---\n      //\n      // Check for pre-aborted signal before calling xhr.send — if we called\n      // send first and then aborted, the abort event fires asynchronously and\n      // we'd resolve the promise rather than reject it with an AbortError.\n      if (request.signal) {\n        if (request.signal.aborted) {\n          reject(new DOMException('Request aborted', 'AbortError'));\n          return;\n        }\n\n        request.signal.addEventListener(\n          'abort',\n          () => {\n            xhr.abort();\n          },\n          // once: true — the XHR is already done after the first abort, no\n          // need to keep the listener alive and risk a second call.\n          { once: true },\n        );\n      }\n\n      // --- Upload progress ---\n\n      // Fire initial 0% upload progress before any bytes leave the browser,\n      // mirroring the FetchAdapter pattern so callers see a consistent first\n      // event regardless of adapter.\n      request.onUploadProgress?.({ loaded: 0, total: 0, progress: 0 });\n\n      // Real per-chunk upload progress — the main advantage over FetchAdapter,\n      // which has no streaming upload and can only fire 0% then 100%.\n      // Deduplication guard — upload.progress and upload.load can both report\n      // 100% (see upload.load listener below for details).\n      let didFireUpload100 = false;\n      let uploadedBytes = 0;\n      let uploadTotalBytes = 0;\n\n      xhr.upload.addEventListener('progress', (event) => {\n        const progress = event.lengthComputable\n          ? event.loaded / event.total\n          : -1;\n\n        if (progress === 1) {\n          didFireUpload100 = true;\n        }\n\n        uploadedBytes = Math.max(uploadedBytes, event.loaded);\n        uploadTotalBytes = Math.max(uploadTotalBytes, event.total);\n\n        request.onUploadProgress?.({\n          loaded: event.loaded,\n          total: event.total || 0,\n          progress,\n        });\n      });\n\n      // 100% upload fires as soon as all bytes are sent, always before xhr.load\n      // per spec. Skip if upload.progress already reported 100% to avoid a\n      // duplicate event. We still track whether this fired so xhr.load can use\n      // it as a fallback for environments that skip upload.load entirely.\n      let didUploadComplete = false;\n\n      xhr.upload.addEventListener('load', (event) => {\n        didUploadComplete = true;\n\n        uploadedBytes = Math.max(uploadedBytes, event.loaded);\n        uploadTotalBytes = Math.max(\n          uploadTotalBytes,\n          event.total || event.loaded,\n        );\n\n        if (!didFireUpload100) {\n          const finalLoaded = uploadedBytes > 0 ? uploadedBytes : 1;\n          const finalTotal = uploadTotalBytes > 0 ? uploadTotalBytes : 1;\n          request.onUploadProgress?.({\n            loaded: finalLoaded,\n            total: finalTotal,\n            progress: 1,\n          });\n        }\n      });\n\n      // --- Download progress ---\n\n      // Real per-chunk download progress. Same advantage over FetchAdapter:\n      // FetchAdapter buffers the full response body before firing any progress,\n      // so it can only ever report 0% then 100%.\n      // Deduplication guard — when Content-Length is known and the final\n      // progress chunk reaches 100%, xhr.load would otherwise fire it again.\n      let didFireDownload100 = false;\n      let downloadedBytes = 0;\n      let downloadTotalBytes = 0;\n\n      xhr.addEventListener('progress', (event) => {\n        const progress = event.lengthComputable\n          ? event.loaded / event.total\n          : -1;\n\n        if (progress === 1) {\n          didFireDownload100 = true;\n        }\n\n        downloadedBytes = Math.max(downloadedBytes, event.loaded);\n        downloadTotalBytes = Math.max(downloadTotalBytes, event.total);\n\n        request.onDownloadProgress?.({\n          loaded: event.loaded,\n          total: event.total || 0,\n          progress,\n        });\n      });\n\n      // --- Load (success) ---\n\n      xhr.addEventListener('load', () => {\n        // Detect browser-followed redirects.\n        //\n        // In a browser, FetchAdapter uses `redirect: 'manual'` which yields an\n        // opaqueredirect response (status 0) — redirects are intercepted before\n        // they happen. XHR has no equivalent opt-out; the browser always follows\n        // redirects automatically. We detect them after-the-fact by comparing\n        // xhr.responseURL (the final URL after all hops) to the original URL.\n        //\n        // Both browser adapters surface the same signal: status 0 +\n        // wasRedirectDetected, which routes through HTTPClient's\n        // redirect_disabled error path so callers get a consistent isFailed\n        // response regardless of adapter.\n        if (\n          xhr.responseURL &&\n          didBrowserFollowRedirect(xhr.responseURL, request.requestURL)\n        ) {\n          // The browser completed the transport and surfaced the final URL even\n          // though the client will treat the result as redirect_disabled, so\n          // emit terminal progress before returning the synthetic redirect\n          // response.\n          if (!didUploadComplete && !didFireUpload100) {\n            request.onUploadProgress?.({\n              loaded: uploadedBytes,\n              total: uploadTotalBytes,\n              progress: 1,\n            });\n          }\n\n          if (!didFireDownload100) {\n            request.onDownloadProgress?.({\n              loaded: downloadedBytes,\n              total: downloadTotalBytes,\n              progress: 1,\n            });\n          }\n\n          resolve({\n            status: 0,\n            wasRedirectDetected: true,\n            // XHR exposes the post-redirect final URL via responseURL. Browser\n            // fetch opaque redirects do not, so this is intentionally\n            // adapter-specific and surfaced separately from requestURL.\n            detectedRedirectURL: xhr.responseURL,\n            headers: {},\n            body: null,\n          });\n          return;\n        }\n\n        // Fallback: upload.load didn't fire (no request body, or the browser\n        // skipped the event). Ensure callers always see a 100% upload event,\n        // unless upload.progress already reported it.\n        if (!didUploadComplete && !didFireUpload100) {\n          request.onUploadProgress?.({\n            loaded: uploadedBytes,\n            total: uploadTotalBytes,\n            progress: 1,\n          });\n        }\n\n        const body = readResponseBody(request.method, xhr);\n\n        // Final 100% download progress — skip if a progress event already\n        // fired exactly 100% (Content-Length known and final chunk completed it).\n        if (!didFireDownload100) {\n          request.onDownloadProgress?.({\n            loaded: body?.length ?? 0,\n            total: body?.length ?? 0,\n            progress: 1,\n          });\n        }\n\n        resolve({\n          status: xhr.status,\n          headers: parseXHRResponseHeaders(xhr.getAllResponseHeaders()),\n          body,\n        });\n      });\n\n      // --- Error / timeout / abort ---\n\n      // The error event fires for network-level failures (DNS failure, refused\n      // connection, CORS rejection). It never fires for HTTP error status codes\n      // (4xx, 5xx) — those arrive on the load event with a real status.\n      xhr.addEventListener('error', () => {\n        resolve({\n          status: 0,\n          isTransportError: true,\n          headers: {},\n          body: null,\n          errorCause: new Error('XHR network error'),\n        });\n      });\n\n      // Defensive fallback: fires if the browser has a hard-coded internal\n      // timeout limit (xhr.timeout is 0 so we never set one ourselves). Mark\n      // the error so HTTPClient classifies it as a timeout (retryable) rather\n      // than an unexpected abort (non-retryable cancel).\n      xhr.addEventListener('timeout', () => {\n        reject(\n          Object.assign(new DOMException('Request timed out', 'AbortError'), {\n            [XHR_BROWSER_TIMEOUT_FLAG]: true,\n          }),\n        );\n      });\n\n      xhr.addEventListener('abort', () => {\n        reject(new DOMException('Request aborted', 'AbortError'));\n      });\n\n      xhr.send(prepareBody(request.body));\n    });\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Returns the response body as a Uint8Array, or null for response types that\n * carry no body (HEAD, 204 No Content, 304 Not Modified).\n */\nfunction readResponseBody(\n  method: string,\n  xhr: XMLHttpRequest,\n): Uint8Array | null {\n  if (method === 'HEAD' || xhr.status === 204 || xhr.status === 304) {\n    return null;\n  }\n\n  if (xhr.response instanceof ArrayBuffer) {\n    return new Uint8Array(xhr.response);\n  }\n\n  return null;\n}\n\n/**\n * Converts the adapter request body to a value accepted by `xhr.send()`.\n * `string`, `Uint8Array` (BufferSource), and `FormData` are all valid\n * `XMLHttpRequestBodyInit` values — the cast is safe for the body types\n * the client produces.\n */\nfunction prepareBody(\n  body: AdapterRequest['body'],\n): XMLHttpRequestBodyInit | null {\n  if (body === null) {\n    return null;\n  }\n\n  return body as XMLHttpRequestBodyInit;\n}\n\n/**\n * Parses the raw header string from `xhr.getAllResponseHeaders()` into a\n * lowercase-keyed record.\n *\n * `getAllResponseHeaders()` returns CRLF-delimited `name: value` lines. When\n * a server sends multiple headers with the same name the browser combines them\n * into a single comma-joined line for most headers, but emits each `Set-Cookie`\n * value as its own line (per spec) to avoid ambiguity with the comma in cookie\n * values. Those are collected here as `string[]` to match the\n * `AdapterResponse.headers` contract.\n *\n * Note: browsers unconditionally block `Set-Cookie` and `Set-Cookie2` from\n * `getAllResponseHeaders()` per the XHR spec, so the `set-cookie` array\n * branch below is effectively unreachable in a real browser — it exists to\n * satisfy the shared `AdapterResponse` type contract.\n */\nfunction parseXHRResponseHeaders(\n  raw: string,\n): Record<string, string | string[]> {\n  const result: Record<string, string | string[]> = {};\n\n  if (!raw) {\n    return result;\n  }\n\n  for (const line of raw.split('\\r\\n')) {\n    // Lines are `Name: value` pairs separated by the first colon.\n    // indexOf is used (not split) so colons in the value are preserved.\n    const colonIndex = line.indexOf(':');\n\n    if (colonIndex < 0) {\n      // No colon — malformed or trailing empty line; skip\n      continue;\n    }\n\n    // Lowercase to normalize across servers (header names are case-insensitive)\n    const key = line.slice(0, colonIndex).trim().toLowerCase();\n    const value = line.slice(colonIndex + 1).trim();\n\n    if (!key) {\n      // Colon at position 0 — no name; skip\n      continue;\n    }\n\n    if (key === 'set-cookie') {\n      // Each Set-Cookie directive arrives as its own line — collect into an\n      // array so callers never need to split on commas (which are valid inside\n      // cookie values). Guarded by the XHR spec in standard browsers, but kept\n      // for correctness in legacy environments or platforms with non-standard\n      // XHR implementations.\n      const existing = result['set-cookie'];\n\n      if (existing === undefined) {\n        result['set-cookie'] = [value];\n      } else if (Array.isArray(existing)) {\n        existing.push(value);\n      } else {\n        result['set-cookie'] = [existing, value];\n      }\n    } else {\n      result[key] = value;\n    }\n  }\n\n  return result;\n}\n\n/**\n * Compares URLs as browsers evaluate request destinations:\n * - strips hash fragments (not sent over HTTP)\n * - relies on URL normalization for equivalent forms\n *   (default ports, dot segments, encoding normalization, etc.)\n */\nfunction didBrowserFollowRedirect(\n  responseURL: string,\n  requestURL: string,\n): boolean {\n  try {\n    const normalizedResponse = new URL(responseURL);\n    normalizedResponse.hash = '';\n\n    const normalizedRequest = new URL(\n      resolveAbsoluteURLForRuntime(requestURL, undefined, true),\n      normalizedResponse.href,\n    );\n    normalizedRequest.hash = '';\n\n    return normalizedResponse.href !== normalizedRequest.href;\n  } catch {\n    // Fallback for non-URL inputs: preserve prior behavior.\n    return responseURL !== requestURL;\n  }\n}\n"],"mappings":"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","names":["import_tldts"]}

package/dist/lib/http-client-xhr/index.d.cts

@@ -0,0 +1,23 @@
+import { H as HTTPAdapter, A as AdapterType, a as AdapterRequest, b as AdapterResponse } from '../../types-CUPvmYQ8.cjs';
+import '../../types-D_MywcG0.cjs';
+
+/**
+ * XHR-based adapter for environments that expose `XMLHttpRequest`. Primary
+ * advantage over FetchAdapter is real per-chunk upload and download progress
+ * via `xhr.upload.onprogress` / `xhr.onprogress`. FetchAdapter only fires 0%
+ * and 100% because the Fetch API has no streaming upload and requires
+ * buffering the full response to read body bytes.
+ *
+ * XHR constraints compared to FetchAdapter and NodeAdapter:
+ * - `followRedirects: false` is required — XHR offers no opt-out from
+ *   automatic redirect following, so individual hops cannot be observed or
+ *   controlled. Redirect following is unsupported and treated as an error.
+ * - In browser runtimes, cookies, CORS, and restricted headers (e.g. Cookie,
+ *   User-Agent) are browser-managed; `cookieJar` must not be passed there.
+ */
+declare class XHRAdapter implements HTTPAdapter {
+    getType(): AdapterType;
+    send(request: AdapterRequest): Promise<AdapterResponse>;
+}
+
+export { XHRAdapter };

package/dist/lib/http-client-xhr/index.d.ts

@@ -0,0 +1,23 @@
+import { H as HTTPAdapter, A as AdapterType, a as AdapterRequest, b as AdapterResponse } from '../../types-Hw2PUTIT.js';
+import '../../types-D_MywcG0.js';
+
+/**
+ * XHR-based adapter for environments that expose `XMLHttpRequest`. Primary
+ * advantage over FetchAdapter is real per-chunk upload and download progress
+ * via `xhr.upload.onprogress` / `xhr.onprogress`. FetchAdapter only fires 0%
+ * and 100% because the Fetch API has no streaming upload and requires
+ * buffering the full response to read body bytes.
+ *
+ * XHR constraints compared to FetchAdapter and NodeAdapter:
+ * - `followRedirects: false` is required — XHR offers no opt-out from
+ *   automatic redirect following, so individual hops cannot be observed or
+ *   controlled. Redirect following is unsupported and treated as an error.
+ * - In browser runtimes, cookies, CORS, and restricted headers (e.g. Cookie,
+ *   User-Agent) are browser-managed; `cookieJar` must not be passed there.
+ */
+declare class XHRAdapter implements HTTPAdapter {
+    getType(): AdapterType;
+    send(request: AdapterRequest): Promise<AdapterResponse>;
+}
+
+export { XHRAdapter };