rehype-og-card 1.1.1 → 2.0.0

package/README.md

@@ -115,6 +115,14 @@ Path to save the build cache. For Astro projects, specify the `./node_modules/.a
 - Type: `string`
 - Default: `"./.cache/og-card"`
 
+### `buildCacheMaxAge`
+
+Cache expiration time for build cache in milliseconds. Set to `false` to disable expiration.
+Expiration is calculated using the cached timestamp stored in the cache itself.
+
+- Type: `number | false`
+- Default: `2592000000` (30 days)
+
 ### `crawlerUserAgent`
 
 User agent to use for fetching the OG metadata and images.
@@ -171,6 +179,14 @@ Path to save the server cache. Specify the directory whose contents will be copi
 - Type: `string`
 - Default: `"./public"`
 
+### `serverCacheMaxAge`
+
+Cache expiration time for server cache in milliseconds. Set to `false` to disable expiration.
+Expiration is calculated using the cached timestamp stored in the cache itself.
+
+- Type: `number | false`
+- Default: `2592000000` (30 days)
+
 ### `shortenURL`
 
 Whether to shorten the displayed URL.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rehype-og-card",
-  "version": "1.1.1",
+  "version": "2.0.0",
   "description": "Rehype plugin to convert text links to link cards",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -43,8 +43,8 @@
     "@changesets/changelog-github": "^0.5.0",
     "@changesets/cli": "^2.27.7",
     "@robot-inventor/eslint-config": "^11.0.0",
-    "@robot-inventor/tsconfig-base": "^6.0.0",
-    "@types/node": "^24.2.1",
+    "@robot-inventor/tsconfig-base": "^7.0.0",
+    "@types/node": "^25.0.2",
     "eslint": "^9.7.0",
     "hast-util-to-html": "^9.0.1",
     "prettier": "^3.3.3",
@@ -57,6 +57,7 @@
   },
   "dependencies": {
     "@types/hast": "^3.0.4",
+    "arktype": "^2.1.29",
     "hast-util-is-element": "^3.0.0",
     "hastscript": "^9.0.0",
     "node-fetch": "^3.3.2",

package/dist/index.d.ts

@@ -1,11 +0,0 @@
-import type { Plugin } from "unified";
-import type { RehypeOGCardOptions } from "./types.js";
-import type { Root } from "hast";
-/**
- * Rehype plugin to create OG card from bare links.
- * @param options Plugin options.
- * @returns Transformer function.
- */
-declare const rehypeOGCard: Plugin<[RehypeOGCardOptions | undefined], Root>;
-export default rehypeOGCard;
-export type { RehypeOGCardOptions };

package/dist/index.js

@@ -1,152 +0,0 @@
-import { convertTextToAnchorElement, createOGCard, isAnchorElement, isTextNode } from "./util/hast.js";
-import { checkFileExistsSync, createDirectorySync } from "./util/file.js";
-import { downloadImage, getOGData, isValidURL } from "./util/network.js";
-import { restoreBuildCache, restoreOGDataBuildCache, saveBuildCacheFile, saveOGDataBuildCache } from "./util/cache.js";
-import { isElement } from "hast-util-is-element";
-import path from "path";
-import { visitParents } from "unist-util-visit-parents";
-const DEFAULT_OPTIONS = {
-    buildCache: false,
-    buildCachePath: "./node_modules/.cache",
-    crawlerUserAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36",
-    decoding: "async",
-    enableSameTextURLConversion: false,
-    excludeDomains: [],
-    loading: "lazy",
-    openInNewTab: false,
-    serverCache: true,
-    serverCachePath: "./public",
-    shortenURL: true
-};
-/**
- * Rehype plugin to create OG card from bare links.
- * @param options Plugin options.
- * @returns Transformer function.
- */
-// eslint-disable-next-line max-lines-per-function, max-statements
-const rehypeOGCard = (options) => {
-    const mergedOptions = {
-        ...DEFAULT_OPTIONS,
-        ...options
-    };
-    if (mergedOptions.buildCache && !mergedOptions.serverCache) {
-        throw new Error("[rehype-og-card] `buildCache` option requires `serverCache` option to be enabled.");
-    }
-    mergedOptions.serverCachePath = path.posix.join(mergedOptions.serverCachePath, "./rehype-og-card/");
-    mergedOptions.buildCachePath = path.posix.join(mergedOptions.buildCachePath, "./rehype-og-card/");
-    const buildCacheExists = checkFileExistsSync(mergedOptions.buildCachePath);
-    if (mergedOptions.buildCache) {
-        if (buildCacheExists) {
-            restoreBuildCache(mergedOptions.buildCachePath, mergedOptions.serverCachePath);
-        }
-        else {
-            createDirectorySync(mergedOptions.buildCachePath);
-        }
-    }
-    /**
-     * Transform function to create OG card from bare links.
-     * @param tree Root node of the HAST tree.
-     */
-    // eslint-disable-next-line max-lines-per-function
-    const transform = async (tree) => {
-        const linkCardPromises = [];
-        // eslint-disable-next-line max-statements, max-lines-per-function
-        visitParents(tree, ["element", "text"], (node, ancestors) => {
-            let anchorNode = null;
-            const isBareLink = node.type === "text" && isValidURL(node.value.trim());
-            const isValidAnchor = isAnchorElement(node) && isValidURL(node.properties.href);
-            if (isBareLink) {
-                anchorNode = convertTextToAnchorElement(node);
-            }
-            else if (mergedOptions.enableSameTextURLConversion && isValidAnchor) {
-                const isSameTextURL = 
-                // eslint-disable-next-line no-magic-numbers
-                node.children.length === 1 &&
-                    node.children[0] &&
-                    isTextNode(node.children[0]) &&
-                    node.children[0].value.trim() === node.properties.href;
-                if (!isSameTextURL)
-                    return;
-                anchorNode = node;
-            }
-            else {
-                return;
-            }
-            // eslint-disable-next-line no-magic-numbers
-            const parent = ancestors[ancestors.length - 1];
-            if (!parent)
-                return;
-            if (!isElement(parent, "p"))
-                return;
-            const shouldSkip = ancestors.some((ancestor) => isElement(ancestor) && ["ul", "ol"].includes(ancestor.tagName));
-            if (shouldSkip)
-                return;
-            // eslint-disable-next-line no-magic-numbers
-            const isTheOnlyChild = parent.children.length === 1;
-            if (!isTheOnlyChild)
-                return;
-            const targetURL = new URL(anchorNode.properties.href);
-            if (mergedOptions.excludeDomains.includes(targetURL.hostname))
-                return;
-            // eslint-disable-next-line jsdoc/require-jsdoc, max-statements, max-lines-per-function
-            const linkCardPromise = async () => {
-                let OGData = mergedOptions.buildCache
-                    ? await restoreOGDataBuildCache(anchorNode.properties.href, mergedOptions.buildCachePath)
-                    : null;
-                if (!OGData) {
-                    OGData = await getOGData(anchorNode.properties.href, mergedOptions.crawlerUserAgent);
-                    if (!OGData)
-                        return;
-                    if (mergedOptions.buildCache) {
-                        void saveOGDataBuildCache(anchorNode.properties.href, OGData, mergedOptions.buildCachePath);
-                    }
-                }
-                if (OGData.OGImageURL && mergedOptions.serverCache) {
-                    const filename = await downloadImage({
-                        directory: mergedOptions.serverCachePath,
-                        url: OGData.OGImageURL,
-                        userAgent: mergedOptions.crawlerUserAgent
-                    });
-                    if (filename) {
-                        OGData.OGImageURL = path.posix.join("/rehype-og-card", filename);
-                    }
-                    if (filename && mergedOptions.buildCache) {
-                        const downloadedFilePath = path.join(mergedOptions.serverCachePath, filename);
-                        const buildCachePath = path.join(mergedOptions.buildCachePath, filename);
-                        void saveBuildCacheFile(downloadedFilePath, buildCachePath);
-                    }
-                }
-                if (OGData.faviconURL && mergedOptions.serverCache) {
-                    const filename = await downloadImage({
-                        directory: mergedOptions.serverCachePath,
-                        url: OGData.faviconURL,
-                        userAgent: mergedOptions.crawlerUserAgent
-                    });
-                    if (filename) {
-                        OGData.faviconURL = path.posix.join("/rehype-og-card", filename);
-                    }
-                    if (filename && mergedOptions.buildCache) {
-                        const downloadedFilePath = path.join(mergedOptions.serverCachePath, filename);
-                        const buildCachePath = path.join(mergedOptions.buildCachePath, filename);
-                        void saveBuildCacheFile(downloadedFilePath, buildCachePath);
-                    }
-                }
-                if (mergedOptions.shortenURL) {
-                    const shortenedURL = new URL(anchorNode.properties.href);
-                    OGData.displayURL = shortenedURL.hostname;
-                }
-                const OGCard = createOGCard(OGData, mergedOptions);
-                const index = parent.children.indexOf(node);
-                // eslint-disable-next-line no-magic-numbers
-                if (index === -1)
-                    return;
-                // eslint-disable-next-line no-magic-numbers
-                parent.children.splice(index, 1, OGCard);
-            };
-            linkCardPromises.push(linkCardPromise());
-        });
-        await Promise.all(linkCardPromises);
-    };
-    return transform;
-};
-export default rehypeOGCard;

package/dist/types.d.ts

@@ -1,73 +0,0 @@
-interface RehypeOGCardOptions {
-    /**
-     * Domains to exclude from conversion.
-     */
-    excludeDomains?: string[];
-    /**
-     * `decoding` attribute of the image element.
-     * @default "async"
-     */
-    decoding?: HTMLImageElement["decoding"];
-    /**
-     * `loading` attribute of the image element.
-     * @default "lazy"
-     */
-    loading?: HTMLImageElement["loading"];
-    /**
-     * Whether to shorten the displayed URL.
-     * @default true
-     */
-    shortenURL?: boolean;
-    /**
-     * Whether to open the link in a new tab.
-     * @default false
-     */
-    openInNewTab?: boolean;
-    /**
-     * Whether to enable converting the links
-     * that have the same URL and text (e.g., `[https://example.com](https://example.com)`).
-     * @default false
-     */
-    enableSameTextURLConversion?: boolean;
-    /**
-     * Whether to cache the OG data on the server.
-     * @default true
-     */
-    serverCache?: boolean;
-    /**
-     * Path to save the server cache.
-     * Specify the directory whose contents will be copied to the root.
-     * For example, for an Astro project, specify the `public` directory.
-     * @default "./public"
-     */
-    serverCachePath?: string;
-    /**
-     * Whether to cache the OG metadata and images for the next build.
-     * `buildCache` option requires `serverCache` option to be enabled.
-     * @default false
-     */
-    buildCache?: boolean;
-    /**
-     * Path to save the build cache.
-     * For Astro projects, specify the `./node_modules/.astro` directory.
-     * @default "./node_modules/.cache"
-     */
-    buildCachePath?: string;
-    /**
-     * User agent to use for fetching the OG metadata and images.
-     * @default "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36"
-     */
-    crawlerUserAgent?: string;
-}
-interface OGCardData {
-    url: string;
-    title: string;
-    description?: string | undefined;
-    displayURL: string;
-    faviconURL?: string | undefined;
-    OGImageURL?: string | undefined;
-    OGImageAlt?: string | undefined;
-    OGImageWidth?: number | undefined;
-    OGImageHeight?: number | undefined;
-}
-export type { RehypeOGCardOptions, OGCardData };

