@fougere/adapter-sql 0.2.0-alpha.2

package/dist/ddl.js

@@ -0,0 +1,194 @@
+/**
+ * DDL — the table description, rendered as SQL.
+ *
+ * Kysely's schema builder is what makes this dialect-agnostic: it owns the
+ * identifier quoting and the per-engine syntax, so this module only decides
+ * *what* to emit. Compilation needs no connection — a `DummyDriver` paired with
+ * a real query compiler renders the statement for any engine, which is why the
+ * whole surface is testable without a database.
+ */
+import { Kysely, DummyDriver, sql, SqliteAdapter, SqliteQueryCompiler, SqliteIntrospector, PostgresAdapter, PostgresQueryCompiler, PostgresIntrospector, MysqlAdapter, MysqlQueryCompiler, MysqlIntrospector, MssqlAdapter, MssqlQueryCompiler, MssqlIntrospector, } from 'kysely';
+import { isKeyed, orderTables, toTableName, toTables, } from './table.js';
+import { resolveDialect } from './dialect.js';
+import { checkFor } from './check.js';
+// ─── Compile-only engines ──────────────────────────
+const parts = {
+    sqlite: [SqliteAdapter, SqliteQueryCompiler, SqliteIntrospector],
+    pg: [PostgresAdapter, PostgresQueryCompiler, PostgresIntrospector],
+    mysql: [MysqlAdapter, MysqlQueryCompiler, MysqlIntrospector],
+    mssql: [MssqlAdapter, MssqlQueryCompiler, MssqlIntrospector],
+};
+const engines = new Map();
+/** A Kysely bound to a dialect's compiler but to no connection — renders SQL only. */
+export function compiler(name) {
+    const cached = engines.get(name);
+    if (cached)
+        return cached;
+    const [Adapter, QueryCompiler, Introspector] = parts[name];
+    const engine = new Kysely({
+        dialect: {
+            createAdapter: () => new Adapter(),
+            createDriver: () => new DummyDriver(),
+            createIntrospector: (db) => new Introspector(db),
+            createQueryCompiler: () => new QueryCompiler(),
+        },
+    });
+    engines.set(name, engine);
+    return engine;
+}
+// ─── CREATE TABLE ──────────────────────────────────
+/**
+ * Render `CREATE TABLE` for one described table.
+ *
+ * `IF NOT EXISTS` is emitted everywhere it exists — SQL Server has no such
+ * clause, so there the statement is bare and the caller must not replay it
+ * blindly (the diff pass, once it lands, answers that properly).
+ *
+ * `skipReferences` names the columns whose FK is rendered WITHOUT the inline
+ * `references()` — the column itself still gets created; `orderTables` sends a
+ * column here when its target is part of a cycle, so the constraint reaches the
+ * table separately, once every table involved exists (`addForeignKeyConstraintSQL`).
+ */
+export function createTableSQL(table, dialectName, options) {
+    const dialect = resolveDialect(dialectName);
+    const composite = table.compositePrimary.length > 0;
+    const skip = options?.skipReferences;
+    let builder = compiler(dialectName).schema.createTable(table.name);
+    if (dialectName !== 'mssql')
+        builder = builder.ifNotExists();
+    for (const column of table.columns) {
+        const type = dialect.columnType(column, isKeyed(table, column));
+        builder = builder.addColumn(column.name, sql.raw(type), (col) => {
+            let built = col;
+            // A simple key is inline; a composite one becomes a table constraint.
+            if (column.primary && !composite)
+                built = built.primaryKey();
+            if (!column.nullable)
+                built = built.notNull();
+            if (column.default !== undefined)
+                built = built.defaultTo(column.default);
+            // Uniqueness is the storage's to enforce: no shape can express it, since judging
+            // one value never sees the other rows.
+            if (column.unique)
+                built = built.unique();
+            if (column.references && !skip?.has(column.name)) {
+                built = built.references(`${column.references.table}.${column.references.column}`);
+                if (column.references.onDelete)
+                    built = built.onDelete(column.references.onDelete);
+            }
+            return built;
+        });
+    }
+    if (composite) {
+        builder = builder.addPrimaryKeyConstraint(`${table.name}_pk`, table.compositePrimary);
+    }
+    // The pair the entity declared. Named after its columns so a second group on the
+    // same table cannot collide, and so a migration can recognize it later.
+    for (const group of table.uniqueGroups) {
+        builder = builder.addUniqueConstraint(`${table.name}_${group.join('_')}_unique`, group);
+    }
+    // What the shape says, told to the storage. Table-level rather than inline: a
+    // named constraint is what a later migration can find and replace, and the same
+    // form will hold a cross-field check when one is declared.
+    for (const column of table.columns) {
+        const check = checkFor(column);
+        if (check)
+            builder = builder.addCheckConstraint(`${table.name}_${column.name}_check`, check);
+    }
+    return builder.compile().sql;
+}
+/**
+ * `CREATE INDEX` for every column that asked for one.
+ *
+ * Separate statements, never part of `CREATE TABLE`: an index is not a constraint, it
+ * changes no answer — only what a read costs. `IF NOT EXISTS` everywhere it exists, so
+ * replaying the batch is safe (SQL Server has no such clause, same rule as the tables).
+ */
+export function indexSQL(table, column, dialectName) {
+    let builder = compiler(dialectName)
+        .schema.createIndex(`${table.name}_${column.name}_idx`)
+        .on(table.name)
+        .column(column.name);
+    if (dialectName !== 'mssql')
+        builder = builder.ifNotExists();
+    return builder.compile().sql;
+}
+/** Every index one table asks for — one statement each. */
+export function createIndexSQL(table, dialectName) {
+    return table.columns
+        .filter((column) => column.index)
+        .map((column) => indexSQL(table, column, dialectName));
+}
+/**
+ * `ALTER TABLE ADD CONSTRAINT` for one FK `orderTables` deferred — closes a
+ * relation cycle once every table in it exists. Not available on SQLite (its
+ * `ALTER TABLE` is limited to RENAME/ADD COLUMN/RENAME COLUMN/DROP COLUMN) — a
+ * caller on that dialect never produces a deferred edge to render here.
+ */
+export function addForeignKeyConstraintSQL(table, column, dialectName) {
+    const ref = column.references;
+    const name = `${table.name}_${column.name}_fk`;
+    let builder = compiler(dialectName)
+        .schema.alterTable(table.name)
+        .addForeignKeyConstraint(name, [column.name], ref.table, [ref.column]);
+    if (ref.onDelete)
+        builder = builder.onDelete(ref.onDelete);
+    return builder.compile().sql;
+}
+/**
+ * `CREATE TABLE` for every entity the app hosts — scanned frond entities plus
+ * auth runtime entities when present.
+ *
+ * SQLite resolves FK targets lazily and accepts any order, and it has no
+ * `ALTER TABLE ADD CONSTRAINT` to close a cycle with — every FK stays inline,
+ * unordered. Every other engine needs a referenced table to exist first:
+ * `orderTables` sorts the batch and reports the edges a cycle forces to defer,
+ * rendered as `ALTER TABLE ADD CONSTRAINT` after every `CREATE TABLE`.
+ *
+ * Caveat for a repeat call (`autoMigrate`): `CREATE TABLE IF NOT EXISTS` is
+ * idempotent, `ADD CONSTRAINT` is not — on pg/mysql/mssql, calling this twice
+ * for an app with a relation cycle re-issues the same constraint and errors.
+ * The introspection-based `migrate()` (`diff.ts`) doesn't have this problem: it
+ * only ever emits a table's constraints once, the run that creates it.
+ */
+export function generateSQL(app, options) {
+    const resolve = options?.tableName ?? toTableName;
+    const dialect = options?.dialect ?? 'sqlite';
+    const tables = toTables(app, resolve);
+    if (dialect === 'sqlite') {
+        return [
+            ...tables.map((table) => createTableSQL(table, dialect)),
+            ...tables.flatMap((table) => createIndexSQL(table, dialect)),
+        ];
+    }
+    const { ordered, deferred } = orderTables(tables);
+    const deferredColumnsOf = new Map();
+    for (const { table, column } of deferred) {
+        const names = deferredColumnsOf.get(table.name) ?? new Set();
+        names.add(column.name);
+        deferredColumnsOf.set(table.name, names);
+    }
+    const creates = ordered.map((table) => createTableSQL(table, dialect, { skipReferences: deferredColumnsOf.get(table.name) }));
+    const constraints = deferred.map(({ table, column }) => addForeignKeyConstraintSQL(table, column, dialect));
+    // Indexes last: every table exists by then, and an index on a table that does not is
+    // the one ordering mistake this pass can make.
+    const indexes = ordered.flatMap((table) => createIndexSQL(table, dialect));
+    return [...creates, ...constraints, ...indexes];
+}
+function runOn(sink, statement) {
+    return 'execute' in sink ? sink.execute(statement) : sink.exec(statement);
+}
+/**
+ * Create every missing table. Additive only — an existing table is left alone.
+ *
+ * Stays SYNCHRONOUS when the sink is (a raw better-sqlite3 handle), so a caller
+ * that doesn't await still gets its tables before the next statement. Returns a
+ * promise only when the sink actually returns one.
+ */
+export function autoMigrate(app, sink, options) {
+    const pending = generateSQL(app, options)
+        .map((statement) => runOn(sink, statement))
+        .filter((result) => typeof result?.then === 'function');
+    return pending.length ? Promise.all(pending).then(() => undefined) : undefined;
+}
+//# sourceMappingURL=ddl.js.map

