@fougere/core 0.6.0-alpha.0 → 0.8.0-alpha.0

package/dist/source.js

@@ -0,0 +1,18 @@
+import { Registry, Role } from '@fougere/schema';
+/** Whether an entity asks for one, anywhere but on its key. */
+export function declares(schema, constraint) {
+    if (constraint !== 'unique')
+        return false;
+    if ((schema.getUnique() ?? []).length > 0)
+        return true;
+    return Object.values(schema.getFields()).some((field) => Role.of(field).isUnique);
+}
+/** Which adapter answers a source name — one per process, no subject to hold. */
+class SourceRegistry extends Registry {
+    /** The source this name stands for, built from the config entry that named it. */
+    open(name, conf, path) {
+        return this.resolve(name, path)(conf);
+    }
+}
+export const Sources = new SourceRegistry('source', 'import the adapter that answers it, or call Sources.register(name, build)');
+//# sourceMappingURL=source.js.map

package/dist/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../src/source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAmB,MAAM,iBAAiB,CAAC;AAMlE,+DAA+D;AAC/D,MAAM,UAAU,QAAQ,CAAC,MAAkB,EAAE,UAAsB;IACjE,IAAI,UAAU,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC1C,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAEvD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC;AACpF,CAAC;AAuCD,iFAAiF;AACjF,MAAM,cAAe,SAAQ,QAAwC;IACnE,kFAAkF;IAClF,IAAI,CAAC,IAAY,EAAE,IAAkB,EAAE,IAAa;QAClD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;CACF;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,cAAc,CACvC,QAAQ,EACR,2EAA2E,CAC5E,CAAC"}

package/dist/storage.d.ts

@@ -16,9 +16,8 @@ export interface ListOptions {
     /** If true, also returns total count (for pagination UIs). */
     count?: boolean;
     /**
-     * Equality criteria, field by field — `{ orderId: '…' }`. Named rather than spread
-     * across the options so an unknown key stays ignored instead of silently becoming a
-     * filter. `listBy(criteria)` is the same thing said as an intention.
+     * Equality criteria, field by field — `{ orderId: '…' }`. Named rather than spread across the
+     * options so an unknown key stays ignored instead of silently becoming a filter.
      */
     where?: Record<string, unknown>;
 }
