@softure-ai/db 0.0.0-stage → 0.1.6

package/dist/migrations/introspect.js

@@ -0,0 +1,117 @@
+const NOT_IN_EXTENSION = (catalog, alias) => `NOT EXISTS (SELECT 1 FROM pg_depend dep WHERE dep.classid = '${catalog}'::regclass AND dep.objid = ${alias}.oid AND dep.deptype = 'e')`;
+const RELATION_KINDS = {
+    r: "table",
+    p: "partitioned table",
+    v: "view",
+    m: "materialized view",
+    S: "sequence",
+    f: "foreign table",
+};
+const QUERIES = {
+    relations: `
+    SELECT c.relname, c.relkind, c.relpersistence
+    FROM pg_class c JOIN pg_namespace n ON n.oid = c.relnamespace
+    WHERE n.nspname = $1 AND c.relkind IN ('r', 'p', 'v', 'm', 'S', 'f') AND ${NOT_IN_EXTENSION("pg_class", "c")}`,
+    columns: `
+    SELECT c.relname, a.attname, format_type(a.atttypid, a.atttypmod) AS type, a.attnotnull AS not_null,
+      CASE WHEN a.attcollation <> 0 AND a.attcollation <> t.typcollation THEN quote_ident(coll.collname) END AS collation,
+      pg_get_expr(d.adbin, d.adrelid) AS default_expr, a.attidentity AS identity, a.attgenerated AS generated
+    FROM pg_attribute a
+      JOIN pg_class c ON c.oid = a.attrelid
+      JOIN pg_namespace n ON n.oid = c.relnamespace
+      JOIN pg_type t ON t.oid = a.atttypid
+      LEFT JOIN pg_collation coll ON coll.oid = a.attcollation
+      LEFT JOIN pg_attrdef d ON d.adrelid = a.attrelid AND d.adnum = a.attnum
+    WHERE n.nspname = $1 AND c.relkind IN ('r', 'p', 'v', 'm', 'f', 'c') AND a.attnum > 0 AND NOT a.attisdropped
+      AND ${NOT_IN_EXTENSION("pg_class", "c")}`,
+    constraints: `
+    SELECT c.relname, con.conname, pg_get_constraintdef(con.oid, true) AS definition
+    FROM pg_constraint con
+      JOIN pg_class c ON c.oid = con.conrelid
+      JOIN pg_namespace n ON n.oid = c.relnamespace
+    WHERE n.nspname = $1 AND con.contype IN ('p', 'u', 'f', 'c', 'x')`,
+    indexes: `
+    SELECT i.relname, pg_get_indexdef(i.oid) AS definition
+    FROM pg_index x
+      JOIN pg_class i ON i.oid = x.indexrelid
+      JOIN pg_namespace n ON n.oid = i.relnamespace
+    WHERE n.nspname = $1 AND ${NOT_IN_EXTENSION("pg_class", "i")}`,
+    sequences: `
+    SELECT c.relname, format_type(s.seqtypid, NULL) AS type, s.seqstart::text AS start, s.seqincrement::text AS increment,
+      s.seqmin::text AS min, s.seqmax::text AS max, s.seqcache::text AS cache, s.seqcycle AS cycle
+    FROM pg_sequence s
+      JOIN pg_class c ON c.oid = s.seqrelid
+      JOIN pg_namespace n ON n.oid = c.relnamespace
+    WHERE n.nspname = $1 AND ${NOT_IN_EXTENSION("pg_class", "c")}`,
+    triggers: `
+    SELECT c.relname, t.tgname, pg_get_triggerdef(t.oid, true) AS definition
+    FROM pg_trigger t
+      JOIN pg_class c ON c.oid = t.tgrelid
+      JOIN pg_namespace n ON n.oid = c.relnamespace
+    WHERE n.nspname = $1 AND NOT t.tgisinternal`,
+    functions: `
+    SELECT p.proname || '(' || pg_get_function_identity_arguments(p.oid) || ')' AS signature,
+      md5(pg_get_functiondef(p.oid)) AS definition_hash
+    FROM pg_proc p JOIN pg_namespace n ON n.oid = p.pronamespace
+    WHERE n.nspname = $1 AND p.prokind IN ('f', 'p') AND ${NOT_IN_EXTENSION("pg_proc", "p")}`,
+    types: `
+    SELECT t.typname, t.typtype,
+      CASE t.typtype
+        WHEN 'r' THEN (SELECT format_type(r.rngsubtype, NULL) FROM pg_range r WHERE r.rngtypid = t.oid)
+        WHEN 'e' THEN (SELECT string_agg(e.enumlabel, ', ' ORDER BY e.enumsortorder) FROM pg_enum e WHERE e.enumtypid = t.oid)
+        WHEN 'd' THEN format_type(t.typbasetype, t.typtypmod)
+      END AS definition
+    FROM pg_type t JOIN pg_namespace n ON n.oid = t.typnamespace
+    WHERE n.nspname = $1 AND ${NOT_IN_EXTENSION("pg_type", "t")}
+      AND (t.typtype IN ('e', 'd', 'r')
+        OR (t.typtype = 'c' AND (SELECT c.relkind FROM pg_class c WHERE c.oid = t.typrelid) = 'c'))`,
+};
+const TYPE_KINDS = { e: "enum", d: "domain", r: "range", c: "composite type" };
+/** Every object of `schema` as one sorted line each. Runs in its own read-only transaction. */
+export async function describeSchema(session, schema) {
+    await session.exec("BEGIN READ ONLY; SET LOCAL search_path = pg_catalog;");
+    try {
+        const lines = [
+            ...(await session.query(QUERIES.relations, [schema])).map((row) => `${row.relpersistence === "u" ? "unlogged " : ""}${RELATION_KINDS[row.relkind] ?? row.relkind} ${schema}.${row.relname}`),
+            ...(await session.query(QUERIES.sequences, [schema])).map((row) => `sequence ${schema}.${row.relname}: ${row.type} start ${row.start} increment ${row.increment} min ${row.min} max ${row.max} cache ${row.cache}${row.cycle ? " cycle" : ""}`),
+            ...(await session.query(QUERIES.columns, [schema])).map((row) => describeColumn(schema, row)),
+            ...(await session.query(QUERIES.constraints, [schema])).map((row) => `constraint ${schema}.${row.relname}.${row.conname}: ${row.definition}`),
+            ...(await session.query(QUERIES.indexes, [schema])).map((row) => `index ${schema}.${row.relname}: ${row.definition}`),
+            ...(await session.query(QUERIES.triggers, [schema])).map((row) => `trigger ${schema}.${row.relname}.${row.tgname}: ${row.definition}`),
+            ...(await session.query(QUERIES.functions, [schema])).map((row) => `function ${schema}.${row.signature}: body ${row.definition_hash}`),
+            ...(await session.query(QUERIES.types, [schema])).map((row) => `${TYPE_KINDS[row.typtype] ?? row.typtype} ${schema}.${row.typname}${row.definition === null ? "" : `: ${row.definition}`}`),
+        ];
+        return lines.sort();
+    }
+    finally {
+        await session.exec("ROLLBACK");
+    }
+}
+/** What is in `expected` and not in `actual`, and the other way round, as readable lines. */
+export function diffSchemas(expected, actual) {
+    const actualSet = new Set(actual);
+    const expectedSet = new Set(expected);
+    return [
+        ...expected.filter((line) => !actualSet.has(line)).map((line) => `missing in database: ${line}`),
+        ...actual.filter((line) => !expectedSet.has(line)).map((line) => `unexpected in database: ${line}`),
+    ];
+}
+function describeColumn(schema, row) {
+    const parts = [`column ${schema}.${row.relname}.${row.attname} ${row.type}`];
+    if (row.collation !== null)
+        parts.push(`collate ${row.collation}`);
+    if (row.not_null)
+        parts.push("not null");
+    if (row.generated === "s" || row.generated === "v") {
+        parts.push(`generated as ${row.default_expr ?? ""}${row.generated === "s" ? " stored" : " virtual"}`);
+    }
+    else if (row.default_expr !== null) {
+        parts.push(`default ${row.default_expr}`);
+    }
+    if (row.identity === "a")
+        parts.push("identity always");
+    if (row.identity === "d")
+        parts.push("identity by default");
+    return parts.join(" ");
+}
+//# sourceMappingURL=introspect.js.map

