@se-studio/core-ui 1.28.5 → 1.28.7

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @se-studio/core-ui
 
+## 1.28.7
+
+### Patch Changes
+
+- 0ab8467: Add `createOgImageHandler` so marketing `/og` routes feed Satori a 1200×630 JPEG Images API URL via `contentfulOgImageUrl`.
+
+## 1.28.6
+
+### Patch Changes
+
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.27.0
+
 ## 1.28.5
 
 ### Patch Changes

package/dist/route-handlers/createOgImageHandler.d.ts

@@ -0,0 +1,29 @@
+import type { ContentfulConfig } from '@se-studio/contentful-rest-api';
+export declare const OG_CACHE_CONTROL = "public, s-maxage=86400, stale-while-revalidate=604800";
+export declare const OG_PREVIEW_CACHE_CONTROL = "private, no-store";
+export interface OgImageHandlerConfig {
+    /**
+     * Function to get the Contentful configuration.
+     * Called on each request to allow for dynamic config.
+     */
+    getConfig: (preview?: boolean) => ContentfulConfig;
+    /** Whether to use the preview API. Defaults to false. */
+    preview?: boolean;
+}
+export interface OgImageRouteContext {
+    params: Promise<{
+        imageId: string;
+    }>;
+}
+/**
+ * Creates Next.js App Router GET and HEAD handlers for `/og/[imageId]`.
+ *
+ * Satori cannot decode WebP. The CMS asset is fetched, then `contentfulOgImageUrl`
+ * supplies a 1200×630 JPEG Images API URL as Satori `<img src>` only.
+ * Public og:image stays the site `/og/{id}.jpg` path.
+ */
+export declare function createOgImageHandler(config: OgImageHandlerConfig): {
+    GET: (request: Request, context: OgImageRouteContext) => Promise<Response>;
+    HEAD: (request: Request, context: OgImageRouteContext) => Promise<Response>;
+};
+//# sourceMappingURL=createOgImageHandler.d.ts.map

package/dist/route-handlers/createOgImageHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createOgImageHandler.d.ts","sourceRoot":"","sources":["../../src/route-handlers/createOgImageHandler.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAIvE,eAAO,MAAM,gBAAgB,0DAA0D,CAAC;AACxF,eAAO,MAAM,wBAAwB,sBAAsB,CAAC;AAE5D,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,SAAS,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,gBAAgB,CAAC;IACnD,yDAAyD;IACzD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtC;AA8DD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG;IAClE,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3E,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC7E,CAiFA"}

package/dist/route-handlers/createOgImageHandler.js

