@c9up/atlas 0.2.0 → 0.2.1

package/dist/schema/SchemaDumper.js

@@ -0,0 +1,365 @@
+/**
+ * Schema dumps (Adonis Lucid `schema:dump` / `SchemaDumper`). Serialise the live
+ * database's structure — every table's DDL plus the migration bookkeeping rows —
+ * into a `.sql` file and a `.meta.json` manifest, so a fresh database can be
+ * rebuilt from the dump instead of replaying the whole migration history.
+ *
+ * The migration runner consumes this via `migration:run --schema-path` /
+ * `migration:fresh --schema-path`: when a database has no applied migrations and
+ * a dump exists, it loads the dump, then runs only the migrations that postdate
+ * it (see {@link MigrationRunner.loadDump}).
+ *
+ *     const dumper = new SchemaDumper(db, { migrationsDir: 'database/migrations' })
+ *     await dumper.run()
+ *     if (dumper.error) throw dumper.error
+ *     console.log(dumper.result?.dumpPath, dumper.result?.metaPath)
+ */
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+import { listUserTables } from "./catalog.js";
+import { introspectTable } from "./introspect.js";
+/** Current time as an ISO string (extracted so tests can stub it). */
+function nowIso() {
+    return new Date().toISOString();
+}
+/** The manifest path for a dump `.sql` path (extension swapped for `.meta.json`). */
+export function schemaDumpManifestPath(dumpPath) {
+    return `${dumpPath.replace(/\.sql$/, "")}.meta.json`;
+}
+/** Structural guard for a manifest — no cast, `in`-narrowed field checks. */
+function isSchemaDumpManifest(v) {
+    return (typeof v === "object" &&
+        v !== null &&
+        "version" in v &&
+        v.version === 1 &&
+        "schemaTableName" in v &&
+        typeof v.schemaTableName === "string");
+}
+/**
+ * Read + validate a dump's manifest, or return `undefined` when it is missing.
+ * Throws on a present-but-malformed manifest (wrong `version`, missing fields)
+ * so a corrupt dump is caught rather than silently mis-loaded.
+ */
+export async function readSchemaDumpManifest(dumpPath) {
+    const metaPath = schemaDumpManifestPath(dumpPath);
+    let raw;
+    try {
+        raw = await fsp.readFile(metaPath, "utf8");
+    }
+    catch {
+        return undefined;
+    }
+    const parsed = JSON.parse(raw);
+    if (!isSchemaDumpManifest(parsed)) {
+        throw new Error(`Invalid schema-dump manifest at ${metaPath}: expected version 1 with a schemaTableName.`);
+    }
+    return parsed;
+}
+const pgQuote = (id) => `"${id}"`;
+/** Map a `pg_constraint.confupdtype`/`confdeltype` char to its SQL action. */
+function pgActionCode(code) {
+    switch (code) {
+        case "c":
+            return "CASCADE";
+        case "n":
+            return "SET NULL";
+        case "d":
+            return "SET DEFAULT";
+        case "r":
+            return "RESTRICT";
+        default:
+            return undefined; // 'a' NO ACTION (default) — omit
+    }
+}
+/**
+ * Render `CREATE TABLE` from introspected columns + primary key (Postgres dump).
+ * Pure — no DB access — so the assembly is unit-testable with fixture columns.
+ */
+export function renderPgCreateTable(table, columns) {
+    const cols = columns.map((c) => {
+        const notNull = c.nullable ? "" : " NOT NULL";
+        return `  ${pgQuote(c.name)} ${c.type}${notNull}`;
+    });
+    const pks = columns.filter((c) => c.primaryKey).map((c) => pgQuote(c.name));
+    if (pks.length > 0)
+        cols.push(`  PRIMARY KEY (${pks.join(", ")})`);
+    return `CREATE TABLE ${pgQuote(table)} (\n${cols.join(",\n")}\n);`;
+}
+/**
+ * Render an `ALTER TABLE … ADD CONSTRAINT … FOREIGN KEY` from an introspected
+ * {@link PgForeignKey} (Postgres dump). Pure — unit-testable. `ON UPDATE` /
+ * `ON DELETE` are emitted only when the rule is not the default `NO ACTION`.
+ */
+export function renderPgForeignKeyDdl(table, fk) {
+    const cols = fk.columns.map(pgQuote).join(", ");
+    const fcols = fk.foreignColumns.map(pgQuote).join(", ");
+    const nonDefault = (rule) => rule && rule.toUpperCase() !== "NO ACTION" ? rule.toUpperCase() : undefined;
+    const onUpdate = nonDefault(fk.onUpdate);
+    const onDelete = nonDefault(fk.onDelete);
+    return (`ALTER TABLE ${pgQuote(table)} ADD CONSTRAINT ${pgQuote(fk.name)} ` +
+        `FOREIGN KEY (${cols}) REFERENCES ${pgQuote(fk.foreignTable)} (${fcols})` +
+        (onUpdate ? ` ON UPDATE ${onUpdate}` : "") +
+        (onDelete ? ` ON DELETE ${onDelete}` : "") +
+        ";");
+}
+/**
+ * Dumps a database's schema to `{outputDir}/{connection}-schema.sql` and a
+ * `.meta.json` manifest. Errors are captured on `.error` (Lucid parity) rather
+ * than thrown, so a CLI can report cleanly; `.result` holds the output paths on
+ * success.
+ */
+export class SchemaDumper {
+    #db;
+    #options;
+    #result;
+    #error;
+    constructor(db, options = {}) {
+        this.#db = db;
+        this.#options = {
+            connectionName: options.connectionName ?? "default",
+            dumpPath: options.dumpPath,
+            outputDir: options.outputDir ?? "database/schema",
+            migrationsDir: options.migrationsDir ?? "",
+            schemaTableName: options.schemaTableName ?? "ream_migrations",
+            prune: options.prune ?? false,
+            generatedAt: options.generatedAt,
+        };
+    }
+    get result() {
+        return this.#result;
+    }
+    get error() {
+        return this.#error;
+    }
+    /** Resolved SQL dump file path — the explicit `dumpPath` or the default per-connection name. */
+    get dumpPath() {
+        return (this.#options.dumpPath ??
+            path.join(this.#options.outputDir, `${this.#options.connectionName}-schema.sql`));
+    }
+    /** Manifest path — the dump path with its extension swapped for `.meta.json`. */
+    get metaPath() {
+        return schemaDumpManifestPath(this.dumpPath);
+    }
+    async run() {
+        try {
+            const sql = await this.#buildDump();
+            const dumpPath = this.dumpPath;
+            const metaPath = this.metaPath;
+            await fsp.mkdir(path.dirname(dumpPath), { recursive: true });
+            await fsp.writeFile(dumpPath, sql);
+            const squashed = this.#options.prune ? await this.#prune() : [];
+            const manifest = {
+                version: 1,
+                connection: this.#options.connectionName,
+                dialect: this.#db.dialect,
+                dumpPath,
+                generatedAt: this.#options.generatedAt ?? nowIso(),
+                schemaTableName: this.#options.schemaTableName,
+                schemaVersionsTableName: null,
+                squashedMigrationNames: squashed,
+            };
+            await fsp.writeFile(metaPath, `${JSON.stringify(manifest, null, 2)}\n`);
+            this.#result = {
+                dumpPath,
+                metaPath,
+                tableCount: (sql.match(/CREATE TABLE/gi) ?? []).length,
+            };
+        }
+        catch (err) {
+            this.#error = err instanceof Error ? err : new Error(String(err));
+        }
+    }
+    /** Serialise DDL for every table (incl. the migrations table) + its bookkeeping rows. */
+    async #buildDump() {
+        const dialect = this.#db.dialect;
+        const header = "-- Generated by @c9up/atlas schema:dump — DO NOT EDIT.\n" +
+            `-- connection=${this.#options.connectionName} dialect=${dialect}\n\n`;
+        const ddl = await this.#dumpDdl(dialect);
+        const data = await this.#dumpMigrationRows();
+        return header + ddl + data;
+    }
+    /** Dialect-specific DDL for all tables (framework tables included, for the dump). */
+    async #dumpDdl(dialect) {
+        // The migration LOCK table is transient infrastructure, never schema — its
+        // presence in the dump would collide with the runner re-creating it.
+        const lockTable = `${this.#options.schemaTableName}_lock`;
+        if (dialect === "sqlite") {
+            // sqlite_master carries the exact CREATE statements (tables + indexes).
+            const rows = await this.#db.query("SELECT name, sql FROM sqlite_master " +
+                "WHERE sql IS NOT NULL AND name NOT LIKE 'sqlite_%' " +
+                "ORDER BY (type = 'table') DESC, name");
+            return `${rows
+                .filter((r) => r.sql && r.name !== lockTable)
+                .map((r) => `${r.sql};`)
+                .join("\n\n")}\n\n`;
+        }
+        const tables = (await listUserTables(this.#db, dialect, {
+            includeFrameworkTables: true,
+        })).filter((t) => t !== lockTable);
+        if (dialect === "mysql") {
+            // SHOW CREATE TABLE gives the exact DDL, indexes and constraints included.
+            const out = [];
+            for (const table of tables.sort()) {
+                let rows;
+                try {
+                    rows = await this.#db.query(`SHOW CREATE TABLE \`${table}\``);
+                }
+                catch {
+                    // The table vanished between listing and dumping (concurrent DDL) —
+                    // skip it, mirroring the postgres path (introspectTable → null).
+                    continue;
+                }
+                const create = rows[0]?.["Create Table"];
+                if (create)
+                    out.push(`${create};`);
+            }
+            return `${out.join("\n\n")}\n\n`;
+        }
+        // postgres: reconstruct from catalog introspection (Adonis Lucid introspects
+        // the connection — it does NOT shell out to pg_dump). Per table: CREATE
+        // TABLE (columns + PK) + foreign keys + CHECK constraints + indexes; then
+        // the schema's views. Proven against real PostgreSQL (podman) in
+        // schema-dump-pg.test.ts.
+        const out = [];
+        for (const table of tables.sort()) {
+            const columns = await introspectTable(this.#db, dialect, table);
+            if (!columns)
+                continue;
+            out.push(renderPgCreateTable(table, columns));
+            for (const fk of await this.#introspectPgForeignKeys(table)) {
+                out.push(renderPgForeignKeyDdl(table, fk));
+            }
+            // CHECK constraints — pg_get_constraintdef gives the exact `CHECK (...)`.
+            for (const chk of await this.#introspectPgChecks(table)) {
+                out.push(`ALTER TABLE ${pgQuote(table)} ADD CONSTRAINT ${pgQuote(chk.name)} ${chk.def};`);
+            }
+            // `indexdef` is the exact CREATE INDEX statement; pass it through.
+            for (const indexDef of await this.#introspectPgIndexes(table)) {
+                out.push(`${indexDef};`);
+            }
+        }
+        // Views + materialized views (schema-level, not in the base-table list).
+        for (const view of await this.#introspectPgViews()) {
+            const kind = view.materialized ? "MATERIALIZED VIEW" : "VIEW";
+            out.push(`CREATE ${kind} ${pgQuote(view.name)} AS\n${view.definition.replace(/;\s*$/, "")};`);
+        }
+        return `${out.join("\n\n")}\n\n`;
+    }
+    /**
+     * FK constraints for `table`, grouped per constraint (Postgres). Uses
+     * `pg_constraint` with `unnest(conkey, confkey) WITH ORDINALITY` so the local
+     * and foreign columns of a COMPOSITE FK are paired by position — the
+     * information_schema kcu×ccu join produces a cartesian product and mismaps
+     * multi-column keys.
+     */
+    async #introspectPgForeignKeys(table) {
+        const rows = await this.#db.query(
+        // ::text on every column — pg_catalog uses the `name` and `"char"` types
+        // which atlas's strict sqlx decode rejects as Option<String>.
+        `SELECT con.conname::text AS constraint_name,
+			        att.attname::text AS column_name,
+			        fatt.attname::text AS foreign_column,
+			        fcl.relname::text AS foreign_table,
+			        con.confupdtype::text AS update_type,
+			        con.confdeltype::text AS delete_type
+			 FROM pg_constraint con
+			 JOIN pg_class cl ON cl.oid = con.conrelid
+			 JOIN pg_class fcl ON fcl.oid = con.confrelid
+			 JOIN LATERAL unnest(con.conkey, con.confkey) WITH ORDINALITY
+			   AS keys(conkey, confkey, ord) ON true
+			 JOIN pg_attribute att
+			   ON att.attrelid = con.conrelid AND att.attnum = keys.conkey
+			 JOIN pg_attribute fatt
+			   ON fatt.attrelid = con.confrelid AND fatt.attnum = keys.confkey
+			 WHERE con.contype = 'f' AND cl.relname = $1
+			   AND cl.relnamespace = current_schema()::regnamespace
+			 ORDER BY con.conname, keys.ord`, [table]);
+        const byName = new Map();
+        for (const r of rows) {
+            const fk = byName.get(r.constraint_name) ?? {
+                name: r.constraint_name,
+                columns: [],
+                foreignTable: r.foreign_table,
+                foreignColumns: [],
+                onUpdate: pgActionCode(r.update_type),
+                onDelete: pgActionCode(r.delete_type),
+            };
+            fk.columns.push(r.column_name);
+            fk.foreignColumns.push(r.foreign_column);
+            byName.set(r.constraint_name, fk);
+        }
+        return [...byName.values()];
+    }
+    /** Non-primary index definitions for `table` (Postgres `pg_indexes.indexdef`). */
+    async #introspectPgIndexes(table) {
+        const rows = await this.#db.query(`SELECT i.indexdef FROM pg_indexes i
+			 WHERE i.schemaname = current_schema() AND i.tablename = $1
+			   AND NOT EXISTS (
+			     SELECT 1 FROM pg_constraint c
+			     WHERE c.conname = i.indexname AND c.contype = 'p'
+			   )
+			 ORDER BY i.indexname`, [table]);
+        return rows.map((r) => r.indexdef).filter((d) => Boolean(d));
+    }
+    /** CHECK constraints for `table` (Postgres) — `pg_get_constraintdef` is exact. */
+    async #introspectPgChecks(table) {
+        const rows = await this.#db.query(`SELECT con.conname::text AS name,
+			        pg_get_constraintdef(con.oid)::text AS def
+			 FROM pg_constraint con
+			 JOIN pg_class cl ON cl.oid = con.conrelid
+			 WHERE con.contype = 'c' AND cl.relname = $1
+			   AND cl.relnamespace = current_schema()::regnamespace
+			 ORDER BY con.conname`, [table]);
+        return rows.filter((r) => r.name && r.def);
+    }
+    /** Views + materialized views in the current schema (Postgres). */
+    async #introspectPgViews() {
+        const views = await this.#db.query(`SELECT viewname::text AS name, definition::text AS definition
+			 FROM pg_views WHERE schemaname = current_schema() ORDER BY viewname`);
+        const matviews = await this.#db.query(`SELECT matviewname::text AS name, definition::text AS definition
+			 FROM pg_matviews WHERE schemaname = current_schema() ORDER BY matviewname`);
+        return [
+            ...views.map((v) => ({ ...v, materialized: false })),
+            ...matviews.map((v) => ({ ...v, materialized: true })),
+        ].filter((v) => v.name && v.definition);
+    }
+    /** `INSERT` the applied-migration rows so the runner sees them as applied. */
+    async #dumpMigrationRows() {
+        const table = this.#options.schemaTableName;
+        let rows;
+        try {
+            rows = await this.#db.query(`SELECT name, batch FROM ${this.#quote(table)} ORDER BY id`);
+        }
+        catch {
+            // No bookkeeping table yet (nothing migrated) — nothing to record.
+            return "";
+        }
+        if (rows.length === 0)
+            return "";
+        const values = rows
+            .map((r) => `(${this.#literal(r.name)}, ${Number(r.batch)})`)
+            .join(",\n  ");
+        return `INSERT INTO ${this.#quote(table)} (name, batch) VALUES\n  ${values};\n`;
+    }
+    /** Delete every migration file and return the pruned names (`--prune`). */
+    async #prune() {
+        if (!this.#options.migrationsDir) {
+            throw new Error("schema:dump --prune requires a migrationsDir");
+        }
+        const entries = (await fsp.readdir(this.#options.migrationsDir))
+            .filter((f) => (f.endsWith(".ts") || f.endsWith(".js")) && !f.endsWith(".d.ts"))
+            .sort();
+        for (const file of entries) {
+            await fsp.rm(path.join(this.#options.migrationsDir, file));
+        }
+        return entries.map((f) => f.replace(/\.(ts|js)$/, ""));
+    }
+    #quote(id) {
+        return this.#db.dialect === "mysql" ? `\`${id}\`` : `"${id}"`;
+    }
+    /** Single-quote a string literal for the dump (doubling embedded quotes). */
+    #literal(value) {
+        return `'${value.replace(/'/g, "''")}'`;
+    }
+}
+//# sourceMappingURL=SchemaDumper.js.map

