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

package/dist/orm.js

@@ -1,10 +1,11 @@
+import { classNameOf } from '@fougere/schema';
 /**
  * The keys `list()` answers to. Anything else is a mistake, and saying so is the point:
  * the façade refuses an unknown key in a CLIENT's input (`Unknown field`) — this applies the
  * same rule to the framework's own arguments. `list({ orderId })` used to be accepted and
  * the filter dropped, so a one-to-many relation quietly returned the whole table.
  */
-export const LIST_OPTION_KEYS = [
+const LIST_OPTION_KEYS = [
     'limit', 'offset', 'page', 'after', 'orderBy', 'order', 'count', 'where', 'select',
 ];
 /** Refuse an option the port does not answer to, naming it and what was expected. */
@@ -28,6 +29,38 @@ export function assertListOptions(options, entity) {
  * so a rename would have moved one and left the other resolving to nothing.
  */
 export function ormKeyOf(entity) {
-    return `${entity[0].toUpperCase()}${entity.slice(1)}Orm`;
+    return `${classNameOf(entity)}Orm`;
+}
+/**
+ * The container key of a frame — `[['Account', 'Ledger'], ['RateMirror']]` →
+ * 'Account+Ledger|RateMirrorTogether'.
+ *
+ * The DECLARED order, not a sorted one. The tuples are what the callback destructures, so
+ * reordering here would hand `[ledger, accounts]` to a signature that says the opposite —
+ * the type and the runtime disagreeing about the same line. Two orders of one frame are
+ * therefore two keys and two registrations; they cost nothing, a frame holding no state
+ * between runs.
+ */
+export function togetherKeyOf(entities, providers = []) {
+    const named = entities.map(classNameOf).join(SEPARATOR);
+    return `${named}${providers.length ? KINDS + providers.map(classNameOf).join(SEPARATOR) : ''}${FRAME}`;
+}
+const FRAME = 'Together';
+const SEPARATOR = '+';
+/** Separates the two lists — what the unwind covers, and what is rebuilt to make it true. */
+const KINDS = '|';
+/**
+ * The members behind a frame key, or `undefined` when the key is not one.
+ *
+ * The dual of the line above, and here for the reason `factOfEmitKey` is: the boot reads
+ * the key back out of a handler's `deps` to know which frames to build. A key and the way
+ * to undo it belong together — the pair that is split is the pair that drifts.
+ */
+export function membersOfTogetherKey(key) {
+    if (key.length <= FRAME.length || !key.endsWith(FRAME))
+        return undefined;
+    const [entities, providers = ''] = key.slice(0, -FRAME.length).split(KINDS);
+    const split = (list) => list.split(SEPARATOR).filter(Boolean);
+    return { entities: split(entities), providers: split(providers) };
 }
 //# sourceMappingURL=orm.js.map

package/dist/orm.js.map

@@ -1 +1 @@
-{"version":3,"file":"orm.js","sourceRoot":"","sources":["../src/orm.ts"],"names":[],"mappings":"AA2CA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ;CAC1E,CAAC;AAEX,qFAAqF;AACrF,MAAM,UAAU,iBAAiB,CAAC,OAA2B,EAAE,MAAc;IAC3E,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,MAAM,KAAK,GAAG,IAAI,GAAG,CAAS,gBAAgB,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACxE,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IACnC,MAAM,IAAI,KAAK,CACb,GAAG,MAAM,2BAA2B,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;QACnF,qBAAqB,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,iCAAiC,SAAS,CAAC,CAAC,CAAC,UAAU,CACxG,CAAC;AACJ,CAAC;AAgDD;;;;;;;;GAQG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAc;IACrC,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;AAC3D,CAAC"}
+{"version":3,"file":"orm.js","sourceRoot":"","sources":["../src/orm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAmB,MAAM,iBAAiB,CAAC;AA2C/D;;;;;GAKG;AACH,MAAM,gBAAgB,GAAG;IACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ;CAC1E,CAAC;AAEX,qFAAqF;AACrF,MAAM,UAAU,iBAAiB,CAAC,OAA2B,EAAE,MAAc;IAC3E,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,MAAM,KAAK,GAAG,IAAI,GAAG,CAAS,gBAAgB,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACxE,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IACnC,MAAM,IAAI,KAAK,CACb,GAAG,MAAM,2BAA2B,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;QACnF,qBAAqB,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,iCAAiC,SAAS,CAAC,CAAC,CAAC,UAAU,CACxG,CAAC;AACJ,CAAC;AAkGD;;;;;;;;GAQG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAc;IACrC,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC;AACrC,CAAC;AA+CD;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,QAA2B,EAAE,YAA+B,EAAE;IAC1F,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxD,OAAO,GAAG,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC;AACzG,CAAC;AAED,MAAM,KAAK,GAAG,UAAU,CAAC;AACzB,MAAM,SAAS,GAAG,GAAG,CAAC;AACtB,6FAA6F;AAC7F,MAAM,KAAK,GAAG,GAAG,CAAC;AAElB;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,IAAI,GAAG,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACzE,MAAM,CAAC,QAAQ,EAAE,SAAS,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC5E,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACtE,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAS,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;AACrE,CAAC"}

package/dist/prefab/collector.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Collector(Type) — resolves one handler input parameter from the invocation context.
+ *
+ * The target is a NAME matched against the parameter's type, never a schema: nothing
+ * here nor in the scan reads its fields. So `Ability`, built per call from state, sits
+ * beside `User`, loaded from a row.
+ *
+ * The dual of Presenter only in direction. A presenter's subject is a ROW — it adds
+ * computed fields to one, so its target must be an entity. A collector's subject is a
+ * PARAMETER.
+ *
+ * Usage:
+ * ```ts
+ * export default class UserCollector extends Collector(User) {
+ *   constructor(private userOrm: UserOrm) { super(); }
+ *
+ *   async collect(ctx: InvocationContext) {
+ *     return this.userOrm.findById(ctx.state.userId as string);
+ *   }
+ * }
+ * ```
+ */
+export declare function Collector<T extends abstract new (...args: any[]) => any>(target: T): {
+    new (): {};
+    readonly __entity: T;
+};
+/** Container key of a collector — 'user' → 'UserCollector', 'ability' → 'AbilityCollector'. */
+export declare function collectorKeyOf(type: string): string;
+//# sourceMappingURL=collector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../../src/prefab/collector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,wBAAgB,SAAS,CAAC,CAAC,SAAS,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,MAAM,EAAE,CAAC;;;EAKlF;AAED,+FAA+F;AAC/F,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/prefab/collector.js

@@ -0,0 +1,34 @@
+/**
+ * Collector(Type) — resolves one handler input parameter from the invocation context.
+ *
+ * The target is a NAME matched against the parameter's type, never a schema: nothing
+ * here nor in the scan reads its fields. So `Ability`, built per call from state, sits
+ * beside `User`, loaded from a row.
+ *
+ * The dual of Presenter only in direction. A presenter's subject is a ROW — it adds
+ * computed fields to one, so its target must be an entity. A collector's subject is a
+ * PARAMETER.
+ *
+ * Usage:
+ * ```ts
+ * export default class UserCollector extends Collector(User) {
+ *   constructor(private userOrm: UserOrm) { super(); }
+ *
+ *   async collect(ctx: InvocationContext) {
+ *     return this.userOrm.findById(ctx.state.userId as string);
+ *   }
+ * }
+ * ```
+ */
+import { classNameOf } from '@fougere/schema';
+export function Collector(target) {
+    class CollectorBase {
+        static __entity = target;
+    }
+    return CollectorBase;
+}
+/** Container key of a collector — 'user' → 'UserCollector', 'ability' → 'AbilityCollector'. */
+export function collectorKeyOf(type) {
+    return `${classNameOf(type)}Collector`;
+}
+//# sourceMappingURL=collector.js.map

package/dist/prefab/collector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collector.js","sourceRoot":"","sources":["../../src/prefab/collector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,MAAM,UAAU,SAAS,CAAiD,MAAS;IACjF,MAAM,aAAa;QACjB,MAAM,CAAU,QAAQ,GAAG,MAAM,CAAC;;IAEpC,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC;AACzC,CAAC"}

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":"AAAA,OAAO,EAAE,SAAS,EAAE,cAAc,EAA8D,MAAM,iBAAiB,CAAC;AAoDxH,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,GAAiB;YAAjB,QAAG,GAAH,GAAG,CAAc;QAAG,CAAC;QAIxC,8EAA8E;QAC9E,KAAK,CAAC,SAAS;YACb,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;YAChF,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,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,CAAiB,CAAC,CAAC;YAC9E,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;AAED,sFAAsF;AACtF,SAAS,SAAS,CAAI,KAAc,EAAE,IAAkB;IACtD,MAAM,KAAK,GAAI,KAAsE,CAAC,QAAQ,CAAC;IAC/F,IAAI,OAAO,KAAK,KAAK,UAAU;QAAE,OAAO,IAAiC,CAAC;IAE1E,MAAM,IAAI,GAAI,KAA2B,CAAC,IAAI,IAAI,QAAQ,CAAC;IAC3D,MAAM,MAAM,GAAI,KAAsC,CAAC,SAAS,EAAE,EAAE,CAAC;IACrE,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAC7B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACvC,IAAI,OAAO,CAAC,OAAO;YAAE,OAAO,OAAO,CAAC,IAA+B,CAAC;QACpE,MAAM,GAAG,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,GAA+B,CAAC,OAAO,CAAC,CAAC;QAC1F,MAAM,KAAK,GAAG,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,eAAe,CAAC;QACxG,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5E,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,mBAAmB,KAAK,MAAM,GAAG,EAAE,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;AACL,CAAC"}

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"}