@c9up/atlas 0.2.0 → 0.2.1

package/dist/console/schemaDumpCommand.js

@@ -0,0 +1,69 @@
+/**
+ * `schema:dump` — serialise the live database's schema to a `.sql` dump + a
+ * `.meta.json` manifest (Adonis Lucid `schema:dump` / `SchemaDumper`), so a
+ * fresh database can be rebuilt from the dump via `migration:run --schema-path`
+ * instead of replaying every migration.
+ *
+ * @example
+ *   // commands/schema-dump.ts
+ *   import { schemaDumpCommand } from '@c9up/atlas'
+ *   export default schemaDumpCommand({ migrationsDir: 'database/migrations' })
+ *   // run:  <console-entry> schema:dump            → database/schema/default-schema.sql
+ *          //                 schema:dump --prune   → also squashes the migration files
+ */
+import { SchemaDumper } from "../schema/SchemaDumper.js";
+import { getConnection, getDb } from "../services/db.js";
+import { flag } from "./contract.js";
+/** `schema:dump` — dump the schema; `--prune` squashes migrations, `--connection` targets one. */
+export function schemaDumpCommand(options = {}) {
+    return class SchemaDump {
+        static commandName = "schema:dump";
+        static description = "Dump the database schema to a .sql file + manifest (--prune, --connection, --path)";
+        static options = { startApp: true };
+        static flags = [
+            flag("connection", "string", {
+                description: "Named connection to dump (defaults to the primary one)",
+            }),
+            flag("prune", "boolean", {
+                description: "Squash the migrations the dump replaces",
+            }),
+            flag("path", "string", {
+                description: "Destination .sql file (not a directory)",
+            }),
+        ];
+        async run() {
+            const connName = this.connection;
+            const db = connName ? getConnection(connName) : getDb();
+            if (!db) {
+                console.error(connName
+                    ? `[atlas] no connection registered under '${connName}'`
+                    : "[atlas] no database connection — is AtlasProvider registered?");
+                process.exitCode = 1;
+                return;
+            }
+            // Typed by the kernel now — no string/boolean coercion to redo here.
+            const prune = this.prune === true;
+            // `--path <file>` is the SQL dump FILE path (Adonis Lucid), not a dir.
+            const dumpPath = this.path;
+            const dumper = new SchemaDumper(db, {
+                connectionName: connName ?? "default",
+                dumpPath,
+                outputDir: options.outputDir,
+                migrationsDir: options.migrationsDir,
+                schemaTableName: options.schemaTableName,
+                prune,
+                generatedAt: options.generatedAt,
+            });
+            await dumper.run();
+            if (dumper.error) {
+                console.error(`[atlas] schema:dump failed: ${dumper.error.message}`);
+                process.exitCode = 1;
+                return;
+            }
+            const r = dumper.result;
+            console.log(`Dumped ${r?.tableCount ?? 0} table(s) → ${r?.dumpPath}` +
+                (prune ? " (migrations squashed)" : ""));
+        }
+    };
+}
+//# sourceMappingURL=schemaDumpCommand.js.map

