fimo 0.6.0 → 0.7.0-experimental.10

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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-messages.d.ts","sourceRoot":"","sources":["../../../src/runtime/shared/i18n-messages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;kEAEkE;AAClE,wBAAgB,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,SAAK,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAmBnH;AAED;;;oEAGoE;AACpE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgBvF;AAED;;4EAE4E;AAC5E,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkBzB"}

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/i18n-messages.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=i18n-messages.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-messages.test.d.ts","sourceRoot":"","sources":["../../../src/runtime/shared/i18n-messages.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,39 @@
+import { describe, expect, it } from 'vitest';
+import { deepMergeMessages, flattenMessages, unflattenMessages } from './i18n-messages.js';
+describe('i18n message flatten/unflatten round-trip', () => {
+    const store = {
+        home: {
+            title: 'Welcome',
+            hero: { cta: 'Get started', sub: 'Ship faster' },
+        },
+        nav: { about: 'About', pricing: 'Pricing' },
+        cart: {
+            // ICU strings stay opaque.
+            items: '{count, plural, =0 {No items} one {# item} other {# items}}',
+            greeting: 'Hello {name}',
+            rich: 'Read the <link>docs</link>',
+        },
+    };
+    it('flattens nested namespaces to dot-keys and back byte-for-byte', () => {
+        const { flat, skipped } = flattenMessages(store);
+        expect(skipped).toEqual([]);
+        expect(flat['home.title']).toBe('Welcome');
+        expect(flat['home.hero.cta']).toBe('Get started');
+        expect(flat['cart.items']).toBe('{count, plural, =0 {No items} one {# item} other {# items}}');
+        expect(flat['cart.rich']).toBe('Read the <link>docs</link>');
+        // The whole store reconstructs exactly.
+        expect(unflattenMessages(flat)).toEqual(store);
+    });
+    it('reports non-string leaves as skipped instead of corrupting them', () => {
+        const { flat, skipped } = flattenMessages({ a: 'x', b: [1, 2], c: 3, d: { e: 'y' } });
+        expect(flat).toEqual({ a: 'x', 'd.e': 'y' });
+        expect(skipped.sort()).toEqual(['b', 'c']);
+    });
+    it('deep-merges the Fimo bundle over the static base (missing keys fall back)', () => {
+        const base = { home: { title: 'Old', cta: 'Base only' }, nav: { about: 'About' } };
+        const fromFimo = unflattenMessages({ 'home.title': 'Edited in Fimo' });
+        const merged = deepMergeMessages(base, fromFimo);
+        // Edited key wins; base-only keys survive.
+        expect(merged).toEqual({ home: { title: 'Edited in Fimo', cta: 'Base only' }, nav: { about: 'About' } });
+    });
+});

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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels-fetch.pure.d.ts","sourceRoot":"","sources":["../../../src/runtime/shared/labels-fetch.pure.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAGD,eAAO,MAAM,gBAAgB,0HAMnB,CAAC;AAEX,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,GAAG,SAAS,CAOnF;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAM3D;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAwBvF;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAcrH;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAQrF"}

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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels-fetch.server.d.ts","sourceRoot":"","sources":["../../../src/runtime/shared/labels-fetch.server.ts"],"names":[],"mappings":"AAUA,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,KAAK,WAAW,GACjB,MAAM,wBAAwB,CAAC;AAEhC,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAE1D;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAU7D;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAwB3E;AAWD,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAWrF"}

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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels-t.pure.d.ts","sourceRoot":"","sources":["../../../src/runtime/shared/labels-t.pure.ts"],"names":[],"mappings":"AAOA,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,IACjE,KAAK,MAAM,EAAE,iBAAa,KAAG,MAAM,CAC5C"}

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,26 @@
+import { type FimoServerOptions } from '../wrapped/server.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;
+}
+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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/runtime/strapi/client.ts"],"names":[],"mappings":"AASA,OAAO,EAAgB,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAG5E,MAAM,WAAW,sBAAuB,SAAQ,iBAAiB;IAC/D,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAUD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,SAAS,GAAG,eAAe,GAAG,IAAI,CAkCzF;AAED,oFAAoF;AACpF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,EAAE,SAAS,GAAE,OAAO,KAAa,GAAG,OAAO,KAAK,CAiCpH"}

package/dist/runtime/strapi/client.js

