rehype-og-card 1.0.2 → 1.0.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.d.ts +2 -2
- package/dist/index.js +14 -22
- package/dist/types.d.ts +1 -1
- package/dist/util/cache.js +14 -23
- package/dist/util/file.js +4 -13
- package/dist/util/hast.d.ts +1 -1
- package/dist/util/hast.js +2 -2
- package/dist/util/network.js +17 -25
- package/package.json +3 -2
package/dist/index.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type { Plugin } from "unified";
|
|
2
|
-
import { RehypeOGCardOptions } from "./types.js";
|
|
2
|
+
import type { RehypeOGCardOptions } from "./types.js";
|
|
3
3
|
import type { Root } from "hast";
|
|
4
4
|
/**
|
|
5
5
|
* Rehype plugin to create OG card from bare links.
|
|
@@ -8,4 +8,4 @@ import type { Root } from "hast";
|
|
|
8
8
|
*/
|
|
9
9
|
declare const rehypeOGCard: Plugin<[RehypeOGCardOptions | undefined], Root>;
|
|
10
10
|
export default rehypeOGCard;
|
|
11
|
-
export { RehypeOGCardOptions };
|
|
11
|
+
export type { RehypeOGCardOptions };
|
package/dist/index.js
CHANGED
|
@@ -1,12 +1,3 @@
|
|
|
1
|
-
var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
|
|
2
|
-
function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
|
|
3
|
-
return new (P || (P = Promise))(function (resolve, reject) {
|
|
4
|
-
function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
|
|
5
|
-
function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
|
|
6
|
-
function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
|
|
7
|
-
step((generator = generator.apply(thisArg, _arguments || [])).next());
|
|
8
|
-
});
|
|
9
|
-
};
|
|
10
1
|
import { convertTextToAnchorElement, createOGCard, isAnchorElement, isTextNode } from "./util/hast.js";
|
|
11
2
|
import { checkFileExistsSync, createDirectorySync } from "./util/file.js";
|
|
12
3
|
import { downloadImage, getOGData, isValidURL } from "./util/network.js";
|
|
@@ -17,9 +8,7 @@ import { visitParents } from "unist-util-visit-parents";
|
|
|
17
8
|
const DEFAULT_OPTIONS = {
|
|
18
9
|
buildCache: false,
|
|
19
10
|
buildCachePath: "./node_modules/.cache",
|
|
20
|
-
crawlerUserAgent:
|
|
21
|
-
// eslint-disable-next-line max-len
|
|
22
|
-
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36",
|
|
11
|
+
crawlerUserAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36",
|
|
23
12
|
decoding: "async",
|
|
24
13
|
enableSameTextURLConversion: false,
|
|
25
14
|
excludeDomains: [],
|
|
@@ -36,7 +25,10 @@ const DEFAULT_OPTIONS = {
|
|
|
36
25
|
*/
|
|
37
26
|
// eslint-disable-next-line max-lines-per-function, max-statements
|
|
38
27
|
const rehypeOGCard = (options) => {
|
|
39
|
-
const mergedOptions =
|
|
28
|
+
const mergedOptions = {
|
|
29
|
+
...DEFAULT_OPTIONS,
|
|
30
|
+
...options
|
|
31
|
+
};
|
|
40
32
|
if (mergedOptions.buildCache && !mergedOptions.serverCache) {
|
|
41
33
|
throw new Error("[rehype-og-card] `buildCache` option requires `serverCache` option to be enabled.");
|
|
42
34
|
}
|
|
@@ -56,7 +48,7 @@ const rehypeOGCard = (options) => {
|
|
|
56
48
|
* @param tree Root node of the HAST tree.
|
|
57
49
|
*/
|
|
58
50
|
// eslint-disable-next-line max-lines-per-function
|
|
59
|
-
const transform = (tree) =>
|
|
51
|
+
const transform = async (tree) => {
|
|
60
52
|
const linkCardPromises = [];
|
|
61
53
|
// eslint-disable-next-line max-statements, max-lines-per-function
|
|
62
54
|
visitParents(tree, ["element", "text"], (node, ancestors) => {
|
|
@@ -93,12 +85,12 @@ const rehypeOGCard = (options) => {
|
|
|
93
85
|
if (mergedOptions.excludeDomains.includes(targetURL.hostname))
|
|
94
86
|
return;
|
|
95
87
|
// eslint-disable-next-line jsdoc/require-jsdoc, max-statements, max-lines-per-function
|
|
96
|
-
const linkCardPromise = () =>
|
|
88
|
+
const linkCardPromise = async () => {
|
|
97
89
|
let OGData = mergedOptions.buildCache
|
|
98
|
-
?
|
|
90
|
+
? await restoreOGDataBuildCache(anchorNode.properties.href, mergedOptions.buildCachePath)
|
|
99
91
|
: null;
|
|
100
92
|
if (!OGData) {
|
|
101
|
-
OGData =
|
|
93
|
+
OGData = await getOGData(anchorNode.properties.href, mergedOptions.crawlerUserAgent);
|
|
102
94
|
if (!OGData)
|
|
103
95
|
return;
|
|
104
96
|
if (mergedOptions.buildCache) {
|
|
@@ -106,7 +98,7 @@ const rehypeOGCard = (options) => {
|
|
|
106
98
|
}
|
|
107
99
|
}
|
|
108
100
|
if (OGData.OGImageURL && mergedOptions.serverCache) {
|
|
109
|
-
const filename =
|
|
101
|
+
const filename = await downloadImage({
|
|
110
102
|
directory: mergedOptions.serverCachePath,
|
|
111
103
|
url: OGData.OGImageURL,
|
|
112
104
|
userAgent: mergedOptions.crawlerUserAgent
|
|
@@ -121,7 +113,7 @@ const rehypeOGCard = (options) => {
|
|
|
121
113
|
}
|
|
122
114
|
}
|
|
123
115
|
if (OGData.faviconURL && mergedOptions.serverCache) {
|
|
124
|
-
const filename =
|
|
116
|
+
const filename = await downloadImage({
|
|
125
117
|
directory: mergedOptions.serverCachePath,
|
|
126
118
|
url: OGData.faviconURL,
|
|
127
119
|
userAgent: mergedOptions.crawlerUserAgent
|
|
@@ -147,11 +139,11 @@ const rehypeOGCard = (options) => {
|
|
|
147
139
|
return;
|
|
148
140
|
// eslint-disable-next-line no-magic-numbers
|
|
149
141
|
ancestors[ancestors.length - 1].children.splice(index, 1, OGCard);
|
|
150
|
-
}
|
|
142
|
+
};
|
|
151
143
|
linkCardPromises.push(linkCardPromise());
|
|
152
144
|
});
|
|
153
|
-
|
|
154
|
-
}
|
|
145
|
+
await Promise.all(linkCardPromises);
|
|
146
|
+
};
|
|
155
147
|
return transform;
|
|
156
148
|
};
|
|
157
149
|
export default rehypeOGCard;
|
package/dist/types.d.ts
CHANGED
package/dist/util/cache.js
CHANGED
|
@@ -1,12 +1,3 @@
|
|
|
1
|
-
var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
|
|
2
|
-
function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
|
|
3
|
-
return new (P || (P = Promise))(function (resolve, reject) {
|
|
4
|
-
function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
|
|
5
|
-
function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
|
|
6
|
-
function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
|
|
7
|
-
step((generator = generator.apply(thisArg, _arguments || [])).next());
|
|
8
|
-
});
|
|
9
|
-
};
|
|
10
1
|
import { checkFileExists, copyDirectory, generateFilename } from "./file.js";
|
|
11
2
|
import fs from "fs/promises";
|
|
12
3
|
import path from "path";
|
|
@@ -15,13 +6,13 @@ import path from "path";
|
|
|
15
6
|
* @param serverCachePath Server cache path.
|
|
16
7
|
* @param buildCachePath Build cache path.
|
|
17
8
|
*/
|
|
18
|
-
const saveBuildCacheFile = (serverCachePath, buildCachePath) =>
|
|
19
|
-
const serverCacheExists =
|
|
20
|
-
const buildCacheExists =
|
|
9
|
+
const saveBuildCacheFile = async (serverCachePath, buildCachePath) => {
|
|
10
|
+
const serverCacheExists = await checkFileExists(serverCachePath);
|
|
11
|
+
const buildCacheExists = await checkFileExists(buildCachePath);
|
|
21
12
|
if (serverCacheExists && !buildCacheExists) {
|
|
22
|
-
|
|
13
|
+
await fs.copyFile(serverCachePath, buildCachePath);
|
|
23
14
|
}
|
|
24
|
-
}
|
|
15
|
+
};
|
|
25
16
|
/**
|
|
26
17
|
* Restore build cache if it exists.
|
|
27
18
|
* @param buildCachePath Build cache path.
|
|
@@ -36,30 +27,30 @@ const restoreBuildCache = (buildCachePath, serverCachePath) => {
|
|
|
36
27
|
* @param OGData OG data to save.
|
|
37
28
|
* @param buildCachePath Build cache path.
|
|
38
29
|
*/
|
|
39
|
-
const saveOGDataBuildCache = (url, OGData, buildCachePath) =>
|
|
30
|
+
const saveOGDataBuildCache = async (url, OGData, buildCachePath) => {
|
|
40
31
|
const filename = generateFilename(url, false);
|
|
41
32
|
const savePath = `${path.join(buildCachePath, filename)}.json`;
|
|
42
|
-
const cacheDirectoryExists =
|
|
33
|
+
const cacheDirectoryExists = await checkFileExists(buildCachePath);
|
|
43
34
|
if (!cacheDirectoryExists) {
|
|
44
|
-
|
|
35
|
+
await fs.mkdir(buildCachePath, { recursive: true });
|
|
45
36
|
}
|
|
46
|
-
|
|
47
|
-
}
|
|
37
|
+
await fs.writeFile(savePath, JSON.stringify(OGData));
|
|
38
|
+
};
|
|
48
39
|
/**
|
|
49
40
|
* Restore OG data from build cache.
|
|
50
41
|
* @param url URL of the OG data.
|
|
51
42
|
* @param buildCachePath Build cache path.
|
|
52
43
|
* @returns Restored OG data. If not found, returns `null`.
|
|
53
44
|
*/
|
|
54
|
-
const restoreOGDataBuildCache = (url, buildCachePath) =>
|
|
45
|
+
const restoreOGDataBuildCache = async (url, buildCachePath) => {
|
|
55
46
|
const filename = generateFilename(url, false);
|
|
56
47
|
const savePath = `${path.join(buildCachePath, filename)}.json`;
|
|
57
48
|
try {
|
|
58
|
-
const data =
|
|
49
|
+
const data = await fs.readFile(savePath, "utf-8");
|
|
59
50
|
return JSON.parse(data);
|
|
60
51
|
}
|
|
61
|
-
catch
|
|
52
|
+
catch {
|
|
62
53
|
return null;
|
|
63
54
|
}
|
|
64
|
-
}
|
|
55
|
+
};
|
|
65
56
|
export { saveBuildCacheFile, restoreBuildCache, saveOGDataBuildCache, restoreOGDataBuildCache };
|
package/dist/util/file.js
CHANGED
|
@@ -1,12 +1,3 @@
|
|
|
1
|
-
var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
|
|
2
|
-
function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
|
|
3
|
-
return new (P || (P = Promise))(function (resolve, reject) {
|
|
4
|
-
function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
|
|
5
|
-
function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
|
|
6
|
-
function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
|
|
7
|
-
step((generator = generator.apply(thisArg, _arguments || [])).next());
|
|
8
|
-
});
|
|
9
|
-
};
|
|
10
1
|
import { createHash } from "crypto";
|
|
11
2
|
import fs from "fs";
|
|
12
3
|
import path from "path";
|
|
@@ -15,15 +6,15 @@ import path from "path";
|
|
|
15
6
|
* @param filePath Path to check.
|
|
16
7
|
* @returns `true` if the file exists, `false` otherwise.
|
|
17
8
|
*/
|
|
18
|
-
const checkFileExists = (filePath) =>
|
|
9
|
+
const checkFileExists = async (filePath) => {
|
|
19
10
|
try {
|
|
20
|
-
|
|
11
|
+
await fs.promises.access(filePath);
|
|
21
12
|
return true;
|
|
22
13
|
}
|
|
23
|
-
catch
|
|
14
|
+
catch {
|
|
24
15
|
return false;
|
|
25
16
|
}
|
|
26
|
-
}
|
|
17
|
+
};
|
|
27
18
|
/**
|
|
28
19
|
* Check if the file exists.
|
|
29
20
|
* @param filePath Path to check.
|
package/dist/util/hast.d.ts
CHANGED
|
@@ -35,4 +35,4 @@ declare const createOGCard: (data: OGCardData, options: Required<{
|
|
|
35
35
|
decoding: RehypeOGCardOptions["decoding"];
|
|
36
36
|
openInNewTab: RehypeOGCardOptions["openInNewTab"];
|
|
37
37
|
}>) => Element;
|
|
38
|
-
export { AnchorElement, isTextNode, isAnchorElement, convertTextToAnchorElement, createOGCard };
|
|
38
|
+
export { type AnchorElement, isTextNode, isAnchorElement, convertTextToAnchorElement, createOGCard };
|
package/dist/util/hast.js
CHANGED
|
@@ -37,8 +37,7 @@ const createOGCard = (data, options) => {
|
|
|
37
37
|
target: "_blank"
|
|
38
38
|
};
|
|
39
39
|
const card = h("div.og-card-container", [
|
|
40
|
-
|
|
41
|
-
h("a", Object.assign({ href: data.url }, (options.openInNewTab ? openInNewTab : {})), [
|
|
40
|
+
h("a", { href: data.url, ...(options.openInNewTab ? openInNewTab : {}) }, [
|
|
42
41
|
h("div.og-card-info", [
|
|
43
42
|
h("div.og-card-title", data.title),
|
|
44
43
|
data.description ? h("div.og-card-description", data.description) : null,
|
|
@@ -57,6 +56,7 @@ const createOGCard = (data, options) => {
|
|
|
57
56
|
data.OGImageURL
|
|
58
57
|
? h("div.og-card-image-container", [
|
|
59
58
|
h("img.og-card-image", {
|
|
59
|
+
// eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing
|
|
60
60
|
alt: data.OGImageAlt || data.OGImageURL,
|
|
61
61
|
decoding: options.decoding,
|
|
62
62
|
height: data.OGImageHeight,
|
package/dist/util/network.js
CHANGED
|
@@ -1,12 +1,3 @@
|
|
|
1
|
-
var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
|
|
2
|
-
function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
|
|
3
|
-
return new (P || (P = Promise))(function (resolve, reject) {
|
|
4
|
-
function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
|
|
5
|
-
function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
|
|
6
|
-
function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
|
|
7
|
-
step((generator = generator.apply(thisArg, _arguments || [])).next());
|
|
8
|
-
});
|
|
9
|
-
};
|
|
10
1
|
import { checkFileExists, generateFilename } from "./file.js";
|
|
11
2
|
import fetch from "node-fetch";
|
|
12
3
|
import fs from "fs/promises";
|
|
@@ -27,7 +18,7 @@ const isValidURL = (url) => {
|
|
|
27
18
|
new URL(url);
|
|
28
19
|
return true;
|
|
29
20
|
}
|
|
30
|
-
catch
|
|
21
|
+
catch {
|
|
31
22
|
return false;
|
|
32
23
|
}
|
|
33
24
|
};
|
|
@@ -37,9 +28,9 @@ const isValidURL = (url) => {
|
|
|
37
28
|
* @param userAgent User agent to use for fetching.
|
|
38
29
|
* @returns OG card data.
|
|
39
30
|
*/
|
|
40
|
-
const getOGData = (url, userAgent) =>
|
|
31
|
+
const getOGData = async (url, userAgent) => {
|
|
41
32
|
try {
|
|
42
|
-
const { result } =
|
|
33
|
+
const { result } = await scraper({
|
|
43
34
|
fetchOptions: {
|
|
44
35
|
headers: {
|
|
45
36
|
"user-agent": userAgent
|
|
@@ -53,13 +44,14 @@ const getOGData = (url, userAgent) => __awaiter(void 0, void 0, void 0, function
|
|
|
53
44
|
: // eslint-disable-next-line no-undefined
|
|
54
45
|
undefined;
|
|
55
46
|
return {
|
|
56
|
-
OGImageAlt: OGImage
|
|
57
|
-
OGImageHeight: OGImage
|
|
58
|
-
OGImageURL: OGImage
|
|
59
|
-
OGImageWidth: OGImage
|
|
47
|
+
OGImageAlt: OGImage?.alt,
|
|
48
|
+
OGImageHeight: OGImage?.height,
|
|
49
|
+
OGImageURL: OGImage?.url,
|
|
50
|
+
OGImageWidth: OGImage?.width,
|
|
60
51
|
description: result.ogDescription,
|
|
61
52
|
displayURL: url,
|
|
62
53
|
faviconURL,
|
|
54
|
+
// eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing
|
|
63
55
|
title: result.ogTitle || url,
|
|
64
56
|
url
|
|
65
57
|
};
|
|
@@ -69,14 +61,14 @@ const getOGData = (url, userAgent) => __awaiter(void 0, void 0, void 0, function
|
|
|
69
61
|
console.error("[rehype-og-card] Error fetching OG data:", error);
|
|
70
62
|
return null;
|
|
71
63
|
}
|
|
72
|
-
}
|
|
64
|
+
};
|
|
73
65
|
/**
|
|
74
66
|
* Download image from given URL. If the image already exists, return the filename.
|
|
75
67
|
* @param options Options to download image.
|
|
76
68
|
* @returns Filename of the downloaded image.
|
|
77
69
|
*/
|
|
78
70
|
// eslint-disable-next-line max-statements
|
|
79
|
-
const downloadImage = (options) =>
|
|
71
|
+
const downloadImage = async (options) => {
|
|
80
72
|
if (!isValidURL(options.url)) {
|
|
81
73
|
// eslint-disable-next-line no-console
|
|
82
74
|
console.error("[rehype-og-card] Invalid thumbnail URL:", options.url);
|
|
@@ -86,23 +78,23 @@ const downloadImage = (options) => __awaiter(void 0, void 0, void 0, function* (
|
|
|
86
78
|
const filename = generateFilename(options.url);
|
|
87
79
|
const savePath = path.posix.join(options.directory, filename);
|
|
88
80
|
// If the file already exists, return the filename.
|
|
89
|
-
const fileExists =
|
|
81
|
+
const fileExists = await checkFileExists(savePath);
|
|
90
82
|
if (fileExists)
|
|
91
83
|
return filename;
|
|
92
|
-
const response =
|
|
84
|
+
const response = await fetch(options.url, {
|
|
93
85
|
headers: {
|
|
94
86
|
"user-agent": options.userAgent
|
|
95
87
|
},
|
|
96
88
|
// eslint-disable-next-line no-magic-numbers
|
|
97
89
|
signal: AbortSignal.timeout(10 * 1000)
|
|
98
90
|
});
|
|
99
|
-
const arrayBuffer =
|
|
91
|
+
const arrayBuffer = await response.arrayBuffer();
|
|
100
92
|
const buffer = Buffer.from(arrayBuffer);
|
|
101
|
-
const saveDirectoryExists =
|
|
93
|
+
const saveDirectoryExists = await checkFileExists(options.directory);
|
|
102
94
|
if (!saveDirectoryExists) {
|
|
103
|
-
|
|
95
|
+
await fs.mkdir(options.directory, { recursive: true });
|
|
104
96
|
}
|
|
105
|
-
|
|
97
|
+
await fs.writeFile(savePath, buffer);
|
|
106
98
|
return filename;
|
|
107
99
|
}
|
|
108
100
|
catch (error) {
|
|
@@ -110,5 +102,5 @@ const downloadImage = (options) => __awaiter(void 0, void 0, void 0, function* (
|
|
|
110
102
|
console.error("[rehype-og-card] Error downloading image:", error);
|
|
111
103
|
return null;
|
|
112
104
|
}
|
|
113
|
-
}
|
|
105
|
+
};
|
|
114
106
|
export { isValidURL, getOGData, downloadImage };
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "rehype-og-card",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.4",
|
|
4
4
|
"description": "Rehype plugin to convert text links to link cards",
|
|
5
5
|
"main": "./dist/index.js",
|
|
6
6
|
"types": "./dist/index.d.ts",
|
|
@@ -42,7 +42,8 @@
|
|
|
42
42
|
"devDependencies": {
|
|
43
43
|
"@changesets/changelog-github": "^0.5.0",
|
|
44
44
|
"@changesets/cli": "^2.27.7",
|
|
45
|
-
"@robot-inventor/eslint-config": "^
|
|
45
|
+
"@robot-inventor/eslint-config": "^5.0.0",
|
|
46
|
+
"@robot-inventor/tsconfig-base": "^1.1.0",
|
|
46
47
|
"@types/node": "^20.14.11",
|
|
47
48
|
"@types/sanitize-html": "^2.11.0",
|
|
48
49
|
"eslint": "^9.7.0",
|