fimo-next 2.2.0-staging.8 → 2.2.0

package/dist/config.d.ts

@@ -10,9 +10,10 @@ export type FimoNextConfig<TConfig extends object = object> = TConfig | FimoNext
  * which preview provider Fimo currently uses. When an application does not
  * configure Next's development indicator, hosted Preview hides it while local
  * development keeps Next's default. Explicit application config is preserved.
- * Every other phase returns the application config unchanged: the Fimo
- * connection is resolved by `FimoProvider` and the server runtime, not by this
- * config wrapper.
+ * Every phase additionally carries the file-tracing include for
+ * `.fimo/config.json` so `buildFimoMetadata` can read it in deployed SSR; the
+ * Fimo connection itself is resolved by `FimoProvider` and the server runtime,
+ * not by this config wrapper.
  */
 export declare function withFimo<TConfig extends object>(applicationConfig: FimoNextConfig<TConfig>): FimoNextConfigFactory<TConfig>;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.js

@@ -6,19 +6,33 @@ function readPreviewOrigins() {
         .map((origin) => origin.trim())
         .filter(Boolean);
 }
+// FIMO-2335: `buildFimoMetadata` reads `.fimo/config.json` at request time in
+// deployed SSR, but Next only traces files it can see statically — without
+// this include the file is missing from the server bundle.
+const FIMO_TRACING_INCLUDES = { '/**': ['.fimo/config.json'] };
+function withConfigTracing(config) {
+    const application = config.outputFileTracingIncludes;
+    const outputFileTracingIncludes = { ...FIMO_TRACING_INCLUDES };
+    for (const [route, files] of Object.entries(application ?? {})) {
+        outputFileTracingIncludes[route] = [...(outputFileTracingIncludes[route] ?? []), ...files];
+    }
+    return { ...config, outputFileTracingIncludes };
+}
 /**
  * Connect `next dev` to Fimo's hosted preview gateway. The platform supplies
  * the allowed preview origins at runtime, so applications do not need to know
  * which preview provider Fimo currently uses. When an application does not
  * configure Next's development indicator, hosted Preview hides it while local
  * development keeps Next's default. Explicit application config is preserved.
- * Every other phase returns the application config unchanged: the Fimo
- * connection is resolved by `FimoProvider` and the server runtime, not by this
- * config wrapper.
+ * Every phase additionally carries the file-tracing include for
+ * `.fimo/config.json` so `buildFimoMetadata` can read it in deployed SSR; the
+ * Fimo connection itself is resolved by `FimoProvider` and the server runtime,
+ * not by this config wrapper.
  */
 export function withFimo(applicationConfig) {
     return async (phase, context) => {
-        const config = typeof applicationConfig === 'function' ? await applicationConfig(phase, context) : applicationConfig;
+        const applied = typeof applicationConfig === 'function' ? await applicationConfig(phase, context) : applicationConfig;
+        const config = withConfigTracing(applied);
         if (phase !== NEXT_DEVELOPMENT_PHASE) {
             return config;
         }

package/dist/runtime/next/seo.d.ts

@@ -0,0 +1,17 @@
+import type { Metadata, Viewport } from 'next';
+/**
+ * Site-wide `Metadata` defaults resolved from `.fimo/config.json#seo` — the
+ * values edited in Studio's Settings → SEO. Wire it as the root layout's
+ * `generateMetadata`. Resolves the global (`/`) SEO only; page-level
+ * `metadata`/`generateMetadata` exports merge over these defaults, so
+ * per-page SEO stays application-owned. Returns `{}` when the project
+ * declares no SEO config.
+ */
+export declare function buildFimoMetadata(rootDir?: string): Metadata;
+/**
+ * Viewport counterpart of `buildFimoMetadata` — Next renders `theme-color`
+ * from the viewport export, not `Metadata`. Wire it as the root layout's
+ * `generateViewport`.
+ */
+export declare function buildFimoViewport(rootDir?: string): Viewport;
+//# sourceMappingURL=seo.d.ts.map

package/dist/runtime/next/seo.js

@@ -0,0 +1,59 @@
+import { getConfigServer } from 'fimo/config';
+import { resolveSeoForPath } from 'fimo/seo';
+function toMetadataBase(url) {
+    if (!url) {
+        return undefined;
+    }
+    try {
+        return new URL(url);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Site-wide `Metadata` defaults resolved from `.fimo/config.json#seo` — the
+ * values edited in Studio's Settings → SEO. Wire it as the root layout's
+ * `generateMetadata`. Resolves the global (`/`) SEO only; page-level
+ * `metadata`/`generateMetadata` exports merge over these defaults, so
+ * per-page SEO stays application-owned. Returns `{}` when the project
+ * declares no SEO config.
+ */
+export function buildFimoMetadata(rootDir = process.cwd()) {
+    const seo = resolveSeoForPath('/', getConfigServer(rootDir));
+    if (!seo) {
+        return {};
+    }
+    const metadataBase = toMetadataBase(seo.url);
+    return {
+        ...(seo.title ? { title: seo.title } : {}),
+        ...(seo.description ? { description: seo.description } : {}),
+        ...(metadataBase ? { metadataBase, alternates: { canonical: './' } } : {}),
+        ...(seo.robots ? { robots: seo.robots } : {}),
+        ...(seo.favicon ? { icons: { icon: seo.favicon, apple: seo.favicon } } : {}),
+        openGraph: {
+            type: 'website',
+            ...(seo.siteName ? { siteName: seo.siteName } : {}),
+            ...(seo.title ? { title: seo.title } : {}),
+            ...(seo.description ? { description: seo.description } : {}),
+            ...(seo.image ? { images: [seo.image] } : {}),
+            ...(seo.locale ? { locale: seo.locale } : {}),
+        },
+        twitter: {
+            card: 'summary_large_image',
+            ...(seo.twitterSite ? { site: seo.twitterSite } : {}),
+            ...(seo.title ? { title: seo.title } : {}),
+            ...(seo.description ? { description: seo.description } : {}),
+            ...(seo.image ? { images: [seo.image] } : {}),
+        },
+    };
+}
+/**
+ * Viewport counterpart of `buildFimoMetadata` — Next renders `theme-color`
+ * from the viewport export, not `Metadata`. Wire it as the root layout's
+ * `generateViewport`.
+ */
+export function buildFimoViewport(rootDir = process.cwd()) {
+    const seo = resolveSeoForPath('/', getConfigServer(rootDir));
+    return seo?.themeColor ? { themeColor: seo.themeColor } : {};
+}

package/dist/runtime/next/server.d.ts

@@ -8,6 +8,7 @@ export type { CreateFimoOptions, NextContentRegistry } from './facade.js';
 export { FimoProvider } from './server-provider.js';
 export type { FimoProviderProps } from './server-provider.js';
 export { getLabels } from './labels.js';
+export { buildFimoMetadata, buildFimoViewport } from './seo.js';
 export type { FormClient, FormSubmissionResult } from 'fimo/forms';
 export type { GetLabelsOptions, Labels, LabelsSnapshot } from 'fimo/labels';
 export type { FimoRichTextComponents, FimoRichTextMarkProps, FimoRichTextNodeProps, } from 'fimo-react/primitives/server';

package/dist/runtime/next/server.js

@@ -8,6 +8,7 @@ export { Boolean, Date, DateTime, Image, Json, RichText, Video } from './primiti
 export { createFimo } from './facade.js';
 export { FimoProvider } from './server-provider.js';
 export { getLabels } from './labels.js';
+export { buildFimoMetadata, buildFimoViewport } from './seo.js';
 export function createContentClient(config) {
     return createServerContentClient(config, nextServerContentRuntime);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fimo-next",
-  "version": "2.2.0-staging.8",
+  "version": "2.2.0",
   "description": "Fimo runtime for Next.js projects.",
   "files": [
     "dist/",
@@ -45,13 +45,13 @@
     "test:watch": "vitest"
   },
   "devDependencies": {
-    "@fimo/tsconfig": "2.2.0-staging.8",
+    "@fimo/tsconfig": "2.2.0",
     "@tanstack/react-query": "^5.80.6",
     "@types/node": "22.18.6",
     "@types/react": "19.2.14",
     "@types/react-dom": "19.2.3",
-    "fimo": "2.2.0-staging.8",
-    "fimo-react": "2.2.0-staging.8",
+    "fimo": "2.2.0",
+    "fimo-react": "2.2.0",
     "next": "16.3.3",
     "react": "19.2.4",
     "react-dom": "19.2.4",
@@ -60,7 +60,7 @@
   },
   "peerDependencies": {
     "@tanstack/react-query": "^5.80.6",
-    "fimo": "2.2.0-staging.8",
+    "fimo": ">=2.0.1",
     "fimo-react": ">=2.0.1",
     "next": "^15.0.0 || ^16.0.0",
     "react": "^18.2.0 || ^19.0.0",