npm - webcake-landing-mcp - Versions diffs - 1.0.25 → 1.0.26 - Mend

webcake-landing-mcp 1.0.25 → 1.0.26

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.

Files changed (5) hide show

package/dist/changelog.json CHANGED Viewed

@@ -1,4 +1,11 @@
 [
+  {
+    "v": "1.0.26",
+    "d": "07/06/2026",
+    "type": "Added",
+    "en": "The HTTP server now serves a pre-rendered 1200×630 PNG social card at GET /og.png; the guide page's og:image and twitter:image meta tags now point…",
+    "vi": "HTTP server nay phục vụ ảnh social card PNG được render sẵn 1200×630 tại GET /og.png; các meta tag og:image và twitter:image của trang hướng dẫn nay…"
+  },
   {
     "v": "1.0.25",
     "d": "07/06/2026",
@@ -33,12 +40,5 @@
     "type": "Added",
     "en": "The HTTP server's GET / guide page is now bilingual (vi/en): append ?lang=en to the URL to switch to English (default is Vietnamese), a language…",
     "vi": "Trang hướng dẫn GET / của HTTP server nay hỗ trợ song ngữ (vi/en): thêm ?lang=en vào URL để chuyển sang tiếng Anh (mặc định là tiếng Việt), kèm nút…"
-  },
-  {
-    "v": "1.0.20",
-    "d": "07/06/2026",
-    "type": "Changed",
-    "en": "get_generation_guide now includes a Layout Archetypes block that maps seven page types (sales/COD, lead-gen/service, event/invitation, app/SaaS…",
-    "vi": "get_generation_guide now includes a Layout Archetypes block that maps seven page types (sales/COD, lead-gen/service, event/invitation, app/SaaS…"
   }
 ]

package/dist/http.js CHANGED Viewed

@@ -12,6 +12,7 @@
  * All logging stays on stderr (console.error), same as stdio mode.
  */
 import { randomUUID } from "node:crypto";
+import { readFileSync } from "node:fs";
 import { createServer as createHttpServer } from "node:http";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
@@ -19,6 +20,21 @@ import { createServer } from "./server.js";
 import { ICON_SVG, ICON_MIME } from "./branding.js";
 import { guideHtml, ogImageSvg, normalizeLang } from "./web-guide.js";
 const MCP_PATH = "/mcp";
