feedcanon 0.9.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 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,88 @@
+# Feedcanon
+
+[![codecov](https://codecov.io/gh/macieklamberski/feedcanon/branch/main/graph/badge.svg)](https://codecov.io/gh/macieklamberski/feedcanon)
+[![npm version](https://img.shields.io/npm/v/feedcanon.svg)](https://www.npmjs.com/package/feedcanon)
+[![license](https://img.shields.io/npm/l/feedcanon.svg)](https://github.com/macieklamberski/feedcanon/blob/main/LICENSE)
+
+Find the canonical URL for any web feed by comparing actual content. Turn messy feed URLs into their cleanest, most reliable form.
+
+Many URLs can point to the same feed—varying by protocol, www prefixes, trailing slashes, order of params, or domain aliases. Feedcanon compares actual feed content, considers the feed's declared self URL, and tests simpler URL alternatives to find the cleanest working one. Perfect for feed readers that need consistent, deduplicated subscriptions.
+
+---
+
+## How It Works
+
+- Read the feed's declared self URL (`atom:link rel="self"`) and validate it serves identical content.
+- Generate URL variants from cleanest to least clean, testing each until one works.
+- Verify URLs serve the same feed using exact body match, then signature-based matching.
+- Attempt to upgrade HTTP URLs to HTTPS when both serve identical content.
+- Normalize platform-specific domains (e.g., FeedBurner aliases like `feedproxy.google.com` → `feeds.feedburner.com`).
+
+## Quick Start
+
+### Installation
+
+```bash
+npm install feedcanon
+```
+
+### Basic Usage
+
+```typescript
+import { findCanonical } from 'feedcanon'
+
+const url = await findCanonical('https://www.example.com/feed/?utm_source=twitter')
+
+// 'https://example.com/feed'
+```
+
+### With Callbacks
+
+```typescript
+import { findCanonical } from 'feedcanon'
+
+const url = await findCanonical('https://example.com/feed', {
+  onFetch: ({ url, response }) => {
+    console.log('Fetched:', url, response.status)
+  },
+  onMatch: ({ url, feed }) => {
+    console.log('Found matching URL:', url)
+  },
+})
+```
+
+### Custom Fetch
+
+```typescript
+import { findCanonical } from 'feedcanon'
+import axios from 'axios'
+
+const url = await findCanonical('https://example.com/feed', {
+  fetchFn: async (url) => {
+    const response = await axios.get(url)
+  
+    return {
+      status: response.status,
+      url: response.request.res.responseUrl,
+      body: response.data,
+      headers: new Headers(response.headers),
+    }
+  },
+})
+```
+
+### Database Integration
+
+```typescript
+import { findCanonical } from 'feedcanon'
+
+const url = await findCanonical('https://example.com/feed', {
+  existsFn: async (url) => {
+    // Return data if URL exists in your database, undefined otherwise.
+    return await db.feeds.findByUrl(url)
+  },
+  onExists: ({ url, data }) => {
+    console.log('URL already exists:', url)
+  },
+})
+```

package/dist/defaults.cjs

@@ -0,0 +1,188 @@
+const require_feedburner = require('./platforms/feedburner.cjs');
+
+//#region src/defaults.ts
+const defaultPlatforms = [require_feedburner.feedburnerHandler];
+const defaultStrippedParams = [
+	"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",
+	"fbclid",
+	"fb_action_ids",
+	"fb_action_types",
+	"fb_source",
+	"fb_ref",
+	"_ga",
+	"_gl",
+	"_bk",
+	"_ke",
+	"mc_cid",
+	"mc_eid",
+	"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",
+	"cid",
+	"s_kwcid",
+	"ef_id",
+	"obOrigUrl",
+	"dicbo",
+	"yclid",
+	"_",
+	"timestamp",
+	"ts",
+	"cb",
+	"cachebuster",
+	"nocache",
+	"rand",
+	"random",
+	"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",
+	"campaign_id",
+	"click_sum",
+	"fref",
+	"gs_l",
+	"hmb_campaign",
+	"hmb_medium",
+	"hmb_source",
+	"itm_campaign",
+	"itm_medium",
+	"itm_source",
+	"ml_subscriber",
+	"ml_subscriber_hash",
+	"oly_anon_id",
+	"oly_enc_id",
+	"rb_clickid",
+	"referer",
+	"referrer",
+	"spm",
+	"trk",
+	"vero_conv",
+	"vero_id",
+	"wickedid",
+	"xtor"
+];
+const defaultNormalizeOptions = {
+	stripProtocol: true,
+	stripAuthentication: false,
+	stripWww: true,
+	stripTrailingSlash: true,
+	stripRootSlash: true,
+	collapseSlashes: true,
+	stripHash: true,
+	stripTextFragment: true,
+	sortQueryParams: true,
+	stripQueryParams: defaultStrippedParams,
+	stripEmptyQuery: true,
+	normalizeEncoding: true,
+	lowercaseHostname: true,
+	normalizeUnicode: true,
+	convertToPunycode: true
+};
+const defaultTiers = [
+	{
+		stripProtocol: false,
+		stripAuthentication: false,
+		stripWww: true,
+		stripTrailingSlash: true,
+		stripRootSlash: true,
+		collapseSlashes: true,
+		stripHash: true,
+		stripTextFragment: true,
+		sortQueryParams: true,
+		stripQueryParams: defaultStrippedParams,
+		stripEmptyQuery: true,
+		normalizeEncoding: true,
+		lowercaseHostname: true,
+		normalizeUnicode: true,
+		convertToPunycode: true
+	},
+	{
+		stripProtocol: false,
+		stripAuthentication: false,
+		stripWww: false,
+		stripTrailingSlash: true,
+		stripRootSlash: true,
+		collapseSlashes: true,
+		stripHash: true,
+		stripTextFragment: true,
+		sortQueryParams: true,
+		stripQueryParams: defaultStrippedParams,
+		stripEmptyQuery: true,
+		normalizeEncoding: true,
+		lowercaseHostname: true,
+		normalizeUnicode: true,
+		convertToPunycode: true
+	},
+	{
+		stripProtocol: false,
+		stripAuthentication: false,
+		stripWww: false,
+		stripTrailingSlash: false,
+		stripRootSlash: true,
+		collapseSlashes: true,
+		stripHash: true,
+		stripTextFragment: true,
+		sortQueryParams: true,
+		stripQueryParams: defaultStrippedParams,
+		stripEmptyQuery: true,
+		normalizeEncoding: true,
+		lowercaseHostname: true,
+		normalizeUnicode: true,
+		convertToPunycode: true
+	}
+];
+
+//#endregion
+exports.defaultNormalizeOptions = defaultNormalizeOptions;
+exports.defaultPlatforms = defaultPlatforms;
+exports.defaultStrippedParams = defaultStrippedParams;
+exports.defaultTiers = defaultTiers;

package/dist/defaults.d.cts

@@ -0,0 +1,9 @@
+import { NormalizeOptions, PlatformHandler } from "./types.cjs";
+
+//#region src/defaults.d.ts
+declare const defaultPlatforms: Array<PlatformHandler>;
+declare const defaultStrippedParams: string[];
+declare const defaultNormalizeOptions: NormalizeOptions;
+declare const defaultTiers: Array<NormalizeOptions>;
+//#endregion
+export { defaultNormalizeOptions, defaultPlatforms, defaultStrippedParams, defaultTiers };

package/dist/defaults.d.ts

@@ -0,0 +1,9 @@
+import { NormalizeOptions, PlatformHandler } from "./types.js";
+
+//#region src/defaults.d.ts
+declare const defaultPlatforms: Array<PlatformHandler>;
+declare const defaultStrippedParams: string[];
+declare const defaultNormalizeOptions: NormalizeOptions;
+declare const defaultTiers: Array<NormalizeOptions>;
+//#endregion
+export { defaultNormalizeOptions, defaultPlatforms, defaultStrippedParams, defaultTiers };

package/dist/defaults.js

@@ -0,0 +1,185 @@
+import { feedburnerHandler } from "./platforms/feedburner.js";
+
+//#region src/defaults.ts
+const defaultPlatforms = [feedburnerHandler];
+const defaultStrippedParams = [
+	"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",
+	"fbclid",
+	"fb_action_ids",
+	"fb_action_types",
+	"fb_source",
+	"fb_ref",
+	"_ga",
+	"_gl",
+	"_bk",
+	"_ke",
+	"mc_cid",
+	"mc_eid",
+	"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",
+	"cid",
+	"s_kwcid",
+	"ef_id",
+	"obOrigUrl",
+	"dicbo",
+	"yclid",
+	"_",
+	"timestamp",
+	"ts",
+	"cb",
+	"cachebuster",
+	"nocache",
+	"rand",
+	"random",
+	"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",
+	"campaign_id",
+	"click_sum",
+	"fref",
+	"gs_l",
+	"hmb_campaign",
+	"hmb_medium",
+	"hmb_source",
+	"itm_campaign",
+	"itm_medium",
+	"itm_source",
+	"ml_subscriber",
+	"ml_subscriber_hash",
+	"oly_anon_id",
+	"oly_enc_id",
+	"rb_clickid",
+	"referer",
+	"referrer",
+	"spm",
+	"trk",
+	"vero_conv",
+	"vero_id",
+	"wickedid",
+	"xtor"
+];
+const defaultNormalizeOptions = {
+	stripProtocol: true,
+	stripAuthentication: false,
+	stripWww: true,
+	stripTrailingSlash: true,
+	stripRootSlash: true,
+	collapseSlashes: true,
+	stripHash: true,
+	stripTextFragment: true,
+	sortQueryParams: true,
+	stripQueryParams: defaultStrippedParams,
+	stripEmptyQuery: true,
+	normalizeEncoding: true,
+	lowercaseHostname: true,
+	normalizeUnicode: true,
+	convertToPunycode: true
+};
+const defaultTiers = [
+	{
+		stripProtocol: false,
+		stripAuthentication: false,
+		stripWww: true,
+		stripTrailingSlash: true,
+		stripRootSlash: true,
+		collapseSlashes: true,
+		stripHash: true,
+		stripTextFragment: true,
+		sortQueryParams: true,
+		stripQueryParams: defaultStrippedParams,
+		stripEmptyQuery: true,
+		normalizeEncoding: true,
+		lowercaseHostname: true,
+		normalizeUnicode: true,
+		convertToPunycode: true
+	},
+	{
+		stripProtocol: false,
+		stripAuthentication: false,
+		stripWww: false,
+		stripTrailingSlash: true,
+		stripRootSlash: true,
+		collapseSlashes: true,
+		stripHash: true,
+		stripTextFragment: true,
+		sortQueryParams: true,
+		stripQueryParams: defaultStrippedParams,
+		stripEmptyQuery: true,
+		normalizeEncoding: true,
+		lowercaseHostname: true,
+		normalizeUnicode: true,
+		convertToPunycode: true
+	},
+	{
+		stripProtocol: false,
+		stripAuthentication: false,
+		stripWww: false,
+		stripTrailingSlash: false,
+		stripRootSlash: true,
+		collapseSlashes: true,
+		stripHash: true,
+		stripTextFragment: true,
+		sortQueryParams: true,
+		stripQueryParams: defaultStrippedParams,
+		stripEmptyQuery: true,
+		normalizeEncoding: true,
+		lowercaseHostname: true,
+		normalizeUnicode: true,
+		convertToPunycode: true
+	}
+];
+
+//#endregion
+export { defaultNormalizeOptions, defaultPlatforms, defaultStrippedParams, defaultTiers };

package/dist/exports.cjs

@@ -0,0 +1,15 @@
+const require_feedburner = require('./platforms/feedburner.cjs');
+const require_defaults = require('./defaults.cjs');
+const require_utils = require('./utils.cjs');
+const require_index = require('./index.cjs');
+
+exports.addMissingProtocol = require_utils.addMissingProtocol;
+exports.defaultPlatforms = require_defaults.defaultPlatforms;
+exports.defaultStrippedParams = require_defaults.defaultStrippedParams;
+exports.defaultTiers = require_defaults.defaultTiers;
+exports.feedburnerHandler = require_feedburner.feedburnerHandler;
+exports.feedsmithParser = require_utils.feedsmithParser;
+exports.findCanonical = require_index.findCanonical;
+exports.normalizeUrl = require_utils.normalizeUrl;
+exports.resolveFeedProtocol = require_utils.resolveFeedProtocol;
+exports.resolveUrl = require_utils.resolveUrl;

package/dist/exports.d.cts

@@ -0,0 +1,6 @@
+import { ExistsFn, FetchFn, FetchFnOptions, FetchFnResponse, FindCanonicalOptions, NormalizeOptions, OnExistsFn, OnFetchFn, OnMatchFn, ParserAdapter, PlatformHandler } from "./types.cjs";
+import { defaultPlatforms, defaultStrippedParams, defaultTiers } from "./defaults.cjs";
+import { findCanonical } from "./index.cjs";
+import { feedburnerHandler } from "./platforms/feedburner.cjs";
+import { addMissingProtocol, feedsmithParser, normalizeUrl, resolveFeedProtocol, resolveUrl } from "./utils.cjs";
+export { type ExistsFn, type FetchFn, type FetchFnOptions, type FetchFnResponse, type FindCanonicalOptions, type NormalizeOptions, type OnExistsFn, type OnFetchFn, type OnMatchFn, type ParserAdapter, type PlatformHandler, addMissingProtocol, defaultPlatforms, defaultStrippedParams, defaultTiers, feedburnerHandler, feedsmithParser, findCanonical, normalizeUrl, resolveFeedProtocol, resolveUrl };

package/dist/exports.d.ts

@@ -0,0 +1,6 @@
+import { ExistsFn, FetchFn, FetchFnOptions, FetchFnResponse, FindCanonicalOptions, NormalizeOptions, OnExistsFn, OnFetchFn, OnMatchFn, ParserAdapter, PlatformHandler } from "./types.js";
+import { defaultPlatforms, defaultStrippedParams, defaultTiers } from "./defaults.js";
+import { findCanonical } from "./index.js";
+import { feedburnerHandler } from "./platforms/feedburner.js";
+import { addMissingProtocol, feedsmithParser, normalizeUrl, resolveFeedProtocol, resolveUrl } from "./utils.js";
+export { type ExistsFn, type FetchFn, type FetchFnOptions, type FetchFnResponse, type FindCanonicalOptions, type NormalizeOptions, type OnExistsFn, type OnFetchFn, type OnMatchFn, type ParserAdapter, type PlatformHandler, addMissingProtocol, defaultPlatforms, defaultStrippedParams, defaultTiers, feedburnerHandler, feedsmithParser, findCanonical, normalizeUrl, resolveFeedProtocol, resolveUrl };

package/dist/exports.js

@@ -0,0 +1,6 @@
+import { feedburnerHandler } from "./platforms/feedburner.js";
+import { defaultPlatforms, defaultStrippedParams, defaultTiers } from "./defaults.js";
+import { addMissingProtocol, feedsmithParser, normalizeUrl, resolveFeedProtocol, resolveUrl } from "./utils.js";
+import { findCanonical } from "./index.js";
+
+export { addMissingProtocol, defaultPlatforms, defaultStrippedParams, defaultTiers, feedburnerHandler, feedsmithParser, findCanonical, normalizeUrl, resolveFeedProtocol, resolveUrl };

package/dist/index.cjs

@@ -0,0 +1,131 @@
+const require_defaults = require('./defaults.cjs');
+const require_utils = require('./utils.cjs');
+
+//#region src/index.ts
+const findCanonical = async (inputUrl, options) => {
+	const { fetchFn = require_utils.nativeFetch, existsFn, parser = require_utils.feedsmithParser, tiers = require_defaults.defaultTiers, platforms = require_defaults.defaultPlatforms, onFetch, onMatch, onExists } = options ?? {};
+	const resolveAndApplyPlatformHandlers = (url, baseUrl) => {
+		const resolved = require_utils.resolveUrl(url, baseUrl);
+		return resolved ? require_utils.applyPlatformHandlers(resolved, platforms) : void 0;
+	};
+	const initialRequestUrl = resolveAndApplyPlatformHandlers(inputUrl);
+	if (!initialRequestUrl) return;
+	let initialResponse;
+	try {
+		initialResponse = await fetchFn(initialRequestUrl);
+	} catch {
+		return;
+	}
+	onFetch?.({
+		url: initialRequestUrl,
+		response: initialResponse
+	});
+	if (initialResponse.status < 200 || initialResponse.status >= 300) return;
+	const initialResponseUrl = resolveAndApplyPlatformHandlers(initialResponse.url);
+	if (!initialResponseUrl) return;
+	const initialResponseBody = initialResponse.body;
+	if (!initialResponseBody) return;
+	let initialResponseSignature;
+	let selfRequestUrl;
+	const initialResponseFeed = parser.parse(initialResponseBody);
+	if (!initialResponseFeed) return;
+	onMatch?.({
+		url: initialRequestUrl,
+		response: initialResponse,
+		feed: initialResponseFeed
+	});
+	const selfRequestUrlRaw = parser.getSelfUrl(initialResponseFeed);
+	if (selfRequestUrlRaw) selfRequestUrl = resolveAndApplyPlatformHandlers(selfRequestUrlRaw, initialResponseUrl);
+	const compareWithInitialResponse = (comparedResponseBody) => {
+		if (!comparedResponseBody) return false;
+		if (initialResponseBody === comparedResponseBody) return true;
+		const comparedResponseFeed = parser.parse(comparedResponseBody);
+		if (comparedResponseFeed) {
+			initialResponseSignature ||= JSON.stringify(parser.getSignature(initialResponseFeed));
+			const comparedResponseSignature = JSON.stringify(parser.getSignature(comparedResponseFeed));
+			return initialResponseSignature === comparedResponseSignature;
+		}
+		return false;
+	};
+	const fetchAndCompare = async (url) => {
+		let response;
+		try {
+			response = await fetchFn(url);
+		} catch {
+			return;
+		}
+		onFetch?.({
+			url,
+			response
+		});
+		if (response.status < 200 || response.status >= 300) return;
+		if (!compareWithInitialResponse(response.body)) return;
+		return response;
+	};
+	let variantSource = initialResponseUrl;
+	if (selfRequestUrl && selfRequestUrl !== initialResponseUrl) {
+		const urlsToTry = [selfRequestUrl];
+		if (selfRequestUrl.startsWith("https://")) urlsToTry.push(selfRequestUrl.replace("https://", "http://"));
+		else if (selfRequestUrl.startsWith("http://")) urlsToTry.push(selfRequestUrl.replace("http://", "https://"));
+		for (const urlToTry of urlsToTry) {
+			const response = await fetchAndCompare(urlToTry);
+			if (response) {
+				onMatch?.({
+					url: urlToTry,
+					response,
+					feed: initialResponseFeed
+				});
+				variantSource = resolveAndApplyPlatformHandlers(response.url) ?? initialResponseUrl;
+				break;
+			}
+		}
+	}
+	const variants = new Set(tiers.map((tier) => resolveAndApplyPlatformHandlers(require_utils.normalizeUrl(variantSource, tier))).filter((url) => url !== void 0));
+	variants.add(variantSource);
+	let winningUrl = variantSource;
+	for (const variant of variants) {
+		if (existsFn) {
+			const data = await existsFn(variant);
+			if (data !== void 0) {
+				onExists?.({
+					url: variant,
+					data
+				});
+				return variant;
+			}
+		}
+		if (variant === variantSource) continue;
+		if (variant === initialResponseUrl) {
+			winningUrl = initialResponseUrl;
+			break;
+		}
+		const response = await fetchAndCompare(variant);
+		if (response) {
+			const preparedResponseUrl = resolveAndApplyPlatformHandlers(response.url);
+			if (preparedResponseUrl === variantSource || preparedResponseUrl === initialResponseUrl) continue;
+			onMatch?.({
+				url: variant,
+				response,
+				feed: initialResponseFeed
+			});
+			winningUrl = variant;
+			break;
+		}
+	}
+	if (winningUrl.startsWith("http://")) {
+		const httpsUrl = winningUrl.replace("http://", "https://");
+		const response = await fetchAndCompare(httpsUrl);
+		if (response) {
+			onMatch?.({
+				url: httpsUrl,
+				response,
+				feed: initialResponseFeed
+			});
+			return httpsUrl;
+		}
+	}
+	return winningUrl;
+};
+
+//#endregion
+exports.findCanonical = findCanonical;

package/dist/index.d.cts

@@ -0,0 +1,6 @@
+import { FindCanonicalOptions } from "./types.cjs";
+
+//#region src/index.d.ts
+declare const findCanonical: <TFeed, TExisting>(inputUrl: string, options?: FindCanonicalOptions<TFeed, TExisting>) => Promise<string | undefined>;
+//#endregion
+export { findCanonical };

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+import { FindCanonicalOptions } from "./types.js";
+
+//#region src/index.d.ts
+declare const findCanonical: <TFeed, TExisting>(inputUrl: string, options?: FindCanonicalOptions<TFeed, TExisting>) => Promise<string | undefined>;
+//#endregion
+export { findCanonical };