@rimelight/seo 0.0.6 → 0.0.8

package/dist/routes/icon-maskable-512.png.mjs

@@ -0,0 +1,18 @@
+import { generateMaskablePng } from "../assets.mjs";
+import { backgroundColor, masterIconBuffer } from "virtual:rimelight-seo/assets";
+//#region src/routes/icon-maskable-512.png.ts
+const prerender = true;
+const GET = async () => {
+	if (!masterIconBuffer) return new Response(null, { status: 404 });
+	const png = await generateMaskablePng(masterIconBuffer, {
+		size: 512,
+		background: backgroundColor || "#ffffff",
+		paddingRatio: .15
+	});
+	return new Response(new Uint8Array(png), { headers: {
+		"Content-Type": "image/png",
+		"Cache-Control": "public, max-age=31536000, immutable"
+	} });
+};
+//#endregion
+export { GET, prerender };

package/dist/routes/llms.txt.mjs

@@ -1,8 +1,8 @@
 import { buildLlmsTxt } from "../llms.mjs";
+import seoOptions from "virtual:rimelight-seo/options";
 import * as siteConfigMod from "virtual:rimelight-seo/site-config";
 import * as dbMod from "virtual:rimelight-seo/db";
 import * as corpusMod from "virtual:rimelight-seo/corpus";
