urlpurify 1.0.0

package/dist/unwraps/tumblr.js

@@ -0,0 +1,9 @@
+import { createParamExtractor } from "../utils.js";
+//#region src/unwraps/tumblr.ts
+const unwrapTumblr = createParamExtractor({
+	hosts: "t.umblr.com",
+	path: "/redirect",
+	params: ["z"]
+});
+//#endregion
+export { unwrapTumblr };

package/dist/unwraps/valuecommerce.d.ts

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

package/dist/unwraps/valuecommerce.js

@@ -0,0 +1,9 @@
+import { createParamExtractor } from "../utils.js";
+//#region src/unwraps/valuecommerce.ts
+const unwrapValuecommerce = createParamExtractor({
+	hosts: "ck.jp.ap.valuecommerce.com",
+	path: "/servlet/referral",
+	params: ["vc_url"]
+});
+//#endregion
+export { unwrapValuecommerce };

package/dist/unwraps/viglink.d.ts

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

package/dist/unwraps/viglink.js

@@ -0,0 +1,8 @@
+import { createParamExtractor } from "../utils.js";
+//#region src/unwraps/viglink.ts
+const unwrapViglink = createParamExtractor({
+	hosts: "redirect.viglink.com",
+	params: ["u"]
+});
+//#endregion
+export { unwrapViglink };

package/dist/unwraps/vkAway.d.ts

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

package/dist/unwraps/vkAway.js

@@ -0,0 +1,9 @@
+import { createParamExtractor } from "../utils.js";
+//#region src/unwraps/vkAway.ts
+const unwrapVkAway = createParamExtractor({
+	hosts: "vk.com",
+	path: "/away.php",
+	params: ["to"]
+});
+//#endregion
+export { unwrapVkAway };

package/dist/unwraps/webArchive.d.ts

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

package/dist/unwraps/webArchive.js

@@ -0,0 +1,12 @@
+//#region src/unwraps/webArchive.ts
+const pathRegex = /^\/web\/\d{14}\*?\/(.+)$/;
+const unwrapWebArchive = (url) => {
+	if (url.hostname !== "web.archive.org") return;
+	const match = url.pathname.match(pathRegex);
+	if (!match) return;
+	try {
+		return decodeURIComponent(match[1]);
+	} catch {}
+};
+//#endregion
+export { unwrapWebArchive };

package/dist/unwraps/yahooSearch.d.ts

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

package/dist/unwraps/yahooSearch.js

@@ -0,0 +1,12 @@
+//#region src/unwraps/yahooSearch.ts
+const yahooPathRegex = /\/RU=([^/]+)\/RK=/;
+const unwrapYahooSearch = (url) => {
+	if (url.hostname !== "r.search.yahoo.com") return;
+	const match = url.pathname.match(yahooPathRegex);
+	if (!match) return;
+	try {
+		return decodeURIComponent(match[1]);
+	} catch {}
+};
+//#endregion
+export { unwrapYahooSearch };

package/dist/unwraps/yandexTurbo.d.ts

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

package/dist/unwraps/yandexTurbo.js

@@ -0,0 +1,12 @@
+//#region src/unwraps/yandexTurbo.ts
+const turbopagesHostRegex = /\.turbopages\.org$/;
+const turbopagesPathRegex = /^\/[^/]+\/s\/(.+)$/;
+const dashRegex = /-/g;
+const unwrapYandexTurbo = (url) => {
+	if (!turbopagesHostRegex.test(url.hostname)) return;
+	const match = url.pathname.match(turbopagesPathRegex);
+	if (!match) return;
+	return `https://${url.hostname.replace(turbopagesHostRegex, "").replace(dashRegex, ".")}/${match[1]}`;
+};
+//#endregion
+export { unwrapYandexTurbo };

package/dist/unwraps/youtube.d.ts

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

package/dist/unwraps/youtube.js

@@ -0,0 +1,9 @@
+import { createParamExtractor } from "../utils.js";
+//#region src/unwraps/youtube.ts
+const unwrapYouTube = createParamExtractor({
+	hosts: "www.youtube.com",
+	path: "/redirect",
+	params: ["q"]
+});
+//#endregion
+export { unwrapYouTube };