@@ -0,0 +1,122 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { contentfulAssetRest, contentfulOgImageUrl } from '@se-studio/contentful-rest-api';
+import { ImageResponse } from 'next/og';
+export const OG_CACHE_CONTROL = 'public, s-maxage=86400, stale-while-revalidate=604800';
+export const OG_PREVIEW_CACHE_CONTROL = 'private, no-store';
+/**
+ * Site og:image stays `/og/{assetId}.jpg` (see buildPageMetadata).
+ * Contentful Images API `fm=jpg` is Satori input only — do not put that URL in meta.
+ * JPEG drops alpha; featured images should be landscape photos or already-backed logos.
+ */
+async function resolveOgSource(imageId, config) {
+    const id = imageId.split('.')[0];
+    if (!id) {
+        return { ok: false, response: new Response('Invalid image ID', { status: 400 }) };
+    }
+    const preview = config.preview ?? false;
+    const cacheControl = preview ? OG_PREVIEW_CACHE_CONTROL : OG_CACHE_CONTROL;
+    const asset = await contentfulAssetRest(config.getConfig(preview), id, {
+        preview,
+        next: { revalidate: preview ? false : 86400 },
+    });
+    if (!asset?.fields?.file?.url) {
+        return { ok: false, response: new Response('Image not found', { status: 404 }) };
+    }
+    const imageUrl = contentfulOgImageUrl(asset.fields.file.url, {
+        contentType: asset.fields.file.contentType,
+    });
+    if (!imageUrl) {
+        return { ok: false, response: new Response('Image not found', { status: 404 }) };
+    }
+    return {
+        ok: true,
+        imageUrl,
+        title: asset.fields.title || 'Featured Image',
+        cacheControl,
+    };
+}
+async function assertOgSourceDecodable(imageUrl) {
+    const response = await fetch(imageUrl, {
+        cache: 'force-cache',
+        next: { revalidate: 86400 },
+    });
+    if (!response.ok) {
+        return false;
+    }
+    const type = response.headers.get('content-type')?.split(';')[0]?.trim() ?? '';
+    return type === 'image/jpeg' || type === 'image/jpg' || type === 'image/png';
+}
+function failedToGenerate() {
+    return new Response('Failed to generate image', { status: 500 });
+}
+/**
+ * Creates Next.js App Router GET and HEAD handlers for `/og/[imageId]`.
+ *
+ * Satori cannot decode WebP. The CMS asset is fetched, then `contentfulOgImageUrl`
+ * supplies a 1200×630 JPEG Images API URL as Satori `<img src>` only.
+ * Public og:image stays the site `/og/{id}.jpg` path.
+ */
+export function createOgImageHandler(config) {
+    async function GET(_request, { params }) {
+        const { imageId } = await params;
+        try {
+            const source = await resolveOgSource(imageId, config);
+            if (!source.ok) {
+                return source.response;
+            }
+            // Next ImageResponse defaults to max-age=0; options.headers override (Next 16.3).
+            return new ImageResponse(_jsx("div", { style: {
+                    display: 'flex',
+                    width: '100%',
+                    height: '100%',
+                    backgroundColor: '#000',
+                    alignItems: 'center',
+                    justifyContent: 'center',
+                }, children: _jsx("img", { src: source.imageUrl, alt: source.title, width: 1200, height: 630, style: {
+                        width: '100%',
+                        height: '100%',
+                        objectFit: 'cover',
+                    } }) }), {
+                width: 1200,
+                height: 630,
+                headers: {
+                    'Cache-Control': source.cacheControl,
+                },
+            });
+        }
+        catch (e) {
+            console.error('Error generating OG image:', e);
+            return failedToGenerate();
+        }
+    }
+    /**
+     * HEAD validates the JPEG Images API source (the WebP 500 cause) without running Satori.
+     * Status matches GET for missing/undecodable assets; GET still renders the PNG card.
+     */
+    async function HEAD(_request, { params }) {
+        const { imageId } = await params;
+        try {
+            const source = await resolveOgSource(imageId, config);
+            if (!source.ok) {
+                return source.response;
+            }
+            const decodable = await assertOgSourceDecodable(source.imageUrl);
+            if (!decodable) {
+                return failedToGenerate();
+            }
+            return new Response(null, {
+                status: 200,
+                headers: {
+                    'Content-Type': 'image/png',
+                    'Cache-Control': source.cacheControl,
+                },
+            });
+        }
+        catch (e) {
+            console.error('Error generating OG image:', e);
+            return failedToGenerate();
+        }
+    }
+    return { GET, HEAD };
+}
+//# sourceMappingURL=createOgImageHandler.js.map

package/dist/route-handlers/createOgImageHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createOgImageHandler.js","sourceRoot":"","sources":["../../src/route-handlers/createOgImageHandler.tsx"],"names":[],"mappings":"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"}

package/dist/route-handlers/index.d.ts

@@ -6,4 +6,6 @@ export type { GuidelinesHandlerOptions } from './createGuidelinesHandler';
 export { createGuidelinesHandler } from './createGuidelinesHandler';
 export type { MediaLibraryHandlerOptions } from './createMediaLibraryHandler';
 export { createMediaLibraryJsonHandler, createMediaLibraryMarkdownHandler, } from './createMediaLibraryHandler';