package/dist/console/schemaDumpCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaDumpCommand.js","sourceRoot":"","sources":["../../src/console/schemaDumpCommand.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAA0B,IAAI,EAAE,MAAM,eAAe,CAAC;AAgB7D,kGAAkG;AAClG,MAAM,UAAU,iBAAiB,CAChC,UAAoC,EAAE;IAEtC,OAAO,MAAM,UAAU;QACtB,MAAM,CAAC,WAAW,GAAG,aAAa,CAAC;QACnC,MAAM,CAAC,WAAW,GACjB,oFAAoF,CAAC;QACtF,MAAM,CAAC,OAAO,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACpC,MAAM,CAAC,KAAK,GAAG;YACd,IAAI,CAAC,YAAY,EAAE,QAAQ,EAAE;gBAC5B,WAAW,EAAE,wDAAwD;aACrE,CAAC;YACF,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE;gBACxB,WAAW,EAAE,yCAAyC;aACtD,CAAC;YACF,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE;gBACtB,WAAW,EAAE,yCAAyC;aACtD,CAAC;SACF,CAAC;QAMF,KAAK,CAAC,GAAG;YACR,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC;YACjC,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;YACxD,IAAI,CAAC,EAAE,EAAE,CAAC;gBACT,OAAO,CAAC,KAAK,CACZ,QAAQ;oBACP,CAAC,CAAC,2CAA2C,QAAQ,GAAG;oBACxD,CAAC,CAAC,+DAA+D,CAClE,CAAC;gBACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;gBACrB,OAAO;YACR,CAAC;YACD,qEAAqE;YACrE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC;YAClC,uEAAuE;YACvE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC;YAC3B,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,EAAE,EAAE;gBACnC,cAAc,EAAE,QAAQ,IAAI,SAAS;gBACrC,QAAQ;gBACR,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,aAAa,EAAE,OAAO,CAAC,aAAa;gBACpC,eAAe,EAAE,OAAO,CAAC,eAAe;gBACxC,KAAK;gBACL,WAAW,EAAE,OAAO,CAAC,WAAW;aAChC,CAAC,CAAC;YACH,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC;YACnB,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBAClB,OAAO,CAAC,KAAK,CAAC,+BAA+B,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;gBACrE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;gBACrB,OAAO;YACR,CAAC;YACD,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;YACxB,OAAO,CAAC,GAAG,CACV,UAAU,CAAC,EAAE,UAAU,IAAI,CAAC,eAAe,CAAC,EAAE,QAAQ,EAAE;gBACvD,CAAC,KAAK,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,EAAE,CAAC,CACxC,CAAC;QACH,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/console/schemaGenerateCommand.d.ts

