parse-domain 8.2.2 → 8.3.1

package/README.md

@@ -63,7 +63,8 @@ npm install parse-domain
 There is the utility function [`fromUrl`](#api-js-fromUrl) which tries to extract the hostname from a (partial) URL and puny-encodes it:
 
 ```javascript
-import { parseDomain, fromUrl } from "parse-domain";
+import { toUnicode } from "punycode";
+import { fromUrl, parseDomain } from "parse-domain";
 
 const { subDomains, domain, topLevelDomains } = parseDomain(
   fromUrl("https://www.münchen.de?query"),
@@ -74,8 +75,6 @@ console.log(domain); // "xn--mnchen-3ya"
 console.log(topLevelDomains); // ["de"]
 
 // You can use the 'punycode' NPM package to decode the domain again
-import { toUnicode } from "punycode";
-
 console.log(toUnicode(domain)); // "münchen"
 ```
 
@@ -326,9 +325,7 @@ Takes a URL-like string and tries to extract the hostname. Requires the global [
 
 ```ts
 export type ParseDomainOptions = {
-  /**
-   * If no validation is specified, Validation.Strict will be used.
-   **/
+  /** If no validation is specified, Validation.Strict will be used. */
   validation?: Validation;
 };
 ```
@@ -342,17 +339,17 @@ An object that holds all possible [Validation](#api-ts-Validation) `validation`
 ```javascript
 export const Validation = {
   /**
-   * Allows any octets as labels
-   * but still restricts the length of labels and the overall domain.
+   * Allows any octets as labels but still restricts the length of labels and
+   * the overall domain.
    *
    * @see https://www.rfc-editor.org/rfc/rfc2181#section-11
-   **/
+   */
   Lax: "LAX",
 
   /**
-   * Only allows ASCII letters, digits and hyphens (aka LDH),
-   * forbids hyphens at the beginning or end of a label
-   * and requires top-level domain names not to be all-numeric.
+   * Only allows ASCII letters, digits and hyphens (aka LDH), forbids hyphens at
+   * the beginning or end of a label and requires top-level domain names not to
+   * be all-numeric.
    *
    * This is the default if no validation is configured.
    *
@@ -418,14 +415,6 @@ type ParseResultInvalid = {
   hostname: string | typeof NO_HOSTNAME;
   errors: Array<ValidationError>;
 };
-
-// Example
-
-{
-  type: "INVALID",
-  hostname: ".com",
-  errors: [...]
-}
 ```
 
 <h3 id="api-ts-ValidationError">
@@ -440,14 +429,6 @@ type ValidationError = {
   message: string;
   column: number;
 };
-
-// Example
-
-{
-  type: "LABEL_MIN_LENGTH",
-  message: `Label "" is too short. Label is 0 octets long but should be at least 1.`,
-  column: 1,
-}
 ```
 
 <h3 id="api-js-ValidationErrorType">
@@ -485,14 +466,6 @@ type ParseResultIp = {
   hostname: string;
   ipVersion: 4 | 6;
 };
-
-// Example
-
-{
-  type: "IP",
-  hostname: "192.168.0.1",
-  ipVersion: 4
-}
 ```
 
 According to [RFC 3986](https://tools.ietf.org/html/rfc3986#section-3.2.2), IPv6 addresses need to be surrounded by `[` and `]` in URLs. [`parseDomain`](#api-js-parseDomain) accepts both IPv6 address with and without square brackets:
@@ -520,14 +493,6 @@ type ParseResultReserved = {
   hostname: string;
   labels: Array<string>;
 };
-
-// Example
-
-{
-  type: "RESERVED",
-  hostname: "pecorino.local",
-  labels: ["pecorino", "local"]
-}
 ```
 
 ⚠️ Reserved IPs, such as `127.0.0.1`, will not be reported as reserved, but as <a href="#-export-parseresultip">`ParseResultIp`</a>. See [#117](https://github.com/peerigon/parse-domain/issues/117).
@@ -544,14 +509,6 @@ type ParseResultNotListed = {
   hostname: string;
   labels: Array<string>;
 };
-
-// Example
-
-{
-  type: "NOT_LISTED",
-  hostname: "this.is.not-listed",
-  labels: ["this", "is", "not-listed"]
-}
 ```
 
 <h3 id="api-ts-ParseResultListed">
@@ -574,22 +531,6 @@ type ParseResultListed = {
     topLevelDomains: Array<string>;
   };
 };
-
-// Example
-
-{
-  type: "LISTED",
-  hostname: "parse-domain.github.io",
-  labels: ["parse-domain", "github", "io"]
-  subDomains: [],
-  domain: "parse-domain",
-  topLevelDomains: ["github", "io"],
-  icann: {
-    subDomains: ["parse-domain"],
-    domain: "github",
-    topLevelDomains: ["io"]
-  }
-}
 ```
 
 ## License

package/dist/bin/update.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=update.d.ts.map

package/dist/bin/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/bin/update.ts"],"names":[],"mappings":""}

package/dist/bin/update.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+import * as fs from "node:fs";
+import { EOL } from "node:os";
+import * as path from "node:path";
+import { fetchBuildSerializeTries } from "../update-tries.js";
+const serializedTriesDir = path.resolve(import.meta.dirname, "../../serialized-tries");
+const { serializedIcannTrie, serializedPrivateTrie } = await fetchBuildSerializeTries();
+await fs.promises.mkdir(serializedTriesDir, { recursive: true });
+await Promise.all([
+    fs.promises.writeFile(path.join(serializedTriesDir, "icann.js"), `export default ${JSON.stringify(serializedIcannTrie)};`),
+    fs.promises.writeFile(path.join(serializedTriesDir, "private.js"), `export default ${JSON.stringify(serializedPrivateTrie)};`),
+    fs.promises.writeFile(path.join(serializedTriesDir, "info.json"), JSON.stringify({ updatedAt: new Date() })),
+]);
+process.stderr.write("Running smoke test... ");
+const { runSmokeTest } = await import("../smoke-test.js");
+runSmokeTest();
+process.stdout.write("ok" + EOL);
+//# sourceMappingURL=update.js.map

package/dist/bin/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/bin/update.ts"],"names":[],"mappings":";AACA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,MAAM,kBAAkB,GAAG,IAAI,CAAC,OAAO,CACrC,MAAM,CAAC,IAAI,CAAC,OAAO,EACnB,wBAAwB,CACzB,CAAC;AAEF,MAAM,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,GAClD,MAAM,wBAAwB,EAAE,CAAC;AAEnC,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,kBAAkB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAEjE,MAAM,OAAO,CAAC,GAAG,CAAC;IAChB,EAAE,CAAC,QAAQ,CAAC,SAAS,CACnB,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,UAAU,CAAC,EACzC,kBAAkB,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAAC,GAAG,CACzD;IACD,EAAE,CAAC,QAAQ,CAAC,SAAS,CACnB,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,YAAY,CAAC,EAC3C,kBAAkB,IAAI,CAAC,SAAS,CAAC,qBAAqB,CAAC,GAAG,CAC3D;IACD,EAAE,CAAC,QAAQ,CAAC,SAAS,CACnB,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,WAAW,CAAC,EAC1C,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC,CAC1C;CACF,CAAC,CAAC;AAEH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;AAC/C,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;AAC1D,YAAY,EAAE,CAAC;AACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC","sourcesContent":["#!/usr/bin/env node\nimport * as fs from \"node:fs\";\nimport { EOL } from \"node:os\";\nimport * as path from \"node:path\";\nimport { fetchBuildSerializeTries } from \"../update-tries.js\";\n\nconst serializedTriesDir = path.resolve(\n  import.meta.dirname,\n  \"../../serialized-tries\",\n);\n\nconst { serializedIcannTrie, serializedPrivateTrie } =\n  await fetchBuildSerializeTries();\n\nawait fs.promises.mkdir(serializedTriesDir, { recursive: true });\n\nawait Promise.all([\n  fs.promises.writeFile(\n    path.join(serializedTriesDir, \"icann.js\"),\n    `export default ${JSON.stringify(serializedIcannTrie)};`,\n  ),\n  fs.promises.writeFile(\n    path.join(serializedTriesDir, \"private.js\"),\n    `export default ${JSON.stringify(serializedPrivateTrie)};`,\n  ),\n  fs.promises.writeFile(\n    path.join(serializedTriesDir, \"info.json\"),\n    JSON.stringify({ updatedAt: new Date() }),\n  ),\n]);\n\nprocess.stderr.write(\"Running smoke test... \");\nconst { runSmokeTest } = await import(\"../smoke-test.js\");\nrunSmokeTest();\nprocess.stdout.write(\"ok\" + EOL);\n"]}

package/{build → dist}/config.d.ts

@@ -4,3 +4,4 @@ export declare const PUBLIC_SUFFIX_MARKER_ICANN_END = "// ===END ICANN DOMAINS==
 export declare const PUBLIC_SUFFIX_MARKER_PRIVATE_START = "// ===BEGIN PRIVATE DOMAINS===";
 export declare const PUBLIC_SUFFIX_MARKER_PRIVATE_END = "// ===END PRIVATE DOMAINS===";
 export declare const FETCH_PSL_EXPECTED_MIN_LENGTH = 313150;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,yDAC0B,CAAC;AACzD,eAAO,MAAM,gCAAgC,iCAAiC,CAAC;AAC/E,eAAO,MAAM,8BAA8B,+BAA+B,CAAC;AAC3E,eAAO,MAAM,kCAAkC,mCACb,CAAC;AACnC,eAAO,MAAM,gCAAgC,iCAAiC,CAAC;AAC/E,eAAO,MAAM,6BAA6B,SAAU,CAAC"}

package/{build → dist}/config.js

@@ -3,5 +3,5 @@ export const PUBLIC_SUFFIX_MARKER_ICANN_START = "// ===BEGIN ICANN DOMAINS===";
 export const PUBLIC_SUFFIX_MARKER_ICANN_END = "// ===END ICANN DOMAINS===";
 export const PUBLIC_SUFFIX_MARKER_PRIVATE_START = "// ===BEGIN PRIVATE DOMAINS===";
 export const PUBLIC_SUFFIX_MARKER_PRIVATE_END = "// ===END PRIVATE DOMAINS===";
-export const FETCH_PSL_EXPECTED_MIN_LENGTH = 313150;
+export const FETCH_PSL_EXPECTED_MIN_LENGTH = 313_150;
 //# sourceMappingURL=config.js.map

package/{build → dist}/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAC5B,sDAAsD,CAAC;AACzD,MAAM,CAAC,MAAM,gCAAgC,GAAG,8BAA8B,CAAC;AAC/E,MAAM,CAAC,MAAM,8BAA8B,GAAG,4BAA4B,CAAC;AAC3E,MAAM,CAAC,MAAM,kCAAkC,GAC7C,gCAAgC,CAAC;AACnC,MAAM,CAAC,MAAM,gCAAgC,GAAG,8BAA8B,CAAC;AAC/E,MAAM,CAAC,MAAM,6BAA6B,GAAG,MAAM,CAAC","sourcesContent":["export const PUBLIC_SUFFIX_URL =\n  \"https://publicsuffix.org/list/public_suffix_list.dat\";\nexport const PUBLIC_SUFFIX_MARKER_ICANN_START = \"// ===BEGIN ICANN DOMAINS===\";\nexport const PUBLIC_SUFFIX_MARKER_ICANN_END = \"// ===END ICANN DOMAINS===\";\nexport const PUBLIC_SUFFIX_MARKER_PRIVATE_START =\n  \"// ===BEGIN PRIVATE DOMAINS===\";\nexport const PUBLIC_SUFFIX_MARKER_PRIVATE_END = \"// ===END PRIVATE DOMAINS===\";\nexport const FETCH_PSL_EXPECTED_MIN_LENGTH = 313150;\n"]}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAC5B,sDAAsD,CAAC;AACzD,MAAM,CAAC,MAAM,gCAAgC,GAAG,8BAA8B,CAAC;AAC/E,MAAM,CAAC,MAAM,8BAA8B,GAAG,4BAA4B,CAAC;AAC3E,MAAM,CAAC,MAAM,kCAAkC,GAC7C,gCAAgC,CAAC;AACnC,MAAM,CAAC,MAAM,gCAAgC,GAAG,8BAA8B,CAAC;AAC/E,MAAM,CAAC,MAAM,6BAA6B,GAAG,OAAO,CAAC","sourcesContent":["export const PUBLIC_SUFFIX_URL =\n  \"https://publicsuffix.org/list/public_suffix_list.dat\";\nexport const PUBLIC_SUFFIX_MARKER_ICANN_START = \"// ===BEGIN ICANN DOMAINS===\";\nexport const PUBLIC_SUFFIX_MARKER_ICANN_END = \"// ===END ICANN DOMAINS===\";\nexport const PUBLIC_SUFFIX_MARKER_PRIVATE_START =\n  \"// ===BEGIN PRIVATE DOMAINS===\";\nexport const PUBLIC_SUFFIX_MARKER_PRIVATE_END = \"// ===END PRIVATE DOMAINS===\";\nexport const FETCH_PSL_EXPECTED_MIN_LENGTH = 313_150;\n"]}

package/{build → dist}/from-url.d.ts

@@ -1,2 +1,3 @@
 export declare const NO_HOSTNAME: unique symbol;
 export declare const fromUrl: (urlLike: string) => string | typeof NO_HOSTNAME;
+//# sourceMappingURL=from-url.d.ts.map

package/dist/from-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"from-url.d.ts","sourceRoot":"","sources":["../src/from-url.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,WAAW,EAAE,OAAO,MAA8B,CAAC;AAEhE,eAAO,MAAM,OAAO,GAAI,SAAS,MAAM,KAAG,MAAM,GAAG,OAAO,WA8BzD,CAAC"}

package/{build → dist}/from-url.js

@@ -4,7 +4,7 @@ export const NO_HOSTNAME = Symbol("NO_HOSTNAME");
 export const fromUrl = (urlLike) => {
     /* istanbul ignore next */
     if (typeof URL !== "function") {
-        throw new Error("Looks like the new URL() constructor is not globally available in your environment. Please make sure to use a polyfill.");
+        throw new TypeError("Looks like the new URL() constructor is not globally available in your environment. Please make sure to use a polyfill.");
     }
     // Extra check for non-TypeScript users
     if (typeof urlLike !== "string") {
@@ -23,7 +23,7 @@ export const fromUrl = (urlLike) => {
     try {
         return new URL(url).hostname;
     }
-    catch (_a) {
+    catch {
         return NO_HOSTNAME;
     }
 };

package/dist/from-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"from-url.js","sourceRoot":"","sources":["../src/from-url.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,GAAG,wBAAwB,CAAC;AAC5C,MAAM,kBAAkB,GACtB,wDAAwD,CAAC;AAE3D,MAAM,CAAC,MAAM,WAAW,GAAkB,MAAM,CAAC,aAAa,CAAC,CAAC;AAEhE,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,OAAe,EAA+B,EAAE;IACtE,0BAA0B;IAC1B,IAAI,OAAO,GAAG,KAAK,UAAU,EAAE,CAAC;QAC9B,MAAM,IAAI,SAAS,CACjB,yHAAyH,CAC1H,CAAC;IACJ,CAAC;IAED,uCAAuC;IACvC,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,gDAAgD;IAChD,IAAI,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;QAChC,CAAC,CAAC,QAAQ,OAAO,EAAE;QACnB,CAAC,CAAC,wDAAwD;YACxD,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;gBACvB,CAAC,CAAC,OAAO;gBACT,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC;oBACxB,CAAC,CAAC,OAAO;oBACT,CAAC,CAAC,UAAU,OAAO,EAAE,CAAC;IAE5B,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC;IAElD,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,WAAW,CAAC;IACrB,CAAC;AACH,CAAC,CAAC","sourcesContent":["const urlPattern = /^[a-z][*+.a-z-]+:\\/\\//i;\nconst invalidIpv6Pattern =\n  /^([a-z][*+.a-z-]+:\\/\\/)([^[][^/?]*:[^/?]*:[^/?]*)(.*)/i;\n\nexport const NO_HOSTNAME: unique symbol = Symbol(\"NO_HOSTNAME\");\n\nexport const fromUrl = (urlLike: string): string | typeof NO_HOSTNAME => {\n  /* istanbul ignore next */\n  if (typeof URL !== \"function\") {\n    throw new TypeError(\n      \"Looks like the new URL() constructor is not globally available in your environment. Please make sure to use a polyfill.\",\n    );\n  }\n\n  // Extra check for non-TypeScript users\n  if (typeof urlLike !== \"string\") {\n    return NO_HOSTNAME;\n  }\n\n  // URLs that start with // are protocol relative\n  let url = urlLike.startsWith(\"//\")\n    ? `http:${urlLike}`\n    : // URLs that start with / do not have a hostname section\n      urlLike.startsWith(\"/\")\n      ? urlLike\n      : urlPattern.test(urlLike)\n        ? urlLike\n        : `http://${urlLike}`;\n\n  url = url.replace(invalidIpv6Pattern, \"$1[$2]$3\");\n\n  try {\n    return new URL(url).hostname;\n  } catch {\n    return NO_HOSTNAME;\n  }\n};\n"]}

package/dist/main.d.ts

@@ -0,0 +1,6 @@
+export { parseDomain, ParseResultType } from "./parse-domain.js";
+export type { ParseResult, ParseResultInvalid, ParseResultReserved, ParseResultNotListed, ParseResultListed, ParseResultIp, } from "./parse-domain.js";
+export { fromUrl, NO_HOSTNAME } from "./from-url.js";
+export { Validation, ValidationErrorType } from "./sanitize.js";
+export type { ValidationError } from "./sanitize.js";
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACjE,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAChE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/main.js

@@ -0,0 +1,6 @@
+/* istanbul ignore file */
+// Jest will report function coverage errors here otherwise
+export { parseDomain, ParseResultType } from "./parse-domain.js";
+export { fromUrl, NO_HOSTNAME } from "./from-url.js";
+export { Validation, ValidationErrorType } from "./sanitize.js";
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,2DAA2D;AAC3D,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AASjE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC","sourcesContent":["/* istanbul ignore file */\n// Jest will report function coverage errors here otherwise\nexport { parseDomain, ParseResultType } from \"./parse-domain.js\";\nexport type {\n  ParseResult,\n  ParseResultInvalid,\n  ParseResultReserved,\n  ParseResultNotListed,\n  ParseResultListed,\n  ParseResultIp,\n} from \"./parse-domain.js\";\nexport { fromUrl, NO_HOSTNAME } from \"./from-url.js\";\nexport { Validation, ValidationErrorType } from \"./sanitize.js\";\nexport type { ValidationError } from \"./sanitize.js\";\n"]}

package/{build → dist}/parse-domain.d.ts

@@ -1,50 +1,52 @@
-import { ValidationError, SanitizationResultValidIp, Validation } from "./sanitize.js";
 import { NO_HOSTNAME } from "./from-url.js";
+import { Validation, type SanitizationResultValidIp, type ValidationError } from "./sanitize.js";
 export declare const RESERVED_TOP_LEVEL_DOMAINS: string[];
 export type Label = string;
 export declare enum ParseResultType {
     /**
-     * This parse result is returned in case the given hostname does not adhere to [RFC 1034](https://tools.ietf.org/html/rfc1034).
+     * This parse result is returned in case the given hostname does not adhere to
+     * [RFC 1034](https://tools.ietf.org/html/rfc1034).
      */
     Invalid = "INVALID",
-    /**
-     * This parse result is returned if the given hostname was an IPv4 or IPv6.
-     */
+    /** This parse result is returned if the given hostname was an IPv4 or IPv6. */
     Ip = "IP",
     /**
      * This parse result is returned when the given hostname
-     * - is the root domain (the empty string `""`)
-     * - belongs to the top-level domain `localhost`, `local`, `example`, `invalid` or `test`
+     *
+     * - Is the root domain (the empty string `""`)
+     * - Belongs to the top-level domain `localhost`, `local`, `example`, `invalid`
+     *   or `test`
      */
     Reserved = "RESERVED",
     /**
-     * This parse result is returned when the given hostname is valid and does not belong to a reserved top-level domain, but is not listed in the public suffix list.
+     * This parse result is returned when the given hostname is valid and does not
+     * belong to a reserved top-level domain, but is not listed in the public
+     * suffix list.
      */
     NotListed = "NOT_LISTED",
     /**
-     * This parse result is returned when the given hostname belongs to a top-level domain that is listed in the public suffix list.
+     * This parse result is returned when the given hostname belongs to a
+     * top-level domain that is listed in the public suffix list.
      */
     Listed = "LISTED"
 }
 type ParseResultCommon<Type extends ParseResultType> = {
     /**
-     * The type of the parse result. Use switch or if to distinguish between different results.
+     * The type of the parse result. Use switch or if to distinguish between
+     * different results.
      */
     type: Type;
-    /**
-     * The original hostname that was passed to parseDomain().
-     */
+    /** The original hostname that was passed to parseDomain(). */
     hostname: Type extends ParseResultType.Invalid ? string | typeof NO_HOSTNAME : string;
 };
 export type ParseResultInvalid = ParseResultCommon<ParseResultType.Invalid> & {
-    /**
-     * An array of validation errors.
-     */
+    /** An array of validation errors. */
     errors: Array<ValidationError>;
 };
 type ParseResultCommonValidDomain = {
     /**
-     * An array of labels that were separated by a dot character in the given hostname.
+     * An array of labels that were separated by a dot character in the given
+     * hostname.
      */
     labels: Array<Label>;
 };
@@ -53,33 +55,32 @@ export type ParseResultReserved = ParseResultCommon<ParseResultType.Reserved> &
 export type ParseResultNotListed = ParseResultCommon<ParseResultType.NotListed> & ParseResultCommonValidDomain;
 type ParseResultListedDomains = {
     /**
-     * An array of labels that belong to the subdomain. Can be empty if there was no subdomain in the given hostname.
+     * An array of labels that belong to the subdomain. Can be empty if there was
+     * no subdomain in the given hostname.
      */
     subDomains: Array<Label>;
     /**
-     * The first label that belongs to the user-controlled section of the hostname. Can be undefined if just a top-level domain was passed to parseDomain().
+     * The first label that belongs to the user-controlled section of the
+     * hostname. Can be undefined if just a top-level domain was passed to
+     * parseDomain().
      */
     domain: Label | undefined;
-    /**
-     * An array of labels that are controlled by the domain registrar.
-     */
+    /** An array of labels that are controlled by the domain registrar. */
     topLevelDomains: Array<Label>;
 };
 export type ParseResultListed = ParseResultCommon<ParseResultType.Listed> & ParseResultCommonValidDomain & ParseResultListedDomains & {
     /**
-     * The parse result according to ICANN only without private top-level domains.
+     * The parse result according to ICANN only without private top-level
+     * domains.
      */
     icann: ParseResultListedDomains;
 };
 export type ParseResult = ParseResultInvalid | ParseResultIp | ParseResultReserved | ParseResultNotListed | ParseResultListed;
 export type ParseDomainOptions = {
-    /**
-     * If no validation is specified, Validation.Strict will be used.
-     **/
+    /** If no validation is specified, Validation.Strict will be used. */
     validation?: Validation;
 };
-/**
- * Splits the given hostname in topLevelDomains, a domain and subDomains.
- */
+/** Splits the given hostname in topLevelDomains, a domain and subDomains. */
 export declare const parseDomain: (hostname: string | typeof NO_HOSTNAME, options?: ParseDomainOptions) => ParseResult;
 export {};
+//# sourceMappingURL=parse-domain.d.ts.map

package/dist/parse-domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-domain.d.ts","sourceRoot":"","sources":["../src/parse-domain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAGL,UAAU,EACV,KAAK,yBAAyB,EAC9B,KAAK,eAAe,EACrB,MAAM,eAAe,CAAC;AAMvB,eAAO,MAAM,0BAA0B,UAMtC,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC;AAE3B,oBAAY,eAAe;IACzB;;;OAGG;IACH,OAAO,YAAY;IACnB,+EAA+E;IAC/E,EAAE,OAAO;IACT;;;;;;OAMG;IACH,QAAQ,aAAa;IACrB;;;;OAIG;IACH,SAAS,eAAe;IACxB;;;OAGG;IACH,MAAM,WAAW;CAClB;AAMD,KAAK,iBAAiB,CAAC,IAAI,SAAS,eAAe,IAAI;IACrD;;;OAGG;IACH,IAAI,EAAE,IAAI,CAAC;IACX,8DAA8D;IAC9D,QAAQ,EAAE,IAAI,SAAS,eAAe,CAAC,OAAO,GAC1C,MAAM,GAAG,OAAO,WAAW,GAC3B,MAAM,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,eAAe,CAAC,OAAO,CAAC,GAAG;IAC5E,qCAAqC;IACrC,MAAM,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC;CAChC,CAAC;AAEF,KAAK,4BAA4B,GAAG;IAClC;;;OAGG;IACH,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,iBAAiB,CAAC,eAAe,CAAC,EAAE,CAAC,GAC/D,IAAI,CAAC,yBAAyB,EAAE,WAAW,CAAC,CAAC;AAE/C,MAAM,MAAM,mBAAmB,GAAG,iBAAiB,CAAC,eAAe,CAAC,QAAQ,CAAC,GAC3E,4BAA4B,CAAC;AAE/B,MAAM,MAAM,oBAAoB,GAC9B,iBAAiB,CAAC,eAAe,CAAC,SAAS,CAAC,GAAG,4BAA4B,CAAC;AAE9E,KAAK,wBAAwB,GAAG;IAC9B;;;OAGG;IACH,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IACzB;;;;OAIG;IACH,MAAM,EAAE,KAAK,GAAG,SAAS,CAAC;IAC1B,sEAAsE;IACtE,eAAe,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,eAAe,CAAC,MAAM,CAAC,GACvE,4BAA4B,GAC5B,wBAAwB,GAAG;IACzB;;;OAGG;IACH,KAAK,EAAE,wBAAwB,CAAC;CACjC,CAAC;AAEJ,MAAM,MAAM,WAAW,GACnB,kBAAkB,GAClB,aAAa,GACb,mBAAmB,GACnB,oBAAoB,GACpB,iBAAiB,CAAC;AAuBtB,MAAM,MAAM,kBAAkB,GAAG;IAC/B,qEAAqE;IACrE,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,WAAW,GACtB,UAAU,MAAM,GAAG,OAAO,WAAW,EACrC,UAAU,kBAAkB,KAC3B,WA8DF,CAAC"}

package/{build → dist}/parse-domain.js

@@ -1,6 +1,7 @@
+import { NO_HOSTNAME } from "./from-url.js";
+import { SanitizationResultType, sanitize, Validation, } from "./sanitize.js";
 import { icannTrie, privateTrie } from "./serialized-tries.js";
 import { lookUpTldsInTrie } from "./trie/look-up.js";
-import { sanitize, SanitizationResultType, } from "./sanitize.js";
 import { parseTrie } from "./trie/parse-trie.js";
 export const RESERVED_TOP_LEVEL_DOMAINS = [
     "localhost",
@@ -12,25 +13,29 @@ export const RESERVED_TOP_LEVEL_DOMAINS = [
 export var ParseResultType;
 (function (ParseResultType) {
     /**
-     * This parse result is returned in case the given hostname does not adhere to [RFC 1034](https://tools.ietf.org/html/rfc1034).
+     * This parse result is returned in case the given hostname does not adhere to
+     * [RFC 1034](https://tools.ietf.org/html/rfc1034).
      */
     ParseResultType["Invalid"] = "INVALID";
-    /**
-     * This parse result is returned if the given hostname was an IPv4 or IPv6.
-     */
+    /** This parse result is returned if the given hostname was an IPv4 or IPv6. */
     ParseResultType["Ip"] = "IP";
     /**
      * This parse result is returned when the given hostname
-     * - is the root domain (the empty string `""`)
-     * - belongs to the top-level domain `localhost`, `local`, `example`, `invalid` or `test`
+     *
+     * - Is the root domain (the empty string `""`)
+     * - Belongs to the top-level domain `localhost`, `local`, `example`, `invalid`
+     *   or `test`
      */
     ParseResultType["Reserved"] = "RESERVED";
     /**
-     * This parse result is returned when the given hostname is valid and does not belong to a reserved top-level domain, but is not listed in the public suffix list.
+     * This parse result is returned when the given hostname is valid and does not
+     * belong to a reserved top-level domain, but is not listed in the public
+     * suffix list.
      */
     ParseResultType["NotListed"] = "NOT_LISTED";
     /**
-     * This parse result is returned when the given hostname belongs to a top-level domain that is listed in the public suffix list.
+     * This parse result is returned when the given hostname belongs to a
+     * top-level domain that is listed in the public suffix list.
      */
     ParseResultType["Listed"] = "LISTED";
 })(ParseResultType || (ParseResultType = {}));
@@ -46,9 +51,7 @@ const splitLabelsIntoDomains = (labels, index) => {
 };
 let parsedIcannTrie;
 let parsedPrivateTrie;
-/**
- * Splits the given hostname in topLevelDomains, a domain and subDomains.
- */
+/** Splits the given hostname in topLevelDomains, a domain and subDomains. */
 export const parseDomain = (hostname, options) => {
     const sanitizationResult = sanitize(hostname, options);
     if (sanitizationResult.type === SanitizationResultType.Error) {
@@ -66,8 +69,11 @@ export const parseDomain = (hostname, options) => {
         };
     }
     const { labels, domain } = sanitizationResult;
+    // We do not want to break compatibility with older engines unnecessarily.
+    // eslint-disable-next-line unicorn/prefer-at
+    const lastLabel = labels[labels.length - 1];
     if (hostname === "" ||
-        RESERVED_TOP_LEVEL_DOMAINS.includes(labels[labels.length - 1])) {
+        (lastLabel !== undefined && RESERVED_TOP_LEVEL_DOMAINS.includes(lastLabel))) {
         return {
             type: ParseResultType.Reserved,
             hostname: domain,
@@ -75,8 +81,8 @@ export const parseDomain = (hostname, options) => {
         };
     }
     // Parse the serialized trie lazily
-    parsedIcannTrie = parsedIcannTrie !== null && parsedIcannTrie !== void 0 ? parsedIcannTrie : parseTrie(icannTrie);
-    parsedPrivateTrie = parsedPrivateTrie !== null && parsedPrivateTrie !== void 0 ? parsedPrivateTrie : parseTrie(privateTrie);
+    parsedIcannTrie = parsedIcannTrie ?? parseTrie(icannTrie);
+    parsedPrivateTrie = parsedPrivateTrie ?? parseTrie(privateTrie);
     const icannTlds = lookUpTldsInTrie(labels, parsedIcannTrie);
     const privateTlds = lookUpTldsInTrie(labels, parsedPrivateTrie);
     if (icannTlds.length === 0 && privateTlds.length === 0) {
@@ -88,6 +94,12 @@ export const parseDomain = (hostname, options) => {
     }
     const indexOfPublicSuffixDomain = labels.length - Math.max(privateTlds.length, icannTlds.length) - 1;
     const indexOfIcannDomain = labels.length - icannTlds.length - 1;
-    return Object.assign({ type: ParseResultType.Listed, hostname: domain, labels, icann: splitLabelsIntoDomains(labels, indexOfIcannDomain) }, splitLabelsIntoDomains(labels, indexOfPublicSuffixDomain));
+    return {
+        type: ParseResultType.Listed,
+        hostname: domain,
+        labels,
+        icann: splitLabelsIntoDomains(labels, indexOfIcannDomain),
+        ...splitLabelsIntoDomains(labels, indexOfPublicSuffixDomain),
+    };
 };
 //# sourceMappingURL=parse-domain.js.map

package/dist/parse-domain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-domain.js","sourceRoot":"","sources":["../src/parse-domain.ts"],"names":[],"mappings":"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","sourcesContent":["import { NO_HOSTNAME } from \"./from-url.js\";\nimport {\n  SanitizationResultType,\n  sanitize,\n  Validation,\n  type SanitizationResultValidIp,\n  type ValidationError,\n} from \"./sanitize.js\";\nimport { icannTrie, privateTrie } from \"./serialized-tries.js\";\nimport { lookUpTldsInTrie } from \"./trie/look-up.js\";\nimport type { TrieRootNode } from \"./trie/nodes.js\";\nimport { parseTrie } from \"./trie/parse-trie.js\";\n\nexport const RESERVED_TOP_LEVEL_DOMAINS = [\n  \"localhost\",\n  \"local\",\n  \"example\",\n  \"invalid\",\n  \"test\",\n];\n\nexport type Label = string;\n\nexport enum ParseResultType {\n  /**\n   * This parse result is returned in case the given hostname does not adhere to\n   * [RFC 1034](https://tools.ietf.org/html/rfc1034).\n   */\n  Invalid = \"INVALID\",\n  /** This parse result is returned if the given hostname was an IPv4 or IPv6. */\n  Ip = \"IP\",\n  /**\n   * This parse result is returned when the given hostname\n   *\n   * - Is the root domain (the empty string `\"\"`)\n   * - Belongs to the top-level domain `localhost`, `local`, `example`, `invalid`\n   *   or `test`\n   */\n  Reserved = \"RESERVED\",\n  /**\n   * This parse result is returned when the given hostname is valid and does not\n   * belong to a reserved top-level domain, but is not listed in the public\n   * suffix list.\n   */\n  NotListed = \"NOT_LISTED\",\n  /**\n   * This parse result is returned when the given hostname belongs to a\n   * top-level domain that is listed in the public suffix list.\n   */\n  Listed = \"LISTED\",\n}\n\n// The following parse result types are organized in this complicated way\n// way because every property should only be described by a single JSDoc comment.\n// If we copy the types (hence duplicating the shared properties),\n// JSDoc comments would show up duplicated in the final return type as well.\ntype ParseResultCommon<Type extends ParseResultType> = {\n  /**\n   * The type of the parse result. Use switch or if to distinguish between\n   * different results.\n   */\n  type: Type;\n  /** The original hostname that was passed to parseDomain(). */\n  hostname: Type extends ParseResultType.Invalid\n    ? string | typeof NO_HOSTNAME\n    : string;\n};\n\nexport type ParseResultInvalid = ParseResultCommon<ParseResultType.Invalid> & {\n  /** An array of validation errors. */\n  errors: Array<ValidationError>;\n};\n\ntype ParseResultCommonValidDomain = {\n  /**\n   * An array of labels that were separated by a dot character in the given\n   * hostname.\n   */\n  labels: Array<Label>;\n};\n\nexport type ParseResultIp = ParseResultCommon<ParseResultType.Ip> &\n  Pick<SanitizationResultValidIp, \"ipVersion\">;\n\nexport type ParseResultReserved = ParseResultCommon<ParseResultType.Reserved> &\n  ParseResultCommonValidDomain;\n\nexport type ParseResultNotListed =\n  ParseResultCommon<ParseResultType.NotListed> & ParseResultCommonValidDomain;\n\ntype ParseResultListedDomains = {\n  /**\n   * An array of labels that belong to the subdomain. Can be empty if there was\n   * no subdomain in the given hostname.\n   */\n  subDomains: Array<Label>;\n  /**\n   * The first label that belongs to the user-controlled section of the\n   * hostname. Can be undefined if just a top-level domain was passed to\n   * parseDomain().\n   */\n  domain: Label | undefined;\n  /** An array of labels that are controlled by the domain registrar. */\n  topLevelDomains: Array<Label>;\n};\n\nexport type ParseResultListed = ParseResultCommon<ParseResultType.Listed> &\n  ParseResultCommonValidDomain &\n  ParseResultListedDomains & {\n    /**\n     * The parse result according to ICANN only without private top-level\n     * domains.\n     */\n    icann: ParseResultListedDomains;\n  };\n\nexport type ParseResult =\n  | ParseResultInvalid\n  | ParseResultIp\n  | ParseResultReserved\n  | ParseResultNotListed\n  | ParseResultListed;\n\nconst getAtIndex = <Item>(\n  array: Array<Item>,\n  index: number,\n): Item | undefined => {\n  return index >= 0 && index < array.length ? array[index] : undefined;\n};\n\nconst splitLabelsIntoDomains = (\n  labels: Array<Label>,\n  index: number,\n): ParseResultListedDomains => {\n  return {\n    subDomains: labels.slice(0, Math.max(0, index)),\n    domain: getAtIndex(labels, index),\n    topLevelDomains: labels.slice(index + 1),\n  };\n};\n\nlet parsedIcannTrie: TrieRootNode | undefined;\nlet parsedPrivateTrie: TrieRootNode | undefined;\n\nexport type ParseDomainOptions = {\n  /** If no validation is specified, Validation.Strict will be used. */\n  validation?: Validation;\n};\n\n/** Splits the given hostname in topLevelDomains, a domain and subDomains. */\nexport const parseDomain = (\n  hostname: string | typeof NO_HOSTNAME,\n  options?: ParseDomainOptions,\n): ParseResult => {\n  const sanitizationResult = sanitize(hostname, options);\n\n  if (sanitizationResult.type === SanitizationResultType.Error) {\n    return {\n      type: ParseResultType.Invalid,\n      hostname,\n      errors: sanitizationResult.errors,\n    };\n  }\n\n  if (sanitizationResult.type === SanitizationResultType.ValidIp) {\n    return {\n      type: ParseResultType.Ip,\n      hostname: sanitizationResult.ip,\n      ipVersion: sanitizationResult.ipVersion,\n    };\n  }\n\n  const { labels, domain } = sanitizationResult;\n\n  // We do not want to break compatibility with older engines unnecessarily.\n  // eslint-disable-next-line unicorn/prefer-at\n  const lastLabel = labels[labels.length - 1];\n  if (\n    hostname === \"\" ||\n    (lastLabel !== undefined && RESERVED_TOP_LEVEL_DOMAINS.includes(lastLabel))\n  ) {\n    return {\n      type: ParseResultType.Reserved,\n      hostname: domain,\n      labels,\n    };\n  }\n\n  // Parse the serialized trie lazily\n  parsedIcannTrie = parsedIcannTrie ?? parseTrie(icannTrie);\n  parsedPrivateTrie = parsedPrivateTrie ?? parseTrie(privateTrie);\n\n  const icannTlds = lookUpTldsInTrie(labels, parsedIcannTrie);\n  const privateTlds = lookUpTldsInTrie(labels, parsedPrivateTrie);\n\n  if (icannTlds.length === 0 && privateTlds.length === 0) {\n    return {\n      type: ParseResultType.NotListed,\n      hostname: domain,\n      labels,\n    };\n  }\n\n  const indexOfPublicSuffixDomain =\n    labels.length - Math.max(privateTlds.length, icannTlds.length) - 1;\n\n  const indexOfIcannDomain = labels.length - icannTlds.length - 1;\n\n  return {\n    type: ParseResultType.Listed,\n    hostname: domain,\n    labels,\n    icann: splitLabelsIntoDomains(labels, indexOfIcannDomain),\n    ...splitLabelsIntoDomains(labels, indexOfPublicSuffixDomain),\n  };\n};\n"]}

package/{build → dist}/psl/build-tries.d.ts

@@ -2,3 +2,4 @@ export declare const buildTries: (psl: string) => {
     icannTrie: import("../trie/nodes.js").TrieRootNode;
     privateTrie: import("../trie/nodes.js").TrieRootNode;
 };
+//# sourceMappingURL=build-tries.d.ts.map

package/dist/psl/build-tries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-tries.d.ts","sourceRoot":"","sources":["../../src/psl/build-tries.ts"],"names":[],"mappings":"AAyDA,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM;;;CASrC,CAAC"}

package/{build → dist}/psl/build-tries.js

@@ -1,4 +1,4 @@
-import { PUBLIC_SUFFIX_MARKER_ICANN_START, PUBLIC_SUFFIX_MARKER_ICANN_END, PUBLIC_SUFFIX_MARKER_PRIVATE_START, PUBLIC_SUFFIX_MARKER_PRIVATE_END, } from "../config.js";
+import { PUBLIC_SUFFIX_MARKER_ICANN_END, PUBLIC_SUFFIX_MARKER_ICANN_START, PUBLIC_SUFFIX_MARKER_PRIVATE_END, PUBLIC_SUFFIX_MARKER_PRIVATE_START, } from "../config.js";
 import { toASCII } from "../punycode.js";
 import { createTrieFromList } from "../trie/create-trie.js";
 const matchNewLine = /\r?\n/u;
@@ -20,12 +20,12 @@ const parsePsl = (listContent) => {
     return {
         icann: extractByMarkers(listContent, PUBLIC_SUFFIX_MARKER_ICANN_START, PUBLIC_SUFFIX_MARKER_ICANN_END)
             .split(matchNewLine)
-            .filter(containsRule)
-            .map(toASCII),
+            .filter((line) => containsRule(line))
+            .map((line) => toASCII(line)),
         private: extractByMarkers(listContent, PUBLIC_SUFFIX_MARKER_PRIVATE_START, PUBLIC_SUFFIX_MARKER_PRIVATE_END)
             .split(matchNewLine)
-            .filter(containsRule)
-            .map(toASCII),
+            .filter((line) => containsRule(line))
+            .map((line) => toASCII(line)),
     };
 };
 export const buildTries = (psl) => {

package/dist/psl/build-tries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-tries.js","sourceRoot":"","sources":["../../src/psl/build-tries.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,gCAAgC,EAChC,gCAAgC,EAChC,kCAAkC,GACnC,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,MAAM,YAAY,GAAG,QAAQ,CAAC;AAC9B,MAAM,YAAY,GAAG,WAAW,CAAC;AACjC,MAAM,eAAe,GAAG,QAAQ,CAAC;AAEjC,MAAM,gBAAgB,GAAG,CACvB,WAAmB,EACnB,WAAmB,EACnB,SAAiB,EACjB,EAAE;IACF,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAE3C,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,wBAAwB,WAAW,wBAAwB,CAC5D,CAAC;IACJ,CAAC;IACD,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,sBAAsB,SAAS,wBAAwB,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACvC,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,IAAY,EAAE,EAAE,CACpC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC;AAE5E,MAAM,QAAQ,GAAG,CAAC,WAAmB,EAAE,EAAE;IACvC,OAAO;QACL,KAAK,EAAE,gBAAgB,CACrB,WAAW,EACX,gCAAgC,EAChC,8BAA8B,CAC/B;aACE,KAAK,CAAC,YAAY,CAAC;aACnB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;aACpC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/B,OAAO,EAAE,gBAAgB,CACvB,WAAW,EACX,kCAAkC,EAClC,gCAAgC,CACjC;aACE,KAAK,CAAC,YAAY,CAAC;aACnB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;aACpC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;KAChC,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAW,EAAE,EAAE;IACxC,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,SAAS,GAAG,kBAAkB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACtD,MAAM,WAAW,GAAG,kBAAkB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAE1D,OAAO;QACL,SAAS;QACT,WAAW;KACZ,CAAC;AACJ,CAAC,CAAC","sourcesContent":["import {\n  PUBLIC_SUFFIX_MARKER_ICANN_END,\n  PUBLIC_SUFFIX_MARKER_ICANN_START,\n  PUBLIC_SUFFIX_MARKER_PRIVATE_END,\n  PUBLIC_SUFFIX_MARKER_PRIVATE_START,\n} from \"../config.js\";\nimport { toASCII } from \"../punycode.js\";\nimport { createTrieFromList } from \"../trie/create-trie.js\";\n\nconst matchNewLine = /\\r?\\n/u;\nconst matchComment = /^\\s*\\/\\//u;\nconst matchWhitespace = /^\\s*$/u;\n\nconst extractByMarkers = (\n  listContent: string,\n  startMarker: string,\n  endMarker: string,\n) => {\n  const start = listContent.indexOf(startMarker);\n  const end = listContent.indexOf(endMarker);\n\n  if (start === -1) {\n    throw new Error(\n      `Missing start marker ${startMarker} in public suffix list`,\n    );\n  }\n  if (end === -1) {\n    throw new Error(`Missing end marker ${endMarker} in public suffix list`);\n  }\n\n  return listContent.slice(start, end);\n};\n\nconst containsRule = (line: string) =>\n  matchComment.test(line) === false && matchWhitespace.test(line) === false;\n\nconst parsePsl = (listContent: string) => {\n  return {\n    icann: extractByMarkers(\n      listContent,\n      PUBLIC_SUFFIX_MARKER_ICANN_START,\n      PUBLIC_SUFFIX_MARKER_ICANN_END,\n    )\n      .split(matchNewLine)\n      .filter((line) => containsRule(line))\n      .map((line) => toASCII(line)),\n    private: extractByMarkers(\n      listContent,\n      PUBLIC_SUFFIX_MARKER_PRIVATE_START,\n      PUBLIC_SUFFIX_MARKER_PRIVATE_END,\n    )\n      .split(matchNewLine)\n      .filter((line) => containsRule(line))\n      .map((line) => toASCII(line)),\n  };\n};\n\nexport const buildTries = (psl: string) => {\n  const parsedPsl = parsePsl(psl);\n  const icannTrie = createTrieFromList(parsedPsl.icann);\n  const privateTrie = createTrieFromList(parsedPsl.private);\n\n  return {\n    icannTrie,\n    privateTrie,\n  };\n};\n"]}

package/{build → dist}/psl/fetch-psl.d.ts

@@ -1 +1,2 @@
 export declare const fetchPsl: () => Promise<string>;
+//# sourceMappingURL=fetch-psl.d.ts.map

package/dist/psl/fetch-psl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-psl.d.ts","sourceRoot":"","sources":["../../src/psl/fetch-psl.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,QAAQ,uBAWpB,CAAC"}

package/dist/psl/fetch-psl.js

@@ -0,0 +1,10 @@
+import { ok } from "node:assert";
+import { FETCH_PSL_EXPECTED_MIN_LENGTH, PUBLIC_SUFFIX_URL } from "../config.js";
+export const fetchPsl = async () => {
+    const response = await fetch(PUBLIC_SUFFIX_URL);
+    const pslContent = await response.text();
+    // Sanity check
+    ok(pslContent.length >= FETCH_PSL_EXPECTED_MIN_LENGTH, "Public suffix list is shorter than expected");
+    return pslContent;
+};
+//# sourceMappingURL=fetch-psl.js.map

package/dist/psl/fetch-psl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-psl.js","sourceRoot":"","sources":["../../src/psl/fetch-psl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,6BAA6B,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEhF,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;IACjC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IAEzC,eAAe;IACf,EAAE,CACA,UAAU,CAAC,MAAM,IAAI,6BAA6B,EAClD,6CAA6C,CAC9C,CAAC;IAEF,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC","sourcesContent":["import { ok } from \"node:assert\";\nimport { FETCH_PSL_EXPECTED_MIN_LENGTH, PUBLIC_SUFFIX_URL } from \"../config.js\";\n\nexport const fetchPsl = async () => {\n  const response = await fetch(PUBLIC_SUFFIX_URL);\n  const pslContent = await response.text();\n\n  // Sanity check\n  ok(\n    pslContent.length >= FETCH_PSL_EXPECTED_MIN_LENGTH,\n    \"Public suffix list is shorter than expected\",\n  );\n\n  return pslContent;\n};\n"]}

package/{build → dist}/punycode.d.ts

@@ -1 +1,2 @@
 export declare const toASCII: (hostname: string) => string;
+//# sourceMappingURL=punycode.d.ts.map

package/dist/punycode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"punycode.d.ts","sourceRoot":"","sources":["../src/punycode.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,GAAI,UAAU,MAAM,WAEvC,CAAC"}

package/{build → dist}/sanitize.d.ts

@@ -1,18 +1,18 @@
 import { ipVersion } from "is-ip";
-import { Label } from "./parse-domain.js";
 import { NO_HOSTNAME } from "./from-url.js";
+import type { Label } from "./parse-domain.js";
 export declare enum Validation {
     /**
-     * Allows any octets as labels
-     * but still restricts the length of labels and the overall domain.
+     * Allows any octets as labels but still restricts the length of labels and
+     * the overall domain.
      *
      * @see https://www.rfc-editor.org/rfc/rfc2181#section-11
-     **/
+     */
     Lax = "LAX",
     /**
-     * Only allows ASCII letters, digits and hyphens (aka LDH),
-     * forbids hyphens at the beginning or end of a label
-     * and requires top-level domain names not to be all-numeric.
+     * Only allows ASCII letters, digits and hyphens (aka LDH), forbids hyphens at
+     * the beginning or end of a label and requires top-level domain names not to
+     * be all-numeric.
      *
      * This is the default if no validation is configured.
      *
@@ -56,3 +56,4 @@ export type SanitizationResult = SanitizationResultValidIp | SanitizationResultV
 export declare const sanitize: (input: string | typeof NO_HOSTNAME, options?: {
     validation?: Validation;
 }) => SanitizationResult;
+//# sourceMappingURL=sanitize.d.ts.map

package/dist/sanitize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../src/sanitize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAgB/C,oBAAY,UAAU;IACpB;;;;;OAKG;IACH,GAAG,QAAQ;IAEX;;;;;;;;OAQG;IACH,MAAM,WAAW;CAClB;AAED,oBAAY,mBAAmB;IAC7B,UAAU,gBAAgB;IAC1B,eAAe,sBAAsB;IACrC,cAAc,qBAAqB;IACnC,cAAc,qBAAqB;IACnC,qBAAqB,4BAA4B;IACjD,gBAAgB,uBAAuB;CACxC;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,oBAAY,sBAAsB;IAChC,OAAO,aAAa;IACpB,WAAW,iBAAiB;IAC5B,KAAK,UAAU;CAChB;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE,sBAAsB,CAAC,OAAO,CAAC;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC;CAC7D,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,IAAI,EAAE,sBAAsB,CAAC,WAAW,CAAC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,sBAAsB,CAAC,KAAK,CAAC;IACnC,MAAM,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAC1B,yBAAyB,GACzB,6BAA6B,GAC7B,uBAAuB,CAAC;AA0D5B,eAAO,MAAM,QAAQ,GACnB,OAAO,MAAM,GAAG,OAAO,WAAW,EAClC,UAAS;IAAE,UAAU,CAAC,EAAE,UAAU,CAAA;CAAO,KACxC,kBA6DF,CAAC"}