-import seoOptions from "virtual:rimelight-seo/options";
 //#region src/routes/llms.txt.ts
 const prerender = false;
 const GET = async ({ site, url }) => {

package/dist/routes/robots.txt.mjs

@@ -1,6 +1,6 @@
 import { buildRobotsTxt } from "../robots.mjs";
-import * as siteConfigMod from "virtual:rimelight-seo/site-config";
 import seoOptions from "virtual:rimelight-seo/options";
+import * as siteConfigMod from "virtual:rimelight-seo/site-config";
 import * as seoConfig from "virtual:rimelight-seo/config";
 //#region src/routes/robots.txt.ts
 const GET = ({ site, url }) => {

package/dist/routes/rss.xml.mjs

@@ -1,7 +1,7 @@
 import { buildRssXml } from "../rss.mjs";
+import seoOptions from "virtual:rimelight-seo/options";
 import * as siteConfigMod from "virtual:rimelight-seo/site-config";
 import * as dbMod from "virtual:rimelight-seo/db";
-import seoOptions from "virtual:rimelight-seo/options";
 import * as seoConfig from "virtual:rimelight-seo/config";
 //#region src/routes/rss.xml.ts
 const GET = async ({ site, url }) => {
@@ -10,29 +10,57 @@ const GET = async ({ site, url }) => {
 	const siteUrl = site ? site.toString() : rssOpts.site || siteConfig.url || url.origin;
 	let items = [];
 	if (Array.isArray(rssOpts.items)) items = rssOpts.items;
+	else if (typeof rssOpts.items === "function") items = await rssOpts.items();
 	else if (typeof seoConfig.rssEntries === "function") items = await seoConfig.rssEntries();
-	else if (dbMod.db) try {
-		const { pages } = await import("#db/schema").catch(() => ({ pages: null }));
-		const { and, isNull, sql } = await import("drizzle-orm");
-		if (pages) items = (await dbMod.db.select().from(pages).where(and(sql`${pages.type} = 'blog'`, isNull(pages.deletedAt))).catch(() => [])).map((p) => {
+	else {
+		const normalizedCollections = (rssOpts.collections && rssOpts.collections.length > 0 ? rssOpts.collections : [
+			"blog",
+			"posts",
+			"news",
+			"articles"
+		]).map((c) => {
+			if (typeof c === "string") return {
+				name: c,
+				pathPrefix: `/${c.replace(/^\/+|\/+$/g, "")}`
+			};
 			return {
-				title: typeof p.title === "string" ? p.title : p.title?.en || p.title && Object.values(p.title)[0] || p.slug,
-				description: typeof p.description === "string" ? p.description : p.description?.en || p.description && Object.values(p.description)[0] || "",
-				link: `/blog/${p.slug}`,
-				pubDate: p.postedAt || p.createdAt || /* @__PURE__ */ new Date()
+				name: c.name,
+				pathPrefix: c.pathPrefix ? `/${c.pathPrefix.replace(/^\/+|\/+$/g, "")}` : `/${c.name.replace(/^\/+|\/+$/g, "")}`
 			};
 		});
-	} catch {}
-	if (items.length === 0) try {
-		const { getCollection } = await import("astro:content");
-		const blog = await getCollection("blog");
-		if (Array.isArray(blog)) items = blog.map((post) => ({
-			title: post.data?.title || post.id,
-			pubDate: post.data?.pubDate || /* @__PURE__ */ new Date(),
-			description: post.data?.description,
-			link: `/blog/${post.id}/`
-		}));
-	} catch {}
+		if (dbMod.db) try {
+			const { pages } = await import("#db/schema").catch(() => ({ pages: null }));
+			const { and, isNull } = await import("drizzle-orm");
+			if (pages) {
+				const collectionNames = normalizedCollections.map((c) => c.name);
+				const prefixMap = new Map(normalizedCollections.map((c) => [c.name, c.pathPrefix]));
+				const matchingPages = (await dbMod.db.select().from(pages).where(and(isNull(pages.deletedAt))).catch(() => [])).filter((p) => collectionNames.includes(p.type));
+				for (const p of matchingPages) {
+					const prefix = prefixMap.get(p.type) || `/${p.type}`;
+					const title = typeof p.title === "string" ? p.title : p.title?.en || p.title && Object.values(p.title)[0] || p.slug;
+					const description = typeof p.description === "string" ? p.description : p.description?.en || p.description && Object.values(p.description)[0] || "";
+					items.push({
+						title,
+						description,
+						link: `${prefix}/${p.slug}`,
+						pubDate: p.postedAt || p.createdAt || /* @__PURE__ */ new Date()
+					});
+				}
+			}
+		} catch {}
+		if (items.length === 0) try {
+			const { getCollection } = await import("astro:content");
+			for (const coll of normalizedCollections) try {
+				const collEntries = await getCollection(coll.name);
+				if (Array.isArray(collEntries)) for (const post of collEntries) items.push({
+					title: post.data?.title || post.id,
+					pubDate: post.data?.pubDate || post.data?.date || /* @__PURE__ */ new Date(),
+					description: post.data?.description || post.data?.summary,
+					link: `${coll.pathPrefix}/${post.id}/`
+				});
+			} catch {}
+		} catch {}
+	}
 	const feedTitle = rssOpts.title || siteConfig.name || "RSS Feed";
 	const feedDesc = rssOpts.description || siteConfig.description || "";
 	const xml = buildRssXml({

package/dist/routes/security.txt.d.mts

@@ -0,0 +1,5 @@
+import { APIRoute } from "astro";
+//#region src/routes/security.txt.d.ts
+export declare const prerender = false;
+export declare const GET: APIRoute;
+//#endregion

package/dist/routes/security.txt.mjs

@@ -0,0 +1,24 @@
+import { buildSecurityTxt } from "../security.mjs";
+import seoOptions from "virtual:rimelight-seo/options";
+import * as siteConfigMod from "virtual:rimelight-seo/site-config";
+//#region src/routes/security.txt.ts
+const prerender = false;
+const GET = ({ site, url }) => {
+	const siteConfig = siteConfigMod.siteConfig || {};
+	const siteUrl = site ? site.toString() : siteConfig.url || url.origin;
+	const secOpts = typeof seoOptions?.security === "object" ? seoOptions.security : {};
+	const defaultContact = siteConfig.email ? `mailto:${siteConfig.email}` : void 0;
+	const contacts = secOpts.contact || defaultContact || `mailto:security@${new URL(siteUrl).hostname}`;
+	const canonical = secOpts.canonical || new URL("/.well-known/security.txt", siteUrl).toString();
+	const content = buildSecurityTxt({
+		contact: contacts,
+		canonical,
+		...secOpts
+	});
+	return new Response(content, { headers: {
+		"Content-Type": "text/plain; charset=utf-8",
+		"Cache-Control": "public, max-age=86400, stale-while-revalidate=604800"
+	} });
+};
+//#endregion
+export { GET, prerender };

package/dist/routes/site.webmanifest.d.mts

@@ -0,0 +1,5 @@
+import { APIRoute } from "astro";
+//#region src/routes/site.webmanifest.d.ts
+export declare const prerender = false;
+export declare const GET: APIRoute;
+//#endregion

package/dist/routes/site.webmanifest.mjs

@@ -0,0 +1,23 @@
+import { buildWebManifest } from "../manifest.mjs";
+import seoOptions from "virtual:rimelight-seo/options";
+import * as siteConfigMod from "virtual:rimelight-seo/site-config";
+//#region src/routes/site.webmanifest.ts
+const prerender = false;
+const GET = () => {
+	const siteConfig = siteConfigMod.siteConfig || {};
+	const manifestOpts = typeof seoOptions?.manifest === "object" ? seoOptions.manifest : {};
+	const manifest = buildWebManifest({
+		name: manifestOpts.name || siteConfig.name || "Site",
+		shortName: manifestOpts.shortName || siteConfig.name || "Site",
+		description: manifestOpts.description || siteConfig.description || "",
+		backgroundColor: manifestOpts.backgroundColor || siteConfig.branding?.colors?.backgroundColor || "#ffffff",
+		themeColor: manifestOpts.themeColor || siteConfig.branding?.colors?.themeColor || "#ffffff",
+		...manifestOpts
+	});
+	return new Response(JSON.stringify(manifest, null, 2), { headers: {
+		"Content-Type": "application/manifest+json; charset=utf-8",
+		"Cache-Control": "public, max-age=86400, stale-while-revalidate=604800"
+	} });
+};
+//#endregion
+export { GET, prerender };

package/dist/routes/sitemap.xml.mjs

@@ -1,6 +1,6 @@
 import { buildSitemapUrls, buildSitemapXml } from "../sitemap.mjs";
-import * as siteConfigMod from "virtual:rimelight-seo/site-config";
 import seoOptions from "virtual:rimelight-seo/options";
+import * as siteConfigMod from "virtual:rimelight-seo/site-config";
 import * as seoConfig from "virtual:rimelight-seo/config";
 //#region src/routes/sitemap.xml.ts
 const GET = async ({ site, url }) => {

package/dist/security.d.mts

@@ -0,0 +1,7 @@
+import { SecurityTxtOptions } from "./types.mjs";
+//#region src/security.d.ts
+/**
+ * Build RFC 9116 compliant security.txt content. https://www.rfc-editor.org/rfc/rfc9116
+ */
+export declare function buildSecurityTxt(options: SecurityTxtOptions): string;
+//#endregion

package/dist/security.mjs

@@ -0,0 +1,34 @@
+//#region src/security.ts
+/**
+* Build RFC 9116 compliant security.txt content. https://www.rfc-editor.org/rfc/rfc9116
+*/
+function buildSecurityTxt(options) {
+	const lines = [];
+	const contacts = Array.isArray(options.contact) ? options.contact : options.contact ? [options.contact] : [];
+	for (const contact of contacts) lines.push(`Contact: ${contact}`);
+	let expiresStr;
+	if (options.expires instanceof Date) expiresStr = options.expires.toISOString();
+	else if (typeof options.expires === "string" && options.expires.trim().length > 0) expiresStr = options.expires;
+	else {
+		const oneYearFromNow = /* @__PURE__ */ new Date();
+		oneYearFromNow.setFullYear(oneYearFromNow.getFullYear() + 1);
+		expiresStr = oneYearFromNow.toISOString();
+	}
+	lines.push(`Expires: ${expiresStr}`);
+	if (options.encryption) {
+		const encList = Array.isArray(options.encryption) ? options.encryption : [options.encryption];
+		for (const enc of encList) lines.push(`Encryption: ${enc}`);
+	}
+	if (options.acknowledgments) {
+		const acks = Array.isArray(options.acknowledgments) ? options.acknowledgments : [options.acknowledgments];
+		for (const ack of acks) lines.push(`Acknowledgments: ${ack}`);
+	}
+	if (options.preferredLanguages) lines.push(`Preferred-Languages: ${options.preferredLanguages}`);
+	if (options.canonical) lines.push(`Canonical: ${options.canonical}`);
+	if (options.policy) lines.push(`Policy: ${options.policy}`);
+	if (options.hiring) lines.push(`Hiring: ${options.hiring}`);
+	if (options.csaf) lines.push(`CSAF: ${options.csaf}`);
+	return lines.join("\n") + "\n";
+}
+//#endregion
+export { buildSecurityTxt };

package/dist/types.d.mts

@@ -1,5 +1,5 @@
 import { n as BreadcrumbItem, t as ArticleSchemaOptions } from "./schema-C8v69blQ.mjs";
-import { n as LlmsPage, r as LlmsTxtOptions$1, t as LlmsFullTxtOptions$1 } from "./llms-BVLxzjr-.mjs";
+import { n as LlmsPage, r as LlmsTxtOptions, t as LlmsFullTxtOptions } from "./llms-BVLxzjr-.mjs";
 //#region src/types.d.ts
 /**
  * Change frequency for sitemap entries
@@ -115,16 +115,17 @@ export interface SiteConfig {
   name: string;
   description: string;
   url: string;
-  ogImage: string;
+  ogImage?: string;
   author: string;
   email: string;
   branding: {
     logo: {
       alt: string;
     };
-    favicon: {
+    favicon?: {
       svg: string;
     };
+    icon?: string;
     colors: {
       themeColor: string;
       backgroundColor: string;
@@ -132,7 +133,7 @@ export interface SiteConfig {
   };
   seo: {
     titleTemplate: string;
-    ogImageFallback: string;
+    ogImageFallback?: string;
     maxDescriptionLength: number;
     authorHandle?: string;
   };
@@ -290,15 +291,23 @@ export interface RssFeedOptions {
   language?: string;
   items: RssItem[];
 }
-export interface RssOptions extends Partial<RssFeedOptions> {
+export interface RssCollectionConfig {
+  name: string;
+  pathPrefix?: string;
+}
+export interface RssOptions extends Omit<Partial<RssFeedOptions>, "items"> {
   /**
    * Custom RSS route pattern (default: "/rss.xml")
    */
   path?: string;
   /**
-   * Custom items loader
+   * Custom items loader or static items array
+   */
+  items?: RssItem[] | (() => Promise<RssItem[]> | RssItem[]);
+  /**
+   * Collections to include in RSS feed (defaults to ["blog", "posts", "news", "articles"])
    */
-  items?: RssItem[];
+  collections?: (string | RssCollectionConfig)[];
 }
 export interface SitemapOptions {
   /**
@@ -310,6 +319,125 @@ export interface SitemapOptions {
   locales?: LocaleConfig;
   [key: string]: unknown;
 }
+export interface SecurityTxtOptions {
+  /**
+   * Contact URI or list of contact URIs (e.g. "mailto:security@example.com") - REQUIRED by RFC 9116
+   */
+  contact: string | string[];
+  /**
+   * Expiration date/time (ISO 8601 string or Date) - REQUIRED by RFC 9116
+   */
+  expires?: Date | string;
+  /**
+   * URI to PGP/GPG public key
+   */
+  encryption?: string | string[];
+  /**
+   * URI to security acknowledgments / hall of fame
+   */
+  acknowledgments?: string | string[];
+  /**
+   * Comma-separated list of preferred languages (e.g. "en, pt")
+   */
+  preferredLanguages?: string;
+  /**
+   * Canonical URI of the security.txt file
+   */
+  canonical?: string;
+  /**
+   * URI to security policy
+   */
+  policy?: string;
+  /**
+   * URI to security hiring page
+   */
+  hiring?: string;
+  /**
+   * URI to Common Security Advisory Framework (CSAF) provider
+   */
+  csaf?: string;
+}
+export interface SecurityRouteOptions extends Partial<SecurityTxtOptions> {
+  /**
+   * Route pattern (default: "/.well-known/security.txt")
+   */
+  path?: string;
+  /**
+   * Whether to also inject legacy fallback route at "/security.txt" (default: true)
+   */
+  legacyRoute?: boolean;
+}
+export interface WebManifestIcon {
+  src: string;
+  sizes: string;
+  type: string;
+  purpose?: "any" | "maskable" | "monochrome";
+}
+export interface WebManifestShortcut {
+  name: string;
+  url: string;
+  short_name?: string;
+  description?: string;
+  icons?: WebManifestIcon[];
+}
+export interface WebManifest {
+  name: string;
+  short_name?: string;
+  description?: string;
+  start_url: string;
+  display: "fullscreen" | "standalone" | "minimal-ui" | "browser";
+  background_color: string;
+  theme_color: string;
+  icons: WebManifestIcon[];
+  shortcuts?: WebManifestShortcut[];
+  categories?: string[];
+  lang?: string;
+  dir?: "auto" | "ltr" | "rtl";
+  orientation?: "any" | "natural" | "landscape" | "portrait";
+  scope?: string;
+  [key: string]: unknown;
+}
+export interface WebManifestOptions {
+  name: string;
+  shortName?: string;
+  description?: string;
+  startUrl?: string;
+  display?: "fullscreen" | "standalone" | "minimal-ui" | "browser";
+  backgroundColor?: string;
+  themeColor?: string;
+  icons?: WebManifestIcon[];
+  shortcuts?: WebManifestShortcut[];
+  categories?: string[];
+  lang?: string;
+  dir?: "auto" | "ltr" | "rtl";
+  orientation?: "any" | "natural" | "landscape" | "portrait";
+  scope?: string;
+}
+export interface ManifestRouteOptions extends Partial<WebManifestOptions> {
+  /**
+   * Route pattern (default: "/site.webmanifest")
+   */
+  path?: string;
+}
+export interface ApiCatalogItem {
+  rel: string;
+  href: string;
+  type?: string;
+  title?: string;
+  [key: string]: unknown;
+}
+export interface ApiCatalog {
+  "api-catalog": ApiCatalogItem[];
+}
+export interface ApiCatalogOptions {
+  items: ApiCatalogItem[];
+}
+export interface ApiCatalogRouteOptions extends Partial<ApiCatalogOptions> {
+  /**
+   * Route pattern (default: "/.well-known/api-catalog")
+   */
+  path?: string;
+}
 export interface RobotsRouteOptions extends Partial<RobotsOptions> {
   /**
    * Route pattern (default: "/robots.txt")
@@ -328,6 +456,42 @@ export interface LlmsFullRouteOptions extends Partial<LlmsFullTxtOptions> {
    */
   path?: string;
 }
+export interface AssetRouteOptions {
+  /**
+   * Path to the master SVG/PNG icon file (relative to project root or absolute). If omitted, will
+   * search in src/assets/logos/ or siteConfig.branding.icon.
+   */
+  icon?: string;
+  /**
+   * Background color for maskable icons (defaults to siteConfig.branding.colors.backgroundColor or
+   * #ffffff)
+   */
+  backgroundColor?: string;
+  /**
+   * Whether to inject /favicon.ico (default: true)
+   */
+  faviconIco?: boolean;
+  /**
+   * Whether to inject /apple-touch-icon.png (default: true)
+   */
+  appleTouchIcon?: boolean;
+  /**
+   * Whether to inject /icon-192.png (default: true)
+   */
+  icon192?: boolean;
+  /**
+   * Whether to inject /icon-512.png (default: true)
+   */
+  icon512?: boolean;
+  /**
+   * Whether to inject /icon-maskable-512.png (default: true)
+   */
+  iconMaskable?: boolean;
+  /**
+   * Whether to generate and emit /og.png branded card (default: true)
+   */
+  ogImage?: boolean;
+}
 export interface RimelightSeoOptions {
   /**
    * Sitemap configuration or false to disable automatic /sitemap.xml (default: true)
@@ -349,6 +513,25 @@ export interface RimelightSeoOptions {
    * LLMs-full.txt configuration or false to disable automatic /llms-full.txt (default: true)
    */
   llmsFull?: boolean | LlmsFullRouteOptions;
+  /**
+   * Security.txt configuration or false to disable automatic /.well-known/security.txt (default:
+   * true)
+   */
+  security?: boolean | SecurityRouteOptions;
+  /**
+   * RFC 9652 API Catalog configuration or false to disable automatic /.well-known/api-catalog
+   * (default: true)
+   */
+  apiCatalog?: boolean | ApiCatalogRouteOptions;
+  /**
+   * Web App Manifest configuration or false to disable automatic /site.webmanifest (default: true)
+   */
+  manifest?: boolean | ManifestRouteOptions;
+  /**
+   * Automatic generation of compliant public image assets (favicon.ico, apple-touch-icon.png, PWA
+   * icons) from a single master icon (default: true)
+   */
+  assets?: boolean | AssetRouteOptions;
 }
 //#endregion
-export type { ArticleSchemaOptions, BreadcrumbItem, LlmsFullTxtOptions$1 as LlmsFullTxtOptions, LlmsPage, LlmsTxtOptions$1 as LlmsTxtOptions };
+export type { ArticleSchemaOptions, BreadcrumbItem, LlmsFullTxtOptions, LlmsPage, LlmsTxtOptions };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rimelight/seo",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "private": false,
   "description": "Rimelight Entertainment's SEO Package",
   "homepage": "https://rimelight.com/docs",
@@ -45,10 +45,26 @@
       "types": "./dist/rss.d.mts",
       "import": "./dist/rss.mjs"
     },
+    "./security": {
+      "types": "./dist/security.d.mts",
+      "import": "./dist/security.mjs"
+    },
+    "./manifest": {
+      "types": "./dist/manifest.d.mts",
+      "import": "./dist/manifest.mjs"
+    },
+    "./catalog": {
+      "types": "./dist/catalog.d.mts",
+      "import": "./dist/catalog.mjs"
+    },
     "./og": {
       "types": "./dist/og.d.mts",
       "import": "./dist/og.mjs"
     },
+    "./assets": {
+      "types": "./dist/assets.d.mts",
+      "import": "./dist/assets.mjs"
+    },
     "./components/*": "./src/components/*",
     "./routes/*": "./src/routes/*",
     "./*": "./src/*"
@@ -56,16 +72,26 @@
   "publishConfig": {
     "access": "public"
   },
+  "scripts": {
+    "build": "vp pack",
+    "prepack": "pnpm run build",
+    "check": "vp check --fix && astro check"
+  },
   "devDependencies": {
-    "@rimelight/config": "0.0.8",
+    "@rimelight/config": "workspace:*",
     "astro": "7.3.2",
+    "sharp": "^0.35.4",
     "typescript": "6.0.3"
   },
   "peerDependencies": {
     "astro": ">=7.0.0",
+    "sharp": ">=0.33.0",
     "takumi-js": ">=2.0.0"
   },
   "peerDependenciesMeta": {
+    "sharp": {
+      "optional": true
+    },
     "takumi-js": {
       "optional": true
     }
@@ -73,8 +99,5 @@
   "engines": {
     "node": ">=26.8.2"
   },
-  "scripts": {
-    "build": "vp pack",
-    "check": "vp check --fix && astro check"
-  }
-}
+  "packageManager": "pnpm@12.4.1"
+}

package/src/assets.test.ts

@@ -0,0 +1,70 @@
+import { describe, it, expect } from "vite-plus/test"
+import { generatePng, generateMaskablePng, generateIco, generateOgCard } from "./assets.js"
+import sharp from "sharp"
+
+const sampleSvg = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100" width="100" height="100">
+  <circle cx="50" cy="50" r="40" fill="#ff0000" />
+</svg>`
+
+describe("Asset Generation", () => {
+  it("generates PNG buffer with correct dimensions", async () => {
+    const pngBuffer = await generatePng(Buffer.from(sampleSvg), { width: 192, height: 192 })
+    expect(pngBuffer).toBeInstanceOf(Buffer)
+
+    const meta = await sharp(pngBuffer).metadata()
+    expect(meta.format).toBe("png")
+    expect(meta.width).toBe(192)
+    expect(meta.height).toBe(192)
+  })
+
+  it("generates maskable PNG buffer with padding and background", async () => {
+    const maskableBuffer = await generateMaskablePng(Buffer.from(sampleSvg), {
+      size: 512,
+      background: "#123456"
+    })
+    expect(maskableBuffer).toBeInstanceOf(Buffer)
+
+    const meta = await sharp(maskableBuffer).metadata()
+    expect(meta.format).toBe("png")
+    expect(meta.width).toBe(512)
+    expect(meta.height).toBe(512)
+  })
+
+  it("generates valid .ico buffer containing PNG data", async () => {
+    const icoBuffer = await generateIco(Buffer.from(sampleSvg), 32)
+    expect(icoBuffer).toBeInstanceOf(Buffer)
+    expect(icoBuffer.length).toBeGreaterThan(22)
+
+    // Verify ICO header
+    expect(icoBuffer.readUInt16LE(0)).toBe(0) // Reserved
+    expect(icoBuffer.readUInt16LE(2)).toBe(1) // Type = 1 (ICO)
+    expect(icoBuffer.readUInt16LE(4)).toBe(1) // 1 image
+
+    // Verify directory entry
+    expect(icoBuffer.readUInt8(6)).toBe(32) // Width
+    expect(icoBuffer.readUInt8(7)).toBe(32) // Height
+    expect(icoBuffer.readUInt16LE(10)).toBe(1) // Planes
+    expect(icoBuffer.readUInt16LE(12)).toBe(32) // 32 bpp
+    expect(icoBuffer.readUInt32LE(18)).toBe(22) // Offset = 22
+
+    // Verify PNG payload inside ICO
+    const pngSlice = icoBuffer.subarray(22)
+    const meta = await sharp(pngSlice).metadata()
+    expect(meta.format).toBe("png")
+    expect(meta.width).toBe(32)
+    expect(meta.height).toBe(32)
+  })
+
+  it("generates standard 1200x630 OG card buffer", async () => {
+    const ogBuffer = await generateOgCard({
+      logoBuffer: Buffer.from(sampleSvg),
+      background: "#0a0a0a"
+    })
+    expect(ogBuffer).toBeInstanceOf(Buffer)
+
+    const meta = await sharp(ogBuffer).metadata()
+    expect(meta.format).toBe("png")
+    expect(meta.width).toBe(1200)
+    expect(meta.height).toBe(630)
+  })
+})