@url-sanitize/cli 0.1.0

package/LICENSE

@@ -0,0 +1,27 @@
+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.
+
+Note: this MIT license applies to the @url-sanitize/core, @url-sanitize/cli,
+@url-sanitize/fetch, and @url-sanitize/action packages. The
+@url-sanitize/clearurls package ships a catalog derived from the ClearURLs
+ruleset and is licensed under LGPL-3.0-only for that bundled data. See
+packages/clearurls/LICENSE and docs/license-model.md for details.

package/README.md

@@ -0,0 +1,25 @@
+# @url-sanitize/cli
+
+Command-line URL sanitizer.
+
+## Install
+
+```sh
+npm install -g @url-sanitize/cli
+# or
+npx @url-sanitize/cli "https://example.com/?utm_source=x"
+```
+
+## Usage
+
+```sh
+url-sanitize "https://example.com/?utm_source=x"
+# https://example.com/
+
+url-sanitize --json "https://example.com/?utm_source=x"
+# {"kind":"cleaned","original":"...","url":"...","strippedParams":["utm_source"],"matchedRules":[...]}
+```
+
+## License
+
+MIT.

package/dist/bin.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+
+// src/bin.ts
+import { clearurlsCatalog } from "@url-sanitize/clearurls";
+import { compileSanitizer } from "@url-sanitize/core";
+var args = process.argv.slice(2);
+if (args.length === 0 || args.includes("--help") || args.includes("-h")) {
+  printHelp();
+  process.exit(args.length === 0 ? 1 : 0);
+}
+var jsonMode = args.includes("--json");
+var stripReferral = args.includes("--keep-referral") ? false : args.includes("--strip-referral");
+var positional = args.filter((a) => !a.startsWith("--") && !a.startsWith("-"));
+var sanitize = compileSanitizer(clearurlsCatalog, {
+  stripReferralMarketing: stripReferral
+});
+for (const url of positional) {
+  const result = sanitize(url);
+  if (jsonMode) {
+    process.stdout.write(`${JSON.stringify(result)}
+`);
+  } else {
+    switch (result.kind) {
+      case "unchanged":
+        process.stdout.write(`${result.url}
+`);
+        break;
+      case "cleaned":
+      case "redirected":
+        process.stdout.write(`${result.url}
+`);
+        break;
+      case "blocked":
+        process.stderr.write(`blocked: ${result.original} (via ${result.via.provider})
+`);
+        process.exitCode = 2;
+        break;
+    }
+  }
+}
+function printHelp() {
+  process.stdout.write(
+    [
+      "url-sanitize <url> [<url>...]",
+      "",
+      "Options:",
+      "  --json              Emit JSON result objects (one per line)",
+      "  --strip-referral    Strip affiliate / referral marketing params (off by default)",
+      "  --keep-referral     Explicitly keep referral params (default)",
+      "  -h, --help          Show this help",
+      ""
+    ].join("\n")
+  );
+}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@url-sanitize/cli",
+  "version": "0.1.0",
+  "description": "Command-line URL sanitizer for cleaning, explaining, and validating tracking-heavy URLs.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "url-sanitize": "./dist/bin.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@url-sanitize/clearurls": "0.1.0",
+    "@url-sanitize/core": "0.1.0"
+  },
+  "keywords": [
+    "cli",
+    "url",
+    "sanitize",
+    "tracking",
+    "clearurls"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/antonio-orionus/url-sanitize.git",
+    "directory": "packages/cli"
+  },
+  "scripts": {
+    "build": "tsup src/bin.ts --format esm --clean",
+    "dev": "tsup src/bin.ts --format esm --watch"
+  }
+}