package/dist/migrations/introspect.js.map

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

package/dist/migrations/ledger.d.ts

@@ -0,0 +1,27 @@
+import { type MigrationFile } from "./files.js";
+import type { MigrationSession } from "./session.js";
+export declare const LEDGER_MODULE_ID = "softure";
+export declare const LEDGER_SCHEMA = "softure";
+/** The ledger's own format version, recorded as `module_version` of its rows. */
+export declare const LEDGER_VERSION = "1.0.0";
+export declare const LEDGER_FILES: readonly MigrationFile[];
+export type MigrationMethod = "applied" | "adopted";
+export interface JournalRow {
+    readonly module: string;
+    readonly version: number;
+    readonly name: string;
+    readonly checksum: string;
+    readonly method: MigrationMethod;
+}
+export interface LedgerEntry {
+    readonly module: string;
+    readonly version: number;
+    readonly name: string;
+    readonly checksum: string;
+    readonly moduleVersion: string;
+    readonly method: MigrationMethod;
+}
+/** Every ledger row, or none while the ledger table does not exist yet. */
+export declare function readJournal(session: MigrationSession): Promise<JournalRow[]>;
+export declare function recordMigration(session: MigrationSession, entry: LedgerEntry): Promise<void>;
+//# sourceMappingURL=ledger.d.ts.map