package/dist/ddl.js.map

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

package/dist/dialect.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Dialect — the only place that speaks SQL.
+ *
+ * A dialect answers two questions and nothing else: which column type carries
+ * this shape, and does this engine support `RETURNING`. Everything structural
+ * (which columns exist, which are keys) is decided upstream in `TableDef`.
+ */
+import type { ColumnDef } from './table.js';
+export type DialectName = 'sqlite' | 'pg' | 'mysql' | 'mssql';
+export interface Dialect {
+    name: DialectName;
+    /**
+     * SQL type for a column. `keyed` is true when the column belongs to a primary
+     * key — MySQL and SQL Server cannot index an unbounded text column, so they
+     * narrow to a bounded varchar there.
+     */
+    columnType(column: ColumnDef, keyed: boolean): string;
+    /**
+     * Does `INSERT … RETURNING` work? MySQL has no such clause and SQL Server
+     * spells it `OUTPUT`; both take the insert-then-select path instead.
+     */
+    supportsReturning: boolean;
+    /**
+     * How many values one statement may bind — what splits a batch read into several.
+     *
+     * A key set comes from a PAGE, and a page has no ceiling (`list()` with no limit
+     * reads the table), so `where id in (…)` eventually meets the engine's limit.
+     * Measured on SQLite: 32 766 binds, and 32 767 answers `too many SQL variables`.
+     * SQL Server is the low one at 2100, which is why this is per dialect and not one
+     * constant — a batch that works on SQLite and dies on SQL Server is the same value
+     * behaving differently per engine, the thing this file exists to absorb.
+     *
+     * The number below is the limit MINUS a margin for the other values a statement
+     * carries (a filter, a cursor): a batch read is never the only thing in the query.
+     */
+    maxBindings: number;
+    /**
+     * How this engine spells "write it, or replace what is there".
+     *
+     * `'on conflict'` is the standard clause (SQLite, Postgres); MySQL spells the same
+     * thing `ON DUPLICATE KEY UPDATE`; SQL Server has only `MERGE`, a different statement
+     * with different semantics — so it answers `false` and the port refuses by name
+     * rather than emulating a write with a read in front of it, which would be a lie
+     * about atomicity in an engine that has no transaction here either.
+     */
+    upsert: 'on conflict' | 'on duplicate key' | false;
+}
+export declare const sqliteDialect: Dialect;
+export declare const pgDialect: Dialect;
+export declare const mysqlDialect: Dialect;
+export declare const mssqlDialect: Dialect;
+export declare const dialects: Record<DialectName, Dialect>;
+export declare function resolveDialect(name: DialectName): Dialect;
+//# sourceMappingURL=dialect.d.ts.map