@@ -0,0 +1,100 @@
+/**
+ * `schema:generate` — database-first codegen (Adonis Lucid parity). Introspects
+ * the live database and writes a `schema.ts` file with one `BaseModel` subclass
+ * per table, mirroring Lucid's `schema:generate` → `database/schema.ts`.
+ *
+ * @example
+ *   // commands/schema-generate.ts
+ *   import { schemaGenerateCommand } from '@c9up/atlas'
+ *   export default schemaGenerateCommand({ outputPath: 'database/schema.ts' })
+ */
+import type { AsyncDatabaseConnection } from "../adapters/NapiDbAdapter.js";
+import { type IntrospectedColumn } from "../schema/introspect.js";
+import { type AtlasCommandClass } from "./contract.js";
+export interface SchemaGenerateOptions {
+    /** File to write the generated schema classes to (Lucid `outputPath`). */
+    outputPath: string;
+    /** Extra tables to skip (framework tables are always skipped). */
+    excludeTables?: string[];
+    /**
+     * When `false`, the `schema:generate` command and post-migration regeneration
+     * are both disabled (Adonis Lucid `schemaGeneration.enabled`). Any other value
+     * (incl. `undefined`) leaves generation on.
+     */
+    enabled?: boolean;
+    /**
+     * Paths to rule modules that customise how columns are emitted (Adonis Lucid
+     * `schemaGeneration.rulesPaths`). Each module default-exports a {@link SchemaRules}
+     * object; multiple files deep-merge, later paths overriding earlier ones.
+     */
+    rulesPaths?: string[];
+    /**
+     * Emit a denser file — no blank line between a class's `$columns` and its
+     * column declarations (Adonis Lucid `--compact-output`). Also settable per-run
+     * with the `--compact-output` flag.
+     */
+    compact?: boolean;
+    /**
+     * PostgreSQL only — restrict generation to these schemas (Adonis Lucid
+     * `schemaGeneration.schemas`). Ignored on sqlite/mysql. NOTE: the runtime
+     * behaviour is not yet proven against a live PostgreSQL in atlas's test env.
+     */
+    schemas?: string[];
+}
+/**
+ * Per-column override for schema generation (Adonis Lucid schema rules). A rule
+ * can force the TypeScript `tsType`, the `decorator`, and the `imports` the
+ * generated file needs for that type.
+ */
+export interface ColumnRule {
+    /** TypeScript type for the property (e.g. `"UserStatus"`). */
+    tsType?: string;
+    /** Full decorator string (e.g. `"@column()"`, `"@column({ isPrimary: true })"`). */
+    decorator?: string;
+    /** Imports the `tsType`/`decorator` needs, added to the generated file header. */
+    imports?: Array<{
+        source: string;
+        namedImports: string[];
+    }>;
+}
+/**
+ * Schema-generation rules (Adonis Lucid). Resolution is most-specific-first:
+ * `tables[table].columns[col]` > `columns[col]` > `types[rawType]`.
+ */
+export interface SchemaRules {
+    /** Rules keyed by column name, applied to that column on every table. */
+    columns?: Record<string, ColumnRule>;
+    /** Rules keyed by raw dialect type (lower-cased), applied by column type. */
+    types?: Record<string, ColumnRule>;
+    /** Table-scoped column rules, the highest-priority match. */
+    tables?: Record<string, {
+        columns?: Record<string, ColumnRule>;
+    }>;
+}
+/**
+ * Load + deep-merge the rule modules named by `rulesPaths` (later files win).
+ * Each module default-exports a {@link SchemaRules}; a module without a usable
+ * default export is skipped.
+ */
+export declare function loadSchemaRules(rulesPaths: string[] | undefined): Promise<SchemaRules>;
+/**
+ * Render the full `schema.ts` source from introspected tables. Pure — no DB
+ * access — so it is unit-testable. `rules` (Adonis Lucid `rulesPaths`) override
+ * per-column TS types/decorators. Manual edits to the output are lost on
+ * regeneration (same contract as Lucid).
+ */
+export declare function renderSchemaFile(tables: ReadonlyArray<{
+    table: string;
+    columns: IntrospectedColumn[];
+    schema?: string;
+}>, rules?: SchemaRules, compact?: boolean): string;
+/**
+ * Introspect the live database and (re)write the schema file. Returns the number
+ * of tables written. Reused by the {@link schemaGenerateCommand} and by the
+ * migration commands' auto-regeneration (Adonis Lucid regenerates after
+ * migrate/rollback/etc).
+ */
+export declare function generateSchemaFile(db: AsyncDatabaseConnection, options: SchemaGenerateOptions): Promise<number>;
+/** `schema:generate` — introspect the DB and (re)write the schema file. */
+export declare function schemaGenerateCommand(options: SchemaGenerateOptions): AtlasCommandClass;
+//# sourceMappingURL=schemaGenerateCommand.d.ts.map

package/dist/console/schemaGenerateCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaGenerateCommand.d.ts","sourceRoot":"","sources":["../../src/console/schemaGenerateCommand.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAE5E,OAAO,EACN,KAAK,kBAAkB,EAEvB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,KAAK,iBAAiB,EAAQ,MAAM,eAAe,CAAC;AAE7D,MAAM,WAAW,qBAAqB;IACrC,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IAC1B,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CAC5D;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC3B,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACrC,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnC,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;KAAE,CAAC,CAAC;CAClE;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACpC,UAAU,EAAE,MAAM,EAAE,GAAG,SAAS,GAC9B,OAAO,CAAC,WAAW,CAAC,CAUtB;AA0JD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC/B,MAAM,EAAE,aAAa,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,EACF,KAAK,GAAE,WAAgB,EACvB,OAAO,UAAQ,GACb,MAAM,CAmBR;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACvC,EAAE,EAAE,uBAAuB,EAC3B,OAAO,EAAE,qBAAqB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAiCjB;AAED,2EAA2E;AAC3E,wBAAgB,qBAAqB,CACpC,OAAO,EAAE,qBAAqB,GAC5B,iBAAiB,CA8CnB"}

package/dist/console/schemaGenerateCommand.js