package/dist/types.js

@@ -1 +0,0 @@
-export {};

package/dist/util/cache.d.ts

@@ -1,28 +0,0 @@
-import type { OGCardData } from "../types.js";
-/**
- * Save build cache if server cache exists.
- * @param serverCachePath Server cache path.
- * @param buildCachePath Build cache path.
- */
-declare const saveBuildCacheFile: (serverCachePath: string, buildCachePath: string) => Promise<void>;
-/**
- * Restore build cache if it exists.
- * @param buildCachePath Build cache path.
- * @param serverCachePath Server cache path.
- */
-declare const restoreBuildCache: (buildCachePath: string, serverCachePath: string) => void;
-/**
- * Save OG data to build cache.
- * @param url URL of the OG data.
- * @param OGData OG data to save.
- * @param buildCachePath Build cache path.
- */
-declare const saveOGDataBuildCache: (url: string, OGData: OGCardData, buildCachePath: string) => Promise<void>;
-/**
- * Restore OG data from build cache.
- * @param url URL of the OG data.
- * @param buildCachePath Build cache path.
- * @returns Restored OG data. If not found, returns `null`.
- */
-declare const restoreOGDataBuildCache: (url: string, buildCachePath: string) => Promise<OGCardData | null>;
-export { saveBuildCacheFile, restoreBuildCache, saveOGDataBuildCache, restoreOGDataBuildCache };

