@v0idd0/tabsnap 1.0.3 → 1.0.4

package/README.md

@@ -8,7 +8,7 @@
 
 > Capture every open tab as a browser-session export: plain text, markdown, JSON, or a readme file.
 > One click in the browser. One pipe in the terminal.
-> Free, MIT, zero telemetry.
+> Free, MIT, zero telemetry. Optional tracking-param stripping for cleaner exports.
 
 [Browser-extension landing](https://extensions.voiddo.com/tabsnap/) ·
 [CLI landing](https://tools.voiddo.com/tabsnap/) ·
@@ -47,6 +47,7 @@ npm i -g @v0idd0/tabsnap
 cat tabs.json | tabsnap                    # markdown (default)
 cat tabs.json | tabsnap --format=readme    # readme.md
 cat tabs.json | tabsnap -f json --no-group # flat structured array
+cat tabs.json | tabsnap --strip-tracking    # clean tracking params first
 
 # from file
 tabsnap --file=tabs.json -f plain
@@ -54,6 +55,9 @@ tabsnap --file=tabs.json -f plain
 # include pinned + incognito tabs (skipped by default)
 tabsnap --include-pinned --include-incognito < tabs.json
 
+# strip common marketing params from exported URLs
+tabsnap --strip-tracking -f readme < tabs.json
+
 # pipe to clipboard (macOS) or any tool
 tabsnap --format=readme < tabs.json | pbcopy
 ```

package/bin/tabsnap.js

@@ -25,6 +25,7 @@ options:
       --no-group          do not group by window (single flat list)
       --include-pinned    include pinned tabs (default: skip)
       --include-incognito include incognito-window tabs (default: skip)
+      --strip-tracking    remove common tracking params from exported urls
   -h, --help              this help
   -v, --version           print version
 
@@ -49,6 +50,7 @@ function parseArgs(argv) {
     groupByWindow: true,
     includePinned: false,
     includeIncognito: false,
+    stripTracking: false,
     help: false,
     version: false,
   };
@@ -59,6 +61,7 @@ function parseArgs(argv) {
     else if (a === '--no-group') opts.groupByWindow = false;
     else if (a === '--include-pinned') opts.includePinned = true;
     else if (a === '--include-incognito') opts.includeIncognito = true;
+    else if (a === '--strip-tracking') opts.stripTracking = true;
     else if (a.startsWith('--format=')) opts.format = a.slice(9);
     else if (a === '-f' || a === '--format') opts.format = argv[++i];
     else if (a.startsWith('--file=')) opts.file = a.slice(7);
@@ -142,6 +145,7 @@ async function main() {
     groupByWindow: opts.groupByWindow,
     includePinned: opts.includePinned,
     includeIncognito: opts.includeIncognito,
+    stripTracking: opts.stripTracking,
   });
   process.stdout.write(out);
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@v0idd0/tabsnap",
-  "version": "1.0.3",
-  "description": "tabsnap — browser session exporter and tab-list formatter for markdown, plain text, JSON, or a readme file. Library + CLI. Same formatters that power the tabsnap browser extension. Zero deps. Free forever from vøiddo.",
+  "version": "1.0.4",
+  "description": "tabsnap — browser session exporter and tab-list formatter for markdown, plain text, JSON, or a readme file. Library + CLI. Optional tracking-param stripping keeps exports clean. Same formatters that power the tabsnap browser extension. Zero deps. Free forever from vøiddo.",
   "main": "src/index.js",
   "bin": {
     "tabsnap": "./bin/tabsnap.js"
@@ -34,6 +34,9 @@
     "formatter",
     "json-to-markdown",
     "json-to-readme",
+    "tracking-params",
+    "utm",
+    "url-cleanup",
     "snapshot",
     "voiddo",
     "free",

package/src/index.js

@@ -9,6 +9,26 @@ function escapeMarkdown(s) {
   return String(s).replace(/[\[\]\\`*_]/g, ch => '\\' + ch);
 }
 