@@ -0,0 +1,246 @@
+/**
+ * `schema:generate` — database-first codegen (Adonis Lucid parity). Introspects
+ * the live database and writes a `schema.ts` file with one `BaseModel` subclass
+ * per table, mirroring Lucid's `schema:generate` → `database/schema.ts`.
+ *
+ * @example
+ *   // commands/schema-generate.ts
+ *   import { schemaGenerateCommand } from '@c9up/atlas'
+ *   export default schemaGenerateCommand({ outputPath: 'database/schema.ts' })
+ */
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+import { listUserTables } from "../schema/catalog.js";
+import { introspectTable, } from "../schema/introspect.js";
+import { getConnection, getDb } from "../services/db.js";
+import { flag } from "./contract.js";
+/**
+ * Load + deep-merge the rule modules named by `rulesPaths` (later files win).
+ * Each module default-exports a {@link SchemaRules}; a module without a usable
+ * default export is skipped.
+ */
+export async function loadSchemaRules(rulesPaths) {
+    const merged = {};
+    for (const p of rulesPaths ?? []) {
+        const mod = await import(p);
+        const rules = mod.default ?? mod;
+        if (rules && typeof rules === "object") {
+            mergeRules(merged, rules);
+        }
+    }
+    return merged;
+}
+/** Deep-merge `src` rules into `dst` (column/type/table maps), src winning. */
+function mergeRules(dst, src) {
+    dst.columns = { ...dst.columns, ...src.columns };
+    dst.types = { ...dst.types, ...src.types };
+    dst.tables = { ...dst.tables };
+    for (const [table, rule] of Object.entries(src.tables ?? {})) {
+        dst.tables[table] = {
+            columns: { ...dst.tables[table]?.columns, ...rule.columns },
+        };
+    }
+}
+/** Resolve the winning rule for a column (table-scoped > column > type), if any. */
+function resolveRule(rules, table, col) {
+    return (rules.tables?.[table]?.columns?.[col.name] ??
+        rules.columns?.[col.name] ??
+        rules.types?.[col.type.toLowerCase()]);
+}
+/** `snake_case` / `snake_case_id` → `camelCase`. */
+function toCamel(name) {
+    return name.replace(/_([a-z0-9])/g, (_, c) => c.toUpperCase());
+}
+/** `snake_case` table → `PascalCase` class stem. */
+function toPascal(name) {
+    const camel = toCamel(name);
+    return camel.charAt(0).toUpperCase() + camel.slice(1);
+}
+/** `camelCase` → `snake_case`, to detect when a DB column needs `columnName`. */
+function toSnake(name) {
+    return name.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`);
+}
+/** Is this a date/time column (→ `@column.dateTime` + a Chronos `DateTime`)? */
+function isDateType(rawType) {
+    return /timestamp|datetime|date|time/.test(rawType.toLowerCase());
+}
+/** Map a NON-date raw dialect column type to a TypeScript type. */
+function toTsType(rawType) {
+    const t = rawType.toLowerCase();
+    if (/bool/.test(t))
+        return "boolean";
+    if (/int|serial|real|float|double|number/.test(t))
+        return "number";
+    // decimal/numeric hydrate as strings (atlas keeps precision) — Lucid parity.
+    if (/decimal|numeric/.test(t))
+        return "string";
+    if (/json/.test(t))
+        return "unknown";
+    if (/bytea|blob|binary/.test(t))
+        return "Uint8Array";
+    return "string"; // varchar / text / char / uuid / everything else
+}
+/** `columnName: "..."` fragment when the DB name doesn't round-trip from camelCase. */
+function columnNameOpt(col, prop) {
+    return toSnake(prop) === col.name ? "" : `columnName: "${col.name}"`;
+}
+/** Record a rule's imports into the sink. */
+function collectImports(sink, rule) {
+    for (const imp of rule?.imports ?? []) {
+        const set = sink.get(imp.source) ?? new Set();
+        for (const n of imp.namedImports)
+            set.add(n);
+        sink.set(imp.source, set);
+    }
+}
+/**
+ * Render one column declaration line (Lucid decorator + typed property). A
+ * matching {@link SchemaRules} entry overrides the decorator and TS type and
+ * contributes its imports to `sink`.
+ */
+function renderColumn(col, table, rules, sink) {
+    const prop = toCamel(col.name);
+    const cn = columnNameOpt(col, prop);
+    const nullable = col.nullable && !col.primaryKey ? " | null" : "";
+    // A rule wins over the built-in mapping (custom enum types, decorators, …).
+    const rule = resolveRule(rules, table, col);
+    if (rule?.decorator || rule?.tsType) {
+        collectImports(sink, rule);
+        const decorator = rule.decorator ?? (col.primaryKey ? "@PrimaryKey()" : "@Column()");
+        const tsType = rule.tsType ?? toTsType(col.type);
+        return `\t${decorator} declare ${prop}: ${tsType}${nullable};`;
+    }
+    if (isDateType(col.type) && !col.primaryKey) {
+        const opts = cn ? `{ ${cn} }` : "";
+        const dateNullable = col.nullable ? " | null" : "";
+        return `\t@column.dateTime(${opts}) declare ${prop}: DateTime${dateNullable};`;
+    }
+    const opts = cn ? `{ ${cn} }` : "";
+    const decorator = col.primaryKey ? "@PrimaryKey()" : `@Column(${opts})`;
+    return `\t${decorator} declare ${prop}: ${toTsType(col.type)}${nullable};`;
+}
+/**
+ * Render one `<Table>Schema extends BaseModel` class (with Lucid `$columns`).
+ * A non-default `schema` qualifies `static table` (`"schema.table"` — the Rust
+ * compiler quotes it as `"schema"."table"`) and prefixes the class name to keep
+ * `public.users` / `tenant.users` distinct.
+ */
+function renderClass(table, columns, rules, sink, compact, schema) {
+    const className = schema
+        ? `${toPascal(schema)}${toPascal(table)}Schema`
+        : `${toPascal(table)}Schema`;
+    const qualifiedTable = schema ? `${schema}.${table}` : table;
+    const props = columns.map((c) => toCamel(c.name));
+    const cols = props.map((p) => `"${p}"`).join(", ");
+    const body = columns
+        .map((c) => renderColumn(c, table, rules, sink))
+        .join("\n");
+    // Compact drops the blank line between `$columns` and the column declarations.
+    const gap = compact ? "\n" : "\n\n";
+    return (`export class ${className} extends BaseModel {\n` +
+        `\tstatic table = "${qualifiedTable}";\n` +
+        `\tstatic $columns = [${cols}] as const;\n` +
+        `\t$columns = ${className}.$columns;${gap}${body}\n}`);
+}
+/** Emit the deduped `import { a, b } from "source"` lines from a sink. */
+function renderRuleImports(sink) {
+    const lines = [];
+    for (const [source, names] of sink) {
+        lines.push(`import { ${[...names].join(", ")} } from "${source}";\n`);
+    }
+    return lines.join("");
+}
+/**
+ * Render the full `schema.ts` source from introspected tables. Pure — no DB
+ * access — so it is unit-testable. `rules` (Adonis Lucid `rulesPaths`) override
+ * per-column TS types/decorators. Manual edits to the output are lost on
+ * regeneration (same contract as Lucid).
+ */
+export function renderSchemaFile(tables, rules = {}, compact = false) {
+    const sink = new Map();
+    // Render the classes first so rule imports are fully collected for the header.
+    const classes = tables
+        .map((t) => renderClass(t.table, t.columns, rules, sink, compact, t.schema))
+        .join(compact ? "\n" : "\n\n");
+    const hasDate = tables.some((t) => t.columns.some((c) => isDateType(c.type) && !resolveRule(rules, t.table, c)?.tsType));
+    const header = "// Generated by @c9up/atlas schema:generate — DO NOT EDIT.\n" +
+        "// Manual edits are lost on regeneration.\n" +
+        'import { BaseModel, Column, column, PrimaryKey } from "@c9up/atlas";\n' +
+        (hasDate ? 'import { DateTime } from "@c9up/chronos";\n' : "") +
+        renderRuleImports(sink);
+    if (tables.length === 0)
+        return `${header}\n// (no tables)\n`;
+    return `${header}\n${classes}\n`;
+}
+/**
+ * Introspect the live database and (re)write the schema file. Returns the number
+ * of tables written. Reused by the {@link schemaGenerateCommand} and by the
+ * migration commands' auto-regeneration (Adonis Lucid regenerates after
+ * migrate/rollback/etc).
+ */
+export async function generateSchemaFile(db, options) {
+    const exclude = new Set(options.excludeTables ?? []);
+    const tables = [];
+    // With `schemas`, list + introspect each named schema's tables against THAT
+    // schema (Lucid). Without it, use the current schema/database as before.
+    const schemaScopes = options.schemas && options.schemas.length > 0
+        ? options.schemas
+        : [undefined];
+    for (const schema of schemaScopes) {
+        const names = (await listUserTables(db, db.dialect, {
+            schemas: schema ? [schema] : undefined,
+        }))
+            .filter((n) => !exclude.has(n))
+            .sort();
+        for (const table of names) {
+            const columns = await introspectTable(db, db.dialect, table, schema);
+            if (columns)
+                tables.push({ table, columns, schema });
+        }
+    }
+    const rules = await loadSchemaRules(options.rulesPaths);
+    const source = renderSchemaFile(tables, rules, options.compact ?? false);
+    await fsp.mkdir(path.dirname(options.outputPath), { recursive: true });
+    await fsp.writeFile(options.outputPath, source);
+    return tables.length;
+}
+/** `schema:generate` — introspect the DB and (re)write the schema file. */
+export function schemaGenerateCommand(options) {
+    return class SchemaGenerate {
+        static commandName = "schema:generate";
+        static description = "Introspect the database and generate BaseModel schema classes";
+        static options = { startApp: true };
+        static flags = [
+            flag("connection", "string", {
+                description: "Named connection to introspect",
+            }),
+            flag("compactOutput", "boolean", {
+                description: "Override the configured `compact` rendering",
+            }),
+        ];
+        async run() {
+            // `enabled: false` disables the command too (Adonis Lucid), not just the
+            // post-migration regeneration.
+            if (options.enabled === false) {
+                console.log("[atlas] schema generation is disabled (enabled: false)");
+                return;
+            }
+            // `--connection <name>` targets a specific registered connection (Adonis
+            // Lucid); without it, the default connection is used.
+            const connName = this.connection;
+            const db = connName ? getConnection(connName) : getDb();
+            if (!db) {
+                console.error(connName
+                    ? `[atlas] no connection registered under '${connName}'`
+                    : "[atlas] no database connection — is AtlasProvider registered?");
+                process.exitCode = 1;
+                return;
+            }
+            // `--compact-output` overrides the configured `compact`.
+            const compact = this.compactOutput === true ? true : options.compact;
+            const n = await generateSchemaFile(db, { ...options, compact });
+            console.log(`Generated ${options.outputPath} (${n} table${n === 1 ? "" : "s"})`);
+        }
+    };
+}
+//# sourceMappingURL=schemaGenerateCommand.js.map

