feedscout 1.0.0 → 1.2.0

package/README.md

@@ -24,6 +24,7 @@ Finds feeds by scanning links and anchors in HTML content, parsing HTTP headers,
 
 ### Discovery Methods
 
+- **Platform** — Generates feed URLs for YouTube, GitHub, WordPress, and other popular platforms using URL pattern matching.
 - **HTML** — Scans `<link>` elements with feed MIME types and `<a>` elements matching feed patterns or labels like "RSS", "Subscribe".
 - **Headers** — Parses HTTP `Link` headers for `rel="alternate"` with feed MIME types per RFC 8288.
 - **Guess** — Tests common paths (e.g. `/feed`, `/rss.xml`, `/atom.xml`) against the base URL as a fallback.
@@ -32,7 +33,7 @@ Finds feeds by scanning links and anchors in HTML content, parsing HTTP headers,
 
 - **Custom extractors** — Override the default parser to extract additional metadata from feeds and blogrolls.
 - **Configurable methods** — Enable/disable discovery methods or customize their options.
-- **Adapter system** — Use native fetch or integrate with Axios, Got, or Ky.
+- **Adapter system** — Use native fetch or easily integrate with Axios, Got, or Ky.
 - **Concurrency control** — Limit parallel requests during validation.
 - **Progress tracking** — Monitor discovery progress with callbacks.
 - **Type-safe** — Full TypeScript support with exported types.
@@ -55,9 +56,7 @@ npm install feedscout
 ```typescript
 import { discoverFeeds } from 'feedscout'
 
-const feeds = await discoverFeeds('https://example.com', {
-  methods: ['html', 'headers'],
-})
+const feeds = await discoverFeeds('https://example.com')
 
 // [{
 //   url: 'https://example.com/feed.xml',
@@ -69,6 +68,12 @@ const feeds = await discoverFeeds('https://example.com', {
 // }]
 ```
 
+```typescript
+const feeds = await discoverFeeds('https://example.com', {
+  methods: ['html', 'headers'],
+})
+```
+
 Or with existing HTML content:
 
 ```html
@@ -135,9 +140,7 @@ const feeds = await discoverFeeds(
 ```typescript
 import { discoverBlogrolls } from 'feedscout'
 
-const blogrolls = await discoverBlogrolls('https://example.com', {
-  methods: ['html'],
-})
+const blogrolls = await discoverBlogrolls('https://example.com')
 
 // [{
 //   url: 'https://example.com/blogroll.opml',

package/dist/blogrolls/index.cjs

@@ -1,17 +1,23 @@
-const require_adapters = require('../common/discover/adapters.cjs');
 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/blogrolls/index.ts