package/dist/unwraps/zhihu.d.ts

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

package/dist/unwraps/zhihu.js

@@ -0,0 +1,8 @@
+import { createParamExtractor } from "../utils.js";
+//#region src/unwraps/zhihu.ts
+const unwrapZhihu = createParamExtractor({
+	hosts: "link.zhihu.com",
+	params: ["target"]
+});
+//#endregion
+export { unwrapZhihu };

package/dist/utils.d.ts

@@ -0,0 +1,11 @@
+import { UrlUnwrapper } from "./types.js";
+
+//#region src/utils.d.ts
+type ParamExtractorConfig = {
+  hosts: string | Array<string> | RegExp;
+  path?: string;
+  params: Array<string>;
+};
+declare const createParamExtractor: (config: ParamExtractorConfig) => UrlUnwrapper;
+//#endregion
+export { ParamExtractorConfig, createParamExtractor };

package/dist/utils.js

@@ -0,0 +1,50 @@
+//#region src/utils.ts
+const createHostMatcher = (hosts) => {
+	if (hosts instanceof RegExp) return (host) => hosts.test(host);
+	const hostSet = new Set(Array.isArray(hosts) ? hosts : [hosts]);
+	return (host) => hostSet.has(host);
+};
+const createParamExtractor = (config) => {
+	const matchesHost = createHostMatcher(config.hosts);
+	return (url) => {
+		if (!matchesHost(url.hostname)) return;
+		if (config.path && url.pathname !== config.path) return;
+		for (const param of config.params) {
+			const value = url.searchParams.get(param);
+			if (value) return value;
+		}
+	};
+};
+const isHostOf = (url, hosts) => {
+	try {
+		const hostname = (url instanceof URL ? url : new URL(url)).hostname.toLowerCase();
+		return (Array.isArray(hosts) ? hosts : [hosts]).some((host) => hostname === host.toLowerCase().trim());
+	} catch {}
+	return false;
+};
+const isSubdomainOf = (url, domains) => {
+	try {
+		const hostname = (url instanceof URL ? url : new URL(url)).hostname.toLowerCase();
+		return (Array.isArray(domains) ? domains : [domains]).some((domain) => hostname.endsWith(`.${domain}`));
+	} catch {}
+	return false;
+};
+const decodeBase64Binary = (value) => {
+	try {
+		return atob(value);
+	} catch {}
+};
+const decodeBase64 = (value) => {
+	const binary = decodeBase64Binary(value);
+	if (binary === void 0) return;
+	const bytes = Uint8Array.from(binary, (char) => char.charCodeAt(0));
+	return new TextDecoder().decode(bytes);
+};
+const decodeBase64Url = (value) => {
+	return decodeBase64(value.replace(/-/g, "+").replace(/_/g, "/"));
+};
+const getUtf8ByteLength = (value) => {
+	return new TextEncoder().encode(value).length;
+};
+//#endregion
+export { createParamExtractor, decodeBase64, decodeBase64Binary, decodeBase64Url, getUtf8ByteLength, isHostOf, isSubdomainOf };

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "urlpurify",
+  "description": "Unwrap redirect, affiliate, and tracking wrapper URLs and strip tracking parameters. Turn noisy links into clean, direct URLs.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/macieklamberski/urlpurify.git"
+  },
+  "bugs": {
+    "url": "https://github.com/macieklamberski/urlpurify/issues"
+  },
+  "license": "MIT",
+  "author": "Maciej Lamberski",
+  "sideEffects": false,
+  "keywords": [
+    "url",
+    "clean",
+    "tracking",
+    "utm",
+    "redirect",
+    "unwrap",
+    "affiliate",
+    "privacy"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "prepare": "lefthook install",
+    "build": "tsdown src/index.ts --format esm --dts --clean --unbundle --no-fixed-extension",
+    "test": "bun test"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.14",
+    "kvalita": "^1.14.0",
+    "tsdown": "^0.22.2"
+  },
+  "version": "1.0.0"
+}