@url-sanitize/firefox 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Antonio Orionus
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE

@@ -0,0 +1,5 @@
+This package bundles Firefox Query Stripping records from Mozilla Remote Settings:
+
+https://firefox.settings.services.mozilla.com/v1/buckets/main/collections/query-stripping/records
+
+The bundled data is licensed MPL-2.0 by its upstream maintainers.

package/README.md

@@ -0,0 +1,37 @@
+# @url-sanitize/firefox
+
+Firefox Query Stripping catalog and adapter for [`@url-sanitize/core`](../core).
+
+Ships a pinned snapshot of Mozilla Remote Settings query-stripping records:
+
+```text
+https://firefox.settings.services.mozilla.com/v1/buckets/main/collections/query-stripping/records
+```
+
+## Install
+
+```sh
+npm install @url-sanitize/core @url-sanitize/firefox
+```
+
+## Usage
+
+```ts
+import { compileSanitizer } from '@url-sanitize/core';
+import { firefoxCatalog } from '@url-sanitize/firefox';
+
+const sanitize = compileSanitizer(firefoxCatalog);
+sanitize('https://example.com/?wbraid=x&id=123');
+```
+
+## Raw access
+
+```ts
+import { firefoxRawData, firefoxMetadata } from '@url-sanitize/firefox/raw';
+import { firefoxToCatalog } from '@url-sanitize/firefox/adapter';
+```
+
+## License
+
+Adapter code is project code. Bundled Firefox Query Stripping data is
+**MPL-2.0**. See [NOTICE](NOTICE).

package/data/data.json

@@ -0,0 +1,52 @@
+{
+  "data": [
+    {
+      "schema": 1694684344305,
+      "allowList": [
+        "googleadservices.com"
+      ],
+      "stripList": [],
+      "id": "a61d2791-d7e1-42e6-9824-0dbe69c33b97",
+      "last_modified": 1694689843914
+    },
+    {
+      "schema": 1678379807899,
+      "allowList": [],
+      "stripList": [
+        "gclid",
+        "dclid",
+        "msclkid",
+        "_openstat",
+        "yclid",
+        "wickedid",
+        "twclid",
+        "_hsenc",
+        "__hssc",
+        "__hstc",
+        "__hsfp",
+        "hsctatracking",
+        "wbraid",
+        "gbraid",
+        "ysclid"
+      ],
+      "id": "85078bad-f31e-4d93-bb8a-81088b25d6dd",
+      "last_modified": 1678736907773
+    },
+    {
+      "schema": 1649695008608,
+      "allowList": [],
+      "stripList": [
+        "mc_eid",
+        "oly_anon_id",
+        "oly_enc_id",
+        "__s",
+        "vero_id",
+        "_hsenc",
+        "mkt_tok",
+        "fbclid"
+      ],
+      "id": "76495cfc-fac9-4079-9b5f-9ff0784484de",
+      "last_modified": 1649762862679
+    }
+  ]
+}

package/data/metadata.json

@@ -0,0 +1,7 @@
+{
+  "version": "61578ba740b7",
+  "hash": "61578ba740b7bb0e9b5450eab725dd3b7be8995ba42633d9d46825745f9e0c7d",
+  "fetchedAt": "2026-06-03T17:40:39.112Z",
+  "upstream": "https://firefox.settings.services.mozilla.com/v1/buckets/main/collections/query-stripping/records",
+  "license": "MPL-2.0"
+}

package/dist/adapter.d.ts

@@ -0,0 +1,6 @@
+import { SanitizerCatalog } from '@url-sanitize/core';
+import { FirefoxQueryStrippingData, FirefoxMetadata } from './types.js';
+
+declare function firefoxToCatalog(data: FirefoxQueryStrippingData, meta: FirefoxMetadata): SanitizerCatalog;
+
+export { firefoxToCatalog };

package/dist/adapter.js

