fimo 2.4.0-staging.3 → 2.4.0-staging.5

package/dist/runtime/astro/server-runtime.js

@@ -9,8 +9,8 @@ export const astroServerContentRuntime = {
     headers(extra) {
         const headers = { ...extra };
         // `FIMO_ENV` is the variable name a customer's deployed build reads and
-        // keeps its spelling; only the header this build emits is canonical
-        // (branch-cutover ledger, F5). Builds already in production keep sending
+        // keeps its spelling; only the header this build emits is canonical.
+        // Builds already in production keep sending
         // `X-Fimo-Env`, which the API still accepts.
         const branch = import.meta.env.FIMO_ENV?.trim();
         if (branch) {

package/dist/runtime/paths/get-fimo-paths.js

@@ -47,7 +47,7 @@ async function fetchEntries(baseUrl, schema, rootDir, locale) {
     }
     const headers = {};
     // `FIMO_ENV` is a customer-facing variable name and keeps its spelling; the
-    // header this build emits is canonical (branch-cutover ledger, F5). A
+    // header this build emits is canonical. A
     // deployed site always talks to the current API, and builds produced by an
     // older `fimo` keep sending `X-Fimo-Env`, which the API still accepts.
     const branch = readEnvValue(rootDir, 'FIMO_ENV') ?? resolveLocalRuntimeEnv({ cwd: rootDir })?.env;

package/dist/runtime/shared/branch-identity.d.ts

@@ -19,8 +19,7 @@ export declare const PROD_BRANCH_PREFIX = "release/";
 export declare function isValidBranch(branch: string): boolean;
 /**
  * Mirror of `envResourceKey` in `@fimo/api-contracts`. Keeps that name on both
- * sides: its OUTPUT is a live tenant hostname and R2 prefix, and the symbol
- * rename is a later slice (branch-cutover ledger, F10).
+ * sides: its OUTPUT is a live tenant hostname and R2 prefix.
  */
 export declare function envResourceKey(branch: string): string;
 /** Mirror of `buildTenantApiUrl` in `@fimo/api-contracts`. */
@@ -32,15 +31,14 @@ export declare function buildTenantApiUrl(projectId: string, branch: string, ten
  * reads is one more line to reason about when a site talks to the wrong Branch.
  *
  * These are process-env variable names in a CUSTOMER's app; they keep their
- * `ENV` spelling (branch-cutover ledger, F3 "Preserve").
+ * `ENV` spelling.
  */
 export declare const LOCAL_CONTENT_API_ENV_KEYS: readonly ['FIMO_CONTENT_API_URL', 'VITE_API_URL', 'NEXT_PUBLIC_FIMO_API_URL', 'PUBLIC_FIMO_API_URL'];
 /**
  * Branch selectors a runtime turns into the Branch request header.
  *
  * `FIMO_ENV` / `NEXT_PUBLIC_FIMO_ENV` are the variable names a customer's
- * deployed build reads; renaming either breaks it (branch-cutover ledger,
- * "Names that must not be mechanically renamed").
+ * deployed build reads; renaming either breaks it.
  */
 export declare const LOCAL_ENV_SELECTOR_KEYS: readonly ['FIMO_ENV', 'NEXT_PUBLIC_FIMO_ENV'];
 /**

package/dist/runtime/shared/branch-identity.js

@@ -46,8 +46,7 @@ function fnv1a8(s) {
 }
 /**
  * Mirror of `envResourceKey` in `@fimo/api-contracts`. Keeps that name on both
- * sides: its OUTPUT is a live tenant hostname and R2 prefix, and the symbol
- * rename is a later slice (branch-cutover ledger, F10).
+ * sides: its OUTPUT is a live tenant hostname and R2 prefix.
  */
 export function envResourceKey(branch) {
     const base = branch
@@ -71,7 +70,7 @@ export function buildTenantApiUrl(projectId, branch, tenantApiBaseUrl) {
  * reads is one more line to reason about when a site talks to the wrong Branch.
  *
  * These are process-env variable names in a CUSTOMER's app; they keep their
- * `ENV` spelling (branch-cutover ledger, F3 "Preserve").
+ * `ENV` spelling.
  */
 export const LOCAL_CONTENT_API_ENV_KEYS = [
     'FIMO_CONTENT_API_URL',
@@ -83,8 +82,7 @@ export const LOCAL_CONTENT_API_ENV_KEYS = [
  * Branch selectors a runtime turns into the Branch request header.
  *
  * `FIMO_ENV` / `NEXT_PUBLIC_FIMO_ENV` are the variable names a customer's
- * deployed build reads; renaming either breaks it (branch-cutover ledger,
- * "Names that must not be mechanically renamed").
+ * deployed build reads; renaming either breaks it.
  */
 export const LOCAL_ENV_SELECTOR_KEYS = ['FIMO_ENV', 'NEXT_PUBLIC_FIMO_ENV'];
 /**

package/dist/scripts/export-static.d.ts

@@ -2,10 +2,9 @@ export interface ExportStaticOptions {
     cwd?: string;
 }
 /**
- * Post-build cleanup for `react-router build` output:
- * - Removes `dist/server/` (we ship a fully prerendered SPA, no SSR runtime needed)
- * - Removes `*.data` files (data is embedded in the prerendered HTML and
- *   never fetched because navigation uses full-page <a> loads)
+ * Removes `dist/server/` after a static React Router build. Requires
+ * `dist/client/` to exist and preserves its contents, including `*.data`
+ * files used by React Router client navigation or authored as static assets.
  *
  * Run from `react-router build && fimo export-static`.
  */

package/dist/scripts/export-static.js

@@ -9,23 +9,10 @@ async function pathExists(targetPath) {
         return false;
     }
 }
-async function removeDataFiles(dir) {
-    const entries = await fs.readdir(dir, { withFileTypes: true });
-    for (const entry of entries) {
-        const fullPath = path.join(dir, entry.name);
-        if (entry.isDirectory()) {
-            await removeDataFiles(fullPath);
-        }
-        else if (entry.name.endsWith('.data')) {
-            await fs.rm(fullPath);
-        }
-    }
-}
 /**
- * Post-build cleanup for `react-router build` output:
- * - Removes `dist/server/` (we ship a fully prerendered SPA, no SSR runtime needed)
- * - Removes `*.data` files (data is embedded in the prerendered HTML and
- *   never fetched because navigation uses full-page <a> loads)
+ * Removes `dist/server/` after a static React Router build. Requires
+ * `dist/client/` to exist and preserves its contents, including `*.data`
+ * files used by React Router client navigation or authored as static assets.
  *
  * Run from `react-router build && fimo export-static`.
  */
@@ -36,12 +23,8 @@ export async function exportStatic(options = {}) {
     if (!(await pathExists(clientDir))) {
         throw new Error('Missing dist/client output. Run `react-router build` first.');
     }
-    // In framework mode with buildDirectory=dist, the static output already lives in dist/client.
     if (await pathExists(serverDir)) {
         await fs.rm(serverDir, { recursive: true, force: true });
     }
-    // Remove .data files — all data is embedded in prerendered HTML.
-    // Navigation uses <a> tags (full page loads), so .data files are never fetched.
-    await removeDataFiles(clientDir);
     console.log('Static export complete.');
 }

package/dist/scripts/sync-schemas.js

@@ -144,6 +144,7 @@ function resolveProjectRuntime(cwd) {
         version,
         providesLegacyReactRuntime: packageExportsSubpath(packageJson, './ui'),
         providesReactRuntime: packageExportsSubpath(readProjectPackage(cwd, 'fimo-react'), '.'),
+        providesLegacyNextRuntime: packageExportsSubpath(packageJson, './next') && packageExportsSubpath(packageJson, './next/client'),
         providesNextRuntime: packageExportsSubpath(readProjectPackage(cwd, 'fimo-next'), '.') &&
             packageExportsSubpath(readProjectPackage(cwd, 'fimo-next'), './client'),
         providesAstroRuntime: packageExportsSubpath(packageJson, './astro'),
@@ -154,7 +155,7 @@ function resolveProjectRuntime(cwd) {
 }
 function contentRuntimeImportFor(framework, runtime) {
     if (framework === 'nextjs') {
-        return 'fimo-next';
+        return isVersionAtLeast(runtime.version, MINIMUM_FRAMEWORK_COMPANION_RUNTIME_VERSION) ? 'fimo-next' : 'fimo/next';
     }
     if (framework === 'astro') {
         return 'fimo/astro';
@@ -196,6 +197,12 @@ function resolveSchemaGenerationTarget(runtimeImport, runtime) {
     if (runtimeImport === 'fimo-react') {
         return 'react';
     }
+    if (runtimeImport === 'fimo/next' && !runtime.providesLegacyNextRuntime) {
+        throw new Error(`Cannot generate schema clients because project-local fimo@${runtime.version} does not provide the ` +
+            'legacy fimo/next and fimo/next/client exports required by this Next.js project. ' +
+            `Run \`${CONTENT_CLIENT_RUNTIME_UPGRADE_COMMAND}\` in the project, then run \`npx fimo@latest validate\` again. ` +
+            'No generated files were changed.');
+    }
     if (runtimeImport === 'fimo-next' && !runtime.providesNextRuntime) {
         throw new Error(`Cannot generate schema clients because the project does not provide the ` +
             'fimo-next and fimo-next/client exports required by this Next.js project. ' +
@@ -213,7 +220,7 @@ function resolveSchemaGenerationTarget(runtimeImport, runtime) {
             `Run \`npm install fimo-sveltekit@${runtime.version}\` in the project, then run \`npx fimo@latest validate\` again. ` +
             'No generated files were changed.');
     }
-    if (runtimeImport === 'fimo-next') {
+    if (runtimeImport === 'fimo/next' || runtimeImport === 'fimo-next') {
         return 'next';
     }
     return runtimeImport === 'fimo/astro' ? 'astro' : 'sveltekit';
@@ -224,17 +231,17 @@ function templatesForTarget(target, runtime, runtimeImport) {
             {
                 suffix: '.types.ts',
                 path: templatePath(runtime, 'types'),
-                runtimeImport: 'fimo-next',
+                runtimeImport,
             },
             {
                 suffix: '.ts',
                 path: templatePath(runtime, 'nextServer'),
-                runtimeImport: 'fimo-next',
+                runtimeImport,
             },
             {
                 suffix: '.client.ts',
                 path: templatePath(runtime, 'nextClient'),
-                runtimeImport: 'fimo-next/client',
+                runtimeImport: `${runtimeImport}/client`,
             },
         ];
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fimo",
-  "version": "2.4.0-staging.3",
+  "version": "2.4.0-staging.5",
   "description": "Fimo CLI - create, deploy, and manage Fimo projects",
   "keywords": [
     "astro-component"
@@ -193,13 +193,13 @@
   "devDependencies": {
     "@clack/core": "^1.2.0",
     "@clack/prompts": "^1.2.0",
-    "@fimo/agents-bundle": "2.4.0-staging.3",
-    "@fimo/api-contracts": "2.4.0-staging.3",
-    "@fimo/cli-kit": "2.4.0-staging.3",
-    "@fimo/framework-detect": "2.4.0-staging.3",
-    "@fimo/routes": "2.4.0-staging.3",
-    "@fimo/sdk": "2.4.0-staging.3",
-    "@fimo/tsconfig": "2.4.0-staging.3",
+    "@fimo/agents-bundle": "2.4.0-staging.5",
+    "@fimo/api-contracts": "2.4.0-staging.5",
+    "@fimo/cli-kit": "2.4.0-staging.5",
+    "@fimo/framework-detect": "2.4.0-staging.5",
+    "@fimo/routes": "2.4.0-staging.5",
+    "@fimo/sdk": "2.4.0-staging.5",
+    "@fimo/tsconfig": "2.4.0-staging.5",
     "@types/node": "22.18.6",
     "agent-install": "^0.0.5",
     "astro": "^7.1.6",

package/templates/astro/package.json

@@ -9,8 +9,8 @@
     "check": "astro sync && astro check"
   },
   "dependencies": {
-    "fimo": "2.4.0-staging.3",
-    "fimo-astro": "2.4.0-staging.3"
+    "fimo": "2.4.0-staging.5",
+    "fimo-astro": "2.4.0-staging.5"
   },
   "devDependencies": {
     "@astrojs/check": "^0.9.10",

package/templates/nextjs/package.json

@@ -12,9 +12,9 @@
   },
   "dependencies": {
     "@tanstack/react-query": "^5.80.6",
-    "fimo": "2.4.0-staging.3",
-    "fimo-next": "2.4.0-staging.3",
-    "fimo-react": "2.4.0-staging.3",
+    "fimo": "2.4.0-staging.5",
+    "fimo-next": "2.4.0-staging.5",
+    "fimo-react": "2.4.0-staging.5",
     "next": "^16.3.3",
     "react": "^19.2.7",
     "react-dom": "^19.2.7"

package/templates/react-router/package.json

@@ -21,10 +21,10 @@
     "cn": "0.2.4",
     "date-fns": "^4.1.0",
     "embla-carousel-react": "^8.6.0",
-    "fimo": "2.4.0-staging.3",
-    "fimo-react": "2.4.0-staging.3",
-    "fimo-react-router": "2.4.0-staging.3",
-    "fimo-vite": "2.4.0-staging.3",
+    "fimo": "2.4.0-staging.5",
+    "fimo-react": "2.4.0-staging.5",
+    "fimo-react-router": "2.4.0-staging.5",
+    "fimo-vite": "2.4.0-staging.5",
     "input-otp": "^1.4.2",
     "isbot": "^5",
     "lucide-react": "^0.577.0",

package/templates/sveltekit/package.json

@@ -11,8 +11,8 @@
     "prepare": "svelte-kit sync"
   },
   "dependencies": {
-    "fimo": "2.4.0-staging.3",
-    "fimo-sveltekit": "2.4.0-staging.3"
+    "fimo": "2.4.0-staging.5",
+    "fimo-sveltekit": "2.4.0-staging.5"
   },
   "devDependencies": {
     "@sveltejs/kit": "^2.70.2",

package/templates/vite/package.json

@@ -11,10 +11,10 @@
   },
   "dependencies": {
     "@tanstack/react-query": "^5.80.6",
-    "fimo": "2.4.0-staging.3",
-    "fimo-react": "2.4.0-staging.3",
-    "fimo-react-router": "2.4.0-staging.3",
-    "fimo-vite": "2.4.0-staging.3",
+    "fimo": "2.4.0-staging.5",
+    "fimo-react": "2.4.0-staging.5",
+    "fimo-react-router": "2.4.0-staging.5",
+    "fimo-vite": "2.4.0-staging.5",
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
     "react-router": "^8.3.0"