@fougere/adapter-sql 0.2.0-alpha.2

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export { createTableSQL, createIndexSQL, indexSQL, addForeignKeyConstraintSQL, generateSQL, autoMigrate, compiler } from './ddl.js';
+export type { GenerateOptions, SqlSink } from './ddl.js';
+export { toTable, toTables, toTableName, toSnakeCase, isKeyed, orderTables } from './table.js';
+export type { TableDef, ColumnDef, ColumnShape, ColumnReference, RelationResolve, FkEdge, TableOrder, EntityEntry, FrondLike, AppLike, } from './table.js';
+export { dialects, resolveDialect, sqliteDialect, pgDialect, mysqlDialect, mssqlDialect, } from './dialect.js';
+export type { Dialect, DialectName } from './dialect.js';
+export { SqlEntityOrm, createOrmFactory } from './crud.js';
+export type { OrmFactoryOptions } from './crud.js';
+export { codecFor, codecsOf } from './values.js';
+export type { ValueCodec } from './values.js';
+export { setupSqlite, setupKysely, sqlSink } from './setup.js';
+export type { Setup, SetupOptions, SqliteSetup, SqliteSetupOptions } from './setup.js';
+export { actualState, desiredTables, delta, orderChanges, changeSQL, planMigration, migrate } from './diff.js';
+export type { SchemaState, Change } from './diff.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,QAAQ,EAAE,0BAA0B,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpI,YAAY,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC/F,YAAY,EACV,QAAQ,EACR,SAAS,EACT,WAAW,EACX,eAAe,EACf,eAAe,EACf,MAAM,EACN,UAAU,EACV,WAAW,EACX,SAAS,EACT,OAAO,GACR,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,QAAQ,EACR,cAAc,EACd,aAAa,EACb,SAAS,EACT,YAAY,EACZ,YAAY,GACb,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC3D,YAAY,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACjD,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC/D,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACvF,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC/G,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { createTableSQL, createIndexSQL, indexSQL, addForeignKeyConstraintSQL, generateSQL, autoMigrate, compiler } from './ddl.js';
+export { toTable, toTables, toTableName, toSnakeCase, isKeyed, orderTables } from './table.js';
+export { dialects, resolveDialect, sqliteDialect, pgDialect, mysqlDialect, mssqlDialect, } from './dialect.js';
+export { SqlEntityOrm, createOrmFactory } from './crud.js';
+export { codecFor, codecsOf } from './values.js';
+export { setupSqlite, setupKysely, sqlSink } from './setup.js';
+export { actualState, desiredTables, delta, orderChanges, changeSQL, planMigration, migrate } from './diff.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,QAAQ,EAAE,0BAA0B,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEpI,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAa/F,OAAO,EACL,QAAQ,EACR,cAAc,EACd,aAAa,EACb,SAAS,EACT,YAAY,EACZ,YAAY,GACb,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE3D,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE/D,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC"}

package/dist/setup.d.ts

@@ -0,0 +1,37 @@
+import { Kysely, type Dialect as KyselyDialect } from 'kysely';
+import Database from 'better-sqlite3';
+import { createOrmFactory, type OrmFactoryOptions } from './crud.js';
+import type { DialectName } from './dialect.js';
+import type { SqlSink } from './ddl.js';
+export interface SetupOptions {
+    /** Override naming for specific entities (e.g. better-auth wants singular table names). */
+    ormFactoryOptions?: OrmFactoryOptions;
+}
+export interface SqliteSetupOptions extends SetupOptions {
+    /** Filesystem path to the database. Defaults to a project-local file. */
+    path?: string;
+}
+export interface Setup {
+    dialect: DialectName;
+    ormFactory: ReturnType<typeof createOrmFactory>;
+    /** Runs raw statements — what `autoMigrate` writes through. */
+    sink: SqlSink;
+    /**
+     * The Kysely instance, for what precedes any entity: `migrate(app, setup)` writes the
+     * schema through it, and a script may need it before a container exists.
+     *
+     * It is not the way to reach data from inside an app — that is the injected `EntityOrm`,
+     * whose `client` gives the same handle while keeping the scope of its entity.
+     */
+    db: Kysely<any>;
+}
+export interface SqliteSetup extends Setup {
+    /** The raw handle, for pragmas and synchronous exec. */
+    sqlite: Database.Database;
+}
+/** A sink that runs statements through Kysely — works on every engine. */
+export declare function sqlSink(db: Kysely<any>): SqlSink;
+/** Wrap any Kysely dialect — Postgres, MySQL, SQL Server. */
+export declare function setupKysely(kyselyDialect: KyselyDialect, dialect: DialectName, opts?: SetupOptions): Setup;
+export declare function setupSqlite(opts?: SqliteSetupOptions): SqliteSetup;
+//# sourceMappingURL=setup.d.ts.map