package/dist/migrations/ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger.d.ts","sourceRoot":"","sources":["../../src/migrations/ledger.ts"],"names":[],"mappings":"AAOA,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAC1C,eAAO,MAAM,aAAa,YAAY,CAAC;AACvC,iFAAiF;AACjF,eAAO,MAAM,cAAc,UAAU,CAAC;AAwBtC,eAAO,MAAM,YAAY,EAAE,SAAS,aAAa,EAAwB,CAAC;AAE1E,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,SAAS,CAAC;AAEpD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;CAClC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;CAClC;AAED,2EAA2E;AAC3E,wBAAsB,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAQlF;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAKlG"}

package/dist/migrations/ledger.js

@@ -0,0 +1,45 @@
+// The migration ledger `softure.migrations` (docs/02-module-standard.md §4). It is owned by the
+// pseudo-module `softure` and created by its own migration, which ships as code so a bundled
+// runner needs no file for it. While the table does not exist the journal reads as empty, so the
+// first run bootstraps through the normal path.
+//
+// NEVER edit LEDGER_MIGRATION: deployed databases hold its checksum (a test pins it). A change to
+// the ledger is a new file, `0002_…`, appended to LEDGER_FILES.
+import { createMigrationFile } from "./files.js";
+export const LEDGER_MODULE_ID = "softure";
+export const LEDGER_SCHEMA = "softure";
+/** The ledger's own format version, recorded as `module_version` of its rows. */
+export const LEDGER_VERSION = "1.0.0";
+const LEDGER_MIGRATION = `-- Rollback: DROP SCHEMA softure CASCADE; this forgets which module migrations ran, the module schemas and their data stay.
+CREATE TABLE softure.migrations (
+  id bigint GENERATED ALWAYS AS IDENTITY UNIQUE,
+  module text NOT NULL CHECK (module ~ '^[a-z][a-z0-9]*(-[a-z0-9]+)*$'),
+  version integer NOT NULL CHECK (version > 0),
+  name text NOT NULL CHECK (name ~ '^[a-z0-9]+(_[a-z0-9]+)*$'),
+  checksum text NOT NULL CHECK (checksum ~ '^[0-9a-f]{64}$'),
+  module_version text NOT NULL,
+  method text NOT NULL CHECK (method IN ('applied', 'adopted')),
+  applied_at timestamptz NOT NULL DEFAULT now(),
+  PRIMARY KEY (module, version)
+);
+`;
+function createLedgerFiles() {
+    const file = createMigrationFile("0001_ledger.sql", LEDGER_MIGRATION);
+    if (typeof file === "string") {
+        throw new Error(`ledger: the built-in migration is invalid: ${file}`);
+    }
+    return [file];
+}
+export const LEDGER_FILES = createLedgerFiles();
+/** Every ledger row, or none while the ledger table does not exist yet. */
+export async function readJournal(session) {
+    const [table] = await session.query("SELECT to_regclass('softure.migrations') IS NOT NULL AS exists");
+    if (table?.exists !== true) {
+        return [];
+    }
+    return session.query("SELECT module, version, name, checksum, method FROM softure.migrations ORDER BY id");
+}
+export async function recordMigration(session, entry) {
+    await session.query("INSERT INTO softure.migrations (module, version, name, checksum, module_version, method) VALUES ($1, $2, $3, $4, $5, $6)", [entry.module, entry.version, entry.name, entry.checksum, entry.moduleVersion, entry.method]);
+}
+//# sourceMappingURL=ledger.js.map

