strip-tracking-params 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ricco020
+
+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/README.md

@@ -0,0 +1,38 @@
+# strip-tracking-params
+
+Remove common **tracking query parameters** (UTM tags, ad click IDs like `gclid`
+and `fbclid`, email-tracking ids) from a URL, returning a clean one. Runs locally,
+zero dependencies, nothing stored or sent anywhere.
+
+```js
+const stripTrackingParams = require('strip-tracking-params');
+
+stripTrackingParams('https://example.com/page?utm_source=news&id=42&fbclid=abc');
+// 'https://example.com/page?id=42'   (functional params like id are kept)
+
+stripTrackingParams('https://shop.com/p?ref=x&gclid=z', { extra: ['ref'] });
+// 'https://shop.com/p'
+```
+
+## What it removes
+
+A documented default list: `utm_*`, `gclid`/`gbraid`/`wbraid`/`dclid`,
+`fbclid`, `igshid`, `msclkid`, `ttclid`, `yclid`, `mc_cid`/`mc_eid`, `_hsenc`,
+`mkt_tok` and other common analytics and email trackers. See
+`stripTrackingParams.DEFAULT_PARAMS`.
+
+Pass `{ params: [...] }` to replace the list, or `{ extra: [...] }` to add to it.
+
+**Honest note:** it only strips query parameters. A non-absolute URL is returned
+unchanged (it cannot be parsed safely without a base), and it does not touch path
+segments or fragments. It reduces tracking, it does not make a link anonymous.
+
+## Notes
+
+Maintained by the team behind [Priviy](https://www.priviy.com), a data-privacy
+resource. For plain-English guides on trackers, metadata and cloud privacy, see
+[priviy.com](https://www.priviy.com).
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,53 @@
+'use strict';
+
+/**
+ * strip-tracking-params
+ * Remove common tracking query parameters (UTM tags, click IDs, email-tracking
+ * ids) from a URL, returning a clean URL. Runs locally, no network, no storage.
+ * The default list covers widely documented trackers; pass your own if needed.
+ */
+
+// Widely documented tracking parameters (analytics, ad-click IDs, email trackers).
+var DEFAULT_PARAMS = [
+  'utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content', 'utm_id',
+  'utm_name', 'utm_cid', 'utm_reader', 'utm_social', 'utm_brand',
+  'gclid', 'gclsrc', 'dclid', 'gbraid', 'wbraid', 'gad_source',
+  'fbclid', 'igshid', 'twclid', 'yclid', 'msclkid', 'ttclid', 'li_fat_id',
+  'mc_cid', 'mc_eid', '_hsenc', '_hsmi', 'vero_id', 'vero_conv',
+  'oly_enc_id', 'oly_anon_id', 'wickedid', 'rb_clickid', 's_cid', 'mkt_tok',
+  'hsa_acc', 'hsa_cam', 'hsa_grp', 'hsa_ad', 'hsa_src', 'hsa_tgt', 'hsa_kw', 'hsa_mt', 'hsa_ver', 'hsa_net'
+];
+
+/**
+ * @param {string} url
+ * @param {object} [options]
+ * @param {string[]} [options.params] override the list of parameters to strip
+ * @param {string[]} [options.extra] additional parameters to strip on top of the defaults
+ * @returns {string} the URL with tracking parameters removed (unchanged if it cannot be parsed)
+ */
+function stripTrackingParams(url, options) {
+  if (typeof url !== 'string') { throw new TypeError('url must be a string'); }
+  options = options || {};
+  var toStrip = options.params ? options.params.slice() : DEFAULT_PARAMS.slice();
+  if (options.extra) { toStrip = toStrip.concat(options.extra); }
+  var lower = {};
+  for (var i = 0; i < toStrip.length; i++) { lower[String(toStrip[i]).toLowerCase()] = true; }
+
+  var u;
+  try { u = new URL(url); }
+  catch (e) { return url; } // not an absolute URL: return unchanged rather than guess
+
+  var keys = [];
+  u.searchParams.forEach(function (_v, k) { keys.push(k); });
+  for (var j = 0; j < keys.length; j++) {
+    if (lower[keys[j].toLowerCase()]) { u.searchParams.delete(keys[j]); }
+  }
+  // Drop a trailing "?" if no params remain.
+  var out = u.toString();
+  if (u.search === '' && out.charAt(out.length - 1) === '?') { out = out.slice(0, -1); }
+  return out;
+}
+
+stripTrackingParams.DEFAULT_PARAMS = DEFAULT_PARAMS.slice();
+module.exports = stripTrackingParams;
+module.exports.stripTrackingParams = stripTrackingParams;

package/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "strip-tracking-params",
+  "version": "1.0.0",
+  "description": "Remove common tracking query parameters (UTM tags, gclid, fbclid, email trackers) from a URL. Local, zero dependencies, privacy-friendly.",
+  "main": "index.js",
+  "type": "commonjs",
+  "scripts": { "test": "node test.js" },
+  "keywords": ["tracking", "utm", "privacy", "url", "gclid", "fbclid", "clean-url", "detrack"],
+  "homepage": "https://www.priviy.com",
+  "author": "ricco020",
+  "license": "MIT",
+  "engines": { "node": ">=12" },
+  "files": ["index.js", "README.md", "LICENSE"]
+}