package/dist/util/cache.js

@@ -1,56 +0,0 @@
-import { checkFileExists, copyDirectory, generateFilename } from "./file.js";
-import fs from "fs/promises";
-import path from "path";
-/**
- * Save build cache if server cache exists.
- * @param serverCachePath Server cache path.
- * @param buildCachePath Build cache path.
- */
-const saveBuildCacheFile = async (serverCachePath, buildCachePath) => {
-    const serverCacheExists = await checkFileExists(serverCachePath);
-    const buildCacheExists = await checkFileExists(buildCachePath);
-    if (serverCacheExists && !buildCacheExists) {
-        await fs.copyFile(serverCachePath, buildCachePath);
-    }
-};
-/**
- * Restore build cache if it exists.
- * @param buildCachePath Build cache path.
- * @param serverCachePath Server cache path.
- */
-const restoreBuildCache = (buildCachePath, serverCachePath) => {
-    copyDirectory(buildCachePath, serverCachePath);
-};
-/**
- * Save OG data to build cache.
- * @param url URL of the OG data.
- * @param OGData OG data to save.
- * @param buildCachePath Build cache path.
- */
-const saveOGDataBuildCache = async (url, OGData, buildCachePath) => {
-    const filename = generateFilename(url, false);
-    const savePath = `${path.join(buildCachePath, filename)}.json`;
-    const cacheDirectoryExists = await checkFileExists(buildCachePath);
-    if (!cacheDirectoryExists) {
-        await fs.mkdir(buildCachePath, { recursive: true });
-    }
-    await fs.writeFile(savePath, JSON.stringify(OGData));
-};
-/**
- * Restore OG data from build cache.
- * @param url URL of the OG data.
- * @param buildCachePath Build cache path.
- * @returns Restored OG data. If not found, returns `null`.
- */
-const restoreOGDataBuildCache = async (url, buildCachePath) => {
-    const filename = generateFilename(url, false);
-    const savePath = `${path.join(buildCachePath, filename)}.json`;
-    try {
-        const data = await fs.readFile(savePath, "utf-8");
-        return JSON.parse(data);
-    }
-    catch {
-        return null;
-    }
-};
-export { saveBuildCacheFile, restoreBuildCache, saveOGDataBuildCache, restoreOGDataBuildCache };

