@fougere/core 0.2.0-alpha.2 → 0.3.0-alpha.0

package/dist/{crud.d.ts → prefab/crud.d.ts}

@@ -1,11 +1,10 @@
-import type { EntityOrm, ListOptions, ListResult } from './orm.js';
-import type { OperationContract } from './operation.js';
-/** Anything the derivation algebra produces — an entity class or one of its views. */
-type SchemaCtor = abstract new (...args: any[]) => any;
+import type { EntityOrm, ListOptions, ListResult } from '../orm.js';
+import type { OperationContract } from '../wire/operation.js';
+import type { EntityConstructor } from '@fougere/schema';
 /** The five ops the mixin fabricates. */
 export type CrudOpName = 'list' | 'findById' | 'create' | 'update' | 'delete';
 /** Which view each op speaks — omitted ops speak the entity, the trivial view. */
-export type CrudViews = Partial<Record<CrudOpName, SchemaCtor>>;
+export type CrudViews = Partial<Record<CrudOpName, EntityConstructor>>;
 /**
  * The view an op emits, fabricated: the one declared for it, the single view when the
  * whole handler declares one, the entity otherwise. `PostCard` is not a hand-written
@@ -14,14 +13,14 @@ export type CrudViews = Partial<Record<CrudOpName, SchemaCtor>>;
  */
 type OutOf<V, K extends CrudOpName, T> = [
     V
-] extends [SchemaCtor] ? InstanceType<V & SchemaCtor> : K extends keyof V ? (V[K] extends SchemaCtor ? InstanceType<V[K]> : T) : T;
+] extends [EntityConstructor] ? InstanceType<V & EntityConstructor> : K extends keyof V ? (V[K] extends EntityConstructor ? InstanceType<V[K]> : T) : T;
 /**
  * The five ops, typed from the entity and its views.
  *
  * Two things the mixin declares but does not own. The **output** is the view the
  * handler names (`Crud(Post, { list: PostCard })`) — fabricated, so a redefinition
  * that returns cards stays assignable. The **trailing parameters** are resolved by
- * type from the container (`delete(id, user: User | null)` gets its user from a
+ * type from the container (`delete(id, user?: User)` gets its user from a
  * collector): the mixin cannot know them, they belong to the app, so it declares that
  * a tail exists and that it supplies none — which is what `never` says, and what keeps
  * a judged redefinition assignable.
@@ -56,6 +55,6 @@ export interface CrudConstructor<T, V = {}> {
  *                                   scopes the injected ORM via .output(PostPublic) —
  *                                   the whole handler speaks the restricted view.
  */
-export declare function Crud<E extends abstract new (...args: any[]) => any, V extends CrudViews | SchemaCtor = {}>(entity: E, output?: V): CrudConstructor<InstanceType<E>, V>;
+export declare function Crud<E extends EntityConstructor, V extends CrudViews | EntityConstructor = {}>(entity: E, output?: V): CrudConstructor<InstanceType<E>, V>;
 export {};
 //# sourceMappingURL=crud.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"crud.d.ts","sourceRoot":"","sources":["../../src/prefab/crud.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAc,MAAM,iBAAiB,CAAC;AAyFrE,yCAAyC;AACzC,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE9E,kFAAkF;AAClF,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC,CAAC;AAEvE;;;;;GAKG;AACH,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC,SAAS,UAAU,EAAE,CAAC,IAInC;IAAC,CAAC;CAAC,SAAS,CAAC,iBAAiB,CAAC,GAAG,YAAY,CAAC,CAAC,GAAG,iBAAiB,CAAC,GACnE,CAAC,SAAS,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,iBAAiB,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAC7E,CAAC,CAAC;AAEN;;;;;;;;;;GAUG;AACH,MAAM,WAAW,OAAO,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE;IAChC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IAClB,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,GAAG,SAAS,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7F,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAC1F,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;IACjF,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7F,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7D;AAED,4FAA4F;AAC5F,MAAM,WAAW,eAAe,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE;IAIxC,KAAK,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CACnD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,iBAAiB,EAAE,CAAC,SAAS,SAAS,GAAG,iBAAiB,GAAG,EAAE,EAC5F,MAAM,EAAE,CAAC,EACT,MAAM,CAAC,EAAE,CAAC,GACT,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CA2BrC"}

package/dist/{crud.js → prefab/crud.js}