package/dist/migrations/ledger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger.js","sourceRoot":"","sources":["../../src/migrations/ledger.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,6FAA6F;AAC7F,iGAAiG;AACjG,gDAAgD;AAChD,EAAE;AACF,kGAAkG;AAClG,gEAAgE;AAChE,OAAO,EAAE,mBAAmB,EAAsB,MAAM,YAAY,CAAC;AAGrE,MAAM,CAAC,MAAM,gBAAgB,GAAG,SAAS,CAAC;AAC1C,MAAM,CAAC,MAAM,aAAa,GAAG,SAAS,CAAC;AACvC,iFAAiF;AACjF,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAEtC,MAAM,gBAAgB,GAAG;;;;;;;;;;;;CAYxB,CAAC;AAEF,SAAS,iBAAiB;IACxB,MAAM,IAAI,GAAG,mBAAmB,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;IACtE,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,8CAA8C,IAAI,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAA6B,iBAAiB,EAAE,CAAC;AAqB1E,2EAA2E;AAC3E,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAyB;IACzD,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,KAAK,CAAsB,gEAAgE,CAAC,CAAC;IAC3H,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,OAAO,CAAC,KAAK,CAClB,oFAAoF,CACrF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAyB,EAAE,KAAkB;IACjF,MAAM,OAAO,CAAC,KAAK,CACjB,0HAA0H,EAC1H,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,CAC7F,CAAC;AACJ,CAAC"}

package/dist/migrations/migrator.d.ts

@@ -0,0 +1,97 @@
+import { type AnySoftureModule } from "@softure-ai/core";
+import type { DatabaseHandle } from "../client.js";
+import { type MigrationUnit } from "./apply.js";
+import { type JournalRow } from "./ledger.js";
+import { type MigrationProblem, type MigrationResult } from "./problems.js";
+export { applyFile, recordAdoption, rollBack, withMigrationLock, type MigrationUnit } from "./apply.js";
+export interface MigrateOptions {
+    /** The enabled modules, in any order; dependencies are applied first. */
+    readonly modules: readonly AnySoftureModule[];
+    /**
+     * Read each module's files from `<migrationsDir>/<module id>/` instead of the module's own
+     * folder: the container path, where a bundle cannot locate package folders.
+     */
+    readonly migrationsDir?: URL;
+    /** Called after each file is committed, e.g. to print progress. */
+    readonly onApplied?: (step: MigrationStep) => void;
+    /** Called after each file a baseline recorded as adopted, e.g. to print progress. */
+    readonly onAdopted?: (step: MigrationStep) => void;
+    /**
+     * The app's own migrations around the module files, and its baseline. `planMigrations` runs no
+     * hook; it reads only the baseline.
+     */
+    readonly app?: AppMigrations;
+    /** Called after an app hook succeeded, e.g. to print progress. */
+    readonly onAppMigrated?: (phase: AppMigrationPhase) => void;
+}
+/**
+ * The app's own migration runner, called by `migrate` under the migration lock on every run (it
+ * must skip what it already applied, as drizzle's migrator does). A throw or rejection is reported
+ * as `db.app_migration_failed`.
+ */
+export type AppMigrationHook = (handle: DatabaseHandle) => Promise<void>;
+export interface AppMigrations {
+    /** Runs before the module files: app tables that module SQL references (normally the app's whole history). */
+    readonly before?: AppMigrationHook;
+    /** Runs after the module files: app migrations that reference tables a module creates. */
+    readonly after?: AppMigrationHook;
+    /**
+     * The module files the app's own history already creates: module id → the last such file (1..n).
+     * For a listed module the ledger has never seen, `migrate` compares the module's schema with
+     * files 1..n once `before` ran and records them as `adopted`, then applies the later files; an
+     * empty schema is migrated normally. Once the module is in the ledger the entry has no effect.
+     */
+    readonly baseline?: Readonly<Record<string, number>>;
+}
+export type AppMigrationPhase = "before" | "after";
+export interface MigrationStep {
+    readonly module: string;
+    readonly schema: string;
+    readonly version: number;
+    readonly name: string;
+    readonly checksum: string;
+}
+export interface MigrationPlan {
+    /** What `migrate` would apply, in order. */
+    readonly pending: readonly MigrationStep[];
+    /**
+     * The pending steps a baseline may adopt instead of applying: they are adopted when the module's
+     * schema already holds objects after `before` (which a plan does not run).
+     */
+    readonly baseline: readonly MigrationStep[];
+}
+export interface MigrationReport {
+    readonly applied: readonly MigrationStep[];
+    /** The files a baseline recorded as adopted, in order. */
+    readonly adopted: readonly MigrationStep[];
+    /** The app hooks that ran, in order. */
+    readonly app: readonly AppMigrationPhase[];
+}
+/** The dry run: what `migrate` would apply. Takes no lock and writes nothing. */
+export declare function planMigrations(handle: DatabaseHandle, options: MigrateOptions): Promise<MigrationResult<MigrationPlan>>;
+/**
+ * Applies every pending migration under the advisory lock: the ledger, `app.before`, the module
+ * files (adopting a baseline where it applies), then `app.after`. Nothing runs when a check fails.
+ */
+export declare function migrate(handle: DatabaseHandle, options: MigrateOptions): Promise<MigrationResult<MigrationReport>>;
+/** `through` must be a whole number from 1 to the unit's file count. */
+export declare function checkThrough(unit: MigrationUnit, through: number): MigrationProblem[];
+export declare function toStep(unit: MigrationUnit, file: MigrationUnit["files"][number]): MigrationStep;
+/**
+ * Runs one app hook alone under the migration lock (the CLI's `--adopt` runs `before` first, so the
+ * app migration that moves a table and the adoption are one command). Ok when there is no hook.
+ */
+export declare function runAppMigrations(handle: DatabaseHandle, app: AppMigrations, phase: AppMigrationPhase): Promise<MigrationResult<{
+    ran: boolean;
+}>>;
+/**
+ * Validates the module list and reads every file: the ledger first, then the modules with a
+ * schema in dependency order. Fails with every problem found.
+ */
+export declare function prepareUnits(modules: readonly AnySoftureModule[], migrationsDir: URL | undefined): Promise<MigrationResult<MigrationUnit[]>>;
+/** Checks applied files against the folder and lists the pending ones in run order. */
+export declare function compareJournal(units: readonly MigrationUnit[], journal: readonly JournalRow[]): {
+    problems: MigrationProblem[];
+    pending: MigrationStep[];
+};
+//# sourceMappingURL=migrator.d.ts.map

