* docs: README, CHANGELOG and the docs suite brought up to v2.0 - README.md (new): what the site is, stack, how the Worker fits together, getting started on Node 26, commands, deploying with Workers Builds, the admin, security and licensing. - CHANGELOG.md (new): v2.0.0 in Keep a Changelog form, plus a summary of the untagged 1.x months. - SECURITY.md: admin.poli0981.dev, the bot gate and the widgets worker are in scope; tagged releases; reports go to a private repository; what the admin stores. - THIRD-PARTY-NOTICES.md: every infrastructure service, with what each one is used for. CONTENT-LICENSE.md: the content submodule and /media images. - poli0981.dev-docs v2.0: decision log D16–D19; architecture (worker entry, stack, repo layout, dev setup, ADR 09–11); design system (Glacier Teal tokens, theme modes, a11y rules); security (headers, single-key CIDR denylist, body limits, secrets table, supply chain on a public repo, admin hardening and Access recommendations, structured logs); Cloudflare setup (correct Workers Builds commands and the deploy incident, ADMIN_EMAILS, Access settings, observability); CI/CD as it runs today; bug reports, widgets, error pages, routes, roadmap with status and next steps, maintenance (TypeScript 7 bumps, rollback, R2/KV backup). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * docs(changelog): link the documentation PR Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * fix(widgets): Steam icons via Steam's Cloudflare CDN; optional GitHub token Found by watching the first cron run of the new worker in production: no image had been mirrored and two sources were stale. - media.steampowered.com answers requests from Workers with 403, so every Steam icon mirror failed. cdn.cloudflare.steamstatic.com serves the same files to Workers (probed from Cloudflare's network). - The GitHub events API allows 60 unauthenticated requests an hour per IP and Workers share egress IPs, so the feed was 403 for hours at a time. The worker now sends GITHUB_TOKEN when that optional secret exists (a fine-grained token with no permissions is enough for public data). - YouTube's feeds/videos.xml currently answers 404 for both the channel and the uploads-playlist URL, from Cloudflare and from elsewhere; the worker already keeps the last good feed, so nothing changes there. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * fix(csp): callout styles were blocked; the CSP check now covers styles Lighthouse flagged a CSP violation on the one MDX post. Astro hashes the styles of the components a page renders, but not of a component that only appears inside MDX content: Callout's inline <style> shipped without its hash and the browser refused it, so callouts were unstyled in production. - Callout's rules move to src/styles/prose.css (the stylesheet Prose loads on every long-form page); the component has no <style> block any more. - scripts/check-csp-hashes.mjs now hashes every inline <style> block against the page's policy and fails on any style attribute (a policy without 'unsafe-inline' never allows one), with self-tests for both matchers. The build reports 339 style blocks across 64 pages, all hashed. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * chore(og): Number.parseInt in the colour mixer (Sonar S7773) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
156 lines
6.4 KiB
JavaScript
156 lines
6.4 KiB
JavaScript
// Build-time Open Graph image generation. Runs in Node (see src/lib/og.ts for why a
|
||
// prerendered endpoint can't do this). Reads content frontmatter, renders a 1200x630 card
|
||
// per entry with Satori + resvg, and writes to dist/client/og/<key>.png. File names come
|
||
// from ogKey() in src/lib/og.ts — the same function the pages use to link to them (Node
|
||
// runs the .ts file directly).
|
||
import satori from "satori";
|
||
import { html } from "satori-html";
|
||
import { Resvg } from "@resvg/resvg-js";
|
||
import { parse as parseYaml } from "yaml";
|
||
import { readFileSync, writeFileSync, mkdirSync, readdirSync } from "node:fs";
|
||
import { fileURLToPath } from "node:url";
|
||
import path from "node:path";
|
||
import { ogKey } from "../src/lib/og.ts";
|
||
import { PALETTE } from "../src/lib/palette.ts";
|
||
|
||
const root = fileURLToPath(new URL("..", import.meta.url));
|
||
const fontsDir = path.join(root, "src/assets/fonts");
|
||
const fonts = [
|
||
{
|
||
name: "Bricolage",
|
||
data: readFileSync(path.join(fontsDir, "BricolageGrotesque-Medium.ttf")),
|
||
weight: 500,
|
||
style: "normal",
|
||
},
|
||
{
|
||
name: "Bricolage",
|
||
data: readFileSync(path.join(fontsDir, "BricolageGrotesque-Bold.ttf")),
|
||
weight: 700,
|
||
style: "normal",
|
||
},
|
||
];
|
||
|
||
// Cards are always dark: they show up in feeds of either theme, and dark carries the
|
||
// brand. Colours come from the site palette (src/lib/palette.ts).
|
||
const C = PALETTE.dark;
|
||
|
||
/** `a` blended into `b` at `weight` (0–1), as #rrggbb — Satori has no color-mix(). */
|
||
function mix(a, b, weight) {
|
||
const rgb = (hex) => [1, 3, 5].map((i) => Number.parseInt(hex.slice(i, i + 2), 16));
|
||
const [x, y] = [rgb(a), rgb(b)];
|
||
return `#${x
|
||
.map((v, i) =>
|
||
Math.round(v * weight + y[i] * (1 - weight))
|
||
.toString(16)
|
||
.padStart(2, "0"),
|
||
)
|
||
.join("")}`;
|
||
}
|
||
|
||
const BADGES = {
|
||
blog: { vi: "Blog", en: "Blog" },
|
||
story: { vi: "Truyện", en: "Story" },
|
||
project: { vi: "Dự án", en: "Project" },
|
||
};
|
||
|
||
// The signature Waveline motif, as an inline SVG (Satori renders paths; resvg rasterizes).
|
||
const WAVE = `<svg width="240" height="26" viewBox="0 0 120 20" fill="none"><path d="M2 10 H30 L38 3 L50 17 L62 4 L74 15 L84 10 H118" stroke="${C.accent}" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round"/></svg>`;
|
||
|
||
function esc(s) {
|
||
return String(s).replace(/&/g, "&").replace(/</g, "<").replace(/>/g, ">");
|
||
}
|
||
|
||
const SHELL = (inner) =>
|
||
`<div style="display:flex; flex-direction:column; justify-content:space-between; width:1200px; height:630px; background:${C.bg}; padding:72px; font-family:Bricolage;">${inner}</div>`;
|
||
|
||
// NOTE: satori-html's `html` must be called as a function on a plain string —
|
||
// its tagged-template form escapes interpolated HTML fragments (the wave/strip).
|
||
function entryCard({ title, badge, cw }) {
|
||
const t = esc(title);
|
||
const size = t.length > 70 ? 50 : t.length > 45 ? 60 : 74;
|
||
const strip = cw
|
||
? `<div style="display:flex; align-items:center; align-self:flex-start; padding:6px 18px; border-radius:999px; background:${mix(C.horror, C.bg, 0.18)}; color:${C.horror}; font-size:22px; font-weight:500;">CW · ${esc(cw)}</div>`
|
||
: "";
|
||
return html(
|
||
SHELL(`
|
||
<div style="display:flex; align-items:center; justify-content:space-between;">
|
||
<div style="display:flex; padding:10px 22px; border:2px solid ${C.line}; border-radius:999px; color:${C.muted}; font-size:26px; font-weight:500;">${esc(badge)}</div>
|
||
${WAVE}
|
||
</div>
|
||
<div style="display:flex; flex-direction:column; gap:20px;">
|
||
${strip}
|
||
<span style="color:${C.text}; font-size:${size}px; font-weight:700; line-height:1.08;">${t}</span>
|
||
</div>
|
||
<div style="display:flex; justify-content:space-between; align-items:center;">
|
||
<span style="color:${C.accent}; font-size:30px; font-weight:700;">poli0981.dev</span>
|
||
<span style="color:${C.muted}; font-size:24px; font-weight:500;">Kokone · SkullMute</span>
|
||
</div>
|
||
`),
|
||
);
|
||
}
|
||
|
||
const defaultCard = html(
|
||
SHELL(`
|
||
<div style="display:flex; justify-content:flex-end;">${WAVE}</div>
|
||
<div style="display:flex; flex-direction:column; gap:14px;">
|
||
<span style="color:${C.text}; font-size:88px; font-weight:700;">Kokone · SkullMute</span>
|
||
<span style="color:${C.muted}; font-size:34px; font-weight:500;">~ dev & storyteller ~</span>
|
||
</div>
|
||
<div style="display:flex;"><span style="color:${C.accent}; font-size:30px; font-weight:700;">poli0981.dev</span></div>
|
||
`),
|
||
);
|
||
|
||
// Frontmatter only (the body is never needed here). gray-matter was dropped: its js-yaml@3 →
|
||
// argparse@1 → sprintf-js chain carries an advisory with no fixed version. YAML 1.2 core
|
||
// schema is fine — no date fields are read below.
|
||
function frontmatter(src) {
|
||
const m = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/.exec(src);
|
||
return (m && parseYaml(m[1])) || {};
|
||
}
|
||
|
||
async function render(node) {
|
||
const svg = await satori(node, { width: 1200, height: 630, fonts });
|
||
return new Resvg(svg, { fitTo: { mode: "width", value: 1200 } }).render().asPng();
|
||
}
|
||
|
||
const contentRoot = path.join(root, "src/content");
|
||
const outDir = path.join(root, "dist/client/og");
|
||
mkdirSync(outDir, { recursive: true });
|
||
|
||
const SECTIONS = [
|
||
{ dir: "blog", section: "blog", titleKey: "title" },
|
||
{ dir: "stories", section: "story", titleKey: "title" },
|
||
{ dir: "projects", section: "project", titleKey: "name" },
|
||
];
|
||
|
||
let count = 0;
|
||
for (const { dir, section, titleKey } of SECTIONS) {
|
||
const base = path.join(contentRoot, dir);
|
||
let files;
|
||
try {
|
||
files = readdirSync(base, { recursive: true });
|
||
} catch {
|
||
continue; // collection dir may not exist yet
|
||
}
|
||
for (const rel of files) {
|
||
const relPosix = String(rel).replace(/\\/g, "/");
|
||
if (!/\.(md|mdx)$/.test(relPosix)) continue;
|
||
if (path.basename(relPosix).startsWith("_")) continue;
|
||
const data = frontmatter(readFileSync(path.join(base, relPosix), "utf8"));
|
||
if (data.draft === true) continue;
|
||
const id = relPosix.replace(/\.(md|mdx)$/, "");
|
||
const lang = data.lang === "en" ? "en" : "vi";
|
||
const title = data[titleKey] ?? id;
|
||
const cw =
|
||
section === "story" && Array.isArray(data.contentWarning) && data.contentWarning.length
|
||
? data.contentWarning.join(" · ")
|
||
: null;
|
||
const png = await render(entryCard({ title, badge: BADGES[section][lang], cw }));
|
||
writeFileSync(path.join(outDir, `${ogKey(section, id)}.png`), png);
|
||
count++;
|
||
}
|
||
}
|
||
|
||
writeFileSync(path.join(outDir, "default.png"), await render(defaultCard));
|
||
console.log(`[og] generated ${count + 1} OG images → dist/client/og/`);
|