@@ -1,6 +1,19 @@
 /** 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 };
+/**
+ * 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.
+ */
+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.
  *
@@ -24,14 +37,35 @@ const fromBody = { name: 'input', source: { kind: 'body' }, optional: false };
  * out. `delete` names none — a boolean is not a shape.
  */
 function crudOps(entity) {
+    const name = entity.name ?? 'Entity';
+    const input = inputParam(name);
     return {
-        list: { output: entity, cardinality: 'page', binding: [{ name: 'options', source: { kind: 'query' }, optional: true }] },
-        findById: { output: entity, cardinality: 'maybe', binding: [byId] },
-        create: { input: entity, output: entity, cardinality: 'one', binding: [fromBody] },
+        list: {
+            output: entity, cardinality: 'page',
+            binding: [{ name: 'options', source: { kind: 'query' }, optional: true }],
+            signature: {
+                name: 'list', returnType: returns(`ListResult<${name}>`, 'ListResult'),
+                params: [{ name: 'options', type: { raw: 'ListOptions', name: 'ListOptions' }, optional: true }],
+            },
+        },
+        findById: {
+            output: entity, cardinality: 'maybe', binding: [byId],
+            signature: { name: 'findById', returnType: returns(`${name} | undefined`, name, { nullable: true }), params: [idParam] },
+        },
+        create: {
+            input: entity, output: entity, cardinality: 'one', binding: [fromBody],
+            signature: { name: 'create', returnType: returns(name, name), params: [input] },
+        },
         // The patch view carries its own mode: an absent field is untouched, an
         // immutable one re-supplied is refused.
-        update: { input: entity.partial?.(), output: entity, cardinality: 'one', binding: [byId, fromBody] },
-        delete: { cardinality: 'none', binding: [byId] },
+        update: {
+            input: entity.partial?.(), output: entity, cardinality: 'one', binding: [byId, fromBody],
+            signature: { name: 'update', returnType: returns(name, name), params: [idParam, input] },
+        },
+        delete: {
+            cardinality: 'none', binding: [byId],
+            signature: { name: 'delete', returnType: returns('boolean', 'boolean'), params: [idParam] },
+        },
     };
 }
 /**

package/dist/prefab/crud.js.map

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

package/dist/prefab/mirror.d.ts

@@ -0,0 +1,52 @@
+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;
+ *     }
+ *   }
+ * }
+ * ```
+ */
+/** 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. */
+    written: number;
+    /** The age the pull was asked to start from — absent on the first ever run. */
+    since?: Date;
+    /** How long the whole pass took, pull included. */
+    ms: number;
+}
+export interface MirrorOf<T> {
+    /** The copy's own storage — where a page lands, and where its age is read. */
+    orm: EntityOrm<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. */
+    refresh(): Promise<Refreshed>;
+    /** When the freshest row here was written — `undefined` while the copy is empty. */
+    freshness(): Promise<Date | undefined>;
+}
+export interface MirrorConstructor<T> {
+    new (orm: EntityOrm<T>): MirrorOf<T>;
+    readonly __entity: unknown;
+}
+export declare function Mirror<E extends EntityConstructor>(shape: E): MirrorConstructor<InstanceType<E>>;
+/** The field whose lifecycle stamps every update. */
+export declare function ageFieldOf(shape: unknown): string | undefined;
+//# sourceMappingURL=mirror.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mirror.d.ts","sourceRoot":"","sources":["../../src/prefab/mirror.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,iBAAiB,EAAsC,MAAM,iBAAiB,CAAC;AACxH,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"}

package/dist/prefab/mirror.js