package/dist/migrations/migrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrator.d.ts","sourceRoot":"","sources":["../../src/migrations/migrator.ts"],"names":[],"mappings":"AAMA,OAAO,EAAiC,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAA+D,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAG7G,OAAO,EAA8E,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAC1H,OAAO,EAAY,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAKtF,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,QAAQ,EAAE,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAExG,MAAM,WAAW,cAAc;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC9C;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,GAAG,CAAC;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;IACnD,qFAAqF;IACrF,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;IACnD;;;OAGG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,aAAa,CAAC;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAC7D;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEzE,MAAM,WAAW,aAAa;IAC5B,8GAA8G;IAC9G,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IACnC,0FAA0F;IAC1F,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAClC;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACtD;AAED,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEnD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;IAC3C;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;IAC3C,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;IAC3C,wCAAwC;IACxC,QAAQ,CAAC,GAAG,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC5C;AAMD,iFAAiF;AACjF,wBAAsB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC,CAiB7H;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC,CA2ExH;AAwDD,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAKrF;AAgBD,wBAAgB,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,GAAG,aAAa,CAE/F;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,eAAe,CAAC;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC,CAM5C;AA2BD;;;GAGG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,SAAS,gBAAgB,EAAE,EACpC,aAAa,EAAE,GAAG,GAAG,SAAS,GAC7B,OAAO,CAAC,eAAe,CAAC,aAAa,EAAE,CAAC,CAAC,CA2B3C;AAED,uFAAuF;AACvF,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS,aAAa,EAAE,EAC/B,OAAO,EAAE,SAAS,UAAU,EAAE,GAC7B;IAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAAC,OAAO,EAAE,aAAa,EAAE,CAAA;CAAE,CA4B5D"}

package/dist/migrations/migrator.js

