@budiauktioner/buildi-primitives 0.1.1 → 0.2.1

package/dist/cjs/web/url.js

@@ -0,0 +1,353 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var url_exports = {};
+__export(url_exports, {
+  Url: () => Url,
+  maskUrl: () => maskUrl
+});
+module.exports = __toCommonJS(url_exports);
+var import_input_sanitization = require("../internal/input-sanitization.js");
+var import_country = require("../geography/country.js");
+var import_text_candidate_category = require("../text-scanning/text-candidate-category.js");
+var import_text_candidate = require("../text-scanning/text-candidate.js");
+var import_text_match_confidence = require("../text-scanning/text-match-confidence.js");
+const MAX_INPUT_LENGTH = 2048;
+const RESERVED_TLDS = /* @__PURE__ */ new Set(["test", "example", "invalid", "localhost"]);
+const RESERVED_DOMAINS = /* @__PURE__ */ new Set(["example.com", "example.org", "example.net"]);
+const DEFAULT_PORTS = {
+  http: 80,
+  https: 443,
+  ftp: 21,
+  ws: 80,
+  wss: 443,
+  gopher: 70
+};
+let tldCountryMapCache = null;
+function getTldCountryMap() {
+  if (tldCountryMapCache) return tldCountryMapCache;
+  const m = /* @__PURE__ */ new Map();
+  for (const c of import_country.Country.all) {
+    if (c.topLevelDomain) m.set(c.topLevelDomain.toLowerCase(), c);
+  }
+  tldCountryMapCache = m;
+  return m;
+}
+const SCAN_PATTERN = /(?:[a-zA-Z][\w+.-]*:\/\/[^\s<>"']+|(?:mailto|tel|sms|callto):[^\s<>"']+|\bwww\.[^\s<>"']+)/gi;
+const IPV4 = /^(?:\d{1,3}\.){3}\d{1,3}$/;
+const ABSOLUTE_URI = /^([a-zA-Z][a-zA-Z0-9+\-.]*):/;
+const HIERARCHICAL_RE = /^([a-zA-Z][a-zA-Z0-9+\-.]*):\/\//;
+class Url {
+  static typeInfo = Object.freeze({
+    englishName: "URL",
+    localizedName: "Webbadress",
+    emoji: "\u{1F517}",
+    sources: Object.freeze([
+      "https://datatracker.ietf.org/doc/html/rfc3986",
+      "https://datatracker.ietf.org/doc/html/rfc2606",
+      "https://datatracker.ietf.org/doc/html/rfc6761"
+    ])
+  });
+  /** The normalized URL string, e.g. `https://www.example.com/path`. */
+  value;
+  /** The URI scheme without `://`, e.g. `https`. */
+  scheme;
+  /** The full hostname, e.g. `www.example.com`. Empty for non-hierarchical URIs. */
+  host;
+  /** Explicit port, or `null` when the default port for the scheme is used. */
+  port;
+  /** The path component, e.g. `/path/to/page`. Root paths are `/`. */
+  path;
+  /** Query string without `?`, or `null` when absent. */
+  query;
+  /** Fragment without `#`, or `null` when absent. */
+  fragment;
+  /** Top-level domain without the dot, e.g. `com`, `se`. */
+  topLevelDomain;
+  /** Country associated with a country-code TLD, or `null` for generic TLDs. */
+  country;
+  /** True when the scheme is `https`. */
+  isSecure;
+  /** True when the host is a reserved example/test domain (RFC 2606 / RFC 6761). */
+  isExampleDomain;
+  /** True when the host is an IP address. */
+  isIpAddress;
+  constructor(p) {
+    this.value = p.value;
+    this.scheme = p.scheme;
+    this.host = p.host;
+    this.port = p.port;
+    this.path = p.path;
+    this.query = p.query;
+    this.fragment = p.fragment;
+    this.topLevelDomain = p.tld;
+    this.country = p.country;
+    this.isSecure = p.scheme === "https";
+    this.isExampleDomain = p.isExample;
+    this.isIpAddress = p.isIp;
+  }
+  static tryParse(input) {
+    if (input == null || input.trim() === "") return null;
+    const trimmed = (0, import_input_sanitization.sanitizeInput)(input).trim();
+    if (trimmed.length === 0 || trimmed.length > MAX_INPUT_LENGTH) return null;
+    let parsed = Url.#tryParseAbsolute(trimmed);
+    if (parsed == null) {
+      if (!trimmed.includes(".")) return null;
+      parsed = Url.#tryParseAbsolute("https://" + trimmed);
+      if (parsed == null) return null;
+    }
+    return parsed;
+  }
+  static parse(input) {
+    const r = Url.tryParse(input);
+    if (r === null) throw new Error("Invalid URL.");
+    return r;
+  }
+  /**
+   * The standard `URL` view of this value, for interop with `fetch` and other
+   * web APIs. The .NET port exposes the same thing as `ToUri()`.
+   */
+  toUrl() {
+    return new URL(this.value);
+  }
+  /** Creates a {@link Url} from a standard `URL`. Throws when it cannot be represented. */
+  static fromUrl(url) {
+    const r = Url.tryParse(url.href);
+    if (r === null) throw new Error("Invalid URL.");
+    return r;
+  }
+  static isValid(input) {
+    return Url.tryParse(input) !== null;
+  }
+  static format(input, options) {
+    const r = Url.tryParse(input);
+    if (r) return r.value;
+    if (options?.fallbackToTrimmedInputWhenInvalid && input != null && input.trim() !== "") {
+      return input.trim();
+    }
+    return null;
+  }
+  static normalize(input, options) {
+    return Url.format(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && Url.normalize(input) === input;
+  }
+  /** Returns the normalized URL, e.g. `https://www.example.com/path`. */
+  toNormalizedString() {
+    return this.value;
+  }
+  /** Returns the normalized URL, e.g. `https://www.example.com/path`. */
+  toString() {
+    return this.value;
+  }
+  /**
+   * Scans unstructured text for potential URLs. Heuristic — may include false positives.
+   */
+  static findCandidatesInText(text) {
+    if (!text) return [];
+    const out = [];
+    SCAN_PATTERN.lastIndex = 0;
+    let m;
+    while ((m = SCAN_PATTERN.exec(text)) !== null) {
+      const candidate = trimTrailingPunctuation(m[0]);
+      const url = Url.tryParse(candidate);
+      if (!url) continue;
+      out.push(
+        new import_text_candidate.TextCandidate({
+          startIndex: m.index,
+          length: candidate.length,
+          originalText: candidate,
+          typeName: "Url",
+          category: import_text_candidate_category.TextCandidateCategory.Contact,
+          normalizedForm: url.toNormalizedString(),
+          formattedForm: url.toString(),
+          maskedForm: maskUrl(url),
+          confidence: import_text_match_confidence.TextMatchConfidence.High,
+          value: url
+        })
+      );
+    }
+    return out;
+  }
+  equals(other) {
+    return other != null && this.value === other.value;
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    return this.value < other.value ? -1 : this.value > other.value ? 1 : 0;
+  }
+  static #tryParseAbsolute(input) {
+    const m = input.match(ABSOLUTE_URI);
+    if (!m) return null;
+    const scheme = m[1].toLowerCase();
+    if (scheme.includes(".")) return null;
+    const isHierarchical = HIERARCHICAL_RE.test(input);
+    if (isHierarchical) {
+      return Url.#parseHierarchical(input, scheme);
+    }
+    return Url.#parseNonHierarchical(input, scheme);
+  }
+  static #parseHierarchical(input, scheme) {
+    let u;
+    try {
+      u = new URL(input);
+    } catch {
+      return null;
+    }
+    const rawHost = u.hostname;
+    const isIp = rawHost.length > 0 && (IPV4.test(rawHost) || rawHost.startsWith("["));
+    let tld = "";
+    if (!isIp && rawHost.length > 0) {
+      const lastDot = rawHost.lastIndexOf(".");
+      tld = lastDot >= 0 ? rawHost.slice(lastDot + 1) : "";
+    }
+    let country = null;
+    if (!isIp && tld.length > 0) {
+      country = getTldCountryMap().get("." + tld) ?? null;
+    }
+    const isExample = !isIp && rawHost.length > 0 && (RESERVED_TLDS.has(tld.toLowerCase()) || RESERVED_DOMAINS.has(rawHost.toLowerCase()) || rawHost.toLowerCase().endsWith(".example.com") || rawHost.toLowerCase().endsWith(".example.org") || rawHost.toLowerCase().endsWith(".example.net"));
+    let port = null;
+    if (u.port !== "") port = parseInt(u.port, 10);
+    if (port != null && DEFAULT_PORTS[scheme] === port) port = null;
+    const normalized = u.href;
+    const path = u.pathname;
+    const query = u.search.length > 0 ? u.search.slice(1) : null;
+    const fragment = u.hash.length > 0 ? u.hash.slice(1) : null;
+    return new Url({
+      value: normalized,
+      scheme,
+      host: rawHost,
+      port,
+      path: path.length === 0 ? "/" : path,
+      query,
+      fragment,
+      tld,
+      country,
+      isExample,
+      isIp
+    });
+  }
+  static #parseNonHierarchical(input, scheme) {
+    const colonIdx = input.indexOf(":");
+    if (colonIdx < 0) return null;
+    const rest = input.slice(colonIdx + 1);
+    if (rest.length === 0) return null;
+    let host = "";
+    let tld = "";
+    let country = null;
+    let isExample = false;
+    let path = rest;
+    let query = null;
+    let fragment = null;
+    if (scheme === "mailto") {
+      const qIdx = rest.indexOf("?");
+      let mainPart = rest;
+      if (qIdx >= 0) {
+        mainPart = rest.slice(0, qIdx);
+        const fragIdx = rest.indexOf("#", qIdx);
+        if (fragIdx >= 0) {
+          query = rest.slice(qIdx + 1, fragIdx);
+          fragment = rest.slice(fragIdx + 1);
+        } else {
+          query = rest.slice(qIdx + 1);
+        }
+      } else {
+        const fragIdx = rest.indexOf("#");
+        if (fragIdx >= 0) {
+          mainPart = rest.slice(0, fragIdx);
+          fragment = rest.slice(fragIdx + 1);
+        }
+      }
+      const atIdx = mainPart.lastIndexOf("@");
+      if (atIdx >= 0) {
+        host = mainPart.slice(atIdx + 1).toLowerCase();
+        const lastDot = host.lastIndexOf(".");
+        tld = lastDot >= 0 ? host.slice(lastDot + 1) : "";
+        if (tld.length > 0) {
+          country = getTldCountryMap().get("." + tld) ?? null;
+        }
+        isExample = RESERVED_TLDS.has(tld.toLowerCase()) || RESERVED_DOMAINS.has(host) || host.endsWith(".example.com") || host.endsWith(".example.org") || host.endsWith(".example.net");
+      }
+      path = mainPart;
+    } else {
+      const qIdx = rest.indexOf("?");
+      if (qIdx >= 0) {
+        path = rest.slice(0, qIdx);
+        const fragIdx = rest.indexOf("#", qIdx);
+        if (fragIdx >= 0) {
+          query = rest.slice(qIdx + 1, fragIdx);
+          fragment = rest.slice(fragIdx + 1);
+        } else {
+          query = rest.slice(qIdx + 1);
+        }
+      } else {
+        const fragIdx = rest.indexOf("#");
+        if (fragIdx >= 0) {
+          path = rest.slice(0, fragIdx);
+          fragment = rest.slice(fragIdx + 1);
+        }
+      }
+    }
+    const normalized = `${scheme}:${rest}`;
+    return new Url({
+      value: normalized,
+      scheme,
+      host,
+      port: null,
+      path,
+      query,
+      fragment,
+      tld,
+      country,
+      isExample,
+      isIp: false
+    });
+  }
+}
+function trimTrailingPunctuation(value) {
+  let end = value.length;
+  while (end > 0) {
+    const ch = value[end - 1];
+    if (ch === "." || ch === "," || ch === ";" || ch === "!" || ch === "?" || ch === ")" || ch === "]" || ch === ">" || ch === "'" || ch === '"') {
+      if (ch === ")" && value.includes("(")) break;
+      if (ch === "]" && value.includes("[")) break;
+      end--;
+    } else {
+      break;
+    }
+  }
+  return end < value.length ? value.slice(0, end) : value;
+}
+function maskUrl(url) {
+  const schemePrefix = url.scheme + "://";
+  if (!url.value.toLowerCase().startsWith(schemePrefix)) {
+    return `${url.scheme}:***`;
+  }
+  let s = url.scheme + "://" + url.host;
+  if (url.port != null) s += ":" + url.port;
+  if (url.path === "/" || url.path === "") {
+    s += "/";
+  } else {
+    s += "/***";
+  }
+  if (url.query != null) s += "?***";
+  if (url.fragment != null) s += "#***";
+  return s;
+}
+//# sourceMappingURL=url.js.map