@@ -42,83 +41,27 @@ export interface Storage<T = Record<string, unknown>> {
     list(options?: ListOptions & SelectOption): Promise<ListResult<T>>;
     findById(id: string, options?: SelectOption): Promise<T | undefined>;
     /**
-     * Read by criteria — `findBy({ email })` for the one, `findAllBy({ orderId })` for the
-     * many, which is what a one-to-many relation *is*.
-     *
-     * Both existed on the SQL implementation from the start and neither was declared here.
-     * A port that hides what it offers is a port nobody can use: `auth-better` cast its way
-     * in (`storage as StorageWithFindBy`), a presenter that needed the lines of an order read the
-     * whole table instead, and the GraphQL relation resolver passed criteria to `list()`
-     * — which drops what it does not know.
+     * Read by criteria — `findBy({ email })` for the one, `findAllBy({ orderId })` for the many,
+     * which is what a one-to-many relation *is*.
      */
     findBy(criteria: Partial<T> | Record<string, unknown>, options?: SelectOption): Promise<T | undefined>;
     findAllBy(criteria: Partial<T> | Record<string, unknown>, options?: SelectOption): Promise<T[]>;
     /**
-     * Read a SET of rows by their key, in one go — the gesture every other one was
-     * being bent into.
-     *
-     * `findAllBy` compares with `=`, so a list of ids could not be passed to it; the
-     * only way to read N rows was `list()` then filter in memory, which is what 14 of
-     * 14 handlers of a real app measured on 2026-08-14 were doing. It is invisible on
-     * SQLite and it is the whole table the day the rows are not local.
-     *
-     * It answers a MAP, because the caller holds keys and not positions: a page zips
-     * against it by `get(row.authorId)`, a miss is the absence of a key, and a repeated
-     * key is one entry. The list form this replaced promised that zip and could not
-     * keep it — dropping a miss shifts every later position — so each caller rebuilt
-     * the very index the implementation had just thrown away.
+     * Read a SET of rows by their key, in one go — the gesture every other one was being bent into.
      */
     findByKeys(ids: readonly string[], options?: SelectOption): Promise<Map<string, T>>;
-    /**
-     * Its dual: the rows that point AT each of these keys, grouped by the one they point at.
-     *
-     * `findByKeys` answers the side a row designates — one each, at most. This answers the
-     * side that designates the row — several each, and a key with none is simply absent.
-     * Together they are both directions of a relation, each in one query.
-     *
-     * Written because the page-shaped gesture only covered one of them: a presenter holding
-     * its page and wanting "the items of these lists" had no vocabulary for it and read the
-     * whole table instead, measured on a real app. `field` names the foreign key on THIS
-     * entity, the one carrying the value.
-     */
+    /** The dual of `findByKeys`: many rows per key, not one. */
     findAllByKeys(field: string, keys: readonly string[], options?: SelectOption): Promise<Map<string, T[]>>;
     create(input: Partial<T>, options?: SelectOption): Promise<T>;
-    /**
-     * Write the row, or make the existing one look like this — one statement.
-     *
-     * What an import needs and the port did not have: `create` throws on the second run,
-     * so re-reading a source meant deleting first. Measured pulling an API twice.
-     *
-     * The key and the creation stamps survive an overwrite — a row keeps the moment it
-     * appeared. An engine with no upsert clause refuses by name rather than emulating
-     * one with a read in front, which would promise an atomicity it has not got.
-     */
+    /** Write the row, or make the existing one look like this — one statement. */
     upsert(input: Partial<T>, options?: SelectOption): Promise<T>;
-    /**
-     * A whole page in one statement — what an import writes through.
-     *
-     * Row by row, 500 rows were 500 statements (measured); the shape of an import is a
-     * page, so the write is one too. Answers how many rows were written rather than the
-     * rows: `create` hands back the complete row because a caller acts on it, and an
-     * import acts on none of them — re-reading a page for a symmetry nobody uses would
-     * double the work.
-     */
+    /** A whole page in one statement — what an import writes through. */
     upsertAll(inputs: readonly Partial<T>[], options?: SelectOption): Promise<number>;
     update(id: string, input: Partial<T>, options?: SelectOption): Promise<T>;
     delete(id: string): Promise<boolean>;
     /** Returns a scoped storage that restricts all read results to the fields of the given schema. */
     output(schema: SchemaView): Storage<T>;
-    /**
-     * What this storage wraps — the Kysely instance for the SQL one, something else elsewhere.
-     *
-     * Every judge sits on the storage's own methods, so a statement issued here meets none of
-     * them: a value the entity refuses lands in the table without a word. It is the port's
-     * own escape hatch rather than a handle on the side, so it keeps the scope the container
-     * gave you — `productStorage.client` reaches the products, not the whole database.
-     *
-     * `unknown` on purpose: the client belongs to the implementation, and narrowing it is
-     * the caller saying out loud which one they are standing on.
-     */
+    /** What this storage wraps — the Kysely instance for the SQL one, something else elsewhere. */
     readonly client: unknown;
 }
 /**
@@ -126,139 +69,11 @@ export interface Storage<T = Record<string, unknown>> {
  * Called by bootstrap for every scanned entity.
  */
 export type StorageFactory = (entity: SchemaView, name: string) => Storage;