package/dist/schema/SchemaDumper.js.map

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

package/dist/schema/Seeder.d.ts

@@ -29,7 +29,15 @@ import type { DatabaseConnection } from "../BaseRepository.js";
  */
 export declare abstract class BaseSeeder {
     protected db: DatabaseConnection;
+    /**
+     * Environments this seeder is allowed to run in (Adonis Lucid
+     * `static environment`). When set, `runSeederDirectory({ environment })`
+     * skips it unless the current environment is listed. Unset = every env.
+     */
+    static environment?: string[];
     constructor(db: DatabaseConnection);
+    /** Alias of {@link db} — Adonis Lucid seeders expose the connection as `this.client`. */
+    protected get client(): DatabaseConnection;
     /** The seeder body. Should be idempotent — `repo.upsert(...)` is the recommended pattern. */
     abstract run(): Promise<void> | void;
 }
@@ -54,6 +62,11 @@ export declare function runSeeders(seeders: BaseSeeder[]): Promise<void>;
  * @implements Story 32.12
  */
 export declare function runSeederDirectory(dir: string, db: DatabaseConnection, options?: {
+    /** Run only these seeders, by base name OR full/relative file path (Lucid `--files`). */
     files?: readonly string[];
+    /** Sort files numerically (`2_x` before `10_x`) instead of lexicographically (Lucid `naturalSort`). */
+    naturalSort?: boolean;
+    /** The current environment — skips a seeder whose `static environment` excludes it (Lucid). */
+    environment?: string;
 }): Promise<string[]>;
 //# sourceMappingURL=Seeder.d.ts.map

