@fougere/adapter-sql 0.9.3-alpha.0 → 0.11.0-alpha.0

package/dist/table/ColumnDef.d.ts

@@ -0,0 +1,34 @@
+import { type ShapeType } from '@fougere/schema';
+import { type ShapeBounds } from '../check.js';
+import { type SqlField } from '../fields/SqlField.js';
+import type { ColumnReference } from './ColumnReference.js';
+/** One column, described by the axes — plus, at most, what the entity stated for sql. */
+export interface ColumnDef {
+    /** Field key on the entity. */
+    field: string;
+    /** SQL column name (snake_case). */
+    name: string;
+    /** What every projection here dispatches on — a `date()` and a bounded set included. */
+    type?: ShapeType;
+    nullable: boolean;
+    primary: boolean;
+    /** A literal default (`lifecycle.create.value`), when the field declares one. */
+    default?: unknown;
+    /** A {@link Unique} of one — 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;
+    /**
+     * What the entity stated for THIS adapter — never an axis. It says how the column is
+     * realized here; drop it and the column is still describable.
+     */
+    stated?: SqlField;
+}
+//# sourceMappingURL=ColumnDef.d.ts.map

package/dist/table/ColumnDef.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColumnDef.d.ts","sourceRoot":"","sources":["../../src/table/ColumnDef.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,yFAAyF;AACzF,MAAM,WAAW,SAAS;IACxB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,wFAAwF;IACxF,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,iFAAiF;IACjF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uFAAuF;IACvF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gFAAgF;IAChF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B;;;OAGG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAC;CACnB"}

package/dist/table/ColumnDef.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ColumnDef.js.map

package/dist/table/ColumnDef.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColumnDef.js","sourceRoot":"","sources":["../../src/table/ColumnDef.ts"],"names":[],"mappings":""}

package/dist/table/ColumnReference.d.ts

@@ -0,0 +1,6 @@
+export interface ColumnReference {
+    table: string;
+    column: string;
+    onDelete?: 'cascade' | 'restrict' | 'set null';
+}
+//# sourceMappingURL=ColumnReference.d.ts.map

package/dist/table/ColumnReference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColumnReference.d.ts","sourceRoot":"","sources":["../../src/table/ColumnReference.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;CAChD"}

package/dist/table/ColumnReference.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ColumnReference.js.map

package/dist/table/ColumnReference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColumnReference.js","sourceRoot":"","sources":["../../src/table/ColumnReference.ts"],"names":[],"mappings":""}

package/dist/table/EntityEntry.d.ts

@@ -0,0 +1,7 @@
+import { type SchemaView } from '@fougere/schema';
+export interface EntityEntry {
+    name: string;
+    /** A live class in-process, or one rebuilt from the card of a frond that never crossed. */
+    entityClass: SchemaView;
+}
+//# sourceMappingURL=EntityEntry.d.ts.map

package/dist/table/EntityEntry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityEntry.d.ts","sourceRoot":"","sources":["../../src/table/EntityEntry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,2FAA2F;IAC3F,WAAW,EAAE,UAAU,CAAC;CACzB"}

package/dist/table/EntityEntry.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=EntityEntry.js.map

package/dist/table/EntityEntry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityEntry.js","sourceRoot":"","sources":["../../src/table/EntityEntry.ts"],"names":[],"mappings":""}

package/dist/table/FrondLike.d.ts

@@ -0,0 +1,6 @@
+import type { EntityEntry } from './EntityEntry.js';
+export interface FrondLike {
+    name: string;
+    entities: EntityEntry[];
+}
+//# sourceMappingURL=FrondLike.d.ts.map

package/dist/table/FrondLike.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FrondLike.d.ts","sourceRoot":"","sources":["../../src/table/FrondLike.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB"}

package/dist/table/FrondLike.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=FrondLike.js.map

package/dist/table/FrondLike.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FrondLike.js","sourceRoot":"","sources":["../../src/table/FrondLike.ts"],"names":[],"mappings":""}

package/dist/table/HostedNames.d.ts