package/dist/console/schemaGenerateCommand.js.map

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

package/dist/console/seederCommands.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Seeder console commands — the Ream-idiomatic CLI for scaffolding and running
+ * database seeders (Adonis Lucid `make:seeder` / `db:seed`). Same shape as the
+ * migration commands: plain `{ name, description, run }` objects registered in
+ * `reamrc.commands` and dispatched by the console kernel.
+ *
+ * Atlas has no global config registry (Lucid parity — you pass your own paths),
+ * so every factory takes the `seedersDir`.
+ *
+ * @example
+ *   // commands/seed.ts
+ *   import { dbSeedCommand } from '@c9up/atlas'
+ *   export default dbSeedCommand({ seedersDir: 'database/seeders' })
+ *   // run:  <console-entry> db:seed  (or --files=UserSeeder,PostSeeder)
+ */
+import { type AtlasCommandClass } from "./contract.js";
+export interface SeederCommandOptions {
+    /** Directory holding the seeder files. */
+    seedersDir: string;
+    /** Sort files numerically (`2_x` before `10_x`) — Adonis Lucid `naturalSort`. */
+    naturalSort?: boolean;
+    /**
+     * Current environment (`development`/`testing`/`production`), used to skip a
+     * seeder whose `static environment` excludes it. Falls back to `NODE_ENV`;
+     * override per-run with `--environment`.
+     */
+    environment?: string;
+}
+/**
+ * `make:seeder <name>` — scaffold a timestamped seeder file in `seedersDir`. The
+ * `Date.now()` prefix keeps files in creation order under the runner's
+ * lexicographic sort (same convention as migrations). The name is validated (no
+ * path separators / traversal) and written with `wx` so an existing seeder is
+ * never clobbered.
+ */
+export declare function makeSeederCommand(options: SeederCommandOptions): AtlasCommandClass;
+/**
+ * `db:seed` — run every seeder in `seedersDir` (Adonis Lucid `db:seed`). Flags:
+ *   --files=A,B         run only the named seeders (Lucid `--files`)
+ *   --connection=name   run against a registered connection (Lucid `--connection`)
+ *   --compact-output    terse output (one summary line, not per-seeder)
+ *   --interactive       accepted for Lucid compat; the console kernel is
+ *                       non-interactive, so it runs every seeder (no prompt)
+ */
+export declare function dbSeedCommand(options: SeederCommandOptions): AtlasCommandClass;
+//# sourceMappingURL=seederCommands.d.ts.map