package/dist/util/file.d.ts

@@ -1,31 +0,0 @@
-/**
- * Check if the file exists.
- * @param filePath Path to check.
- * @returns `true` if the file exists, `false` otherwise.
- */
-declare const checkFileExists: (filePath: string) => Promise<boolean>;
-/**
- * Check if the file exists.
- * @param filePath Path to check.
- * @returns `true` if the file exists, `false` otherwise.
- */
-declare const checkFileExistsSync: (filePath: string) => boolean;
-/**
- * Create directory.
- * @param dir Directory path.
- */
-declare const createDirectorySync: (dir: string) => void;
-/**
- * Copy directory from source to destination.
- * @param source Source directory.
- * @param destination Destination directory.
- */
-declare const copyDirectory: (source: string, destination: string) => void;
-/**
- * Generate filename from URL.
- * @param url URL to generate filename.
- * @param extension Include extension in the filename.
- * @returns Generated filename.
- */
-declare const generateFilename: (url: string, extension?: boolean) => string;
-export { checkFileExists, checkFileExistsSync, createDirectorySync, copyDirectory, generateFilename };

package/dist/util/file.js

@@ -1,78 +0,0 @@
-import { createHash } from "crypto";
-import fs from "fs";
-import path from "path";
-/**
- * Check if the file exists.
- * @param filePath Path to check.
- * @returns `true` if the file exists, `false` otherwise.
- */
-const checkFileExists = async (filePath) => {
-    try {
-        await fs.promises.access(filePath);
-        return true;
-    }
-    catch {
-        return false;
-    }
-};
-/**
- * Check if the file exists.
- * @param filePath Path to check.
- * @returns `true` if the file exists, `false` otherwise.
- */
-const checkFileExistsSync = (filePath) => {
-    let result = false;
-    fs.access(filePath, (error) => {
-        result = !error;
-    });
-    return result;
-};
-/**
- * Create directory.
- * @param dir Directory path.
- */
-const createDirectorySync = (dir) => {
-    fs.mkdir(dir, { recursive: true }, (error) => {
-        if (error) {
-            // eslint-disable-next-line no-console
-            console.error("[rehype-og-card] Failed to copy files: ", error);
-        }
-    });
-};
-/**
- * Copy directory from source to destination.
- * @param source Source directory.
- * @param destination Destination directory.
- */
-const copyDirectory = (source, destination) => {
-    const sourceExists = checkFileExistsSync(source);
-    if (!sourceExists)
-        return;
-    const destinationExists = checkFileExistsSync(destination);
-    if (!destinationExists) {
-        createDirectorySync(destination);
-    }
-    fs.cp(source, destination, { recursive: true }, (error) => {
-        if (error) {
-            // eslint-disable-next-line no-console
-            console.error("[rehype-og-card] Failed to copy files: ", error);
-        }
-    });
-};
-/**
- * Generate filename from URL.
- * @param url URL to generate filename.
- * @param extension Include extension in the filename.
- * @returns Generated filename.
- */
-const generateFilename = (url, extension = true) => {
-    const hash = createHash("sha256").update(url).digest("hex");
-    const possibleExtension = path.extname(new URL(url).pathname).toLowerCase();
-    const allowedExtensions = [".png", ".jpg", ".jpeg", ".webp", ".gif", ".avif", ".svg"];
-    const extensionString = allowedExtensions.includes(possibleExtension)
-        ? possibleExtension
-        : "";
-    const filename = extension ? hash + extensionString : hash;
-    return filename;
-};
-export { checkFileExists, checkFileExistsSync, createDirectorySync, copyDirectory, generateFilename };