@@ -0,0 +1,8 @@
+/** 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>;
+}
+//# sourceMappingURL=HostedNames.d.ts.map

package/dist/table/HostedNames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HostedNames.d.ts","sourceRoot":"","sources":["../../src/table/HostedNames.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1B,0FAA0F;IAC1F,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAChC"}

package/dist/table/HostedNames.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=HostedNames.js.map

package/dist/table/HostedNames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HostedNames.js","sourceRoot":"","sources":["../../src/table/HostedNames.ts"],"names":[],"mappings":""}

package/dist/table/RelationResolve.d.ts

@@ -0,0 +1,12 @@
+import { type SchemaView } from '@fougere/schema';
+import type { HostedNames } from './HostedNames.js';
+/** 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<SchemaView, string>;
+    /** Which entities this batch holds and which live in another source — decided by NAME. */
+    hosted?: HostedNames;
+}
+//# sourceMappingURL=RelationResolve.d.ts.map

package/dist/table/RelationResolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RelationResolve.d.ts","sourceRoot":"","sources":["../../src/table/RelationResolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,wFAAwF;AACxF,MAAM,WAAW,eAAe;IAC9B,yFAAyF;IACzF,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAClC,yFAAyF;IACzF,WAAW,CAAC,EAAE,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACtC,0FAA0F;IAC1F,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB"}

package/dist/table/RelationResolve.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=RelationResolve.js.map

package/dist/table/RelationResolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RelationResolve.js","sourceRoot":"","sources":["../../src/table/RelationResolve.ts"],"names":[],"mappings":""}

package/dist/table/TableDef.d.ts

