@djangocfg/nextjs 2.1.536 → 2.1.539

package/README.md

@@ -23,7 +23,7 @@
 
 ## Features
 
-- **Page Metadata + OG Images** — one factory for complete page metadata; static or dynamically-rendered OG images via Django's `django_ogimage` (`@djangocfg/nextjs/og-image`)
+- **Page Metadata + OG Images** — one factory for complete page metadata: titles, canonical + hreflang, OpenGraph, Twitter, icons (`@djangocfg/nextjs/og-image`)
 - **i18n** — full next-intl integration with routing, middleware, and components
 - **PWA** — zero-config service worker and manifest
 - **Base Next.js Config** — reusable `createBaseNextConfig()` factory for monorepos
@@ -391,8 +391,7 @@ export const GET = createHealthHandler({
 
 One factory per app builds complete page `Metadata` (title, openGraph, twitter,
 canonical + hreflang, icons). The OG image is chosen by a single `og` field —
-static brand image by default, dynamic title-rendered card on demand. No Edge
-Runtime, no `@vercel/og`:
+the static brand image by default, or an exact URL:
 
 ```tsx
 // app/_core/metadata.ts — bind once
@@ -407,11 +406,13 @@ export const createMetadata = makeMetadataFactory({
 
 // landing page → static brand image (default)
 export const metadata = createMetadata({ title: 'Pricing', path: '/pricing' })
-// content page → render the title onto the card
-export const metadata = createMetadata({ title: post.title, path, og: 'dynamic' })
+// content page with its own image
+export const metadata = createMetadata({ title: p.name, path, og: { image: p.image } })
 ```
 
-The dynamic URL is resolved automatically from `NEXT_PUBLIC_MEDIA_URL` → `NEXT_PUBLIC_API_URL` → `NEXT_PUBLIC_SITE_URL`. Django renders and caches the PNG — no Edge Runtime or `@vercel/og` required.
+For a card rendered per page, add an `opengraph-image` route — Next.js finds it
+by filename and its output overrides whatever the factory set, so the factory
+has no "dynamic" case of its own.
 
 ### Navigation Utilities
 
@@ -461,7 +462,7 @@ import { RedirectPage } from '@djangocfg/layouts/components/RedirectPage';
 | `@djangocfg/nextjs/pwa/worker` | Service worker creation helpers |
 | `@djangocfg/nextjs/sitemap` | Sitemap generation with i18n hreflang support |
 | `@djangocfg/nextjs/health` | Health check handlers |
-| `@djangocfg/nextjs/og-image` | Page metadata factory + static/dynamic OG images for Django's `django_ogimage` |
+| `@djangocfg/nextjs/og-image` | Page metadata factory — titles, canonical + hreflang, OpenGraph, Twitter, icons |
 | `@djangocfg/nextjs/navigation` | Route definitions, menu generation, navigation helpers |
 
 ## API Reference
@@ -623,17 +624,16 @@ createHealthHandler({
 
 ### Page Metadata + OG Image
 
-`@djangocfg/nextjs/og-image` builds complete page metadata and OG images for
-Django's `django_ogimage` renderer. No Edge Runtime, no `@vercel/og`, no JSX
-templates — Django renders and caches the PNG.
+`@djangocfg/nextjs/og-image` builds complete page metadata: title templating,
+canonical + hreflang alternates, OpenGraph, Twitter cards and icons.
 
 See [`src/og-image/README.md`](./src/og-image/README.md) for full docs (the `og`
-axis, `SiteMetaConfig`/`PageMeta` fields, URL resolution, deployment examples).
+axis, `SiteMetaConfig`/`PageMeta` fields).
 
 #### `makeMetadataFactory(config)` — recommended
 
 Binds a `SiteMetaConfig` once; returns a per-page factory. The OG image is set by
-the single `og` field: `'static'` (default) · `'dynamic'` · `{ render }` · `{ image, alt? }`.
+the single `og` field: `'static'` (default) · `{ image, alt? }`.
 
 ```tsx
 import { makeMetadataFactory } from '@djangocfg/nextjs/og-image'
@@ -643,23 +643,21 @@ export const createMetadata = makeMetadataFactory({
   ogImage: '/static/ogimage.png', locales: LOCALES,
 })
 
-export const metadata = createMetadata({ title: 'About', path: '/about' })          // static
-export const metadata = createMetadata({ title: post.title, path, og: 'dynamic' })  // rendered title
+export const metadata = createMetadata({ title: 'About', path: '/about' })      // brand image
+export const metadata = createMetadata({ title: p.name, og: { image: p.image } })
 ```
 
-#### Low-level (escape hatches)
+#### Per-page rendered cards
 
-`withOgImage(metadata, params)` merges a dynamic OG image into existing metadata;
-`createOgMetadata(params)` returns the `{ openGraph, twitter }` fragment;
-`buildOgUrl(params)` returns the raw URL string; `resolveOgImage(spec, …)` is the
-`OgSpec` decision point. Most pages use `createMetadata` and never touch these.
+Use Next.js's `opengraph-image` file convention. It is discovered by filename
+and overrides metadata, so this package needs no support for it — and offering
+a second route to the same tag would only create a conflict.
 
-```tsx
-import { buildOgUrl } from '@djangocfg/nextjs/og-image'
-const url = buildOgUrl({ title: 'Hello', preset: 'DARK_BLUE' })
-```
+#### Low-level (escape hatches)
 
-**URL resolution** (`NEXT_PUBLIC_MEDIA_URL` → `NEXT_PUBLIC_API_URL` → `NEXT_PUBLIC_SITE_URL` → relative).
+`resolveOgImage(spec, staticUrl, fallbackTitle)` is the `OgSpec` decision point;
+`extractTitle(metadata)` reads a plain title out of Next.js's title shapes. Most
+pages use `createMetadata` and never touch these.
 
 ### Navigation
 

package/dist/og-image/index.d.mts

@@ -1,41 +1,20 @@
 import { Metadata } from 'next';
 
-type OGPreset = 'DARK' | 'DARK_BLUE' | 'DARK_PURPLE' | 'DARK_GREEN' | 'DARK_ROSE' | 'LIGHT' | 'LIGHT_GRAY' | 'LIGHT_WARM' | 'LIGHT_GREEN';
-type OGLayout = 'DEFAULT' | 'HERO' | 'ARTICLE' | 'MINIMAL';
 /**
  * Per-page OG image intent — the single axis that decides what the OG image is.
- * A discriminated union so every case is explicit and type-checked:
  *
  *   'static'              brand image from site config (the default)
- *   'dynamic'             render the page title onto the OG card
- *   { render: {...} }     render with explicit preset/layout/colors
  *   { image, alt? }       an exact image URL (e.g. a content screenshot)
+ *
+ * There is deliberately no "render this title onto a card" case. That was
+ * served by a Django endpoint (`/cfg/og/<base64>/`), archived 2026-09-03 —
+ * Next.js renders such cards itself via an `opengraph-image` route, which
+ * needs no metadata support because the file convention IS the registration.
  */
-type OgSpec = 'static' | 'dynamic' | {
-    render: Omit<OGImageParams, 'title'> & {
-        title?: string;
-    };
-} | {
+type OgSpec = 'static' | {
     image: string;
     alt?: string;
 };
-/** Mirrors Django OGImageParams exactly */
-interface OGImageParams {
-    title: string;
-    description?: string;
-    locale?: string;
-    style?: 'dark' | 'light';
-    bg_color?: string;
-    bg_color2?: string;
-    text_color?: string;
-    accent_color?: string;
-    /** e.g. "1200x630" */
-    size?: string;
-    preset?: OGPreset;
-    layout?: OGLayout;
-    /** Excluded from cache key on Django side */
-    page_url?: string;
-}
 
 /**
  * Site-wide identity the metadata factory needs. Config-agnostic on purpose —
@@ -51,16 +30,6 @@ interface SiteMetaConfig {
     siteUrl: string;
     /** Ready-made static brand OG image URL (absolute or root-relative). */
     ogImage: string;
-    /**
-     * Django origin that serves the dynamic OG renderer (`/cfg/og/`), e.g.
-     * "https://api.example.com". Required for `og: 'dynamic'` / `{ render }`.
-     *
-     * - set    → dynamic OG images render against this origin
-     * - `''`   → no backend: dynamic specs fall back to the static brand image
-     *            (use this for a frontend with no Django, so no broken URLs)
-     * - omit   → fall back to env vars (MEDIA_URL → API_URL → SITE_URL)
-     */
-    ogBackend?: string;
     /** Optional favicon / apple-touch icons forwarded to Metadata.icons. */
     icons?: Metadata['icons'];
     /** Locales for hreflang alternates. Omit for single-locale sites. */
@@ -89,9 +58,10 @@ interface PageMeta {
     /**
      * What the OG image should be. Defaults to `'static'` (the brand image).
      * - `'static'`          brand image from config (default)
-     * - `'dynamic'`         render the page title onto the card
-     * - `{ render: {...} }` render with explicit preset/layout/colors
      * - `{ image, alt? }`   an exact image URL (e.g. a content screenshot)
+     *
+     * For a per-page rendered card, add an `opengraph-image` route instead —
+     * Next.js finds it by filename and it overrides whatever is set here.
      */
     og?: OgSpec;
     /** Escape hatch: extra Metadata fields merged last (robots, authors, etc.). */
@@ -117,8 +87,6 @@ interface PageMeta {
  *
  *   // landing page — static brand image (default)
  *   export const metadata = createMetadata({ title: 'Pricing', path: '/pricing' })
- *   // content page — title rendered onto the card
- *   export const metadata = createMetadata({ title: post.title, path, og: 'dynamic' })
  *   // content page with its own image
  *   export const metadata = createMetadata({ title: p.name, og: { image: p.image } })
  */
@@ -129,48 +97,19 @@ declare function createMetadata(config: SiteMetaConfig, page?: PageMeta): Metada
  */
 declare function makeMetadataFactory(config: SiteMetaConfig): (page?: PageMeta) => Metadata;
 
-/**
- * Builds an absolute (or relative) OG image URL pointing to Django's
- * django_ogimage endpoint: /cfg/og/<base64params>/
- *
- * The URL is suitable for use in og:image and twitter:image meta tags.
- *
- * @param base Optional explicit backend origin (e.g. "https://api.example.com").
- *   When omitted, it's resolved from env (MEDIA_URL → API_URL → SITE_URL → '').
- *   Pass the `ogBackend` from your site config to avoid relying on env.
- */
-declare function buildOgUrl(params: OGImageParams, base?: string): string;
-
-/**
- * Metadata fragment whose OG image is rendered by Django's django_ogimage
- * endpoint (/cfg/og/). Low-level — most callers use `createMetadata`'s `og`
- * field instead.
- */
-declare function createOgMetadata(params: OGImageParams): Metadata;
 /** Extract a plain title string from Next.js's title shapes. */
 declare function extractTitle(metadata: Metadata): string;
 /**
- * Resolves an `OgSpec` against a base Metadata into a concrete og/twitter image
- * fragment. `staticUrl` is the site's brand image, used for the `'static'` case.
- *
- * `backend` is the Django origin that serves the dynamic renderer. The dynamic
- * cases (`'dynamic'`, `{ render }`) require it: when it's `undefined`/empty —
- * e.g. a frontend with no Django backend — they **fall back to the static brand
- * image** instead of emitting a broken `/cfg/og/` URL. (`undefined` still lets
- * `buildOgUrl` fall back to env vars; pass `''` to force the static fallback.)
+ * Resolves an `OgSpec` into a concrete og/twitter image fragment. `staticUrl`
+ * is the site's brand image, used for the `'static'` case.
  *
  * This is the single decision point for "what is the OG image" — no other code
  * branches on the spec.
- */
-declare function resolveOgImage(spec: OgSpec, staticUrl: string, fallbackTitle: string, backend?: string): Pick<Metadata, 'openGraph' | 'twitter'>;
-/**
- * Merges OG image metadata (dynamic render) into existing Metadata. Kept for
- * low-level/manual use; `createMetadata` is the recommended entry point.
  *
- *   return withOgImage({ title: 'Page' }, { preset: 'DARK_BLUE' })
+ * To render a per-page card instead, add an `opengraph-image` route: Next.js
+ * discovers it by filename and overrides whatever is set here, so it needs no
+ * support from this function.
  */
-declare function withOgImage(metadata: Metadata, params?: Omit<OGImageParams, 'title'> & {
-    title?: string;
-}): Metadata;
+declare function resolveOgImage(spec: OgSpec, staticUrl: string, fallbackTitle: string): Pick<Metadata, 'openGraph' | 'twitter'>;
 
-export { type OGImageParams, type OGLayout, type OGPreset, type OgSpec, type PageMeta, type SiteMetaConfig, buildOgUrl, createMetadata, createOgMetadata, extractTitle, makeMetadataFactory, resolveOgImage, withOgImage };
+export { type OgSpec, type PageMeta, type SiteMetaConfig, createMetadata, extractTitle, makeMetadataFactory, resolveOgImage };

package/dist/og-image/index.mjs

@@ -1,27 +1,3 @@
-// src/og-image/url.ts
-function resolveOgPublicBase() {
-  if (typeof process === "undefined") return "";
-  return process.env.NEXT_PUBLIC_MEDIA_URL?.replace(/\/$/, "") ?? process.env.NEXT_PUBLIC_API_URL?.replace(/\/$/, "") ?? process.env.NEXT_PUBLIC_SITE_URL?.replace(/\/$/, "") ?? "";
-}
-function encodeBase64(str) {
-  if (typeof Buffer !== "undefined") {
-    return Buffer.from(str).toString("base64url");
-  }
-  return btoa(unescape(encodeURIComponent(str))).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
-}
-function cleanParams(params) {
-  return Object.fromEntries(
-    Object.entries(params).filter(
-      ([, v]) => v !== void 0 && v !== null && v !== ""
-    )
-  );
-}
-function buildOgUrl(params, base) {
-  const b64 = encodeBase64(JSON.stringify(cleanParams(params)));
-  const origin = (base ?? resolveOgPublicBase()).replace(/\/$/, "");
-  return `${origin}/cfg/og/${b64}/`;
-}
-
 // src/og-image/metadata.ts
 var OG_WIDTH = 1200;
 var OG_HEIGHT = 630;
@@ -34,9 +10,6 @@ function ogImageFragment(url, alt) {
     twitter: { card: "summary_large_image", images: [url] }
   };
 }
-function createOgMetadata(params) {
-  return ogImageFragment(buildOgUrl(params), params.title);
-}
 function extractTitle(metadata) {
   const t = metadata.title;
   if (!t) return "";
@@ -45,28 +18,11 @@ function extractTitle(metadata) {
   if (typeof t === "object" && "default" in t) return t.default;
   return "";
 }
-function resolveOgImage(spec, staticUrl, fallbackTitle, backend) {
-  const canRenderDynamic = backend === void 0 || backend !== "";
+function resolveOgImage(spec, staticUrl, fallbackTitle) {
   if (spec === "static") {
     return ogImageFragment(staticUrl, fallbackTitle);
   }
-  if (spec === "dynamic") {
-    return canRenderDynamic ? ogImageFragment(buildOgUrl({ title: fallbackTitle }, backend), fallbackTitle) : ogImageFragment(staticUrl, fallbackTitle);
-  }
-  if ("image" in spec) {
-    return ogImageFragment(spec.image, spec.alt ?? fallbackTitle);
-  }
-  const title = spec.render.title ?? fallbackTitle;
-  return canRenderDynamic ? ogImageFragment(buildOgUrl({ ...spec.render, title }, backend), title) : ogImageFragment(staticUrl, title);
-}
-function withOgImage(metadata, params = {}) {
-  const title = params.title ?? extractTitle(metadata);
-  const frag = createOgMetadata({ ...params, title });
-  return {
-    ...metadata,
-    openGraph: { ...metadata.openGraph, ...frag.openGraph },
-    twitter: { ...metadata.twitter, ...frag.twitter }
-  };
+  return ogImageFragment(spec.image, spec.alt ?? fallbackTitle);
 }
 
 // src/og-image/metadata-factory.ts
@@ -93,7 +49,7 @@ function createMetadata(config, page = {}) {
   const locale = page.locale ?? config.defaultLocale ?? "en";
   const path = page.path ?? "";
   const ogUrl = buildUrl(config.siteUrl, config.locales?.length ? locale : void 0, path);
-  const ogImage = resolveOgImage(page.og ?? "static", config.ogImage, title, config.ogBackend);
+  const ogImage = resolveOgImage(page.og ?? "static", config.ogImage, title);
   const metadata = {
     title,
     description,
@@ -127,12 +83,9 @@ function makeMetadataFactory(config) {
   return (page = {}) => createMetadata(config, page);
 }
 export {
-  buildOgUrl,
   createMetadata,
-  createOgMetadata,
   extractTitle,
   makeMetadataFactory,
-  resolveOgImage,
-  withOgImage
+  resolveOgImage
 };
 //# sourceMappingURL=index.mjs.map

package/dist/og-image/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/og-image/url.ts","../../src/og-image/metadata.ts","../../src/og-image/metadata-factory.ts"],"sourcesContent":["import type { OGImageParams } from './types'\n\n/**\n * Resolves the base URL for og:image meta tags.\n * Must be publicly accessible by crawlers (Twitter, Facebook, etc).\n *\n * Priority:\n * 1. NEXT_PUBLIC_MEDIA_URL — explicit media domain (nginx proxy or CDN)\n * 2. NEXT_PUBLIC_API_URL   — direct Django API domain\n * 3. NEXT_PUBLIC_SITE_URL  — site domain (same-domain/static build)\n * 4. ''                    — relative URL (last resort)\n *\n * Use cases:\n * - Same domain (static build):   API_URL='' → relative /cfg/og/...\n * - Split domain (standalone):    API_URL=https://api.x.com → absolute\n * - Media via nginx proxy:        MEDIA_URL=https://x.com, API_URL=https://api.x.com\n * - CDN:                          MEDIA_URL=https://cdn.x.com\n */\nfunction resolveOgPublicBase(): string {\n  if (typeof process === 'undefined') return ''\n  return (\n    process.env.NEXT_PUBLIC_MEDIA_URL?.replace(/\\/$/, '') ??\n    process.env.NEXT_PUBLIC_API_URL?.replace(/\\/$/, '') ??\n    process.env.NEXT_PUBLIC_SITE_URL?.replace(/\\/$/, '') ??\n    ''\n  )\n}\n\nfunction encodeBase64(str: string): string {\n  if (typeof Buffer !== 'undefined') {\n    return Buffer.from(str).toString('base64url')\n  }\n  // Browser fallback\n  return btoa(unescape(encodeURIComponent(str)))\n    .replace(/\\+/g, '-')\n    .replace(/\\//g, '_')\n    .replace(/=+$/, '')\n}\n\nfunction cleanParams(params: OGImageParams): Record<string, unknown> {\n  return Object.fromEntries(\n    Object.entries(params).filter(\n      ([, v]) => v !== undefined && v !== null && v !== ''\n    )\n  )\n}\n\n/**\n * Builds an absolute (or relative) OG image URL pointing to Django's\n * django_ogimage endpoint: /cfg/og/<base64params>/\n *\n * The URL is suitable for use in og:image and twitter:image meta tags.\n *\n * @param base Optional explicit backend origin (e.g. \"https://api.example.com\").\n *   When omitted, it's resolved from env (MEDIA_URL → API_URL → SITE_URL → '').\n *   Pass the `ogBackend` from your site config to avoid relying on env.\n */\nexport function buildOgUrl(params: OGImageParams, base?: string): string {\n  const b64 = encodeBase64(JSON.stringify(cleanParams(params)))\n  const origin = (base ?? resolveOgPublicBase()).replace(/\\/$/, '')\n  return `${origin}/cfg/og/${b64}/`\n}\n","import type { Metadata } from 'next'\nimport type { OGImageParams, OgSpec } from './types'\nimport { buildOgUrl } from './url'\n\nconst OG_WIDTH = 1200\nconst OG_HEIGHT = 630\n\n/** A Next.js OG image entry. */\nfunction imageEntry(url: string, alt: string) {\n  return { url, width: OG_WIDTH, height: OG_HEIGHT, alt }\n}\n\n/**\n * Builds the og/twitter image fragment for a given image URL — the one place\n * that knows the shape Next.js expects. Both static URLs and the dynamic\n * renderer funnel through here, so there's a single source of truth.\n */\nfunction ogImageFragment(url: string, alt: string): Pick<Metadata, 'openGraph' | 'twitter'> {\n  return {\n    openGraph: { images: [imageEntry(url, alt)] },\n    twitter: { card: 'summary_large_image', images: [url] },\n  }\n}\n\n/**\n * Metadata fragment whose OG image is rendered by Django's django_ogimage\n * endpoint (/cfg/og/). Low-level — most callers use `createMetadata`'s `og`\n * field instead.\n */\nexport function createOgMetadata(params: OGImageParams): Metadata {\n  return ogImageFragment(buildOgUrl(params), params.title)\n}\n\n/** Extract a plain title string from Next.js's title shapes. */\nexport function extractTitle(metadata: Metadata): string {\n  const t = metadata.title\n  if (!t) return ''\n  if (typeof t === 'string') return t\n  if (typeof t === 'object' && 'absolute' in t) return (t as { absolute: string }).absolute\n  if (typeof t === 'object' && 'default' in t) return (t as { default: string }).default\n  return ''\n}\n\n/**\n * Resolves an `OgSpec` against a base Metadata into a concrete og/twitter image\n * fragment. `staticUrl` is the site's brand image, used for the `'static'` case.\n *\n * `backend` is the Django origin that serves the dynamic renderer. The dynamic\n * cases (`'dynamic'`, `{ render }`) require it: when it's `undefined`/empty —\n * e.g. a frontend with no Django backend — they **fall back to the static brand\n * image** instead of emitting a broken `/cfg/og/` URL. (`undefined` still lets\n * `buildOgUrl` fall back to env vars; pass `''` to force the static fallback.)\n *\n * This is the single decision point for \"what is the OG image\" — no other code\n * branches on the spec.\n */\nexport function resolveOgImage(\n  spec: OgSpec,\n  staticUrl: string,\n  fallbackTitle: string,\n  backend?: string\n): Pick<Metadata, 'openGraph' | 'twitter'> {\n  const canRenderDynamic = backend === undefined || backend !== ''\n\n  if (spec === 'static') {\n    return ogImageFragment(staticUrl, fallbackTitle)\n  }\n  if (spec === 'dynamic') {\n    return canRenderDynamic\n      ? ogImageFragment(buildOgUrl({ title: fallbackTitle }, backend), fallbackTitle)\n      : ogImageFragment(staticUrl, fallbackTitle)\n  }\n  if ('image' in spec) {\n    return ogImageFragment(spec.image, spec.alt ?? fallbackTitle)\n  }\n  // { render: {...} } — dynamic with explicit params; title defaults to page title.\n  const title = spec.render.title ?? fallbackTitle\n  return canRenderDynamic\n    ? ogImageFragment(buildOgUrl({ ...spec.render, title }, backend), title)\n    : ogImageFragment(staticUrl, title)\n}\n\n/**\n * Merges OG image metadata (dynamic render) into existing Metadata. Kept for\n * low-level/manual use; `createMetadata` is the recommended entry point.\n *\n *   return withOgImage({ title: 'Page' }, { preset: 'DARK_BLUE' })\n */\nexport function withOgImage(\n  metadata: Metadata,\n  params: Omit<OGImageParams, 'title'> & { title?: string } = {}\n): Metadata {\n  const title = params.title ?? extractTitle(metadata)\n  const frag = createOgMetadata({ ...params, title })\n  return {\n    ...metadata,\n    openGraph: { ...metadata.openGraph, ...frag.openGraph },\n    twitter: { ...metadata.twitter, ...frag.twitter },\n  }\n}\n","import type { Metadata } from 'next'\nimport type { OgSpec } from './types'\nimport { resolveOgImage } from './metadata'\n\n/**\n * Site-wide identity the metadata factory needs. Config-agnostic on purpose —\n * the package doesn't know about any app's `settings` object, so the consumer\n * passes these once (typically derived from their own settings module).\n */\nexport interface SiteMetaConfig {\n  /** Brand / app name, e.g. \"CMDOP\". Used in titles, siteName, alt text. */\n  name: string\n  /** Default description used when a page doesn't supply its own. */\n  description: string\n  /** Absolute site origin, e.g. \"https://cmdop.com\". Used for canonical/og url. */\n  siteUrl: string\n  /** Ready-made static brand OG image URL (absolute or root-relative). */\n  ogImage: string\n  /**\n   * Django origin that serves the dynamic OG renderer (`/cfg/og/`), e.g.\n   * \"https://api.example.com\". Required for `og: 'dynamic'` / `{ render }`.\n   *\n   * - set    → dynamic OG images render against this origin\n   * - `''`   → no backend: dynamic specs fall back to the static brand image\n   *            (use this for a frontend with no Django, so no broken URLs)\n   * - omit   → fall back to env vars (MEDIA_URL → API_URL → SITE_URL)\n   */\n  ogBackend?: string\n  /** Optional favicon / apple-touch icons forwarded to Metadata.icons. */\n  icons?: Metadata['icons']\n  /** Locales for hreflang alternates. Omit for single-locale sites. */\n  locales?: readonly string[]\n  /** Locale used for x-default hreflang (defaults to \"en\" or first locale). */\n  defaultLocale?: string\n}\n\n/**\n * Per-page inputs. Only `title` is really worth setting per page; everything\n * else falls back to the site config.\n */\nexport interface PageMeta {\n  /** Page title (without the brand suffix). Falls back to the site name. */\n  title?: string\n  /** Page description; falls back to the site description. */\n  description?: string\n  keywords?: string[]\n  /** Current locale, used for canonical + openGraph.locale + alternates. */\n  locale?: string\n  /**\n   * Path without locale prefix, e.g. \"/skills\" or \"/skills/foo\". Home is ''\n   * (or '/'). Leading/trailing slashes are normalized, so both canonical and\n   * og:url come out well-formed whichever you pass.\n   */\n  path?: string\n  /**\n   * What the OG image should be. Defaults to `'static'` (the brand image).\n   * - `'static'`          brand image from config (default)\n   * - `'dynamic'`         render the page title onto the card\n   * - `{ render: {...} }` render with explicit preset/layout/colors\n   * - `{ image, alt? }`   an exact image URL (e.g. a content screenshot)\n   */\n  og?: OgSpec\n  /** Escape hatch: extra Metadata fields merged last (robots, authors, etc.). */\n  extra?: Metadata\n}\n\n/**\n * Joins the site origin, an optional locale segment, and a page path into one\n * absolute URL.\n *\n * This is the SINGLE place the URL shape is decided. `canonical` and\n * `openGraph.url` describe the same page, so they must be built by the same\n * function — when they were two hand-rolled template literals they drifted\n * apart (one inserted a slash the other didn't), and a page shipped a canonical\n * and an og:url pointing at two different URLs.\n *\n * Contract (see `PageMeta.path`): `path` carries its own leading slash —\n * \"/skills\", \"/skills/foo\" — and home is '' (we also tolerate '/'). Segments\n * are normalized rather than trusted, so a stray or missing slash at a call\n * site cannot produce \"site.com//skills\" or \"site.comskills\".\n */\nfunction buildUrl(siteUrl: string, locale: string | undefined, path: string): string {\n  const origin = siteUrl.replace(/\\/+$/, '')\n  const segments = [locale, path]\n    .map((segment) => segment?.replace(/^\\/+|\\/+$/g, '') ?? '')\n    .filter(Boolean)\n  return segments.length ? `${origin}/${segments.join('/')}` : origin\n}\n\nfunction buildAlternates(\n  config: SiteMetaConfig,\n  path: string,\n  locale: string\n): Metadata['alternates'] {\n  if (!config.locales?.length) {\n    return { canonical: buildUrl(config.siteUrl, undefined, path) }\n  }\n  const languages: Record<string, string> = {}\n  for (const loc of config.locales) {\n    languages[loc] = buildUrl(config.siteUrl, loc, path)\n  }\n  const xDefault =\n    config.defaultLocale ?? (config.locales.includes('en') ? 'en' : config.locales[0])\n  languages['x-default'] = buildUrl(config.siteUrl, xDefault, path)\n  return { canonical: buildUrl(config.siteUrl, locale, path), languages }\n}\n\n/**\n * Builds a complete Next.js `Metadata` from a one-time site config plus per-page\n * inputs — title-template, description, openGraph, twitter, canonical + hreflang,\n * icons, and the OG image — so pages only declare what's unique.\n *\n * The OG image is chosen by the single `og` field (defaults to the static brand\n * image). There is exactly one way to do each thing.\n *\n *   // app/_core/metadata.ts\n *   export const createMetadata = makeMetadataFactory({\n *     name: settings.app.name,\n *     description: settings.app.description,\n *     siteUrl: settings.app.siteUrl,\n *     ogImage: settings.app.media.ogimage,\n *     icons: { icon: settings.app.media.favicon },\n *     locales: LOCALES,\n *   })\n *\n *   // landing page — static brand image (default)\n *   export const metadata = createMetadata({ title: 'Pricing', path: '/pricing' })\n *   // content page — title rendered onto the card\n *   export const metadata = createMetadata({ title: post.title, path, og: 'dynamic' })\n *   // content page with its own image\n *   export const metadata = createMetadata({ title: p.name, og: { image: p.image } })\n */\nexport function createMetadata(config: SiteMetaConfig, page: PageMeta = {}): Metadata {\n  const title = page.title ?? config.name\n  const description = page.description ?? config.description\n  const locale = page.locale ?? config.defaultLocale ?? 'en'\n  const path = page.path ?? ''\n  // Same builder as the canonical below — og:url and canonical name the same\n  // page, so they are never allowed to be assembled by two different rules.\n  const ogUrl = buildUrl(config.siteUrl, config.locales?.length ? locale : undefined, path)\n\n  const ogImage = resolveOgImage(page.og ?? 'static', config.ogImage, title, config.ogBackend)\n\n  const metadata: Metadata = {\n    title,\n    description,\n    keywords: page.keywords,\n    alternates: buildAlternates(config, path, locale),\n    openGraph: {\n      type: 'website',\n      locale,\n      url: ogUrl,\n      siteName: config.name,\n      title,\n      description,\n      ...ogImage.openGraph,\n    },\n    twitter: {\n      title,\n      description,\n      ...ogImage.twitter,\n    },\n    icons: config.icons,\n  }\n\n  if (!page.extra) return metadata\n  // Shallow-merge the escape hatch, but deep-merge the nested og/twitter so the\n  // image we just set isn't clobbered by a partial `extra.openGraph`.\n  return {\n    ...metadata,\n    ...page.extra,\n    openGraph: { ...metadata.openGraph, ...page.extra.openGraph },\n    twitter: { ...metadata.twitter, ...page.extra.twitter },\n  }\n}\n\n/**\n * Curries `createMetadata` with a fixed site config so pages call a zero-config\n * factory. This is the single recommended entry point for app metadata.\n */\nexport function makeMetadataFactory(config: SiteMetaConfig) {\n  return (page: PageMeta = {}): Metadata => createMetadata(config, page)\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/og-image/metadata.ts","../../src/og-image/metadata-factory.ts"],"sourcesContent":["import type { Metadata } from 'next'\nimport type { OgSpec } from './types'\n\nconst OG_WIDTH = 1200\nconst OG_HEIGHT = 630\n\n/** A Next.js OG image entry. */\nfunction imageEntry(url: string, alt: string) {\n  return { url, width: OG_WIDTH, height: OG_HEIGHT, alt }\n}\n\n/**\n * Builds the og/twitter image fragment for a given image URL — the one place\n * that knows the shape Next.js expects.\n */\nfunction ogImageFragment(url: string, alt: string): Pick<Metadata, 'openGraph' | 'twitter'> {\n  return {\n    openGraph: { images: [imageEntry(url, alt)] },\n    twitter: { card: 'summary_large_image', images: [url] },\n  }\n}\n\n/** Extract a plain title string from Next.js's title shapes. */\nexport function extractTitle(metadata: Metadata): string {\n  const t = metadata.title\n  if (!t) return ''\n  if (typeof t === 'string') return t\n  if (typeof t === 'object' && 'absolute' in t) return (t as { absolute: string }).absolute\n  if (typeof t === 'object' && 'default' in t) return (t as { default: string }).default\n  return ''\n}\n\n/**\n * Resolves an `OgSpec` into a concrete og/twitter image fragment. `staticUrl`\n * is the site's brand image, used for the `'static'` case.\n *\n * This is the single decision point for \"what is the OG image\" — no other code\n * branches on the spec.\n *\n * To render a per-page card instead, add an `opengraph-image` route: Next.js\n * discovers it by filename and overrides whatever is set here, so it needs no\n * support from this function.\n */\nexport function resolveOgImage(\n  spec: OgSpec,\n  staticUrl: string,\n  fallbackTitle: string\n): Pick<Metadata, 'openGraph' | 'twitter'> {\n  if (spec === 'static') {\n    return ogImageFragment(staticUrl, fallbackTitle)\n  }\n  return ogImageFragment(spec.image, spec.alt ?? fallbackTitle)\n}\n","import type { Metadata } from 'next'\nimport type { OgSpec } from './types'\nimport { resolveOgImage } from './metadata'\n\n/**\n * Site-wide identity the metadata factory needs. Config-agnostic on purpose —\n * the package doesn't know about any app's `settings` object, so the consumer\n * passes these once (typically derived from their own settings module).\n */\nexport interface SiteMetaConfig {\n  /** Brand / app name, e.g. \"CMDOP\". Used in titles, siteName, alt text. */\n  name: string\n  /** Default description used when a page doesn't supply its own. */\n  description: string\n  /** Absolute site origin, e.g. \"https://cmdop.com\". Used for canonical/og url. */\n  siteUrl: string\n  /** Ready-made static brand OG image URL (absolute or root-relative). */\n  ogImage: string\n  /** Optional favicon / apple-touch icons forwarded to Metadata.icons. */\n  icons?: Metadata['icons']\n  /** Locales for hreflang alternates. Omit for single-locale sites. */\n  locales?: readonly string[]\n  /** Locale used for x-default hreflang (defaults to \"en\" or first locale). */\n  defaultLocale?: string\n}\n\n/**\n * Per-page inputs. Only `title` is really worth setting per page; everything\n * else falls back to the site config.\n */\nexport interface PageMeta {\n  /** Page title (without the brand suffix). Falls back to the site name. */\n  title?: string\n  /** Page description; falls back to the site description. */\n  description?: string\n  keywords?: string[]\n  /** Current locale, used for canonical + openGraph.locale + alternates. */\n  locale?: string\n  /**\n   * Path without locale prefix, e.g. \"/skills\" or \"/skills/foo\". Home is ''\n   * (or '/'). Leading/trailing slashes are normalized, so both canonical and\n   * og:url come out well-formed whichever you pass.\n   */\n  path?: string\n  /**\n   * What the OG image should be. Defaults to `'static'` (the brand image).\n   * - `'static'`          brand image from config (default)\n   * - `{ image, alt? }`   an exact image URL (e.g. a content screenshot)\n   *\n   * For a per-page rendered card, add an `opengraph-image` route instead —\n   * Next.js finds it by filename and it overrides whatever is set here.\n   */\n  og?: OgSpec\n  /** Escape hatch: extra Metadata fields merged last (robots, authors, etc.). */\n  extra?: Metadata\n}\n\n/**\n * Joins the site origin, an optional locale segment, and a page path into one\n * absolute URL.\n *\n * This is the SINGLE place the URL shape is decided. `canonical` and\n * `openGraph.url` describe the same page, so they must be built by the same\n * function — when they were two hand-rolled template literals they drifted\n * apart (one inserted a slash the other didn't), and a page shipped a canonical\n * and an og:url pointing at two different URLs.\n *\n * Contract (see `PageMeta.path`): `path` carries its own leading slash —\n * \"/skills\", \"/skills/foo\" — and home is '' (we also tolerate '/'). Segments\n * are normalized rather than trusted, so a stray or missing slash at a call\n * site cannot produce \"site.com//skills\" or \"site.comskills\".\n */\nfunction buildUrl(siteUrl: string, locale: string | undefined, path: string): string {\n  const origin = siteUrl.replace(/\\/+$/, '')\n  const segments = [locale, path]\n    .map((segment) => segment?.replace(/^\\/+|\\/+$/g, '') ?? '')\n    .filter(Boolean)\n  return segments.length ? `${origin}/${segments.join('/')}` : origin\n}\n\nfunction buildAlternates(\n  config: SiteMetaConfig,\n  path: string,\n  locale: string\n): Metadata['alternates'] {\n  if (!config.locales?.length) {\n    return { canonical: buildUrl(config.siteUrl, undefined, path) }\n  }\n  const languages: Record<string, string> = {}\n  for (const loc of config.locales) {\n    languages[loc] = buildUrl(config.siteUrl, loc, path)\n  }\n  const xDefault =\n    config.defaultLocale ?? (config.locales.includes('en') ? 'en' : config.locales[0])\n  languages['x-default'] = buildUrl(config.siteUrl, xDefault, path)\n  return { canonical: buildUrl(config.siteUrl, locale, path), languages }\n}\n\n/**\n * Builds a complete Next.js `Metadata` from a one-time site config plus per-page\n * inputs — title-template, description, openGraph, twitter, canonical + hreflang,\n * icons, and the OG image — so pages only declare what's unique.\n *\n * The OG image is chosen by the single `og` field (defaults to the static brand\n * image). There is exactly one way to do each thing.\n *\n *   // app/_core/metadata.ts\n *   export const createMetadata = makeMetadataFactory({\n *     name: settings.app.name,\n *     description: settings.app.description,\n *     siteUrl: settings.app.siteUrl,\n *     ogImage: settings.app.media.ogimage,\n *     icons: { icon: settings.app.media.favicon },\n *     locales: LOCALES,\n *   })\n *\n *   // landing page — static brand image (default)\n *   export const metadata = createMetadata({ title: 'Pricing', path: '/pricing' })\n *   // content page with its own image\n *   export const metadata = createMetadata({ title: p.name, og: { image: p.image } })\n */\nexport function createMetadata(config: SiteMetaConfig, page: PageMeta = {}): Metadata {\n  const title = page.title ?? config.name\n  const description = page.description ?? config.description\n  const locale = page.locale ?? config.defaultLocale ?? 'en'\n  const path = page.path ?? ''\n  // Same builder as the canonical below — og:url and canonical name the same\n  // page, so they are never allowed to be assembled by two different rules.\n  const ogUrl = buildUrl(config.siteUrl, config.locales?.length ? locale : undefined, path)\n\n  const ogImage = resolveOgImage(page.og ?? 'static', config.ogImage, title)\n\n  const metadata: Metadata = {\n    title,\n    description,\n    keywords: page.keywords,\n    alternates: buildAlternates(config, path, locale),\n    openGraph: {\n      type: 'website',\n      locale,\n      url: ogUrl,\n      siteName: config.name,\n      title,\n      description,\n      ...ogImage.openGraph,\n    },\n    twitter: {\n      title,\n      description,\n      ...ogImage.twitter,\n    },\n    icons: config.icons,\n  }\n\n  if (!page.extra) return metadata\n  // Shallow-merge the escape hatch, but deep-merge the nested og/twitter so the\n  // image we just set isn't clobbered by a partial `extra.openGraph`.\n  return {\n    ...metadata,\n    ...page.extra,\n    openGraph: { ...metadata.openGraph, ...page.extra.openGraph },\n    twitter: { ...metadata.twitter, ...page.extra.twitter },\n  }\n}\n\n/**\n * Curries `createMetadata` with a fixed site config so pages call a zero-config\n * factory. This is the single recommended entry point for app metadata.\n */\nexport function makeMetadataFactory(config: SiteMetaConfig) {\n  return (page: PageMeta = {}): Metadata => createMetadata(config, page)\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/nextjs",
-  "version": "2.1.536",
+  "version": "2.1.539",
   "description": "Next.js server utilities: sitemap, health, OG images, contact forms, navigation, config",
   "keywords": [
     "nextjs",
@@ -149,9 +149,9 @@
     "ai-docs": "tsx src/ai/cli.ts"
   },
   "peerDependencies": {
-    "@djangocfg/devtools": "^2.1.536",
-    "@djangocfg/i18n": "^2.1.536",
-    "@djangocfg/ui-core": "^2.1.536",
+    "@djangocfg/devtools": "^2.1.539",
+    "@djangocfg/i18n": "^2.1.539",
+    "@djangocfg/ui-core": "^2.1.539",
     "next": "^16.2.2"
   },
   "peerDependenciesMeta": {
@@ -170,11 +170,11 @@
     "semver": "^7.8.5"
   },
   "devDependencies": {
-    "@djangocfg/devtools": "^2.1.536",
-    "@djangocfg/i18n": "^2.1.536",
-    "@djangocfg/layouts": "^2.1.536",
-    "@djangocfg/typescript-config": "^2.1.536",
-    "@djangocfg/ui-core": "^2.1.536",
+    "@djangocfg/devtools": "^2.1.539",
+    "@djangocfg/i18n": "^2.1.539",
+    "@djangocfg/layouts": "^2.1.539",
+    "@djangocfg/typescript-config": "^2.1.539",
+    "@djangocfg/ui-core": "^2.1.539",
     "@types/node": "^25.9.5",
     "@types/react": "19.2.15",
     "@types/react-dom": "19.2.3",

package/src/og-image/README.md

@@ -1,16 +1,19 @@
 # @djangocfg/nextjs/og-image
 
-Page metadata + typed OG image builder for Django's `django_ogimage` renderer.
+Page metadata for Next.js: title templating, canonical + hreflang alternates,
+OpenGraph, Twitter cards and icons, from one bound factory.
 
-**No Edge Runtime. No `@vercel/og`. No JSX templates.**
-Django renders and caches the PNG — Next.js only builds the URL and injects it into metadata.
+> **Changed 2026-09-03.** This package used to build URLs for a Django-side PNG
+> renderer (`django_ogimage`, `/cfg/og/<base64>/`). That module is archived and
+> the `'dynamic'` / `{ render }` specs, `ogBackend`, `buildOgUrl`,
+> `createOgMetadata`, `withOgImage` and `OGImageParams` are gone with it.
+> Next.js renders per-page cards itself — see [Per-page cards](#per-page-cards).
 
 ---
 
 ## Quick start
 
-One factory per app; pages declare only what's unique. The OG image is chosen by
-a single `og` field (defaults to your static brand image):
+One factory per app; pages declare only what's unique.
 
 ```typescript
 // app/_core/metadata.ts — bind the factory once
@@ -29,124 +32,58 @@ export const createMetadata = makeMetadataFactory({
 
 // any page.tsx
 export const metadata = createMetadata({ title: 'Pricing', path: '/pricing' })
-//                        ↑ static brand image, canonical, hreflang, og, twitter, icons
+//                        ↑ brand image, canonical, hreflang, og, twitter, icons
 ```
 
 ```typescript
-// content page — render the title onto the OG card
-export const metadata = createMetadata({ title: post.title, path, og: 'dynamic' })
-
 // content page with its own image (a screenshot, cover, …)
 export const metadata = createMetadata({ title: p.name, path, og: { image: p.image, alt: p.name } })
 ```
 
 ### The `og` axis (`OgSpec`)
 
-A single discriminated union decides what the OG image is — there is exactly one
-way to express each case:
-
 | `og` value | Result |
 |---|---|
 | omitted / `'static'` | the brand image from `config.ogImage` (default) |
-| `'dynamic'` | Django renders the page **title** onto the card |
-| `{ render: { preset, layout, … } }` | dynamic render with explicit params |
-| `{ image, alt? }` | an exact image URL (content screenshot, cover) |
-
-### No backend? Dynamic falls back to static
-
-The `'dynamic'` and `{ render }` cases need a Django renderer. Tell the factory
-where it is — or that there isn't one — via `ogBackend`:
-
-```typescript
-// has a backend → dynamic OG renders against it
-makeMetadataFactory({ ..., ogBackend: 'https://api.example.com' })
-
-// frontend with NO Django backend → og:'dynamic' silently becomes the static
-// brand image, so you never emit a broken /cfg/og/ URL
-makeMetadataFactory({ ..., ogBackend: '' })
+| `{ image, alt? }` | that exact URL |
 
-// omit → resolve from env (MEDIA_URL → API_URL → SITE_URL)
-makeMetadataFactory({ ... })
-```
-
-So a static-only site can leave `og: 'dynamic'` on content pages without breaking
-anything — set `ogBackend: ''` once and every dynamic spec degrades to static.
+Both cases resolve in `resolveOgImage` — the one place that decides what the OG
+image is. `og:image` and `twitter:image` are always written together there,
+because a change that set one and not the other is the failure this package
+exists to prevent.
 
 ---
 
-## How It Works
+## Per-page cards
 
-```
-createMetadata({ … , og })   — picks the OG image by the single `og` field
-    ↓  (dynamic cases only)
-buildOgUrl(params)           — base64-encodes OGImageParams
-    ↓
-resolveOgPublicBase()        — picks the right base URL from env vars
-    ↓
-<meta og:image> = "{base}/cfg/og/{b64}/"
-
-Crawler/browser hits that URL
-    ↓
-Django OGImageRenderView     — decodes params, renders PNG via PicTex
-    ↓
-FileResponse (cached in MEDIA_ROOT/ogimage/<sharded>/<key>.png)
-```
-
-Static / `{ image }` cases skip Django entirely — the URL points straight at the
-given image.
-
----
+To render a card per page — the title on a background, a generated cover —
+use Next.js's own file convention:
 
-## URL Resolution
+```tsx
+// app/blog/[slug]/opengraph-image.tsx
+import { ImageResponse } from 'next/og'
 
-The public base URL (used in `og:image` meta tags) is resolved in priority order:
+export const size = { width: 1200, height: 630 }
+export const contentType = 'image/png'
 
-| Priority | Variable | Use case |
-|---|---|---|
-| 1 | `NEXT_PUBLIC_MEDIA_URL` | nginx proxies `/media/` from `SITE_URL` to `API_URL`; or CDN |
-| 2 | `NEXT_PUBLIC_API_URL` | direct split-domain (Next.js ≠ Django domain) |
-| 3 | `NEXT_PUBLIC_SITE_URL` | same-domain / static build |
-| 4 | `''` (empty) | relative URLs (last resort) |
-
-**Why not always use `API_URL`?**
-Crawlers (Twitter, Facebook, Slack) must reach the OG image URL publicly. When nginx proxies `/media/` through the frontend domain, `API_URL` is internal — the crawler can't reach it. `MEDIA_URL` solves this explicitly.
-
-### Deployment examples
-
-```bash
-# Same-domain static build (Django serves everything)
-NEXT_PUBLIC_SITE_URL=https://example.com
-NEXT_PUBLIC_API_URL=                      # empty → relative /cfg/og/...
-
-# Split-domain standalone build
-NEXT_PUBLIC_SITE_URL=https://example.com
-NEXT_PUBLIC_API_URL=https://api.example.com
-# → og:image = https://api.example.com/cfg/og/<b64>/
-
-# Media proxied through site domain (nginx /media/ → api/media/)
-NEXT_PUBLIC_SITE_URL=https://example.com
-NEXT_PUBLIC_API_URL=https://api.example.com
-NEXT_PUBLIC_MEDIA_URL=https://example.com   # ← crawler hits example.com/cfg/og/...
-
-# CDN
-NEXT_PUBLIC_MEDIA_URL=https://cdn.example.com
+export default async function Image({ params }) {
+  return new ImageResponse(<div style={{ /* … */ }}>{title}</div>, size)
+}
 ```
 
+Nothing here needs to know about it: Next.js discovers the file by name and its
+output **overrides** whatever `createMetadata` set. That is why the factory has
+no "dynamic" case — adding one would mean two mechanisms competing to set the
+same tag.
+
 ---
 
 ## API
 
-### Recommended
-
 #### `makeMetadataFactory(config) → (page) => Metadata`
 
-Binds a `SiteMetaConfig` once and returns a per-page factory. This is the single
-recommended entry point.
-
-```typescript
-const createMetadata = makeMetadataFactory(config)
-export const metadata = createMetadata({ title: 'About', path: '/about' })
-```
+Binds a `SiteMetaConfig` once and returns a per-page factory. The recommended
+entry point.
 
 **`SiteMetaConfig`**
 
@@ -156,7 +93,6 @@ export const metadata = createMetadata({ title: 'About', path: '/about' })
 | `description` | `string` | default description |
 | `siteUrl` | `string` | absolute origin, e.g. `https://example.com` |
 | `ogImage` | `string` | static brand OG image URL |
-| `ogBackend?` | `string` | Django origin for the dynamic renderer (see below) |
 | `icons?` | `Metadata['icons']` | favicon / apple-touch |
 | `locales?` | `readonly string[]` | for hreflang; omit for single-locale |
 | `defaultLocale?` | `string` | x-default locale (defaults `en` / first) |
@@ -175,77 +111,9 @@ export const metadata = createMetadata({ title: 'About', path: '/about' })
 
 #### `createMetadata(config, page)`
 
-The un-curried form `makeMetadataFactory` wraps. Use when you don't want a bound factory.
-
-### Low-level (escape hatches)
-
-Most pages never need these — they're the primitives the factory is built on.
-
-#### `buildOgUrl(params)`
-
-Raw OG image URL string for the dynamic renderer.
-
-```typescript
-const url = buildOgUrl({ title: 'Hello', preset: 'DARK_BLUE' })
-// → "https://api.example.com/cfg/og/eyJ0aXRsZSI6Ikhlb.../"
-```
-
-#### `createOgMetadata(params)` · `withOgImage(metadata, params)`
-
-`createOgMetadata` returns a `{ openGraph, twitter }` image fragment for the
-dynamic renderer; `withOgImage` merges that fragment into an existing `Metadata`
-(auto-extracting `title`). Both are for manual metadata assembly outside the factory.
-
-#### `resolveOgImage(spec, staticUrl, fallbackTitle)`
-
-The single decision point that turns an `OgSpec` into an image fragment — exported
-for advanced custom factories.
-
----
-
-## OGImageParams
-
-Mirrors Django's `OGImageParams` exactly:
-
-```typescript
-interface OGImageParams {
-  title: string           // required
-  description?: string
-  locale?: string         // for CJK/RTL font selection
-  style?: 'dark' | 'light'
-
-  // Color overrides (hex, e.g. "#1a1a2e")
-  bg_color?: string
-  bg_color2?: string      // gradient second color
-  text_color?: string
-  accent_color?: string
-
-  size?: string           // "1200x630" (default)
-  preset?: OGPreset       // see below
-  layout?: OGLayout       // see below
-  page_url?: string       // excluded from Django's cache key
-}
-```
-
-### Presets (`OGPreset`)
-
-Dark: `DARK` `DARK_BLUE` `DARK_PURPLE` `DARK_GREEN` `DARK_ROSE`
-Light: `LIGHT` `LIGHT_GRAY` `LIGHT_WARM` `LIGHT_GREEN`
-
-### Layouts (`OGLayout`)
-
-| Value | Description |
-|---|---|
-| `DEFAULT` | Accent bar top, brand bottom-left, content centered |
-| `HERO` | Accent bar top, brand top-left, content bottom — larger fonts |
-| `ARTICLE` | No accent, brand top-left, content centered |
-| `MINIMAL` | No accent, no brand, pure content |
-
----
-
-## Django side
+The un-curried form `makeMetadataFactory` wraps. Use when you don't want a bound
+factory.
 
-The endpoint is registered by `django_ogimage` at `/cfg/og/<b64params>/`.
-Enable it by including the URLs in your Django project (handled automatically by `django-cfg`).
+#### `resolveOgImage(spec, staticUrl, fallbackTitle)` · `extractTitle(metadata)`
 
-Cache lives at `MEDIA_ROOT/ogimage/<key[:2]>/<key[2:4]>/<key>.png` — sharded, `Cache-Control: public, max-age=86400`.
+Escape hatches for custom factories. Most pages never touch them.

package/src/og-image/index.ts

@@ -4,8 +4,7 @@ export { createMetadata, makeMetadataFactory } from './metadata-factory'
 export type { SiteMetaConfig, PageMeta } from './metadata-factory'
 
 // ── Types ────────────────────────────────────────────────────────────────────
-export type { OGImageParams, OGPreset, OGLayout, OgSpec } from './types'
+export type { OgSpec } from './types'
 
 // ── Low-level primitives (escape hatches) ────────────────────────────────────
-export { buildOgUrl } from './url'
-export { createOgMetadata, withOgImage, resolveOgImage, extractTitle } from './metadata'
+export { resolveOgImage, extractTitle } from './metadata'

package/src/og-image/metadata-factory.test.ts

@@ -21,7 +21,6 @@ const BASE: SiteMetaConfig = {
   description: 'Capability catalogue',
   siteUrl: 'https://marketplace.cmdop.com',
   ogImage: '/opengraph-image',
-  ogBackend: '',
 }
 
 const LOCALIZED: SiteMetaConfig = {

package/src/og-image/metadata-factory.ts

@@ -16,16 +16,6 @@ export interface SiteMetaConfig {
   siteUrl: string
   /** Ready-made static brand OG image URL (absolute or root-relative). */
   ogImage: string
-  /**
-   * Django origin that serves the dynamic OG renderer (`/cfg/og/`), e.g.
-   * "https://api.example.com". Required for `og: 'dynamic'` / `{ render }`.
-   *
-   * - set    → dynamic OG images render against this origin
-   * - `''`   → no backend: dynamic specs fall back to the static brand image
-   *            (use this for a frontend with no Django, so no broken URLs)
-   * - omit   → fall back to env vars (MEDIA_URL → API_URL → SITE_URL)
-   */
-  ogBackend?: string
   /** Optional favicon / apple-touch icons forwarded to Metadata.icons. */
   icons?: Metadata['icons']
   /** Locales for hreflang alternates. Omit for single-locale sites. */
@@ -55,9 +45,10 @@ export interface PageMeta {
   /**
    * What the OG image should be. Defaults to `'static'` (the brand image).
    * - `'static'`          brand image from config (default)
-   * - `'dynamic'`         render the page title onto the card
-   * - `{ render: {...} }` render with explicit preset/layout/colors
    * - `{ image, alt? }`   an exact image URL (e.g. a content screenshot)
+   *
+   * For a per-page rendered card, add an `opengraph-image` route instead —
+   * Next.js finds it by filename and it overrides whatever is set here.
    */
   og?: OgSpec
   /** Escape hatch: extra Metadata fields merged last (robots, authors, etc.). */
@@ -125,8 +116,6 @@ function buildAlternates(
  *
  *   // landing page — static brand image (default)
  *   export const metadata = createMetadata({ title: 'Pricing', path: '/pricing' })
- *   // content page — title rendered onto the card
- *   export const metadata = createMetadata({ title: post.title, path, og: 'dynamic' })
  *   // content page with its own image
  *   export const metadata = createMetadata({ title: p.name, og: { image: p.image } })
  */
@@ -139,7 +128,7 @@ export function createMetadata(config: SiteMetaConfig, page: PageMeta = {}): Met
   // page, so they are never allowed to be assembled by two different rules.
   const ogUrl = buildUrl(config.siteUrl, config.locales?.length ? locale : undefined, path)
 
-  const ogImage = resolveOgImage(page.og ?? 'static', config.ogImage, title, config.ogBackend)
+  const ogImage = resolveOgImage(page.og ?? 'static', config.ogImage, title)
 
   const metadata: Metadata = {
     title,

package/src/og-image/metadata.ts

@@ -1,6 +1,5 @@
 import type { Metadata } from 'next'
-import type { OGImageParams, OgSpec } from './types'
-import { buildOgUrl } from './url'
+import type { OgSpec } from './types'
 
 const OG_WIDTH = 1200
 const OG_HEIGHT = 630
@@ -12,8 +11,7 @@ function imageEntry(url: string, alt: string) {
 
 /**
  * Builds the og/twitter image fragment for a given image URL — the one place
- * that knows the shape Next.js expects. Both static URLs and the dynamic
- * renderer funnel through here, so there's a single source of truth.
+ * that knows the shape Next.js expects.
  */
 function ogImageFragment(url: string, alt: string): Pick<Metadata, 'openGraph' | 'twitter'> {
   return {
@@ -22,15 +20,6 @@ function ogImageFragment(url: string, alt: string): Pick<Metadata, 'openGraph' |
   }
 }
 
-/**
- * Metadata fragment whose OG image is rendered by Django's django_ogimage
- * endpoint (/cfg/og/). Low-level — most callers use `createMetadata`'s `og`
- * field instead.
- */
-export function createOgMetadata(params: OGImageParams): Metadata {
-  return ogImageFragment(buildOgUrl(params), params.title)
-}
-
 /** Extract a plain title string from Next.js's title shapes. */
 export function extractTitle(metadata: Metadata): string {
   const t = metadata.title
@@ -42,59 +31,23 @@ export function extractTitle(metadata: Metadata): string {
 }
 
 /**
- * Resolves an `OgSpec` against a base Metadata into a concrete og/twitter image
- * fragment. `staticUrl` is the site's brand image, used for the `'static'` case.
- *
- * `backend` is the Django origin that serves the dynamic renderer. The dynamic
- * cases (`'dynamic'`, `{ render }`) require it: when it's `undefined`/empty —
- * e.g. a frontend with no Django backend — they **fall back to the static brand
- * image** instead of emitting a broken `/cfg/og/` URL. (`undefined` still lets
- * `buildOgUrl` fall back to env vars; pass `''` to force the static fallback.)
+ * Resolves an `OgSpec` into a concrete og/twitter image fragment. `staticUrl`
+ * is the site's brand image, used for the `'static'` case.
  *
  * This is the single decision point for "what is the OG image" — no other code
  * branches on the spec.
+ *
+ * To render a per-page card instead, add an `opengraph-image` route: Next.js
+ * discovers it by filename and overrides whatever is set here, so it needs no
+ * support from this function.
  */
 export function resolveOgImage(
   spec: OgSpec,
   staticUrl: string,
-  fallbackTitle: string,
-  backend?: string
+  fallbackTitle: string
 ): Pick<Metadata, 'openGraph' | 'twitter'> {
-  const canRenderDynamic = backend === undefined || backend !== ''
-
   if (spec === 'static') {
     return ogImageFragment(staticUrl, fallbackTitle)
   }
-  if (spec === 'dynamic') {
-    return canRenderDynamic
-      ? ogImageFragment(buildOgUrl({ title: fallbackTitle }, backend), fallbackTitle)
-      : ogImageFragment(staticUrl, fallbackTitle)
-  }
-  if ('image' in spec) {
-    return ogImageFragment(spec.image, spec.alt ?? fallbackTitle)
-  }
-  // { render: {...} } — dynamic with explicit params; title defaults to page title.
-  const title = spec.render.title ?? fallbackTitle
-  return canRenderDynamic
-    ? ogImageFragment(buildOgUrl({ ...spec.render, title }, backend), title)
-    : ogImageFragment(staticUrl, title)
-}
-
-/**
- * Merges OG image metadata (dynamic render) into existing Metadata. Kept for
- * low-level/manual use; `createMetadata` is the recommended entry point.
- *
- *   return withOgImage({ title: 'Page' }, { preset: 'DARK_BLUE' })
- */
-export function withOgImage(
-  metadata: Metadata,
-  params: Omit<OGImageParams, 'title'> & { title?: string } = {}
-): Metadata {
-  const title = params.title ?? extractTitle(metadata)
-  const frag = createOgMetadata({ ...params, title })
-  return {
-    ...metadata,
-    openGraph: { ...metadata.openGraph, ...frag.openGraph },
-    twitter: { ...metadata.twitter, ...frag.twitter },
-  }
+  return ogImageFragment(spec.image, spec.alt ?? fallbackTitle)
 }

package/src/og-image/types.ts

@@ -1,45 +1,12 @@
-export type OGPreset =
-  | 'DARK'
-  | 'DARK_BLUE'
-  | 'DARK_PURPLE'
-  | 'DARK_GREEN'
-  | 'DARK_ROSE'
-  | 'LIGHT'
-  | 'LIGHT_GRAY'
-  | 'LIGHT_WARM'
-  | 'LIGHT_GREEN'
-
-export type OGLayout = 'DEFAULT' | 'HERO' | 'ARTICLE' | 'MINIMAL'
-
 /**
  * Per-page OG image intent — the single axis that decides what the OG image is.
- * A discriminated union so every case is explicit and type-checked:
  *
  *   'static'              brand image from site config (the default)
- *   'dynamic'             render the page title onto the OG card
- *   { render: {...} }     render with explicit preset/layout/colors
  *   { image, alt? }       an exact image URL (e.g. a content screenshot)
+ *
+ * There is deliberately no "render this title onto a card" case. That was
+ * served by a Django endpoint (`/cfg/og/<base64>/`), archived 2026-09-03 —
+ * Next.js renders such cards itself via an `opengraph-image` route, which
+ * needs no metadata support because the file convention IS the registration.
  */
-export type OgSpec =
-  | 'static'
-  | 'dynamic'
-  | { render: Omit<OGImageParams, 'title'> & { title?: string } }
-  | { image: string; alt?: string }
-
-/** Mirrors Django OGImageParams exactly */
-export interface OGImageParams {
-  title: string
-  description?: string
-  locale?: string
-  style?: 'dark' | 'light'
-  bg_color?: string
-  bg_color2?: string
-  text_color?: string
-  accent_color?: string
-  /** e.g. "1200x630" */
-  size?: string
-  preset?: OGPreset
-  layout?: OGLayout
-  /** Excluded from cache key on Django side */
-  page_url?: string
-}
+export type OgSpec = 'static' | { image: string; alt?: string }

package/src/og-image/url.ts

@@ -1,62 +0,0 @@
-import type { OGImageParams } from './types'
-
-/**
- * Resolves the base URL for og:image meta tags.
- * Must be publicly accessible by crawlers (Twitter, Facebook, etc).
- *
- * Priority:
- * 1. NEXT_PUBLIC_MEDIA_URL — explicit media domain (nginx proxy or CDN)
- * 2. NEXT_PUBLIC_API_URL   — direct Django API domain
- * 3. NEXT_PUBLIC_SITE_URL  — site domain (same-domain/static build)
- * 4. ''                    — relative URL (last resort)
- *
- * Use cases:
- * - Same domain (static build):   API_URL='' → relative /cfg/og/...
- * - Split domain (standalone):    API_URL=https://api.x.com → absolute
- * - Media via nginx proxy:        MEDIA_URL=https://x.com, API_URL=https://api.x.com
- * - CDN:                          MEDIA_URL=https://cdn.x.com
- */
-function resolveOgPublicBase(): string {
-  if (typeof process === 'undefined') return ''
-  return (
-    process.env.NEXT_PUBLIC_MEDIA_URL?.replace(/\/$/, '') ??
-    process.env.NEXT_PUBLIC_API_URL?.replace(/\/$/, '') ??
-    process.env.NEXT_PUBLIC_SITE_URL?.replace(/\/$/, '') ??
-    ''
-  )
-}
-
-function encodeBase64(str: string): string {
-  if (typeof Buffer !== 'undefined') {
-    return Buffer.from(str).toString('base64url')
-  }
-  // Browser fallback
-  return btoa(unescape(encodeURIComponent(str)))
-    .replace(/\+/g, '-')
-    .replace(/\//g, '_')
-    .replace(/=+$/, '')
-}
-
-function cleanParams(params: OGImageParams): Record<string, unknown> {
-  return Object.fromEntries(
-    Object.entries(params).filter(
-      ([, v]) => v !== undefined && v !== null && v !== ''
-    )
-  )
-}
-
-/**
- * Builds an absolute (or relative) OG image URL pointing to Django's
- * django_ogimage endpoint: /cfg/og/<base64params>/
- *
- * The URL is suitable for use in og:image and twitter:image meta tags.
- *
- * @param base Optional explicit backend origin (e.g. "https://api.example.com").
- *   When omitted, it's resolved from env (MEDIA_URL → API_URL → SITE_URL → '').
- *   Pass the `ogBackend` from your site config to avoid relying on env.
- */
-export function buildOgUrl(params: OGImageParams, base?: string): string {
-  const b64 = encodeBase64(JSON.stringify(cleanParams(params)))
-  const origin = (base ?? resolveOgPublicBase()).replace(/\/$/, '')
-  return `${origin}/cfg/og/${b64}/`
-}