package/dist/cjs/web/url.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/web/url.ts"],
+  "sourcesContent": ["import { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { sanitizeInput } from \"../internal/input-sanitization.js\";\nimport { Country } from \"../geography/country.js\";\nimport { TextCandidateCategory } from \"../text-scanning/text-candidate-category.js\";\nimport { TextCandidate } from \"../text-scanning/text-candidate.js\";\nimport { TextMatchConfidence } from \"../text-scanning/text-match-confidence.js\";\n\nconst MAX_INPUT_LENGTH = 2048;\n\nconst RESERVED_TLDS = new Set([\"test\", \"example\", \"invalid\", \"localhost\"]);\nconst RESERVED_DOMAINS = new Set([\"example.com\", \"example.org\", \"example.net\"]);\n\nconst DEFAULT_PORTS: Record<string, number> = {\n  http: 80,\n  https: 443,\n  ftp: 21,\n  ws: 80,\n  wss: 443,\n  gopher: 70,\n};\n\nlet tldCountryMapCache: Map<string, Country> | null = null;\nfunction getTldCountryMap(): Map<string, Country> {\n  if (tldCountryMapCache) return tldCountryMapCache;\n  const m = new Map<string, Country>();\n  for (const c of Country.all) {\n    if (c.topLevelDomain) m.set(c.topLevelDomain.toLowerCase(), c);\n  }\n  tldCountryMapCache = m;\n  return m;\n}\n\nconst SCAN_PATTERN =\n  /(?:[a-zA-Z][\\w+.-]*:\\/\\/[^\\s<>\"']+|(?:mailto|tel|sms|callto):[^\\s<>\"']+|\\bwww\\.[^\\s<>\"']+)/gi;\n\nconst IPV4 = /^(?:\\d{1,3}\\.){3}\\d{1,3}$/;\nconst ABSOLUTE_URI = /^([a-zA-Z][a-zA-Z0-9+\\-.]*):/;\nconst HIERARCHICAL_RE = /^([a-zA-Z][a-zA-Z0-9+\\-.]*):\\/\\//;\n\ninterface UrlParts {\n  value: string;\n  scheme: string;\n  host: string;\n  port: number | null;\n  path: string;\n  query: string | null;\n  fragment: string | null;\n  tld: string;\n  country: Country | null;\n  isExample: boolean;\n  isIp: boolean;\n}\n\n/**\n * A URL or URI (`webbadress`). Accepts any valid URI scheme \u2014 `http`, `https`,\n * `mailto`, `tel`, `ssh`, custom schemes, etc. Bare domains like `example.com`\n * are auto-prefixed with `https://`. Reserved example/test domains per\n * RFC 2606 / RFC 6761 are flagged via `isExampleDomain`.\n */\nexport class Url {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"URL\",\n    localizedName: \"Webbadress\",\n    emoji: \"\\u{1F517}\",\n    sources: Object.freeze([\n      \"https://datatracker.ietf.org/doc/html/rfc3986\",\n      \"https://datatracker.ietf.org/doc/html/rfc2606\",\n      \"https://datatracker.ietf.org/doc/html/rfc6761\",\n    ]),\n  });\n\n  /** The normalized URL string, e.g. `https://www.example.com/path`. */\n  readonly value: string;\n  /** The URI scheme without `://`, e.g. `https`. */\n  readonly scheme: string;\n  /** The full hostname, e.g. `www.example.com`. Empty for non-hierarchical URIs. */\n  readonly host: string;\n  /** Explicit port, or `null` when the default port for the scheme is used. */\n  readonly port: number | null;\n  /** The path component, e.g. `/path/to/page`. Root paths are `/`. */\n  readonly path: string;\n  /** Query string without `?`, or `null` when absent. */\n  readonly query: string | null;\n  /** Fragment without `#`, or `null` when absent. */\n  readonly fragment: string | null;\n  /** Top-level domain without the dot, e.g. `com`, `se`. */\n  readonly topLevelDomain: string;\n  /** Country associated with a country-code TLD, or `null` for generic TLDs. */\n  readonly country: Country | null;\n  /** True when the scheme is `https`. */\n  readonly isSecure: boolean;\n  /** True when the host is a reserved example/test domain (RFC 2606 / RFC 6761). */\n  readonly isExampleDomain: boolean;\n  /** True when the host is an IP address. */\n  readonly isIpAddress: boolean;\n\n  private constructor(p: UrlParts) {\n    this.value = p.value;\n    this.scheme = p.scheme;\n    this.host = p.host;\n    this.port = p.port;\n    this.path = p.path;\n    this.query = p.query;\n    this.fragment = p.fragment;\n    this.topLevelDomain = p.tld;\n    this.country = p.country;\n    this.isSecure = p.scheme === \"https\";\n    this.isExampleDomain = p.isExample;\n    this.isIpAddress = p.isIp;\n  }\n\n  static tryParse(input: string | null | undefined): Url | null {\n    if (input == null || input.trim() === \"\") return null;\n\n    const trimmed = sanitizeInput(input).trim();\n    if (trimmed.length === 0 || trimmed.length > MAX_INPUT_LENGTH) return null;\n\n    let parsed = Url.#tryParseAbsolute(trimmed);\n    if (parsed == null) {\n      if (!trimmed.includes(\".\")) return null;\n      parsed = Url.#tryParseAbsolute(\"https://\" + trimmed);\n      if (parsed == null) return null;\n    }\n\n    return parsed;\n  }\n\n  static parse(input: string): Url {\n    const r = Url.tryParse(input);\n    if (r === null) throw new Error(\"Invalid URL.\");\n    return r;\n  }\n\n  /**\n   * The standard `URL` view of this value, for interop with `fetch` and other\n   * web APIs. The .NET port exposes the same thing as `ToUri()`.\n   */\n  toUrl(): URL {\n    return new URL(this.value);\n  }\n\n  /** Creates a {@link Url} from a standard `URL`. Throws when it cannot be represented. */\n  static fromUrl(url: URL): Url {\n    const r = Url.tryParse(url.href);\n    if (r === null) throw new Error(\"Invalid URL.\");\n    return r;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return Url.tryParse(input) !== null;\n  }\n\n  static format(\n    input: string | null | undefined,\n    options?: { fallbackToTrimmedInputWhenInvalid?: boolean },\n  ): string | null {\n    const r = Url.tryParse(input);\n    if (r) return r.value;\n    if (options?.fallbackToTrimmedInputWhenInvalid && input != null && input.trim() !== \"\") {\n      return input.trim();\n    }\n    return null;\n  }\n\n  static normalize(\n    input: string | null | undefined,\n    options?: { fallbackToTrimmedInputWhenInvalid?: boolean },\n  ): string | null {\n    return Url.format(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && Url.normalize(input) === input;\n  }\n\n  /** Returns the normalized URL, e.g. `https://www.example.com/path`. */\n  toNormalizedString(): string {\n    return this.value;\n  }\n\n  /** Returns the normalized URL, e.g. `https://www.example.com/path`. */\n  toString(): string {\n    return this.value;\n  }\n\n  /**\n   * Scans unstructured text for potential URLs. Heuristic \u2014 may include false positives.\n   */\n  static findCandidatesInText(text: string): readonly TextCandidate<Url>[] {\n    if (!text) return [];\n    const out: TextCandidate<Url>[] = [];\n    SCAN_PATTERN.lastIndex = 0;\n    let m: RegExpExecArray | null;\n    while ((m = SCAN_PATTERN.exec(text)) !== null) {\n      const candidate = trimTrailingPunctuation(m[0]);\n      const url = Url.tryParse(candidate);\n      if (!url) continue;\n      out.push(\n        new TextCandidate<Url>({\n          startIndex: m.index,\n          length: candidate.length,\n          originalText: candidate,\n          typeName: \"Url\",\n          category: TextCandidateCategory.Contact,\n          normalizedForm: url.toNormalizedString(),\n          formattedForm: url.toString(),\n          maskedForm: maskUrl(url),\n          confidence: TextMatchConfidence.High,\n          value: url,\n        }),\n      );\n    }\n    return out;\n  }\n\n  equals(other: Url | null | undefined): boolean {\n    return other != null && this.value === other.value;\n  }\n\n  compareTo(other: Url | null | undefined): number {\n    if (other == null) return 1;\n    return this.value < other.value ? -1 : this.value > other.value ? 1 : 0;\n  }\n\n  static #tryParseAbsolute(input: string): Url | null {\n    const m = input.match(ABSOLUTE_URI);\n    if (!m) return null;\n    const scheme = m[1]!.toLowerCase();\n    if (scheme.includes(\".\")) return null;\n\n    const isHierarchical = HIERARCHICAL_RE.test(input);\n    if (isHierarchical) {\n      return Url.#parseHierarchical(input, scheme);\n    }\n    return Url.#parseNonHierarchical(input, scheme);\n  }\n\n  static #parseHierarchical(input: string, scheme: string): Url | null {\n    let u: URL;\n    try {\n      u = new URL(input);\n    } catch {\n      return null;\n    }\n\n    const rawHost = u.hostname;\n    const isIp = rawHost.length > 0 && (IPV4.test(rawHost) || rawHost.startsWith(\"[\"));\n    let tld = \"\";\n    if (!isIp && rawHost.length > 0) {\n      const lastDot = rawHost.lastIndexOf(\".\");\n      tld = lastDot >= 0 ? rawHost.slice(lastDot + 1) : \"\";\n    }\n\n    let country: Country | null = null;\n    if (!isIp && tld.length > 0) {\n      country = getTldCountryMap().get(\".\" + tld) ?? null;\n    }\n\n    const isExample =\n      !isIp &&\n      rawHost.length > 0 &&\n      (RESERVED_TLDS.has(tld.toLowerCase()) ||\n        RESERVED_DOMAINS.has(rawHost.toLowerCase()) ||\n        rawHost.toLowerCase().endsWith(\".example.com\") ||\n        rawHost.toLowerCase().endsWith(\".example.org\") ||\n        rawHost.toLowerCase().endsWith(\".example.net\"));\n\n    let port: number | null = null;\n    if (u.port !== \"\") port = parseInt(u.port, 10);\n    if (port != null && DEFAULT_PORTS[scheme] === port) port = null;\n\n    const normalized = u.href;\n    const path = u.pathname;\n    const query = u.search.length > 0 ? u.search.slice(1) : null;\n    const fragment = u.hash.length > 0 ? u.hash.slice(1) : null;\n\n    return new Url({\n      value: normalized,\n      scheme,\n      host: rawHost,\n      port,\n      path: path.length === 0 ? \"/\" : path,\n      query,\n      fragment,\n      tld,\n      country,\n      isExample,\n      isIp,\n    });\n  }\n\n  static #parseNonHierarchical(input: string, scheme: string): Url | null {\n    const colonIdx = input.indexOf(\":\");\n    if (colonIdx < 0) return null;\n    const rest = input.slice(colonIdx + 1);\n    if (rest.length === 0) return null;\n\n    let host = \"\";\n    let tld = \"\";\n    let country: Country | null = null;\n    let isExample = false;\n    let path = rest;\n    let query: string | null = null;\n    let fragment: string | null = null;\n\n    if (scheme === \"mailto\") {\n      const qIdx = rest.indexOf(\"?\");\n      let mainPart = rest;\n      if (qIdx >= 0) {\n        mainPart = rest.slice(0, qIdx);\n        const fragIdx = rest.indexOf(\"#\", qIdx);\n        if (fragIdx >= 0) {\n          query = rest.slice(qIdx + 1, fragIdx);\n          fragment = rest.slice(fragIdx + 1);\n        } else {\n          query = rest.slice(qIdx + 1);\n        }\n      } else {\n        const fragIdx = rest.indexOf(\"#\");\n        if (fragIdx >= 0) {\n          mainPart = rest.slice(0, fragIdx);\n          fragment = rest.slice(fragIdx + 1);\n        }\n      }\n\n      const atIdx = mainPart.lastIndexOf(\"@\");\n      if (atIdx >= 0) {\n        host = mainPart.slice(atIdx + 1).toLowerCase();\n        const lastDot = host.lastIndexOf(\".\");\n        tld = lastDot >= 0 ? host.slice(lastDot + 1) : \"\";\n        if (tld.length > 0) {\n          country = getTldCountryMap().get(\".\" + tld) ?? null;\n        }\n        isExample =\n          RESERVED_TLDS.has(tld.toLowerCase()) ||\n          RESERVED_DOMAINS.has(host) ||\n          host.endsWith(\".example.com\") ||\n          host.endsWith(\".example.org\") ||\n          host.endsWith(\".example.net\");\n      }\n      path = mainPart;\n    } else {\n      const qIdx = rest.indexOf(\"?\");\n      if (qIdx >= 0) {\n        path = rest.slice(0, qIdx);\n        const fragIdx = rest.indexOf(\"#\", qIdx);\n        if (fragIdx >= 0) {\n          query = rest.slice(qIdx + 1, fragIdx);\n          fragment = rest.slice(fragIdx + 1);\n        } else {\n          query = rest.slice(qIdx + 1);\n        }\n      } else {\n        const fragIdx = rest.indexOf(\"#\");\n        if (fragIdx >= 0) {\n          path = rest.slice(0, fragIdx);\n          fragment = rest.slice(fragIdx + 1);\n        }\n      }\n    }\n\n    const normalized = `${scheme}:${rest}`;\n    return new Url({\n      value: normalized,\n      scheme,\n      host,\n      port: null,\n      path,\n      query,\n      fragment,\n      tld,\n      country,\n      isExample,\n      isIp: false,\n    });\n  }\n}\n\nfunction trimTrailingPunctuation(value: string): string {\n  let end = value.length;\n  while (end > 0) {\n    const ch = value[end - 1];\n    if (\n      ch === \".\" ||\n      ch === \",\" ||\n      ch === \";\" ||\n      ch === \"!\" ||\n      ch === \"?\" ||\n      ch === \")\" ||\n      ch === \"]\" ||\n      ch === \">\" ||\n      ch === \"'\" ||\n      ch === '\"'\n    ) {\n      if (ch === \")\" && value.includes(\"(\")) break;\n      if (ch === \"]\" && value.includes(\"[\")) break;\n      end--;\n    } else {\n      break;\n    }\n  }\n  return end < value.length ? value.slice(0, end) : value;\n}\n\n/**\n * Returns a masked URL showing the scheme and host but obscuring the path,\n * query, and fragment, e.g.\n * `https://www.example.com/my/secret/page?key=val` \u2192\n * `https://www.example.com/***?***`.\n * For non-hierarchical URIs (mailto:, tel:), returns `scheme:***`.\n */\nexport function maskUrl(url: Url): string {\n  const schemePrefix = url.scheme + \"://\";\n  if (!url.value.toLowerCase().startsWith(schemePrefix)) {\n    return `${url.scheme}:***`;\n  }\n\n  let s = url.scheme + \"://\" + url.host;\n  if (url.port != null) s += \":\" + url.port;\n\n  if (url.path === \"/\" || url.path === \"\") {\n    s += \"/\";\n  } else {\n    s += \"/***\";\n  }\n\n  if (url.query != null) s += \"?***\";\n  if (url.fragment != null) s += \"#***\";\n  return s;\n}\n"],
+  "mappings": "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",
+  "names": []
+}