@@ -0,0 +1,66 @@
+import { Lifecycle, primaryFieldOf } 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);
+    if (declared === undefined) {
+        throw new Error(`Mirror(${shape.name ?? '?'}): the shape carries no \`updated()\` field — ` +
+            `a copy has to be able to say when it was pulled, and \`refresh\` reads its high-water mark from it.`);
+    }
+    const age = declared;
+    class MirrorBase {
+        orm;
+        static __entity = shape;
+        constructor(orm) {
+            this.orm = orm;
+        }
+        /** 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 value = newest?.[age];
+            return value instanceof Date ? value : undefined;
+        }
+        async refresh() {
+            const started = Date.now();
+            const since = await this.freshness();
+            let written = 0;
+            // Preserve the source's page boundaries: one page becomes one upsert.
+            for await (const page of this.pull(since)) {
+                if (page.length === 0)
+                    continue;
+                written += await this.orm.upsertAll(judgePage(shape, page));
+            }
+            return { written, since, ms: Date.now() - started };
+        }
+    }
+    return MirrorBase;
+}
+/** The field whose lifecycle stamps every update. */
+export function ageFieldOf(shape) {
+    const fields = shape.getFields?.();
+    if (!fields)
+        return undefined;
+    for (const [name, field] of Object.entries(fields)) {
+        if (Lifecycle.of(field).stampedOnUpdate)
+            return name;
+    }
+    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 ? primaryFieldOf(fields) : 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

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

package/dist/prefab/prefab.d.ts

@@ -0,0 +1,15 @@
+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.
+ */
+export declare function targetOf(ctor: unknown): EntityConstructor | undefined;
+/** The views a prefab declares, same rule. */
+export declare function viewsOf(ctor: unknown): PresenterViews | undefined;
+/** The handler-wide view a prefab declares, same rule. */
+export declare function outputOf(ctor: unknown): EntityConstructor | undefined;
+//# sourceMappingURL=prefab.d.ts.map

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

@@ -0,0 +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"}

package/dist/prefab/prefab.js

@@ -0,0 +1,19 @@
+/**
+ * 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.
+ */
+export function targetOf(ctor) {
+    return ctor?.__entity;
+}
+/** The views a prefab declares, same rule. */
+export function viewsOf(ctor) {
+    return ctor?.__views;
+}
+/** The handler-wide view a prefab declares, same rule. */
+export function outputOf(ctor) {
+    return ctor?.__output;
+}
+//# sourceMappingURL=prefab.js.map

package/dist/prefab/prefab.js.map

@@ -0,0 +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"}

package/dist/{presenter.d.ts → prefab/presenter.d.ts}

@@ -21,19 +21,17 @@
  * }
  * ```
  */
-type EntityClass = abstract new (...args: any[]) => any;
-declare const PRESENTER_TARGET: unique symbol;
-declare const PRESENTER_VIEWS: unique symbol;
+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, EntityClass | [EntityClass]>;
+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 `egress.ts`), and every surface reads the same statement
+ * 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
@@ -42,22 +40,13 @@ export type PresenterViews = Record<string, EntityClass | [EntityClass]>;
  * error on a field REST served whole. Declaring is optional — a scalar field needs nothing,
  * and an undeclared object keeps the old behaviour.
  */
-export declare function Presenter<E extends EntityClass>(entity: E, views?: PresenterViews): {
+export declare function Presenter<E extends EntityConstructor>(entity: E, views?: PresenterViews): {
     new (): {};
-    [PRESENTER_TARGET]: E;
-    [PRESENTER_VIEWS]: PresenterViews | undefined;
+    readonly __entity: E;
+    readonly __views: PresenterViews | undefined;
 };
-/** Get the entity class a presenter targets. */
-export declare function getPresenterTarget(ctor: Function): EntityClass | undefined;
-/**
- * The views a presenter declares, walked up the prototype chain so a subclass of a
- * presenter keeps what its base stated. Runtime, like `Crud.__ops`: an installed app whose
- * source the scan cannot read still carries its contract.
- */
-export declare function getPresenterViews(ctor: Function): PresenterViews | undefined;
 /** List computed field names from a presenter class (own methods minus constructor). */
 export declare function getPresenterFields(ctor: Function): string[];
 /** Container key of an entity's presenter — 'post' → 'PostPresenter'. */
 export declare function presenterKeyOf(entity: string): string;
-export {};
 //# sourceMappingURL=presenter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presenter.d.ts","sourceRoot":"","sources":["../../src/prefab/presenter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAe,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEtE;;;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"}

package/dist/{presenter.js → prefab/presenter.js}

@@ -21,13 +21,12 @@
  * }
  * ```
  */
-const PRESENTER_TARGET = Symbol.for('fougere:presenter_target');
-const PRESENTER_VIEWS = Symbol.for('fougere:presenter_views');
+import { classNameOf } 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 `egress.ts`), and every surface reads the same statement
+ * 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
@@ -38,28 +37,11 @@ const PRESENTER_VIEWS = Symbol.for('fougere:presenter_views');
  */
 export function Presenter(entity, views) {
     class PresenterBase {
-        static [PRESENTER_TARGET] = entity;
-        static [PRESENTER_VIEWS] = views;
+        static __entity = entity;
+        static __views = views;
     }
     return PresenterBase;
 }
