@opensite/hooks 2.0.0 → 2.0.3

package/dist/core/useOpenGraphExtractor.cjs

@@ -0,0 +1,59 @@
+import { useCallback, useMemo } from "react";
+import { useWebsiteExtractorBase } from "./useWebsiteExtractorBase.js";
+const DEFAULT_SKIP_PATTERNS = [
+    /search\.google\.com\/local\/reviews/i,
+    /google\.com\/maps\/place/i,
+    /maps\.google\.com/i,
+    /opentable\.com/i,
+];
+const pickFirstString = (...values) => {
+    for (const value of values) {
+        if (typeof value === "string" && value.trim().length > 0) {
+            return value;
+        }
+    }
+    return undefined;
+};
+const safeHost = (value) => {
+    if (!value) {
+        return undefined;
+    }
+    try {
+        return new URL(value).hostname;
+    }
+    catch {
+        return undefined;
+    }
+};
+export function useOpenGraphExtractor(options) {
+    const skipPatterns = useMemo(() => options.skipPatterns ?? DEFAULT_SKIP_PATTERNS, [options.skipPatterns]);
+    const shouldSkip = useCallback((url) => skipPatterns.some((pattern) => pattern.test(url)), [skipPatterns]);
+    const selectData = useCallback((payload, _raw, meta) => {
+        const { openGraph, htmlInferred, hybridGraph } = payload;
+        const description = pickFirstString(openGraph?.description, hybridGraph?.description, htmlInferred?.description);
+        const title = pickFirstString(openGraph?.title, hybridGraph?.title, htmlInferred?.title);
+        const siteName = pickFirstString(openGraph?.site_name, hybridGraph?.site_name, htmlInferred?.site_name);
+        const favicon = pickFirstString(hybridGraph?.favicon, htmlInferred?.favicon);
+        const image = pickFirstString(openGraph?.image?.url ?? undefined, hybridGraph?.image ?? undefined, htmlInferred?.image ?? undefined, htmlInferred?.images?.[0]);
+        const video = pickFirstString(openGraph?.video?.url ?? undefined, hybridGraph?.video ?? undefined);
+        const videoType = pickFirstString(hybridGraph?.videoType, htmlInferred?.videoType);
+        const resolvedUrl = pickFirstString(meta.url, openGraph?.url ?? undefined, hybridGraph?.url ?? undefined, htmlInferred?.url ?? undefined, meta.finalUrl, meta.normalizedUrl, meta.requestedUrl) ?? "";
+        return {
+            description,
+            favicon,
+            image,
+            video,
+            videoType,
+            siteName,
+            title,
+            url: resolvedUrl,
+            siteHost: safeHost(resolvedUrl),
+        };
+    }, []);
+    return useWebsiteExtractorBase({
+        endpoint: "open-graph",
+        options,
+        selectData,
+        shouldSkip,
+    });
+}

package/dist/core/useOpenGraphExtractor.d.ts