package/dist/dialect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialect.d.ts","sourceRoot":"","sources":["../src/dialect.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,IAAI,GAAG,OAAO,GAAG,OAAO,CAAC;AAE9D,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,WAAW,CAAC;IAClB;;;;OAIG;IACH,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IACtD;;;OAGG;IACH,iBAAiB,EAAE,OAAO,CAAC;IAC3B;;;;;;;;;;;;OAYG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;;;OAQG;IACH,MAAM,EAAE,aAAa,GAAG,kBAAkB,GAAG,KAAK,CAAC;CACpD;AAUD,eAAO,MAAM,aAAa,EAAE,OAmB3B,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,OAuBvB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,OAsB1B,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,OAsB1B,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,WAAW,EAAE,OAAO,CAKjD,CAAC;AAEF,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAIzD"}

package/dist/dialect.js

@@ -0,0 +1,109 @@
+/** Bounded length for a key column, when the shape doesn't state its own. */
+const KEY_LENGTH = 255;
+function keyLength(column) {
+    const declared = column.shape?.maxLength;
+    return declared !== undefined && declared > 0 && declared <= KEY_LENGTH ? declared : KEY_LENGTH;
+}
+export const sqliteDialect = {
+    upsert: 'on conflict',
+    // SQLITE_MAX_VARIABLE_NUMBER is 32766 on any build since 3.32 (measured on better-sqlite3).
+    maxBindings: 30000,
+    name: 'sqlite',
+    supportsReturning: true,
+    // SQLite has one integer, one float and one text type — a boolean is an int,
+    // JSON is text. Any column may be a key, so `keyed` changes nothing.
+    columnType(column) {
+        switch (column.shape?.type) {
+            case 'integer':
+            case 'boolean':
+                return 'integer';
+            case 'number':
+                return 'real';
+            default:
+                return 'text';
+        }
+    },
+};
+export const pgDialect = {
+    upsert: 'on conflict',
+    // the wire protocol counts parameters in an int16 — 65535.
+    maxBindings: 60000,
+    name: 'pg',
+    supportsReturning: true,
+    // Postgres has real types for everything, and `text` is indexable — so a key
+    // needs no narrowing.
+    columnType(column) {
+        switch (column.shape?.type) {
+            case 'integer':
+                return 'integer';
+            case 'number':
+                return 'double precision';
+            case 'boolean':
+                return 'boolean';
+            case 'object':
+            case 'array':
+                return 'jsonb';
+            default:
+                return 'text';
+        }
+    },
+};
+export const mysqlDialect = {
+    upsert: 'on duplicate key',
+    // no parameter ceiling of its own; max_allowed_packet is what gives way, and it grows with the VALUES not the count.
+    maxBindings: 60000,
+    name: 'mysql',
+    supportsReturning: false,
+    columnType(column, keyed) {
+        switch (column.shape?.type) {
+            case 'integer':
+                return 'int';
+            case 'number':
+                return 'double';
+            case 'boolean':
+                return 'boolean';
+            case 'object':
+            case 'array':
+                return 'json';
+            default:
+                // TEXT cannot take part in a key without a prefix length.
+                return keyed ? `varchar(${keyLength(column)})` : 'text';
+        }
+    },
+};
+export const mssqlDialect = {
+    upsert: false,
+    // 2100 parameters per statement, the lowest of the four by a wide margin.
+    maxBindings: 2000,
+    name: 'mssql',
+    supportsReturning: false,
+    columnType(column, keyed) {
+        switch (column.shape?.type) {
+            case 'integer':
+                return 'int';
+            case 'number':
+                return 'float';
+            case 'boolean':
+                return 'bit';
+            case 'object':
+            case 'array':
+                return 'nvarchar(max)';
+            default:
+                // nvarchar(max) is not indexable — a key narrows to a bounded length.
+                return keyed ? `nvarchar(${keyLength(column)})` : 'nvarchar(max)';
+        }
+    },
+};
+export const dialects = {
+    sqlite: sqliteDialect,
+    pg: pgDialect,
+    mysql: mysqlDialect,
+    mssql: mssqlDialect,
+};
+export function resolveDialect(name) {
+    const dialect = dialects[name];
+    if (!dialect)
+        throw new Error(`Unknown SQL dialect '${name}'. Known: ${Object.keys(dialects).join(', ')}`);
+    return dialect;
+}
+//# sourceMappingURL=dialect.js.map

