@fougere/core 0.5.0-alpha.1 → 0.7.0-alpha.0

package/dist/prefab/crud.js

@@ -1,41 +1,32 @@
-/** The id of the row an op acts on — a route segment, or a query fallback. */
-const byId = { name: 'id', source: { kind: 'param', name: 'id' }, optional: false };
-const fromBody = { name: 'input', source: { kind: 'body' }, optional: false };
+import { lowerFirst } from '@fougere/schema';
+import { targetOf } from './prefab.js';
+/**
+ * So a class is recognized by what it ANSWERS, since the mixin leaves no other trace.
+ * FR : pour qu'une classe se reconnaisse à ce qu'elle répond, le mixin ne laissant rien d'autre.
+ * `inheritsCrud(class PostHandler extends Crud(Post) {})` → `true`
+ */
+export function inheritsCrud(ctor) {
+    const proto = ctor?.prototype;
+    return typeof proto?.list === 'function' && typeof proto?.findById === 'function';
+}
 /**
- * The same five, written as the scan would have written them.
- *
- * `binding` says WHERE an argument is read from; it never says of what type, and a
- * GraphQL argument needs the type. So a producer that fills only `binding` leaves
- * `adapter/graphql` with nothing to declare — it drops the op (`registerOperations`,
- * `if (!sig) continue`) and four of the five CRUD ops vanish from the schema while
- * the façade and REST still serve them. Measured on an installed app: 16 handlers,
- * 14 with unresolvable heritage, zero `createX` in the schema.
+ * So storage follows the shape the handler was built on, which may differ from its address.
+ * FR : pour que le stockage suive la forme sur laquelle le handler est bâti.
+ * `subjectOf(class Draft extends Crud(Post) {}, 'draft')` → `'post'`
  */
+export function subjectOf(ctor, address) {
+    const target = targetOf(ctor);
+    return target?.name ? lowerFirst(target.name) : address;
+}
+/** The id of the row an op acts on — a route segment, or a query fallback. */
+const byId = { name: 'id', source: { kind: 'param', name: 'id' }, optional: false };
+const fromBody = { name: 'input', source: { kind: 'input' }, optional: false };
+/** The same five, written as the scan would have written them. */
 const idParam = { name: 'id', type: { raw: 'string', name: 'string' } };
 const inputParam = (entity) => ({ name: 'input', type: { raw: `Partial<${entity}>`, name: entity } });
 const returns = (raw, name, extra) => ({ raw, name, ...extra });
-/**
- * The five ops a Crud handler brings, declared rather than discovered.
- *
- * The mixin built them, so it alone knows their contract in full: what judges
- * their input, where each argument comes from. It says so on the class, at
- * runtime — which is what makes the guarantee independent of the AST scan (an
- * installed app cannot resolve this file, and never needs to).
- */
-/**
- * `output` says the entity, and saying it costs nothing at runtime.
- *
- * The façade already projected onto the entity when nothing else was named, so this
- * changes no result: `outputFieldsFor` reads `contractOutput` and falls back to the
- * entity, and both are the same shape here. What changes is that the sentence now
- * EXISTS — the identity card publishes `output` per op, and a card was measured
- * carrying none at all (2026-08-06, ten ops, zero outputs), which typed every remote
- * return as `unknown` for anyone building on it.
- *
- * It does not close the view: only an explicit `__opOutputs` does (`closed: perOp !==
- * undefined`), so a named view still wins and a presenter's computed fields still ride
- * out. `delete` names none — a boolean is not a shape.
- */
+/** The five ops a Crud handler brings, declared rather than discovered. */
+/** `output` says the entity, and saying it costs nothing at runtime. */
 function crudOps(entity) {
     const name = entity.name ?? 'Entity';
     const input = inputParam(name);
@@ -68,52 +59,34 @@ function crudOps(entity) {
         },
     };
 }
