urlpurify 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Maciej Lamberski
+
+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,93 @@
+# urlpurify
+
+[![codecov](https://codecov.io/gh/macieklamberski/urlpurify/branch/main/graph/badge.svg)](https://codecov.io/gh/macieklamberski/urlpurify)
+[![npm version](https://img.shields.io/npm/v/urlpurify.svg)](https://www.npmjs.com/package/urlpurify)
+[![license](https://img.shields.io/npm/l/urlpurify.svg)](https://github.com/macieklamberski/urlpurify/blob/main/LICENSE)
+
+Unwrap redirect, affiliate, and tracking wrapper URLs and strip tracking parameters. Turn noisy links into clean, direct URLs.
+
+URLs collected from feeds, emails, and social platforms rarely point straight at their destination: they pass through search-engine redirects, email security gateways, affiliate networks, and AMP caches, and carry analytics parameters that bloat the link and leak data. urlpurify ships 70+ unwrappers for known wrapper services and a list of 150+ known tracking parameters, plus a composite `cleanUrl()` that applies both. It has zero dependencies and runs in any modern JavaScript runtime, including browsers.
+
+## Installation
+
+```bash
+npm install urlpurify
+```
+
+## Quick Start
+
+```typescript
+import { cleanUrl } from 'urlpurify'
+
+cleanUrl('https://www.google.com/url?q=https%3A%2F%2Fexample.com%2Fpost%3Futm_source%3Dnewsletter')
+// => 'https://example.com/post'
+```
+
+## API
+
+### `cleanUrl(url, options?)`
+
+Unwraps redirect wrappers (repeatedly, since wrappers can nest), then strips tracking parameters. When the input cannot be parsed as a URL or nothing applies, the input string is returned unchanged, so the result is always safe to display.
+
+```typescript
+import { cleanUrl, defaultUnwrappers, unwrapWebArchive } from 'urlpurify'
+
+const cleaned = cleanUrl(url, {
+  // Unwrappers to apply, first match wins per pass (omit to use defaults).
+  unwrappers: [...defaultUnwrappers, unwrapWebArchive],
+  // Query parameter names to remove, matched case-insensitively (omit to use defaults).
+  trackingParams: ['utm_source', 'utm_medium', 'fbclid'],
+  // Maximum number of unwrap passes for nested wrappers. Defaults to 3.
+  maxUnwrapDepth: 3,
+})
+```
+
+### `unwrapUrl(url, unwrappers?)`
+
+Applies the unwrappers in order (one pass) and returns the first extracted target, or `undefined` when none match or the input cannot be parsed.
+
+### `stripTrackingParams(url, trackingParams?)`
+
+Removes matching query parameters and returns the cleaned URL. The input is returned unchanged when nothing matches or it cannot be parsed.
+
+### `createParamExtractor(config)`
+
+Builds an unwrapper for the common case where the target URL sits in a query parameter:
+
+```typescript
+import { cleanUrl, createParamExtractor, defaultUnwrappers } from 'urlpurify'
+
+const unwrapExample = createParamExtractor({
+  hosts: 'go.example.com', // Also accepts an array of hosts or a regex.
+  params: ['target'],
+})
+
+cleanUrl(url, { unwrappers: [...defaultUnwrappers, unwrapExample] })
+```
+
+For wrappers that encode the target (base64 path segments, custom escaping), write a plain function of type `UrlUnwrapper`: it receives a `URL` and returns the target string or `undefined`.
+
+### Defaults
+
+`defaultTrackingParams` and `defaultUnwrappers` are exported from the package root. `defaultUnwrappers` enables a conservative subset of the catalog (search-engine redirects and social-platform shims); everything else is exported individually for explicit opt-in.
+
+## Unwrappers
+
+Enabled by default:
+
+| Unwrapper | Description |
+| --- | --- |
+| `unwrapBing` | Bing search-result redirect (www.bing.com/ck/a?u=a1\<base64url\>) |
+| `unwrapFacebookShim` | Facebook link shim (l.facebook.com/l.php?u=\<target\>) |
+| `unwrapGoogle` | Google redirect (google.\<TLD\>/url?url=\<target\> or ?q=\<target\>) |
+| `unwrapGoogleAmpViewer` | Google AMP viewer (www.google.\<TLD\>/amp/s/\<host\>/\<path\>) |
+| `unwrapGoogleNews` | Google News legacy redirect (news.google.\<TLD\>/news/url?url=\<target\>) |
+| `unwrapGoogleNewsModern` | Google News modern article URLs (news.google.com/articles/\<base64\>) |
+| `unwrapGoogleScholar` | Google Scholar search-result redirect (scholar.google.\<TLD\>/scholar_url?url=\<target\>) |
+| `unwrapInstagramShim` | Instagram outbound link shim (l.instagram.com with ?u=\<target\>) |
+| `unwrapRedditOut` | Reddit outbound click tracker (out.reddit.com/?url=\<target\>) |
+| `unwrapVkAway` | VK away redirect (vk.com/away.php?to=\<target\>) |
+| `unwrapYahooSearch` | Yahoo Search redirect (r.search.yahoo.com/.../RU=\<target\>/RK=...) |
+| `unwrapYouTube` | YouTube external redirect (www.youtube.com/redirect?q=\<target\>) |
+
+Many more are available for explicit opt-in: email security gateways (Outlook SafeLinks, Proofpoint, Mimecast), affiliate networks (Awin, Skimlinks, Commission Junction), CJK platforms, AMP caches, and others. See [src/unwraps](src/unwraps) for the full catalog, each documented in its source file.

package/dist/clean.d.ts

@@ -0,0 +1,8 @@
+import { CleanUrlOptions, UrlUnwrapper } from "./types.js";
+
+//#region src/clean.d.ts
+declare const unwrapUrl: (url: string, unwrappers?: Array<UrlUnwrapper>) => string | undefined;
+declare const stripTrackingParams: (url: string, trackingParams?: Array<string>) => string;
+declare const cleanUrl: (url: string, options?: CleanUrlOptions) => string;
+//#endregion
+export { cleanUrl, stripTrackingParams, unwrapUrl };

package/dist/clean.js

@@ -0,0 +1,63 @@
+import { defaultTrackingParams } from "./params.js";
+import { defaultUnwrappers } from "./defaults.js";
+//#region src/clean.ts
+const trackingParamsCache = /* @__PURE__ */ new WeakMap();
+const getTrackingParamsSet = (params) => {
+	let cached = trackingParamsCache.get(params);
+	if (!cached) {
+		cached = new Set(params.map((param) => param.toLowerCase()));
+		trackingParamsCache.set(params, cached);
+	}
+	return cached;
+};
+const parseUrl = (url) => {
+	try {
+		return new URL(url);
+	} catch {}
+};
+const deleteTrackingParams = (url, trackingParams) => {
+	if (!url.search) return false;
+	const trackingSet = getTrackingParamsSet(trackingParams);
+	const keysToDelete = [];
+	for (const key of url.searchParams.keys()) if (trackingSet.has(key.toLowerCase())) keysToDelete.push(key);
+	for (const key of keysToDelete) url.searchParams.delete(key);
+	return keysToDelete.length > 0;
+};
+const applyUnwrappers = (url, unwrappers) => {
+	for (const unwrap of unwrappers) {
+		const target = unwrap(url);
+		if (target) return target;
+	}
+};
+const unwrapUrl = (url, unwrappers = defaultUnwrappers) => {
+	const parsed = parseUrl(url);
+	if (!parsed) return;
+	return applyUnwrappers(parsed, unwrappers);
+};
+const stripTrackingParams = (url, trackingParams = defaultTrackingParams) => {
+	const parsed = parseUrl(url);
+	if (!parsed) return url;
+	if (deleteTrackingParams(parsed, trackingParams)) return parsed.toString();
+	return url;
+};
+const cleanUrl = (url, options) => {
+	const unwrappers = options?.unwrappers ?? defaultUnwrappers;
+	const trackingParams = options?.trackingParams ?? defaultTrackingParams;
+	const maxUnwrapDepth = options?.maxUnwrapDepth ?? 3;
+	const parsed = parseUrl(url);
+	if (!parsed) return url;
+	let currentUrl = url;
+	let currentParsed = parsed;
+	for (let depth = 0; depth < maxUnwrapDepth; depth += 1) {
+		const target = applyUnwrappers(currentParsed, unwrappers);
+		if (!target) break;
+		const targetParsed = parseUrl(target);
+		if (!targetParsed) break;
+		currentUrl = target;
+		currentParsed = targetParsed;
+	}
+	if (deleteTrackingParams(currentParsed, trackingParams)) return currentParsed.toString();
+	return currentUrl;
+};
+//#endregion
+export { cleanUrl, stripTrackingParams, unwrapUrl };

package/dist/defaults.d.ts

@@ -0,0 +1,7 @@
+import { UrlUnwrapper } from "./types.js";
+import { defaultTrackingParams } from "./params.js";
+
+//#region src/defaults.d.ts
+declare const defaultUnwrappers: Array<UrlUnwrapper>;
+//#endregion
+export { defaultUnwrappers };

package/dist/defaults.js

@@ -0,0 +1,30 @@
+import { unwrapBing } from "./unwraps/bing.js";
+import { unwrapFacebookShim } from "./unwraps/facebook.js";
+import { unwrapGoogle } from "./unwraps/google.js";
+import { unwrapGoogleAmpViewer } from "./unwraps/googleAmpViewer.js";
+import { unwrapGoogleNews } from "./unwraps/googleNews.js";
+import { unwrapGoogleNewsModern } from "./unwraps/googleNewsModern.js";
+import { unwrapGoogleScholar } from "./unwraps/googleScholar.js";
+import { unwrapInstagramShim } from "./unwraps/instagram.js";
+import { unwrapRedditOut } from "./unwraps/redditOut.js";
+import { unwrapVkAway } from "./unwraps/vkAway.js";
+import { unwrapYahooSearch } from "./unwraps/yahooSearch.js";
+import { unwrapYouTube } from "./unwraps/youtube.js";
+import "./params.js";
+//#region src/defaults.ts
+const defaultUnwrappers = [
+	unwrapBing,
+	unwrapGoogle,
+	unwrapGoogleNews,
+	unwrapGoogleNewsModern,
+	unwrapGoogleScholar,
+	unwrapGoogleAmpViewer,
+	unwrapYahooSearch,
+	unwrapYouTube,
+	unwrapFacebookShim,
+	unwrapInstagramShim,
+	unwrapVkAway,
+	unwrapRedditOut
+];
+//#endregion
+export { defaultUnwrappers };

package/dist/index.d.ts

@@ -0,0 +1,80 @@
+import { CleanUrlOptions, UrlUnwrapper } from "./types.js";
+import { cleanUrl, stripTrackingParams, unwrapUrl } from "./clean.js";
+import { defaultTrackingParams } from "./params.js";
+import { defaultUnwrappers } from "./defaults.js";
+import { unwrapAceml } from "./unwraps/aceml.js";
+import { unwrapAdjust } from "./unwraps/adjust.js";
+import { unwrapAmazonAffiliate } from "./unwraps/amazonAffiliate.js";
+import { unwrapAmpCache } from "./unwraps/ampCache.js";
+import { unwrapAwin } from "./unwraps/awin.js";
+import { unwrapBing } from "./unwraps/bing.js";
+import { unwrapCjNetwork } from "./unwraps/cjNetwork.js";
+import { unwrapDigidip } from "./unwraps/digidip.js";
+import { unwrapDisqus } from "./unwraps/disqus.js";
+import { unwrapDouban } from "./unwraps/douban.js";
+import { unwrapDuckduckgo } from "./unwraps/duckduckgo.js";
+import { unwrapEbayRover } from "./unwraps/ebayRover.js";
+import { unwrapEffiliation } from "./unwraps/effiliation.js";
+import { unwrapEmbedly } from "./unwraps/embedly.js";
+import { unwrapFacebookShim } from "./unwraps/facebook.js";
+import { unwrapFeedsportal } from "./unwraps/feedsportal.js";
+import { unwrapFirebaseDynamicLinks } from "./unwraps/firebaseDynamicLinks.js";
+import { unwrapFlipboard } from "./unwraps/flipboard.js";
+import { unwrapGateSc } from "./unwraps/gateSc.js";
+import { unwrapGeoriot } from "./unwraps/georiot.js";
+import { unwrapGitee } from "./unwraps/gitee.js";
+import { unwrapGoogle } from "./unwraps/google.js";
+import { unwrapGoogleAmpViewer } from "./unwraps/googleAmpViewer.js";
+import { unwrapGoogleNews } from "./unwraps/googleNews.js";
+import { unwrapGoogleNewsModern } from "./unwraps/googleNewsModern.js";
+import { unwrapGoogleScholar } from "./unwraps/googleScholar.js";
+import { unwrapGoogleTranslate } from "./unwraps/googleTranslate.js";
+import { unwrapHashnode } from "./unwraps/hashnode.js";
+import { unwrapIcptrack } from "./unwraps/icptrack.js";
+import { unwrapIdealoPartner } from "./unwraps/idealoPartner.js";
+import { unwrapInstagramShim } from "./unwraps/instagram.js";
+import { unwrapJianshuGo } from "./unwraps/jianshuGo.js";
+import { unwrapJuejin } from "./unwraps/juejin.js";
+import { unwrapLeverAnalytics } from "./unwraps/leverAnalytics.js";
+import { unwrapLinksynergy } from "./unwraps/linksynergy.js";
+import { unwrapMailchimp } from "./unwraps/mailchimp.js";
+import { unwrapMailpanion } from "./unwraps/mailpanion.js";
+import { unwrapMailpgn } from "./unwraps/mailpgn.js";
+import { unwrapMailtrack } from "./unwraps/mailtrack.js";
+import { unwrapMedium } from "./unwraps/medium.js";
+import { unwrapMimecast } from "./unwraps/mimecast.js";
+import { unwrapMozillaOutgoing } from "./unwraps/mozillaOutgoing.js";
+import { unwrapNarrativ } from "./unwraps/narrativ.js";
+import { unwrapNicoMs } from "./unwraps/nicoMs.js";
+import { unwrapOutlookSafelinks } from "./unwraps/outlookSafelinks.js";
+import { unwrapPartnerAds } from "./unwraps/partnerAds.js";
+import { unwrapPocket } from "./unwraps/pocket.js";
+import { unwrapPostmark } from "./unwraps/postmark.js";
+import { unwrapProofpointV1 } from "./unwraps/proofpointV1.js";
+import { unwrapProofpointV2 } from "./unwraps/proofpointV2.js";
+import { unwrapProofpointV3 } from "./unwraps/proofpointV3.js";
+import { unwrapPxf } from "./unwraps/pxf.js";
+import { unwrapRecruitics } from "./unwraps/recruitics.js";
+import { unwrapRedditOut } from "./unwraps/redditOut.js";
+import { unwrapRedirectingat } from "./unwraps/redirectingat.js";
+import { unwrapSegmentfault } from "./unwraps/segmentfault.js";
+import { unwrapShareasale } from "./unwraps/shareasale.js";
+import { unwrapSjv } from "./unwraps/sjv.js";
+import { unwrapSkimlinks } from "./unwraps/skimlinks.js";
+import { unwrapSlack } from "./unwraps/slack.js";
+import { unwrapSmartredirect } from "./unwraps/smartredirect.js";
+import { unwrapSspai } from "./unwraps/sspai.js";
+import { unwrapSteamLinkfilter } from "./unwraps/steamLinkfilter.js";
+import { unwrapTelegramIv } from "./unwraps/telegramIv.js";
+import { unwrapTradedoubler } from "./unwraps/tradedoubler.js";
+import { unwrapTumblr } from "./unwraps/tumblr.js";
+import { unwrapValuecommerce } from "./unwraps/valuecommerce.js";
+import { unwrapViglink } from "./unwraps/viglink.js";
+import { unwrapVkAway } from "./unwraps/vkAway.js";
+import { unwrapWebArchive } from "./unwraps/webArchive.js";
+import { unwrapYahooSearch } from "./unwraps/yahooSearch.js";
+import { unwrapYandexTurbo } from "./unwraps/yandexTurbo.js";
+import { unwrapYouTube } from "./unwraps/youtube.js";
+import { unwrapZhihu } from "./unwraps/zhihu.js";
+import { ParamExtractorConfig, createParamExtractor } from "./utils.js";
+export { type CleanUrlOptions, type ParamExtractorConfig, type UrlUnwrapper, cleanUrl, createParamExtractor, defaultTrackingParams, defaultUnwrappers, stripTrackingParams, unwrapAceml, unwrapAdjust, unwrapAmazonAffiliate, unwrapAmpCache, unwrapAwin, unwrapBing, unwrapCjNetwork, unwrapDigidip, unwrapDisqus, unwrapDouban, unwrapDuckduckgo, unwrapEbayRover, unwrapEffiliation, unwrapEmbedly, unwrapFacebookShim, unwrapFeedsportal, unwrapFirebaseDynamicLinks, unwrapFlipboard, unwrapGateSc, unwrapGeoriot, unwrapGitee, unwrapGoogle, unwrapGoogleAmpViewer, unwrapGoogleNews, unwrapGoogleNewsModern, unwrapGoogleScholar, unwrapGoogleTranslate, unwrapHashnode, unwrapIcptrack, unwrapIdealoPartner, unwrapInstagramShim, unwrapJianshuGo, unwrapJuejin, unwrapLeverAnalytics, unwrapLinksynergy, unwrapMailchimp, unwrapMailpanion, unwrapMailpgn, unwrapMailtrack, unwrapMedium, unwrapMimecast, unwrapMozillaOutgoing, unwrapNarrativ, unwrapNicoMs, unwrapOutlookSafelinks, unwrapPartnerAds, unwrapPocket, unwrapPostmark, unwrapProofpointV1, unwrapProofpointV2, unwrapProofpointV3, unwrapPxf, unwrapRecruitics, unwrapRedditOut, unwrapRedirectingat, unwrapSegmentfault, unwrapShareasale, unwrapSjv, unwrapSkimlinks, unwrapSlack, unwrapSmartredirect, unwrapSspai, unwrapSteamLinkfilter, unwrapTelegramIv, unwrapTradedoubler, unwrapTumblr, unwrapUrl, unwrapValuecommerce, unwrapViglink, unwrapVkAway, unwrapWebArchive, unwrapYahooSearch, unwrapYandexTurbo, unwrapYouTube, unwrapZhihu };

package/dist/index.js

@@ -0,0 +1,79 @@
+import { createParamExtractor } from "./utils.js";
+import { unwrapBing } from "./unwraps/bing.js";
+import { unwrapFacebookShim } from "./unwraps/facebook.js";
+import { unwrapGoogle } from "./unwraps/google.js";
+import { unwrapGoogleAmpViewer } from "./unwraps/googleAmpViewer.js";
+import { unwrapGoogleNews } from "./unwraps/googleNews.js";
+import { unwrapGoogleNewsModern } from "./unwraps/googleNewsModern.js";
+import { unwrapGoogleScholar } from "./unwraps/googleScholar.js";
+import { unwrapInstagramShim } from "./unwraps/instagram.js";
+import { unwrapRedditOut } from "./unwraps/redditOut.js";
+import { unwrapVkAway } from "./unwraps/vkAway.js";
+import { unwrapYahooSearch } from "./unwraps/yahooSearch.js";
+import { unwrapYouTube } from "./unwraps/youtube.js";
+import { defaultTrackingParams } from "./params.js";
+import { defaultUnwrappers } from "./defaults.js";
+import { cleanUrl, stripTrackingParams, unwrapUrl } from "./clean.js";
+import { unwrapAceml } from "./unwraps/aceml.js";
+import { unwrapAdjust } from "./unwraps/adjust.js";
+import { unwrapAmazonAffiliate } from "./unwraps/amazonAffiliate.js";
+import { unwrapAmpCache } from "./unwraps/ampCache.js";
+import { unwrapAwin } from "./unwraps/awin.js";
+import { unwrapCjNetwork } from "./unwraps/cjNetwork.js";
+import { unwrapDigidip } from "./unwraps/digidip.js";
+import { unwrapDisqus } from "./unwraps/disqus.js";
+import { unwrapDouban } from "./unwraps/douban.js";
+import { unwrapDuckduckgo } from "./unwraps/duckduckgo.js";
+import { unwrapEbayRover } from "./unwraps/ebayRover.js";
+import { unwrapEffiliation } from "./unwraps/effiliation.js";
+import { unwrapEmbedly } from "./unwraps/embedly.js";
+import { unwrapFeedsportal } from "./unwraps/feedsportal.js";
+import { unwrapFirebaseDynamicLinks } from "./unwraps/firebaseDynamicLinks.js";
+import { unwrapFlipboard } from "./unwraps/flipboard.js";
+import { unwrapGateSc } from "./unwraps/gateSc.js";
+import { unwrapGeoriot } from "./unwraps/georiot.js";
+import { unwrapGitee } from "./unwraps/gitee.js";
+import { unwrapGoogleTranslate } from "./unwraps/googleTranslate.js";
+import { unwrapHashnode } from "./unwraps/hashnode.js";
+import { unwrapIcptrack } from "./unwraps/icptrack.js";
+import { unwrapIdealoPartner } from "./unwraps/idealoPartner.js";
+import { unwrapJianshuGo } from "./unwraps/jianshuGo.js";
+import { unwrapJuejin } from "./unwraps/juejin.js";
+import { unwrapLeverAnalytics } from "./unwraps/leverAnalytics.js";
+import { unwrapLinksynergy } from "./unwraps/linksynergy.js";
+import { unwrapMailchimp } from "./unwraps/mailchimp.js";
+import { unwrapMailpanion } from "./unwraps/mailpanion.js";
+import { unwrapMailpgn } from "./unwraps/mailpgn.js";
+import { unwrapMailtrack } from "./unwraps/mailtrack.js";
+import { unwrapMedium } from "./unwraps/medium.js";
+import { unwrapMimecast } from "./unwraps/mimecast.js";
+import { unwrapMozillaOutgoing } from "./unwraps/mozillaOutgoing.js";
+import { unwrapNarrativ } from "./unwraps/narrativ.js";
+import { unwrapNicoMs } from "./unwraps/nicoMs.js";
+import { unwrapOutlookSafelinks } from "./unwraps/outlookSafelinks.js";
+import { unwrapPartnerAds } from "./unwraps/partnerAds.js";
+import { unwrapPocket } from "./unwraps/pocket.js";
+import { unwrapPostmark } from "./unwraps/postmark.js";
+import { unwrapProofpointV1 } from "./unwraps/proofpointV1.js";
+import { unwrapProofpointV2 } from "./unwraps/proofpointV2.js";
+import { unwrapProofpointV3 } from "./unwraps/proofpointV3.js";
+import { unwrapPxf } from "./unwraps/pxf.js";
+import { unwrapRecruitics } from "./unwraps/recruitics.js";
+import { unwrapRedirectingat } from "./unwraps/redirectingat.js";
+import { unwrapSegmentfault } from "./unwraps/segmentfault.js";
+import { unwrapShareasale } from "./unwraps/shareasale.js";
+import { unwrapSjv } from "./unwraps/sjv.js";
+import { unwrapSkimlinks } from "./unwraps/skimlinks.js";
+import { unwrapSlack } from "./unwraps/slack.js";
+import { unwrapSmartredirect } from "./unwraps/smartredirect.js";
+import { unwrapSspai } from "./unwraps/sspai.js";
+import { unwrapSteamLinkfilter } from "./unwraps/steamLinkfilter.js";
+import { unwrapTelegramIv } from "./unwraps/telegramIv.js";
+import { unwrapTradedoubler } from "./unwraps/tradedoubler.js";
+import { unwrapTumblr } from "./unwraps/tumblr.js";
+import { unwrapValuecommerce } from "./unwraps/valuecommerce.js";
+import { unwrapViglink } from "./unwraps/viglink.js";
+import { unwrapWebArchive } from "./unwraps/webArchive.js";
+import { unwrapYandexTurbo } from "./unwraps/yandexTurbo.js";
+import { unwrapZhihu } from "./unwraps/zhihu.js";
+export { cleanUrl, createParamExtractor, defaultTrackingParams, defaultUnwrappers, stripTrackingParams, unwrapAceml, unwrapAdjust, unwrapAmazonAffiliate, unwrapAmpCache, unwrapAwin, unwrapBing, unwrapCjNetwork, unwrapDigidip, unwrapDisqus, unwrapDouban, unwrapDuckduckgo, unwrapEbayRover, unwrapEffiliation, unwrapEmbedly, unwrapFacebookShim, unwrapFeedsportal, unwrapFirebaseDynamicLinks, unwrapFlipboard, unwrapGateSc, unwrapGeoriot, unwrapGitee, unwrapGoogle, unwrapGoogleAmpViewer, unwrapGoogleNews, unwrapGoogleNewsModern, unwrapGoogleScholar, unwrapGoogleTranslate, unwrapHashnode, unwrapIcptrack, unwrapIdealoPartner, unwrapInstagramShim, unwrapJianshuGo, unwrapJuejin, unwrapLeverAnalytics, unwrapLinksynergy, unwrapMailchimp, unwrapMailpanion, unwrapMailpgn, unwrapMailtrack, unwrapMedium, unwrapMimecast, unwrapMozillaOutgoing, unwrapNarrativ, unwrapNicoMs, unwrapOutlookSafelinks, unwrapPartnerAds, unwrapPocket, unwrapPostmark, unwrapProofpointV1, unwrapProofpointV2, unwrapProofpointV3, unwrapPxf, unwrapRecruitics, unwrapRedditOut, unwrapRedirectingat, unwrapSegmentfault, unwrapShareasale, unwrapSjv, unwrapSkimlinks, unwrapSlack, unwrapSmartredirect, unwrapSspai, unwrapSteamLinkfilter, unwrapTelegramIv, unwrapTradedoubler, unwrapTumblr, unwrapUrl, unwrapValuecommerce, unwrapViglink, unwrapVkAway, unwrapWebArchive, unwrapYahooSearch, unwrapYandexTurbo, unwrapYouTube, unwrapZhihu };

package/dist/params.d.ts

@@ -0,0 +1,4 @@
+//#region src/params.d.ts
+declare const defaultTrackingParams: string[];
+//#endregion
+export { defaultTrackingParams };

package/dist/params.js

@@ -0,0 +1,157 @@
+//#region src/params.ts
+const defaultTrackingParams = [
+	"utm_source",
+	"utm_medium",
+	"utm_campaign",
+	"utm_term",
+	"utm_content",
+	"utm_reader",
+	"utm_name",
+	"utm_cid",
+	"utm_viz_id",
+	"gclid",
+	"dclid",
+	"gbraid",
+	"wbraid",
+	"gclsrc",
+	"gad_source",
+	"gad_campaignid",
+	"srsltid",
+	"fbclid",
+	"fb_action_ids",
+	"fb_action_types",
+	"fb_source",
+	"fb_ref",
+	"_ga",
+	"_gl",
+	"_bk",
+	"_ke",
+	"mc_cid",
+	"mc_eid",
+	"mc_tc",
+	"mkt_tok",
+	"msclkid",
+	"twclid",
+	"ttclid",
+	"igshid",
+	"mtm_campaign",
+	"mtm_cid",
+	"mtm_content",
+	"mtm_group",
+	"mtm_keyword",
+	"mtm_medium",
+	"mtm_placement",
+	"mtm_source",
+	"pk_campaign",
+	"pk_cid",
+	"pk_content",
+	"pk_keyword",
+	"pk_medium",
+	"pk_source",
+	"ncid",
+	"sr_share",
+	"hsa_acc",
+	"hsa_ad",
+	"hsa_cam",
+	"hsa_grp",
+	"hsa_kw",
+	"hsa_mt",
+	"hsa_net",
+	"hsa_src",
+	"hsa_tgt",
+	"hsa_ver",
+	"hsCtaTracking",
+	"_hsenc",
+	"_hsmi",
+	"__hstc",
+	"__hsfp",
+	"__hssc",
+	"cid",
+	"s_kwcid",
+	"sc_cid",
+	"ef_id",
+	"obOrigUrl",
+	"dicbo",
+	"yclid",
+	"ysclid",
+	"_openstat",
+	"awinaffid",
+	"awinmid",
+	"clickref",
+	"afftrack",
+	"itm_source",
+	"itm_medium",
+	"itm_campaign",
+	"itm_content",
+	"itm_channel",
+	"itm_audience",
+	"int_source",
+	"int_medium",
+	"int_campaign",
+	"int_content",
+	"int_placement",
+	"int_campaign_type",
+	"int_keycode",
+	"g2i_source",
+	"g2i_medium",
+	"g2i_campaign",
+	"g2i_or_o",
+	"g2i_or_p",
+	"doing_wp_cron",
+	"preview",
+	"preview_id",
+	"preview_nonce",
+	"replytocom",
+	"_",
+	"timestamp",
+	"ts",
+	"cb",
+	"cachebuster",
+	"nocache",
+	"rand",
+	"random",
+	"sbdcrw",
+	"forceByPassCache",
+	"sucurianticache",
+	"cleancache",
+	"rebuildcache",
+	"kontrol_health_check_timestamp",
+	"action_object_map",
+	"action_ref_map",
+	"action_type_map",
+	"algo_expid",
+	"algo_pvid",
+	"at_campaign",
+	"at_custom1",
+	"at_custom2",
+	"at_custom3",
+	"at_custom4",
+	"at_medium",
+	"at_preview_index",
+	"_bhlid",
+	"_branch_match_id",
+	"_branch_referrer",
+	"__readwiseLocation",
+	"campaign_id",
+	"click_sum",
+	"fref",
+	"gs_l",
+	"hmb_campaign",
+	"hmb_medium",
+	"hmb_source",
+	"ml_subscriber",
+	"ml_subscriber_hash",
+	"oly_anon_id",
+	"oly_enc_id",
+	"rb_clickid",
+	"referer",
+	"referrer",
+	"spm",
+	"trk",
+	"vero_conv",
+	"vero_id",
+	"wickedid",
+	"xtor"
+];
+//#endregion
+export { defaultTrackingParams };

package/dist/types.d.ts

@@ -0,0 +1,9 @@
+//#region src/types.d.ts
+type UrlUnwrapper = (url: URL) => string | undefined;
+type CleanUrlOptions = {
+  unwrappers?: Array<UrlUnwrapper>;
+  trackingParams?: Array<string>;
+  maxUnwrapDepth?: number;
+};
+//#endregion
+export { CleanUrlOptions, UrlUnwrapper };

package/dist/unwraps/aceml.d.ts

@@ -0,0 +1,6 @@
+import { UrlUnwrapper } from "../types.js";
+
+//#region src/unwraps/aceml.d.ts
+declare const unwrapAceml: UrlUnwrapper;
+//#endregion
+export { unwrapAceml };

package/dist/unwraps/aceml.js

@@ -0,0 +1,15 @@
+import { createParamExtractor, decodeBase64 } from "../utils.js";
+//#region src/unwraps/aceml.ts
+const baseExtractor = createParamExtractor({
+	hosts: /\.acemln[a-d]\.com$/,
+	path: "/Prod/link-tracker",
+	params: ["redirectUrl"]
+});
+const unwrapAceml = (url) => {
+	const raw = baseExtractor(url);
+	if (!raw) return;
+	const decoded = decodeBase64(raw);
+	if (decoded && (decoded.startsWith("http://") || decoded.startsWith("https://"))) return decoded;
+};
+//#endregion
+export { unwrapAceml };

package/dist/unwraps/adjust.d.ts

@@ -0,0 +1,6 @@
+import { UrlUnwrapper } from "../types.js";
+
+//#region src/unwraps/adjust.d.ts
+declare const unwrapAdjust: UrlUnwrapper;
+//#endregion
+export { unwrapAdjust };

package/dist/unwraps/adjust.js

@@ -0,0 +1,9 @@
+//#region src/unwraps/adjust.ts
+const unwrapAdjust = (url) => {
+	if (url.hostname !== "app.adjust.com") return;
+	const target = url.searchParams.get("redirect");
+	if (target?.startsWith("https://") !== true && target?.startsWith("http://") !== true) return;
+	return target;
+};
+//#endregion
+export { unwrapAdjust };

package/dist/unwraps/amazonAffiliate.d.ts

@@ -0,0 +1,6 @@
+import { UrlUnwrapper } from "../types.js";
+
+//#region src/unwraps/amazonAffiliate.d.ts
+declare const unwrapAmazonAffiliate: UrlUnwrapper;
+//#endregion
+export { unwrapAmazonAffiliate };

package/dist/unwraps/amazonAffiliate.js

@@ -0,0 +1,9 @@
+//#region src/unwraps/amazonAffiliate.ts
+const amazonHostRegex = /\.amazon-adsystem\.com$/;
+const amazonPathRegex = /^\/x\/c\/[^/]+\/(https?:\/\/.+)$/;
+const unwrapAmazonAffiliate = (url) => {
+	if (!amazonHostRegex.test(url.hostname)) return;
+	return url.pathname.match(amazonPathRegex)?.[1];
+};
+//#endregion
+export { unwrapAmazonAffiliate };

package/dist/unwraps/ampCache.d.ts

@@ -0,0 +1,6 @@
+import { UrlUnwrapper } from "../types.js";
+
+//#region src/unwraps/ampCache.d.ts
+declare const unwrapAmpCache: UrlUnwrapper;
+//#endregion
+export { unwrapAmpCache };

package/dist/unwraps/ampCache.js

@@ -0,0 +1,13 @@
+import { isHostOf, isSubdomainOf } from "../utils.js";
+//#region src/unwraps/ampCache.ts
+const httpsPathRegex = /^\/c\/s\/(.+)$/;
+const httpPathRegex = /^\/c\/(?!s\/)(.+)$/;
+const unwrapAmpCache = (url) => {
+	if (!isHostOf(url, "cdn.ampproject.org") && !isSubdomainOf(url, "cdn.ampproject.org")) return;
+	const httpsMatch = url.pathname.match(httpsPathRegex);
+	if (httpsMatch) return `https://${httpsMatch[1]}`;
+	const httpMatch = url.pathname.match(httpPathRegex);
+	if (httpMatch) return `http://${httpMatch[1]}`;
+};
+//#endregion
+export { unwrapAmpCache };

package/dist/unwraps/awin.d.ts

@@ -0,0 +1,6 @@
+import { UrlUnwrapper } from "../types.js";
+
+//#region src/unwraps/awin.d.ts
+declare const unwrapAwin: UrlUnwrapper;
+//#endregion
+export { unwrapAwin };