package/dist/schema/Seeder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Seeder.d.ts","sourceRoot":"","sources":["../../src/schema/Seeder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAQ/D;;;;;GAKG;AACH,8BAAsB,UAAU;IAC/B,SAAS,CAAC,EAAE,EAAE,kBAAkB,CAAC;gBAErB,EAAE,EAAE,kBAAkB;IAIlC,6FAA6F;IAC7F,QAAQ,CAAC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CACpC;AAED,yDAAyD;AACzD,eAAO,MAAM,MAAM,mBAAa,CAAC;AAEjC;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAIrE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CACvC,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,kBAAkB,EACtB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GACrC,OAAO,CAAC,MAAM,EAAE,CAAC,CAqDnB"}
+{"version":3,"file":"Seeder.d.ts","sourceRoot":"","sources":["../../src/schema/Seeder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAKH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAQ/D;;;;;GAKG;AACH,8BAAsB,UAAU;IAC/B,SAAS,CAAC,EAAE,EAAE,kBAAkB,CAAC;IAEjC;;;;OAIG;IACH,MAAM,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;gBAElB,EAAE,EAAE,kBAAkB;IAIlC,yFAAyF;IACzF,SAAS,KAAK,MAAM,IAAI,kBAAkB,CAEzC;IAED,6FAA6F;IAC7F,QAAQ,CAAC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CACpC;AAED,yDAAyD;AACzD,eAAO,MAAM,MAAM,mBAAa,CAAC;AAEjC;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAIrE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CACvC,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,kBAAkB,EACtB,OAAO,CAAC,EAAE;IACT,yFAAyF;IACzF,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,uGAAuG;IACvG,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,+FAA+F;IAC/F,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB,GACC,OAAO,CAAC,MAAM,EAAE,CAAC,CAsEnB"}

package/dist/schema/Seeder.js

@@ -21,6 +21,7 @@
  * @implements MISS-4, Story 32.12
  */
 import * as fsp from "node:fs/promises";
+import * as path from "node:path";
 import { pathToFileURL } from "node:url";
 import { AtlasError } from "../errors.js";
 import { assertPathInsideBase, assertSafeName, pathExists, } from "../utils/safePath.js";
@@ -32,9 +33,19 @@ import { assertPathInsideBase, assertSafeName, pathExists, } from "../utils/safe
  */
 export class BaseSeeder {
     db;
+    /**
+     * Environments this seeder is allowed to run in (Adonis Lucid
+     * `static environment`). When set, `runSeederDirectory({ environment })`
+     * skips it unless the current environment is listed. Unset = every env.
+     */
+    static environment;
     constructor(db) {
         this.db = db;
     }
+    /** Alias of {@link db} — Adonis Lucid seeders expose the connection as `this.client`. */
+    get client() {
+        return this.db;
+    }
 }
 /** Legacy alias kept for code using the previous API. */
 export const Seeder = BaseSeeder;
@@ -66,11 +77,16 @@ export async function runSeederDirectory(dir, db, options) {
             hint: "Create the directory or adjust the path passed to runSeederDirectory.",
         });
     }