package/dist/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,MAAM,EAAsB,KAAK,OAAO,IAAI,aAAa,EAAE,MAAM,QAAQ,CAAC;AACnF,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC,MAAM,WAAW,YAAY;IAC3B,2FAA2F;IAC3F,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAED,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACtD,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,KAAK;IACpB,OAAO,EAAE,WAAW,CAAC;IACrB,UAAU,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;IAChD,+DAA+D;IAC/D,IAAI,EAAE,OAAO,CAAC;IACd;;;;;;OAMG;IACH,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;CACjB;AAED,MAAM,WAAW,WAAY,SAAQ,KAAK;IACxC,wDAAwD;IACxD,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC;CAC3B;AAED,0EAA0E;AAC1E,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,OAAO,CAEhD;AAED,6DAA6D;AAC7D,wBAAgB,WAAW,CACzB,aAAa,EAAE,aAAa,EAC5B,OAAO,EAAE,WAAW,EACpB,IAAI,GAAE,YAAiB,GACtB,KAAK,CAGP;AAED,wBAAgB,WAAW,CAAC,IAAI,GAAE,kBAAuB,GAAG,WAAW,CAetE"}

package/dist/setup.js

@@ -0,0 +1,40 @@
+/**
+ * Storage setup — convention for SQLite, an escape hatch for the rest.
+ *
+ * SQLite is the default a first run meets, so it gets a concrete helper that
+ * owns its driver. Every other engine needs a driver Fougere has no business
+ * choosing (`pg`, `mysql2`, `tedious`), so the caller builds the Kysely dialect
+ * and hands it over — no dynamic import, no optional dependency.
+ */
+import { mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { Kysely, SqliteDialect, sql } from 'kysely';
+import Database from 'better-sqlite3';
+import { createOrmFactory } from './crud.js';
+/** A sink that runs statements through Kysely — works on every engine. */
+export function sqlSink(db) {
+    return { execute: (statement) => sql.raw(statement).execute(db) };
+}
+/** Wrap any Kysely dialect — Postgres, MySQL, SQL Server. */
+export function setupKysely(kyselyDialect, dialect, opts = {}) {
+    const db = new Kysely({ dialect: kyselyDialect });
+    return { db, dialect, ormFactory: createOrmFactory(db, opts.ormFactoryOptions, dialect), sink: sqlSink(db) };
+}
+export function setupSqlite(opts = {}) {
+    const path = opts.path ?? 'fougere.db';
+    // A file-backed DB needs its directory — SQLite won't create it.
+    if (path !== ':memory:')
+        mkdirSync(dirname(path), { recursive: true });
+    const sqlite = new Database(path);
+    sqlite.pragma('journal_mode = WAL');
+    sqlite.pragma('foreign_keys = ON');
+    const db = new Kysely({ dialect: new SqliteDialect({ database: sqlite }) });
+    return {
+        db,
+        sqlite,
+        dialect: 'sqlite',
+        ormFactory: createOrmFactory(db, opts.ormFactoryOptions, 'sqlite'),
+        sink: sqlSink(db),
+    };
+}
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,EAAiC,MAAM,QAAQ,CAAC;AACnF,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAA0B,MAAM,WAAW,CAAC;AAkCrE,0EAA0E;AAC1E,MAAM,UAAU,OAAO,CAAC,EAAe;IACrC,OAAO,EAAE,OAAO,EAAE,CAAC,SAAiB,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;AAC5E,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,WAAW,CACzB,aAA4B,EAC5B,OAAoB,EACpB,IAAI,GAAiB,EAAE;IAEvB,MAAM,EAAE,GAAG,IAAI,MAAM,CAAM,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;IACvD,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,gBAAgB,CAAC,EAAE,EAAE,IAAI,CAAC,iBAAiB,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;AAC/G,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAI,GAAuB,EAAE;IACvD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,YAAY,CAAC;IACvC,iEAAiE;IACjE,IAAI,IAAI,KAAK,UAAU;QAAE,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IACpC,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IACnC,MAAM,EAAE,GAAG,IAAI,MAAM,CAAM,EAAE,OAAO,EAAE,IAAI,aAAa,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;IACjF,OAAO;QACL,EAAE;QACF,MAAM;QACN,OAAO,EAAE,QAAQ;QACjB,UAAU,EAAE,gBAAgB,CAAC,EAAE,EAAE,IAAI,CAAC,iBAAiB,EAAE,QAAQ,CAAC;QAClE,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;KAClB,CAAC;AACJ,CAAC"}

package/dist/table.d.ts

@@ -0,0 +1,169 @@
+/**
+ * Entity → table description, with no SQL in sight.
+ *
+ * This is the neutral middle term: one projection reads the entity's axes and
+ * produces a `TableDef`; a `Dialect` turns that into SQL. Neither half knows the
+ * other — the entity never mentions a column type, the dialect never mentions a
+ * field. Adding a dialect touches only the second half.
+ */
+import { type SchemaSource } from '@fougere/schema';
+import { type ShapeBounds } from './check.js';
+/** The shape keywords a dialect needs to choose a column type. */
+export interface ColumnShape {
+    type?: string;
+    format?: string;
+    maxLength?: number;
+}
+/** One column, described by the axes — never by a SQL type. */
+export interface ColumnDef {
+    /** Field key on the entity. */
+    field: string;
+    /** SQL column name (snake_case). */
+    name: string;
+    /** The value shape, nullable union already unwrapped. */
+    shape?: ColumnShape;
+    nullable: boolean;
+    primary: boolean;
+    /** A literal default (`lifecycle.create.value`), when the field declares one. */
+    default?: unknown;
+    /** `role.unique` — realized as a column constraint the database enforces. */
+    unique?: boolean;
+    /** `role.index` — realized as a separate `CREATE INDEX`, never a constraint. */
+    index?: boolean;
+    /**
+     * What the shape bounds beyond its type — `oneOf`, `min`, `max`. Realized as a
+     * `CHECK`, so the rule holds on every write and not only at the façade.
+     */
+    bounds?: ShapeBounds;
+    /** The FK target, from `role.relation` when it's a `ref()` (kind `'one'`). */
+    references?: ColumnReference;
+}
+export interface ColumnReference {
+    table: string;
+    column: string;
+    onDelete?: 'cascade' | 'restrict' | 'set null';
+}
+export interface TableDef {
+    name: string;
+    columns: ColumnDef[];
+    /** PK column names when the key is composite — empty for a simple key. */
+    compositePrimary: string[];
+    /**
+     * Column groups unique together, from `entity(fields, { unique: [...] })`.
+     * A single-field group is left to the column's own `unique` — this is the
+     * table-level form, for facts no column can hold alone.
+     */
+    uniqueGroups: string[][];
+}
+/** camelCase → snake_case */
+export declare function toSnakeCase(str: string): string;
+/** How a `ref()` field's target table+column is resolved — see {@link referenceFor}. */
+export interface RelationResolve {
+    /** Same resolver used for every entity's own table (default or a custom `tableName`). */
+    resolve: (name: string) => string;
+    /** Live entity class → its already-resolved table name, reused instead of re-derived. */
+    tableNameOf?: Map<SchemaSource, string>;
+    /** Which entities this batch holds and which live in another source — decided by NAME. */
+    hosted?: HostedNames;
+}
+/** The two name sets a cross-source batch is read against — see {@link referenceFor}. */
+export interface HostedNames {
+    /** Registration names in THIS batch. */
+    here: ReadonlySet<string>;
+    /** Registration names the app hosts in another source — see {@link AppLike.elsewhere}. */
+    elsewhere: ReadonlySet<string>;
+}
+/**
+ * Describe one entity as a table — the single reader of the axes.
+ *
+ * Takes the entity as a live class or as a card. Read ONCE into `fields`: `fieldsOf`
+ * reconstructs a descriptor on each call, so re-reading per loop would rebuild the schema
+ * as many times as this function iterates.
+ *
+ * A lone card has no live relation targets, so a `ref()` falls back to the conventions
+ * `referenceFor`/`primaryColumnOf` already document (name-derived table, `id` as the key).
+ * Pass a bundle through `reconstructSet` first when the FKs matter — it resolves the
+ * targets, and its output is the live-class case again.
+ */
+export declare function toTable(tableName: string, entity: SchemaSource, relations?: RelationResolve): TableDef;
+/**
+ * Is this column part of a key? MySQL and SQL Server refuse an unbounded text
+ * column in a primary key or an index, so the dialect needs to know.
+ *
+ * `unique` and `index` count, and until they could be declared nothing did but the
+ * primary key — the comment above already said "or an index" while the code answered
+ * for the key alone, because no vocabulary word produced one to answer for.
+ */
+export declare function isKeyed(table: TableDef, column: ColumnDef): boolean;
+/** camelCase → snake_case + plural */
+export declare function toTableName(name: string): string;
+export interface EntityEntry {
+    name: string;
+    /** A live class in-process, a card from a frond whose class never crossed. */
+    entityClass: SchemaSource;
+}
+export interface FrondLike {
+    name: string;
+    entities: EntityEntry[];
+}
+export interface AppLike {
+    fronds: FrondLike[];
+    /** Auth runtime entities are migrated alongside scanned fronds when present. */
+    auth?: {
+        entities: Record<string, SchemaSource>;
+    };
+    /**
+     * Entities this app hosts in ANOTHER source — named so a miss can be read.
+     *
+     * Without it every miss looked alike, so a `ref()` fell back to a derived table name
+     * and the constraint was emitted against a table that might not exist. Absent means
+     * one source, where a miss can only be a mistake.
+     */
+    elsewhere?: string[];
+    /**
+     * The DERIVATIONS this app stores — registration names.
+     *
+     * A derivation makes no table by default: `Post.pick('id','title')` describes an
+     * answer, not a place rows live, and one dropped under `entities/` used to get a
+     * table of its own — measured on a real app, where a projection of an archived
+     * entity created a duplicate in the OTHER database.
+     *
+     * Naming it in `sources:` is the opt-in, and it changes what the thing is: a stored
+     * derivation is a dated COPY, not a projection, and it owes what any copy owes —
+     * who fills it, and how old it is.
+     */
+    materialize?: string[];
+}
+/**
+ * Every entity an app hosts, as FK-aware tables — the shared middle step behind
+ * `generateSQL` (a from-scratch create pass) and `desiredTables` (the diff's
+ * target state). Builds the identity map once (see `referenceFor`'s doc) so a
+ * `ref()` target reuses the SAME resolved name as the entity's own table.
+ */
+export declare function toTables(app: AppLike, resolve: (name: string) => string): TableDef[];
+export interface FkEdge {
+    table: TableDef;
+    column: ColumnDef;
+}
+export interface TableOrder {
+    /** Tables in dependency order — a `ref()` target always precedes its referrer. */
+    ordered: TableDef[];
+    /** FK columns whose target could not be ordered first — a cycle. Constrain after creation. */
+    deferred: FkEdge[];
+}
+/**
+ * Order a table set so a `ref()`'s target always exists before the table that
+ * points at it — required by every engine except SQLite, which resolves FK
+ * targets lazily and accepts any order (and has no `ALTER TABLE ADD CONSTRAINT`
+ * to close a cycle with — a caller on that dialect skips this function entirely).
+ *
+ * A cycle (`Post → Author → Post`, legal in the model — role.ts's relation
+ * thunk exists precisely so two entities can reference each other) has no such
+ * order: the loop is broken by deferring ONE of its edges per remaining cycle —
+ * that FK is added after every table exists, instead of inline. A self-reference
+ * (`parentId: ref(() => Category)`) is not a cycle here: a table may always
+ * reference its own not-yet-populated rows inline, standard support across
+ * every engine — so it's excluded from the dependency graph entirely.
+ */
+export declare function orderTables(tables: TableDef[]): TableOrder;
+//# sourceMappingURL=table.d.ts.map

package/dist/table.d.ts.map

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

package/dist/table.js

@@ -0,0 +1,292 @@
+/**
+ * Entity → table description, with no SQL in sight.
+ *
+ * This is the neutral middle term: one projection reads the entity's axes and
+ * produces a `TableDef`; a `Dialect` turns that into SQL. Neither half knows the
+ * other — the entity never mentions a column type, the dialect never mentions a
+ * field. Adding a dialect touches only the second half.
+ */
+import { Anatomy, fieldsOf, registrationKeyOf, uniqueMembers } from '@fougere/schema';
+import { boundsOf } from './check.js';
+/** camelCase → snake_case */
+export function toSnakeCase(str) {
+    return str.replace(/[A-Z]/g, (letter) => `_${letter.toLowerCase()}`);
+}
+/**
+ * A `many` relation owns no column — the join lives on the other side. Every
+ * other field becomes exactly one column.
+ */
+function isStored(field) {
+    return field.role?.relation?.kind !== 'many';
+}
+/**
+ * The target's primary key column. A live thunk (an in-process entity) answers
+ * for real; a relation reconstructed from a lone card (`reconstruct()`, no
+ * bundle — `packages/schema/src/projections/card.ts:18-22`) has lost it to a
+ * name stand-in with no `getFields` — the convention there is to assume `id`.
+ */
+function primaryColumnOf(target) {
+    if (typeof target.getFields !== 'function')
+        return 'id';
+    for (const [name, field] of Object.entries(target.getFields())) {
+        if (field.role?.primary)
+            return toSnakeCase(name);
+    }
+    return 'id'; // declared no primary() field — defensive, shouldn't happen
+}
+/**
+ * The FK target for a `ref()` field: the table it points at plus its PK column.
+ *
+ * `tableNameOf` is an identity map — built once per app generation pass, see
+ * {@link toTables} — from a LIVE entity class to the table name already resolved
+ * for it. Reusing that name (instead of re-deriving one from the class name) is
+ * what keeps a custom `tableName` resolver honest: `demos/schema-ecommerce`
+ * names `Category`'s table `"categories"` (an irregular plural its resolver
+ * special-cases) — re-deriving from `Category.name` through the DEFAULT
+ * convention would silently produce `"categorys"` instead.
+ *
+ * A miss (the target isn't part of this batch — a cross-frond target, or a live
+ * class the app substituted for one a package hardcoded — e.g.
+ * `@fougere/auth-better`'s `AuthSession` always points at its own default
+ * `AuthUser`, never at whatever `opts.user` the app actually registered) falls
+ * back to deriving the name from the class — correct when that class follows
+ * the default convention, wrong if the app ALSO overrides `tableName` for it.
+ */
+function referenceFor(field, resolve, tableNameOf, hosted) {
+    const relation = field.role?.relation;
+    if (!relation || relation.kind !== 'one')
+        return undefined;
+    const target = relation.to();
+    const mapped = tableNameOf?.get(target);
+    if (mapped === undefined && hosted !== undefined) {
+        // Three answers, and only the first two are ordinary. Two databases share no
+        // constraint, so a target that lives in another source gets a column and no
+        // foreign key — the relation survives, the pretence does not. A target no source
+        // hosts is a mistake, and staying silent would turn a bad registration into what
+        // reads exactly like a source boundary.
+        //
+        // Decided on the NAME and never on object identity: a target reached through two
+        // specifiers (`./Subscription.js` from a sibling entity, `Subscription.ts` from
+        // the scan) is TWO class objects for one entity, so the identity map misses on an
+        // entity that is right there. Measured on a real app, where this threw on
+        // `ref(Subscription)` while the table was in the very batch being built. Everything
+        // else that resolves a relation target already resolves it by name, for the same
+        // reason — a target rebuilt from a card is a `{ name }` stand-in.
+        const key = registrationKeyOf(target.name ?? '');
+        if (hosted.elsewhere.has(key))
+            return undefined;
+        if (!hosted.here.has(key)) {
+            throw new Error(`ref(${target.name ?? '?'}): no source hosts it — it is in neither this batch nor another one. ` +
+                `Check the entity is scanned, and that \`sources\` spells its name the same way.`);
+        }
+    }
+    const table = mapped ?? resolve(registrationKeyOf(target.name ?? ''));
+    const column = primaryColumnOf(target);
+    return relation.onDelete ? { table, column, onDelete: relation.onDelete } : { table, column };
+}
+function toColumn(fieldName, field, resolve, tableNameOf, hosted) {
+    // The column type comes from the `shape` axis alone. `anatomy` strips the
+    // nullable union so a nullable integer stays an integer instead of falling
+    // through to text.
+    const { base, nullable } = Anatomy.of(field.shape);
+    const create = field.lifecycle?.create;
+    const column = {
+        field: fieldName,
+        name: toSnakeCase(fieldName),
+        shape: base,
+        nullable,
+        primary: field.role?.primary === true,
+    };
+    const bounds = boundsOf(base);
+    if (bounds)
+        column.bounds = bounds;
+    if (typeof create === 'object' && create !== null && 'value' in create) {
+        column.default = create.value;
+    }
+    // A primary key is already unique and already indexed — saying it twice would emit a
+    // redundant constraint on every engine. So would indexing what `unique` constrains.
+    // Only a constraint of ONE becomes a column constraint; a group of several is a table
+    // constraint, emitted once from `uniqueGroups` rather than once per member column.
+    const soleUnique = (field.role?.unique ?? []).some((group) => group.length <= 1);
+    if (soleUnique && !column.primary)
+        column.unique = true;
+    if (field.role?.index === true && !column.primary && !column.unique)
+        column.index = true;
+    const references = referenceFor(field, resolve, tableNameOf, hosted);
+    if (references)
+        column.references = references;
+    return column;
+}
+/**
+ * Describe one entity as a table — the single reader of the axes.
+ *
+ * Takes the entity as a live class or as a card. Read ONCE into `fields`: `fieldsOf`
+ * reconstructs a descriptor on each call, so re-reading per loop would rebuild the schema
+ * as many times as this function iterates.
+ *
+ * A lone card has no live relation targets, so a `ref()` falls back to the conventions
+ * `referenceFor`/`primaryColumnOf` already document (name-derived table, `id` as the key).
+ * Pass a bundle through `reconstructSet` first when the FKs matter — it resolves the
+ * targets, and its output is the live-class case again.
+ */
+export function toTable(tableName, entity, relations) {
+    const resolve = relations?.resolve ?? toTableName;
+    const fields = fieldsOf(entity);
+    const columns = [];
+    for (const [fieldName, field] of Object.entries(fields)) {
+        if (!isStored(field))
+            continue;
+        columns.push(toColumn(fieldName, field, resolve, relations?.tableNameOf, relations?.hosted));
+    }
+    const primaries = columns.filter((column) => column.primary).map((column) => column.name);
+    const stored = new Set(columns.map((column) => column.name));
+    // Read off the fields, not off `getUnique()`: a card has no entity-level declaration to
+    // offer, and the members carry the same fact either way. One reader for both forms.
+    //
+    // Declared in field names, realized in column names — and a group that names a field the
+    // storage does not keep is not enforceable, so it is dropped here rather than emitted
+    // against a column that will not exist.
+    const groups = new Map();
+    for (const [fieldName, field] of Object.entries(fields)) {
+        for (const group of field.role?.unique ?? []) {
+            const members = uniqueMembers(group, fieldName).map(toSnakeCase);
+            if (members.length > 1 && members.every((column) => stored.has(column))) {
+                groups.set(members.join(' '), members);
+            }
+        }
+    }
+    const uniqueGroups = [...groups.values()];
+    return {
+        name: tableName,
+        columns,
+        compositePrimary: primaries.length > 1 ? primaries : [],
+        uniqueGroups,
+    };
+}
+/**
+ * Is this column part of a key? MySQL and SQL Server refuse an unbounded text
+ * column in a primary key or an index, so the dialect needs to know.
+ *
+ * `unique` and `index` count, and until they could be declared nothing did but the
+ * primary key — the comment above already said "or an index" while the code answered
+ * for the key alone, because no vocabulary word produced one to answer for.
+ */
+export function isKeyed(table, column) {
+    return column.primary
+        || column.unique === true
+        || column.index === true
+        || table.compositePrimary.includes(column.name);
+}
+// ─── App-wide entity collection — shared by generateSQL and desiredTables ──
+/** camelCase → snake_case + plural */
+export function toTableName(name) {
+    return name.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`) + 's';
+}
+/**
+ * Does this schema come from another one? `Post` answers no, `Post.pick(…)` answers
+ * `Post` — a derivation carries its origin, which `sourceNameOf` already reads for two
+ * other projections. Recognised by that FORM, never by a brand.
+ */
+function isDerivation(source) {
+    return source.source !== undefined;
+}
+/**
+ * A stored derivation must be able to say HOW OLD it is.
+ *
+ * It is a copy, and a copy read as if it were live is the silent loss this whole
+ * design exists to refuse: rows from yesterday typed exactly like rows from now. The
+ * vocabulary already carries the answer — a field with `update: 'now'` records when
+ * this row last changed HERE, which for a copy is when it was last pulled. So nothing
+ * new is declared; what is new is that forgetting it is refused, at boot, by name.
+ *
+ * An entity is untouched: it is not a copy of anything, and its rows are the truth.
+ */
+function refuseUndated(name, source) {
+    const dated = Object.values(fieldsOf(source)).some((field) => field.lifecycle?.update === 'now');
+    if (dated)
+        return;
+    throw new Error(`${name} is stored as a derivation but carries no \`updated()\` field — a copy that ` +
+        `cannot say when it was pulled reads exactly like live rows. Add one, or drop it from \`sources\`.`);
+}
+function collectEntities(app) {
+    const stored = new Set((app.materialize ?? []).map((name) => registrationKeyOf(name)));
+    const entries = [];
+    for (const frond of app.fronds) {
+        for (const entry of frond.entities) {
+            if (isDerivation(entry.entityClass)) {
+                if (!stored.has(registrationKeyOf(entry.name)))
+                    continue;
+                refuseUndated(entry.name, entry.entityClass);
+            }
+            entries.push(entry);
+        }
+    }
+    if (app.auth?.entities) {
+        for (const [name, entityClass] of Object.entries(app.auth.entities))
+            entries.push({ name, entityClass });
+    }
+    return entries;
+}
+/**
+ * Every entity an app hosts, as FK-aware tables — the shared middle step behind
+ * `generateSQL` (a from-scratch create pass) and `desiredTables` (the diff's
+ * target state). Builds the identity map once (see `referenceFor`'s doc) so a
+ * `ref()` target reuses the SAME resolved name as the entity's own table.
+ */
+export function toTables(app, resolve) {
+    const entries = collectEntities(app);
+    const tableNameOf = new Map(entries.map((entry) => [entry.entityClass, resolve(entry.name)]));
+    const lower = (name) => name.charAt(0).toLowerCase() + name.slice(1);
+    const hosted = app.elsewhere
+        ? { here: new Set(entries.map((entry) => lower(entry.name))), elsewhere: new Set(app.elsewhere.map(lower)) }
+        : undefined;
+    return entries.map((entry) => toTable(resolve(entry.name), entry.entityClass, { resolve, tableNameOf, hosted }));
+}
+/**
+ * Order a table set so a `ref()`'s target always exists before the table that
+ * points at it — required by every engine except SQLite, which resolves FK
+ * targets lazily and accepts any order (and has no `ALTER TABLE ADD CONSTRAINT`
+ * to close a cycle with — a caller on that dialect skips this function entirely).
+ *
+ * A cycle (`Post → Author → Post`, legal in the model — role.ts's relation
+ * thunk exists precisely so two entities can reference each other) has no such
+ * order: the loop is broken by deferring ONE of its edges per remaining cycle —
+ * that FK is added after every table exists, instead of inline. A self-reference
+ * (`parentId: ref(() => Category)`) is not a cycle here: a table may always
+ * reference its own not-yet-populated rows inline, standard support across
+ * every engine — so it's excluded from the dependency graph entirely.
+ */
+export function orderTables(tables) {
+    const byName = new Map(tables.map((table) => [table.name, table]));
+    const needs = new Map(tables.map((table) => [
+        table.name,
+        new Set(table.columns
+            .filter((c) => c.references && c.references.table !== table.name && byName.has(c.references.table))
+            .map((c) => c.references.table)),
+    ]));
+    const ordered = [];
+    const deferred = [];
+    const done = new Set();
+    while (needs.size > 0) {
+        const ready = [...needs.keys()].find((name) => [...needs.get(name)].every((dep) => done.has(dep)));
+        if (ready) {
+            ordered.push(byName.get(ready));
+            done.add(ready);
+            needs.delete(ready);
+            continue;
+        }
+        // Every table left waits on another table left — a cycle. Break it by
+        // deferring one edge: every column of the first remaining table that points
+        // at its first unmet dependency.
+        const [name, deps] = [...needs.entries()][0];
+        const dep = [...deps].find((d) => !done.has(d));
+        const table = byName.get(name);
+        for (const column of table.columns) {
+            if (column.references?.table === dep)
+                deferred.push({ table, column });
+        }
+        deps.delete(dep);
+    }
+    return { ordered, deferred };
+}
+//# sourceMappingURL=table.js.map