@@ -0,0 +1,88 @@
+// 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,
+    };
+}
+/** 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 };
+    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) {
+            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 } : {}),
+        });
+        if (entries.length === 0) {
+            return realFetch(input, init); // nothing scaffolded → fall back to the CMS
+        }
+        const single = Boolean(parsed.documentId) || singletons.has(typeName);
+        const payload = single
+            ? fimoEntryToStrapiSingle(parsed.documentId ? (entries.find((e) => e.id === parsed.documentId) ?? entries[0]) : entries[0])
+            : fimoEntriesToStrapiList(entries, { pageSize: parsed.pageSize, total: entries.length });
+        return new Response(JSON.stringify(payload), {
+            status: 200,
+            headers: { 'content-type': 'application/json' },
+        });
+    });
+}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=client.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.test.d.ts","sourceRoot":"","sources":["../../../src/runtime/strapi/client.test.ts"],"names":[],"mappings":""}

package/dist/runtime/strapi/client.test.js

@@ -0,0 +1,64 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+const fetchEntriesMock = vi.fn();
+vi.mock('../wrapped/server.js', () => ({
+    fetchEntries: (...args) => fetchEntriesMock(...args),
+}));
+import { createFimoStrapiFetch, parseStrapiUrl } from './client.js';
+describe('parseStrapiUrl', () => {
+    it('parses type, pagination, locale and $eq filters', () => {
+        const parsed = parseStrapiUrl('https://cms.example/api/blog-posts?locale=en&pagination[pageSize]=5&filters[slug][$eq]=hello');
+        expect(parsed).toMatchObject({ pluralName: 'blog-posts', locale: 'en', pageSize: 5, where: { slug: 'hello' } });
+    });
+    it('parses a documentId path', () => {
+        expect(parseStrapiUrl('https://cms.example/api/pages/abc123')).toMatchObject({
+            pluralName: 'pages',
+            documentId: 'abc123',
+        });
+    });
+    it('returns null for non-/api paths', () => {
+        expect(parseStrapiUrl('https://cms.example/health')).toBeNull();
+    });
+});
+describe('createFimoStrapiFetch', () => {
+    const realFetch = vi.fn(async () => new Response('REAL', { status: 200 }));
+    beforeEach(() => {
+        fetchEntriesMock.mockReset();
+        realFetch.mockClear();
+    });
+    it('serves a mapped collection from Fimo as a Strapi list envelope', async () => {
+        fetchEntriesMock.mockResolvedValue([
+            { id: '1', data: { title: 'A' } },
+            { id: '2', data: { title: 'B' } },
+        ]);
+        const fimoFetch = createFimoStrapiFetch({ types: { 'blog-posts': 'BlogPost' } }, realFetch);
+        const body = await (await fimoFetch('https://cms.example/api/blog-posts?pagination[pageSize]=10')).json();
+        expect(body.data).toHaveLength(2);
+        expect(body.data[0]).toMatchObject({ id: '1', documentId: '1', title: 'A' });
+        expect(body.meta.pagination.total).toBe(2);
+        expect(realFetch).not.toHaveBeenCalled();
+        expect(fetchEntriesMock).toHaveBeenCalledWith('BlogPost', expect.objectContaining({ limit: 10 }));
+    });
+    it('serves a singleton as a single envelope, not a list', async () => {
+        fetchEntriesMock.mockResolvedValue([{ id: 'g', data: { siteName: 'X' } }]);
+        const fimoFetch = createFimoStrapiFetch({ types: { global: 'Global' }, singletons: ['Global'] }, realFetch);
+        const body = await (await fimoFetch('https://cms.example/api/global')).json();
+        expect(Array.isArray(body.data)).toBe(false);
+        expect(body.data).toMatchObject({ id: 'g', siteName: 'X' });
+    });
+    it('passes a slug filter through to fetchEntries', async () => {
+        fetchEntriesMock.mockResolvedValue([{ id: '1', data: { slug: 'hello' } }]);
+        const fimoFetch = createFimoStrapiFetch({ types: { 'blog-posts': 'BlogPost' } }, realFetch);
+        await fimoFetch('https://cms.example/api/blog-posts?filters[slug][$eq]=hello');
+        expect(fetchEntriesMock).toHaveBeenCalledWith('BlogPost', expect.objectContaining({ where: { slug: 'hello' } }));
+    });
+    it('falls through to the real fetch for an unmapped path', async () => {
+        const fimoFetch = createFimoStrapiFetch({ types: { 'blog-posts': 'BlogPost' } }, realFetch);
+        expect(await (await fimoFetch('https://cms.example/api/users?filters[slug][$eq]=x')).text()).toBe('REAL');
+        expect(realFetch).toHaveBeenCalled();
+    });
+    it('falls through when Fimo has nothing scaffolded for the type', async () => {
+        fetchEntriesMock.mockResolvedValue([]);
+        const fimoFetch = createFimoStrapiFetch({ types: { 'blog-posts': 'BlogPost' } }, realFetch);
+        expect(await (await fimoFetch('https://cms.example/api/blog-posts')).text()).toBe('REAL');
+    });
+});

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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/strapi/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACpE,YAAY,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvG,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC"}

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,28 @@
+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>;
+}
+/** One Fimo entry → one Strapi-v5 item (flat fields, `id` + `documentId`). */
+export declare function fimoEntryToStrapiItem(entry: FimoEntry): 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;
+}): StrapiListEnvelope;
+/** Fimo entry → a Strapi-v5 single/singleton envelope (`{ data, meta }`). */
+export declare function fimoEntryToStrapiSingle(entry: FimoEntry | undefined): StrapiSingleEnvelope;
+//# sourceMappingURL=reshape.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reshape.d.ts","sourceRoot":"","sources":["../../../src/runtime/strapi/reshape.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAChC,IAAI,EAAE;QAAE,UAAU,EAAE,gBAAgB,CAAA;KAAE,CAAC;CACxC;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAqDD,8EAA8E;AAC9E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAM/E;AAED,oFAAoF;AACpF,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,SAAS,EAAE,EACpB,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GACjE,kBAAkB,CAepB;AAED,6EAA6E;AAC7E,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,oBAAoB,CAE1F"}