@cmssy/next 0.5.2 → 0.5.4

package/dist/index.cjs

@@ -284,18 +284,28 @@ function createCmssyRobots(config, options = {}) {
     return {
       rules,
       ...includeSitemap ? { sitemap: `${baseUrl}/sitemap.xml` } : {},
-      ...baseUrl ? { host: baseUrl } : {}
+      ...options.host && baseUrl ? { host: baseUrl } : {}
     };
   };
 }
+
+// src/seo-paths.ts
+function resolveSeoLocales(config, siteConfig) {
+  const defaultLocale = config.defaultLocale ?? siteConfig?.defaultLanguage ?? "en";
+  const locales = config.enabledLocales && config.enabledLocales.length > 0 ? config.enabledLocales : siteConfig?.enabledLanguages && siteConfig.enabledLanguages.length > 0 ? siteConfig.enabledLanguages : [defaultLocale];
+  return { defaultLocale, locales };
+}
 function normalizeSlug(slug) {
   if (slug === "/" || slug === "") return "/";
   return slug.startsWith("/") ? slug : `/${slug}`;
 }
 function localizedPath(slug, locale, defaultLocale) {
-  const normalized = slug === "/" ? "" : slug;
-  return locale === defaultLocale ? normalized || "/" : `/${locale}${normalized}`;
+  const normalized = normalizeSlug(slug);
+  const base = normalized === "/" ? "" : normalized;
+  return locale === defaultLocale ? base || "/" : `/${locale}${base}`;
 }