@@ -0,0 +1,29 @@
+import { type SchemaView } from '@fougere/schema';
+import type { ColumnDef } from './ColumnDef.js';
+import type { RelationResolve } from './RelationResolve.js';
+import type { AppLike } from './AppLike.js';
+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: [...] })`. */
+    uniqueGroups: string[][];
+}
+/** camelCase → snake_case */
+export declare function toSnakeCase(str: string): string;
+/** Describe one entity as a table — the single reader of the axes. */
+export declare function toTable(tableName: string, schema: SchemaView, 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.
+ */
+export declare function isKeyed(table: TableDef, column: ColumnDef): boolean;
+/** camelCase → snake_case + plural */
+export declare function toTableName(name: string): 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).
+ */
+export declare function toTables(app: AppLike, resolve: (name: string) => string): TableDef[];
+//# sourceMappingURL=TableDef.d.ts.map

package/dist/table/TableDef.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TableDef.d.ts","sourceRoot":"","sources":["../../src/table/TableDef.ts"],"names":[],"mappings":"AACA,OAAO,EAAkC,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAIlF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,0EAA0E;IAC1E,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,+EAA+E;IAC/E,YAAY,EAAE,MAAM,EAAE,EAAE,CAAC;CAC1B;AAED,6BAA6B;AAC7B,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AA8FD,sEAAsE;AACtE,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,eAAe,GAAG,QAAQ,CA6BpG;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAKnE;AAID,sCAAsC;AACtC,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AA+BD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,QAAQ,EAAE,CAOpF"}

package/dist/{table.js → table/TableDef.js}

@@ -1,8 +1,7 @@
 import { Lifecycle, Role } from '@fougere/schema';
-/** Entity → table description, with no SQL in sight. */
 import { Shapes, lowerFirst } from '@fougere/schema';
-import { boundsOf } from './check.js';
-import { sqlEntries } from './fields.js';
+import { boundsOf } from '../check.js';
+import { sqlEntries } from '../fields/SqlFields.js';
 /** camelCase → snake_case */
 export function toSnakeCase(str) {
     return str.replace(/[A-Z]/g, (letter) => `_${letter.toLowerCase()}`);
@@ -177,4 +176,4 @@ export function toTables(app, resolve) {
     return entries.map((entry) => toTable(resolve(entry.name), entry.entityClass, { resolve, tableNameOf, hosted }));
 }
 // ─── Ordering — a referenced table before its referrer ─────────────────────
-//# sourceMappingURL=table.js.map
+//# sourceMappingURL=TableDef.js.map

package/dist/table/TableDef.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fougere/adapter-sql",
-  "version": "0.9.3-alpha.0",
+  "version": "0.11.0-alpha.0",
   "description": "Entity → SQL tables through Kysely (SQLite, PostgreSQL, MySQL, SQL Server).",
   "keywords": [
     "fougere",
@@ -28,8 +28,8 @@
       "import": "./dist/index.js"
     },
     "./sqlite": {
-      "types": "./dist/sqlite.d.ts",
-      "import": "./dist/sqlite.js"
+      "types": "./dist/sqlite/index.d.ts",
+      "import": "./dist/sqlite/index.js"
     }
   },
   "files": [
@@ -39,8 +39,8 @@
   "dependencies": {
     "better-sqlite3": "^13.0.3",
     "dequal": "^2.0.3",
-    "@fougere/core": "0.9.3-alpha.0",
-    "@fougere/schema": "0.9.3-alpha.0"
+    "@fougere/core": "0.11.0-alpha.0",
+    "@fougere/schema": "0.11.0-alpha.0"
   },
   "peerDependencies": {
     "kysely": ">=0.28.17"
@@ -49,7 +49,7 @@
     "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^22.0.0",
     "kysely": "^0.28.17",
-    "@fougere/core": "0.9.3-alpha.0"
+    "@fougere/core": "0.11.0-alpha.0"
   },
   "publishConfig": {
     "access": "public"

package/src/check.ts

@@ -1,6 +1,6 @@
 /** Shape → CHECK constraints. */
 import { sql, type Expression, type SqlBool } from 'kysely';
-import type { ColumnDef } from './table.js';
+import type { ColumnDef } from './table/ColumnDef.js';
 
 /** What a column's shape can be checked for, beyond its type. */
 export interface ShapeBounds {

package/src/{crud.ts → crud/SqlStorage.ts}

@@ -1,13 +1,12 @@
 import { Lifecycle, Role } from '@fougere/schema';
-/** SqlStorage — per-entity storage over Kysely, one implementation for every engine. */
 import { sql, type Kysely } from 'kysely';
 import { applyCreate, applyUpdate, type Fields, type SchemaView } from '@fougere/schema';
-import { toTable, toTableName, type TableDef } from './table.js';
-import { resolveDialect, type Dialect, type DialectName } from './dialect.js';
-// The contract entry and not the main one: `FougereError` crosses a process boundary and
-// lives there for that reason, and this package must not drag the boot to raise one.
+import { toTable, toTableName, type TableDef } from '../table/TableDef.js';
+import { resolveDialect, type Dialect } from '../dialect/Dialect.js';
+import { type DialectName } from '../dialect/DialectName.js';
 import { comparisonOf, comparisonsIn, ErrorCode, FougereError, type Comparison } from '@fougere/core/contract';
-import { codecsOf, type ValueCodec } from './values.js';
+import { codecsOf, type ValueCodec } from '../values.js';
+import type { StorageFactoryOptions } from './StorageFactoryOptions.js';
 
 /** ListOptions — duplicated from @fougere/core to avoid a runtime dep. */
 interface ListOptions {
@@ -169,7 +168,7 @@ export class SqlStorage {
   // A criterion may name a SET — `where: { id: [a, b, c] }` is `IN`, one query for a
   // whole page. Without it a relation had no batch form at all: the GraphQL `one`
   // resolver read row by row (50 calls for a page of 50, measured), while its `many`
-  // dual already went through this same door. An empty set matches nothing, said in
+  // dual already went through this same facade. An empty set matches nothing, said in
   // SQL rather than by returning the whole table.
   private whereAll<Q extends { where(a: any, b: any, c: any): Q }>(query: Q, criteria: Record<string, unknown>): Q {
     return Object.entries(criteria).reduce((q, [key, value]) => {
@@ -518,12 +517,6 @@ export class SqlStorage {
   }
 }
 
-
-export interface StorageFactoryOptions {
-  /** Override table name resolution. Default: camelCase → snake_case + 's'. */
-  tableName?: (entityName: string) => string;
-}
-
 /** Create a StorageFactory backed by Kysely — same call shape on every engine. */
 export function createStorageFactory(db: Kysely<any>, options?: StorageFactoryOptions, dialect: DialectName = 'sqlite') {
   const resolve = options?.tableName ?? toTableName;

package/src/crud/StorageFactoryOptions.ts

@@ -0,0 +1,4 @@
+export interface StorageFactoryOptions {
+  /** Override table name resolution. Default: camelCase → snake_case + 's'. */
+  tableName?: (entityName: string) => string;
+}

package/src/ddl/GenerateOptions.ts

@@ -0,0 +1,8 @@
+import { type DialectName } from '../dialect/DialectName.js';
+
+export interface GenerateOptions {
+  /** Override table name resolution. Default: camelCase → snake_case + 's'. */
+  tableName?: (entityName: string) => string;
+  /** Target engine. Default: sqlite. */
+  dialect?: DialectName;
+}

package/src/{ddl.ts → ddl/SqlSink.ts}

@@ -1,4 +1,3 @@
-/** DDL — the table description, rendered as SQL. */
 import {
   Kysely,
   DummyDriver,
@@ -8,19 +7,14 @@ import {
   MysqlAdapter, MysqlQueryCompiler, MysqlIntrospector,
   MssqlAdapter, MssqlQueryCompiler, MssqlIntrospector,
 } from 'kysely';
-import {
-  isKeyed,
-  toTableName,
-  toTables,
-  type AppLike,
-  type ColumnDef,
-  type TableDef,
-} from './table.js';
-import { orderTables } from './order.js';
-import { columnTypeFor, resolveDialect, type DialectName } from './dialect.js';
-import { checkFor } from './check.js';
-
-// ─── Compile-only engines ──────────────────────────
+import { type AppLike } from '../table/AppLike.js';
+import { type ColumnDef } from '../table/ColumnDef.js';
+import { isKeyed, toTableName, toTables, type TableDef } from '../table/TableDef.js';
+import { orderTables } from '../order/TableOrder.js';
+import { columnTypeFor, resolveDialect } from '../dialect/Dialect.js';
+import { type DialectName } from '../dialect/DialectName.js';
+import { checkFor } from '../check.js';
+import type { GenerateOptions } from './GenerateOptions.js';
 
 const parts = {
   sqlite: [SqliteAdapter, SqliteQueryCompiler, SqliteIntrospector],
@@ -139,13 +133,6 @@ export function addForeignKeyConstraintSQL(table: TableDef, column: ColumnDef, d
 
 // ─── App-wide generation ───────────────────────────
 
-export interface GenerateOptions {
-  /** Override table name resolution. Default: camelCase → snake_case + 's'. */
-  tableName?: (entityName: string) => string;
-  /** Target engine. Default: sqlite. */
-  dialect?: DialectName;
-}
-
 /**
  * `CREATE TABLE` for every entity the app hosts — scanned frond entities plus auth runtime
  * entities when present.

package/src/{dialect.ts → dialect/Dialect.ts}

@@ -1,7 +1,5 @@
-/** Dialect — the only place that speaks SQL. */
-import type { ColumnDef } from './table.js';
-
-export type DialectName = 'sqlite' | 'pg' | 'mysql' | 'mssql';
+import type { ColumnDef } from '../table/ColumnDef.js';
+import type { DialectName } from './DialectName.js';
 
 export interface Dialect {
   name: DialectName;

package/src/dialect/DialectName.ts

@@ -0,0 +1 @@
+export type DialectName = 'sqlite' | 'pg' | 'mysql' | 'mssql';

package/src/{diff.ts → diff/Change.ts}

@@ -1,20 +1,14 @@
-/** Diff — what the database is missing, compared to what the entities describe. */
 import { sql, type Kysely } from 'kysely';
-import { addForeignKeyConstraintSQL, compiler, createTableSQL, indexSQL, type GenerateOptions } from './ddl.js';
-import { checkFor } from './check.js';
-import { columnTypeFor, resolveDialect, type DialectName } from './dialect.js';
-import {
-  isKeyed,
-  toTables,
-  toTableName,
-  type AppLike,
-  type ColumnDef,
-  type TableDef,
-} from './table.js';
-import { orderTables } from './order.js';
-
-/** What the database actually holds: column names per table. */
-export type SchemaState = Map<string, Set<string>>;
+import { type GenerateOptions } from '../ddl/GenerateOptions.js';
+import { addForeignKeyConstraintSQL, compiler, createTableSQL, indexSQL } from '../ddl/SqlSink.js';
+import { checkFor } from '../check.js';
+import { columnTypeFor, resolveDialect } from '../dialect/Dialect.js';
+import { type DialectName } from '../dialect/DialectName.js';
+import { type AppLike } from '../table/AppLike.js';
+import { type ColumnDef } from '../table/ColumnDef.js';
+import { isKeyed, toTableName, toTables, type TableDef } from '../table/TableDef.js';
+import { orderTables } from '../order/TableOrder.js';
+import type { SchemaState } from './SchemaState.js';
 
 /** Read the live schema. Only names are needed — an additive pass never inspects types. */
 export async function actualState(db: Kysely<any>): Promise<SchemaState> {

package/src/diff/SchemaState.ts

@@ -0,0 +1,13 @@
+import type { Kysely } from 'kysely';
+/** 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 async function actualState(db: Kysely<any>): Promise<SchemaState> {
+  const state: SchemaState = 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;
+}

package/src/drift.ts

@@ -1,7 +1,7 @@
 /** What a table PROMISES and what it now holds, when the two stopped agreeing. */
 import type { Kysely } from 'kysely';
 
-import type { TableDef } from './table.js';
+import type { TableDef } from './table/TableDef.js';
 
 /** One column whose declaration moved and whose table did not follow. */
 export interface Drift {
@@ -58,7 +58,7 @@ export async function drift(db: Kysely<any>, desired: TableDef[]): Promise<Drift
           column: column.name,
           declared: 'required',
           held: 'nullable',
-          reason: 'the door refuses what the table would still accept',
+          reason: 'the facade refuses what the table would still accept',
         });
       }
     }

package/src/fields/Engine.ts

@@ -0,0 +1,4 @@
+import ENTRY_FORMAT from '../adapter.schema.json' with { type: 'json' };
+
+/** The engines the format names — the one list, read off the file that states it. */
+export type Engine = keyof typeof ENTRY_FORMAT.properties.columnType.properties;

package/src/fields/SqlField.ts

@@ -0,0 +1,6 @@
+import type { Engine } from './Engine.js';
+
+export interface SqlField {
+  /** The column type to emit, per engine. An engine absent here keeps the shape's own. */
+  readonly columnType?: Readonly<Partial<Record<Engine, string>>>;
+}

package/src/{fields.ts → fields/SqlFields.ts}

@@ -3,24 +3,19 @@
  * no engine and no column type, and must not learn one to let this exist.
  */
 import { AdapterFieldValidator, type Shape } from '@fougere/schema';
-import ENTRY_FORMAT from './adapter.schema.json' with { type: 'json' };
-import type { DialectName } from './dialect.js';
-
-/** The engines the format names — the one list, read off the file that states it. */
-type Engine = keyof typeof ENTRY_FORMAT.properties.columnType.properties;
+import ENTRY_FORMAT from '../adapter.schema.json' with { type: 'json' };
+import type { DialectName } from '../dialect/DialectName.js';
+import type { SqlField } from './SqlField.js';
+import type { Engine } from './Engine.js';
 
 /** What sql holds, addressed by field — the shape every augmentation of the registry takes. */
 export type SqlFields<K extends string> = Readonly<Partial<Record<K, SqlField>>>;
 
-export interface SqlField {
-  /** The column type to emit, per engine. An engine absent here keeps the shape's own. */
-  readonly columnType?: Readonly<Partial<Record<Engine, string>>>;
-}
-
 /** Judges what an entity states under `adapters.sql`, against the format this adapter ships. */
 export const sqlEntries = AdapterFieldValidator.of(ENTRY_FORMAT as Shape);
 
 type Assert<T extends true> = T;
+
 /** A fifth dialect does not compile until `adapter.schema.json` names it. */
 type _EnginesMatchDialects = Assert<
   [Exclude<DialectName, Engine>] extends [never] ? true : false

package/src/index.ts

@@ -1,30 +1,30 @@
-export { createTableSQL, generateSQL, autoMigrate, compiler } from './ddl.js';
-export { onQuery } from './query.js';
-export type { QueryEvent, QuerySink } from './query.js';
-export { toTable, toTables, toTableName, toSnakeCase } from './table.js';
-export { orderTables } from './order.js';
-export type {
-  EntityEntry,
-  FrondLike,
-  AppLike,
-} from './table.js';
-export {
-  columnTypeFor,
-  dialects,
-} from './dialect.js';
-export type { Dialect } from './dialect.js';
-export type { SqlField, SqlFields } from './fields.js';
-export { SqlStorage, createStorageFactory } from './crud.js';
+export { autoMigrate, compiler, createTableSQL, generateSQL } from './ddl/SqlSink.js';
+export { onQuery } from './query/QuerySink.js';
+export type { QueryEvent } from './query/QueryEvent.js';
+export type { QuerySink } from './query/QuerySink.js';
+export { toSnakeCase, toTable, toTableName, toTables } from './table/TableDef.js';
+export { orderTables } from './order/TableOrder.js';
+export type { AppLike } from './table/AppLike.js';
+export type { EntityEntry } from './table/EntityEntry.js';
+export type { FrondLike } from './table/FrondLike.js';
+export { columnTypeFor, dialects } from './dialect/Dialect.js';
+export type { Dialect } from './dialect/Dialect.js';
+export type { SqlField } from './fields/SqlField.js';
+export type { SqlFields } from './fields/SqlFields.js';
+export { SqlStorage, createStorageFactory } from './crud/SqlStorage.js';
 export { codecsOf } from './values.js';
 // The driver this package owns is NOT here: `better-sqlite3` is native and `node:fs` is a
 // builtin, and an index that re-exported them made the whole adapter unreachable from a
 // runtime that has neither. It lives at `@fougere/adapter-sql/sqlite`.
-export { createKyselySource } from './source.js';
-export type { SqlSource } from './source.js';
+export { createKyselySource } from './source/SqlSource.js';
+export type { SqlSource } from './source/SqlSource.js';
 export { drift } from './drift.js';
 export type { Drift } from './drift.js';
-export { actualState, desiredTables, delta, changeSQL, migrate } from './diff.js';
-export type { SchemaState, Change } from './diff.js';
+export { actualState } from './diff/SchemaState.js';
+export { changeSQL, delta, desiredTables, migrate } from './diff/Change.js';
+export type { Change } from './diff/Change.js';
+export type { SchemaState } from './diff/SchemaState.js';
 // The non-additive half — realised only from a step a human wrote down.
-export { planStep, collapseChain, applyStep } from './step.js';
-export type { Plan, StepChange } from './step.js';
+export { applyStep, collapseChain, planStep } from './step/Plan.js';
+export type { Plan } from './step/Plan.js';
+export type { StepChange } from './step/StepChange.js';

package/src/order/FkEdge.ts

@@ -0,0 +1,7 @@
+import type { ColumnDef } from '../table/ColumnDef.js';
+import type { TableDef } from '../table/TableDef.js';
+
+export interface FkEdge {
+  table: TableDef;
+  column: ColumnDef;
+}

package/src/{order.ts → order/TableOrder.ts}

@@ -1,13 +1,5 @@
-/**
- * In what order a batch of tables is created — the one question that reads a `TableDef` and
- * knows nothing above it: no entity, no axis, no schema.
- */
-import type { ColumnDef, TableDef } from './table.js';
-
-export interface FkEdge {
-  table: TableDef;
-  column: ColumnDef;
-}
+import type { TableDef } from '../table/TableDef.js';
+import type { FkEdge } from './FkEdge.js';
 
 export interface TableOrder {
   /** Tables in dependency order — a `ref()` target always precedes its referrer. */

package/src/query/QueryEvent.ts

@@ -0,0 +1,16 @@
+/** One statement this process ran, and what it cost. */
+export interface QueryEvent {
+  /** Which storage ran it — a process may open several (`sources:`). */
+  storage: string;
+  sql: string;
+  /** What it read or wrote, or the storage when the statement names no table. */
+  subject: string;
+  /** `select`, `insert`, `update`, `delete` — its first word, whatever that turns out to be. */
+  verb: string;
+  /** How MANY parameters, never their values. */
+  parameters: number;
+  /** Rounded to three decimals: a sub-microsecond statement reports 17 digits otherwise. */
+  ms: number;
+  failed: boolean;
+  at: number;
+}