+export type { OgImageHandlerConfig, OgImageRouteContext } from './createOgImageHandler';
+export { createOgImageHandler, OG_CACHE_CONTROL, OG_PREVIEW_CACHE_CONTROL, } from './createOgImageHandler';
 //# sourceMappingURL=index.d.ts.map

package/dist/route-handlers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/route-handlers/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EACV,eAAe,EACf,UAAU,EACV,cAAc,EACd,uBAAuB,EACvB,iBAAiB,EACjB,aAAa,EACb,SAAS,EACT,OAAO,GACR,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,YAAY,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAC9E,OAAO,EACL,6BAA6B,EAC7B,iCAAiC,GAClC,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/route-handlers/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EACV,eAAe,EACf,UAAU,EACV,cAAc,EACd,uBAAuB,EACvB,iBAAiB,EACjB,aAAa,EACb,SAAS,EACT,OAAO,GACR,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,YAAY,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAC9E,OAAO,EACL,6BAA6B,EAC7B,iCAAiC,GAClC,MAAM,6BAA6B,CAAC;AACrC,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACxF,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,wBAAwB,CAAC"}

package/dist/route-handlers/index.js

@@ -2,4 +2,5 @@ export { createCmsTxtHandler } from './createCmsTxtHandler';
 export { createDiscoveryHandler } from './createDiscoveryHandler';
 export { createGuidelinesHandler } from './createGuidelinesHandler';
 export { createMediaLibraryJsonHandler, createMediaLibraryMarkdownHandler, } from './createMediaLibraryHandler';
+export { createOgImageHandler, OG_CACHE_CONTROL, OG_PREVIEW_CACHE_CONTROL, } from './createOgImageHandler';
 //# sourceMappingURL=index.js.map

package/dist/route-handlers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/route-handlers/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAW5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,OAAO,EACL,6BAA6B,EAC7B,iCAAiC,GAClC,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/route-handlers/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAW5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,OAAO,EACL,6BAA6B,EAC7B,iCAAiC,GAClC,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,wBAAwB,CAAC"}

package/docs/PACKAGE_EXPORT_BOUNDARIES.md

@@ -12,7 +12,7 @@ Next.js App Router mixes **Server Components** and **Client Components** (`'use
 |-------|----------------|----------|
 | `@se-studio/core-ui` | **Everyone** — `'use client'` files, server components, registrations | React UI, hooks, `cn`, CMS renderers, registration helpers, shared types |
 | `@se-studio/core-ui/server` | **Server only** — `import 'server-only'` at top | `createAppHelpers`, `createRouteHandlers`, `getRelated*`, `filterRelatedArticles`, listing structured-data helpers, etc. |
-| `@se-studio/core-ui/route-handlers` | **App route modules** (Node `fs`) | Discovery/guidelines/cms.txt handlers |
+| `@se-studio/core-ui/route-handlers` | **App route modules** (Node `fs`) | Discovery/guidelines/cms.txt/OG image handlers |
 
 **Do not add a `/client` entry** unless you want stricter enforcement. The main barrel *is* the client-safe surface; `/server` is the explicit server escape hatch.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@se-studio/core-ui",
-  "version": "1.28.5",
+  "version": "1.28.7",
   "description": "Shared React UI component library with Tailwind CSS v4 for SE Studio applications",
   "repository": {
     "type": "git",
@@ -76,7 +76,7 @@
     "@contentful/rich-text-react-renderer": "^16.2.2",
     "@contentful/rich-text-types": "^17.2.7",
     "@radix-ui/react-slot": "1.3.3",
-    "@se-studio/contentful-rest-api": "1.26.7",
+    "@se-studio/contentful-rest-api": "1.27.0",
     "@se-studio/core-data-types": "1.13.3",
     "@types/mustache": "4.2.6",
     "@vimeo/player": "^2.30.4",