package/dist/table.js.map

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

package/dist/values.d.ts

@@ -0,0 +1,32 @@
+/**
+ * The values a driver accepts, and the values an entity declares.
+ *
+ * A driver binds numbers, strings, buffers and null — nothing else. An entity declares
+ * booleans, dates, lists and objects. Something has to sit between the two, and until
+ * now nothing did: `done: bool()` threw at insert ("SQLite3 can only bind numbers,
+ * strings, bigints, buffers, and null"), a `date()` could only be written as the ISO
+ * string its own type forbids, and both came back as whatever the column held.
+ *
+ * The pair below is derived from the column's shape alone — no new declaration, no axis
+ * to read. It lives in the storage adapter because that is where the driver's limits are
+ * known; the entity keeps saying `boolean` and `Date`.
+ *
+ * Drivers differ in how much they already do (Postgres hands back real booleans and
+ * Dates, SQLite hands back 0/1 and text), so every read guards on what it actually got
+ * instead of assuming.
+ */
+import type { ColumnShape } from './table.js';
+export interface ValueCodec {
+    /** Entity value → what the driver can bind. */
+    write(value: unknown): unknown;
+    /** What the driver returned → the value the entity declares. */
+    read(value: unknown): unknown;
+}
+/** The pair a column's shape calls for — identity when the driver already accepts it. */
+export declare function codecFor(shape?: ColumnShape): ValueCodec;
+/** Field name → codec, for every column that needs one. Identity columns are omitted. */
+export declare function codecsOf(columns: {
+    field: string;
+    shape?: ColumnShape;
+}[]): Map<string, ValueCodec>;
+//# sourceMappingURL=values.d.ts.map

package/dist/values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../src/values.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,UAAU;IACzB,+CAA+C;IAC/C,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IAC/B,gEAAgE;IAChE,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;CAC/B;AAsDD,yFAAyF;AACzF,wBAAgB,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,UAAU,CAexD;AAED,yFAAyF;AACzF,wBAAgB,QAAQ,CAAC,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,WAAW,CAAA;CAAE,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAOnG"}