@xingwangzhe/stalux 1.49.0 → 1.51.0

package/src/utils/social-image.ts

@@ -1,4 +1,5 @@
 import { createHash } from "node:crypto";
+import { loadSharp } from "../internal/sharp-loader";
 
 export interface SocialCardData {
     title: string;
@@ -7,12 +8,13 @@ export interface SocialCardData {
     author: string;
     host: string;
     lang: string;
-    accent: string;
     date: string;
     category: string;
     cover?: string;
 }
 
+export type SocialCardFormat = "jpg" | "png";
+
 export interface SocialImage {
     url: string;
     width?: number;
@@ -35,13 +37,23 @@ export function isSocialImageUrl(value: string): boolean {
     }
 }
 
+/**
+ * Cards with artwork are photographic, so JPEG saves most of the bytes and is
+ * accepted by every crawler. Plain cards stay PNG: flat type compresses far
+ * better there. Without `sharp` neither palette PNG nor JPEG is available, so
+ * the card falls back to a plain PNG.
+ */
+export function socialCardFormat(data: Pick<SocialCardData, "cover">): SocialCardFormat {
+    return data.cover && loadSharp() ? "jpg" : "png";
+}
+
 export function socialCardPath(data: SocialCardData, base = "/"): string {
     // Bump the template revision when layout changes. Metadata changes get a fresh URL.
     const hash = createHash("sha256")
-        .update(JSON.stringify(["stalux-takumi-v2", data]))
+        .update(JSON.stringify(["stalux-mono-v1", data]))
         .digest("hex")
         .slice(0, 20);
-    return `${base.replace(/\/$/u, "")}/og/${hash}.png`;
+    return `${base.replace(/\/$/u, "")}/og/${hash}.${socialCardFormat(data)}`;
 }
 
 export function resolvePostSocialImage(
@@ -50,14 +62,11 @@ export function resolvePostSocialImage(
     base = "/",
 ): SocialImage {
     if (explicit?.trim() && isSocialImageUrl(explicit.trim())) return { url: explicit.trim() };
-    // PNG for the sharing image, always. Several platforms (and every legacy
-    // crawler) refuse WebP or AVIF in og:image, so this is the one place the
-    // modern format costs reach instead of saving bytes. In-page images are
-    // served as WebP instead, where the browser decides.
+    const format = socialCardFormat(data);
     return {
         url: socialCardPath(data, base),
         width: 1200,
         height: 630,
-        type: "image/png",
+        type: format === "jpg" ? "image/jpeg" : "image/png",
     };
 }