+const TRACKING_PARAM_RE = /^(?:utm_[a-z0-9_]+|gclid|dclid|fbclid|msclkid|mc_cid|mc_eid|ref|ref_src|referrer|trk|igshid|_hsenc|_hsmi)$/i;
+
+function cleanUrl(url, opts) {
+  if (!url || !opts || !opts.stripTracking) return url;
+  try {
+    const parsed = new URL(url);
+    const keys = [...new Set([...parsed.searchParams.keys()])];
+    let changed = false;
+    for (const key of keys) {
+      if (TRACKING_PARAM_RE.test(key)) {
+        parsed.searchParams.delete(key);
+        changed = true;
+      }
+    }
+    return changed ? parsed.toString() : url;
+  } catch (_) {
+    return url;
+  }
+}
+
 function groupTabsByWindow(tabs) {
   const groups = new Map();
   for (const t of tabs) {
@@ -37,30 +57,30 @@ function fmtMarkdown(tabs, opts) {
   const dt = new Date().toISOString().replace('T', ' ').replace(/\.\d+Z$/, ' UTC');
   const head = '# tab snapshot · ' + t.length + ' tab' + (t.length === 1 ? '' : 's') + '\n_' + dt + '_\n\n';
   if (!opts.groupByWindow) {
-    return head + t.map(formatLineMd).join('\n') + '\n';
+    return head + t.map(tab => formatLineMd(tab, opts)).join('\n') + '\n';
   }
   const groups = groupTabsByWindow(t);
   return head + groups.map(g =>
     '## window ' + g.windowIndex + ' (' + g.tabs.length + ')\n' +
-    g.tabs.map(formatLineMd).join('\n') + '\n'
+    g.tabs.map(tab => formatLineMd(tab, opts)).join('\n') + '\n'
   ).join('\n');
 }
 
-function formatLineMd(tab) {
+function formatLineMd(tab, opts) {
   const title = escapeMarkdown(tab.title || '(untitled)');
-  return '- [' + title + '](' + tab.url + ')';
+  return '- [' + title + '](' + cleanUrl(tab.url, opts) + ')';
 }
 
 function fmtPlain(tabs, opts) {
   const t = filterTabs(tabs, opts);
   if (!opts.groupByWindow) {
-    return t.map(x => (x.title || '(untitled)') + '\n  ' + x.url).join('\n\n') + '\n';
+    return t.map(x => (x.title || '(untitled)') + '\n  ' + cleanUrl(x.url, opts)).join('\n\n') + '\n';
   }
   const groups = groupTabsByWindow(t);
   return groups.map(g =>
     'window ' + g.windowIndex + '  (' + g.tabs.length + ')\n' +
     '─'.repeat(40) + '\n' +
-    g.tabs.map(x => (x.title || '(untitled)') + '\n  ' + x.url).join('\n\n')
+    g.tabs.map(x => (x.title || '(untitled)') + '\n  ' + cleanUrl(x.url, opts)).join('\n\n')
   ).join('\n\n') + '\n';
 }
 
@@ -75,18 +95,18 @@ function fmtJson(tabs, opts) {
     out.windows = groupTabsByWindow(t).map(g => ({
       window_index: g.windowIndex,
       tab_count: g.tabs.length,
-      tabs: g.tabs.map(simplifyTab),
+      tabs: g.tabs.map(tab => simplifyTab(tab, opts)),
     }));
   } else {
-    out.tabs = t.map(simplifyTab);
+    out.tabs = t.map(tab => simplifyTab(tab, opts));
   }
   return JSON.stringify(out, null, 2) + '\n';
 }
 
-function simplifyTab(t) {
+function simplifyTab(t, opts) {
   return {
     title: t.title || null,
-    url: t.url || null,
+    url: cleanUrl(t.url, opts) || null,
     pinned: !!t.pinned,
     active: !!t.active,
     audible: !!t.audible,
@@ -107,12 +127,12 @@ function fmtReadme(tabs, opts) {
   domains += '\n';
   let body;
   if (!opts.groupByWindow) {
-    body = '## all tabs\n\n' + t.map(formatLineMd).join('\n') + '\n';
+    body = '## all tabs\n\n' + t.map(tab => formatLineMd(tab, opts)).join('\n') + '\n';
   } else {
     const groups = groupTabsByWindow(t);
     body = groups.map(g =>
       '## window ' + g.windowIndex + ' · ' + g.tabs.length + ' tab' + (g.tabs.length === 1 ? '' : 's') + '\n\n' +
-      g.tabs.map(formatLineMd).join('\n') + '\n'
+      g.tabs.map(tab => formatLineMd(tab, opts)).join('\n') + '\n'
     ).join('\n');
   }
   return head + domains + body;