package/dist/dialect.js.map

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

package/dist/diff.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Diff — what the database is missing, compared to what the entities describe.
+ *
+ * Two states, one comparison, one realisation. The desired state comes from the
+ * entities; the actual one from Kysely's introspection, which is already
+ * engine-agnostic. The comparison itself is pure — no IO, no SQL.
+ *
+ * ADDITIVE ONLY, and that incapacity is the guarantee: a missing table is
+ * created, a missing column is added, and **nothing else ever happens**. Drops,
+ * renames and type changes are human intentions — a rename is not even
+ * detectable from a diff (it reads as a drop plus an add). Those belong in a
+ * written migration, never in an automatic pass.
+ */
+import { type Kysely } from 'kysely';
+import { type GenerateOptions } from './ddl.js';
+import { type DialectName } from './dialect.js';
+import { type AppLike, type ColumnDef, type TableDef } from './table.js';
+/** What the database actually holds: column names per table. */
+export type SchemaState = Map<string, Set<string>>;
+/** Read the live schema. Only names are needed — an additive pass never inspects types. */
+export declare function actualState(db: Kysely<any>): Promise<SchemaState>;
+/** Project the app's entities into the tables they ask for. */
+export declare function desiredTables(app: AppLike, options?: GenerateOptions): TableDef[];
+export type Change = {
+    kind: 'createTable';
+    table: TableDef;
+    deferredColumns?: string[];
+} | {
+    kind: 'addColumn';
+    table: TableDef;
+    column: ColumnDef;
+} | {
+    kind: 'addConstraint';
+    table: TableDef;
+    column: ColumnDef;
+} | {
+    kind: 'createIndex';
+    table: TableDef;
+    column: ColumnDef;
+};
+/** Compare the two states. Pure — the only place that decides what is missing. */
+export declare function delta(desired: TableDef[], actual: SchemaState): Change[];
+/**
+ * Order the changes `delta` found, dialect-aware — `delta` itself stays pure and
+ * unordered, this is the one place that adds engine knowledge to the plan.
+ *
+ * SQLite resolves FK targets lazily and accepts any order, with no `ALTER TABLE
+ * ADD CONSTRAINT` to defer to — changes pass through unchanged. Every other
+ * engine needs a `createTable`'s FK targets to already exist: `orderTables`
+ * sorts the NEW tables among themselves and reports the edges a cycle forces to
+ * defer as `addConstraint` changes. An `addColumn` always lands last — its
+ * table already exists (that's why it's `addColumn` and not `createTable`), but
+ * its FK target might be one of THIS batch's new tables, so it waits until
+ * every `createTable`/`addConstraint` above it has run.
+ */
+export declare function orderChanges(changes: Change[], dialectName: DialectName): Change[];
+/**
+ * Render one change.
+ *
+ * A column added to a populated table cannot be `NOT NULL` without a default —
+ * every engine refuses it. So an added column keeps its `NOT NULL` only when a
+ * default answers the existing rows; otherwise it lands nullable, and tightening
+ * it is a written migration.
+ */
+export declare function changeSQL(change: Change, dialectName: DialectName): string;
+/** Everything the database is missing, as statements ready to run. */
+export declare function planMigration(app: AppLike, db: Kysely<any>, options?: GenerateOptions): Promise<{
+    changes: Change[];
+    statements: string[];
+}>;
+/**
+ * Bring the database up to what the entities describe — additively.
+ *
+ * Returns what it did, so a caller can log or refuse. Replaces the old
+ * create-if-not-exists pass: it also catches a field added to an existing entity,
+ * which used to be silently ignored.
+ */
+/**
+ * Bring the schema up to date. Takes the setup itself — `migrate(app, setup)` — so the
+ * common case never has to reach into `setup.db`, the one handle that meets no judge.
+ * A bare Kysely instance is still accepted, for a caller who holds only that.
+ */
+export declare function migrate(app: AppLike, target: Kysely<any> | {
+    db: Kysely<any>;
+}, options?: GenerateOptions): Promise<Change[]>;
+//# sourceMappingURL=diff.d.ts.map