+// The raster social card (1200x630), pre-rendered and committed at src/og.png,
+// mirrored to dist/og.png by copy-assets. Served at GET /og.png as the og:image —
+// SVG OG images don't unfurl on Facebook/X/LinkedIn/Zalo. Read once, lazily.
+let OG_PNG = null;
+function ogImagePng() {
+    if (OG_PNG)
+        return OG_PNG;
+    try {
+        OG_PNG = readFileSync(new URL("./og.png", import.meta.url));
+        return OG_PNG;
+    }
+    catch {
+        return null;
+    }
+}
 function sendJson(res, status, body) {
     res.writeHead(status, { "content-type": "application/json" });
     res.end(JSON.stringify(body));
@@ -75,6 +91,18 @@ export async function startHttpServer(port) {
             return res.end(ICON_SVG);
         }
         // Social-card image referenced by the landing page's og:image / twitter:image.
+        // PNG is the canonical og:image (unfurls everywhere); the SVG stays for clients
+        // that prefer it (Slack/Telegram/Discord) and as a fallback if og.png is absent.
+        if (req.method === "GET" && path === "/og.png") {
+            const png = ogImagePng();
+            if (png) {
+                res.writeHead(200, { "content-type": "image/png", "cache-control": "public, max-age=86400" });
+                return res.end(png);
+            }
+            // Fall back to the SVG card if the raster asset didn't ship.
+            res.writeHead(200, { "content-type": ICON_MIME, "cache-control": "public, max-age=86400" });
+            return res.end(ogImageSvg());
+        }
         if (req.method === "GET" && path === "/og.svg") {
             res.writeHead(200, { "content-type": ICON_MIME, "cache-control": "public, max-age=86400" });
             return res.end(ogImageSvg());

package/dist/og.png ADDED Viewed

Binary file

package/dist/web-guide.js CHANGED Viewed

@@ -16,7 +16,9 @@
  * It's also built to be *shareable*: a full SEO `<head>` (description, canonical,
  * Open Graph, Twitter Card, JSON-LD for SoftwareApplication + WebSite + FAQPage)
  * so links unfurl nicely on social/chat and the page can be indexed. The social
- * card image is served separately at `/og.svg` (see `ogImageSvg`, wired in http.ts).
+ * card image is a pre-rendered 1200x630 PNG at `/og.png` (committed src/og.png,
+ * regenerated by scripts/render-og.mjs from `ogImageSvg`) — PNG because SVG OG
+ * images don't unfurl on Facebook/X/LinkedIn/Zalo. `/og.svg` is still served too.
  *
  * Self-contained (inline CSS + the Webcake icon, no external assets/fonts/trackers)
  * so it loads instantly and leaks nothing.
@@ -333,7 +335,8 @@ export function guideHtml(origin, lang = "vi") {
     const m = META[L];
     const faq = FAQ[L];
     const endpoint = `${origin}/mcp`;
-    const ogImage = `${origin}/og.svg`;
+    // PNG (not SVG) so the card unfurls on Facebook/X/LinkedIn/Zalo; served by http.ts.
+    const ogImage = `${origin}/og.png`;
     const selfPath = L === "en" ? "?lang=en" : "/";
     const otherLang = L === "vi" ? "en" : "vi";
     const otherHref = otherLang === "en" ? "?lang=en" : "?lang=vi";
@@ -396,14 +399,17 @@ export function guideHtml(origin, lang = "vi") {
 <meta property="og:description" content="${m.desc}">
 <meta property="og:url" content="${canonical}">
 <meta property="og:image" content="${ogImage}">
+<meta property="og:image:type" content="image/png">
 <meta property="og:image:width" content="1200">
 <meta property="og:image:height" content="630">
+<meta property="og:image:alt" content="${m.title}">
 <meta property="og:locale" content="${m.locale}">
 <meta property="og:locale:alternate" content="${META[otherLang].locale}">
 <meta name="twitter:card" content="summary_large_image">
 <meta name="twitter:title" content="${m.title}">
 <meta name="twitter:description" content="${m.desc}">
 <meta name="twitter:image" content="${ogImage}">
+<meta name="twitter:image:alt" content="${m.title}">
 <script type="application/ld+json">${jsonLdScript}</script>
 <style>
   /* Light defaults. Dark applies via OS preference OR a forced [data-theme="dark"]
@@ -751,11 +757,13 @@ export function guideHtml(origin, lang = "vi") {
 </body></html>`;
 }
 /**
- * The social-card image served at `/og.svg` and referenced by the page's
- * `og:image` / `twitter:image`. A self-contained 1200×630 branded SVG (the size
- * social scrapers expect) — no external fonts/assets. Slack, Telegram, LinkedIn,
- * Discord render SVG OG images; a few (older Twitter/Facebook) may skip it, which
- * is acceptable for a dependency-free server.
+ * The social-card source: a self-contained 1200×630 branded SVG (the size social
+ * scrapers expect) — no external fonts/assets. This is the SOURCE that
+ * scripts/render-og.mjs rasterizes into the committed src/og.png used as the
+ * canonical `og:image` / `twitter:image` (PNG unfurls on Facebook/X/LinkedIn/Zalo
+ * where SVG doesn't). Still served verbatim at `/og.svg` for SVG-friendly clients
+ * (Slack/Telegram/Discord) and as the http.ts fallback. EDIT THIS, then re-run
+ * scripts/render-og.mjs and commit the regenerated PNG.
  */
 export function ogImageSvg() {
     return `<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="630" viewBox="0 0 1200 630" fill="none" font-family="system-ui,-apple-system,Segoe UI,Roboto,sans-serif">

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "webcake-landing-mcp",
-  "version": "1.0.25",
+  "version": "1.0.26",
   "description": "MCP server exposing Webcake landing-page element schemas + AI usage hints, and persisting LLM-generated page sources to a Webcake backend.",
   "type": "module",
   "bin": {