@@ -0,0 +1,301 @@
+// The module migrator (docs/02-module-standard.md §4). Every enabled module's SQL files run in the
+// module's own schema, dependencies first, one transaction per file together with its ledger row.
+// Everything that can be checked (names, numbering, checksums, order) is checked for all modules
+// before the first file runs, so a problem in one module never leaves another half-migrated.
+// The app's own migrations (drizzle's, usually) plug in through `app.before` / `app.after`, and
+// `app.baseline` names the module files the app's own history already creates (issue #152).
+import { ok, sortModulesByDependencies } from "@softure-ai/core";
+import { applyFile, describeError, recordAdoption, withMigrationLock } from "./apply.js";
+import { readMigrationFiles } from "./files.js";
+import { describeSchema, diffSchemas } from "./introspect.js";
+import { LEDGER_FILES, LEDGER_MODULE_ID, LEDGER_SCHEMA, LEDGER_VERSION, readJournal } from "./ledger.js";
+import { failWith } from "./problems.js";
+import { buildReferenceSchema, listOwnedSchemas } from "./reference.js";
+import { withSession } from "./session.js";
+import { readAppTables } from "./stubs.js";
+export { applyFile, recordAdoption, rollBack, withMigrationLock } from "./apply.js";
+// `drizzle` holds drizzle's own ledger (`drizzle.__drizzle_migrations`) in every app on this stack.
+const RESERVED_SCHEMAS = new Set([LEDGER_SCHEMA, "public", "information_schema", "drizzle"]);
+const MAX_IDENTIFIER_BYTES = 63;
+/** The dry run: what `migrate` would apply. Takes no lock and writes nothing. */
+export async function planMigrations(handle, options) {
+    const units = await prepareUnits(options.modules, options.migrationsDir);
+    if (!units.ok) {
+        return units;
+    }
+    const baseline = options.app?.baseline ?? {};
+    const baselineProblems = checkBaseline(options.modules, units.value, baseline);
+    if (baselineProblems.length > 0) {
+        return failWith(baselineProblems);
+    }
+    const journal = await withSession(handle, readJournal);
+    const comparison = compareJournal(units.value, journal);
+    if (comparison.problems.length > 0) {
+        return failWith(comparison.problems);
+    }
+    const adoptable = comparison.pending.filter((step) => isBaselineStep(step, baseline, journal));
+    return ok({ pending: comparison.pending, baseline: adoptable });
+}
+/**
+ * Applies every pending migration under the advisory lock: the ledger, `app.before`, the module
+ * files (adopting a baseline where it applies), then `app.after`. Nothing runs when a check fails.
+ */
+export async function migrate(handle, options) {
+    const units = await prepareUnits(options.modules, options.migrationsDir);
+    if (!units.ok) {
+        return units;
+    }
+    const app = options.app ?? {};
+    const baseline = app.baseline ?? {};
+    const baselineProblems = checkBaseline(options.modules, units.value, baseline);
+    if (baselineProblems.length > 0) {
+        return failWith(baselineProblems);
+    }
+    return withSession(handle, (session) => withMigrationLock(session, async () => {
+        // Read after the lock: a runner that waited sees what the first one applied.
+        const journal = await readJournal(session);
+        const comparison = compareJournal(units.value, journal);
+        if (comparison.problems.length > 0) {
+            return failWith(comparison.problems);
+        }
+        const applied = [];
+        const adopted = [];
+        const ranHooks = [];
+        const applySteps = async (steps) => {
+            for (const step of steps) {
+                const { unit, file } = findFile(units.value, step);
+                const failure = await applyFile(session, { unit, file, method: "applied" });
+                if (failure !== null) {
+                    return failure;
+                }
+                applied.push(step);
+                options.onApplied?.(step);
+            }
+            return null;
+        };
+        const runHook = async (phase) => {
+            const failure = await runAppHook(handle, app, phase);
+            if (failure === null && app[phase] !== undefined) {
+                ranHooks.push(phase);
+                options.onAppMigrated?.(phase);
+            }
+            return failure;
+        };
+        // Unit by unit in dependency order, so a module's dependencies are migrated before its
+        // baseline is compared.
+        const migrateModules = async () => {
+            for (const unit of units.value) {
+                if (unit.module === LEDGER_MODULE_ID)
+                    continue;
+                const steps = comparison.pending.filter((step) => step.module === unit.module);
+                const through = baseline[unit.module];
+                if (through === undefined || journal.some((row) => row.module === unit.module)) {
+                    const failure = await applySteps(steps);
+                    if (failure !== null)
+                        return failure;
+                    continue;
+                }
+                const adoption = await adoptBaseline(session, { modules: options.modules, units: units.value, unit, through });
+                if (adoption.problem !== null)
+                    return adoption.problem;
+                for (const step of adoption.adopted) {
+                    adopted.push(step);
+                    options.onAdopted?.(step);
+                }
+                const failure = await applySteps(steps.filter((step) => !adoption.adopted.some((done) => done.version === step.version)));
+                if (failure !== null)
+                    return failure;
+            }
+            return null;
+        };
+        // The ledger first, so it exists whatever a hook does; then before, the modules, after.
+        const ledgerSteps = comparison.pending.filter((step) => step.module === LEDGER_MODULE_ID);
+        const failure = (await applySteps(ledgerSteps)) ?? (await runHook("before")) ?? (await migrateModules()) ?? (await runHook("after"));
+        if (failure !== null) {
+            return failWith([failure]);
+        }
+        return ok({ applied, adopted, app: ranHooks });
+    }));
+}
+/**
+ * Adopt-or-migrate for a baseline module the ledger has never seen: an empty schema adopts
+ * nothing (its files are then applied normally); otherwise the schema must equal files 1..through,
+ * which are then recorded as adopted in one transaction.
+ */
+async function adoptBaseline(session, input) {
+    const { unit, through } = input;
+    const live = await describeSchema(session, unit.schema);
+    if (live.length === 0) {
+        return { adopted: [], problem: null };
+    }
+    // Built only here, so a database whose modules are all in the ledger never needs PGlite. The app's
+    // tables exist by now (`before` ran), so module SQL that references them finds their stubs.
+    const appTables = await readAppTables(session, listOwnedSchemas(input.units));
+    const reference = await buildReferenceSchema({ modules: input.modules, units: input.units, target: unit, through, appTables });
+    if (!reference.ok) {
+        return { adopted: [], problem: reference.problems[0] ?? null };
+    }
+    const differences = diffSchemas(reference.value, live);
+    if (differences.length > 0) {
+        return { adopted: [], problem: { code: "db.schema_mismatch", module: unit.module, schema: unit.schema, differences } };
+    }
+    const files = unit.files.filter((file) => file.version <= through);
+    const failure = await recordAdoption(session, unit, files);
+    if (failure !== null) {
+        return { adopted: [], problem: failure };
+    }
+    return { adopted: files.map((file) => toStep(unit, file)), problem: null };
+}
+/**
+ * A baseline may name only enabled modules with a schema and migrations, and a last file between
+ * 1 and the module's file count. Checked before anything runs.
+ */
+function checkBaseline(modules, units, baseline) {
+    return Object.entries(baseline).flatMap(([module, through]) => {
+        if (!modules.some((candidate) => candidate.id === module)) {
+            return [{ code: "db.adopt_unknown_module", module }];
+        }
+        const unit = units.find((candidate) => candidate.module === module);
+        if (unit === undefined) {
+            return [{ code: "db.adopt_no_schema", module }];
+        }
+        return checkThrough(unit, through);
+    });
+}
+/** `through` must be a whole number from 1 to the unit's file count. */
+export function checkThrough(unit, through) {
+    const files = unit.files.length;
+    return Number.isInteger(through) && through >= 1 && through <= files
+        ? []
+        : [{ code: "db.adopt_through_out_of_range", module: unit.module, through, files }];
+}
+function isBaselineStep(step, baseline, journal) {
+    const through = baseline[step.module];
+    return through !== undefined && step.version <= through && !journal.some((row) => row.module === step.module);
+}
+function findFile(units, step) {
+    const unit = units.find((candidate) => candidate.module === step.module);
+    const file = unit?.files.find((candidate) => candidate.version === step.version);
+    if (unit === undefined || file === undefined) {
+        throw new Error(`migrate: step ${step.module} ${step.version} has no file; compareJournal is broken`);
+    }
+    return { unit, file };
+}
+export function toStep(unit, file) {
+    return { module: unit.module, schema: unit.schema, version: file.version, name: file.name, checksum: file.checksum };
+}
+/**
+ * Runs one app hook alone under the migration lock (the CLI's `--adopt` runs `before` first, so the
+ * app migration that moves a table and the adoption are one command). Ok when there is no hook.
+ */
+export async function runAppMigrations(handle, app, phase) {
+    if (app[phase] === undefined) {
+        return ok({ ran: false });
+    }
+    const failure = await withSession(handle, (session) => withMigrationLock(session, () => runAppHook(handle, app, phase)));
+    return failure === null ? ok({ ran: true }) : failWith([failure]);
+}
+async function runAppHook(handle, app, phase) {
+    const hook = app[phase];
+    if (hook === undefined) {
+        return null;
+    }
+    try {
+        await hook(handle);
+        return null;
+    }
+    catch (error) {
+        return { code: "db.app_migration_failed", phase, reason: describeErrorChain(error) };
+    }
+}
+// drizzle wraps the database error (`Failed query: <sql>`, the Postgres message in `cause`), so the
+// whole chain is the reason.
+function describeErrorChain(error) {
+    const messages = [];
+    let current = error;
+    while (current !== undefined && current !== null && messages.length < 5) {
+        messages.push(describeError(current));
+        current = current instanceof Error ? current.cause : undefined;
+    }
+    return messages.join(": ");
+}
+/**
+ * Validates the module list and reads every file: the ledger first, then the modules with a
+ * schema in dependency order. Fails with every problem found.
+ */
+export async function prepareUnits(modules, migrationsDir) {
+    const problems = modules.flatMap(checkModule);
+    const sorted = sortModulesByDependencies(modules);
+    if (!sorted.ok) {
+        problems.push({ code: "db.dependency_cycle", modules: modules.map((module) => module.id) });
+    }
+    if (problems.length > 0 || !sorted.ok) {
+        return failWith(problems);
+    }
+    const units = [
+        { module: LEDGER_MODULE_ID, schema: LEDGER_SCHEMA, moduleVersion: LEDGER_VERSION, files: LEDGER_FILES },
+    ];
+    for (const module of sorted.value) {
+        const schema = module.manifest.dbSchema;
+        if (schema === null || module.migrations === null) {
+            continue;
+        }
+        const dir = migrationsDir === undefined ? module.migrations.dir : new URL(`${module.id}/`, ensureFolderUrl(migrationsDir));
+        const files = await readMigrationFiles(module.id, dir);
+        if (files.ok) {
+            units.push({ module: module.id, schema, moduleVersion: module.manifest.version, files: files.value });
+        }
+        else {
+            problems.push(...files.problems);
+        }
+    }
+    return problems.length > 0 ? failWith(problems) : ok(units);
+}
+/** Checks applied files against the folder and lists the pending ones in run order. */
+export function compareJournal(units, journal) {
+    const problems = [];
+    const pending = [];
+    for (const unit of units) {
+        const rows = journal.filter((row) => row.module === unit.module);
+        const appliedVersions = new Set(rows.map((row) => row.version));
+        const lastApplied = Math.max(0, ...rows.map((row) => row.version));
+        for (const row of rows) {
+            const file = unit.files.find((candidate) => candidate.version === row.version);
+            if (file === undefined) {
+                problems.push({ code: "db.migration_missing", module: unit.module, version: row.version, name: row.name });
+            }
+            else if (file.checksum !== row.checksum || file.name !== row.name) {
+                problems.push({ code: "db.migration_changed", module: unit.module, version: row.version, name: row.name });
+            }
+        }
+        for (const file of unit.files) {
+            if (appliedVersions.has(file.version)) {
+                continue;
+            }
+            if (file.version < lastApplied) {
+                problems.push({ code: "db.migration_out_of_order", module: unit.module, version: file.version, appliedVersion: lastApplied });
+            }
+            else {
+                pending.push({ module: unit.module, schema: unit.schema, version: file.version, name: file.name, checksum: file.checksum });
+            }
+        }
+    }
+    return { problems, pending };
+}
+function checkModule(module) {
+    const schema = module.manifest.dbSchema;
+    if (module.id === LEDGER_MODULE_ID || (schema !== null && isReservedSchema(schema))) {
+        return [{ code: "db.reserved_module", module: module.id }];
+    }
+    if (schema === null && module.migrations !== null) {
+        return [{ code: "db.migrations_without_schema", module: module.id }];
+    }
+    return [];
+}
+function isReservedSchema(schema) {
+    return RESERVED_SCHEMAS.has(schema) || schema.startsWith("pg_") || Buffer.byteLength(schema, "utf8") > MAX_IDENTIFIER_BYTES;
+}
+function ensureFolderUrl(url) {
+    return url.href.endsWith("/") ? url : new URL(`${url.href}/`);
+}
+//# sourceMappingURL=migrator.js.map

package/dist/migrations/migrator.js.map

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