-/**
- * A place rows live, whatever realizes it.
- *
- * `StorageFactory` plus its lifecycle, which is why it lives beside it. Three of the four
- * gestures are optional and ABSENCE IS THE ANSWER: no `transacted` and a frame compensates
- * instead of transacting (`boot/together.ts`), no `migrate` and there is no shape to bring
- * up to date. What a source is MADE OF is not here — `adapter/sql` states `dialect`, `db`
- * and `sink` on its own `SqlSource`, reached by narrowing, the rule {@link Storage.client}
- * already obeys one level down.
- */
-export interface Source {
-    storageFactory: StorageFactory;
-    /** Bring the shape of what lives here up to date. */
-    migrate?(view: SourceView): Promise<void>;
-    /** Run `fn` as ONE unit of work, with a factory bound to it. */
-    transacted?<R>(fn: (factory: StorageFactory) => Promise<R>): Promise<R>;
-    close?(): Promise<void>;
-    /** What distinguishes it when a query is reported. */
-    name?: string;
-}
-/**
- * The app as ONE source sees it: what lives there, and the NAMES of what does not.
- *
- * The second half is what lets a DDL stop lying. A batch holding every entity cannot tell
- * a cross-source target from a typo, so a `ref()` falls back to a derived table name and
- * the constraint is emitted against a table that may not exist. `elsewhere` says which
- * misses are legitimate — and a target in neither list is a mistake, out loud.
- */
-export interface SourceView {
-    fronds: readonly {
-        readonly name: string;
-        readonly entities: readonly {
-            readonly name: string;
-        }[];
-    }[];
-    /** The auth provider's own entities, when they ride with this source. */
-    auth?: unknown;
-    elsewhere: readonly string[];
-}
-/**
- * What a config file can carry about a source — values, never a live driver.
- *
- * `source` names the ADAPTER, and everything else belongs to the adapter it named:
- * `adapter/sql` reads `dialect`, a file one reads `path`. That is the shape
- * `EntityAdapters` already has — addressed by adapter, and what sits below is the
- * adapter's own. Which is why the level `schema` owns is not repeated here.
- */
-export interface SourceConfig {
-    /** The adapter that realizes it. Absent means the conventional one. */
-    source?: string;
-    /** The entities whose rows live here. Absent on the default source: it holds the rest. */
-    entities?: string[];
-    [key: string]: unknown;
-}
-/**
- * Which adapter answers a source name — one per process, no subject to hold.
- *
- * The shape `Generators` already has, and the refusal `resolveStorage` already made: only
- * `sqlite` could be resolved from its name, because it was the one driver `defaults`
- * depended on. That refusal had no owner — it lived in the package that happened to import
- * the driver — so a second adapter had nowhere to say it exists. Here it does, and an
- * unknown name is refused naming what this process answers.
- *
- * Registered at IMPORT by each adapter, so nothing central lists them.
- */
-export declare class Sources {
-    private static readonly registry;
-    static register(name: string, build: (conf: SourceConfig) => Source): void;
-    /** The source this name stands for, refused by name when nothing does. */
-    static resolve(name: string, conf: SourceConfig): Source;
-    /** Whether a name is answered, for a caller that must not throw to find out. */
-    static answers(name: string): boolean;
-    /** What this process answers — what a refusal elsewhere prints. */
-    static answered(): string[];
-}
-/**
- * Container key of an entity's storage — 'reading' → 'ReadingStorage'.
- *
- * The twin of {@link repositoryKeyOf} and of `facadeKeyOf`: the key of a thing
- * lives with the thing. This one was spelled by hand in four places in
- * `bootstrap.ts` and a fifth in `scanner.ts` — where the SCAN derives what a
- * constructor asks for. Two readers of one convention, neither of them naming it,
- * so a rename would have moved one and left the other resolving to nothing.
- */
+/** Container key of an entity's storage — 'reading' → 'ReadingStorage'. */
 export declare function storageKeyOf(entity: string): string;
-/**
- * The entity behind a storage key, or `undefined` when the key is not one.
- *
- * The dual of the line above, for the reason `membersOfTogetherKey` is. `known` is what the
- * suffix alone cannot answer: `FileStorage` is an ordinary class name.
- */
+/** The entity behind a storage key, or `undefined` when the key is not one. */
 export declare function entityOfStorageKey(key: string, known: (entity: string) => boolean): string | undefined;
