@fougere/defaults 0.2.0-alpha.2 → 0.4.0-alpha.0

package/README.md

@@ -12,4 +12,4 @@ pnpm add @fougere/defaults
 
 Part of [Fougere](https://github.com/chok/fougere) — one schema, a gradient from
 monolith to distributed, the same user code.
-Reference documentation: [the site](https://chok.github.io/fougere/) (en/fr).
+Reference documentation: [the site](https://fougere.dev/) (en/fr).

package/dist/index.d.ts

@@ -8,7 +8,7 @@
  * package supplies them on top of `core.boot()`. Nuxt's fallback, the CLI's
  * `serve`/`call`, and a standalone frond host are all projections of it.
  */
-import { type App } from '@fougere/core';
+import { type App, type CreateAppOptions } from '@fougere/core';
 export { resolveStorage, declaresStorage, storageFrom } from './storage.js';
 export type { DbConfig, SourcesConfig, DeclaredStorage, Placement, ResolvedStorage } from './storage.js';
 export interface BootAppOptions {
@@ -19,6 +19,11 @@ export interface BootAppOptions {
      * passes false — it *is* the frond, it doesn't route back out.
      */
     topology?: boolean;
+    /**
+     * What this app takes on beyond its fronds — `observability()` is the first one.
+     * Appended after the framework's own members, or replacing one by naming it.
+     */
+    extensions?: CreateAppOptions['extensions'];
 }
 /**
  * Boot a Fougere app from the `fougere.config.ts` at `root`, wired the

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAoB,KAAK,GAAG,EAAE,MAAM,eAAe,CAAC;AAK3D,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC5E,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,eAAe,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEzG,MAAM,WAAW,cAAc;IAC7B,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,GAAG,CAAC,CAc7F"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAMhE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC5E,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,eAAe,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEzG,MAAM,WAAW,cAAc;IAC7B,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,UAAU,CAAC,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;CAC7C;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,GAAG,CAAC,CAe7F"}

package/dist/index.js

@@ -1,14 +1,4 @@
-/**
- * @fougere/defaults — the conventional boot, declared once.
- *
- * Booting an app from `fougere.config.ts` means the same three opinionated
- * bindings every time: the container is `container`, `db: sqlite`
- * realizes through `schema-sql`, and `remotes:` are reached over
- * `transport-http`. core stays pure (it knows none of these); this layer-2
- * package supplies them on top of `core.boot()`. Nuxt's fallback, the CLI's
- * `serve`/`call`, and a standalone frond host are all projections of it.
- */
-import { boot, loadConfig } from '@fougere/core';
+import { boot, loadConfig } from '@fougere/core/node';
 import { createContainer } from '@fougere/container';
 import { createHttpTransport } from '@fougere/transport-http';
 import { resolveStorage } from './storage.js';
@@ -29,6 +19,7 @@ export async function bootAppFromConfig(root, opts = {}) {
         remoteTransport: useRemotes ? (url) => createHttpTransport(url) : undefined,
         // One resolver, one place that knows a storage package.
         db: (cfg) => resolveStorage(cfg.db, cfg.sources),
+        extensions: opts.extensions,
     });
 }
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,IAAI,EAAE,UAAU,EAAY,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAiB,MAAM,cAAc,CAAC;AAE7D,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAa5E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAY,EAAE,IAAI,GAAmB,EAAE;IAC7E,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;IACrC,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAE9E,OAAO,IAAI,CAAC;QACV,IAAI;QACJ,eAAe;QACf,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;QACzC,eAAe,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;QAC3E,wDAAwD;QACxD,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,EAAc,EAAG,GAA6B,CAAC,OAAgB,CAAC;KACjG,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAiB,MAAM,cAAc,CAAC;AAE7D,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAkB5E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAY,EAAE,IAAI,GAAmB,EAAE;IAC7E,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;IACrC,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAE9E,OAAO,IAAI,CAAC;QACV,IAAI;QACJ,eAAe;QACf,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;QACzC,eAAe,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;QAC3E,wDAAwD;QACxD,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,EAAc,EAAG,GAA6B,CAAC,OAAgB,CAAC;QAChG,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAC,CAAC;AACL,CAAC"}

package/dist/storage.d.ts

@@ -25,8 +25,40 @@ export interface ResolvedStorage {
     /** Opaque handle handed to auth providers. */
     db?: unknown;
     ormFactory: ((entity: any, name: string) => any) | undefined;
-    /** Brings the schema up to date once the app is scanned. */
-    afterBoot?: (app: App) => Promise<void> | void;
+    /**
+     * The source an entity's rows live in — what decides whether a frame gets a real
+     * transaction or an unwind it replays itself.
+     *
+     * Absent when the caller built a `ResolvedStorage` by hand: there is then one factory
+     * and no routing, so every entity IS on one engine — but nothing here can reach into it
+     * for a transaction, and a frame falls back to compensating. Not knowing and promising
+     * atomicity are two different things.
+     */
+    sourceOf?: (entityName: string) => string;
+    /**
+     * The engine a source runs on — the dual of `sourceOf`, which names it without
+     * reaching it. A caller that must run DDL per engine needs the handle, not the name.
+     */
+    dbOf?: (source: string) => unknown;
+    /** Every source that has an engine, the default one first. */
+    sources?: () => string[];
+    /** Run `fn` inside one transaction of that source, with an ORM factory bound to it. */
+    transacted?: <R>(source: string, fn: (ormFactory: (entity: any, name: string) => any) => Promise<R>) => Promise<R>;
+    /**
+     * Brings the schema up to date once the app is scanned — the storage's `up`, handed to
+     * `migrating()`. It was called `afterBoot`, a word that also meant the host's own
+     * post-boot and was read in four places under the two senses.
+     */
+    migrate?: (app: App) => Promise<void> | void;
+    /**
+     * Close every engine this opened — the dual of opening them, declared by whoever did.
+     *
+     * `boot()` calls the factory that lands here, so `boot()` is what owns closing it: a
+     * container disposes what IT built, and this connection was handed in. Without this
+     * the pool of a discarded app stayed open, which is what turning the ring makes
+     * ordinary rather than rare.
+     */
+    close?: () => Promise<void>;
     /** Raw synchronous handle, when the engine exposes one. */
     raw?: {
         exec(sql: string): void;

package/dist/storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAwB,KAAK,WAAW,EAAE,KAAK,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE1F,8DAA8D;AAC9D,MAAM,MAAM,QAAQ,GAChB,KAAK,GACL,QAAQ,GACR;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACnC,SAAS,CAAC;AAEd,yFAAyF;AACzF,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,GAAG,SAAS,CAAC;AAEhH,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,GAAG,CAAC,GAAG,SAAS,CAAC;IAC7D,4DAA4D;IAC5D,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC/C,2DAA2D;IAC3D,GAAG,CAAC,EAAE;QAAE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAClC,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED,mDAAmD;AACnD,wBAAgB,eAAe,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAGzD;AA+DD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,eAAe,CAazF;AAED,8EAA8E;AAC9E,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,qEAAqE;IACrE,EAAE,EAAE,KAAK,CAAC;IACV,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACrC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,eAAe,GAAG,eAAe,CA6CtE"}
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAGzC,OAAO,EAAW,KAAK,WAAW,EAAE,KAAK,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAG7E,8DAA8D;AAC9D,MAAM,MAAM,QAAQ,GAChB,KAAK,GACL,QAAQ,GACR;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACnC,SAAS,CAAC;AAEd,yFAAyF;AACzF,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,GAAG,SAAS,CAAC;AAEhH,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,GAAG,CAAC,GAAG,SAAS,CAAC;IAC7D;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC;IAC1C;;;OAGG;IACH,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,MAAM,EAAE,CAAC;IACzB,uFAAuF;IACvF,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IACnH;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7C;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,2DAA2D;IAC3D,GAAG,CAAC,EAAE;QAAE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAClC,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED,mDAAmD;AACnD,wBAAgB,eAAe,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAGzD;AAwDD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,eAAe,CAazF;AAED,8EAA8E;AAC9E,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,qEAAqE;IACrE,EAAE,EAAE,KAAK,CAAC;IACV,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACrC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,eAAe,GAAG,eAAe,CAgEtE"}

package/dist/storage.js

@@ -1,4 +1,7 @@
-import { setupSqlite, migrate } from '@fougere/adapter-sql';
+import { Fronds } from '@fougere/core';
+import { lowerFirst } from '@fougere/core/contract';
+import { migrate } from '@fougere/adapter-sql';
+import { setupSqlite } from '@fougere/adapter-sql/sqlite';
 /** Does this config ask for persistence at all? */
 export function declaresStorage(dbConf) {
     if (dbConf === false || dbConf === undefined)
@@ -21,13 +24,6 @@ function refuseUnresolvable(declared, field) {
         `Kysely dialect yourself and call setupKysely(dialect, '${declared}') ` +
         `from @fougere/adapter-sql.`);
 }
-/** The name an entity is registered under — 'Book' and 'book' name the same rows. */
-const keyOf = (name) => name.charAt(0).toLowerCase() + name.slice(1);
-/** Every entity the app hosts, wherever its rows are — what a partition is cut from. */
-function entityNames(app) {
-    return app
-        .fronds.flatMap((frond) => frond.entities.map((entry) => entry.name));
-}
 /**
  * The app as ONE source sees it: the entities that live there, and the names of those
  * that do not.
@@ -48,7 +44,9 @@ function partition(app, holds, withAuth, materialize) {
     return {
         fronds,
         auth: withAuth ? typed.auth : undefined,
-        elsewhere: entityNames(app).filter((name) => !holds(name)),
+        // Lifted, because this function reads its app structurally on purpose — a caller
+        // may hand it a shape that is app-LIKE, and the question is still the same one.
+        elsewhere: Fronds.scanned(typed.fronds).entityNames().filter((name) => !holds(name)),
         // A derivation makes no table unless a source names it — see AppLike.materialize.
         materialize,
     };
@@ -108,7 +106,7 @@ export function storageFrom(declared) {
     for (const [name, placement] of Object.entries(sources ?? {})) {
         engines.set(name, placement.setup);
         for (const entity of placement.entities) {
-            const key = keyOf(entity);
+            const key = lowerFirst(entity);
             const claimed = home.get(key);
             if (claimed) {
                 throw new Error(`sources: '${entity}' is claimed by both '${claimed}' and '${name}' — an entity lives in one place.`);
@@ -117,24 +115,45 @@ export function storageFrom(declared) {
             named.push(entity);
         }
     }
+    // The default source answers to the name the config gave it, so a refusal naming two
+    // sources names things the author can find in their own file.
+    const DEFAULT = 'db';
+    const sourceOf = (entityName) => home.get(lowerFirst(entityName)) ?? DEFAULT;
+    const engineOf = (source) => (source === DEFAULT ? base : engines.get(source));
     const engineFor = (entityName) => {
-        const source = home.get(keyOf(entityName));
+        const source = home.get(lowerFirst(entityName));
         return (source && engines.get(source)) || base;
     };
     return {
         db: base.db,
         ormFactory: (entity, name) => engineFor(name).ormFactory(entity, name),
+        sourceOf,
+        dbOf: (source) => engineOf(source)?.db,
+        sources: () => [DEFAULT, ...engines.keys()],
+        transacted: (source, fn) => {
+            const engine = engineOf(source);
+            if (!engine)
+                throw new Error(`No source named '${source}' — declared sources are ${[DEFAULT, ...engines.keys()].join(', ')}.`);
+            return engine.transacted(fn);
+        },
         raw: base.sqlite,
         dialect: base.dialect,
         // Additive migration: creates missing tables AND adds columns an entity gained.
         // One pass per source, each seeing only its own tables — which is what makes a
         // cross-source `ref()` a miss rather than a constraint against a stranger.
-        afterBoot: async (app) => {
-            await migrate(partition(app, (name) => !home.has(keyOf(name)), true, named), base.db);
+        migrate: async (app) => {
+            await migrate(partition(app, (name) => !home.has(lowerFirst(name)), true, named), base.db);
             for (const [name, engine] of engines) {
-                await migrate(partition(app, (e) => home.get(keyOf(e)) === name, false, named), engine.db);
+                await migrate(partition(app, (e) => home.get(lowerFirst(e)) === name, false, named), engine.db);
             }
         },
+        // Every engine, the default one last: a named source may hold what the default
+        // refers to, and closing in reverse of opening is the rule everywhere else.
+        close: async () => {
+            for (const engine of [...engines.values()].reverse())
+                await engine.db.destroy();
+            await base.db.destroy();
+        },
     };
 }
 //# sourceMappingURL=storage.js.map

package/dist/storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,MAAM,EAAwB,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAgC,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAuD1D,mDAAmD;AACnD,MAAM,UAAU,eAAe,CAAC,MAAgB;IAC9C,IAAI,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC3D,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,kBAAkB,CAAC,QAA4B,EAAE,KAAa;IACrE,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,QAAQ;QAAE,OAAO;IAC5D,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,KAAK,QAAQ,0DAA0D;QAC/E,6DAA6D,QAAQ,cAAc;QACnF,0DAA0D,QAAQ,KAAK;QACvE,4BAA4B,CAC7B,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,SAAS,CAChB,GAAQ,EACR,KAAgC,EAChC,QAAiB,EACjB,WAAqB;IAErB,MAAM,KAAK,GAAG,GAGb,CAAC;IACF,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM;SACxB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;SAC7F,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAChD,OAAO;QACL,MAAM;QACN,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QACvC,iFAAiF;QACjF,gFAAgF;QAChF,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,MAA2B,CAAC,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzG,kFAAkF;QAClF,WAAW;KACZ,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,MAAgB,EAAE,OAAuB;IACtE,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;IAE/D,kBAAkB,CAAC,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,SAAS,CAAC,EAAE,YAAY,CAAC,CAAC;IACtG,MAAM,KAAK,GAA8B,EAAE,CAAC;IAC5C,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;QACzD,kBAAkB,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,IAAI,UAAU,CAAC,CAAC;QAC5D,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,WAAW,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;IACrF,CAAC;IACD,OAAO,WAAW,CAAC;QACjB,EAAE,EAAE,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;QAC/E,OAAO,EAAE,KAAK;KACf,CAAC,CAAC;AACL,CAAC;AAeD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,WAAW,CAAC,QAAyB;IACnD,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC;IAEvC,oFAAoF;IACpF,+EAA+E;IAC/E,qFAAqF;IACrF,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAiB,CAAC;IACzC,uFAAuF;IACvF,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;QAC9D,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;QACnC,KAAK,MAAM,MAAM,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;YACxC,MAAM,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;YAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC9B,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CACb,aAAa,MAAM,yBAAyB,OAAO,UAAU,IAAI,mCAAmC,CACrG,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,qFAAqF;IACrF,8DAA8D;IAC9D,MAAM,OAAO,GAAG,IAAI,CAAC;IACrB,MAAM,QAAQ,GAAG,CAAC,UAAkB,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,IAAI,OAAO,CAAC;IACrF,MAAM,QAAQ,GAAG,CAAC,MAAc,EAAE,EAAE,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACvF,MAAM,SAAS,GAAG,CAAC,UAAkB,EAAE,EAAE;QACvC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;QAChD,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,IAAI,CAAC;IACjD,CAAC,CAAC;IAEF,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,UAAU,EAAE,CAAC,MAAW,EAAE,IAAY,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC;QACnF,QAAQ;QACR,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE;QACtC,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC3C,UAAU,EAAE,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE;YACzB,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;YAChC,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,MAAM,4BAA4B,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC/H,OAAO,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAC/B,CAAC;QACD,GAAG,EAAG,IAAiD,CAAC,MAAM;QAC9D,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,gFAAgF;QAChF,+EAA+E;QAC/E,2EAA2E;QAC3E,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACrB,MAAM,OAAO,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAU,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;YACpG,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACrC,MAAM,OAAO,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,KAAK,CAAU,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;YAC3G,CAAC;QACH,CAAC;QACD,+EAA+E;QAC/E,4EAA4E;QAC5E,KAAK,EAAE,KAAK,IAAI,EAAE;YAChB,KAAK,MAAM,MAAM,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;gBAAE,MAAM,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC;YAChF,MAAM,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC;QAC1B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fougere/defaults",
-  "version": "0.2.0-alpha.2",
+  "version": "0.4.0-alpha.0",
   "description": "The conventional boot of a Fougere app — the one place storage is wired.",
   "keywords": [
     "fougere",
@@ -25,13 +25,14 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "src"
   ],
   "dependencies": {
-    "@fougere/core": "0.2.0-alpha.2",
-    "@fougere/transport-http": "0.2.0-alpha.2",
-    "@fougere/container": "0.2.0-alpha.2",
-    "@fougere/adapter-sql": "0.2.0-alpha.2"
+    "@fougere/core": "0.4.0-alpha.0",
+    "@fougere/transport-http": "0.4.0-alpha.0",
+    "@fougere/adapter-sql": "0.4.0-alpha.0",
+    "@fougere/container": "0.4.0-alpha.0"
   },
   "publishConfig": {
     "access": "public"
@@ -40,7 +41,7 @@
     "kysely": "^0.28.17",
     "better-sqlite3": "^13.0.3",
     "@types/better-sqlite3": "^7.6.13",
-    "@fougere/schema": "0.2.0-alpha.2"
+    "@fougere/schema": "0.4.0-alpha.0"
   },
   "scripts": {
     "build": "rm -rf dist && tsc",

package/src/index.ts

@@ -0,0 +1,54 @@
+/**
+ * @fougere/defaults — the conventional boot, declared once.
+ *
+ * Booting an app from `fougere.config.ts` means the same three opinionated
+ * bindings every time: the container is `container`, `db: sqlite`
+ * realizes through `schema-sql`, and `remotes:` are reached over
+ * `transport-http`. core stays pure (it knows none of these); this layer-2
+ * package supplies them on top of `core.boot()`. Nuxt's fallback, the CLI's
+ * `serve`/`call`, and a standalone frond host are all projections of it.
+ */
+import { type App, type CreateAppOptions } from '@fougere/core';
+import { boot, loadConfig } from '@fougere/core/node';
+import { createContainer } from '@fougere/container';
+import { createHttpTransport } from '@fougere/transport-http';
+import { resolveStorage, type DbConfig } from './storage.js';
+
+export { resolveStorage, declaresStorage, storageFrom } from './storage.js';
+export type { DbConfig, SourcesConfig, DeclaredStorage, Placement, ResolvedStorage } from './storage.js';
+
+export interface BootAppOptions {
+  /** Boot only these fronds (by name). Absent = every discovered frond. */
+  fronds?: string[];
+  /**
+   * Follow `remotes:` from config (default true). A host process (`serve`)
+   * passes false — it *is* the frond, it doesn't route back out.
+   */
+  topology?: boolean;
+  /**
+   * What this app takes on beyond its fronds — `observability()` is the first one.
+   * Appended after the framework's own members, or replacing one by naming it.
+   */
+  extensions?: CreateAppOptions['extensions'];
+}
+
+/**
+ * Boot a Fougere app from the `fougere.config.ts` at `root`, wired the
+ * conventional way (container + sqlite + http remotes).
+ */
+export async function bootAppFromConfig(root: string, opts: BootAppOptions = {}): Promise<App> {
+  const config = await loadConfig(root);
+  const remotes = config.remotes ?? {};
+  const useRemotes = (opts.topology ?? true) && Object.keys(remotes).length > 0;
+
+  return boot({
+    root,
+    createContainer,
+    fronds: opts.fronds,
+    remotes: useRemotes ? remotes : undefined,
+    remoteTransport: useRemotes ? (url) => createHttpTransport(url) : undefined,
+    // One resolver, one place that knows a storage package.
+    db: (cfg) => resolveStorage(cfg.db as DbConfig, (cfg as { sources?: unknown }).sources as never),
+    extensions: opts.extensions,
+  });
+}

package/src/storage.ts

@@ -0,0 +1,251 @@
+/**
+ * Storage resolution — `config.db` → a working data layer.
+ *
+ * THE single place that names a storage package. Every host (the conventional
+ * boot, the Nuxt fallback, the CLI's frond host) calls this instead of wiring an
+ * engine itself; swapping the implementation is a change here and nowhere else.
+ *
+ * Before this existed, each host re-resolved `db: 'sqlite'` inline — which is
+ * why an engine change looked like it touched seven files.
+ */
+import type { App } from '@fougere/core';
+import { Fronds, type FrondDescriptor } from '@fougere/core';
+import { lowerFirst } from '@fougere/core/contract';
+import { migrate, type DialectName, type Setup } from '@fougere/adapter-sql';
+import { setupSqlite } from '@fougere/adapter-sql/sqlite';
+
+/** The `db` field of fougere.config.ts, read structurally. */
+export type DbConfig =
+  | false
+  | 'sqlite'
+  | { dialect?: string; path?: string }
+  | undefined;
+
+/** A named source and the entities it holds — the `sources` field, read structurally. */
+export type SourcesConfig = Record<string, { dialect?: string; path?: string; entities: string[] }> | undefined;
+
+export interface ResolvedStorage {
+  /** Opaque handle handed to auth providers. */
+  db?: unknown;
+  ormFactory: ((entity: any, name: string) => any) | undefined;
+  /**
+   * The source an entity's rows live in — what decides whether a frame gets a real
+   * transaction or an unwind it replays itself.
+   *
+   * Absent when the caller built a `ResolvedStorage` by hand: there is then one factory
+   * and no routing, so every entity IS on one engine — but nothing here can reach into it
+   * for a transaction, and a frame falls back to compensating. Not knowing and promising
+   * atomicity are two different things.
+   */
+  sourceOf?: (entityName: string) => string;
+  /**
+   * The engine a source runs on — the dual of `sourceOf`, which names it without
+   * reaching it. A caller that must run DDL per engine needs the handle, not the name.
+   */
+  dbOf?: (source: string) => unknown;
+  /** Every source that has an engine, the default one first. */
+  sources?: () => string[];
+  /** Run `fn` inside one transaction of that source, with an ORM factory bound to it. */
+  transacted?: <R>(source: string, fn: (ormFactory: (entity: any, name: string) => any) => Promise<R>) => Promise<R>;
+  /**
+   * Brings the schema up to date once the app is scanned — the storage's `up`, handed to
+   * `migrating()`. It was called `afterBoot`, a word that also meant the host's own
+   * post-boot and was read in four places under the two senses.
+   */
+  migrate?: (app: App) => Promise<void> | void;
+  /**
+   * Close every engine this opened — the dual of opening them, declared by whoever did.
+   *
+   * `boot()` calls the factory that lands here, so `boot()` is what owns closing it: a
+   * container disposes what IT built, and this connection was handed in. Without this
+   * the pool of a discarded app stayed open, which is what turning the ring makes
+   * ordinary rather than rare.
+   */
+  close?: () => Promise<void>;
+  /** Raw synchronous handle, when the engine exposes one. */
+  raw?: { exec(sql: string): void };
+  dialect?: DialectName;
+}
+
+/** Does this config ask for persistence at all? */
+export function declaresStorage(dbConf: DbConfig): boolean {
+  if (dbConf === false || dbConf === undefined) return false;
+  return true;
+}
+
+/**
+ * Only sqlite is resolvable from a NAME — its driver is a dependency here. Any other
+ * engine needs a Kysely dialect INSTANCE, which only the host can build because only
+ * the host has its driver. So the name is refused, and the way in is named.
+ *
+ * `dialect` used to be declared and never read: `db: { dialect: 'postgres' }` started
+ * SQLite and said nothing — a config whose central word was ignored.
+ */
+function refuseUnresolvable(declared: string | undefined, field: string): void {
+  if (declared === undefined || declared === 'sqlite') return;
+  throw new Error(
+    `${field} '${declared}' cannot be resolved from its name — only 'sqlite' can, ` +
+    `because it is the one driver this package depends on. For ${declared}, build the ` +
+    `Kysely dialect yourself and call setupKysely(dialect, '${declared}') ` +
+    `from @fougere/adapter-sql.`,
+  );
+}
+
+/**
+ * The app as ONE source sees it: the entities that live there, and the names of those
+ * that do not.
+ *
+ * The second half is what lets the DDL stop lying. A batch holding every entity could
+ * never tell a cross-source target from a typo, so it derived a table name and emitted
+ * a foreign key against a table that may not exist. Cut per source, `elsewhere` says
+ * which misses are legitimate — and a target in neither list is a mistake, out loud.
+ *
+ * Auth entities ride with the default source: a provider's tables are the app's own,
+ * and nothing yet lets one declare where it lives.
+ */
+function partition(
+  app: App,
+  holds: (name: string) => boolean,
+  withAuth: boolean,
+  materialize: string[],
+): unknown {
+  const typed = app as unknown as {
+    fronds: { name: string; entities: { name: string }[] }[];
+    auth?: unknown;
+  };
+  const fronds = typed.fronds
+    .map((frond) => ({ ...frond, entities: frond.entities.filter((entry) => holds(entry.name)) }))
+    .filter((frond) => frond.entities.length > 0);
+  return {
+    fronds,
+    auth: withAuth ? typed.auth : undefined,
+    // Lifted, because this function reads its app structurally on purpose — a caller
+    // may hand it a shape that is app-LIKE, and the question is still the same one.
+    elsewhere: Fronds.scanned(typed.fronds as FrondDescriptor[]).entityNames().filter((name) => !holds(name)),
+    // A derivation makes no table unless a source names it — see AppLike.materialize.
+    materialize,
+  };
+}
+
+/**
+ * Resolve the data layer. `db: false` (or absent) means a frond with no
+ * persistence of its own — the caller decides what to fall back to.
+ *
+ * `sources` names the places that are NOT the default one. An entity it does not
+ * name stays in `db`, so an app with one database declares nothing and behaves
+ * exactly as before.
+ */
+export function resolveStorage(dbConf: DbConfig, sources?: SourcesConfig): ResolvedStorage {
+  if (!declaresStorage(dbConf)) return { ormFactory: undefined };
+
+  refuseUnresolvable(typeof dbConf === 'object' ? dbConf.dialect : (dbConf || undefined), 'db.dialect');
+  const named: Record<string, Placement> = {};
+  for (const [name, conf] of Object.entries(sources ?? {})) {
+    refuseUnresolvable(conf.dialect, `sources.${name}.dialect`);
+    named[name] = { setup: setupSqlite({ path: conf.path }), entities: conf.entities };
+  }
+  return storageFrom({
+    db: setupSqlite({ path: typeof dbConf === 'object' ? dbConf.path : undefined }),
+    sources: named,
+  });
+}
+
+/** One source: the engine that holds it, and the entities that live there. */
+export interface Placement {
+  setup: Setup;
+  entities: string[];
+}
+
+export interface DeclaredStorage {
+  /** The default source — where an entity no placement names lands. */
+  db: Setup;
+  /** The other places. Absent means one source, the way it always was. */
+  sources?: Record<string, Placement>;
+}
+
+/**
+ * The same routing `resolveStorage` performs, over engines the CALLER built.
+ *
+ * `resolveStorage` reads a config file, and a config file cannot hold a live Kysely
+ * dialect — so it can only ever resolve sqlite, the one driver this package depends
+ * on. That was fine while `db:` was alone, because the escape hatch was to abandon
+ * the convention entirely and hand `configureFougere` your own factory. With several
+ * sources that stopped being an escape: a user wanting Postgres for ONE of them had
+ * to re-implement the routing and the per-source migration to keep the other.
+ *
+ * So the two jobs are separated. Resolving a NAME into an engine is sqlite-only and
+ * stays there; placing entities and migrating each source is engine-agnostic and
+ * lives here, where any `Setup` is welcome:
+ *
+ * ```ts
+ * configureFougere(storageFrom({
+ *   db: setupSqlite({ path: '.data/app.db' }),
+ *   sources: { legacy: { setup: setupKysely(pgDialect, 'postgres'), entities: ['Book'] } },
+ * }));
+ * ```
+ */
+export function storageFrom(declared: DeclaredStorage): ResolvedStorage {
+  const { db: base, sources } = declared;
+
+  // Where each named entity lives. An entity claimed by two sources is refused naming
+  // both: the rows would be read from one and written to the other, by whichever
+  // registration ran last — the same silent duplicate `remotes:` refuses one level up.
+  const home = new Map<string, string>();
+  const engines = new Map<string, Setup>();
+  /** Everything a source names — the opt-in that turns a derivation into stored rows. */
+  const named: string[] = [];
+  for (const [name, placement] of Object.entries(sources ?? {})) {
+    engines.set(name, placement.setup);
+    for (const entity of placement.entities) {
+      const key = lowerFirst(entity);
+      const claimed = home.get(key);
+      if (claimed) {
+        throw new Error(
+          `sources: '${entity}' is claimed by both '${claimed}' and '${name}' — an entity lives in one place.`,
+        );
+      }
+      home.set(key, name);
+      named.push(entity);
+    }
+  }
+
+  // The default source answers to the name the config gave it, so a refusal naming two
+  // sources names things the author can find in their own file.
+  const DEFAULT = 'db';
+  const sourceOf = (entityName: string) => home.get(lowerFirst(entityName)) ?? DEFAULT;
+  const engineOf = (source: string) => (source === DEFAULT ? base : engines.get(source));
+  const engineFor = (entityName: string) => {
+    const source = home.get(lowerFirst(entityName));
+    return (source && engines.get(source)) || base;
+  };
+
+  return {
+    db: base.db,
+    ormFactory: (entity: any, name: string) => engineFor(name).ormFactory(entity, name),
+    sourceOf,
+    dbOf: (source) => engineOf(source)?.db,
+    sources: () => [DEFAULT, ...engines.keys()],
+    transacted: (source, fn) => {
+      const engine = engineOf(source);
+      if (!engine) throw new Error(`No source named '${source}' — declared sources are ${[DEFAULT, ...engines.keys()].join(', ')}.`);
+      return engine.transacted(fn);
+    },
+    raw: (base as { sqlite?: { exec(sql: string): void } }).sqlite,
+    dialect: base.dialect,
+    // Additive migration: creates missing tables AND adds columns an entity gained.
+    // One pass per source, each seeing only its own tables — which is what makes a
+    // cross-source `ref()` a miss rather than a constraint against a stranger.
+    migrate: async (app) => {
+      await migrate(partition(app, (name) => !home.has(lowerFirst(name)), true, named) as never, base.db);
+      for (const [name, engine] of engines) {
+        await migrate(partition(app, (e) => home.get(lowerFirst(e)) === name, false, named) as never, engine.db);
+      }
+    },
+    // Every engine, the default one last: a named source may hold what the default
+    // refers to, and closing in reverse of opening is the rule everywhere else.
+    close: async () => {
+      for (const engine of [...engines.values()].reverse()) await engine.db.destroy();
+      await base.db.destroy();
+    },
+  };
+}