fimo 0.8.0 → 0.9.0-experimental.10

package/dist/runtime/seo/neutral.js

@@ -0,0 +1,17 @@
+import { getConfigServer } from '../shared/fimo-config.server.js';
+import { resolveSeoForPath } from './resolver.js';
+/**
+ * The framework-neutral `fimo/seo` surface: pure per-page SEO resolution over
+ * the page registry (`fimo-config.json#routes`), with no framework adapter,
+ * no vite virtual module, and no React. Every framework's injection recipe
+ * (Next `generateMetadata`, an Astro head component, a SvelteKit load) calls
+ * `getFimoSeoForPath` server-side and maps the result to its own head API.
+ * SEO stays wired only when the project owner explicitly opted into
+ * Fimo-managed SEO — the migration never wires it by default.
+ */
+export { resolveSeoForPath } from './resolver.js';
+/** Resolve the SEO values for one page path from the page registry on disk. */
+export function getFimoSeoForPath(pathname, options = {}) {
+    const config = getConfigServer(options.rootDir ?? process.cwd());
+    return resolveSeoForPath(pathname, config, options.routeData);
+}

package/dist/runtime/shared/display-routes.d.ts

@@ -0,0 +1,14 @@
+import type { FimoConfig } from './fimo-config.types.js';
+export interface ParamInfo {
+    schema: string;
+    queryField: string;
+    displayField: string;
+}
+export interface DisplayRoute {
+    id: string;
+    name: string;
+    path: string;
+    params?: Record<string, ParamInfo>;
+}
+export declare function getDisplayRoutes(config: Pick<FimoConfig, 'routes'> | undefined): DisplayRoute[];
+//# sourceMappingURL=display-routes.d.ts.map

package/dist/runtime/shared/display-routes.js

@@ -0,0 +1,25 @@
+const titleCase = (seg) => seg
+    .replace(/[_\-]+/g, ' ')
+    .replace(/([a-z])([A-Z])/g, '$1 $2')
+    .split(/\s+/)
+    .filter(Boolean)
+    .map((w) => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase())
+    .join(' ');
+const generateRouteName = (path) => {
+    if (path === '/') {
+        return 'Home';
+    }
+    const firstSegment = path.replace(/^\//, '').split('/')[0];
+    return titleCase(firstSegment);
+};
+export function getDisplayRoutes(config) {
+    const configRoutes = config?.routes ?? {};
+    return Object.entries(configRoutes)
+        .filter(([, route]) => route.path)
+        .map(([id, route]) => ({
+        id,
+        path: route.path,
+        name: route.name || route.label || generateRouteName(route.path),
+        params: route.params,
+    }));
+}

package/dist/runtime/shared/fimo-config.server.d.ts

@@ -4,5 +4,4 @@ import type { FimoConfig } from './fimo-config.types.js';
  * Reads JSON directly to avoid virtual module issues during config loading.
  */
 export declare function getConfigServer(rootDir: string): FimoConfig;
-export declare function getConfigVersion(rootDir: string): number;
 //# sourceMappingURL=fimo-config.server.d.ts.map

package/dist/runtime/shared/fimo-config.server.js

@@ -2,7 +2,6 @@ import { readFileSync } from 'fs';
 import { resolve } from 'path';
 // Matches the template's fimo-config.json (`version: "4"`) and the agents
 // workspace default — the fallback when a config omits the field.
-const LATEST_TEMPLATE_VERSION = 4;
 const defaultConfig = {
     seo: undefined,
 };
@@ -20,21 +19,10 @@ export function getConfigServer(rootDir) {
             i18n: raw.i18n,
             routes: raw.routes,
             version: raw.version,
+            framework: raw.framework,
         };
     }
     catch {
         return defaultConfig;
     }
 }