package/dist/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../src/diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAO,KAAK,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,EAAkE,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhH,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAKL,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,QAAQ,EACd,MAAM,YAAY,CAAC;AAEpB,gEAAgE;AAChE,MAAM,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAEnD,2FAA2F;AAC3F,wBAAsB,WAAW,CAAC,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAOvE;AAED,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,QAAQ,EAAE,CAEjF;AAED,MAAM,MAAM,MAAM,GACd;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GACpE;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,CAAC;AAEhE,kFAAkF;AAClF,wBAAgB,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,EAAE,CAsBxE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,WAAW,GAAG,MAAM,EAAE,CAuBlF;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,MAAM,CAqC1E;AAED,sEAAsE;AACtE,wBAAsB,aAAa,CACjC,GAAG,EAAE,OAAO,EACZ,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,EACf,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAItD;AAED;;;;;;GAMG;AACH;;;;GAIG;AACH,wBAAsB,OAAO,CAC3B,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAA;CAAE,EACzC,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,MAAM,EAAE,CAAC,CAOnB"}

package/dist/diff.js

@@ -0,0 +1,168 @@
+/**
+ * Diff — what the database is missing, compared to what the entities describe.
+ *
+ * Two states, one comparison, one realisation. The desired state comes from the
+ * entities; the actual one from Kysely's introspection, which is already
+ * engine-agnostic. The comparison itself is pure — no IO, no SQL.
+ *
+ * ADDITIVE ONLY, and that incapacity is the guarantee: a missing table is
+ * created, a missing column is added, and **nothing else ever happens**. Drops,
+ * renames and type changes are human intentions — a rename is not even
+ * detectable from a diff (it reads as a drop plus an add). Those belong in a
+ * written migration, never in an automatic pass.
+ */
+import { sql } from 'kysely';
+import { addForeignKeyConstraintSQL, compiler, createTableSQL, indexSQL } from './ddl.js';
+import { checkFor } from './check.js';
+import { resolveDialect } from './dialect.js';
+import { isKeyed, orderTables, toTables, toTableName, } from './table.js';
+/** Read the live schema. Only names are needed — an additive pass never inspects types. */
+export async function actualState(db) {
+    const state = new Map();
+    for (const table of await db.introspection.getTables()) {
+        if (table.isView)
+            continue;
+        state.set(table.name, new Set(table.columns.map((column) => column.name)));
+    }
+    return state;
+}
+/** Project the app's entities into the tables they ask for. */
+export function desiredTables(app, options) {
+    return toTables(app, options?.tableName ?? toTableName);
+}
+/** Compare the two states. Pure — the only place that decides what is missing. */
+export function delta(desired, actual) {
+    const changes = [];
+    for (const table of desired) {
+        const existing = actual.get(table.name);
+        if (!existing) {
+            changes.push({ kind: 'createTable', table });
+            continue;
+        }
+        for (const column of table.columns) {
+            if (!existing.has(column.name))
+                changes.push({ kind: 'addColumn', table, column });
+        }
+    }
+    // Indexes, unconditionally: this pass reads column NAMES from the live schema, so it
+    // cannot see whether an index exists. `CREATE INDEX IF NOT EXISTS` is idempotent, so
+    // proposing it every time is cheaper and more honest than introspecting to guess —
+    // the alternative would be an index that a `unique()` added later never gets.
+    for (const table of desired) {
+        for (const column of table.columns) {
+            if (column.index)
+                changes.push({ kind: 'createIndex', table, column });
+        }
+    }
+    return changes;
+}
+/**
+ * Order the changes `delta` found, dialect-aware — `delta` itself stays pure and
+ * unordered, this is the one place that adds engine knowledge to the plan.
+ *
+ * SQLite resolves FK targets lazily and accepts any order, with no `ALTER TABLE
+ * ADD CONSTRAINT` to defer to — changes pass through unchanged. Every other
+ * engine needs a `createTable`'s FK targets to already exist: `orderTables`
+ * sorts the NEW tables among themselves and reports the edges a cycle forces to
+ * defer as `addConstraint` changes. An `addColumn` always lands last — its
+ * table already exists (that's why it's `addColumn` and not `createTable`), but
+ * its FK target might be one of THIS batch's new tables, so it waits until
+ * every `createTable`/`addConstraint` above it has run.
+ */
+export function orderChanges(changes, dialectName) {
+    if (dialectName === 'sqlite')
+        return changes;
+    const creates = changes.filter((c) => c.kind === 'createTable');
+    const addColumns = changes.filter((c) => c.kind === 'addColumn');
+    const indexes = changes.filter((c) => c.kind === 'createIndex');
+    const { ordered, deferred } = orderTables(creates.map((c) => c.table));
+    const deferredColumnsOf = new Map();
+    for (const { table, column } of deferred) {
+        const names = deferredColumnsOf.get(table.name) ?? new Set();
+        names.add(column.name);
+        deferredColumnsOf.set(table.name, names);
+    }
+    const createChanges = ordered.map((table) => {
+        const names = deferredColumnsOf.get(table.name);
+        return names ? { kind: 'createTable', table, deferredColumns: [...names] } : { kind: 'createTable', table };
+    });
+    const constraintChanges = deferred.map(({ table, column }) => ({ kind: 'addConstraint', table, column }));
+    // Indexes last: the column they stand on may be one this very batch added.
+    return [...createChanges, ...constraintChanges, ...addColumns, ...indexes];
+}
+/**
+ * Render one change.
+ *
+ * A column added to a populated table cannot be `NOT NULL` without a default —
+ * every engine refuses it. So an added column keeps its `NOT NULL` only when a
+ * default answers the existing rows; otherwise it lands nullable, and tightening
+ * it is a written migration.
+ */
+export function changeSQL(change, dialectName) {
+    const dialect = resolveDialect(dialectName);
+    if (change.kind === 'createTable') {
+        // Reuse the same renderer as a fresh install — one builder, no drift.
+        const skip = change.deferredColumns ? new Set(change.deferredColumns) : undefined;
+        return createTableSQL(change.table, dialectName, { skipReferences: skip });
+    }
+    if (change.kind === 'addConstraint') {
+        return addForeignKeyConstraintSQL(change.table, change.column, dialectName);
+    }
+    if (change.kind === 'createIndex') {
+        // One statement per change — `migrate` runs them one by one, and no driver here
+        // accepts a batch.
+        return indexSQL(change.table, change.column, dialectName);
+    }
+    const { table, column } = change;
+    const type = dialect.columnType(column, isKeyed(table, column));
+    return compiler(dialectName)
+        .schema.alterTable(table.name)
+        .addColumn(column.name, sql.raw(type), (col) => {
+        let built = col;
+        if (column.default !== undefined) {
+            built = built.defaultTo(column.default);
+            if (!column.nullable)
+                built = built.notNull();
+        }
+        if (column.references) {
+            built = built.references(`${column.references.table}.${column.references.column}`);
+            if (column.references.onDelete)
+                built = built.onDelete(column.references.onDelete);
+        }
+        // Inline rather than a named table constraint: SQLite cannot ALTER one in, and
+        // the column is new, so no existing row can be caught out by it. A column that
+        // arrives later is bounded like a column that was there from the start.
+        const check = checkFor(column);
+        if (check)
+            built = built.check(check);
+        return built;
+    })
+        .compile().sql;
+}
+/** Everything the database is missing, as statements ready to run. */
+export async function planMigration(app, db, options) {
+    const dialect = options?.dialect ?? 'sqlite';
+    const changes = orderChanges(delta(desiredTables(app, options), await actualState(db)), dialect);
+    return { changes, statements: changes.map((change) => changeSQL(change, dialect)) };
+}
+/**
+ * Bring the database up to what the entities describe — additively.
+ *
+ * Returns what it did, so a caller can log or refuse. Replaces the old
+ * create-if-not-exists pass: it also catches a field added to an existing entity,
+ * which used to be silently ignored.
+ */
+/**
+ * Bring the schema up to date. Takes the setup itself — `migrate(app, setup)` — so the
+ * common case never has to reach into `setup.db`, the one handle that meets no judge.
+ * A bare Kysely instance is still accepted, for a caller who holds only that.
+ */
+export async function migrate(app, target, options) {
+    const db = target.db ?? target;
+    const { changes, statements } = await planMigration(app, db, options);
+    for (const statement of statements) {
+        await sql.raw(statement).execute(db);
+    }
+    return changes;
+}
+//# sourceMappingURL=diff.js.map

package/dist/diff.js.map

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