@@ -0,0 +1,64 @@
+import type { WebsiteExtractorOptions, WebsiteExtractorResponse, WebsiteExtractorResult } from "./websiteExtractorTypes.js";
+export interface OpenGraphImage {
+    url?: string | null;
+    height?: string | null;
+    width?: string | null;
+}
+export interface OpenGraphVideo {
+    url?: string | null;
+    height?: string | null;
+    width?: string | null;
+}
+export interface OpenGraphData {
+    description?: string | null;
+    title?: string | null;
+    site_name?: string | null;
+    image?: OpenGraphImage | null;
+    video?: OpenGraphVideo | null;
+    url?: string | null;
+    ogType?: string | null;
+}
+export interface OpenGraphHtmlInferredData {
+    description?: string | null;
+    title?: string | null;
+    type?: string | null;
+    videoType?: string | null;
+    url?: string | null;
+    favicon?: string | null;
+    images?: string[] | null;
+    image?: string | null;
+    site_name?: string | null;
+}
+export interface OpenGraphHybridData {
+    description?: string | null;
+    title?: string | null;
+    type?: string | null;
+    image?: string | null;
+    video?: string | null;
+    videoType?: string | null;
+    favicon?: string | null;
+    site_name?: string | null;
+    url?: string | null;
+    videoWidth?: number | null;
+    videoHeight?: number | null;
+}
+export type OpenGraphResponse = WebsiteExtractorResponse<{
+    openGraph: OpenGraphData;
+    htmlInferred: OpenGraphHtmlInferredData;
+    hybridGraph: OpenGraphHybridData;
+}>;
+export interface OpenGraphSummary {
+    description?: string;
+    favicon?: string;
+    image?: string;
+    video?: string;
+    videoType?: string;
+    siteName?: string;
+    title?: string;
+    url: string;
+    siteHost?: string;
+}
+export interface OpenGraphExtractorOptions extends WebsiteExtractorOptions {
+    skipPatterns?: RegExp[];
+}
+export declare function useOpenGraphExtractor(options: OpenGraphExtractorOptions): WebsiteExtractorResult<OpenGraphSummary, OpenGraphResponse>;

package/dist/core/useOpenGraphExtractor.js

@@ -0,0 +1,59 @@
+import { useCallback, useMemo } from "react";
+import { useWebsiteExtractorBase } from "./useWebsiteExtractorBase.js";
+const DEFAULT_SKIP_PATTERNS = [
+    /search\.google\.com\/local\/reviews/i,
+    /google\.com\/maps\/place/i,
+    /maps\.google\.com/i,
+    /opentable\.com/i,
+];
+const pickFirstString = (...values) => {
+    for (const value of values) {
+        if (typeof value === "string" && value.trim().length > 0) {
+            return value;
+        }
+    }
+    return undefined;
+};
+const safeHost = (value) => {
+    if (!value) {
+        return undefined;
+    }
+    try {
+        return new URL(value).hostname;
+    }
+    catch {
+        return undefined;
+    }
+};
+export function useOpenGraphExtractor(options) {
+    const skipPatterns = useMemo(() => options.skipPatterns ?? DEFAULT_SKIP_PATTERNS, [options.skipPatterns]);
+    const shouldSkip = useCallback((url) => skipPatterns.some((pattern) => pattern.test(url)), [skipPatterns]);
+    const selectData = useCallback((payload, _raw, meta) => {
+        const { openGraph, htmlInferred, hybridGraph } = payload;
+        const description = pickFirstString(openGraph?.description, hybridGraph?.description, htmlInferred?.description);
+        const title = pickFirstString(openGraph?.title, hybridGraph?.title, htmlInferred?.title);
+        const siteName = pickFirstString(openGraph?.site_name, hybridGraph?.site_name, htmlInferred?.site_name);
+        const favicon = pickFirstString(hybridGraph?.favicon, htmlInferred?.favicon);
+        const image = pickFirstString(openGraph?.image?.url ?? undefined, hybridGraph?.image ?? undefined, htmlInferred?.image ?? undefined, htmlInferred?.images?.[0]);
+        const video = pickFirstString(openGraph?.video?.url ?? undefined, hybridGraph?.video ?? undefined);
+        const videoType = pickFirstString(hybridGraph?.videoType, htmlInferred?.videoType);
+        const resolvedUrl = pickFirstString(meta.url, openGraph?.url ?? undefined, hybridGraph?.url ?? undefined, htmlInferred?.url ?? undefined, meta.finalUrl, meta.normalizedUrl, meta.requestedUrl) ?? "";
+        return {
+            description,
+            favicon,
+            image,
+            video,
+            videoType,
+            siteName,
+            title,
+            url: resolvedUrl,
+            siteHost: safeHost(resolvedUrl),
+        };
+    }, []);
+    return useWebsiteExtractorBase({
+        endpoint: "open-graph",
+        options,
+        selectData,
+        shouldSkip,
+    });
+}