package/dist/util/hast.d.ts

@@ -1,38 +0,0 @@
-import type { Element, ElementContent, Text } from "hast";
-import type { OGCardData, RehypeOGCardOptions } from "../types.js";
-interface AnchorElement extends Element {
-    tagName: "a";
-    properties: {
-        href: string;
-    };
-}
-/**
- * Check if the node is a text node.
- * @param node Node to check.
- * @returns `true` if the node is a text node, `false` otherwise.
- */
-declare const isTextNode: (node: ElementContent) => node is Text;
-/**
- * Check if the node is an anchor element.
- * @param node Node to check.
- * @returns `true` if the node is an anchor element, `false` otherwise.
- */
-declare const isAnchorElement: (node: unknown) => node is AnchorElement;
-/**
- * Convert text node to anchor element. **This function does not check if the text is a valid URL.**
- * @param text Text node to convert.
- * @returns Anchor element.
- */
-declare const convertTextToAnchorElement: (text: Text) => AnchorElement;
-/**
- * Create OG card element from given data.
- * @param data Data to create OG card.
- * @param options Options to create OG card.
- * @returns OG card element.
- */
-declare const createOGCard: (data: OGCardData, options: Required<{
-    loading: RehypeOGCardOptions["loading"];
-    decoding: RehypeOGCardOptions["decoding"];
-    openInNewTab: RehypeOGCardOptions["openInNewTab"];
-}>) => Element;
-export { type AnchorElement, isTextNode, isAnchorElement, convertTextToAnchorElement, createOGCard };