-    const allFiles = (await fsp.readdir(dir))
-        .filter((f) => (f.endsWith(".ts") || f.endsWith(".js")) && !f.endsWith(".d.ts"))
-        .sort();
-    const selected = options?.files
-        ? allFiles.filter((f) => options.files?.includes(f.replace(/\.(ts|js)$/, "")))
+    const files = (await fsp.readdir(dir)).filter((f) => (f.endsWith(".ts") || f.endsWith(".js")) && !f.endsWith(".d.ts"));
+    // naturalSort compares embedded numbers by value; the default is lexicographic.
+    const allFiles = options?.naturalSort
+        ? files.sort((a, b) => a.localeCompare(b, undefined, { numeric: true, sensitivity: "base" }))
+        : files.sort();
+    // `--files` matches a base name (`UserSeeder`) OR a full/relative path
+    // (`database/seeders/UserSeeder.ts`) — take each entry's basename sans ext.
+    const wanted = options?.files?.map((f) => path.basename(f).replace(/\.(ts|js)$/, ""));
+    const selected = wanted
+        ? allFiles.filter((f) => wanted.includes(f.replace(/\.(ts|js)$/, "")))
         : allFiles;
     const executed = [];
     for (const file of selected) {
@@ -85,6 +101,13 @@ export async function runSeederDirectory(dir, db, options) {
                 hint: "Example: `export default class UserSeeder extends BaseSeeder { async run() { ... } }`",
             });
         }