+
+// src/create-cmssy-sitemap.ts
 function createCmssySitemap(config, options = {}) {
   const clientConfig = {
     apiUrl: config.apiUrl,
@@ -311,15 +321,15 @@ function createCmssySitemap(config, options = {}) {
       }
       pages = [];
     }
-    let notFoundPageId = null;
+    let siteConfig = null;
     try {
-      notFoundPageId = (await react.fetchSiteConfig(clientConfig))?.notFoundPageId ?? null;
+      siteConfig = await react.fetchSiteConfig(clientConfig);
     } catch {
-      notFoundPageId = null;
+      siteConfig = null;
     }
+    const notFoundPageId = siteConfig?.notFoundPageId ?? null;
     const baseUrl = await resolveSeoBaseUrl(config, options.baseUrl);
-    const defaultLocale = config.defaultLocale ?? "en";
-    const locales = config.enabledLocales && config.enabledLocales.length > 0 ? config.enabledLocales : [defaultLocale];
+    const { defaultLocale, locales } = resolveSeoLocales(config, siteConfig);
     const excluded = new Set((options.excludeSlugs ?? []).map(normalizeSlug));
     const entries = pages.map((page) => ({ ...page, slug: normalizeSlug(page.slug) })).filter((page) => page.id !== notFoundPageId && !excluded.has(page.slug)).map((page) => {
       const lastModified = page.updatedAt ?? page.publishedAt ?? void 0;
@@ -342,6 +352,67 @@ function createCmssySitemap(config, options = {}) {
     return options.extra ? [...entries, ...options.extra] : entries;
   };
 }
+function pick(value, locale, defaultLocale) {
+  if (!value) return "";
+  if (typeof value === "string") return value;
+  return value[locale] || value[defaultLocale] || Object.values(value)[0] || "";
+}
+async function buildCmssyMetadata(config, path, options = {}) {
+  const clientConfig = {
+    apiUrl: config.apiUrl,
+    workspaceSlug: config.workspaceSlug
+  };
+  const [meta, siteConfig, baseUrl] = await Promise.all([
+    react.fetchPageMeta(clientConfig, path).catch(() => null),
+    react.fetchSiteConfig(clientConfig).catch(() => null),
+    resolveSeoBaseUrl(config, options.baseUrl)
+  ]);
+  const { defaultLocale, locales: enabledLocales } = resolveSeoLocales(
+    config,
+    siteConfig
+  );
+  const locale = await config.resolveLocale?.() ?? defaultLocale;
+  const slug = react.normalizeSlug(path);
+  const siteName = pick(siteConfig?.siteName, locale, defaultLocale) || siteConfig?.branding?.brandName || void 0;
+  const title = pick(meta?.seoTitle, locale, defaultLocale) || pick(meta?.displayName, locale, defaultLocale) || siteName || "";
+  const description = pick(meta?.seoDescription, locale, defaultLocale);
+  const keywords = meta?.seoKeywords?.length ? meta.seoKeywords : void 0;
+  const image = options.image ?? siteConfig?.branding?.ogImageUrl ?? void 0;
+  const canonical = baseUrl ? `${baseUrl}${localizedPath(slug, locale, defaultLocale)}` : void 0;
+  const languages = baseUrl && enabledLocales.length > 1 ? Object.fromEntries(
+    enabledLocales.map((l) => [
+      l,
+      `${baseUrl}${localizedPath(slug, l, defaultLocale)}`
+    ])
+  ) : void 0;
+  return {
+    ...baseUrl ? { metadataBase: new URL(baseUrl) } : {},
+    ...title ? { title } : {},
+    ...description ? { description } : {},
+    ...keywords ? { keywords } : {},
+    ...canonical || languages ? {
+      alternates: {
+        ...canonical ? { canonical } : {},
+        ...languages ? { languages } : {}
+      }
+    } : {},
+    openGraph: {
+      ...title ? { title } : {},
+      ...description ? { description } : {},
+      ...canonical ? { url: canonical } : {},
+      ...siteName ? { siteName } : {},
+      type: options.ogType ?? "website",
+      locale,
+      ...image ? { images: [{ url: image }] } : {}
+    },
+    twitter: {
+      card: image ? options.twitterCard ?? "summary_large_image" : "summary",
+      ...title ? { title } : {},
+      ...description ? { description } : {},
+      ...image ? { images: [image] } : {}
+    }
+  };
+}
 var MIN_SECRET_LENGTH = 16;
 function secretsMatch(a, b) {
   const ha = crypto$1.createHash("sha256").update(a).digest();
@@ -1518,6 +1589,7 @@ exports.CmssyWebhookError = CmssyWebhookError;
 exports.SESSION_MAX_AGE_SECONDS = SESSION_MAX_AGE_SECONDS;
 exports.applyCmssyCsp = applyCmssyCsp;
 exports.assertAuthConfig = assertAuthConfig;
+exports.buildCmssyMetadata = buildCmssyMetadata;
 exports.cmssyCspHeaders = cmssyCspHeaders;
 exports.createCmssyAuthMiddleware = createCmssyAuthMiddleware;
 exports.createCmssyAuthRoute = createCmssyAuthRoute;

package/dist/index.d.cts

@@ -2,7 +2,7 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ComponentType, ReactNode } from 'react';
 import { CmssyPageData, CmssyFormDefinition, BlockDefinition, CmssyClientConfig, CmssyProduct, CmssyOrder } from '@cmssy/react';
 import { EditBridgeConfig } from '@cmssy/react/client';
-import { MetadataRoute } from 'next';
+import { MetadataRoute, Metadata } from 'next';
 import { NextRequest, NextResponse } from 'next/server';
 
 interface CmssyAuthConfig {
@@ -80,10 +80,16 @@ interface CreateCmssyRobotsOptions extends SeoBaseUrlOption {
     rules?: MetadataRoute.Robots["rules"];
     /** Reference `${baseUrl}/sitemap.xml`. Defaults to true. */
     sitemap?: boolean;
+    /**
+     * Emit the non-standard `Host:` directive (a Yandex extension). Google
+     * ignores it and reports a warning in Search Console, so it is off by
+     * default. Enable only when targeting Yandex.
+     */
+    host?: boolean;
 }
 /**
- * Builds the default export for Next's `app/robots.ts`. Allows crawling, points
- * to the sitemap, and reports the canonical host. Drop in as:
+ * Builds the default export for Next's `app/robots.ts`. Allows crawling and
+ * points to the sitemap. Drop in as:
  *
  *   export default createCmssyRobots(cmssy);
  */
@@ -108,6 +114,27 @@ interface CreateCmssySitemapOptions extends SeoBaseUrlOption {
  */
 declare function createCmssySitemap(config: CmssyNextConfig, options?: CreateCmssySitemapOptions): () => Promise<MetadataRoute.Sitemap>;
 
+interface BuildCmssyMetadataOptions extends SeoBaseUrlOption {
+    /** Override the Open Graph / Twitter image (defaults to workspace branding). */
+    image?: string;
+    /** Open Graph type. Defaults to "website". */
+    ogType?: string;
+    /** Twitter card. Defaults to "summary_large_image" when an image exists. */
+    twitterCard?: "summary" | "summary_large_image";
+}
+/**
+ * Builds complete Next.js `Metadata` for a cmssy page from its SEO fields and
+ * the workspace branding: title/description/keywords, canonical + per-locale
+ * `hreflang` alternates, and Open Graph / Twitter cards (with the branding OG
+ * image). Use in a route's `generateMetadata`:
+ *
+ *   export const generateMetadata = ({ params }) =>
+ *     buildCmssyMetadata(cmssy, (await params).path);
+ *
+ * `path` is the catch-all segments with the locale prefix already stripped.
+ */
+declare function buildCmssyMetadata(config: CmssyNextConfig, path?: string | string[], options?: BuildCmssyMetadataOptions): Promise<Metadata>;
+
 type CmssyDraftRouteConfig = Pick<CmssyNextConfig, "draftSecret"> & {
     defaultRedirect?: string;
 };
@@ -301,4 +328,4 @@ declare class CmssyWebhookError extends Error {
  */
 declare function verifyCmssyWebhook(options: VerifyCmssyWebhookOptions): CmssyWebhookEvent;
 
-export { CMSSY_CART_COOKIE, CMSSY_EDIT_HEADER, CMSSY_LOCALE_HEADER, CMSSY_SESSION_COOKIE, type CmssyAuthConfig, type CmssyAuthMiddleware, type CmssyAuthRouteHandlers, type CmssyCartRouteHandlers, type CmssyCspOptions, type CmssyDraftRouteConfig, type CmssyEditorProps, type CmssyNextConfig, type CmssyOrdersRouteHandlers, type CmssySessionPayload, type CmssySessionUser, CmssyWebhookError, type CmssyWebhookEvent, type CmssyWebhookOrder, type CreateCmssyNotFoundOptions, type CreateCmssyPageOptions, type CreateCmssyRobotsOptions, type CreateCmssySitemapOptions, type FetchProductOptions, type FetchProductsOptions, type MyOrdersResult, SESSION_MAX_AGE_SECONDS, type SessionCookieOptions, type VerifyCmssyWebhookOptions, applyCmssyCsp, assertAuthConfig, cmssyCspHeaders, createCmssyAuthMiddleware, createCmssyAuthRoute, createCmssyCartRoute, createCmssyLocaleMiddleware, createCmssyNotFound, createCmssyOrdersRoute, createCmssyPage, createCmssyRobots, createCmssySitemap, createDraftRoute, fetchProduct, fetchProducts, getCmssyAccessToken, getCmssyLocale, getCmssyUser, isAccessExpired, isCmssyEditMode, isCmssyEditRequest, localeForPathname, openSession, resolveLocaleFromPathname, sealSession, sessionCookieOptions, splitCmssyLocale, verifyCmssyWebhook };
+export { type BuildCmssyMetadataOptions, CMSSY_CART_COOKIE, CMSSY_EDIT_HEADER, CMSSY_LOCALE_HEADER, CMSSY_SESSION_COOKIE, type CmssyAuthConfig, type CmssyAuthMiddleware, type CmssyAuthRouteHandlers, type CmssyCartRouteHandlers, type CmssyCspOptions, type CmssyDraftRouteConfig, type CmssyEditorProps, type CmssyNextConfig, type CmssyOrdersRouteHandlers, type CmssySessionPayload, type CmssySessionUser, CmssyWebhookError, type CmssyWebhookEvent, type CmssyWebhookOrder, type CreateCmssyNotFoundOptions, type CreateCmssyPageOptions, type CreateCmssyRobotsOptions, type CreateCmssySitemapOptions, type FetchProductOptions, type FetchProductsOptions, type MyOrdersResult, SESSION_MAX_AGE_SECONDS, type SessionCookieOptions, type VerifyCmssyWebhookOptions, applyCmssyCsp, assertAuthConfig, buildCmssyMetadata, cmssyCspHeaders, createCmssyAuthMiddleware, createCmssyAuthRoute, createCmssyCartRoute, createCmssyLocaleMiddleware, createCmssyNotFound, createCmssyOrdersRoute, createCmssyPage, createCmssyRobots, createCmssySitemap, createDraftRoute, fetchProduct, fetchProducts, getCmssyAccessToken, getCmssyLocale, getCmssyUser, isAccessExpired, isCmssyEditMode, isCmssyEditRequest, localeForPathname, openSession, resolveLocaleFromPathname, sealSession, sessionCookieOptions, splitCmssyLocale, verifyCmssyWebhook };

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ComponentType, ReactNode } from 'react';
 import { CmssyPageData, CmssyFormDefinition, BlockDefinition, CmssyClientConfig, CmssyProduct, CmssyOrder } from '@cmssy/react';
 import { EditBridgeConfig } from '@cmssy/react/client';
-import { MetadataRoute } from 'next';
+import { MetadataRoute, Metadata } from 'next';
 import { NextRequest, NextResponse } from 'next/server';
 
 interface CmssyAuthConfig {
@@ -80,10 +80,16 @@ interface CreateCmssyRobotsOptions extends SeoBaseUrlOption {
     rules?: MetadataRoute.Robots["rules"];
     /** Reference `${baseUrl}/sitemap.xml`. Defaults to true. */
     sitemap?: boolean;
+    /**
+     * Emit the non-standard `Host:` directive (a Yandex extension). Google
+     * ignores it and reports a warning in Search Console, so it is off by
+     * default. Enable only when targeting Yandex.
+     */
+    host?: boolean;
 }
 /**
- * Builds the default export for Next's `app/robots.ts`. Allows crawling, points
- * to the sitemap, and reports the canonical host. Drop in as:
+ * Builds the default export for Next's `app/robots.ts`. Allows crawling and
+ * points to the sitemap. Drop in as:
  *
  *   export default createCmssyRobots(cmssy);
  */
@@ -108,6 +114,27 @@ interface CreateCmssySitemapOptions extends SeoBaseUrlOption {
  */
 declare function createCmssySitemap(config: CmssyNextConfig, options?: CreateCmssySitemapOptions): () => Promise<MetadataRoute.Sitemap>;
 
+interface BuildCmssyMetadataOptions extends SeoBaseUrlOption {
+    /** Override the Open Graph / Twitter image (defaults to workspace branding). */
+    image?: string;
+    /** Open Graph type. Defaults to "website". */
+    ogType?: string;
+    /** Twitter card. Defaults to "summary_large_image" when an image exists. */
+    twitterCard?: "summary" | "summary_large_image";
+}
+/**
+ * Builds complete Next.js `Metadata` for a cmssy page from its SEO fields and
+ * the workspace branding: title/description/keywords, canonical + per-locale
+ * `hreflang` alternates, and Open Graph / Twitter cards (with the branding OG
+ * image). Use in a route's `generateMetadata`:
+ *
+ *   export const generateMetadata = ({ params }) =>
+ *     buildCmssyMetadata(cmssy, (await params).path);
+ *
+ * `path` is the catch-all segments with the locale prefix already stripped.
+ */
+declare function buildCmssyMetadata(config: CmssyNextConfig, path?: string | string[], options?: BuildCmssyMetadataOptions): Promise<Metadata>;
+
 type CmssyDraftRouteConfig = Pick<CmssyNextConfig, "draftSecret"> & {
     defaultRedirect?: string;
 };
@@ -301,4 +328,4 @@ declare class CmssyWebhookError extends Error {
  */
 declare function verifyCmssyWebhook(options: VerifyCmssyWebhookOptions): CmssyWebhookEvent;
 
-export { CMSSY_CART_COOKIE, CMSSY_EDIT_HEADER, CMSSY_LOCALE_HEADER, CMSSY_SESSION_COOKIE, type CmssyAuthConfig, type CmssyAuthMiddleware, type CmssyAuthRouteHandlers, type CmssyCartRouteHandlers, type CmssyCspOptions, type CmssyDraftRouteConfig, type CmssyEditorProps, type CmssyNextConfig, type CmssyOrdersRouteHandlers, type CmssySessionPayload, type CmssySessionUser, CmssyWebhookError, type CmssyWebhookEvent, type CmssyWebhookOrder, type CreateCmssyNotFoundOptions, type CreateCmssyPageOptions, type CreateCmssyRobotsOptions, type CreateCmssySitemapOptions, type FetchProductOptions, type FetchProductsOptions, type MyOrdersResult, SESSION_MAX_AGE_SECONDS, type SessionCookieOptions, type VerifyCmssyWebhookOptions, applyCmssyCsp, assertAuthConfig, cmssyCspHeaders, createCmssyAuthMiddleware, createCmssyAuthRoute, createCmssyCartRoute, createCmssyLocaleMiddleware, createCmssyNotFound, createCmssyOrdersRoute, createCmssyPage, createCmssyRobots, createCmssySitemap, createDraftRoute, fetchProduct, fetchProducts, getCmssyAccessToken, getCmssyLocale, getCmssyUser, isAccessExpired, isCmssyEditMode, isCmssyEditRequest, localeForPathname, openSession, resolveLocaleFromPathname, sealSession, sessionCookieOptions, splitCmssyLocale, verifyCmssyWebhook };
+export { type BuildCmssyMetadataOptions, CMSSY_CART_COOKIE, CMSSY_EDIT_HEADER, CMSSY_LOCALE_HEADER, CMSSY_SESSION_COOKIE, type CmssyAuthConfig, type CmssyAuthMiddleware, type CmssyAuthRouteHandlers, type CmssyCartRouteHandlers, type CmssyCspOptions, type CmssyDraftRouteConfig, type CmssyEditorProps, type CmssyNextConfig, type CmssyOrdersRouteHandlers, type CmssySessionPayload, type CmssySessionUser, CmssyWebhookError, type CmssyWebhookEvent, type CmssyWebhookOrder, type CreateCmssyNotFoundOptions, type CreateCmssyPageOptions, type CreateCmssyRobotsOptions, type CreateCmssySitemapOptions, type FetchProductOptions, type FetchProductsOptions, type MyOrdersResult, SESSION_MAX_AGE_SECONDS, type SessionCookieOptions, type VerifyCmssyWebhookOptions, applyCmssyCsp, assertAuthConfig, buildCmssyMetadata, cmssyCspHeaders, createCmssyAuthMiddleware, createCmssyAuthRoute, createCmssyCartRoute, createCmssyLocaleMiddleware, createCmssyNotFound, createCmssyOrdersRoute, createCmssyPage, createCmssyRobots, createCmssySitemap, createDraftRoute, fetchProduct, fetchProducts, getCmssyAccessToken, getCmssyLocale, getCmssyUser, isAccessExpired, isCmssyEditMode, isCmssyEditRequest, localeForPathname, openSession, resolveLocaleFromPathname, sealSession, sessionCookieOptions, splitCmssyLocale, verifyCmssyWebhook };

package/dist/index.js

@@ -1,6 +1,6 @@
 import { draftMode, headers, cookies } from 'next/headers';
 import { notFound, redirect } from 'next/navigation';
-import { resolveSiteLocales, splitLocaleFromPath, fetchPage, resolveForms, CmssyServerPage, fetchSiteConfig, fetchPageById, fetchPages, resolveWorkspaceId, graphqlRequest } from '@cmssy/react';
+import { resolveSiteLocales, splitLocaleFromPath, fetchPage, resolveForms, CmssyServerPage, fetchSiteConfig, fetchPageById, fetchPages, fetchPageMeta, normalizeSlug as normalizeSlug$1, resolveWorkspaceId, graphqlRequest } from '@cmssy/react';
 import { CmssyLocaleProvider } from '@cmssy/react/client';
 import { jsx, jsxs } from 'react/jsx-runtime';
 import { createHmac, createHash, timingSafeEqual } from 'crypto';
@@ -282,18 +282,28 @@ function createCmssyRobots(config, options = {}) {
     return {
       rules,
       ...includeSitemap ? { sitemap: `${baseUrl}/sitemap.xml` } : {},
-      ...baseUrl ? { host: baseUrl } : {}
+      ...options.host && baseUrl ? { host: baseUrl } : {}
     };
   };
 }
+
+// src/seo-paths.ts
+function resolveSeoLocales(config, siteConfig) {
+  const defaultLocale = config.defaultLocale ?? siteConfig?.defaultLanguage ?? "en";
+  const locales = config.enabledLocales && config.enabledLocales.length > 0 ? config.enabledLocales : siteConfig?.enabledLanguages && siteConfig.enabledLanguages.length > 0 ? siteConfig.enabledLanguages : [defaultLocale];
+  return { defaultLocale, locales };
+}
 function normalizeSlug(slug) {
   if (slug === "/" || slug === "") return "/";
   return slug.startsWith("/") ? slug : `/${slug}`;
 }
 function localizedPath(slug, locale, defaultLocale) {
-  const normalized = slug === "/" ? "" : slug;
-  return locale === defaultLocale ? normalized || "/" : `/${locale}${normalized}`;
+  const normalized = normalizeSlug(slug);
+  const base = normalized === "/" ? "" : normalized;
+  return locale === defaultLocale ? base || "/" : `/${locale}${base}`;
 }
+
+// src/create-cmssy-sitemap.ts
 function createCmssySitemap(config, options = {}) {
   const clientConfig = {
     apiUrl: config.apiUrl,
@@ -309,15 +319,15 @@ function createCmssySitemap(config, options = {}) {
       }
       pages = [];
     }
-    let notFoundPageId = null;
+    let siteConfig = null;
     try {
-      notFoundPageId = (await fetchSiteConfig(clientConfig))?.notFoundPageId ?? null;
+      siteConfig = await fetchSiteConfig(clientConfig);
     } catch {
-      notFoundPageId = null;
+      siteConfig = null;
     }
+    const notFoundPageId = siteConfig?.notFoundPageId ?? null;
     const baseUrl = await resolveSeoBaseUrl(config, options.baseUrl);
-    const defaultLocale = config.defaultLocale ?? "en";
-    const locales = config.enabledLocales && config.enabledLocales.length > 0 ? config.enabledLocales : [defaultLocale];
+    const { defaultLocale, locales } = resolveSeoLocales(config, siteConfig);
     const excluded = new Set((options.excludeSlugs ?? []).map(normalizeSlug));
     const entries = pages.map((page) => ({ ...page, slug: normalizeSlug(page.slug) })).filter((page) => page.id !== notFoundPageId && !excluded.has(page.slug)).map((page) => {
       const lastModified = page.updatedAt ?? page.publishedAt ?? void 0;
@@ -340,6 +350,67 @@ function createCmssySitemap(config, options = {}) {
     return options.extra ? [...entries, ...options.extra] : entries;
   };
 }
+function pick(value, locale, defaultLocale) {
+  if (!value) return "";
+  if (typeof value === "string") return value;
+  return value[locale] || value[defaultLocale] || Object.values(value)[0] || "";
+}
+async function buildCmssyMetadata(config, path, options = {}) {
+  const clientConfig = {
+    apiUrl: config.apiUrl,
+    workspaceSlug: config.workspaceSlug
+  };
+  const [meta, siteConfig, baseUrl] = await Promise.all([
+    fetchPageMeta(clientConfig, path).catch(() => null),
+    fetchSiteConfig(clientConfig).catch(() => null),
+    resolveSeoBaseUrl(config, options.baseUrl)
+  ]);
+  const { defaultLocale, locales: enabledLocales } = resolveSeoLocales(
+    config,
+    siteConfig
+  );
+  const locale = await config.resolveLocale?.() ?? defaultLocale;
+  const slug = normalizeSlug$1(path);
+  const siteName = pick(siteConfig?.siteName, locale, defaultLocale) || siteConfig?.branding?.brandName || void 0;
+  const title = pick(meta?.seoTitle, locale, defaultLocale) || pick(meta?.displayName, locale, defaultLocale) || siteName || "";
+  const description = pick(meta?.seoDescription, locale, defaultLocale);
+  const keywords = meta?.seoKeywords?.length ? meta.seoKeywords : void 0;
+  const image = options.image ?? siteConfig?.branding?.ogImageUrl ?? void 0;
+  const canonical = baseUrl ? `${baseUrl}${localizedPath(slug, locale, defaultLocale)}` : void 0;
+  const languages = baseUrl && enabledLocales.length > 1 ? Object.fromEntries(
+    enabledLocales.map((l) => [
+      l,
+      `${baseUrl}${localizedPath(slug, l, defaultLocale)}`
+    ])
+  ) : void 0;
+  return {
+    ...baseUrl ? { metadataBase: new URL(baseUrl) } : {},
+    ...title ? { title } : {},
+    ...description ? { description } : {},
+    ...keywords ? { keywords } : {},
+    ...canonical || languages ? {
+      alternates: {
+        ...canonical ? { canonical } : {},
+        ...languages ? { languages } : {}
+      }
+    } : {},
+    openGraph: {
+      ...title ? { title } : {},
+      ...description ? { description } : {},
+      ...canonical ? { url: canonical } : {},
+      ...siteName ? { siteName } : {},
+      type: options.ogType ?? "website",
+      locale,
+      ...image ? { images: [{ url: image }] } : {}
+    },
+    twitter: {
+      card: image ? options.twitterCard ?? "summary_large_image" : "summary",
+      ...title ? { title } : {},
+      ...description ? { description } : {},
+      ...image ? { images: [image] } : {}
+    }
+  };
+}
 var MIN_SECRET_LENGTH = 16;
 function secretsMatch(a, b) {
   const ha = createHash("sha256").update(a).digest();
@@ -1508,4 +1579,4 @@ function verifyCmssyWebhook(options) {
   return parsed;
 }
 
-export { CMSSY_CART_COOKIE, CMSSY_EDIT_HEADER, CMSSY_LOCALE_HEADER, CMSSY_SESSION_COOKIE, CmssyWebhookError, SESSION_MAX_AGE_SECONDS, applyCmssyCsp, assertAuthConfig, cmssyCspHeaders, createCmssyAuthMiddleware, createCmssyAuthRoute, createCmssyCartRoute, createCmssyLocaleMiddleware, createCmssyNotFound, createCmssyOrdersRoute, createCmssyPage, createCmssyRobots, createCmssySitemap, createDraftRoute, fetchProduct, fetchProducts, getCmssyAccessToken, getCmssyLocale, getCmssyUser, isAccessExpired, isCmssyEditMode, isCmssyEditRequest, localeForPathname, openSession, resolveLocaleFromPathname, sealSession, sessionCookieOptions, splitCmssyLocale, verifyCmssyWebhook };
+export { CMSSY_CART_COOKIE, CMSSY_EDIT_HEADER, CMSSY_LOCALE_HEADER, CMSSY_SESSION_COOKIE, CmssyWebhookError, SESSION_MAX_AGE_SECONDS, applyCmssyCsp, assertAuthConfig, buildCmssyMetadata, cmssyCspHeaders, createCmssyAuthMiddleware, createCmssyAuthRoute, createCmssyCartRoute, createCmssyLocaleMiddleware, createCmssyNotFound, createCmssyOrdersRoute, createCmssyPage, createCmssyRobots, createCmssySitemap, createDraftRoute, fetchProduct, fetchProducts, getCmssyAccessToken, getCmssyLocale, getCmssyUser, isAccessExpired, isCmssyEditMode, isCmssyEditRequest, localeForPathname, openSession, resolveLocaleFromPathname, sealSession, sessionCookieOptions, splitCmssyLocale, verifyCmssyWebhook };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cmssy/next",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "description": "Next.js App Router bindings for cmssy headless sites (createCmssyPage + draft preview)",
   "keywords": [
     "cmssy",
@@ -41,7 +41,7 @@
     "dist"
   ],
   "peerDependencies": {
-    "@cmssy/react": "^0.5.2",
+    "@cmssy/react": "^0.5.4",
     "next": ">=15",
     "react": "^18.2.0 || ^19.0.0",
     "react-dom": "^18.2.0 || ^19.0.0"
@@ -54,7 +54,7 @@
     "tsup": "^8.3.0",
     "typescript": "^5.6.0",
     "vitest": "^2.1.0",
-    "@cmssy/react": "0.5.2"
+    "@cmssy/react": "0.5.4"
   },
   "dependencies": {
     "jose": "^6.2.3"