package/dist/util/hast.js

@@ -1,73 +0,0 @@
-import { h } from "hastscript";
-import { isElement } from "hast-util-is-element";
-/**
- * Check if the node is a text node.
- * @param node Node to check.
- * @returns `true` if the node is a text node, `false` otherwise.
- */
-const isTextNode = (node) => Boolean(node) && typeof node === "object" && "type" in node && node.type === "text";
-/**
- * Check if the node is an anchor element.
- * @param node Node to check.
- * @returns `true` if the node is an anchor element, `false` otherwise.
- */
-const isAnchorElement = (node) => Boolean(node) && isElement(node, "a") && "href" in node.properties && typeof node.properties["href"] === "string";
-/**
- * Convert text node to anchor element. **This function does not check if the text is a valid URL.**
- * @param text Text node to convert.
- * @returns Anchor element.
- */
-const convertTextToAnchorElement = (text) => ({
-    children: [text],
-    properties: {
-        href: text.value.trim()
-    },
-    tagName: "a",
-    type: "element"
-});
-/**
- * Create OG card element from given data.
- * @param data Data to create OG card.
- * @param options Options to create OG card.
- * @returns OG card element.
- */
-const createOGCard = (data, options) => {
-    const openInNewTab = {
-        rel: "noopener noreferrer",
-        target: "_blank"
-    };
-    const card = h("div.og-card-container", [
-        h("a", { href: data.url, ...(options.openInNewTab ? openInNewTab : {}) }, [
-            h("div.og-card-info", [
-                h("div.og-card-title", data.title),
-                data.description ? h("div.og-card-description", data.description) : null,
-                h("div.og-card-url-container", [
-                    h("img.og-card-favicon", {
-                        alt: "favicon",
-                        decoding: options.decoding,
-                        height: 16,
-                        loading: options.loading,
-                        src: data.faviconURL,
-                        width: 16
-                    }),
-                    h("span.og-card-url", data.displayURL)
-                ])
-            ]),
-            data.OGImageURL
-                ? h("div.og-card-image-container", [
-                    h("img.og-card-image", {
-                        // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing
-                        alt: data.OGImageAlt || data.OGImageURL,
-                        decoding: options.decoding,
-                        height: data.OGImageHeight,
-                        loading: options.loading,
-                        src: data.OGImageURL,
-                        width: data.OGImageWidth
-                    })
-                ])
-                : null
-        ])
-    ]);
-    return card;
-};
-export { isTextNode, isAnchorElement, convertTextToAnchorElement, createOGCard };

package/dist/util/network.d.ts

@@ -1,35 +0,0 @@
-import type { OGCardData } from "../types.js";
-/**
- * Check if the URL is valid.
- * @param url URL to check.
- * @returns `true` if the URL is valid, `false` otherwise.
- */
-declare const isValidURL: (url: string) => boolean;
-/**
- * Get OG card data from given URL.
- * @param url URL to get OG card data.
- * @param userAgent User agent to use for fetching.
- * @returns OG card data.
- */
-declare const getOGData: (url: string, userAgent: string) => Promise<OGCardData | null>;
-interface DownloadImageOptions {
-    /**
-     * URL to download image.
-     */
-    url: string;
-    /**
-     * Directory to save the downloaded image.
-     */
-    directory: string;
-    /**
-     * User agent to use for fetching the image.
-     */
-    userAgent: string;
-}
-/**
- * Download image from given URL. If the image already exists, return the filename.
- * @param options Options to download image.
- * @returns Filename of the downloaded image.
- */
-declare const downloadImage: (options: DownloadImageOptions) => Promise<string | null>;
-export { isValidURL, getOGData, downloadImage };