-/**
- * `Together<[Account, Ledger]>` — writes that stand or fall as one.
- *
- * `Storage` is the port whose every gesture is ONE statement, and one statement is
- * atomic in every engine. This is the port whose unit is a BLOCK: what the callback did
- * happens entirely, or not at all. Nothing else separates them — the arity of the unit
- * of work is the whole distinction, which is why this lives here and not in a file of
- * its own.
- *
- * ```ts
- * constructor(private together: Together<[Account, Ledger]>) {}
- *
- * await this.together.run(async ([accounts, ledger]) => {
- *   await accounts.update(from, { balance: b - amount });
- *   await ledger.create({ from, to, amount });
- * });
- * ```
- *
- * **The second list is providers**, rebuilt inside the frame so that what THEY write is
- * covered too — a `Mirror` writes its pages through `Storage<T>`, so naming it puts
- * them under the same unwind, with no locator and no second injection path:
- *
- * ```ts
- * constructor(private together: Together<[RateCard, Ledger], [RateMirror]>) {}
- *
- * await this.together.run(async ([rates, ledger], [mirror]) => { await mirror.refresh(); });
- * ```
- *
- * Two lists rather than one, because in a signature an entity and a provider are both
- * written as a class name and their instance types do not separate them — the type would
- * have to guess, by looking for methods or for a brand, and both answers are worse than
- * saying it. They are two different facts anyway: what the unwind covers, and what is
- * rebuilt to make that true.
- *
- * **All or nothing is the promise; isolation is not.** On one engine the members are
- * rebuilt over a transaction and the engine gives both. Across engines a transaction
- * cannot exist, so the frame keeps the before-image of each write and replays the
- * inverse in reverse order — the unwind holds, the isolation does not, and a reader
- * between two writes sees the half. The boot says which of the two it built rather
- * than letting the author assume the stronger one.
- */
+/** `Together<[Account, Ledger]>` — writes that stand or fall as one. */
 export interface Together<E extends readonly unknown[], P extends readonly unknown[] = []> {
     run<R>(fn: (entities: {
         [K in keyof E]: Storage<E[K]>;
@@ -267,21 +82,9 @@ export interface Together<E extends readonly unknown[], P extends readonly unkno
 /**
  * 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 declare function togetherKeyOf(entities: readonly string[], providers?: readonly string[]): string;
-/**
- * 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.
- */
+/** The members behind a frame key, or `undefined` when the key is not one. */
 export declare function membersOfTogetherKey(key: string): {
     entities: string[];
     providers: string[];

package/dist/storage.d.ts.map

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

package/dist/storage.js

@@ -1,10 +1,5 @@
 import { upperFirst, lowerFirst } 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.
- */
+/** The keys `list()` answers to. */
 const LIST_OPTION_KEYS = [
     'limit', 'offset', 'page', 'after', 'orderBy', 'order', 'count', 'where', 'select',
 ];
@@ -19,58 +14,11 @@ export function assertListOptions(options, entity) {
     throw new Error(`${entity}.list(): unknown option ${strangers.map((s) => `\`${s}\``).join(', ')}. ` +
         `Known options are ${LIST_OPTION_KEYS.join(', ')} — to filter, pass \`where: { ${strangers[0]}: … }\`.`);
 }
-/**
- * Which adapter answers a source name — one per process, no subject to hold.
- *
- * The shape `Generators` already has, and the refusal `resolveStorage` already made: only
- * `sqlite` could be resolved from its name, because it was the one driver `defaults`
- * depended on. That refusal had no owner — it lived in the package that happened to import
- * the driver — so a second adapter had nowhere to say it exists. Here it does, and an
- * unknown name is refused naming what this process answers.
- *
- * Registered at IMPORT by each adapter, so nothing central lists them.
- */
-export class Sources {
-    static registry = new Map();
-    static register(name, build) {
-        this.registry.set(name, build);
-    }
-    /** The source this name stands for, refused by name when nothing does. */
-    static resolve(name, conf) {
-        const build = this.registry.get(name);
-        if (build)
-            return build(conf);
-        throw new Error(`Unknown source '${name}' — import the adapter that answers it, or register one with `
-            + `Sources.register('${name}', build). This process answers `
-            + `${[...this.registry.keys()].join(', ') || 'nothing yet'}.`);
-    }
-    /** Whether a name is answered, for a caller that must not throw to find out. */
-    static answers(name) {
-        return this.registry.has(name);
-    }
-    /** What this process answers — what a refusal elsewhere prints. */
-    static answered() {
-        return [...this.registry.keys()];
-    }
-}
-/**
- * Container key of an entity's storage — 'reading' → 'ReadingStorage'.
- *
- * The twin of {@link repositoryKeyOf} and of `facadeKeyOf`: the key of a thing
- * lives with the thing. This one was spelled by hand in four places in
- * `bootstrap.ts` and a fifth in `scanner.ts` — where the SCAN derives what a
- * constructor asks for. Two readers of one convention, neither of them naming it,
- * so a rename would have moved one and left the other resolving to nothing.
- */
+/** Container key of an entity's storage — 'reading' → 'ReadingStorage'. */
 export function storageKeyOf(entity) {
     return `${upperFirst(entity)}${HELD}`;
 }
-/**
- * The entity behind a storage key, or `undefined` when the key is not one.
- *
- * The dual of the line above, for the reason `membersOfTogetherKey` is. `known` is what the
- * suffix alone cannot answer: `FileStorage` is an ordinary class name.
- */
+/** The entity behind a storage key, or `undefined` when the key is not one. */
 export function entityOfStorageKey(key, known) {
     if (key.length <= HELD.length || !key.endsWith(HELD))
         return undefined;
@@ -82,12 +30,6 @@ const HELD = 'Storage';
 /**
  * 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(upperFirst).join(SEPARATOR);
@@ -97,13 +39,7 @@ 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.
- */
+/** The members behind a frame key, or `undefined` when the key is not one. */
 export function membersOfTogetherKey(key) {
     if (key.length <= FRAME.length || !key.endsWith(FRAME))
         return undefined;

package/dist/storage.js.map

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

package/dist/store.d.ts

@@ -0,0 +1,18 @@
+/** The thirteen gestures of {@link Storage}, derived from four. */
+import { type SchemaView } from '@fougere/schema';
+import type { StorageFactory } from './storage.js';
+/** One instance, as every realization hands it over. */
+export type Values = Record<string, unknown>;
+/** Instances addressed by key — what an adapter supplies, and all of it. */
+export interface Store {
+    get(key: string): Promise<Values | undefined>;
+    has(key: string): Promise<boolean>;
+    set(key: string, values: Values): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    /** Everything it holds. A realization that cannot answer this cheaply says so in its doc. */
+    all(): Promise<Values[]>;
+    /** Handed on as `Storage.client` — the Map, the directory, whatever it is. */
+    readonly client: unknown;
+}
+export declare function storageOver(open: (entity: SchemaView, name: string) => Store): StorageFactory;
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,OAAO,EAA6C,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7F,OAAO,KAAK,EAAW,cAAc,EAAE,MAAM,cAAc,CAAC;AAE5D,wDAAwD;AACxD,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE7C,4EAA4E;AAC5E,MAAM,WAAW,KAAK;IACpB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC9C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,6FAA6F;IAC7F,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACzB,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,KAAK,KAAK,GAAG,cAAc,CA0I7F"}

package/dist/store.js

@@ -0,0 +1,179 @@
+/** The thirteen gestures of {@link Storage}, derived from four. */
+import { applyCreate, applyUpdate, Lifecycle, Role } from '@fougere/schema';
+import { comparisonOf, comparisonsIn } from './criterion.js';
+export function storageOver(open) {
+    return (entity, name) => {
+        const fields = entity.getFields();
+        const store = open(entity, name);
+        const pk = Object.entries(fields).find(([, field]) => Role.of(field).isPrimary)?.[0] ?? 'id';
+        // `Storage.findById(id: string)` — but a key can hold a number, and a Map keyed on
+        // `1` does not answer `'1'`. SQL never had the question; here the divergence was
+        // silent and only on this storage.
+        const keyOf = (value) => String(value);
+        // Same contract as SQL: a criterion may name a SET, and an empty set matches nothing.
+        // A comparison is told from a value by the FIELD, never by the criterion's own shape.
+        const matches = (values, criteria) => Object.entries(criteria).every(([key, value]) => {
+            const comparison = comparisonOf(fields[key], value);
+            if (comparison)
+                return compares(values[key], comparison);
+            return Array.isArray(value)
+                ? value.some((v) => Object.is(values[key], v))
+                : Object.is(values[key], value);
+        });
+        // A store holds whole instances and reads them whole, so the scope SQL puts in its
+        // SELECT is applied here on the way out. Same set of gestures either way: everything
+        // that hands back an instance, which leaves `delete` and `upsertAll` alone.
+        const scoped = (selected) => {
+            const pick = (values) => (selected
+                ? Object.fromEntries(Object.entries(values).filter(([key]) => selected.has(key)))
+                : values);
+            return {
+                client: store.client,
+                async list(options) {
+                    let items = await store.all();
+                    if (options?.where)
+                        items = items.filter((values) => matches(values, options.where));
+                    // Held before the page is cut, and after the filter: `total` answers "how many
+                    // match", which is what a paginator divides. Reading `store.size` at the end
+                    // answered a different question — everything the store holds, including the ones
+                    // the filter exists to keep out of this caller's sight.
+                    const matching = items.length;
+                    const limit = options?.limit;
+                    const offset = options?.page && limit ? (options.page - 1) * limit : options?.offset ?? 0;
+                    if (offset > 0)
+                        items = items.slice(offset);
+                    const hasMore = limit ? items.length > limit : false;
+                    if (limit)
+                        items = items.slice(0, limit);
+                    // The cursor is read before the scope cuts: a view that drops the key still
+                    // pages, the way it does over SQL.
+                    const endCursor = items.length > 0 ? String(items[items.length - 1][pk] ?? '') : undefined;
+                    const result = items.map(pick);
+                    result.hasMore = hasMore;
+                    result.endCursor = endCursor;
+                    if (options?.count)
+                        result.total = matching;
+                    return result;
+                },
+                async findById(id) {
+                    const values = await store.get(keyOf(id));
+                    return values && pick(values);
+                },
+                async findBy(criteria) {
+                    const values = (await store.all()).find((held) => matches(held, criteria));
+                    return values && pick(values);
+                },
+                async findAllBy(criteria) {
+                    return (await store.all()).filter((values) => matches(values, criteria)).map(pick);
+                },
+                // Same contract as SQL: a map keyed by the primary key, a miss being an absent key.
+                async findByKeys(ids) {
+                    const found = new Map();
+                    for (const id of ids) {
+                        const values = await store.get(keyOf(id));
+                        if (values)
+                            found.set(String(id), pick(values));
+                    }
+                    return found;
+                },
+                // The dual, same contract as SQL: grouped by the value read off the instance.
+                async findAllByKeys(field, keys) {
+                    const grouped = new Map();
+                    if (keys.length === 0)
+                        return grouped;
+                    const wanted = new Set(keys.map(String));
+                    for (const values of await store.all()) {
+                        const key = String(values[field]);
+                        if (!wanted.has(key))
+                            continue;
+                        const bucket = grouped.get(key);
+                        if (bucket)
+                            bucket.push(pick(values));
+                        else
+                            grouped.set(key, [pick(values)]);
+                    }
+                    return grouped;
+                },
+                // Same contract as SQL: the key and the creation stamps survive an overwrite.
+                async upsert(input) {
+                    const values = applyCreate(fields, applyUpdate(fields, input));
+                    const id = values[pk];
+                    if (id === undefined)
+                        throw new Error(`${name}.upsert(): no \`${pk}\` — an upsert needs the key it writes at.`);
+                    const previous = await store.get(keyOf(id));
+                    if (previous) {
+                        for (const [key, field] of Object.entries(fields)) {
+                            if (key === pk || Lifecycle.of(field).stampedOnce)
+                                values[key] = previous[key];
+                        }
+                    }
+                    await store.set(keyOf(id), values);
+                    return pick(values);
+                },
+                async upsertAll(inputs) {
+                    for (const input of inputs)
+                        await this.upsert(input);
+                    return inputs.length;
+                },
+                async create(input) {
+                    const values = applyCreate(fields, input);
+                    const id = values[pk];
+                    // `primary(text())` declares no generator, so nothing fills the hole and the
+                    // caller has to. Keying on `undefined` would let the second create overwrite the
+                    // first, in silence — the old version hid this by inventing an `id` field the
+                    // entity never declared.
+                    if (id === undefined) {
+                        throw new Error(`${name}.create: '${pk}' is the primary key and nothing supplied it — this entity declares no generator for it.`);
+                    }
+                    // A create is not an upsert. `Map.set` overwrites, so a second create under the
+                    // same key answered "created" while destroying the previous instance — SQL answers a
+                    // constraint violation, and a store that loses data silently is worse than one
+                    // that fails.
+                    if (await store.has(keyOf(id))) {
+                        throw new Error(`${name}.create: '${pk}' ${JSON.stringify(id)} already exists.`);
+                    }
+                    await store.set(keyOf(id), values);
+                    return pick(values);
+                },
+                async update(id, input) {
+                    const existing = await store.get(keyOf(id));
+                    if (!existing)
+                        throw new Error(`Not found: ${id}`);
+                    const updated = { ...existing, ...applyUpdate(fields, input), [pk]: existing[pk] };
+                    await store.set(keyOf(id), updated);
+                    return pick(updated);
+                },
+                async delete(id) { return await store.delete(keyOf(id)); },
+                output(schema) { return scoped(new Set(Object.keys(schema.getFields()))); },
+            };
+        };
+        return scoped();
+    };
+}
+/**
+ * The same comparisons SQL compiles, answered in memory. Every one a criterion names has
+ * to hold — the rule two criteria already follow.
+ */
+function compares(held, comparison) {
+    return comparisonsIn(comparison).every(([name, asked]) => {
+        switch (name) {
+            case 'gte': return ordered(held, asked, (a, b) => a >= b);
+            case 'lte': return ordered(held, asked, (a, b) => a <= b);
+            case 'gt': return ordered(held, asked, (a, b) => a > b);
+            case 'lt': return ordered(held, asked, (a, b) => a < b);
+            case 'ne': return !Object.is(held, asked);
+            case 'contains': return String(held ?? '').includes(String(asked));
+            case 'notIn': return !asked.some((one) => Object.is(held, one));
+            case 'isNull': return (held === null || held === undefined) === Boolean(asked);
+            case 'between': {
+                const [low, high] = asked;
+                return ordered(held, low, (a, b) => a >= b) && ordered(held, high, (a, b) => a <= b);
+            }
+        }
+    });
+}
+/** A row that holds nothing compares to nothing — the answer SQL gives for NULL. */
+const ordered = (held, asked, holds) => held === null || held === undefined ? false : holds(order(held), order(asked));
+/** What a Date and a number have in common, and a string keeps for itself. */
+const order = (value) => value instanceof Date ? value.getTime() : value;
+//# sourceMappingURL=store.js.map