-export function getConfigVersion(rootDir) {
-    try {
-        const configPath = resolve(rootDir, 'fimo-config.json');
-        const content = readFileSync(configPath, 'utf-8');
-        const raw = JSON.parse(content);
-        const parsed = Number.parseInt(String(raw.version ?? LATEST_TEMPLATE_VERSION), 10);
-        return Number.isFinite(parsed) && parsed > 0 ? parsed : LATEST_TEMPLATE_VERSION;
-    }
-    catch {
-        return LATEST_TEMPLATE_VERSION;
-    }
-}

package/dist/runtime/shared/fimo-config.types.d.ts

@@ -57,5 +57,7 @@ export interface FimoConfig {
     i18n?: FimoI18nConfig;
     routes?: Record<string, FimoRouteConfig>;
     version?: string | number;
+    /** The project's framework. Absent means the Fimo template (react-router). */
+    framework?: 'react-router' | 'next' | string;
 }
 //# sourceMappingURL=fimo-config.types.d.ts.map

package/dist/runtime/shared/i18n-messages.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Lossless bridge between a nested i18n message store (next-intl / i18next
+ * style: `{ home: { title: "…" } }`) and Fimo's FLAT per-locale label map
+ * (`{ "home.title": "…" }`). Ingestion flattens the store into labels;
+ * `loadFimoMessages` un-flattens the labels back so the app's own i18n
+ * runtime keeps rendering unchanged, now sourced from Fimo.
+ *
+ * String leaves and nested objects round-trip byte-for-byte, ICU strings
+ * (`{count, plural, …}`, `<tag>…</tag>`) kept opaque. Array/number/boolean
+ * leaves are rare in message stores and are NOT flattened — they stay in the
+ * caller's static base (deep-merged under the Fimo bundle).
+ */
+/** Flatten a nested message object to dot-keyed string entries. Non-string
+ *  leaves (arrays, numbers) are skipped — reported so the caller can note
+ *  them. Keys already containing a dot are preserved verbatim. */
+export declare function flattenMessages(messages: unknown, prefix?: string): {
+    flat: Record<string, string>;
+    skipped: string[];
+};
+/** Rebuild the nested message object from a flat dot-keyed map. Inverse of
+ *  flattenMessages for string leaves. A key whose path collides with an
+ *  already-set string (e.g. both `a` and `a.b` exist) keeps the deeper
+ *  object and drops the scalar — message stores never have both. */
+export declare function unflattenMessages(flat: Record<string, string>): Record<string, unknown>;
+/** Deep-merge `override` (Fimo bundle) over `base` (static messages) so keys
+ *  absent from Fimo fall back to the shipped file instead of next-intl's
+ *  MISSING_MESSAGE. Objects merge recursively; leaves in `override` win. */
+export declare function deepMergeMessages(base: Record<string, unknown>, override: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=i18n-messages.d.ts.map

package/dist/runtime/shared/i18n-messages.js

@@ -0,0 +1,79 @@
+/**
+ * Lossless bridge between a nested i18n message store (next-intl / i18next
+ * style: `{ home: { title: "…" } }`) and Fimo's FLAT per-locale label map
+ * (`{ "home.title": "…" }`). Ingestion flattens the store into labels;
+ * `loadFimoMessages` un-flattens the labels back so the app's own i18n
+ * runtime keeps rendering unchanged, now sourced from Fimo.
+ *
+ * String leaves and nested objects round-trip byte-for-byte, ICU strings
+ * (`{count, plural, …}`, `<tag>…</tag>`) kept opaque. Array/number/boolean
+ * leaves are rare in message stores and are NOT flattened — they stay in the
+ * caller's static base (deep-merged under the Fimo bundle).
+ */
+/** Flatten a nested message object to dot-keyed string entries. Non-string
+ *  leaves (arrays, numbers) are skipped — reported so the caller can note
+ *  them. Keys already containing a dot are preserved verbatim. */
+export function flattenMessages(messages, prefix = '') {
+    const flat = {};
+    const skipped = [];
+    if (!messages || typeof messages !== 'object' || Array.isArray(messages)) {
+        return { flat, skipped };
+    }
+    for (const [key, value] of Object.entries(messages)) {
+        const path = prefix ? `${prefix}.${key}` : key;
+        if (typeof value === 'string') {
+            flat[path] = value;
+        }
+        else if (value && typeof value === 'object' && !Array.isArray(value)) {
+            const nested = flattenMessages(value, path);
+            Object.assign(flat, nested.flat);
+            skipped.push(...nested.skipped);
+        }
+        else {
+            skipped.push(path);
+        }
+    }
+    return { flat, skipped };
+}
+/** Rebuild the nested message object from a flat dot-keyed map. Inverse of
+ *  flattenMessages for string leaves. A key whose path collides with an
+ *  already-set string (e.g. both `a` and `a.b` exist) keeps the deeper
+ *  object and drops the scalar — message stores never have both. */
+export function unflattenMessages(flat) {
+    const root = {};
+    for (const [flatKey, value] of Object.entries(flat)) {
+        const parts = flatKey.split('.');
+        let node = root;
+        for (let i = 0; i < parts.length - 1; i += 1) {
+            const part = parts[i];
+            const existing = node[part];
+            if (!existing || typeof existing !== 'object' || Array.isArray(existing)) {
+                node[part] = {};
+            }
+            node = node[part];
+        }
+        node[parts[parts.length - 1]] = value;
+    }
+    return root;
+}
+/** Deep-merge `override` (Fimo bundle) over `base` (static messages) so keys
+ *  absent from Fimo fall back to the shipped file instead of next-intl's
+ *  MISSING_MESSAGE. Objects merge recursively; leaves in `override` win. */
+export function deepMergeMessages(base, override) {
+    const out = { ...base };
+    for (const [key, value] of Object.entries(override)) {
+        const current = out[key];
+        if (value &&
+            typeof value === 'object' &&
+            !Array.isArray(value) &&
+            current &&
+            typeof current === 'object' &&
+            !Array.isArray(current)) {
+            out[key] = deepMergeMessages(current, value);
+        }
+        else {
+            out[key] = value;
+        }
+    }
+    return out;
+}

package/dist/runtime/shared/labels-fetch.pure.d.ts

@@ -0,0 +1,17 @@
+export interface LabelBundle {
+    dictionaries: Record<string, Record<string, string>>;
+    defaultLocale: string;
+    locales: string[];
+    updatedAt: string | null;
+}
+export declare const API_URL_ENV_KEYS: readonly ["VITE_API_URL", "NEXT_PUBLIC_FIMO_API_URL", "NUXT_PUBLIC_FIMO_API_URL", "PUBLIC_FIMO_API_URL", "FIMO_API_URL"];
+export declare function resolveTenantApiUrl(env: Record<string, string>): string | undefined;
+export declare function serializeBundle(bundle: LabelBundle): string;
+export declare function fetchLabelDictionary(apiUrl: string, locale: string): Promise<{
+    locale: string;
+    labels: Record<string, string>;
+    updatedAt: string | null;
+}>;
+export declare function fetchLabelBundle(apiUrl: string, locales: string[], defaultLocale: string): Promise<LabelBundle>;
+export declare function fetchWithTimeout(url: URL, timeoutMs: number): Promise<Response>;
+//# sourceMappingURL=labels-fetch.pure.d.ts.map

package/dist/runtime/shared/labels-fetch.pure.js

@@ -0,0 +1,71 @@
+// Label fetching, PURE core: fetch/URL/AbortController only — no node
+// builtins, importable from client-bundled code (Nuxt composables, universal
+// SFCs). The node-flavored wrapper (env-file reading, config, signatures)
+// lives in labels-fetch.server.ts.
+// The tenant API base URL env var, in framework flavor order.
+export const API_URL_ENV_KEYS = [
+    'VITE_API_URL',
+    'NEXT_PUBLIC_FIMO_API_URL',
+    'NUXT_PUBLIC_FIMO_API_URL',
+    'PUBLIC_FIMO_API_URL',
+    'FIMO_API_URL',
+];
+export function resolveTenantApiUrl(env) {
+    for (const key of API_URL_ENV_KEYS) {
+        if (env[key]) {
+            return env[key];
+        }
+    }
+    return undefined;
+}
+export function serializeBundle(bundle) {
+    return JSON.stringify({
+        dictionaries: bundle.dictionaries,
+        defaultLocale: bundle.defaultLocale,
+        locales: bundle.locales,
+    });
+}
+export async function fetchLabelDictionary(apiUrl, locale) {
+    const url = new URL('/labels', apiUrl);
+    url.searchParams.set('locale', locale);
+    const response = await fetchWithTimeout(url, 4000);
+    if (!response.ok) {
+        return { locale, labels: {}, updatedAt: null };
+    }
+    const body = (await response.json());
+    if (Array.isArray(body.data)) {
+        return {
+            locale,
+            labels: Object.fromEntries(body.data.map((row) => [row.key, row.value ?? row.defaultValue ?? ''])),
+            updatedAt: null,
+        };
+    }
+    return {
+        locale,
+        labels: body.data?.labels ?? {},
+        updatedAt: body.data?.updatedAt ?? null,
+    };
+}
+export async function fetchLabelBundle(apiUrl, locales, defaultLocale) {
+    const loaded = await Promise.all(locales.map((locale) => fetchLabelDictionary(apiUrl, locale).catch(() => ({ locale, labels: {}, updatedAt: null }))));
+    const sortedUpdatedAt = loaded
+        .map((entry) => entry.updatedAt)
+        .filter((value) => typeof value === 'string')
+        .sort();
+    return {
+        dictionaries: Object.fromEntries(loaded.map((entry) => [entry.locale, entry.labels])),
+        defaultLocale,
+        locales,
+        updatedAt: sortedUpdatedAt[sortedUpdatedAt.length - 1] ?? null,
+    };
+}
+export async function fetchWithTimeout(url, timeoutMs) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        return await fetch(url, { signal: controller.signal });
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}