@@ -0,0 +1,43 @@
+// src/adapter.ts
+function firefoxToCatalog(data, meta) {
+  const rules = [];
+  for (const record of data.data) {
+    if (record.filter_expression) {
+      throw new Error(`Unsupported Firefox filter_expression in record ${record.id}`);
+    }
+    const exceptions = record.allowList.map(domainPattern);
+    for (const param of record.stripList) {
+      rules.push({
+        kind: "strip-param",
+        source: "firefox",
+        provider: `firefox-${record.id}`,
+        paramPattern: escapeRegExp(param),
+        exceptions
+      });
+    }
+  }
+  return {
+    version: meta.version,
+    generatedAt: meta.fetchedAt,
+    sources: [
+      {
+        name: "firefox",
+        version: meta.version,
+        hash: meta.hash,
+        license: meta.license,
+        upstream: meta.upstream
+      }
+    ],
+    rules
+  };
+}
+function domainPattern(domain) {
+  const escaped = escapeRegExp(domain);
+  return `^https?:\\/\\/([^/?#]+\\.)?${escaped}(?::[0-9]+)?(?:[/?#]|$)`;
+}
+function escapeRegExp(value) {
+  return value.replace(/[|\\{}()[\]^$+?.*]/g, "\\$&");
+}
+export {
+  firefoxToCatalog
+};

package/dist/chunk-ASRH34YB.js

@@ -0,0 +1,67 @@
+// data/data.json
+var data_default = {
+  data: [
+    {
+      schema: 1694684344305,
+      allowList: [
+        "googleadservices.com"
+      ],
+      stripList: [],
+      id: "a61d2791-d7e1-42e6-9824-0dbe69c33b97",
+      last_modified: 1694689843914
+    },
+    {
+      schema: 1678379807899,
+      allowList: [],
+      stripList: [
+        "gclid",
+        "dclid",
+        "msclkid",
+        "_openstat",
+        "yclid",
+        "wickedid",
+        "twclid",
+        "_hsenc",
+        "__hssc",
+        "__hstc",
+        "__hsfp",
+        "hsctatracking",
+        "wbraid",
+        "gbraid",
+        "ysclid"
+      ],
+      id: "85078bad-f31e-4d93-bb8a-81088b25d6dd",
+      last_modified: 1678736907773
+    },
+    {
+      schema: 1649695008608,
+      allowList: [],
+      stripList: [
+        "mc_eid",
+        "oly_anon_id",
+        "oly_enc_id",
+        "__s",
+        "vero_id",
+        "_hsenc",
+        "mkt_tok",
+        "fbclid"
+      ],
+      id: "76495cfc-fac9-4079-9b5f-9ff0784484de",
+      last_modified: 1649762862679
+    }
+  ]
+};
+
+// data/metadata.json
+var metadata_default = {
+  version: "61578ba740b7",
+  hash: "61578ba740b7bb0e9b5450eab725dd3b7be8995ba42633d9d46825745f9e0c7d",
+  fetchedAt: "2026-06-03T17:40:39.112Z",
+  upstream: "https://firefox.settings.services.mozilla.com/v1/buckets/main/collections/query-stripping/records",
+  license: "MPL-2.0"
+};
+
+export {
+  data_default,
+  metadata_default
+};

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+import { SanitizerCatalog, Sanitizer } from '@url-sanitize/core';
+export { firefoxToCatalog } from './adapter.js';
+export { firefoxMetadata, firefoxRawData } from './raw.js';
+export { FirefoxMetadata, FirefoxQueryStrippingData, FirefoxQueryStrippingRecord } from './types.js';
+
+declare const firefoxCatalog: SanitizerCatalog;
+declare const sanitize: Sanitizer;
+
+export { firefoxCatalog, sanitize };

package/dist/index.js