-/** Get the entity class a presenter targets. */
-export function getPresenterTarget(ctor) {
-    return ctor[PRESENTER_TARGET];
-}
-/**
- * The views a presenter declares, walked up the prototype chain so a subclass of a
- * presenter keeps what its base stated. Runtime, like `Crud.__ops`: an installed app whose
- * source the scan cannot read still carries its contract.
- */
-export function getPresenterViews(ctor) {
-    for (let cur = ctor; cur; cur = Object.getPrototypeOf(cur)) {
-        const views = cur[PRESENTER_VIEWS];
-        if (views)
-            return views;
-    }
-    return undefined;
-}
 /** List computed field names from a presenter class (own methods minus constructor). */
 export function getPresenterFields(ctor) {
     return Object.getOwnPropertyNames(ctor.prototype)
@@ -67,6 +49,6 @@ export function getPresenterFields(ctor) {
 }
 /** Container key of an entity's presenter — 'post' → 'PostPresenter'. */
 export function presenterKeyOf(entity) {
-    return `${entity[0].toUpperCase()}${entity.slice(1)}Presenter`;
+    return `${classNameOf(entity)}Presenter`;
 }
 //# sourceMappingURL=presenter.js.map

package/dist/prefab/presenter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presenter.js","sourceRoot":"","sources":["../../src/prefab/presenter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,WAAW,EAA0B,MAAM,iBAAiB,CAAC;AAQtE;;;;;;;;;;;;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,WAAW,CAAC,MAAM,CAAC,WAAW,CAAC;AAC3C,CAAC"}

package/dist/prefab/repository.d.ts

@@ -0,0 +1,104 @@
+import { type EntityConstructor } from '@fougere/schema';
+import type { EntityOrm } from '../orm.js';
+/**
+ * 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. 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>;
+/** The single-entity form: the port, plus whatever the subclass names. */
+export interface RepositoryConstructor<T> {
+    new (orm: EntityOrm<T>): EntityOrm<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.
+ */
+declare abstract class AggregateShape<E extends readonly EntityConstructor[]> {
+    protected orms: {
+        [K in keyof E]: EntityOrm<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]>>;
+};
+export type AggregateConstructor<E extends readonly EntityConstructor[]> = (new (...orms: unknown[]) => AggregateShape<E>) & {
+    readonly __entity: unknown;
+    /** The entities this class owns. Present from two on — an owner of one owns nothing. */
+    readonly __owns: E;
+};
+export declare function Repository<E extends EntityConstructor>(entity: E): RepositoryConstructor<InstanceType<E>>;
+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.
+ */
+export declare function ownedBy(ctor: unknown): readonly EntityConstructor[];
+export {};
+//# sourceMappingURL=repository.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../src/prefab/repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACtE,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"}

package/dist/prefab/repository.js

@@ -0,0 +1,62 @@
+import { classNameOf } from '@fougere/schema';
+export function Repository(...entities) {
+    return entities.length === 1 ? one(entities[0]) : many(entities);
+}
+/**
+ * The port forwarded, member by member. Written out rather than proxied: a Proxy would
+ * answer every name including the ones the port does not have, and this file would then
+ * state the surface nowhere. Thirteen lines against one declaration that can be read.
+ */
+function one(entity) {
+    class RepositoryBase {
+        orm;
+        static __entity = entity;
+        constructor(orm) {
+            this.orm = orm;
+        }
+        list(options) { return this.orm.list(options); }
+        findById(id, options) { return this.orm.findById(id, options); }
+        findBy(criteria, options) { return this.orm.findBy(criteria, options); }
+        findAllBy(criteria, options) { return this.orm.findAllBy(criteria, options); }
+        findByKeys(ids, options) { return this.orm.findByKeys(ids, options); }
+        findAllByKeys(field, keys, options) { return this.orm.findAllByKeys(field, keys, options); }
+        create(input, options) { return this.orm.create(input, options); }
+        upsert(input, options) { return this.orm.upsert(input, options); }
+        upsertAll(inputs, options) { return this.orm.upsertAll(inputs, options); }
+        update(id, input, options) { return this.orm.update(id, input, options); }
+        delete(id) { return this.orm.delete(id); }
+        output(schema) { return this.orm.output(schema); }
+        get client() { return this.orm.client; }
+    }
+    return RepositoryBase;
+}
+/**
+ * The aggregate. Its constructor takes the members' storage in the DECLARED order — the
+ * order `toProvider` fills its `deps` with, and the order a subclass hands back to `super()`
+ * when it declares a constructor of its own.
+ */
+function many(entities) {
+    class AggregateBase {
+        static __entity = entities[0];
+        static __owns = entities;
+        orms;
+        constructor(...orms) {
+            this.orms = orms.slice(0, entities.length);
+        }
+    }
+    return AggregateBase;
+}
+/** Container key of an entity's repository — 'reading' → 'ReadingRepository'. */
+export function repositoryKeyOf(entity) {
+    return `${classNameOf(entity)}Repository`;
+}
+/**
+ * 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.
+ */
+export function ownedBy(ctor) {
+    return ctor?.__owns ?? [];
+}
+//# sourceMappingURL=repository.js.map

package/dist/prefab/repository.js.map

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

package/dist/scan/Fronds.d.ts

@@ -0,0 +1,45 @@
+import type { SchemaView } from '@fougere/schema';
+import type { EntityEntry, FrondDescriptor } from './frond.js';
+/**
+ * What this app hosts — the scan's answer, with the questions everyone was asking it
+ * by hand.
+ *
+ * The list was a bare array, so every reader re-walked it: "which frond owns this
+ * entity" was spelled four times, "every entity by name" three times as three literal
+ * copies of the same `Map`, and the two inside the boot even carried comments saying so.
+ * A concept nobody can question is a concept everyone rebuilds.
+ *
+ * It IS an array — the same reason `ListResult` is one: twenty call sites iterate,
+ * filter and spread it, and none of them is wrong to. `Symbol.species` is `Array` so a
+ * `.map()` over it answers a plain array rather than something that claims to be a
+ * hosting table and holds strings.
+ */
+export declare class Fronds extends Array<FrondDescriptor> {
+    static get [Symbol.species](): ArrayConstructor;
+    /** What one scan run found. The only gate in — `Array.of` is taken, and named. */
+    static scanned(fronds: readonly FrondDescriptor[]): Fronds;
+    /** The frond that hosts an entity — `undefined` when no loaded frond does. */
+    owner(entity: string): FrondDescriptor | undefined;
+    /** The entity of that name, wherever it was scanned. */
+    entity(name: string): EntityEntry | undefined;
+    /**
+     * Every scanned entity class, by name — across all fronds and never per-frond.
+     *
+     * A fact is announced in one frond and heard in another, so the subscriber's own
+     * frond does not hold the shape it must judge; a `reads:` clause names entities
+     * that belong to neighbours by definition.
+     */
+    schemas(): Map<string, SchemaView>;
+    /** Every scanned entity, sorted. What was FOUND, not what answers. */
+    entityNames(): string[];
+    /**
+     * The names a call may address, sorted — what a NOT_FOUND must print.
+     *
+     * Not `entityNames()`, which is what the scan found: an entity with no handler is
+     * scanned and serves nothing, so the refusal read *"Entity 'indexed' is not hosted
+     * here. Hosted here: indexed."* — naming the very thing it had just refused. A façade
+     * is keyed on a HANDLER's address, and that is what this lists.
+     */
+    servedNames(surface?: string): string[];
+}
+//# sourceMappingURL=Fronds.d.ts.map

package/dist/scan/Fronds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Fronds.d.ts","sourceRoot":"","sources":["../../src/scan/Fronds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE/D;;;;;;;;;;;;;GAaG;AACH,qBAAa,MAAO,SAAQ,KAAK,CAAC,eAAe,CAAC;IAChD,WAAoB,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,gBAAgB,CAEvD;IAED,kFAAkF;IAClF,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,GAAG,MAAM;IAM1D,8EAA8E;IAC9E,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIlD,wDAAwD;IACxD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAQ7C;;;;;;OAMG;IACH,OAAO,IAAI,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC;IAIlC,sEAAsE;IACtE,WAAW,IAAI,MAAM,EAAE;IAIvB;;;;;;;OAOG;IACH,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;CAKxC"}