package/dist/console/seederCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seederCommands.d.ts","sourceRoot":"","sources":["../../src/console/seederCommands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,OAAO,EAAE,KAAK,iBAAiB,EAAkB,MAAM,eAAe,CAAC;AAEvE,MAAM,WAAW,oBAAoB;IACpC,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAaD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,oBAAoB,GAC3B,iBAAiB,CA2BnB;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC5B,OAAO,EAAE,oBAAoB,GAC3B,iBAAiB,CAmEnB"}

package/dist/console/seederCommands.js

@@ -0,0 +1,136 @@
+/**
+ * Seeder console commands — the Ream-idiomatic CLI for scaffolding and running
+ * database seeders (Adonis Lucid `make:seeder` / `db:seed`). Same shape as the
+ * migration commands: plain `{ name, description, run }` objects registered in
+ * `reamrc.commands` and dispatched by the console kernel.
+ *
+ * Atlas has no global config registry (Lucid parity — you pass your own paths),
+ * so every factory takes the `seedersDir`.
+ *
+ * @example
+ *   // commands/seed.ts
+ *   import { dbSeedCommand } from '@c9up/atlas'
+ *   export default dbSeedCommand({ seedersDir: 'database/seeders' })
+ *   // run:  <console-entry> db:seed  (or --files=UserSeeder,PostSeeder)
+ */
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+import { runSeederDirectory } from "../schema/Seeder.js";
+import { getConnection, getDb } from "../services/db.js";
+import { assertSafeName } from "../utils/safePath.js";
+import { argument, flag } from "./contract.js";
+/** Scaffold body for a fresh seeder (`make:seeder`). */
+const SEEDER_STUB = `import { BaseSeeder } from '@c9up/atlas'
+
+export default class extends BaseSeeder {
+  async run() {
+    // const repo = new BaseRepository(Model, this.db)
+    // await repo.upsert([{ /* ... */ }], ['uniqueColumn'], ['columnToUpdate'])
+  }
+}
+`;
+/**
+ * `make:seeder <name>` — scaffold a timestamped seeder file in `seedersDir`. The
+ * `Date.now()` prefix keeps files in creation order under the runner's
+ * lexicographic sort (same convention as migrations). The name is validated (no
+ * path separators / traversal) and written with `wx` so an existing seeder is
+ * never clobbered.
+ */
+export function makeSeederCommand(options) {
+    return class MakeSeeder {
+        static commandName = "make:seeder";
+        static description = "Scaffold a new seeder file";
+        // Filesystem only — no connection needed.
+        static options = { startApp: false };
+        static args = [argument("name", { description: "Seeder file name" })];
+        async run() {
+            // A missing name never reaches here: the kernel reports the required
+            // argument by name before `run()`.
+            try {
+                assertSafeName(this.name, "SEEDER_INVALID", "seeder");
+            }
+            catch {
+                console.error(`[atlas] invalid seeder name: ${this.name}`);
+                process.exitCode = 1;
+                return;
+            }
+            const fileName = `${Date.now()}_${this.name}.ts`;
+            const filePath = path.join(options.seedersDir, fileName);
+            await fsp.mkdir(options.seedersDir, { recursive: true });
+            await fsp.writeFile(filePath, SEEDER_STUB, { flag: "wx" });
+            console.log(`Created ${filePath}`);
+        }
+    };
+}
+/**
+ * `db:seed` — run every seeder in `seedersDir` (Adonis Lucid `db:seed`). Flags:
+ *   --files=A,B         run only the named seeders (Lucid `--files`)
+ *   --connection=name   run against a registered connection (Lucid `--connection`)
+ *   --compact-output    terse output (one summary line, not per-seeder)
+ *   --interactive       accepted for Lucid compat; the console kernel is
+ *                       non-interactive, so it runs every seeder (no prompt)
+ */
+export function dbSeedCommand(options) {
+    return class DbSeed {
+        static commandName = "db:seed";
+        static description = "Run database seeders (--files=A,B, --connection=name)";
+        static options = { startApp: true };
+        static flags = [
+            flag("files", "string", {
+                description: "Comma-separated seeder names to run",
+            }),
+            flag("connection", "string", {
+                description: "Named connection to seed",
+            }),
+            flag("compactOutput", "boolean", {
+                description: "One summary line instead of per-seeder output",
+            }),
+            flag("environment", "string", {
+                description: "Environment the seeders run under",
+            }),
+            flag("interactive", "boolean", {
+                description: "Accepted for Lucid compatibility; runs every seeder",
+            }),
+        ];
+        async run() {
+            const connName = this.connection;
+            const db = connName ? getConnection(connName) : getDb();
+            if (!db) {
+                console.error(connName
+                    ? `[atlas] no connection registered under '${connName}'`
+                    : "[atlas] no database connection — is AtlasProvider registered?");
+                process.exitCode = 1;
+                return;
+            }
+            if (this.interactive === true) {
+                console.warn("[atlas] --interactive is not supported in the non-interactive console; running all selected seeders.");
+            }
+            const files = parseFilesFlag(this.files);
+            const environment = this.environment ?? options.environment ?? process.env.NODE_ENV;
+            const executed = await runSeederDirectory(options.seedersDir, db, {
+                files,
+                naturalSort: options.naturalSort,
+                environment,
+            });
+            const compact = this.compactOutput === true;
+            if (compact) {
+                console.log(`Seeded ${executed.length} seeder(s)`);
+            }
+            else {
+                console.log(executed.length
+                    ? `Seeded: ${executed.join(", ")}`
+                    : "No seeders to run");
+            }
+        }
+    };
+}
+/** Parse `--files=A,B,C` into a name list, or undefined when absent. */
+function parseFilesFlag(value) {
+    if (typeof value !== "string" || value.length === 0)
+        return undefined;
+    return value
+        .split(",")
+        .map((f) => f.trim())
+        .filter((f) => f.length > 0);
+}
+//# sourceMappingURL=seederCommands.js.map

package/dist/console/seederCommands.js.map

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