@@ -0,0 +1,63 @@
+import {
+  data_default,
+  metadata_default
+} from "./chunk-ASRH34YB.js";
+
+// src/index.ts
+import { compileSanitizer } from "@url-sanitize/core";
+
+// src/adapter.js
+function firefoxToCatalog(data, meta) {
+  const rules = [];
+  for (const record of data.data) {
+    if (record.filter_expression) {
+      throw new Error(`Unsupported Firefox filter_expression in record ${record.id}`);
+    }
+    const exceptions = record.allowList.map(domainPattern);
+    for (const param of record.stripList) {
+      rules.push({
+        kind: "strip-param",
+        source: "firefox",
+        provider: `firefox-${record.id}`,
+        paramPattern: escapeRegExp(param),
+        exceptions
+      });
+    }
+  }
+  return {
+    version: meta.version,
+    generatedAt: meta.fetchedAt,
+    sources: [
+      {
+        name: "firefox",
+        version: meta.version,
+        hash: meta.hash,
+        license: meta.license,
+        upstream: meta.upstream
+      }
+    ],
+    rules
+  };
+}
+function domainPattern(domain) {
+  const escaped = escapeRegExp(domain);
+  return `^https?:\\/\\/([^/?#]+\\.)?${escaped}(?::[0-9]+)?(?:[/?#]|$)`;
+}
+function escapeRegExp(value) {
+  return value.replace(/[|\\{}()[\]^$+?.*]/g, "\\$&");
+}
+
+// src/raw.js
+var firefoxRawData = data_default;
+var firefoxMetadata = metadata_default;
+
+// src/index.ts
+var firefoxCatalog = firefoxToCatalog(firefoxRawData, firefoxMetadata);
+var sanitize = compileSanitizer(firefoxCatalog);
+export {
+  firefoxCatalog,
+  firefoxMetadata,
+  firefoxRawData,
+  firefoxToCatalog,
+  sanitize
+};

package/dist/raw.d.ts

@@ -0,0 +1,6 @@
+import { FirefoxMetadata, FirefoxQueryStrippingData } from './types.js';
+
+declare const firefoxRawData: FirefoxQueryStrippingData;
+declare const firefoxMetadata: FirefoxMetadata;
+
+export { firefoxMetadata, firefoxRawData };

package/dist/raw.js

@@ -0,0 +1,12 @@
+import {
+  data_default,
+  metadata_default
+} from "./chunk-ASRH34YB.js";
+
+// src/raw.ts
+var firefoxRawData = data_default;
+var firefoxMetadata = metadata_default;
+export {
+  firefoxMetadata,
+  firefoxRawData
+};

package/dist/types.d.ts

@@ -0,0 +1,20 @@
+interface FirefoxQueryStrippingRecord {
+    allowList: string[];
+    filter_expression?: string;
+    id: string;
+    last_modified: number;
+    schema: number;
+    stripList: string[];
+}
+interface FirefoxQueryStrippingData {
+    data: FirefoxQueryStrippingRecord[];
+}
+interface FirefoxMetadata {
+    version: string;
+    hash: string;
+    fetchedAt: string;
+    upstream: string;
+    license: string;
+}
+
+export type { FirefoxMetadata, FirefoxQueryStrippingData, FirefoxQueryStrippingRecord };

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@url-sanitize/firefox",
+  "version": "2.0.0",
+  "description": "Firefox Query Stripping catalog adapter for @url-sanitize/core.",
+  "license": "MPL-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./adapter": {
+      "types": "./dist/adapter.d.ts",
+      "import": "./dist/adapter.js"
+    },
+    "./raw": {
+      "types": "./dist/raw.d.ts",
+      "import": "./dist/raw.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js"
+    }
+  },
+  "files": [
+    "dist",
+    "data",
+    "NOTICE"
+  ],
+  "dependencies": {
+    "@url-sanitize/core": "2.0.0"
+  },
+  "keywords": [
+    "firefox",
+    "query-stripping",
+    "url",
+    "tracking",
+    "privacy"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/antonio-orionus/url-sanitize.git",
+    "directory": "packages/firefox"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup src/index.ts src/raw.ts src/adapter.ts src/types.ts --format esm --dts --clean",
+    "dev": "tsup src/index.ts src/raw.ts src/adapter.ts src/types.ts --format esm --dts --watch"
+  }
+}