-const discoverBlogrolls = async (input, options) => {
+const discoverBlogrolls = async (input, options = {}) => {
 	return require_index.discover(input, {
 		...options,
-		fetchFn: options.fetchFn ?? require_adapters.createNativeFetchAdapter(),
+		methods: options.methods ?? [
+			"html",
+			"headers",
+			"guess"
+		],
+		fetchFn: options.fetchFn ?? require_utils$1.defaultFetchFn,
 		extractFn: options.extractFn ?? require_extractors.defaultExtractor,
 		normalizeUrlFn: options.normalizeUrlFn ?? require_utils.normalizeUrl
 	}, {
+		platform: { handlers: [] },
 		html: require_defaults.defaultHtmlOptions,
 		headers: require_defaults.defaultHeadersOptions,
 		guess: require_defaults.defaultGuessOptions

package/dist/blogrolls/index.d.cts

@@ -2,6 +2,6 @@ import { DiscoverInput, DiscoverOptions, DiscoverResult } from "../common/types.
 import { BlogrollResult } from "./types.cjs";
 
 //#region src/blogrolls/index.d.ts
-declare const discoverBlogrolls: <TValid extends BlogrollResult = BlogrollResult>(input: DiscoverInput, options: DiscoverOptions<TValid>) => Promise<Array<DiscoverResult<TValid>>>;
+declare const discoverBlogrolls: <TValid extends BlogrollResult = BlogrollResult>(input: DiscoverInput, options?: DiscoverOptions<TValid>) => Promise<Array<DiscoverResult<TValid>>>;
 //#endregion
 export { discoverBlogrolls };

package/dist/blogrolls/index.d.ts

@@ -2,6 +2,6 @@ import { DiscoverInput, DiscoverOptions, DiscoverResult } from "../common/types.
 import { BlogrollResult } from "./types.js";
 
 //#region src/blogrolls/index.d.ts
-declare const discoverBlogrolls: <TValid extends BlogrollResult = BlogrollResult>(input: DiscoverInput, options: DiscoverOptions<TValid>) => Promise<Array<DiscoverResult<TValid>>>;
+declare const discoverBlogrolls: <TValid extends BlogrollResult = BlogrollResult>(input: DiscoverInput, options?: DiscoverOptions<TValid>) => Promise<Array<DiscoverResult<TValid>>>;
 //#endregion
 export { discoverBlogrolls };

package/dist/blogrolls/index.js

@@ -1,17 +1,23 @@
-import { createNativeFetchAdapter } from "../common/discover/adapters.js";
 import { normalizeUrl } from "../common/utils.js";
+import { defaultFetchFn } from "../common/discover/utils.js";
 import { discover } from "../common/discover/index.js";
 import { defaultGuessOptions, defaultHeadersOptions, defaultHtmlOptions } from "./defaults.js";
 import { defaultExtractor } from "./extractors.js";
 
 //#region src/blogrolls/index.ts
-const discoverBlogrolls = async (input, options) => {
+const discoverBlogrolls = async (input, options = {}) => {
 	return discover(input, {
 		...options,
-		fetchFn: options.fetchFn ?? createNativeFetchAdapter(),
+		methods: options.methods ?? [
+			"html",
+			"headers",
+			"guess"
+		],
+		fetchFn: options.fetchFn ?? defaultFetchFn,
 		extractFn: options.extractFn ?? defaultExtractor,
 		normalizeUrlFn: options.normalizeUrlFn ?? normalizeUrl
 	}, {
+		platform: { handlers: [] },
 		html: defaultHtmlOptions,
 		headers: defaultHeadersOptions,
 		guess: defaultGuessOptions

package/dist/common/discover/utils.cjs

@@ -1,6 +1,19 @@
 const require_locales = require('../locales.cjs');
 
 //#region src/common/discover/utils.ts
+const defaultFetchFn = async (url, options) => {
+	const response = await fetch(url, {
+		method: options?.method ?? "GET",
+		headers: options?.headers
+	});
+	return {
+		headers: response.headers,
+		body: await response.text(),
+		url: response.url,
+		status: response.status,
+		statusText: response.statusText
+	};
+};
 const normalizeInput = async (input, fetchFn) => {
 	if (typeof input === "object") return input;
 	const response = await fetchFn(input);
@@ -13,6 +26,18 @@ const normalizeInput = async (input, fetchFn) => {
 const normalizeMethodsConfig = (input, methods, defaults) => {
 	const methodsObj = Array.isArray(methods) ? Object.fromEntries(methods.map((method) => [method, true])) : methods;
 	const methodsConfig = {};
+	if (methodsObj.platform) {
+		if (!input.url || input.url === "") throw new Error(require_locales.errors.platformMethodRequiresUrl);
+		const platformOptions = methodsObj.platform === true ? {} : methodsObj.platform;
+		methodsConfig.platform = {
+			html: input.content ?? "",
+			options: {
+				...defaults.platform,
+				...platformOptions,
+				baseUrl: input.url
+			}
+		};
+	}
 	if (methodsObj.html) {
 		if (input.content === void 0) throw new Error(require_locales.errors.htmlMethodRequiresContent);
 		const htmlOptions = methodsObj.html === true ? {} : methodsObj.html;
@@ -50,5 +75,6 @@ const normalizeMethodsConfig = (input, methods, defaults) => {
 };
 
 //#endregion
+exports.defaultFetchFn = defaultFetchFn;
 exports.normalizeInput = normalizeInput;
 exports.normalizeMethodsConfig = normalizeMethodsConfig;

package/dist/common/discover/utils.js

@@ -1,6 +1,19 @@
 import { errors } from "../locales.js";
 
 //#region src/common/discover/utils.ts
+const defaultFetchFn = async (url, options) => {
+	const response = await fetch(url, {
+		method: options?.method ?? "GET",
+		headers: options?.headers
+	});
+	return {
+		headers: response.headers,
+		body: await response.text(),
+		url: response.url,
+		status: response.status,
+		statusText: response.statusText
+	};
+};
 const normalizeInput = async (input, fetchFn) => {
 	if (typeof input === "object") return input;
 	const response = await fetchFn(input);
@@ -13,6 +26,18 @@ const normalizeInput = async (input, fetchFn) => {
 const normalizeMethodsConfig = (input, methods, defaults) => {
 	const methodsObj = Array.isArray(methods) ? Object.fromEntries(methods.map((method) => [method, true])) : methods;
 	const methodsConfig = {};
+	if (methodsObj.platform) {
+		if (!input.url || input.url === "") throw new Error(errors.platformMethodRequiresUrl);
+		const platformOptions = methodsObj.platform === true ? {} : methodsObj.platform;
+		methodsConfig.platform = {
+			html: input.content ?? "",
+			options: {
+				...defaults.platform,
+				...platformOptions,
+				baseUrl: input.url
+			}
+		};
+	}
 	if (methodsObj.html) {
 		if (input.content === void 0) throw new Error(errors.htmlMethodRequiresContent);
 		const htmlOptions = methodsObj.html === true ? {} : methodsObj.html;
@@ -50,4 +75,4 @@ const normalizeMethodsConfig = (input, methods, defaults) => {
 };
 
 //#endregion
-export { normalizeInput, normalizeMethodsConfig };
+export { defaultFetchFn, normalizeInput, normalizeMethodsConfig };

package/dist/common/locales.cjs

@@ -1,6 +1,7 @@
 
 //#region src/common/locales.json
 var errors = {
+	"platformMethodRequiresUrl": "Platform method requires url to be provided in input",
 	"htmlMethodRequiresContent": "HTML method requires content to be provided in input",
 	"headersMethodRequiresHeaders": "Headers method requires headers to be provided in input",
 	"guessMethodRequiresUrl": "Guess method requires url to be provided in input"

package/dist/common/locales.js

@@ -1,5 +1,6 @@
 //#region src/common/locales.json
 var errors = {
+	"platformMethodRequiresUrl": "Platform method requires url to be provided in input",
 	"htmlMethodRequiresContent": "HTML method requires content to be provided in input",
 	"headersMethodRequiresHeaders": "Headers method requires headers to be provided in input",
 	"guessMethodRequiresUrl": "Guess method requires url to be provided in input"

package/dist/common/types.d.cts

@@ -1,6 +1,7 @@
 import { GuessMethodOptions } from "./uris/guess/types.cjs";
 import { HeadersMethodOptions } from "./uris/headers/types.cjs";
 import { HtmlMethodOptions } from "./uris/html/types.cjs";
+import { PlatformMethodOptions } from "./uris/platform/types.cjs";
 
 //#region src/common/types.d.ts
 type LinkSelector = {
@@ -26,7 +27,7 @@ type DiscoverProgress = {
   found: number;
   current: string;
 };
-type DiscoverProgressFn = (progress: DiscoverProgress) => void;
+type DiscoverOnProgressFn = (progress: DiscoverProgress) => void;
 type DiscoverResult<TValid = object> = ({
   url: string;
   isValid: true;
@@ -46,20 +47,21 @@ type DiscoverInputObject = {
   headers?: Headers;
 };
 type DiscoverInput = string | DiscoverInputObject;
-type DiscoverMethodsConfig = Array<'html' | 'headers' | 'guess'> | {
+type DiscoverMethodsConfig = Array<'platform' | 'html' | 'headers' | 'guess'> | {
+  platform?: true | Partial<PlatformMethodOptions>;
   html?: true | Partial<Omit<HtmlMethodOptions, 'baseUrl'>>;
   headers?: true | Partial<Omit<HeadersMethodOptions, 'baseUrl'>>;
   guess?: true | Partial<Omit<GuessMethodOptions, 'baseUrl'>>;
 };
 type DiscoverOptions<TValid> = {
-  methods: DiscoverMethodsConfig;
+  methods?: DiscoverMethodsConfig;
   fetchFn?: DiscoverFetchFn;
   extractFn?: DiscoverExtractFn<TValid>;
   normalizeUrlFn?: DiscoverNormalizeUrlFn;
   concurrency?: number;
   stopOnFirstResult?: boolean;
   includeInvalid?: boolean;
-  onProgress?: DiscoverProgressFn;
+  onProgress?: DiscoverOnProgressFn;
 };
 //#endregion
-export { DiscoverExtractFn, DiscoverFetchFn, DiscoverFetchFnOptions, DiscoverFetchFnResponse, DiscoverInput, DiscoverInputObject, DiscoverMethodsConfig, DiscoverNormalizeUrlFn, DiscoverOptions, DiscoverProgress, DiscoverProgressFn, DiscoverResult, LinkSelector };
+export { DiscoverExtractFn, DiscoverFetchFn, DiscoverFetchFnOptions, DiscoverFetchFnResponse, DiscoverInput, DiscoverInputObject, DiscoverMethodsConfig, DiscoverNormalizeUrlFn, DiscoverOnProgressFn, DiscoverOptions, DiscoverProgress, DiscoverResult, LinkSelector };

package/dist/common/types.d.ts

@@ -1,6 +1,7 @@
 import { GuessMethodOptions } from "./uris/guess/types.js";
 import { HeadersMethodOptions } from "./uris/headers/types.js";
 import { HtmlMethodOptions } from "./uris/html/types.js";
+import { PlatformMethodOptions } from "./uris/platform/types.js";
 
 //#region src/common/types.d.ts
 type LinkSelector = {
@@ -26,7 +27,7 @@ type DiscoverProgress = {
   found: number;
   current: string;
 };
-type DiscoverProgressFn = (progress: DiscoverProgress) => void;
+type DiscoverOnProgressFn = (progress: DiscoverProgress) => void;
 type DiscoverResult<TValid = object> = ({
   url: string;
   isValid: true;
@@ -46,20 +47,21 @@ type DiscoverInputObject = {
   headers?: Headers;
 };
 type DiscoverInput = string | DiscoverInputObject;
-type DiscoverMethodsConfig = Array<'html' | 'headers' | 'guess'> | {
+type DiscoverMethodsConfig = Array<'platform' | 'html' | 'headers' | 'guess'> | {
+  platform?: true | Partial<PlatformMethodOptions>;
   html?: true | Partial<Omit<HtmlMethodOptions, 'baseUrl'>>;
   headers?: true | Partial<Omit<HeadersMethodOptions, 'baseUrl'>>;
   guess?: true | Partial<Omit<GuessMethodOptions, 'baseUrl'>>;
 };
 type DiscoverOptions<TValid> = {
-  methods: DiscoverMethodsConfig;
+  methods?: DiscoverMethodsConfig;
   fetchFn?: DiscoverFetchFn;
   extractFn?: DiscoverExtractFn<TValid>;
   normalizeUrlFn?: DiscoverNormalizeUrlFn;
   concurrency?: number;
   stopOnFirstResult?: boolean;
   includeInvalid?: boolean;
-  onProgress?: DiscoverProgressFn;
+  onProgress?: DiscoverOnProgressFn;
 };
 //#endregion
-export { DiscoverExtractFn, DiscoverFetchFn, DiscoverFetchFnOptions, DiscoverFetchFnResponse, DiscoverInput, DiscoverInputObject, DiscoverMethodsConfig, DiscoverNormalizeUrlFn, DiscoverOptions, DiscoverProgress, DiscoverProgressFn, DiscoverResult, LinkSelector };
+export { DiscoverExtractFn, DiscoverFetchFn, DiscoverFetchFnOptions, DiscoverFetchFnResponse, DiscoverInput, DiscoverInputObject, DiscoverMethodsConfig, DiscoverNormalizeUrlFn, DiscoverOnProgressFn, DiscoverOptions, DiscoverProgress, DiscoverResult, LinkSelector };

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

@@ -1,15 +1,18 @@
 const require_utils = require('../../utils.cjs');
 
 //#region src/common/uris/headers/index.ts
+const urlRegex = /<([^<>]+)>/;
+const relRegex = /rel\s*=\s*["']?([^"';,]+)["']?/i;
+const typeRegex = /type\s*=\s*["']?([^"';,]+)["']?/i;
 const discoverUrisFromHeaders = (headers, options) => {
 	const uris = /* @__PURE__ */ new Set();
 	const linkHeader = headers.get("link");
 	if (!linkHeader) return [];
 	const links = linkHeader.split(/,(?=\s*<)/);
 	for (const link of links) {
-		const urlMatch = link.match(/<([^<>]+)>/);
-		const relMatch = link.match(/rel\s*=\s*["']?([^"';,]+)["']?/i);
-		const typeMatch = link.match(/type\s*=\s*["']?([^"';,]+)["']?/i);
+		const urlMatch = link.match(urlRegex);
+		const relMatch = link.match(relRegex);
+		const typeMatch = link.match(typeRegex);
 		if (!urlMatch) continue;
 		const url = urlMatch[1];
 		const rel = relMatch?.[1]?.toLowerCase();

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

@@ -1,15 +1,18 @@
 import { matchesAnyOfLinkSelectors } from "../../utils.js";
 
 //#region src/common/uris/headers/index.ts
+const urlRegex = /<([^<>]+)>/;
+const relRegex = /rel\s*=\s*["']?([^"';,]+)["']?/i;
+const typeRegex = /type\s*=\s*["']?([^"';,]+)["']?/i;
 const discoverUrisFromHeaders = (headers, options) => {
 	const uris = /* @__PURE__ */ new Set();
 	const linkHeader = headers.get("link");
 	if (!linkHeader) return [];
 	const links = linkHeader.split(/,(?=\s*<)/);
 	for (const link of links) {
-		const urlMatch = link.match(/<([^<>]+)>/);
-		const relMatch = link.match(/rel\s*=\s*["']?([^"';,]+)["']?/i);
-		const typeMatch = link.match(/type\s*=\s*["']?([^"';,]+)["']?/i);
+		const urlMatch = link.match(urlRegex);
+		const relMatch = link.match(relRegex);
+		const typeMatch = link.match(typeRegex);
 		if (!urlMatch) continue;
 		const url = urlMatch[1];
 		const rel = relMatch?.[1]?.toLowerCase();

package/dist/common/uris/index.cjs

@@ -1,10 +1,12 @@
 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');
 
 //#region src/common/uris/index.ts
 const discoverUris = (config) => {
 	const uris = /* @__PURE__ */ new Set();
+	if (config.platform) for (const uri of require_index$3.discoverUrisFromPlatform(config.platform.html, config.platform.options)) uris.add(uri);
 	if (config.html) for (const uri of require_index$2.discoverUrisFromHtml(config.html.html, config.html.options)) uris.add(uri);
 	if (config.headers) for (const uri of require_index$1.discoverUrisFromHeaders(config.headers.headers, config.headers.options)) uris.add(uri);
 	if (config.guess) for (const uri of require_index.discoverUrisFromGuess(config.guess.options)) uris.add(uri);

package/dist/common/uris/index.js

@@ -1,10 +1,12 @@
 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) => {
 	const uris = /* @__PURE__ */ new Set();
+	if (config.platform) for (const uri of discoverUrisFromPlatform(config.platform.html, config.platform.options)) uris.add(uri);
 	if (config.html) for (const uri of discoverUrisFromHtml(config.html.html, config.html.options)) uris.add(uri);
 	if (config.headers) for (const uri of discoverUrisFromHeaders(config.headers.headers, config.headers.options)) uris.add(uri);
 	if (config.guess) for (const uri of discoverUrisFromGuess(config.guess.options)) uris.add(uri);

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

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

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

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

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

@@ -0,0 +1,11 @@
+//#region src/common/uris/platform/types.d.ts
+type PlatformHandler = {
+  match: (url: string) => boolean;
+  resolve: (url: string, content?: string) => Array<string>;
+};
+type PlatformMethodOptions = {
+  baseUrl: string;
+  handlers: Array<PlatformHandler>;
+};
+//#endregion
+export { PlatformMethodOptions };

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

@@ -0,0 +1,11 @@
+//#region src/common/uris/platform/types.d.ts
+type PlatformHandler = {
+  match: (url: string) => boolean;
+  resolve: (url: string, content?: string) => Array<string>;
+};
+type PlatformMethodOptions = {
+  baseUrl: string;
+  handlers: Array<PlatformHandler>;
+};
+//#endregion
+export { PlatformMethodOptions };

package/dist/common/utils.cjs

@@ -3,6 +3,12 @@
 const normalizeMimeType = (type) => {
 	return type.split(";")[0].trim().toLowerCase();
 };
+const isSubdomainOf = (url, domain) => {
+	return new URL(url).hostname.toLowerCase().endsWith(`.${domain}`);
+};
+const isHostOf = (url, hosts) => {
+	return isAnyOf(new URL(url).hostname, hosts);
+};
 const includesAnyOf = (value, patterns, parser) => {
 	const parsedValue = parser ? parser(value) : value?.toLowerCase();
 	return patterns.map((pattern) => pattern.toLowerCase()).some((pattern) => parsedValue?.includes(pattern));
@@ -50,8 +56,12 @@ const processConcurrently = async (items, processFn, options) => {
 };
 
 //#endregion
+exports.anyWordMatchesAnyOf = anyWordMatchesAnyOf;
 exports.endsWithAnyOf = endsWithAnyOf;
 exports.includesAnyOf = includesAnyOf;
+exports.isAnyOf = isAnyOf;
+exports.isHostOf = isHostOf;
+exports.isSubdomainOf = isSubdomainOf;
 exports.matchesAnyOfLinkSelectors = matchesAnyOfLinkSelectors;
 exports.normalizeUrl = normalizeUrl;
 exports.processConcurrently = processConcurrently;

package/dist/common/utils.d.cts

@@ -0,0 +1,9 @@
+//#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 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;
+declare const endsWithAnyOf: (value: string, patterns: Array<string>) => boolean;
+//#endregion
+export { anyWordMatchesAnyOf, endsWithAnyOf, includesAnyOf, isAnyOf, isHostOf, isSubdomainOf };

package/dist/common/utils.d.ts

@@ -0,0 +1,9 @@
+//#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 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;
+declare const endsWithAnyOf: (value: string, patterns: Array<string>) => boolean;
+//#endregion
+export { anyWordMatchesAnyOf, endsWithAnyOf, includesAnyOf, isAnyOf, isHostOf, isSubdomainOf };

package/dist/common/utils.js

@@ -2,6 +2,12 @@
 const normalizeMimeType = (type) => {
 	return type.split(";")[0].trim().toLowerCase();
 };
+const isSubdomainOf = (url, domain) => {
+	return new URL(url).hostname.toLowerCase().endsWith(`.${domain}`);
+};
+const isHostOf = (url, hosts) => {
+	return isAnyOf(new URL(url).hostname, hosts);
+};
 const includesAnyOf = (value, patterns, parser) => {
 	const parsedValue = parser ? parser(value) : value?.toLowerCase();
 	return patterns.map((pattern) => pattern.toLowerCase()).some((pattern) => parsedValue?.includes(pattern));
@@ -49,4 +55,4 @@ const processConcurrently = async (items, processFn, options) => {
 };
 
 //#endregion
-export { endsWithAnyOf, includesAnyOf, matchesAnyOfLinkSelectors, normalizeUrl, processConcurrently };
+export { anyWordMatchesAnyOf, endsWithAnyOf, includesAnyOf, isAnyOf, isHostOf, isSubdomainOf, matchesAnyOfLinkSelectors, normalizeUrl, processConcurrently };

package/dist/feeds/defaults.cjs

@@ -1,3 +1,23 @@
+const require_behance = require('./platform/handlers/behance.cjs');
+const require_blogspot = require('./platform/handlers/blogspot.cjs');
+const require_bluesky = require('./platform/handlers/bluesky.cjs');
+const require_dailymotion = require('./platform/handlers/dailymotion.cjs');
+const require_deviantart = require('./platform/handlers/deviantart.cjs');
+const require_devto = require('./platform/handlers/devto.cjs');
+const require_github = require('./platform/handlers/github.cjs');
+const require_githubGist = require('./platform/handlers/githubGist.cjs');
+const require_gitlab = require('./platform/handlers/gitlab.cjs');
+const require_kickstarter = require('./platform/handlers/kickstarter.cjs');
+const require_lobsters = require('./platform/handlers/lobsters.cjs');
+const require_medium = require('./platform/handlers/medium.cjs');
+const require_pinterest = require('./platform/handlers/pinterest.cjs');
+const require_producthunt = require('./platform/handlers/producthunt.cjs');
+const require_reddit = require('./platform/handlers/reddit.cjs');
+const require_soundcloud = require('./platform/handlers/soundcloud.cjs');
+const require_substack = require('./platform/handlers/substack.cjs');
+const require_tumblr = require('./platform/handlers/tumblr.cjs');
+const require_wordpress = require('./platform/handlers/wordpress.cjs');
+const require_youtube = require('./platform/handlers/youtube.cjs');
 
 //#region src/feeds/defaults.ts
 const mimeTypes = [
@@ -75,12 +95,35 @@ const defaultHtmlOptions = {
 };
 const defaultHeadersOptions = { linkSelectors };
 const defaultGuessOptions = { uris: urisBalanced };
+const defaultPlatformOptions = { handlers: [
+	require_behance.behanceHandler,
+	require_blogspot.blogspotHandler,
+	require_bluesky.blueskyHandler,
+	require_deviantart.deviantartHandler,
+	require_dailymotion.dailymotionHandler,
+	require_devto.devtoHandler,
+	require_github.githubHandler,
+	require_githubGist.githubGistHandler,
+	require_gitlab.gitlabHandler,
+	require_kickstarter.kickstarterHandler,
+	require_medium.mediumHandler,
+	require_pinterest.pinterestHandler,
+	require_producthunt.producthuntHandler,
+	require_lobsters.lobstersHandler,
+	require_reddit.redditHandler,
+	require_soundcloud.soundcloudHandler,
+	require_substack.substackHandler,
+	require_tumblr.tumblrHandler,
+	require_wordpress.wordpressHandler,
+	require_youtube.youtubeHandler
+] };
 
 //#endregion
 exports.anchorLabels = anchorLabels;
 exports.defaultGuessOptions = defaultGuessOptions;
 exports.defaultHeadersOptions = defaultHeadersOptions;
 exports.defaultHtmlOptions = defaultHtmlOptions;
+exports.defaultPlatformOptions = defaultPlatformOptions;
 exports.ignoredUris = ignoredUris;
 exports.linkSelectors = linkSelectors;
 exports.mimeTypes = mimeTypes;

package/dist/feeds/defaults.d.cts

@@ -1,6 +1,7 @@
 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/feeds/defaults.d.ts
@@ -14,5 +15,6 @@ declare const linkSelectors: Array<LinkSelector>;
 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 { anchorLabels, defaultGuessOptions, defaultHeadersOptions, defaultHtmlOptions, ignoredUris, linkSelectors, mimeTypes, urisBalanced, urisComprehensive, urisMinimal };
+export { anchorLabels, defaultGuessOptions, defaultHeadersOptions, defaultHtmlOptions, defaultPlatformOptions, ignoredUris, linkSelectors, mimeTypes, urisBalanced, urisComprehensive, urisMinimal };

package/dist/feeds/defaults.d.ts

@@ -1,6 +1,7 @@
 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/feeds/defaults.d.ts
@@ -14,5 +15,6 @@ declare const linkSelectors: Array<LinkSelector>;
 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 { anchorLabels, defaultGuessOptions, defaultHeadersOptions, defaultHtmlOptions, ignoredUris, linkSelectors, mimeTypes, urisBalanced, urisComprehensive, urisMinimal };
+export { anchorLabels, defaultGuessOptions, defaultHeadersOptions, defaultHtmlOptions, defaultPlatformOptions, ignoredUris, linkSelectors, mimeTypes, urisBalanced, urisComprehensive, urisMinimal };