package/dist/runtime/shared/labels-fetch.server.d.ts

@@ -0,0 +1,7 @@
+import { type LabelBundle } from './labels-fetch.pure.js';
+export { API_URL_ENV_KEYS, fetchLabelBundle, fetchLabelDictionary, fetchWithTimeout, resolveTenantApiUrl, serializeBundle, type LabelBundle, } from './labels-fetch.pure.js';
+export declare function labelSignature(bundle: LabelBundle): string;
+export declare function emptyLabelBundle(rootDir: string): LabelBundle;
+export declare function loadLabelBundle(rootDir: string): Promise<LabelBundle>;
+export declare function readProjectEnv(rootDir: string): Promise<Record<string, string>>;
+//# sourceMappingURL=labels-fetch.server.d.ts.map

package/dist/runtime/shared/labels-fetch.server.js

@@ -0,0 +1,97 @@
+// Framework-neutral label fetching (server-side). Shared by the Vite
+// translations plugin (fimo/vite) and the Next server loaders (fimo/next/server).
+// The fetch core is in labels-fetch.pure.ts (client-safe); this module adds
+// the node-flavored parts: env-file reading, config resolution, signatures.
+import { Buffer } from 'node:buffer';
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { getFimoDefaultLocale, getFimoLocales } from '../i18n/locale.js';
+import { getConfigServer } from './fimo-config.server.js';
+import { API_URL_ENV_KEYS, fetchLabelBundle, serializeBundle, } from './labels-fetch.pure.js';
+export { API_URL_ENV_KEYS, fetchLabelBundle, fetchLabelDictionary, fetchWithTimeout, resolveTenantApiUrl, serializeBundle, } from './labels-fetch.pure.js';
+export function labelSignature(bundle) {
+    return Buffer.from(serializeBundle(bundle)).toString('base64');
+}
+export function emptyLabelBundle(rootDir) {
+    const config = getConfigServer(rootDir);
+    const defaultLocale = getFimoDefaultLocale(config);
+    const locales = getFimoLocales(config);
+    return {
+        dictionaries: Object.fromEntries(locales.map((locale) => [locale, {}])),
+        defaultLocale,
+        locales,
+        updatedAt: null,
+    };
+}
+export async function loadLabelBundle(rootDir) {
+    const config = getConfigServer(rootDir);
+    const defaultLocale = getFimoDefaultLocale(config);
+    const locales = getFimoLocales(config);
+    const env = await readProjectEnv(rootDir);
+    const apiUrl = resolveTenantApiUrlFromEnv(env);
+    if (!apiUrl) {
+        return {
+            dictionaries: Object.fromEntries(locales.map((locale) => [locale, {}])),
+            defaultLocale,
+            locales,
+            updatedAt: null,
+        };
+    }
+    try {
+        return await fetchLabelBundle(apiUrl, locales, defaultLocale);
+    }
+    catch {
+        return {
+            dictionaries: Object.fromEntries(locales.map((locale) => [locale, {}])),
+            defaultLocale,
+            locales,
+            updatedAt: null,
+        };
+    }
+}
+function resolveTenantApiUrlFromEnv(env) {
+    for (const key of API_URL_ENV_KEYS) {
+        if (env[key]) {
+            return env[key];
+        }
+    }
+    return undefined;
+}
+export async function readProjectEnv(rootDir) {
+    const values = {
+        ...(await readEnvFile(join(rootDir, '.env'))),
+        ...(await readEnvFile(join(rootDir, '.env.local'))),
+    };
+    for (const key of API_URL_ENV_KEYS) {
+        if (process.env[key]) {
+            values[key] = process.env[key];
+        }
+    }
+    return values;
+}
+async function readEnvFile(filePath) {
+    try {
+        const content = await readFile(filePath, 'utf8');
+        const values = {};
+        for (const line of content.split(/\r?\n/)) {
+            const trimmed = line.trim();
+            if (!trimmed || trimmed.startsWith('#')) {
+                continue;
+            }
+            const index = trimmed.indexOf('=');
+            if (index === -1) {
+                continue;
+            }
+            const key = trimmed.slice(0, index).trim();
+            const value = trimmed
+                .slice(index + 1)
+                .trim()
+                .replace(/^['"]|['"]$/g, '');
+            values[key] = value;
+        }
+        return values;
+    }
+    catch {
+        return {};
+    }
+}

package/dist/runtime/shared/labels-t.pure.d.ts

@@ -0,0 +1,2 @@
+export declare function makeFimoT(labels: Record<string, string> | null | undefined): (key: string, fallback?: string) => string;
+//# sourceMappingURL=labels-t.pure.d.ts.map

package/dist/runtime/shared/labels-t.pure.js

@@ -0,0 +1,10 @@
+// Pure label accessor factory — no node builtins, no framework imports.
+// Template frameworks load the dictionary server-side (+layout.server.ts
+// load, a Vue data service, …), hand it to components through their own
+// data flow, and build `t` locally:
+//
+//   const t = makeFimoT(data.fimoLabels);
+//   <h1 {...fimoLabelAttrs('hero.title')}>{t('hero.title', 'Fallback')}</h1>
+export function makeFimoT(labels) {
+    return (key, fallback = '') => labels?.[key] ?? fallback;
+}

package/dist/runtime/strapi/client.d.ts

@@ -0,0 +1,30 @@
+import { type FimoServerOptions } from '../wrapped/server.js';
+import { type FieldShapes } from './reshape.js';
+export interface FimoStrapiFetchOptions extends FimoServerOptions {
+    /** Strapi REST path segment (pluralName) → Fimo type name. */
+    types: Record<string, string>;
+    /** Fimo type names that are single types (served as `{data:{}}`, not a list). */
+    singletons?: string[];
+    /** Path prefix before the content segment (Strapi default `/api`). */
+    apiPrefix?: string;
+    /** Per-type structural field-shape manifest (single-component unwrap + block
+     *  item reshaping). Baked by the migration; absent → pure value-inspection. */
+    fieldShapes?: Record<string, FieldShapes>;
+}
+export interface ParsedStrapiUrl {
+    pluralName: string;
+    documentId?: string;
+    locale?: string;
+    pageSize?: number;
+    where?: Record<string, unknown>;
+}
+/**
+ * Parse a Strapi REST URL into the parts the Fimo read needs. Best-effort:
+ * pagination + locale + top-level `$eq` filters (enough for list, detail-by-slug,
+ * and singleton reads); richer `qs` filters are ignored (fake content tolerates
+ * an unfiltered set).
+ */
+export declare function parseStrapiUrl(rawUrl: string, apiPrefix?: string): ParsedStrapiUrl | null;
+/** Build a `fetch`-compatible function that serves scaffolded content from Fimo. */
+export declare function createFimoStrapiFetch(options: FimoStrapiFetchOptions, realFetch?: typeof fetch): typeof fetch;
+//# sourceMappingURL=client.d.ts.map

package/dist/runtime/strapi/client.js

@@ -0,0 +1,132 @@
+// Native `fimo/strapi` read adapter — the generic interception point. Every
+// Strapi client (hand-rolled or `@strapi/client`) ultimately does a single
+// `fetch(<strapiRestUrl>)`; this returns a `fetch`-compatible function that
+// serves that request from Fimo (via `fetchEntries` + the reshape) when the URL
+// maps to a scaffolded content type, and transparently falls through to the
+// real fetch (the live CMS) otherwise. Intercepting at the fetch boundary is
+// what makes "any Strapi project" work — the client's method surface is
+// irrelevant.
+import { fetchEntries } from '../wrapped/server.js';
+import { fimoEntriesToStrapiList, fimoEntryToStrapiSingle } from './reshape.js';
+function positiveInt(value) {
+    if (value == null) {
+        return undefined;
+    }
+    const n = Number(value);
+    return Number.isFinite(n) && n > 0 ? n : undefined;
+}
+/**
+ * Parse a Strapi REST URL into the parts the Fimo read needs. Best-effort:
+ * pagination + locale + top-level `$eq` filters (enough for list, detail-by-slug,
+ * and singleton reads); richer `qs` filters are ignored (fake content tolerates
+ * an unfiltered set).
+ */
+export function parseStrapiUrl(rawUrl, apiPrefix = '/api') {
+    let url;
+    try {
+        url = new URL(rawUrl, 'http://fimo.local');
+    }
+    catch {
+        return null;
+    }
+    const marker = `${apiPrefix}/`;
+    const at = url.pathname.indexOf(marker);
+    if (at === -1) {
+        return null;
+    }
+    const segments = url.pathname
+        .slice(at + marker.length)
+        .split('/')
+        .filter(Boolean);
+    if (segments.length === 0) {
+        return null;
+    }
+    const q = url.searchParams;
+    const where = {};
+    for (const [key, value] of q.entries()) {
+        const eq = key.match(/^filters\[([^\][]+)\]\[\$eq\]$/);
+        if (eq) {
+            where[eq[1]] = value;
+        }
+    }
+    return {
+        pluralName: segments[0],
+        documentId: segments[1],
+        locale: q.get('locale') ?? undefined,
+        pageSize: positiveInt(q.get('pagination[pageSize]') ?? q.get('pagination[limit]')),
+        where: Object.keys(where).length > 0 ? where : undefined,
+    };
+}
+const isDev = () => typeof process !== 'undefined' && process.env != null && process.env.NODE_ENV !== 'production';
+/** Build a `fetch`-compatible function that serves scaffolded content from Fimo. */
+export function createFimoStrapiFetch(options, realFetch = fetch) {
+    const singletons = new Set(options.singletons ?? []);
+    const read = { apiUrl: options.apiUrl, rootDir: options.rootDir };
+    // Lowercased type-name index, used only to flag a *near-miss* fallthrough: a
+    // path segment that looks like a scaffolded type but doesn't match a TYPES key
+    // (the classic singular-vs-plural keying bug). Genuinely foreign paths
+    // (`/api/upload/files`) don't match and stay silent.
+    const typeNamesLower = new Set(Object.values(options.types).map((name) => name.toLowerCase()));
+    const warnedPaths = new Set();
+    const warnNearMiss = (segment) => {
+        if (!isDev() || warnedPaths.has(segment)) {
+            return;
+        }
+        const seg = segment.toLowerCase();
+        const nearMiss = typeNamesLower.has(seg) ||
+            typeNamesLower.has(seg.replace(/s$/, '')) ||
+            typeNamesLower.has(seg.replace(/ies$/, 'y'));
+        if (nearMiss) {
+            warnedPaths.add(segment);
+            console.warn(`[fimo/strapi] /api/${segment} looks like a scaffolded type but is not in the type map — ` +
+                `this read fell through to the live CMS. If a single type reads empty, its map key is likely ` +
+                `plural where the fetch is singular (regenerate with \`fimo migrate --scaffold-cms\`).`);
+        }
+    };
+    return (async (input, init) => {
+        const rawUrl = typeof input === 'string' ? input : input instanceof URL ? input.href : input.url;
+        const parsed = parseStrapiUrl(rawUrl ?? '', options.apiPrefix);
+        const typeName = parsed ? options.types[parsed.pluralName] : undefined;
+        if (!parsed || !typeName) {
+            if (parsed) {
+                warnNearMiss(parsed.pluralName);
+            }
+            return realFetch(input, init); // not a mapped content read → real CMS
+        }
+        const entries = await fetchEntries(typeName, {
+            ...read,
+            ...(parsed.where ? { where: parsed.where } : {}),
+            ...(parsed.pageSize ? { limit: parsed.pageSize } : {}),
+        });
+        const shapes = options.fieldShapes?.[typeName];
+        const single = Boolean(parsed.documentId) || singletons.has(typeName);
+        if (entries.length === 0) {
+            // A FILTERED miss on a type Fimo owns (it has entries) answers with the
+            // honest empty envelope — the document just doesn't exist. Falling
+            // through here would leak every unknown-slug read (404s included) to the
+            // old CMS: dead-CMS timeouts, and content resurrection when it's alive.
+            if (parsed.where || parsed.documentId) {
+                const any = await fetchEntries(typeName, { ...read, limit: 1 });
+                if (any.length > 0) {
+                    // Canonical Strapi shapes: collection miss → 200 `{data: []}`,
+                    // document miss → 404 with the Strapi error body.
+                    const empty = single
+                        ? { data: null, error: { status: 404, name: 'NotFoundError', message: 'Not Found', details: {} } }
+                        : fimoEntriesToStrapiList([], { pageSize: parsed.pageSize, total: 0, shapes });
+                    return new Response(JSON.stringify(empty), {
+                        status: single ? 404 : 200,
+                        headers: { 'content-type': 'application/json' },
+                    });
+                }
+            }
+            return realFetch(input, init); // nothing scaffolded → fall back to the CMS
+        }
+        const payload = single
+            ? fimoEntryToStrapiSingle(parsed.documentId ? (entries.find((e) => e.id === parsed.documentId) ?? entries[0]) : entries[0], shapes)
+            : fimoEntriesToStrapiList(entries, { pageSize: parsed.pageSize, total: entries.length, shapes });
+        return new Response(JSON.stringify(payload), {
+            status: 200,
+            headers: { 'content-type': 'application/json' },
+        });
+    });
+}

package/dist/runtime/strapi/index.d.ts

@@ -0,0 +1,5 @@
+export { createFimoStrapiFetch, parseStrapiUrl } from './client.js';
+export type { FimoStrapiFetchOptions, ParsedStrapiUrl } from './client.js';
+export { fimoEntriesToStrapiList, fimoEntryToStrapiItem, fimoEntryToStrapiSingle } from './reshape.js';
+export type { StrapiListEnvelope, StrapiPagination, StrapiSingleEnvelope } from './reshape.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/strapi/index.js

@@ -0,0 +1,6 @@
+// `fimo/strapi` — native read adapter that serves a wrapped Strapi frontend's
+// content from Fimo. Drop `createFimoStrapiFetch(...)` in at the CMS client's
+// single `fetch` and every read (list, detail, singleton) is served from Fimo,
+// falling through to the live CMS for anything not scaffolded.
+export { createFimoStrapiFetch, parseStrapiUrl } from './client.js';
+export { fimoEntriesToStrapiList, fimoEntryToStrapiItem, fimoEntryToStrapiSingle } from './reshape.js';

package/dist/runtime/strapi/reshape.d.ts

@@ -0,0 +1,50 @@
+import type { FimoEntry } from '../wrapped/server.js';
+export interface StrapiPagination {
+    page: number;
+    pageSize: number;
+    pageCount: number;
+    total: number;
+}
+export interface StrapiListEnvelope {
+    data: Record<string, unknown>[];
+    meta: {
+        pagination: StrapiPagination;
+    };
+}
+export interface StrapiSingleEnvelope {
+    data: Record<string, unknown> | null;
+    meta: Record<string, unknown>;
+}
+/**
+ * The field-shape manifest, baked into the generated `fimo-strapi.ts` by the
+ * migration. It carries the structural (blocks) fields — a Fimo blocks value
+ * is always an array, but a Strapi single component reads as an object, so
+ * the reshape needs to know which array to unwrap — plus to-many relations
+ * ('many-ref'), whose array invariant value-inspection cannot hold on its
+ * own. Other leaf fields (scalars, media, richtext, single references) never
+ * appear here; they are handled by value-inspection.
+ * Kept in sync with `computeFieldShapes` in `scripts/cms/strapi/shapes.ts`.
+ */
+export interface BlockFieldShape {
+    /** 'single' → unwrap the one-item array to an object; 'list' → keep the
+     *  array; 'many-ref' → a to-many relation, coerced to an array whatever
+     *  arrives (a frontend iterating a oneToMany 500s on a stray object). */
+    readonly kind: 'single' | 'list' | 'many-ref';
+    /** Nested structural shapes for a fixed-shape block (single/repeatable component). */
+    readonly fields?: FieldShapes;
+    /** Per-variant nested shapes for a dynamic zone, keyed by variant uid (`_type`). */
+    readonly variants?: Record<string, FieldShapes>;
+}
+export type FieldShapes = Record<string, BlockFieldShape>;
+/** One Fimo entry → one Strapi-v5 item (`id` + `documentId` + reshaped fields). */
+export declare function fimoEntryToStrapiItem(entry: FimoEntry, shapes?: FieldShapes): Record<string, unknown>;
+/** Fimo entries → a Strapi-v5 collection envelope (`{ data, meta.pagination }`). */
+export declare function fimoEntriesToStrapiList(entries: FimoEntry[], options?: {
+    page?: number;
+    pageSize?: number;
+    total?: number;
+    shapes?: FieldShapes;
+}): StrapiListEnvelope;
+/** Fimo entry → a Strapi-v5 single/singleton envelope (`{ data, meta }`). */
+export declare function fimoEntryToStrapiSingle(entry: FimoEntry | undefined, shapes?: FieldShapes): StrapiSingleEnvelope;
+//# sourceMappingURL=reshape.d.ts.map