+        // Skip a seeder whose `static environment` excludes the current one (Lucid).
+        const allowed = SeederClass.environment;
+        if (options?.environment &&
+            Array.isArray(allowed) &&
+            !allowed.includes(options.environment)) {
+            continue;
+        }
         const instance = new SeederClass(db);
         await instance.run();
         executed.push(file.replace(/\.(ts|js)$/, ""));

package/dist/schema/Seeder.js.map

@@ -1 +1 @@
-{"version":3,"file":"Seeder.js","sourceRoot":"","sources":["../../src/schema/Seeder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,GAAG,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EACN,oBAAoB,EACpB,cAAc,EACd,UAAU,GACV,MAAM,sBAAsB,CAAC;AAE9B;;;;;GAKG;AACH,MAAM,OAAgB,UAAU;IACrB,EAAE,CAAqB;IAEjC,YAAY,EAAsB;QACjC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACd,CAAC;CAID;AAED,yDAAyD;AACzD,MAAM,CAAC,MAAM,MAAM,GAAG,UAAU,CAAC;AAEjC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAqB;IACrD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC;IACpB,CAAC;AACF,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACvC,GAAW,EACX,EAAsB,EACtB,OAAuC;IAEvC,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,UAAU,CACnB,wBAAwB,EACxB,+BAA+B,GAAG,EAAE,EACpC;YACC,IAAI,EAAE,uEAAuE;SAC7E,CACD,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;SACvC,MAAM,CACN,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CACvE;SACA,IAAI,EAAE,CAAC;IAET,MAAM,QAAQ,GAAG,OAAO,EAAE,KAAK;QAC9B,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACtB,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,CACpD;QACF,CAAC,CAAC,QAAQ,CAAC;IAEZ,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC7B,cAAc,CAAC,IAAI,EAAE,kBAAkB,EAAE,QAAQ,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAC1C,GAAG,EACH,IAAI,EACJ,uBAAuB,EACvB,QAAQ,CACR,CAAC;QAEF,iEAAiE;QACjE,+DAA+D;QAC/D,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC;QACvD,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC;QAChC,IAAI,CAAC,WAAW,IAAI,OAAO,WAAW,KAAK,UAAU,EAAE,CAAC;YACvD,MAAM,IAAI,UAAU,CACnB,kBAAkB,EAClB,UAAU,IAAI,mDAAmD,EACjE;gBACC,IAAI,EAAE,uFAAuF;aAC7F,CACD,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAe,IAAI,WAAW,CAAC,EAAE,CAAC,CAAC;QACjD,MAAM,QAAQ,CAAC,GAAG,EAAE,CAAC;QACrB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,QAAQ,CAAC;AACjB,CAAC"}
+{"version":3,"file":"Seeder.js","sourceRoot":"","sources":["../../src/schema/Seeder.ts"],"names":[],"mappings":"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"}

package/dist/schema/TableBuilder.d.ts

@@ -161,9 +161,8 @@ export declare class TableBuilder {
      *     t.uuid('id').primary()                  // no DEFAULT
      *     // and at insert: db.insert({ id: crypto.randomUUID(), ... })
      *
-     * See `AUDIT-migration-templates.md` (shipped at the package root) for
-     * the full audit and the escape-hatch procedure if a future story makes
-     * the helper dialect-aware.
+     * (A dialect-aware escape hatch can be added later if a future story needs
+     * per-dialect PK defaults.)
      */
     id(): this;
     /**
@@ -185,11 +184,22 @@ export declare class TableBuilder {
      *     t.timestamp('updated_at').notNullable()
      *     // and at insert: db.insert({ created_at: new Date().toISOString(), ... })
      *
-     * See `AUDIT-migration-templates.md` (shipped at the package root) for
-     * the full audit and the escape-hatch procedure if a future story makes
-     * the helper dialect-aware.
+     * (A dialect-aware escape hatch can be added later if a future story needs
+     * per-dialect PK defaults.)
      */
-    timestamps(): this;
+    /**
+     * Add `created_at` / `updated_at` columns (Adonis Lucid / Knex
+     * `timestamps(useTimestamps, defaultToNow)`).
+     *
+     * - `useTimestamps` (default `true`): `timestamp` type; `false` → `dateTime`.
+     * - `defaultToNow` (default `true`): `NOT NULL DEFAULT CURRENT_TIMESTAMP`;
+     *   `false` → nullable, no default.
+     *
+     * The default uses `CURRENT_TIMESTAMP`, which every dialect understands —
+     * unlike `NOW()`, which SQLite rejects. So `timestamps()` and the Lucid
+     * `timestamps(true, true)` form both port to SQLite/Postgres/MySQL unchanged.
+     */
+    timestamps(useTimestamps?: boolean, defaultToNow?: boolean): this;
     notNullable(): this;
     nullable(): this;
     /**
@@ -200,7 +210,16 @@ export declare class TableBuilder {
     defaultTo(value: DefaultValue): this;
     /** MySQL `UNSIGNED` numeric modifier (Lucid `unsigned()`). No-op on pg/sqlite. */
     unsigned(): this;
-    references(table: string, column?: string): this;
+    /**
+     * Declare the current column a foreign key.
+     *
+     * - `references('users', 'id')` — atlas form `(table, column='id')`.
+     * - `references('users.id')` — Lucid/Knex dotted `'table.column'` shorthand, so
+     *   a migration copied from Lucid resolves the target the same way. A single
+     *   argument without a dot is treated as the table name (column defaults to
+     *   `id`), preserving the atlas one-arg behaviour.
+     */
+    references(tableOrPath: string, column?: string): this;
     /**
      * Referential action for the current column's foreign key `ON DELETE`
      * (Lucid parity). Must follow {@link references}.

package/dist/schema/TableBuilder.d.ts.map

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