@fougere/app 0.2.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fougere contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/auth.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Auth accessor — reads the AuthRuntime that the core mounted on the app.
+ *
+ * Auth is no longer a separate singleton: it lives on `app.auth`, built once
+ * during boot from the `auth` field of fougere.config.ts. This accessor is a
+ * thin async helper for server code (middleware, routes, /api/me).
+ */
+import type { AuthRuntime } from '@fougere/core';
+/** Get the auth runtime resolved at boot. Throws if no `auth` was declared in fougere.config.ts. */
+export declare function useFougereAuth(): Promise<AuthRuntime>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGjD,oGAAoG;AACpG,wBAAsB,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC,CAQ3D"}

package/dist/auth.js

@@ -0,0 +1,10 @@
+import { useFougereApp } from './boot.js';
+/** Get the auth runtime resolved at boot. Throws if no `auth` was declared in fougere.config.ts. */
+export async function useFougereAuth() {
+    const app = await useFougereApp();
+    if (!app.auth) {
+        throw new Error('Auth not configured — declare `auth: { provider, ... }` in fougere.config.ts.');
+    }
+    return app.auth;
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,oGAAoG;AACpG,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,MAAM,GAAG,GAAG,MAAM,aAAa,EAAE,CAAC;IAClC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,+EAA+E,CAChF,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC;AAClB,CAAC"}

package/dist/boot.d.ts

@@ -0,0 +1,35 @@
+import type { App, EntityOrm } from '@fougere/core';
+import { type SchemaLike } from '@fougere/schema';
+export interface FougereServerConfig {
+    /** Storage handle. Forwarded to the auth provider via AuthContext.db. */
+    db?: unknown;
+    /** Per-entity ORM factory. */
+    ormFactory?: (entity: SchemaLike, name: string) => EntityOrm;
+    /** Called after app is created. Use for migrations, seeding, etc. */
+    afterBoot?: (app: App) => void | Promise<void>;
+    /**
+     * What the boot line names as the host — 'Nuxt/Nitro', 'Next'. Stated by the
+     * adapter, never sniffed: a boot that guesses its host from what happens to be
+     * importable is the hidden runtime the doctrine refuses.
+     */
+    host?: string;
+}
+/**
+ * Override the data layer — only needed if you don't want the convention-driven
+ * setup based on `config.db` in fougere.config.ts.
+ */
+export declare function configureFougere(config: FougereServerConfig): void;
+/** Get the booted Fougere app. Lazy — boots on first call, then caches. */
+export declare function useFougereApp(): Promise<App>;
+/**
+ * The store an app with no `db` runs on.
+ *
+ * It used to ignore both its arguments — `(_entity, _name)` — so it forced the field
+ * name `id`, minted a uuid whatever the entity declared, and realized none of the
+ * lifecycle rules: `created()` stamped nothing, a declared default stayed absent. The
+ * same page therefore behaved one way here and another way on SQLite.
+ *
+ * It reads the axes now, through the one realization every storage shares.
+ */
+export declare function createMemoryOrm(entity: SchemaLike, name: string): EntityOrm;
+//# sourceMappingURL=boot.d.ts.map

package/dist/boot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot.d.ts","sourceRoot":"","sources":["../src/boot.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,GAAG,EAAE,SAAS,EAA4B,MAAM,eAAe,CAAC;AAC9E,OAAO,EAA4B,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAI5E,MAAM,WAAW,mBAAmB;IAClC,yEAAyE;IACzE,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,8BAA8B;IAC9B,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,KAAK,SAAS,CAAC;IAC7D,qEAAqE;IACrE,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AASD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,QAG3D;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,CAK5C;AAiGD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAoE3E"}

package/dist/boot.js

@@ -0,0 +1,208 @@
+/**
+ * Fougere server bootstrap — single entry point for an app's lifecycle,
+ * whatever hosts it.
+ *
+ * Nothing here knows h3, Nitro, Vue or React: a boot reads `fougere.config.ts`,
+ * scans fronds off the filesystem and hands back an `App`. That is why it lives
+ * in `@fougere/app` rather than in one of the two adapters — the second host
+ * would otherwise have copied it, and a copied boot drifts (the seeding loop
+ * already did, `core/src/seed.ts`).
+ *
+ * Default path (zero-config): fougere.config.ts declares `db: 'sqlite'` and
+ * everything else; this module auto-resolves the storage handle, builds an
+ * ormFactory, runs auto-DDL from the entities, and boots the app.
+ *
+ * Escape hatch: `configureFougere({ db, ormFactory })` can be called from the
+ * host's own startup (a Nitro plugin, a Next instrumentation hook) if the user
+ * wants a custom data layer — alternative driver, managed migrations, etc.
+ */
+import { createApp, loadCascadedConfig, setModuleLoader, frondAliases, Logger } from '@fougere/core';
+import { createContainer } from '@fougere/container';
+import { applyCreate, applyUpdate } from '@fougere/schema';
+// ── State ────────────────────────────────────────
+let _config = {};
+let _appPromise = null;
+// ── Public API ───────────────────────────────────
+/**
+ * Override the data layer — only needed if you don't want the convention-driven
+ * setup based on `config.db` in fougere.config.ts.
+ */
+export function configureFougere(config) {
+    _config = config;
+    _appPromise = null;
+}
+/** Get the booted Fougere app. Lazy — boots on first call, then caches. */
+export function useFougereApp() {
+    if (!_appPromise) {
+        _appPromise = boot();
+    }
+    return _appPromise;
+}
+// ── Boot ─────────────────────────────────────────
+async function boot() {
+    const bootStart = performance.now();
+    const log = new Logger('boot', { level: 'debug' });
+    log.info(`booting (${_config.host ?? 'app'})`);
+    const { createJiti } = await import('jiti');
+    // Nitro serves from a bundle, but the scan still reads frond sources from disk — so the
+    // named form a frond uses for its neighbour has to resolve here too.
+    const jiti = createJiti(import.meta.url, {
+        interopDefault: true,
+        alias: await frondAliases(process.env.FOUGERE_ROOT ?? process.cwd()),
+    });
+    setModuleLoader((filePath) => jiti.import(filePath));
+    // Config cascades along the workspace→app frontier: the workspace root (via
+    // FOUGERE_ROOT, where `remotes`/shared db live) is the base, the app (cwd)
+    // overrides. Same boundary the fronds cascade along. No `root` → both equal.
+    const configRoot = process.cwd();
+    const root = process.env.FOUGERE_ROOT ?? configRoot;
+    const fileConfig = await loadCascadedConfig(root, configRoot);
+    // Auto-resolve the data layer from config.db when the user didn't provide a
+    // custom one via configureFougere. The resolution itself lives in @fougere/runtime
+    // — this host must not know which storage package backs `db:`.
+    let db = _config.db;
+    let ormFactory = _config.ormFactory;
+    let migrateSchema;
+    if (!ormFactory) {
+        const { resolveStorage } = await import('@fougere/runtime');
+        const storage = resolveStorage(fileConfig.db);
+        if (storage.ormFactory) {
+            log.debug('auto-resolving storage from config.db');
+            db = storage.db;
+            ormFactory = storage.ormFactory;
+            migrateSchema = storage.afterBoot;
+        }
+        else {
+            log.debug('no db declared — falling back to in-memory ORM');
+            ormFactory = createMemoryOrm;
+        }
+    }
+    // Layer-2 wiring: `remotes: { catalog: 'http://...' }` in fougere.config.ts
+    // is all the user writes — the default transport comes from here.
+    let remoteTransport;
+    if (Object.keys(fileConfig.remotes ?? {}).length > 0) {
+        log.debug(`remotes declared (${Object.keys(fileConfig.remotes).join(', ')}) — wiring HTTP transport`);
+        const { createHttpTransport } = await import('@fougere/transport-http');
+        remoteTransport = (url) => createHttpTransport(url);
+    }
+    const app = await createApp({
+        root,
+        createContainer,
+        ormFactory,
+        db,
+        auth: fileConfig.auth,
+        adapters: fileConfig.adapters,
+        remotes: fileConfig.remotes,
+        remoteTransport,
+    });
+    // Bring the schema up to date — creates missing tables and adds columns an
+    // entity gained. Auth entities travel with the app, no synthetic frond needed.
+    if (migrateSchema) {
+        log.debug('migrating schema from entities');
+        await migrateSchema(app);
+    }
+    if (_config.afterBoot) {
+        // A host that declares `afterBoot` OWNS what happens after the boot, seeding
+        // included — Nuxt's generated Nitro plugin does exactly that, because Nitro
+        // bundles and the seed modules have to be spelled out as static imports for it.
+        log.debug('running afterBoot');
+        await _config.afterBoot(app);
+        log.info('afterBoot done');
+    }
+    else {
+        // Nobody claimed it, so the boot seeds. The scan already carries each seed's
+        // data (`SeedEntry.data` is its resolved default export), and the order comes
+        // from core — the same `orderSeeds`/`runSeeds` pair Nuxt's plugin calls. A host
+        // that does not bundle its frond sources needs nothing else.
+        const { orderSeeds, runSeeds } = await import('@fougere/core');
+        await runSeeds(app, orderSeeds(app.fronds), (message) => log.info(`[seed]${message}`));
+    }
+    const ms = (performance.now() - bootStart).toFixed(0);
+    log.info(`ready in ${ms}ms — ${app.fronds.length} frond(s)${app.auth ? ` + auth (${app.auth.basePath})` : ''}`);
+    return app;
+}
+// ── Fallback ORM ─────────────────────────────────
+/**
+ * The store an app with no `db` runs on.
+ *
+ * It used to ignore both its arguments — `(_entity, _name)` — so it forced the field
+ * name `id`, minted a uuid whatever the entity declared, and realized none of the
+ * lifecycle rules: `created()` stamped nothing, a declared default stayed absent. The
+ * same page therefore behaved one way here and another way on SQLite.
+ *
+ * It reads the axes now, through the one realization every storage shares.
+ */
+export function createMemoryOrm(entity, name) {
+    const fields = entity.getFields();
+    const pk = Object.entries(fields).find(([, field]) => field.role?.primary)?.[0] ?? 'id';
+    const store = new Map();
+    // `EntityOrm.findById(id: string)` — but a key can hold a number, and a Map keyed on
+    // `1` does not answer `'1'`. SQL never had the question; here the divergence was
+    // silent and only on this storage.
+    const keyOf = (value) => String(value);
+    const matches = (row, criteria) => Object.entries(criteria).every(([key, value]) => Object.is(row[key], value));
+    return {
+        client: store,
+        async list(options) {
+            let items = [...store.values()];
+            if (options?.where)
+                items = items.filter((row) => matches(row, options.where));
+            // Held before the page is cut, and after the filter: `total` answers "how many
+            // match", which is what a paginator divides. Reading `store.size` at the end
+            // answered a different question — every row the store holds, including the ones
+            // the filter exists to keep out of this caller's sight.
+            const matching = items.length;
+            const limit = options?.limit;
+            const offset = options?.page && limit ? (options.page - 1) * limit : options?.offset ?? 0;
+            if (offset > 0)
+                items = items.slice(offset);
+            const hasMore = limit ? items.length > limit : false;
+            if (limit)
+                items = items.slice(0, limit);
+            const result = items;
+            result.hasMore = hasMore;
+            result.endCursor = items.length > 0 ? String(items[items.length - 1][pk] ?? '') : undefined;
+            if (options?.count)
+                result.total = matching;
+            return result;
+        },
+        async findById(id) { return store.get(keyOf(id)); },
+        async findBy(criteria) {
+            return [...store.values()].find((row) => matches(row, criteria));
+        },
+        async findAllBy(criteria) {
+            return [...store.values()].filter((row) => matches(row, criteria));
+        },
+        async create(input) {
+            const record = applyCreate(fields, input);
+            const id = record[pk];
+            // `primary(text())` declares no generator, so nothing fills the hole and the
+            // caller has to. Keying on `undefined` would let the second create overwrite the
+            // first, in silence — the old version hid this by inventing an `id` field the
+            // entity never declared.
+            if (id === undefined) {
+                throw new Error(`${name}.create: '${pk}' is the primary key and nothing supplied it — this entity declares no generator for it.`);
+            }
+            // A create is not an upsert. `Map.set` overwrites, so a second create under the
+            // same key answered "created" while destroying the previous row — SQL answers a
+            // constraint violation, and a store that loses data silently is worse than one
+            // that fails.
+            if (store.has(keyOf(id))) {
+                throw new Error(`${name}.create: '${pk}' ${JSON.stringify(id)} already exists.`);
+            }
+            store.set(keyOf(id), record);
+            return record;
+        },
+        async update(id, input) {
+            const existing = store.get(keyOf(id));
+            if (!existing)
+                throw new Error(`Not found: ${id}`);
+            const updated = { ...existing, ...applyUpdate(fields, input), [pk]: existing[pk] };
+            store.set(keyOf(id), updated);
+            return updated;
+        },
+        async delete(id) { return store.delete(keyOf(id)); },
+        output(_schema) { return this; },
+    };
+}
+//# sourceMappingURL=boot.js.map

package/dist/boot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot.js","sourceRoot":"","sources":["../src/boot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACrG,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAmB,MAAM,iBAAiB,CAAC;AAmB5E,oDAAoD;AAEpD,IAAI,OAAO,GAAwB,EAAE,CAAC;AACtC,IAAI,WAAW,GAAwB,IAAI,CAAC;AAE5C,oDAAoD;AAEpD;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAA2B;IAC1D,OAAO,GAAG,MAAM,CAAC;IACjB,WAAW,GAAG,IAAI,CAAC;AACrB,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,WAAW,GAAG,IAAI,EAAE,CAAC;IACvB,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,oDAAoD;AAEpD,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IACpC,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IAEnD,GAAG,CAAC,IAAI,CAAC,YAAY,OAAO,CAAC,IAAI,IAAI,KAAK,GAAG,CAAC,CAAC;IAE/C,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5C,wFAAwF;IACxF,qEAAqE;IACrE,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,GAAG,EAAE;QACvC,cAAc,EAAE,IAAI;QACpB,KAAK,EAAE,MAAM,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;KACrE,CAAC,CAAC;IACH,eAAe,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAqC,CAAC,CAAC;IAEzF,4EAA4E;IAC5E,2EAA2E;IAC3E,6EAA6E;IAC7E,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,UAAU,CAAC;IACpD,MAAM,UAAU,GAAkB,MAAM,kBAAkB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAE7E,4EAA4E;IAC5E,mFAAmF;IACnF,+DAA+D;IAC/D,IAAI,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC;IACpB,IAAI,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACpC,IAAI,aAAiE,CAAC;IACtE,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;QAC5D,MAAM,OAAO,GAAG,cAAc,CAAC,UAAU,CAAC,EAAW,CAAC,CAAC;QACvD,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACvB,GAAG,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;YACnD,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC;YAChB,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;YAChC,aAAa,GAAG,OAAO,CAAC,SAAkB,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;YAC5D,UAAU,GAAG,eAAe,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,kEAAkE;IAClE,IAAI,eAAyD,CAAC;IAC9D,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrD,GAAG,CAAC,KAAK,CAAC,qBAAqB,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,OAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QACvG,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;QACxE,eAAe,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC;QAC1B,IAAI;QACJ,eAAe;QACf,UAAU;QACV,EAAE;QACF,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,eAAe;KAChB,CAAC,CAAC;IAEH,2EAA2E;IAC3E,+EAA+E;IAC/E,IAAI,aAAa,EAAE,CAAC;QAClB,GAAG,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAC5C,MAAM,aAAa,CAAC,GAAY,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,6EAA6E;QAC7E,4EAA4E;QAC5E,gFAAgF;QAChF,GAAG,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAC/B,MAAM,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAC7B,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC7B,CAAC;SAAM,CAAC;QACN,6EAA6E;QAC7E,8EAA8E;QAC9E,gFAAgF;QAChF,6DAA6D;QAC7D,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QAC/D,MAAM,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC,CAAC;IACzF,CAAC;IAED,MAAM,EAAE,GAAG,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACtD,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,GAAG,CAAC,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,GAAG,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEhH,OAAO,GAAG,CAAC;AACb,CAAC;AAED,oDAAoD;AAEpD;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,MAAkB,EAAE,IAAY;IAC9D,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;IAClC,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IACxF,MAAM,KAAK,GAAG,IAAI,GAAG,EAAmC,CAAC;IACzD,qFAAqF;IACrF,iFAAiF;IACjF,mCAAmC;IACnC,MAAM,KAAK,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,CAAC,GAA4B,EAAE,QAAiC,EAAE,EAAE,CAClF,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IAC/E,OAAO;QACL,MAAM,EAAE,KAAK;QACb,KAAK,CAAC,IAAI,CAAC,OAAa;YACtB,IAAI,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;YAChC,IAAI,OAAO,EAAE,KAAK;gBAAE,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;YAC/E,+EAA+E;YAC/E,6EAA6E;YAC7E,gFAAgF;YAChF,wDAAwD;YACxD,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC;YAC9B,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,CAAC;YAC7B,MAAM,MAAM,GAAG,OAAO,EAAE,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC;YAC1F,IAAI,MAAM,GAAG,CAAC;gBAAE,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC5C,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;YACrD,IAAI,KAAK;gBAAE,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG,KAAY,CAAC;YAC5B,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;YACzB,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAE,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACrG,IAAI,OAAO,EAAE,KAAK;gBAAE,MAAM,CAAC,KAAK,GAAG,QAAQ,CAAC;YAC5C,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,KAAK,CAAC,QAAQ,CAAC,EAAU,IAAI,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3D,KAAK,CAAC,MAAM,CAAC,QAAiC;YAC5C,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;QACnE,CAAC;QACD,KAAK,CAAC,SAAS,CAAC,QAAiC;YAC/C,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;QACrE,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,KAAuC;YAClD,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAC1C,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,CAAuB,CAAC;YAC5C,6EAA6E;YAC7E,iFAAiF;YACjF,8EAA8E;YAC9E,yBAAyB;YACzB,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;gBACrB,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,aAAa,EAAE,0FAA0F,CAAC,CAAC;YACpI,CAAC;YACD,gFAAgF;YAChF,gFAAgF;YAChF,+EAA+E;YAC/E,cAAc;YACd,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,aAAa,EAAE,KAAK,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,kBAAkB,CAAC,CAAC;YACnF,CAAC;YACD,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;YAC7B,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,KAAuC;YAC9D,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;YACtC,IAAI,CAAC,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;YACnD,MAAM,OAAO,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YACnF,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;YAC9B,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,EAAU,IAAI,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5D,MAAM,CAAC,OAAmB,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC;KAC7C,CAAC;AACJ,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,64 @@
+/**
+ * The couple, minus the reactivity — everything `useQuery`/`useCommand` decide
+ * before a framework's state primitives get involved.
+ *
+ * Designation is class + verb: the imported entity class carries the metadata,
+ * its name carries the registration key. That is true in Vue and in React, and so
+ * is the link — a successful command on an entity revalidates every mounted query
+ * on that entity, because the entity is designated on both sides and nothing has
+ * to be declared. What differs between hosts is only HOW a value becomes reactive
+ * and how a revalidation is triggered, which is ~50 lines each and belongs to them.
+ *
+ * Browser-safe by construction: this module reaches `@fougere/core/contract` and
+ * the transport's client subpath, never the boot. `@fougere/app/client` is the
+ * subpath that keeps it that way.
+ */
+import { FougereError, type InvocationContext, type FrondCall } from '@fougere/core/contract';
+/** An entity class is a designation: its name is the registration key. */
+export type EntityClass = {
+    name: string;
+};
+/** What a page provides of an invocation — the rest is stamped server-side. */
+export type CallInput = Partial<Pick<InvocationContext, 'params' | 'query' | 'body'>>;
+/** The one door the browser knows. A named surface adds `/{surface}` to it. */
+export declare const CALL_ENDPOINT = "/_fougere/call";
+export type Fetcher = <T>(url: string, options: {
+    method: 'POST';
+    body: unknown;
+}) => Promise<T>;
+/** The registration key an entity class designates. */
+export declare function entityKeyOf(entity: EntityClass): string;
+export declare function callOf(entity: EntityClass, op: string): FrondCall;
+export declare function invocationOf(input?: CallInput): InvocationContext;
+/**
+ * The cache key of a read. Same designation and same input means the same key —
+ * which is what lets two components asking the same thing share one request, and
+ * what the command side matches against to revalidate.
+ */
+export declare function queryKeyOf(entityKey: string, op: string, input?: CallInput): string;
+export declare function sendCall(fetcher: Fetcher, call: FrondCall, invocation: InvocationContext, endpoint?: string): Promise<unknown>;
+/** Register a mounted read. Returns the unregistration, for the host's scope teardown. */
+export declare function trackQuery(entityKey: string, key: string): () => void;
+/** The keys a successful command on this entity should revalidate. */
+export declare function mountedKeys(entityKey: string): string[];
+/** Register a mounted read's refetch. Returns the unregistration. */
+export declare function onRefetch(key: string, run: () => void): () => void;
+export declare function revalidate(keys: string[]): void;
+/** The browser's way to reach the envelope. Same-origin, so no base URL to configure. */
+export declare const fetcher: Fetcher;
+/** A list result reads as items whatever the wire delivered — bare array or envelope. */
+export declare function itemsOf<T>(data: unknown): T[];
+export declare function pageOf(data: unknown): {
+    total?: number;
+    hasMore?: boolean;
+    endCursor?: string;
+};
+/**
+ * Whatever failed, as the error the primitives promise. A transport failure is not
+ * a domain refusal, so it arrives under SERVICE_UNAVAILABLE rather than borrowing a
+ * code the server never sent.
+ */
+export declare function asFougereError(err: unknown, entityKey: string, op: string): FougereError;
+export { formFieldsOf, payloadOf, errorsByField, type FormEntity, type FormField, } from './form.js';
+export { sessionViewOf, type SessionView } from './session.js';
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EACL,YAAY,EAGZ,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACf,MAAM,wBAAwB,CAAC;AAGhC,0EAA0E;AAC1E,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3C,+EAA+E;AAC/E,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC;AAEtF,+EAA+E;AAC/E,eAAO,MAAM,aAAa,mBAAmB,CAAC;AAE9C,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAIjG,uDAAuD;AACvD,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAEvD;AAED,wBAAgB,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,CAEjE;AAED,wBAAgB,YAAY,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,iBAAiB,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,CAEnF;AAED,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,SAAS,EACf,UAAU,EAAE,iBAAiB,EAC7B,QAAQ,GAAE,MAAsB,GAC/B,OAAO,CAAC,OAAO,CAAC,CAMlB;AAOD,0FAA0F;AAC1F,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,IAAI,CAKrE;AAED,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAEvD;AAYD,qEAAqE;AACrE,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAKlE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAE/C;AAED,yFAAyF;AACzF,eAAO,MAAM,OAAO,EAAE,OAOrB,CAAC;AAIF,yFAAyF;AACzF,wBAAgB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,GAAG,CAAC,EAAE,CAM7C;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAE/F;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,YAAY,CAUxF;AAKD,OAAO,EACL,YAAY,EACZ,SAAS,EACT,aAAa,EACb,KAAK,UAAU,EACf,KAAK,SAAS,GACf,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/dist/client.js

@@ -0,0 +1,124 @@
+/**
+ * The couple, minus the reactivity — everything `useQuery`/`useCommand` decide
+ * before a framework's state primitives get involved.
+ *
+ * Designation is class + verb: the imported entity class carries the metadata,
+ * its name carries the registration key. That is true in Vue and in React, and so
+ * is the link — a successful command on an entity revalidates every mounted query
+ * on that entity, because the entity is designated on both sides and nothing has
+ * to be declared. What differs between hosts is only HOW a value becomes reactive
+ * and how a revalidation is triggered, which is ~50 lines each and belongs to them.
+ *
+ * Browser-safe by construction: this module reaches `@fougere/core/contract` and
+ * the transport's client subpath, never the boot. `@fougere/app/client` is the
+ * subpath that keeps it that way.
+ */
+import { FougereError, ErrorCode, toRegistrationName, } from '@fougere/core/contract';
+import { frameCall, unframeResponse } from '@fougere/transport-http/client';
+/** The one door the browser knows. A named surface adds `/{surface}` to it. */
+export const CALL_ENDPOINT = '/_fougere/call';
+let nextId = 1;
+/** The registration key an entity class designates. */
+export function entityKeyOf(entity) {
+    return toRegistrationName(entity.name);
+}
+export function callOf(entity, op) {
+    return { entity: entityKeyOf(entity), op };
+}
+export function invocationOf(input) {
+    return { params: {}, query: {}, body: undefined, state: {}, ...input };
+}
+/**
+ * The cache key of a read. Same designation and same input means the same key —
+ * which is what lets two components asking the same thing share one request, and
+ * what the command side matches against to revalidate.
+ */
+export function queryKeyOf(entityKey, op, input) {
+    return `fougere:${entityKey}.${op}:${JSON.stringify(input ?? {})}`;
+}
+export async function sendCall(fetcher, call, invocation, endpoint = CALL_ENDPOINT) {
+    const response = await fetcher(endpoint, {
+        method: 'POST',
+        body: frameCall(call, invocation, nextId++),
+    });
+    return unframeResponse(response, call);
+}
+// ── The link ─────────────────────────────────────
+/** Mounted queries per entity — the command side of the link reads this. */
+const mounted = new Map();
+/** Register a mounted read. Returns the unregistration, for the host's scope teardown. */
+export function trackQuery(entityKey, key) {
+    const keys = mounted.get(entityKey) ?? new Set();
+    keys.add(key);
+    mounted.set(entityKey, keys);
+    return () => keys.delete(key);
+}
+/** The keys a successful command on this entity should revalidate. */
+export function mountedKeys(entityKey) {
+    return [...(mounted.get(entityKey) ?? [])];
+}
+/**
+ * `mountedKeys` says WHICH reads a command invalidates; these say how to make one
+ * happen. Both halves turned out to be host-independent — Nuxt is the exception,
+ * because `refreshNuxtData` already is this registry.
+ *
+ * They lived in `@fougere/react` until a second non-Nuxt client needed them, which
+ * is when it became visible that nothing in them is React.
+ */
+const refetchers = new Map();
+/** Register a mounted read's refetch. Returns the unregistration. */
+export function onRefetch(key, run) {
+    const set = refetchers.get(key) ?? new Set();
+    set.add(run);
+    refetchers.set(key, set);
+    return () => set.delete(run);
+}
+export function revalidate(keys) {
+    for (const key of keys)
+        for (const run of refetchers.get(key) ?? [])
+            run();
+}
+/** The browser's way to reach the envelope. Same-origin, so no base URL to configure. */
+export const fetcher = async (url, options) => {
+    const response = await fetch(url, {
+        method: options.method,
+        headers: { 'content-type': 'application/json' },
+        body: JSON.stringify(options.body),
+    });
+    return (await response.json());
+};
+// ── Reading a result ─────────────────────────────
+/** A list result reads as items whatever the wire delivered — bare array or envelope. */
+export function itemsOf(data) {
+    if (Array.isArray(data))
+        return data;
+    if (data && typeof data === 'object' && Array.isArray(data.items)) {
+        return data.items;
+    }
+    return [];
+}
+export function pageOf(data) {
+    return (data ?? {});
+}
+/**
+ * Whatever failed, as the error the primitives promise. A transport failure is not
+ * a domain refusal, so it arrives under SERVICE_UNAVAILABLE rather than borrowing a
+ * code the server never sent.
+ */
+export function asFougereError(err, entityKey, op) {
+    return err instanceof FougereError
+        ? err
+        : new FougereError({
+            code: ErrorCode.SERVICE_UNAVAILABLE,
+            message: err?.message ?? String(err),
+            entity: entityKey,
+            operation: op,
+            cause: err,
+        });
+}
+// The form contract is host-independent too, and a form is client code — so it
+// reaches the browser through this subpath rather than through the package root,
+// which carries the boot.
+export { formFieldsOf, payloadOf, errorsByField, } from './form.js';
+export { sessionViewOf } from './session.js';
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/express.d.ts

@@ -0,0 +1,25 @@
+type Next = (err?: unknown) => void;
+export type ExpressMiddleware = (req: any, res: any, next: Next) => void;
+/**
+ * The call envelope, at `/_fougere/call` — the door the browser primitives use.
+ *
+ * Mounted with `app.use()`, Express strips nothing, so the path still carries the
+ * audience segment (`/_fougere/call/public`) that `surfaceOf` reads.
+ */
+export declare function fougereCall(mountPath?: string): ExpressMiddleware;
+/** The session view, at `/_fougere/session`. */
+export declare function fougereSession(mountPath?: string): ExpressMiddleware;
+/**
+ * The REST projection, under `/api` by default.
+ *
+ * A path this app does not serve calls `next()` — so an app's own `/api/health` keeps
+ * answering whether it was registered before or after this middleware.
+ */
+export declare function fougereRest(mountPath?: string): ExpressMiddleware;
+/** GraphQL, at `/graphql` by default. Declines when the app declares no such adapter. */
+export declare function fougereGraphQL(mountPath?: string): ExpressMiddleware;
+/** Every door, for an app that wants all of them. What each one SERVES is still the
+ *  app's declaration — mounting is not publishing. */
+export declare function fougere(): ExpressMiddleware;
+export {};
+//# sourceMappingURL=express.d.ts.map

package/dist/express.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.d.ts","sourceRoot":"","sources":["../src/express.ts"],"names":[],"mappings":"AA0DA,KAAK,IAAI,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;AACpC,MAAM,MAAM,iBAAiB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;AAsCzE;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,SAAS,SAAmB,GAAG,iBAAiB,CAqB3E;AAED,gDAAgD;AAChD,wBAAgB,cAAc,CAAC,SAAS,SAAsB,GAAG,iBAAiB,CAKjF;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,SAAS,SAAS,GAAG,iBAAiB,CA4BjE;AAED,yFAAyF;AACzF,wBAAgB,cAAc,CAAC,SAAS,SAAa,GAAG,iBAAiB,CAoBxE;AAED;sDACsD;AACtD,wBAAgB,OAAO,IAAI,iBAAiB,CAY3C"}