feedscout 1.4.0 → 1.6.0

package/dist/common/uris/html/handlers.cjs

@@ -1,5 +1,4 @@
-const require_utils = require('../../utils.cjs');
-
+const require_utils = require("../../utils.cjs");
 //#region src/common/uris/html/handlers.ts
 const handleOpenTag = (context, name, attribs, _isImplied) => {
 	if (name === "link" && attribs.href) {
@@ -42,6 +41,5 @@ const createHtmlUrisHandlers = (context) => {
 		}
 	};
 };
-
 //#endregion
-exports.createHtmlUrisHandlers = createHtmlUrisHandlers;
+exports.createHtmlUrisHandlers = createHtmlUrisHandlers;

package/dist/common/uris/html/handlers.js

@@ -1,5 +1,4 @@
 import { endsWithAnyOf, includesAnyOf, matchesAnyOfLinkSelectors } from "../../utils.js";
-
 //#region src/common/uris/html/handlers.ts
 const handleOpenTag = (context, name, attribs, _isImplied) => {
 	if (name === "link" && attribs.href) {
@@ -42,6 +41,5 @@ const createHtmlUrisHandlers = (context) => {
 		}
 	};
 };
-
 //#endregion
-export { createHtmlUrisHandlers };
+export { createHtmlUrisHandlers };

package/dist/common/uris/html/index.cjs

@@ -1,6 +1,5 @@
-const require_handlers = require('./handlers.cjs');
+const require_handlers = require("./handlers.cjs");
 let htmlparser2 = require("htmlparser2");