-/**
- * The mixin's single "trust me" point — the twin of `asSchemaConstructor` in @fougere/schema.
- *
- * The implementation returns whatever the ORM hands back; the declaration names the view
- * each op emits at the port. TypeScript cannot connect the two (the view is a runtime
- * argument, the type is a generic), so one assertion states that the mixin honours what it
- * declared — and the façade makes it true, projecting each op's result onto its view
- * (`outputFieldsFor` in `bootstrap.ts`).
- */
+/** The mixin's single "trust me" point — the twin of `asSchemaConstructor` in @fougere/schema. */
 function asCrudConstructor(impl) {
     return impl;
 }
-/**
- * Mixin — extends Crud(Entity) to get all 5 typed CRUD methods.
- *
- * The second argument (optional) names the view the ops emit, and comes in two
- * spellings of one idea — a view per op, or one view for all five:
- *
- * Crud(Post)                      → every op emits Post
- * Crud(Post, { list: PostCard })  → list emits cards, the rest emit Post. Declaration
- *                                   only: the handler keeps its full-row ORM, so a
- *                                   judge can still read `body`.
- * Crud(Post, PostPublic)          → every op emits PostPublic, and the bootstrap
- *                                   scopes the injected ORM via .output(PostPublic) —
- *                                   the whole handler speaks the restricted view.
- */
+/** Mixin — extends Crud(Entity) to get all 5 typed CRUD methods. */
 export function Crud(entity, output) {
     // A view is a class (it carries fields) ; a map of views is a plain object.
     const perOp = typeof output === 'object' && output !== null ? output : undefined;
     const wholeHandler = typeof output === 'function' ? output : undefined;
     return asCrudConstructor(class CrudHandler {
         static __entity = entity;
-        /** Handler-wide view only — a per-op map must NOT scope the ORM the judges read. */
+        /** Handler-wide view only — a per-op map must NOT scope the storage the validators read. */
         static __output = wholeHandler ?? entity;
         static __opOutputs = perOp;
-        /** What this prefab handler declares — read by the façade, merged under the author's own methods. */
+        /**
+         * What this prefab handler declares — read by the façade, merged under the author's own
+         * methods.
+         */
         static __ops = crudOps(entity);
-        orm;
-        constructor(orm) {
-            this.orm = orm;
+        storage;
+        constructor(storage) {
+            this.storage = storage;
         }
-        async list(options) { return this.orm.list(options); }
-        async findById(id) { return this.orm.findById(id); }
-        async create(input) { return this.orm.create(input); }
-        async update(id, input) { return this.orm.update(id, input); }
-        async delete(id) { return this.orm.delete(id); }
+        async list(options) { return this.storage.list(options); }
+        async findById(id) { return this.storage.findById(id); }
+        async create(input) { return this.storage.create(input); }
+        async update(id, input) { return this.storage.update(id, input); }
+        async delete(id) { return this.storage.delete(id); }
     });
 }
 //# sourceMappingURL=crud.js.map

package/dist/prefab/crud.js.map

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

package/dist/prefab/mirror.d.ts

@@ -1,31 +1,9 @@
 import { type EntityConstructor } from '@fougere/schema';
-import type { EntityOrm } from '../orm.js';
-/**
- * A paginated local copy of a source that cannot be queried directly.
- *
- * The shape must contain an `updated()` field used as a high-water mark. Subclasses
- * implement `pull`; `refresh` validates and upserts each returned page.
- *
- * ```ts
- * export default class PartnerCatalog extends Mirror(BookCard) {
- *   constructor(orm: EntityOrm<BookCard>, private catalog: Facade<CatalogHandler>) {
- *     super(orm);
- *   }
- *
- *   async *pull(since?: Date) {
- *     for (let page = 0; page !== null;) {
- *       const body = await fetch(`${api}?page=${page}&since=${since?.toISOString() ?? ''}`);
- *       const { items, next } = await body.json();
- *       yield items.map(toCard);
- *       page = next;
- *     }
- *   }
- * }
- * ```
- */
+import type { Storage } from '../storage.js';
+/** A paginated local copy of a source that cannot be queried directly. */
 /** What one refresh did — enough to log it, and to decide whether to run again. */
 export interface Refreshed {
-    /** Rows written, counting a replaced row once. */
+    /** Instances written, counting a replaced one once. */
     written: number;
     /** The age the pull was asked to start from — absent on the first ever run. */
     since?: Date;
@@ -34,7 +12,7 @@ export interface Refreshed {
 }
 export interface MirrorOf<T> {
     /** The copy's own storage — where a page lands, and where its age is read. */
-    orm: EntityOrm<T>;
+    storage: Storage<T>;
     /** Pages of rows to write. The one thing a mirror's author supplies. */
     pull(since?: Date): AsyncIterable<Partial<T>[]>;
     /** Run one pass: read the high-water mark, pull from there, write each page. */
@@ -43,7 +21,7 @@ export interface MirrorOf<T> {
     freshness(): Promise<Date | undefined>;
 }
 export interface MirrorConstructor<T> {
-    new (orm: EntityOrm<T>): MirrorOf<T>;
+    new (storage: Storage<T>): MirrorOf<T>;
     readonly __entity: unknown;
 }
 export declare function Mirror<E extends EntityConstructor>(shape: E): MirrorConstructor<InstanceType<E>>;

package/dist/prefab/mirror.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mirror.d.ts","sourceRoot":"","sources":["../../src/prefab/mirror.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,iBAAiB,EAAsC,MAAM,iBAAiB,CAAC;AAClH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,mFAAmF;AACnF,MAAM,WAAW,SAAS;IACxB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,8EAA8E;IAC9E,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IAClB,wEAAwE;IACxE,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAChD,gFAAgF;IAChF,OAAO,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;IAC9B,oFAAoF;IACpF,SAAS,IAAI,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,KAAK,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAgB,MAAM,CAAC,CAAC,SAAS,iBAAiB,EAAE,KAAK,EAAE,CAAC,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAyChG;AAED,qDAAqD;AACrD,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAO7D"}
+{"version":3,"file":"mirror.d.ts","sourceRoot":"","sources":["../../src/prefab/mirror.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,iBAAiB,EAAe,MAAM,iBAAiB,CAAC;AACjF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,0EAA0E;AAC1E,mFAAmF;AACnF,MAAM,WAAW,SAAS;IACxB,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,8EAA8E;IAC9E,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,wEAAwE;IACxE,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAChD,gFAAgF;IAChF,OAAO,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;IAC9B,oFAAoF;IACpF,SAAS,IAAI,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,KAAK,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAgB,MAAM,CAAC,CAAC,SAAS,iBAAiB,EAAE,KAAK,EAAE,CAAC,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAyChG;AAED,qDAAqD;AACrD,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAO7D"}

package/dist/prefab/mirror.js

@@ -1,4 +1,4 @@
-import { FieldSet, Lifecycle } from '@fougere/schema';
+import { Lifecycle } from '@fougere/schema';
 export function Mirror(shape) {
     // Refuse an undated copy before it can be used as if it held live rows.
     const declared = ageFieldOf(shape);
@@ -8,14 +8,14 @@ export function Mirror(shape) {
     }
     const age = declared;
     class MirrorBase {
-        orm;
+        storage;
         static __entity = shape;
-        constructor(orm) {
-            this.orm = orm;
+        constructor(storage) {
+            this.storage = storage;
         }
         /** The freshest persisted stamp; no process-local freshness state is kept. */
         async freshness() {
-            const [newest] = await this.orm.list({ orderBy: age, order: 'desc', limit: 1 });
+            const [newest] = await this.storage.list({ orderBy: age, order: 'desc', limit: 1 });
             const value = newest?.[age];
             return value instanceof Date ? value : undefined;
         }
@@ -27,7 +27,7 @@ export function Mirror(shape) {
             for await (const page of this.pull(since)) {
                 if (page.length === 0)
                     continue;
-                written += await this.orm.upsertAll(judgePage(shape, page));
+                written += await this.storage.upsertAll(page);
             }
             return { written, since, ms: Date.now() - started };
         }
@@ -45,22 +45,4 @@ export function ageFieldOf(shape) {
     }
     return undefined;
 }
-/** Validate and decode a page, naming a refused row by its declared primary field. */
-function judgePage(shape, page) {
-    const judge = shape.validate;
-    if (typeof judge !== 'function')
-        return page;
-    const name = shape.name ?? 'mirror';
-    const fields = shape.getFields?.();
-    const primary = fields ? FieldSet.of(fields).primary : undefined;
-    return page.map((row, index) => {
-        const verdict = judge.call(shape, row);
-        if (verdict.success)
-            return verdict.data;
-        const key = primary === undefined ? undefined : row[primary];
-        const where = key !== undefined ? `row ${primary} ${JSON.stringify(key)}` : `row ${index} of this page`;
-        const why = verdict.errors.map((e) => `${e.path}: ${e.message}`).join(', ');
-        throw new Error(`${name} mirror refused ${where} — ${why}`);
-    });
-}
 //# sourceMappingURL=mirror.js.map

package/dist/prefab/mirror.js.map

@@ -1 +1 @@
-{"version":3,"file":"mirror.js","sourceRoot":"","sources":["../../src/prefab/mirror.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mirror.js","sourceRoot":"","sources":["../../src/prefab/mirror.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAuC,MAAM,iBAAiB,CAAC;AA8BjF,MAAM,UAAU,MAAM,CAA8B,KAAQ;IAG1D,wEAAwE;IACxE,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,UAAW,KAA2B,CAAC,IAAI,IAAI,GAAG,gDAAgD;YAClG,qGAAqG,CACtG,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAW,QAAQ,CAAC;IAE7B,MAAe,UAAU;QAGJ;QAFnB,MAAM,CAAU,QAAQ,GAAG,KAAK,CAAC;QAEjC,YAAmB,OAAmB;YAAnB,YAAO,GAAP,OAAO,CAAY;QAAG,CAAC;QAI1C,8EAA8E;QAC9E,KAAK,CAAC,SAAS;YACb,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;YACpF,MAAM,KAAK,GAAI,MAA8C,EAAE,CAAC,GAAG,CAAC,CAAC;YACrE,OAAO,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QACnD,CAAC;QAED,KAAK,CAAC,OAAO;YACX,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;YACrC,IAAI,OAAO,GAAG,CAAC,CAAC;YAChB,sEAAsE;YACtE,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;oBAAE,SAAS;gBAChC,OAAO,IAAI,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAChD,CAAC;YACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;QACtD,CAAC;;IAGH,OAAO,UAA6C,CAAC;AACvD,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,MAAM,MAAM,GAAI,KAAsC,CAAC,SAAS,EAAE,EAAE,CAAC;IACrE,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,IAAI,SAAS,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,eAAe;YAAE,OAAO,IAAI,CAAC;IACvD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/prefab/prefab.d.ts

@@ -1,12 +1,6 @@
 import type { EntityConstructor } from '@fougere/schema';
 import type { PresenterViews } from './presenter.js';
-/**
- * The shape a prefab was built on, or `undefined` when the class is not one.
- *
- * A plain property read: JavaScript walks a constructor's own prototype chain, so a
- * subclass of a prefab answers what its base recorded. Three of the five accessors this
- * replaces walked that chain by hand, and two did not — one question, two mechanisms.
- */
+/** The shape a prefab was built on, or `undefined` when the class is not one. */
 export declare function targetOf(ctor: unknown): EntityConstructor | undefined;
 /** The views a prefab declares, same rule. */
 export declare function viewsOf(ctor: unknown): PresenterViews | undefined;

package/dist/prefab/prefab.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prefab.d.ts","sourceRoot":"","sources":["../../src/prefab/prefab.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAyBrD;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS,CAErE;AAED,8CAA8C;AAC9C,wBAAgB,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,GAAG,SAAS,CAEjE;AAED,0DAA0D;AAC1D,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS,CAErE"}
+{"version":3,"file":"prefab.d.ts","sourceRoot":"","sources":["../../src/prefab/prefab.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAYrD,iFAAiF;AACjF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS,CAErE;AAED,8CAA8C;AAC9C,wBAAgB,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,GAAG,SAAS,CAEjE;AAED,0DAA0D;AAC1D,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS,CAErE"}

package/dist/prefab/prefab.js

@@ -1,10 +1,4 @@
-/**
- * The shape a prefab was built on, or `undefined` when the class is not one.
- *
- * A plain property read: JavaScript walks a constructor's own prototype chain, so a
- * subclass of a prefab answers what its base recorded. Three of the five accessors this
- * replaces walked that chain by hand, and two did not — one question, two mechanisms.
- */
+/** The shape a prefab was built on, or `undefined` when the class is not one. */
 export function targetOf(ctor) {
     return ctor?.__entity;
 }

package/dist/prefab/prefab.js.map

@@ -1 +1 @@
-{"version":3,"file":"prefab.js","sourceRoot":"","sources":["../../src/prefab/prefab.ts"],"names":[],"mappings":"AA0BA;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAa;IACpC,OAAQ,IAA2B,EAAE,QAAQ,CAAC;AAChD,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,OAAO,CAAC,IAAa;IACnC,OAAQ,IAA2B,EAAE,OAAO,CAAC;AAC/C,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,QAAQ,CAAC,IAAa;IACpC,OAAQ,IAA2B,EAAE,QAAQ,CAAC;AAChD,CAAC"}
+{"version":3,"file":"prefab.js","sourceRoot":"","sources":["../../src/prefab/prefab.ts"],"names":[],"mappings":"AAaA,iFAAiF;AACjF,MAAM,UAAU,QAAQ,CAAC,IAAa;IACpC,OAAQ,IAA2B,EAAE,QAAQ,CAAC;AAChD,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,OAAO,CAAC,IAAa;IACnC,OAAQ,IAA2B,EAAE,OAAO,CAAC;AAC/C,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,QAAQ,CAAC,IAAa;IACpC,OAAQ,IAA2B,EAAE,QAAQ,CAAC;AAChD,CAAC"}

package/dist/prefab/presenter.d.ts

@@ -1,45 +1,11 @@
-/**
- * Presenter(Entity) — enriches an entity's output with computed fields.
- *
- * Each method on the presenter is a computed field resolver:
- * - Receives the entity record as first argument
- * - Can be sync or async
- * - Injected via DI (constructor params resolved by the container)
- *
- * Usage:
- * ```ts
- * export default class PostPresenter extends Presenter(Post) {
- *   constructor(private commentOrm: CommentOrm) { super(); }
- *
- *   excerpt(post: Post) {
- *     return post.body.slice(0, 200);
- *   }
- *
- *   async commentCount(post: Post) {
- *     return this.commentOrm.countFor(post.id);
- *   }
- * }
- * ```
- */
+/** Presenter(Entity) — enriches an entity's output with computed fields. */
 import { type EntityConstructor } from '@fougere/schema';
 /**
  * The view a computed field emits — `OrderItemView` for one, `[OrderItemView]` for many.
  * A view is a schema, so it derives: `Order.pick('id', 'status')`, never a hand-written type.
  */
 export type PresenterViews = Record<string, EntityConstructor | [EntityConstructor]>;
-/**
- * `Presenter(Order, { items: [OrderItemView], user: UserCard })` — the second argument names
- * the view each computed field emits, exactly as `Crud(Post, { list: PostCard })` names an
- * op's. What fabricates a field declares its contract, and it declares it **once**: the
- * façade applies the presenter (see `PresenterExecutor`), and every surface reads the same statement
- * instead of guessing.
- *
- * Guessing was the cost of not stating it. The scan can read a scalar off a return type and
- * nothing more, so a field returning an object had no derivable shape: the GraphQL projection
- * fell back to a serialized `String`, and a client asking `items { quantity }` got a schema
- * error on a field REST served whole. Declaring is optional — a scalar field needs nothing,
- * and an undeclared object keeps the old behaviour.
- */
+/** `Presenter(Order, { items. */
 export declare function Presenter<E extends EntityConstructor>(entity: E, views?: PresenterViews): {
     new (): {};
     readonly __entity: E;

package/dist/prefab/presenter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"presenter.d.ts","sourceRoot":"","sources":["../../src/prefab/presenter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAc,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAErE;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC;AAErF;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,iBAAiB,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,cAAc;;;;EAMvF;AAED,wFAAwF;AACxF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,EAAE,CAG3D;AAED,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAErD"}
+{"version":3,"file":"presenter.d.ts","sourceRoot":"","sources":["../../src/prefab/presenter.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAE5E,OAAO,EAAc,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAErE;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC;AAErF,iCAAiC;AACjC,wBAAgB,SAAS,CAAC,CAAC,SAAS,iBAAiB,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,cAAc;;;;EAMvF;AAED,wFAAwF;AACxF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,EAAE,CAG3D;AAED,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/prefab/presenter.js

@@ -1,40 +1,6 @@
-/**
- * Presenter(Entity) — enriches an entity's output with computed fields.
- *
- * Each method on the presenter is a computed field resolver:
- * - Receives the entity record as first argument
- * - Can be sync or async
- * - Injected via DI (constructor params resolved by the container)
- *
- * Usage:
- * ```ts
- * export default class PostPresenter extends Presenter(Post) {
- *   constructor(private commentOrm: CommentOrm) { super(); }
- *
- *   excerpt(post: Post) {
- *     return post.body.slice(0, 200);
- *   }
- *
- *   async commentCount(post: Post) {
- *     return this.commentOrm.countFor(post.id);
- *   }
- * }
- * ```
- */
+/** Presenter(Entity) — enriches an entity's output with computed fields. */
 import { upperFirst } from '@fougere/schema';
-/**
- * `Presenter(Order, { items: [OrderItemView], user: UserCard })` — the second argument names
- * the view each computed field emits, exactly as `Crud(Post, { list: PostCard })` names an
- * op's. What fabricates a field declares its contract, and it declares it **once**: the
- * façade applies the presenter (see `PresenterExecutor`), and every surface reads the same statement
- * instead of guessing.
- *
- * Guessing was the cost of not stating it. The scan can read a scalar off a return type and
- * nothing more, so a field returning an object had no derivable shape: the GraphQL projection
- * fell back to a serialized `String`, and a client asking `items { quantity }` got a schema
- * error on a field REST served whole. Declaring is optional — a scalar field needs nothing,
- * and an undeclared object keeps the old behaviour.
- */
+/** `Presenter(Order, { items. */
 export function Presenter(entity, views) {
     class PresenterBase {
         static __entity = entity;

package/dist/prefab/presenter.js.map

@@ -1 +1 @@
-{"version":3,"file":"presenter.js","sourceRoot":"","sources":["../../src/prefab/presenter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,UAAU,EAA0B,MAAM,iBAAiB,CAAC;AAQrE;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,SAAS,CAA8B,MAAS,EAAE,KAAsB;IACtF,MAAM,aAAa;QACjB,MAAM,CAAU,QAAQ,GAAG,MAAM,CAAC;QAClC,MAAM,CAAU,OAAO,GAAG,KAAK,CAAC;;IAElC,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,kBAAkB,CAAC,IAAc;IAC/C,OAAO,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC;SAC9C,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,aAAa,IAAI,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,UAAU,CAAC,CAAC;AAC5F,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"presenter.js","sourceRoot":"","sources":["../../src/prefab/presenter.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAE5E,OAAO,EAAE,UAAU,EAA0B,MAAM,iBAAiB,CAAC;AAQrE,iCAAiC;AACjC,MAAM,UAAU,SAAS,CAA8B,MAAS,EAAE,KAAsB;IACtF,MAAM,aAAa;QACjB,MAAM,CAAU,QAAQ,GAAG,MAAM,CAAC;QAClC,MAAM,CAAU,OAAO,GAAG,KAAK,CAAC;;IAElC,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,kBAAkB,CAAC,IAAc;IAC/C,OAAO,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC;SAC9C,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,aAAa,IAAI,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,UAAU,CAAC,CAAC;AAC5F,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC;AAC1C,CAAC"}

package/dist/prefab/repository.d.ts

@@ -1,90 +1,27 @@
 import { type EntityConstructor } from '@fougere/schema';
-import type { EntityOrm } from '../orm.js';
+import type { Storage } from '../storage.js';
+/** Repository(…entities) — who owns an entity's storage, and where its questions are named. */
 /**
- * Repository(…entities) — who owns an entity's storage, and where its questions are named.
- *
- * **The arity decides**, which is the second reading of what `orm.ts` already states for
- * `EntityOrm` against `Together`: the arity of the unit is the whole distinction.
- *
- * ONE entity — the repository IS that entity's storage, with your methods added. The port's
- * thirteen gestures are forwarded, so a handler reads `this.posts.list()` whether or not
- * anyone wrote the file, and a named question sits beside them:
- *
- * ```ts
- * // repositories/PostRepository.ts
- * export default class PostRepository extends Repository(Post) {
- *   published() {
- *     return this.list({ where: { status: 'published' }, orderBy: 'publishedAt', order: 'desc' });
- *   }
- * }
- * ```
- *
- * TWO OR MORE — an aggregate. It owns them: nothing else in the app is handed their
- * storage, and no gesture is forwarded (which entity would `create` write to?), so the only
- * way in is a method this class names. That is what lets a rule spanning two tables exist:
- * it is ordinary TypeScript inside the method that does the writing.
- *
- * ```ts
- * // repositories/CommandeRepository.ts
- * export default class CommandeRepository extends Repository(Commande, Stock) {
- *   avecLignes(id: string) {
- *     const [commandes, stock] = this.orms;
- *     …
- *   }
- * }
- * ```
- *
- * `this.orms` is protected, because the whole point is that the storage stops at this file.
- * `protected` is erased at runtime, like `abstract` on a port: a compile-time guarantee, not
- * a barrier. The same bargain, already accepted.
- *
- * **The boundary is not the unit of work.** An aggregate says the rules of these entities
- * hold together; a frame says these writes land together, and the two lists coincide only
- * often. Deriving the frame from the membership would make a read-only aggregate carry one
- * — refusals included, and `registerFrames` refuses without storage or over `remotes:` —
- * and would put `Together<[Commande, Stock], [StockMirror]>` out of reach forever. So a
- * frame is ASKED FOR here as anywhere else, which is what makes it declared:
- *
- * ```ts
- * constructor(commandes: CommandeOrm, stock: StockOrm, private frame: Together<[Commande, Stock]>) {
- *   super(commandes, stock);
- * }
- * ```
- *
- * The ORM words come back in that line, and only there: this class IS the holder, which is
- * the one case `boot/ownership.ts` lets name the storage it was built on.
- *
- * A repository is NOT a door: it has no façade, so nothing here is reachable from the wire.
+ * The shape a repository of ONE entity has — the port itself, plus whatever the subclass names on
+ * top.
  */
-/**
- * The shape a repository of ONE entity has — the port itself, plus whatever the subclass
- * names on top. Written by an author who has not written the file: `RepositoryOf<Post>` is
- * to `PostRepository` what `EntityOrm<Post>` is to `PostOrm`, one spelling of one key, and
- * `depKeyOf` reads both.
- */
-export type RepositoryOf<T> = EntityOrm<T>;
+export type RepositoryOf<T> = Storage<T>;
 /** The single-entity form: the port, plus whatever the subclass names. */
 export interface RepositoryConstructor<T> {
-    new (orm: EntityOrm<T>): EntityOrm<T>;
+    new (storage: Storage<T>): Storage<T>;
     readonly __entity: unknown;
 }
-/**
- * What an aggregate's subclass sees: the storage of the members it owns, in declared order,
- * and `protected` — the storage stops at that file, which is the whole mechanism.
- *
- * A class and not an interface, because `protected` cannot be spelled in one. Ambient: the
- * value it describes is fabricated by `many()` for an arity only known at the call.
- */
+/** What an aggregate's subclass sees. */
 declare abstract class AggregateShape<E extends readonly EntityConstructor[]> {
-    protected orms: {
-        [K in keyof E]: EntityOrm<InstanceType<E[K]>>;
+    protected storages: {
+        [K in keyof E]: Storage<InstanceType<E[K]>>;
     };
 }
 /** The tuple an aggregate holds — the readable form of {@link AggregateShape}'s member. */
 export type AggregateOf<E extends readonly EntityConstructor[]> = {
-    [K in keyof E]: EntityOrm<InstanceType<E[K]>>;
+    [K in keyof E]: Storage<InstanceType<E[K]>>;
 };
-export type AggregateConstructor<E extends readonly EntityConstructor[]> = (new (...orms: unknown[]) => AggregateShape<E>) & {
+export type AggregateConstructor<E extends readonly EntityConstructor[]> = (new (...storages: unknown[]) => AggregateShape<E>) & {
     readonly __entity: unknown;
     /** The entities this class owns. Present from two on — an owner of one owns nothing. */
     readonly __owns: E;
@@ -93,12 +30,7 @@ export declare function Repository<E extends EntityConstructor>(entity: E): Repo
 export declare function Repository<E extends readonly [EntityConstructor, EntityConstructor, ...EntityConstructor[]]>(...entities: E): AggregateConstructor<E>;
 /** Container key of an entity's repository — 'reading' → 'ReadingRepository'. */
 export declare function repositoryKeyOf(entity: string): string;
-/**
- * The entities a class owns — empty for anything that is not an aggregate.
- *
- * Read from the mark rather than from the constructor, for the reason `Crud.__ops` exists:
- * the AST scan is workspace-only, so an installed prefab resolves to nothing.
- */
+/** The entities a class owns — empty for anything that is not an aggregate. */
 export declare function ownedBy(ctor: unknown): readonly EntityConstructor[];
 export {};
 //# sourceMappingURL=repository.d.ts.map

package/dist/prefab/repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../src/prefab/repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAyC,MAAM,WAAW,CAAC;AAGlF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC;AAE3C,0EAA0E;AAC1E,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,KAAK,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,OAAO,CAAC,QAAQ,OAAO,cAAc,CAAC,CAAC,SAAS,SAAS,iBAAiB,EAAE;IAC1E,SAAS,CAAC,IAAI,EAAE;SAAG,CAAC,IAAI,MAAM,CAAC,GAAG,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAAE,CAAC;CACnE;AAED,2FAA2F;AAC3F,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,SAAS,iBAAiB,EAAE,IAC5D;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC;AAEpD,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,SAAS,iBAAiB,EAAE,IACrE,CAAC,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG;IAChD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,wFAAwF;IACxF,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;CACpB,CAAC;AAEJ,wBAAgB,UAAU,CAAC,CAAC,SAAS,iBAAiB,EAAE,MAAM,EAAE,CAAC,GAAG,qBAAqB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3G,wBAAgB,UAAU,CAAC,CAAC,SAAS,SAAS,CAAC,iBAAiB,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,EAAE,CAAC,EAC1G,GAAG,QAAQ,EAAE,CAAC,GACb,oBAAoB,CAAC,CAAC,CAAC,CAAC;AAwD3B,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,iBAAiB,EAAE,CAEnE"}
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../src/prefab/repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,KAAK,EAAE,OAAO,EAAyC,MAAM,eAAe,CAAC;AAGpF,+FAA+F;AAE/F;;;GAGG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;AAEzC,0EAA0E;AAC1E,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,KAAK,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,yCAAyC;AACzC,OAAO,CAAC,QAAQ,OAAO,cAAc,CAAC,CAAC,SAAS,SAAS,iBAAiB,EAAE;IAC1E,SAAS,CAAC,QAAQ,EAAE;SAAG,CAAC,IAAI,MAAM,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAAE,CAAC;CACrE;AAED,2FAA2F;AAC3F,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,SAAS,iBAAiB,EAAE,IAC5D;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC;AAElD,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,SAAS,iBAAiB,EAAE,IACrE,CAAC,KAAK,GAAG,QAAQ,EAAE,OAAO,EAAE,KAAK,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG;IACpD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,wFAAwF;IACxF,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;CACpB,CAAC;AAEJ,wBAAgB,UAAU,CAAC,CAAC,SAAS,iBAAiB,EAAE,MAAM,EAAE,CAAC,GAAG,qBAAqB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3G,wBAAgB,UAAU,CAAC,CAAC,SAAS,SAAS,CAAC,iBAAiB,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,EAAE,CAAC,EAC1G,GAAG,QAAQ,EAAE,CAAC,GACb,oBAAoB,CAAC,CAAC,CAAC,CAAC;AAgD3B,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,+EAA+E;AAC/E,wBAAgB,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,iBAAiB,EAAE,CAEnE"}