package/dist/core/usePrevious.cjs

@@ -1,7 +1,12 @@
-import { useEffect, useRef } from "react";
+import { useRef } from "react";
+import { useIsomorphicLayoutEffect } from "./useIsomorphicLayoutEffect.js";
 export function usePrevious(value) {
     const ref = useRef();
-    useEffect(() => {
+    // Use useIsomorphicLayoutEffect to capture the previous value synchronously
+    // BEFORE paint. This ensures that during render, ref.current holds the actual
+    // previous value (from the last render), not the current value.
+    // Using useEffect would update AFTER paint, making comparisons incorrect.
+    useIsomorphicLayoutEffect(() => {
         ref.current = value;
     }, [value]);
     return ref.current;

package/dist/core/usePrevious.js

@@ -1,7 +1,12 @@
-import { useEffect, useRef } from "react";
+import { useRef } from "react";
+import { useIsomorphicLayoutEffect } from "./useIsomorphicLayoutEffect.js";
 export function usePrevious(value) {
     const ref = useRef();
-    useEffect(() => {
+    // Use useIsomorphicLayoutEffect to capture the previous value synchronously
+    // BEFORE paint. This ensures that during render, ref.current holds the actual
+    // previous value (from the last render), not the current value.
+    // Using useEffect would update AFTER paint, making comparisons incorrect.
+    useIsomorphicLayoutEffect(() => {
         ref.current = value;
     }, [value]);
     return ref.current;

package/dist/core/useWebsiteExtractorBase.cjs

@@ -0,0 +1,153 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { useDebounceCallback } from "./useDebounceCallback.js";
+import { useDebounceValue } from "./useDebounceValue.js";
+import { useIsClient } from "./useIsClient.js";
+import { useMap } from "./useMap.js";
+import { fetchWebsiteExtractor } from "./websiteExtractorService.js";
+import { DEFAULT_EXTRACTOR_CACHE, DEFAULT_EXTRACTOR_DEBOUNCE_MS, DEFAULT_EXTRACTOR_ENABLED, DEFAULT_EXTRACTOR_REFRESH_DEBOUNCE_MS, DEFAULT_WEBSITE_EXTRACTOR_BASE_URL, extractWebsiteMeta, stripWebsiteMeta, } from "./websiteExtractorTypes.js";
+export function useWebsiteExtractorBase(config) {
+    const { endpoint, options, selectData, shouldSkip } = config;
+    const isClient = useIsClient();
+    const [state, setState] = useState({
+        loading: false,
+    });
+    const [, cacheActions] = useMap();
+    const cacheEnabled = options.cache ?? DEFAULT_EXTRACTOR_CACHE;
+    const enabled = options.enabled ?? DEFAULT_EXTRACTOR_ENABLED;
+    const debounceMs = options.debounceMs ?? DEFAULT_EXTRACTOR_DEBOUNCE_MS;
+    const refreshDebounceMs = options.refreshDebounceMs ?? DEFAULT_EXTRACTOR_REFRESH_DEBOUNCE_MS;
+    const normalizedUrl = useMemo(() => {
+        return options.url?.trim() ?? "";
+    }, [options.url]);
+    const debouncedUrl = useDebounceValue(normalizedUrl, debounceMs);
+    const refreshCounterRef = useRef(0);
+    const lastRefreshHandledRef = useRef(0);
+    const [refreshToken, setRefreshToken] = useState(0);
+    const { debouncedCallback: scheduleRefresh, cancel: cancelRefresh } = useDebounceCallback(() => {
+        refreshCounterRef.current += 1;
+        setRefreshToken(refreshCounterRef.current);
+    }, refreshDebounceMs);
+    const refresh = useCallback(() => {
+        scheduleRefresh();
+    }, [scheduleRefresh]);
+    useEffect(() => () => cancelRefresh(), [cancelRefresh]);
+    const requestKey = useMemo(() => {
+        if (!debouncedUrl) {
+            return "";
+        }
+        const baseUrl = options.baseUrl ?? DEFAULT_WEBSITE_EXTRACTOR_BASE_URL;
+        const apiKey = options.apiKey ?? "";
+        return `${endpoint}:${baseUrl}:${apiKey}:${debouncedUrl}`;
+    }, [
+        endpoint,
+        options.apiKey,
+        options.baseUrl,
+        debouncedUrl,
+    ]);
+    const inFlightControllerRef = useRef(null);
+    useEffect(() => {
+        if (!isClient) {
+            return;
+        }
+        if (!enabled || !debouncedUrl) {
+            setState({ loading: false });
+            return;
+        }
+        if (shouldSkip?.(debouncedUrl)) {
+            setState({ loading: false });
+            return;
+        }
+        const forceRefresh = refreshToken !== lastRefreshHandledRef.current;
+        if (forceRefresh) {
+            lastRefreshHandledRef.current = refreshToken;
+        }
+        if (cacheEnabled && !forceRefresh) {
+            const cached = cacheActions.get(requestKey);
+            if (cached) {
+                setState({
+                    loading: false,
+                    data: cached.data,
+                    raw: cached.raw,
+                    meta: cached.meta,
+                });
+                return;
+            }
+        }
+        inFlightControllerRef.current?.abort();
+        const controller = new AbortController();
+        inFlightControllerRef.current = controller;
+        setState((prev) => ({
+            ...prev,
+            loading: true,
+            error: undefined,
+        }));
+        fetchWebsiteExtractor({
+            endpoint,
+            url: debouncedUrl,
+            apiKey: options.apiKey,
+            baseUrl: options.baseUrl,
+            signal: controller.signal,
+        })
+            .then((result) => {
+            if (controller.signal.aborted) {
+                return;
+            }
+            if (!result.ok) {
+                setState((prev) => ({
+                    ...prev,
+                    loading: false,
+                    error: result.error,
+                }));
+                return;
+            }
+            const raw = result.response;
+            const meta = extractWebsiteMeta(raw);
+            const payload = stripWebsiteMeta(raw);
+            const data = selectData(payload, raw, meta);
+            if (cacheEnabled) {
+                cacheActions.set(requestKey, { data, raw, meta });
+            }
+            setState({
+                loading: false,
+                data,
+                raw,
+                meta,
+            });
+        })
+            .catch((error) => {
+            if (controller.signal.aborted) {
+                return;
+            }
+            setState((prev) => ({
+                ...prev,
+                loading: false,
+                error: {
+                    message: error instanceof Error
+                        ? error.message
+                        : "Request failed unexpectedly.",
+                    raw: error,
+                },
+            }));
+        });
+        return () => {
+            controller.abort();
+        };
+    }, [
+        cacheActions,
+        cacheEnabled,
+        debouncedUrl,
+        enabled,
+        endpoint,
+        isClient,
+        options.apiKey,
+        options.baseUrl,
+        requestKey,
+        refreshToken,
+        selectData,
+        shouldSkip,
+    ]);
+    return useMemo(() => ({
+        ...state,
+        refresh,
+    }), [refresh, state]);
+}

package/dist/core/useWebsiteExtractorBase.d.ts

@@ -0,0 +1,9 @@
+import { type WebsiteExtractorOptions, type WebsiteExtractorResult, type WebsiteExtractMeta } from "./websiteExtractorTypes.js";
+interface UseWebsiteExtractorBaseConfig<TResponse extends WebsiteExtractMeta, TData> {
+    endpoint: string;
+    options: WebsiteExtractorOptions;
+    selectData: (payload: Omit<TResponse, keyof WebsiteExtractMeta>, raw: TResponse, meta: WebsiteExtractMeta) => TData;
+    shouldSkip?: (url: string) => boolean;
+}
+export declare function useWebsiteExtractorBase<TResponse extends WebsiteExtractMeta, TData>(config: UseWebsiteExtractorBaseConfig<TResponse, TData>): WebsiteExtractorResult<TData, TResponse>;
+export {};

package/dist/core/useWebsiteExtractorBase.js

@@ -0,0 +1,153 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { useDebounceCallback } from "./useDebounceCallback.js";
+import { useDebounceValue } from "./useDebounceValue.js";
+import { useIsClient } from "./useIsClient.js";
+import { useMap } from "./useMap.js";
+import { fetchWebsiteExtractor } from "./websiteExtractorService.js";
+import { DEFAULT_EXTRACTOR_CACHE, DEFAULT_EXTRACTOR_DEBOUNCE_MS, DEFAULT_EXTRACTOR_ENABLED, DEFAULT_EXTRACTOR_REFRESH_DEBOUNCE_MS, DEFAULT_WEBSITE_EXTRACTOR_BASE_URL, extractWebsiteMeta, stripWebsiteMeta, } from "./websiteExtractorTypes.js";
+export function useWebsiteExtractorBase(config) {
+    const { endpoint, options, selectData, shouldSkip } = config;
+    const isClient = useIsClient();
+    const [state, setState] = useState({
+        loading: false,
+    });
+    const [, cacheActions] = useMap();
+    const cacheEnabled = options.cache ?? DEFAULT_EXTRACTOR_CACHE;
+    const enabled = options.enabled ?? DEFAULT_EXTRACTOR_ENABLED;
+    const debounceMs = options.debounceMs ?? DEFAULT_EXTRACTOR_DEBOUNCE_MS;
+    const refreshDebounceMs = options.refreshDebounceMs ?? DEFAULT_EXTRACTOR_REFRESH_DEBOUNCE_MS;
+    const normalizedUrl = useMemo(() => {
+        return options.url?.trim() ?? "";
+    }, [options.url]);
+    const debouncedUrl = useDebounceValue(normalizedUrl, debounceMs);
+    const refreshCounterRef = useRef(0);
+    const lastRefreshHandledRef = useRef(0);
+    const [refreshToken, setRefreshToken] = useState(0);
+    const { debouncedCallback: scheduleRefresh, cancel: cancelRefresh } = useDebounceCallback(() => {
+        refreshCounterRef.current += 1;
+        setRefreshToken(refreshCounterRef.current);
+    }, refreshDebounceMs);
+    const refresh = useCallback(() => {
+        scheduleRefresh();
+    }, [scheduleRefresh]);
+    useEffect(() => () => cancelRefresh(), [cancelRefresh]);
+    const requestKey = useMemo(() => {
+        if (!debouncedUrl) {
+            return "";
+        }
+        const baseUrl = options.baseUrl ?? DEFAULT_WEBSITE_EXTRACTOR_BASE_URL;
+        const apiKey = options.apiKey ?? "";
+        return `${endpoint}:${baseUrl}:${apiKey}:${debouncedUrl}`;
+    }, [
+        endpoint,
+        options.apiKey,
+        options.baseUrl,
+        debouncedUrl,
+    ]);
+    const inFlightControllerRef = useRef(null);
+    useEffect(() => {
+        if (!isClient) {
+            return;
+        }
+        if (!enabled || !debouncedUrl) {
+            setState({ loading: false });
+            return;
+        }
+        if (shouldSkip?.(debouncedUrl)) {
+            setState({ loading: false });
+            return;
+        }
+        const forceRefresh = refreshToken !== lastRefreshHandledRef.current;
+        if (forceRefresh) {
+            lastRefreshHandledRef.current = refreshToken;
+        }
+        if (cacheEnabled && !forceRefresh) {
+            const cached = cacheActions.get(requestKey);
+            if (cached) {
+                setState({
+                    loading: false,
+                    data: cached.data,
+                    raw: cached.raw,
+                    meta: cached.meta,
+                });
+                return;
+            }
+        }
+        inFlightControllerRef.current?.abort();
+        const controller = new AbortController();
+        inFlightControllerRef.current = controller;
+        setState((prev) => ({
+            ...prev,
+            loading: true,
+            error: undefined,
+        }));
+        fetchWebsiteExtractor({
+            endpoint,
+            url: debouncedUrl,
+            apiKey: options.apiKey,
+            baseUrl: options.baseUrl,
+            signal: controller.signal,
+        })
+            .then((result) => {
+            if (controller.signal.aborted) {
+                return;
+            }
+            if (!result.ok) {
+                setState((prev) => ({
+                    ...prev,
+                    loading: false,
+                    error: result.error,
+                }));
+                return;
+            }
+            const raw = result.response;
+            const meta = extractWebsiteMeta(raw);
+            const payload = stripWebsiteMeta(raw);
+            const data = selectData(payload, raw, meta);
+            if (cacheEnabled) {
+                cacheActions.set(requestKey, { data, raw, meta });
+            }
+            setState({
+                loading: false,
+                data,
+                raw,
+                meta,
+            });
+        })
+            .catch((error) => {
+            if (controller.signal.aborted) {
+                return;
+            }
+            setState((prev) => ({
+                ...prev,
+                loading: false,
+                error: {
+                    message: error instanceof Error
+                        ? error.message
+                        : "Request failed unexpectedly.",
+                    raw: error,
+                },
+            }));
+        });
+        return () => {
+            controller.abort();
+        };
+    }, [
+        cacheActions,
+        cacheEnabled,
+        debouncedUrl,
+        enabled,
+        endpoint,
+        isClient,
+        options.apiKey,
+        options.baseUrl,
+        requestKey,
+        refreshToken,
+        selectData,
+        shouldSkip,
+    ]);
+    return useMemo(() => ({
+        ...state,
+        refresh,
+    }), [refresh, state]);
+}

package/dist/core/useWebsiteLinksExtractor.cjs

@@ -0,0 +1,16 @@
+import { useCallback } from "react";
+import { useWebsiteExtractorBase } from "./useWebsiteExtractorBase.js";
+export function useWebsiteLinksExtractor(options) {
+    const selectData = useCallback((payload) => {
+        return {
+            totalLinks: payload.totalLinks ?? 0,
+            uniqueDomains: payload.uniqueDomains ?? 0,
+            links: payload.links ?? [],
+        };
+    }, []);
+    return useWebsiteExtractorBase({
+        endpoint: "links",
+        options,
+        selectData,
+    });
+}

package/dist/core/useWebsiteLinksExtractor.d.ts

@@ -0,0 +1,14 @@
+import type { WebsiteExtractorOptions, WebsiteExtractorResponse, WebsiteExtractorResult } from "./websiteExtractorTypes.js";
+export interface WebsiteLinkRecord {
+    url: string;
+    text: string;
+    isExternal: boolean;
+    domain?: string | null;
+}
+export interface WebsiteLinksPayload {
+    totalLinks: number;
+    uniqueDomains: number;
+    links: WebsiteLinkRecord[];
+}
+export type WebsiteLinksResponse = WebsiteExtractorResponse<WebsiteLinksPayload>;
+export declare function useWebsiteLinksExtractor(options: WebsiteExtractorOptions): WebsiteExtractorResult<WebsiteLinksPayload, WebsiteLinksResponse>;

package/dist/core/useWebsiteLinksExtractor.js

@@ -0,0 +1,16 @@
+import { useCallback } from "react";
+import { useWebsiteExtractorBase } from "./useWebsiteExtractorBase.js";
+export function useWebsiteLinksExtractor(options) {
+    const selectData = useCallback((payload) => {
+        return {
+            totalLinks: payload.totalLinks ?? 0,
+            uniqueDomains: payload.uniqueDomains ?? 0,
+            links: payload.links ?? [],
+        };
+    }, []);
+    return useWebsiteExtractorBase({
+        endpoint: "links",
+        options,
+        selectData,
+    });
+}

package/dist/core/useWebsiteMetaExtractor.cjs

@@ -0,0 +1,20 @@
+import { useCallback } from "react";
+import { useWebsiteExtractorBase } from "./useWebsiteExtractorBase.js";
+export function useWebsiteMetaExtractor(options) {
+    const selectData = useCallback((payload) => {
+        return {
+            title: payload.title ?? undefined,
+            description: payload.description ?? undefined,
+            language: payload.language ?? undefined,
+            canonicalUrl: payload.canonicalUrl ?? undefined,
+            feedUrl: payload.feedUrl ?? null,
+            textContentLength: payload.textContentLength ?? undefined,
+            metaTags: payload.metaTags ?? {},
+        };
+    }, []);
+    return useWebsiteExtractorBase({
+        endpoint: "meta",
+        options,
+        selectData,
+    });
+}

package/dist/core/useWebsiteMetaExtractor.d.ts

@@ -0,0 +1,12 @@
+import type { WebsiteExtractorOptions, WebsiteExtractorResponse, WebsiteExtractorResult } from "./websiteExtractorTypes.js";
+export interface WebsiteMetaPayload {
+    title?: string | null;
+    description?: string | null;
+    language?: string | null;
+    canonicalUrl?: string | null;
+    feedUrl?: string | null;
+    textContentLength?: number | null;
+    metaTags: Record<string, string>;
+}
+export type WebsiteMetaResponse = WebsiteExtractorResponse<WebsiteMetaPayload>;
+export declare function useWebsiteMetaExtractor(options: WebsiteExtractorOptions): WebsiteExtractorResult<WebsiteMetaPayload, WebsiteMetaResponse>;

package/dist/core/useWebsiteMetaExtractor.js

@@ -0,0 +1,20 @@
+import { useCallback } from "react";
+import { useWebsiteExtractorBase } from "./useWebsiteExtractorBase.js";
+export function useWebsiteMetaExtractor(options) {
+    const selectData = useCallback((payload) => {
+        return {
+            title: payload.title ?? undefined,
+            description: payload.description ?? undefined,
+            language: payload.language ?? undefined,
+            canonicalUrl: payload.canonicalUrl ?? undefined,
+            feedUrl: payload.feedUrl ?? null,
+            textContentLength: payload.textContentLength ?? undefined,
+            metaTags: payload.metaTags ?? {},
+        };
+    }, []);
+    return useWebsiteExtractorBase({
+        endpoint: "meta",
+        options,
+        selectData,
+    });
+}

package/dist/core/useWebsiteRssExtractor.cjs

@@ -0,0 +1,15 @@
+import { useCallback } from "react";
+import { useWebsiteExtractorBase } from "./useWebsiteExtractorBase.js";
+export function useWebsiteRssExtractor(options) {
+    const selectData = useCallback((payload) => {
+        return {
+            feedUrl: payload.feedUrl ?? null,
+            feeds: payload.feeds ?? [],
+        };
+    }, []);
+    return useWebsiteExtractorBase({
+        endpoint: "rss",
+        options,
+        selectData,
+    });
+}

package/dist/core/useWebsiteRssExtractor.d.ts

@@ -0,0 +1,12 @@
+import type { WebsiteExtractorOptions, WebsiteExtractorResponse, WebsiteExtractorResult } from "./websiteExtractorTypes.js";
+export interface WebsiteRssFeed {
+    url: string;
+    feedType: string;
+    title?: string | null;
+}
+export interface WebsiteRssPayload {
+    feedUrl?: string | null;
+    feeds: WebsiteRssFeed[];
+}
+export type WebsiteRssResponse = WebsiteExtractorResponse<WebsiteRssPayload>;
+export declare function useWebsiteRssExtractor(options: WebsiteExtractorOptions): WebsiteExtractorResult<WebsiteRssPayload, WebsiteRssResponse>;