-
 //#region src/common/uris/html/index.ts
 const discoverUrisFromHtml = (html, options) => {
 	const context = {
@@ -16,6 +15,5 @@ const discoverUrisFromHtml = (html, options) => {
 	parser.end();
 	return Array.from(context.discoveredUris);
 };
-
 //#endregion
-exports.discoverUrisFromHtml = discoverUrisFromHtml;
+exports.discoverUrisFromHtml = discoverUrisFromHtml;

package/dist/common/uris/html/index.js

@@ -1,6 +1,5 @@
 import { createHtmlUrisHandlers } from "./handlers.js";
 import { Parser } from "htmlparser2";
-
 //#region src/common/uris/html/index.ts
 const discoverUrisFromHtml = (html, options) => {
 	const context = {
@@ -16,6 +15,5 @@ const discoverUrisFromHtml = (html, options) => {
 	parser.end();
 	return Array.from(context.discoveredUris);
 };
-
 //#endregion
-export { discoverUrisFromHtml };
+export { discoverUrisFromHtml };

package/dist/common/uris/index.cjs

@@ -1,26 +1,32 @@
-const require_index = require('./guess/index.cjs');
-const require_index$1 = require('./headers/index.cjs');
-const require_index$2 = require('./html/index.cjs');
-const require_index$3 = require('./platform/index.cjs');
-
+const require_index = require("./feed/index.cjs");
+const require_index$1 = require("./guess/index.cjs");
+const require_index$2 = require("./headers/index.cjs");
+const require_index$3 = require("./html/index.cjs");
+const require_index$4 = require("./platform/index.cjs");
 //#region src/common/uris/index.ts
-const discoverUris = (config, stopOnFirstMethod = false) => {
-	const uris = /* @__PURE__ */ new Set();
+const discoverUris = async (config, fetchFn) => {
+	const result = {};
 	if (config.platform) {
-		for (const uri of require_index$3.discoverUrisFromPlatform(config.platform.html, config.platform.options)) uris.add(uri);
-		if (stopOnFirstMethod && uris.size > 0) return Array.from(uris);
+		const uris = await require_index$4.discoverUrisFromPlatform(config.platform.content, config.platform.headers, config.platform.options, fetchFn);
+		if (uris.length > 0) result.platform = uris;
+	}
+	if (config.feed) {
+		const uris = require_index.discoverUrisFromFeed(config.feed.content, config.feed.options);
+		if (uris.length > 0) result.feed = uris.map((uri) => ({ uri }));
 	}
 	if (config.html) {
-		for (const uri of require_index$2.discoverUrisFromHtml(config.html.html, config.html.options)) uris.add(uri);
-		if (stopOnFirstMethod && uris.size > 0) return Array.from(uris);
+		const uris = require_index$3.discoverUrisFromHtml(config.html.html, config.html.options);
+		if (uris.length > 0) result.html = uris.map((uri) => ({ uri }));
 	}
 	if (config.headers) {
-		for (const uri of require_index$1.discoverUrisFromHeaders(config.headers.headers, config.headers.options)) uris.add(uri);
-		if (stopOnFirstMethod && uris.size > 0) return Array.from(uris);
+		const uris = require_index$2.discoverUrisFromHeaders(config.headers.headers, config.headers.options);
+		if (uris.length > 0) result.headers = uris.map((uri) => ({ uri }));
+	}
+	if (config.guess) {
+		const uris = require_index$1.discoverUrisFromGuess(config.guess.options);
+		if (uris.length > 0) result.guess = uris.map((uri) => ({ uri }));
 	}
-	if (config.guess) for (const uri of require_index.discoverUrisFromGuess(config.guess.options)) uris.add(uri);
-	return Array.from(uris);
+	return result;
 };
-
 //#endregion
-exports.discoverUris = discoverUris;
+exports.discoverUris = discoverUris;

package/dist/common/uris/index.js

@@ -1,26 +1,32 @@
+import { discoverUrisFromFeed } from "./feed/index.js";
 import { discoverUrisFromGuess } from "./guess/index.js";
 import { discoverUrisFromHeaders } from "./headers/index.js";
 import { discoverUrisFromHtml } from "./html/index.js";
 import { discoverUrisFromPlatform } from "./platform/index.js";
-
 //#region src/common/uris/index.ts
-const discoverUris = (config, stopOnFirstMethod = false) => {
-	const uris = /* @__PURE__ */ new Set();
+const discoverUris = async (config, fetchFn) => {
+	const result = {};
 	if (config.platform) {
-		for (const uri of discoverUrisFromPlatform(config.platform.html, config.platform.options)) uris.add(uri);
-		if (stopOnFirstMethod && uris.size > 0) return Array.from(uris);
+		const uris = await discoverUrisFromPlatform(config.platform.content, config.platform.headers, config.platform.options, fetchFn);
+		if (uris.length > 0) result.platform = uris;
+	}
+	if (config.feed) {
+		const uris = discoverUrisFromFeed(config.feed.content, config.feed.options);
+		if (uris.length > 0) result.feed = uris.map((uri) => ({ uri }));
 	}
 	if (config.html) {
-		for (const uri of discoverUrisFromHtml(config.html.html, config.html.options)) uris.add(uri);
-		if (stopOnFirstMethod && uris.size > 0) return Array.from(uris);
+		const uris = discoverUrisFromHtml(config.html.html, config.html.options);
+		if (uris.length > 0) result.html = uris.map((uri) => ({ uri }));
 	}
 	if (config.headers) {
-		for (const uri of discoverUrisFromHeaders(config.headers.headers, config.headers.options)) uris.add(uri);
-		if (stopOnFirstMethod && uris.size > 0) return Array.from(uris);
+		const uris = discoverUrisFromHeaders(config.headers.headers, config.headers.options);
+		if (uris.length > 0) result.headers = uris.map((uri) => ({ uri }));
+	}
+	if (config.guess) {
+		const uris = discoverUrisFromGuess(config.guess.options);
+		if (uris.length > 0) result.guess = uris.map((uri) => ({ uri }));
 	}
-	if (config.guess) for (const uri of discoverUrisFromGuess(config.guess.options)) uris.add(uri);
-	return Array.from(uris);
+	return result;
 };
-
 //#endregion
-export { discoverUris };
+export { discoverUris };

package/dist/common/uris/platform/index.cjs

@@ -1,12 +1,10 @@
-
 //#region src/common/uris/platform/index.ts
-const discoverUrisFromPlatform = (html, options) => {
+const discoverUrisFromPlatform = async (content, headers, options, fetchFn) => {
 	const { baseUrl, handlers } = options;
 	for (const handler of handlers) try {
-		if (handler.match(baseUrl)) return handler.resolve(baseUrl, html);
+		if (handler.match(baseUrl, content, headers)) return await handler.resolve(baseUrl, content, headers, fetchFn);
 	} catch {}
 	return [];
 };
-
 //#endregion
-exports.discoverUrisFromPlatform = discoverUrisFromPlatform;
+exports.discoverUrisFromPlatform = discoverUrisFromPlatform;

package/dist/common/uris/platform/index.d.cts

@@ -0,0 +1,7 @@
+import { PlatformMethodOptions } from "./types.cjs";
+import { DiscoverFetchFn, DiscoverUriEntry } from "../../types.cjs";
+
+//#region src/common/uris/platform/index.d.ts
+declare const discoverUrisFromPlatform: (content: string | undefined, headers: Headers | undefined, options: PlatformMethodOptions, fetchFn?: DiscoverFetchFn) => Promise<Array<DiscoverUriEntry>>;
+//#endregion
+export { discoverUrisFromPlatform };

package/dist/common/uris/platform/index.d.ts

@@ -0,0 +1,7 @@
+import { PlatformMethodOptions } from "./types.js";
+import { DiscoverFetchFn, DiscoverUriEntry } from "../../types.js";
+
+//#region src/common/uris/platform/index.d.ts
+declare const discoverUrisFromPlatform: (content: string | undefined, headers: Headers | undefined, options: PlatformMethodOptions, fetchFn?: DiscoverFetchFn) => Promise<Array<DiscoverUriEntry>>;
+//#endregion
+export { discoverUrisFromPlatform };

package/dist/common/uris/platform/index.js

@@ -1,11 +1,10 @@
 //#region src/common/uris/platform/index.ts
-const discoverUrisFromPlatform = (html, options) => {
+const discoverUrisFromPlatform = async (content, headers, options, fetchFn) => {
 	const { baseUrl, handlers } = options;
 	for (const handler of handlers) try {
-		if (handler.match(baseUrl)) return handler.resolve(baseUrl, html);
+		if (handler.match(baseUrl, content, headers)) return await handler.resolve(baseUrl, content, headers, fetchFn);
 	} catch {}
 	return [];
 };
-
 //#endregion
-export { discoverUrisFromPlatform };
+export { discoverUrisFromPlatform };

package/dist/common/uris/platform/types.d.cts

@@ -1,7 +1,9 @@
+import { DiscoverFetchFn, DiscoverUriEntry } from "../../types.cjs";
+
 //#region src/common/uris/platform/types.d.ts
 type PlatformHandler = {
-  match: (url: string) => boolean;
-  resolve: (url: string, content?: string) => Array<string>;
+  match: (url: string, content?: string, headers?: Headers) => boolean;
+  resolve: (url: string, content?: string, headers?: Headers, fetchFn?: DiscoverFetchFn) => Array<DiscoverUriEntry> | Promise<Array<DiscoverUriEntry>>;
 };
 type PlatformMethodOptions = {
   baseUrl: string;

package/dist/common/uris/platform/types.d.ts

@@ -1,7 +1,9 @@
+import { DiscoverFetchFn, DiscoverUriEntry } from "../../types.js";
+
 //#region src/common/uris/platform/types.d.ts
 type PlatformHandler = {
-  match: (url: string) => boolean;
-  resolve: (url: string, content?: string) => Array<string>;
+  match: (url: string, content?: string, headers?: Headers) => boolean;
+  resolve: (url: string, content?: string, headers?: Headers, fetchFn?: DiscoverFetchFn) => Array<DiscoverUriEntry> | Promise<Array<DiscoverUriEntry>>;
 };
 type PlatformMethodOptions = {
   baseUrl: string;

package/dist/common/utils.cjs

@@ -1,17 +1,29 @@
-
+const require_locales = require("./locales.cjs");
 //#region src/common/utils.ts
+const composeHint = (key) => ({
+	key,
+	label: require_locales.hints[key]
+});
 const normalizeMimeType = (type) => {
 	return type.split(";")[0].trim().toLowerCase();
 };
-const isSubdomainOf = (url, domain) => {
-	return new URL(url).hostname.toLowerCase().endsWith(`.${domain}`);
+const isSubdomainOf = (url, domains) => {
+	try {
+		const hostname = new URL(url).hostname.toLowerCase();
+		return (Array.isArray(domains) ? domains : [domains]).some((domain) => hostname.endsWith(`.${domain}`));
+	} catch {}
+	return false;
 };
 const isHostOf = (url, hosts) => {
-	return isAnyOf(new URL(url).hostname, hosts);
+	try {
+		const list = Array.isArray(hosts) ? hosts : [hosts];
+		return isAnyOf(new URL(url).hostname, list);
+	} catch {}
+	return false;
 };
 const includesAnyOf = (value, patterns, parser) => {
 	const parsedValue = parser ? parser(value) : value?.toLowerCase();
-	return patterns.map((pattern) => pattern.toLowerCase()).some((pattern) => parsedValue?.includes(pattern));
+	return patterns.map((pattern) => pattern.toLowerCase()).some((pattern) => pattern && parsedValue?.includes(pattern));
 };
 const isAnyOf = (value, patterns, parser) => {
 	const parsedValue = parser ? parser(value) : value?.toLowerCase()?.trim();
@@ -22,13 +34,16 @@ const anyWordMatchesAnyOf = (value, patterns) => {
 };
 const endsWithAnyOf = (value, patterns) => {
 	const lowerValue = value.toLowerCase();
-	return patterns.some((pattern) => lowerValue.endsWith(pattern.toLowerCase()));
+	return patterns.some((pattern) => pattern && lowerValue.endsWith(pattern.toLowerCase()));
 };
 const isOfAllowedMimeType = (type, allowedTypes) => {
 	if (allowedTypes.length === 0) return true;
 	if (!type) return false;
 	return isAnyOf(type, allowedTypes, normalizeMimeType);
 };
+const omitEmpty = (array) => {
+	return array.filter((item) => item != null && item !== "");
+};
 const normalizeUrl = (url, baseUrl) => {
 	return baseUrl ? new URL(url, baseUrl).href : url;
 };
@@ -40,6 +55,7 @@ const matchesAnyOfLinkSelectors = (rel, type, selectors) => {
 	});
 };
 const processConcurrently = async (items, processFn, options) => {
+	if (options.concurrency < 1) return;
 	const active = /* @__PURE__ */ new Set();
 	let index = 0;
 	while (index < items.length || active.size > 0) {
@@ -54,9 +70,9 @@ const processConcurrently = async (items, processFn, options) => {
 		if (active.size > 0) await Promise.race(active);
 	}
 };
-
 //#endregion
 exports.anyWordMatchesAnyOf = anyWordMatchesAnyOf;
+exports.composeHint = composeHint;
 exports.endsWithAnyOf = endsWithAnyOf;
 exports.includesAnyOf = includesAnyOf;
 exports.isAnyOf = isAnyOf;
@@ -64,4 +80,5 @@ exports.isHostOf = isHostOf;
 exports.isSubdomainOf = isSubdomainOf;
 exports.matchesAnyOfLinkSelectors = matchesAnyOfLinkSelectors;
 exports.normalizeUrl = normalizeUrl;
-exports.processConcurrently = processConcurrently;
+exports.omitEmpty = omitEmpty;
+exports.processConcurrently = processConcurrently;

package/dist/common/utils.d.cts

@@ -1,6 +1,6 @@
 //#region src/common/utils.d.ts
-declare const isSubdomainOf: (url: string, domain: string) => boolean;
-declare const isHostOf: (url: string, hosts: Array<string>) => boolean;
+declare const isSubdomainOf: (url: string, domains: string | Array<string>) => boolean;
+declare const isHostOf: (url: string, hosts: string | Array<string>) => boolean;
 declare const includesAnyOf: (value: string, patterns: Array<string>, parser?: (value: string) => string) => boolean;
 declare const isAnyOf: (value: string, patterns: Array<string>, parser?: (value: string) => string) => boolean;
 declare const anyWordMatchesAnyOf: (value: string, patterns: Array<string>) => boolean;

package/dist/common/utils.d.ts

@@ -1,6 +1,6 @@
 //#region src/common/utils.d.ts
-declare const isSubdomainOf: (url: string, domain: string) => boolean;
-declare const isHostOf: (url: string, hosts: Array<string>) => boolean;
+declare const isSubdomainOf: (url: string, domains: string | Array<string>) => boolean;
+declare const isHostOf: (url: string, hosts: string | Array<string>) => boolean;
 declare const includesAnyOf: (value: string, patterns: Array<string>, parser?: (value: string) => string) => boolean;
 declare const isAnyOf: (value: string, patterns: Array<string>, parser?: (value: string) => string) => boolean;
 declare const anyWordMatchesAnyOf: (value: string, patterns: Array<string>) => boolean;

package/dist/common/utils.js

@@ -1,16 +1,29 @@
+import { hints } from "./locales.js";
 //#region src/common/utils.ts
+const composeHint = (key) => ({
+	key,
+	label: hints[key]
+});
 const normalizeMimeType = (type) => {
 	return type.split(";")[0].trim().toLowerCase();
 };
-const isSubdomainOf = (url, domain) => {
-	return new URL(url).hostname.toLowerCase().endsWith(`.${domain}`);
+const isSubdomainOf = (url, domains) => {
+	try {
+		const hostname = new URL(url).hostname.toLowerCase();
+		return (Array.isArray(domains) ? domains : [domains]).some((domain) => hostname.endsWith(`.${domain}`));
+	} catch {}
+	return false;
 };
 const isHostOf = (url, hosts) => {
-	return isAnyOf(new URL(url).hostname, hosts);
+	try {
+		const list = Array.isArray(hosts) ? hosts : [hosts];
+		return isAnyOf(new URL(url).hostname, list);
+	} catch {}
+	return false;
 };
 const includesAnyOf = (value, patterns, parser) => {
 	const parsedValue = parser ? parser(value) : value?.toLowerCase();
-	return patterns.map((pattern) => pattern.toLowerCase()).some((pattern) => parsedValue?.includes(pattern));
+	return patterns.map((pattern) => pattern.toLowerCase()).some((pattern) => pattern && parsedValue?.includes(pattern));
 };
 const isAnyOf = (value, patterns, parser) => {
 	const parsedValue = parser ? parser(value) : value?.toLowerCase()?.trim();
@@ -21,13 +34,16 @@ const anyWordMatchesAnyOf = (value, patterns) => {
 };
 const endsWithAnyOf = (value, patterns) => {
 	const lowerValue = value.toLowerCase();
-	return patterns.some((pattern) => lowerValue.endsWith(pattern.toLowerCase()));
+	return patterns.some((pattern) => pattern && lowerValue.endsWith(pattern.toLowerCase()));
 };
 const isOfAllowedMimeType = (type, allowedTypes) => {
 	if (allowedTypes.length === 0) return true;
 	if (!type) return false;
 	return isAnyOf(type, allowedTypes, normalizeMimeType);
 };
+const omitEmpty = (array) => {
+	return array.filter((item) => item != null && item !== "");
+};
 const normalizeUrl = (url, baseUrl) => {
 	return baseUrl ? new URL(url, baseUrl).href : url;
 };
@@ -39,6 +55,7 @@ const matchesAnyOfLinkSelectors = (rel, type, selectors) => {
 	});
 };
 const processConcurrently = async (items, processFn, options) => {
+	if (options.concurrency < 1) return;
 	const active = /* @__PURE__ */ new Set();
 	let index = 0;
 	while (index < items.length || active.size > 0) {
@@ -53,6 +70,5 @@ const processConcurrently = async (items, processFn, options) => {
 		if (active.size > 0) await Promise.race(active);
 	}
 };
-
 //#endregion
-export { anyWordMatchesAnyOf, endsWithAnyOf, includesAnyOf, isAnyOf, isHostOf, isSubdomainOf, matchesAnyOfLinkSelectors, normalizeUrl, processConcurrently };
+export { anyWordMatchesAnyOf, composeHint, endsWithAnyOf, includesAnyOf, isAnyOf, isHostOf, isSubdomainOf, matchesAnyOfLinkSelectors, normalizeUrl, omitEmpty, processConcurrently };

package/dist/favicons/defaults.cjs

@@ -0,0 +1,60 @@
+const require_utils = require("../common/utils.cjs");
+const require_bluesky = require("./platform/handlers/bluesky.cjs");
+const require_codeberg = require("./platform/handlers/codeberg.cjs");
+const require_deviantart = require("./platform/handlers/deviantart.cjs");
+const require_github = require("./platform/handlers/github.cjs");
+const require_githubGist = require("./platform/handlers/githubGist.cjs");
+const require_lobsters = require("./platform/handlers/lobsters.cjs");
+const require_mastodon = require("./platform/handlers/mastodon.cjs");
+const require_reddit = require("./platform/handlers/reddit.cjs");
+const require_sourceforge = require("./platform/handlers/sourceforge.cjs");
+const require_tumblr = require("./platform/handlers/tumblr.cjs");
+//#region src/favicons/defaults.ts
+const defaultIconRels = [
+	"icon",
+	"shortcut",
+	"apple-touch-icon",
+	"apple-touch-icon-precomposed"
+];
+const defaultGuessPaths = [
+	"/favicon.ico",
+	"/apple-touch-icon.png",
+	"/apple-touch-icon-precomposed.png",
+	"/favicon.png",
+	"/favicon.svg"
+];
+const linkSelectors = defaultIconRels.map((rel) => ({ rel }));
+const defaultFeedOptions = { extractUrls: ({ format, feed }) => {
+	if (format === "atom") return require_utils.omitEmpty([feed.icon]);
+	if (format === "json") return require_utils.omitEmpty([feed.favicon, feed.icon]);
+	return [];
+} };
+const defaultHtmlOptions = {
+	linkSelectors,
+	anchorUris: [],
+	anchorIgnoredUris: [],
+	anchorLabels: []
+};
+const defaultHeadersOptions = { linkSelectors };
+const defaultGuessOptions = { uris: defaultGuessPaths };
+const defaultPlatformOptions = { handlers: [
+	require_github.githubHandler,
+	require_githubGist.githubGistHandler,
+	require_mastodon.mastodonHandler,
+	require_bluesky.blueskyHandler,
+	require_reddit.redditHandler,
+	require_tumblr.tumblrHandler,
+	require_codeberg.codebergHandler,
+	require_lobsters.lobstersHandler,
+	require_sourceforge.sourceforgeHandler,
+	require_deviantart.deviantartHandler
+] };
+//#endregion
+exports.defaultFeedOptions = defaultFeedOptions;
+exports.defaultGuessOptions = defaultGuessOptions;
+exports.defaultGuessPaths = defaultGuessPaths;
+exports.defaultHeadersOptions = defaultHeadersOptions;
+exports.defaultHtmlOptions = defaultHtmlOptions;
+exports.defaultIconRels = defaultIconRels;
+exports.defaultPlatformOptions = defaultPlatformOptions;
+exports.linkSelectors = linkSelectors;

package/dist/favicons/defaults.d.cts

@@ -0,0 +1,18 @@
+import { FeedMethodOptions } from "../common/uris/feed/types.cjs";
+import { GuessMethodOptions } from "../common/uris/guess/types.cjs";
+import { HeadersMethodOptions } from "../common/uris/headers/types.cjs";
+import { HtmlMethodOptions } from "../common/uris/html/types.cjs";
+import { PlatformMethodOptions } from "../common/uris/platform/types.cjs";
+import { LinkSelector } from "../common/types.cjs";
+
+//#region src/favicons/defaults.d.ts
+declare const defaultIconRels: string[];
+declare const defaultGuessPaths: string[];
+declare const linkSelectors: Array<LinkSelector>;
+declare const defaultFeedOptions: FeedMethodOptions;
+declare const defaultHtmlOptions: Omit<HtmlMethodOptions, 'baseUrl'>;
+declare const defaultHeadersOptions: Omit<HeadersMethodOptions, 'baseUrl'>;
+declare const defaultGuessOptions: Omit<GuessMethodOptions, 'baseUrl'>;
+declare const defaultPlatformOptions: Omit<PlatformMethodOptions, 'baseUrl'>;
+//#endregion
+export { defaultFeedOptions, defaultGuessOptions, defaultGuessPaths, defaultHeadersOptions, defaultHtmlOptions, defaultIconRels, defaultPlatformOptions, linkSelectors };

package/dist/favicons/defaults.d.ts

@@ -0,0 +1,18 @@
+import { FeedMethodOptions } from "../common/uris/feed/types.js";
+import { GuessMethodOptions } from "../common/uris/guess/types.js";
+import { HeadersMethodOptions } from "../common/uris/headers/types.js";
+import { HtmlMethodOptions } from "../common/uris/html/types.js";
+import { PlatformMethodOptions } from "../common/uris/platform/types.js";
+import { LinkSelector } from "../common/types.js";
+
+//#region src/favicons/defaults.d.ts
+declare const defaultIconRels: string[];
+declare const defaultGuessPaths: string[];
+declare const linkSelectors: Array<LinkSelector>;
+declare const defaultFeedOptions: FeedMethodOptions;
+declare const defaultHtmlOptions: Omit<HtmlMethodOptions, 'baseUrl'>;
+declare const defaultHeadersOptions: Omit<HeadersMethodOptions, 'baseUrl'>;
+declare const defaultGuessOptions: Omit<GuessMethodOptions, 'baseUrl'>;
+declare const defaultPlatformOptions: Omit<PlatformMethodOptions, 'baseUrl'>;
+//#endregion
+export { defaultFeedOptions, defaultGuessOptions, defaultGuessPaths, defaultHeadersOptions, defaultHtmlOptions, defaultIconRels, defaultPlatformOptions, linkSelectors };

package/dist/favicons/defaults.js

@@ -0,0 +1,53 @@
+import { omitEmpty } from "../common/utils.js";
+import { blueskyHandler } from "./platform/handlers/bluesky.js";
+import { codebergHandler } from "./platform/handlers/codeberg.js";
+import { deviantartHandler } from "./platform/handlers/deviantart.js";
+import { githubHandler } from "./platform/handlers/github.js";
+import { githubGistHandler } from "./platform/handlers/githubGist.js";
+import { lobstersHandler } from "./platform/handlers/lobsters.js";
+import { mastodonHandler } from "./platform/handlers/mastodon.js";
+import { redditHandler } from "./platform/handlers/reddit.js";
+import { sourceforgeHandler } from "./platform/handlers/sourceforge.js";
+import { tumblrHandler } from "./platform/handlers/tumblr.js";
+//#region src/favicons/defaults.ts
+const defaultIconRels = [
+	"icon",
+	"shortcut",
+	"apple-touch-icon",
+	"apple-touch-icon-precomposed"
+];
+const defaultGuessPaths = [
+	"/favicon.ico",
+	"/apple-touch-icon.png",
+	"/apple-touch-icon-precomposed.png",
+	"/favicon.png",
+	"/favicon.svg"
+];
+const linkSelectors = defaultIconRels.map((rel) => ({ rel }));
+const defaultFeedOptions = { extractUrls: ({ format, feed }) => {
+	if (format === "atom") return omitEmpty([feed.icon]);
+	if (format === "json") return omitEmpty([feed.favicon, feed.icon]);
+	return [];
+} };
+const defaultHtmlOptions = {
+	linkSelectors,
+	anchorUris: [],
+	anchorIgnoredUris: [],
+	anchorLabels: []
+};
+const defaultHeadersOptions = { linkSelectors };
+const defaultGuessOptions = { uris: defaultGuessPaths };
+const defaultPlatformOptions = { handlers: [
+	githubHandler,
+	githubGistHandler,
+	mastodonHandler,
+	blueskyHandler,
+	redditHandler,
+	tumblrHandler,
+	codebergHandler,
+	lobstersHandler,
+	sourceforgeHandler,
+	deviantartHandler
+] };
+//#endregion
+export { defaultFeedOptions, defaultGuessOptions, defaultGuessPaths, defaultHeadersOptions, defaultHtmlOptions, defaultIconRels, defaultPlatformOptions, linkSelectors };

package/dist/favicons/extractors.cjs

@@ -0,0 +1,13 @@
+//#region src/favicons/extractors.ts
+const defaultExtractor = async ({ url, status }) => {
+	if (status !== void 0 && status >= 200 && status < 400) return {
+		url,
+		isValid: true
+	};
+	return {
+		url,
+		isValid: false
+	};
+};
+//#endregion
+exports.defaultExtractor = defaultExtractor;

package/dist/favicons/extractors.d.cts

@@ -0,0 +1,7 @@
+import { DiscoverExtractFn } from "../common/types.cjs";
+import { FaviconResult } from "./types.cjs";
+
+//#region src/favicons/extractors.d.ts
+declare const defaultExtractor: DiscoverExtractFn<FaviconResult>;
+//#endregion
+export { defaultExtractor };

package/dist/favicons/extractors.d.ts

@@ -0,0 +1,7 @@
+import { DiscoverExtractFn } from "../common/types.js";
+import { FaviconResult } from "./types.js";
+
+//#region src/favicons/extractors.d.ts
+declare const defaultExtractor: DiscoverExtractFn<FaviconResult>;
+//#endregion
+export { defaultExtractor };

package/dist/favicons/extractors.js

@@ -0,0 +1,13 @@
+//#region src/favicons/extractors.ts
+const defaultExtractor = async ({ url, status }) => {
+	if (status !== void 0 && status >= 200 && status < 400) return {
+		url,
+		isValid: true
+	};
+	return {
+		url,
+		isValid: false
+	};
+};
+//#endregion
+export { defaultExtractor };

package/dist/favicons/index.cjs

@@ -0,0 +1,29 @@
+const require_utils = require("../common/utils.cjs");
+const require_utils$1 = require("../common/discover/utils.cjs");
+const require_index = require("../common/discover/index.cjs");
+const require_defaults = require("./defaults.cjs");
+const require_extractors = require("./extractors.cjs");
+//#region src/favicons/index.ts
+const discoverFavicons = async (input, options = {}) => {
+	return require_index.discover(input, {
+		...options,
+		methods: options.methods ?? [
+			"platform",
+			"feed",
+			"html",
+			"headers",
+			"guess"
+		],
+		fetchFn: options.fetchFn ?? require_utils$1.defaultFetchFn,
+		extractFn: options.extractFn ?? require_extractors.defaultExtractor,
+		normalizeUrlFn: options.normalizeUrlFn ?? require_utils.normalizeUrl
+	}, {
+		platform: require_defaults.defaultPlatformOptions,
+		feed: require_defaults.defaultFeedOptions,
+		html: require_defaults.defaultHtmlOptions,
+		headers: require_defaults.defaultHeadersOptions,
+		guess: require_defaults.defaultGuessOptions
+	});
+};
+//#endregion
+exports.discoverFavicons = discoverFavicons;

package/dist/favicons/index.d.cts

@@ -0,0 +1,7 @@
+import { DiscoverInput, DiscoverOptions, DiscoverResult } from "../common/types.cjs";
+import { FaviconResult } from "./types.cjs";
+
+//#region src/favicons/index.d.ts
+declare const discoverFavicons: <TValid extends FaviconResult = FaviconResult>(input: DiscoverInput, options?: DiscoverOptions<TValid>) => Promise<Array<DiscoverResult<TValid>>>;
+//#endregion
+export { discoverFavicons };