package/dist/util/network.js

@@ -1,112 +0,0 @@
-import { checkFileExists, generateFilename } from "./file.js";
-import fetch from "node-fetch";
-import fs from "fs/promises";
-import path from "path";
-import scraper from "open-graph-scraper";
-/**
- * Check if the URL is valid.
- * @param url URL to check.
- * @returns `true` if the URL is valid, `false` otherwise.
- */
-const isValidURL = (url) => {
-    const ALLOWED_PROTOCOLS = ["http:", "https:"];
-    const parsedUrl = URL.parse(url);
-    return Boolean(parsedUrl && ALLOWED_PROTOCOLS.includes(parsedUrl.protocol));
-};
-/**
- * Resolve an absolute URL from a raw URL and a base URL.
- * @param rawURL Raw URL to resolve.
- * @param baseURL Base URL to resolve against.
- * @returns Resolved absolute URL or `undefined` if the raw URL is invalid.
- */
-const resolveAbsoluteURL = (rawURL, baseURL) => {
-    // eslint-disable-next-line no-undefined
-    if (!rawURL)
-        return undefined;
-    const parsedUrl = URL.parse(rawURL, baseURL);
-    // eslint-disable-next-line no-undefined
-    return parsedUrl ? parsedUrl.href : undefined;
-};
-/**
- * Get OG card data from given URL.
- * @param url URL to get OG card data.
- * @param userAgent User agent to use for fetching.
- * @returns OG card data.
- */
-const getOGData = async (url, userAgent) => {
-    try {
-        const { result } = await scraper({
-            fetchOptions: {
-                headers: {
-                    "user-agent": userAgent
-                }
-            },
-            url
-        });
-        const OGImage = result.ogImage ? result.ogImage[0] : null;
-        const OGImageURL = resolveAbsoluteURL(OGImage?.url, url);
-        const faviconURL = result.favicon
-            ? `https://www.google.com/s2/favicons?domain=${new URL(url).hostname}`
-            : // eslint-disable-next-line no-undefined
-                undefined;
-        return {
-            OGImageAlt: OGImage?.alt,
-            OGImageHeight: OGImage?.height,
-            OGImageURL,
-            OGImageWidth: OGImage?.width,
-            description: result.ogDescription,
-            displayURL: url,
-            faviconURL,
-            // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing
-            title: result.ogTitle || url,
-            url
-        };
-    }
-    catch (error) {
-        // eslint-disable-next-line no-console
-        console.error("[rehype-og-card] Error fetching OG data:", error);
-        return null;
-    }
-};
-/**
- * Download image from given URL. If the image already exists, return the filename.
- * @param options Options to download image.
- * @returns Filename of the downloaded image.
- */
-// eslint-disable-next-line max-statements
-const downloadImage = async (options) => {
-    if (!isValidURL(options.url)) {
-        // eslint-disable-next-line no-console
-        console.error("[rehype-og-card] Invalid thumbnail URL:", options.url);
-        return null;
-    }
-    try {
-        const filename = generateFilename(options.url);
-        const savePath = path.posix.join(options.directory, filename);
-        // If the file already exists, return the filename.
-        const fileExists = await checkFileExists(savePath);
-        if (fileExists)
-            return filename;
-        const response = await fetch(options.url, {
-            headers: {
-                "user-agent": options.userAgent
-            },
-            // eslint-disable-next-line no-magic-numbers
-            signal: AbortSignal.timeout(10 * 1000)
-        });
-        const arrayBuffer = await response.arrayBuffer();
-        const buffer = Buffer.from(arrayBuffer);
-        const saveDirectoryExists = await checkFileExists(options.directory);
-        if (!saveDirectoryExists) {
-            await fs.mkdir(options.directory, { recursive: true });
-        }
-        await fs.writeFile(savePath, buffer);
-        return filename;
-    }
-    catch (error) {
-        // eslint-disable-next-line no-console
-        console.error("[rehype-og-card] Error downloading image:", error);
-        return null;
-    }
-};
-export { isValidURL, getOGData, downloadImage };