@c9up/atlas 0.1.3 → 0.1.5

package/dist/schema/MigrationRunner.js

@@ -0,0 +1,406 @@
+/**
+ * Migration Runner — discovers, executes, and tracks database migrations.
+ *
+ * @implements FR34
+ */
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+import { pathToFileURL } from "node:url";
+import { AtlasError } from "../errors.js";
+import { compileStatementNative } from "../query/native.js";
+import { assertPathInsideBase, assertSafeName, pathExists, } from "../utils/safePath.js";
+const DEFAULT_TABLE = "ream_migrations";
+const TABLE_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
+function validateTrackingTableName(name) {
+    if (!TABLE_NAME_PATTERN.test(name)) {
+        throw new AtlasError("MIGRATION_INVALID_TABLE_NAME", `Invalid tracking-table name: ${JSON.stringify(name)}. ` +
+            "Must match /^[A-Za-z_][A-Za-z0-9_]*$/ (letters, digits, underscores; not starting with a digit).");
+    }
+    return name;
+}
+/** Compile a statement + run it via the adapter. */
+async function runStmt(db, dialect, spec) {
+    const compiled = compileStatementNative(spec, dialect);
+    for (const sql of compiled.statements) {
+        await db.execute(sql, compiled.params);
+    }
+}
+async function queryStmt(db, dialect, spec) {
+    const compiled = compileStatementNative(spec, dialect);
+    return db.query(compiled.statements[0], compiled.params);
+}
+/**
+ * Runs migrations against a database.
+ */
+export class MigrationRunner {
+    #db;
+    #migrationsDir;
+    #dialect;
+    #tableName;
+    /**
+     * @param db Underlying database adapter.
+     * @param options.migrationsDir Directory containing migration files. Defaults to `database/migrations`.
+     * @param options.dialect SQL dialect of the adapter. Defaults to `sqlite`.
+     * @param options.tableName Custom name for the migrations tracking table.
+     *   Defaults to `"ream_migrations"`. Must match `/^[A-Za-z_][A-Za-z0-9_]*$/` —
+     *   throws `AtlasError("MIGRATION_INVALID_TABLE_NAME")` synchronously otherwise.
+     *
+     *   Cleanup coupling: `DatabaseCleanup.truncateAll` (`src/testing/DatabaseCleanup.ts`)
+     *   skips tables whose name starts with `ream_` (via `LIKE 'ream\_%' ESCAPE '\'`).
+     *   The default `"ream_migrations"` is therefore auto-protected. Choosing a name
+     *   without the `ream_` prefix (e.g. `"schema_versions"`) opts the tracking table
+     *   out of that protection — `truncateAll` will wipe it alongside user tables,
+     *   forcing a re-`init()` and replay of every migration on next test run.
+     *
+     *   Rename caveat: `init()` emits `CREATE TABLE IF NOT EXISTS <tableName>` —
+     *   it does NOT auto-migrate from a previous tracking table. A project that
+     *   has been running with `ream_migrations` and then changes `tableName` to
+     *   `schema_versions` will get a fresh empty `schema_versions` on next boot,
+     *   read zero applied migrations, and re-run every past migration (likely
+     *   crashing on `CREATE TABLE <user-table>` already-exists). To rename
+     *   safely, copy the history manually before switching:
+     *
+     *     INSERT INTO schema_versions SELECT * FROM ream_migrations;
+     *     -- (then DROP TABLE ream_migrations once verified)
+     */
+    constructor(db, options) {
+        this.#db = db;
+        this.#migrationsDir = options?.migrationsDir ?? "database/migrations";
+        this.#dialect = options?.dialect ?? "sqlite";
+        this.#tableName =
+            options?.tableName === undefined
+                ? DEFAULT_TABLE
+                : validateTrackingTableName(options.tableName);
+    }
+    /** Ensure the ream_migrations tracking table exists. */
+    async init() {
+        await runStmt(this.#db, this.#dialect, {
+            kind: "createTable",
+            table: this.#tableName,
+            ifNotExists: true,
+            columns: [
+                // Auto-increment PK (Lucid's adonis_schema uses `increments`). The
+                // Rust compiler emits the dialect-appropriate identity clause, so
+                // the INSERT below omits `id` on every dialect.
+                {
+                    name: "id",
+                    kind: "integer",
+                    autoIncrement: true,
+                    nullable: false,
+                    primary: true,
+                    unique: false,
+                    default: null,
+                    references: null,
+                    length: null,
+                    precision: null,
+                    scale: null,
+                },
+                {
+                    name: "name",
+                    kind: "string",
+                    length: 255,
+                    nullable: false,
+                    primary: false,
+                    unique: true,
+                    default: null,
+                    references: null,
+                    precision: null,
+                    scale: null,
+                },
+                {
+                    name: "batch",
+                    kind: "integer",
+                    nullable: false,
+                    primary: false,
+                    unique: false,
+                    default: null,
+                    references: null,
+                    length: null,
+                    precision: null,
+                    scale: null,
+                },
+                {
+                    name: "executed_at",
+                    kind: "timestamp",
+                    nullable: false,
+                    primary: false,
+                    unique: false,
+                    default: "CURRENT_TIMESTAMP",
+                    references: null,
+                    length: null,
+                    precision: null,
+                    scale: null,
+                },
+            ],
+            indexes: [],
+        });
+    }
+    /** Get the status of all migrations. */
+    async status() {
+        const applied = await queryStmt(this.#db, this.#dialect, {
+            kind: "select",
+            table: this.#tableName,
+            select: ["name", "batch"],
+            wheres: [],
+            orderBy: [{ column: "name", direction: "asc" }],
+            groupBy: [],
+            having: [],
+            limit: null,
+            offset: null,
+            distinct: false,
+            ctes: [],
+            unions: [],
+        });
+        const appliedMap = new Map(applied.map((r) => [r.name, r.batch]));
+        const files = await this.#discoverFiles();
+        return files.map((f) => ({
+            name: f,
+            status: appliedMap.has(f) ? "applied" : "pending",
+            batch: appliedMap.get(f),
+        }));
+    }
+    /** Run all pending migrations. */
+    async migrate() {
+        await this.init();
+        const applied = await queryStmt(this.#db, this.#dialect, {
+            kind: "select",
+            table: this.#tableName,
+            select: ["name"],
+            wheres: [],
+            orderBy: [],
+            groupBy: [],
+            having: [],
+            limit: null,
+            offset: null,
+            distinct: false,
+            ctes: [],
+            unions: [],
+        });
+        const appliedNames = new Set(applied.map((r) => r.name));
+        const files = await this.#discoverFiles();
+        const pending = files.filter((f) => !appliedNames.has(f));
+        if (pending.length === 0) {
+            return [];
+        }
+        const batch = (await this.#currentBatch()) + 1;
+        const executed = [];
+        for (const name of pending) {
+            this.#assertSafeName(name);
+            const migration = await this.#loadMigration(name);
+            const statements = await migration.getUpSQL();
+            // Compile the ream_migrations INSERT so we can include it in the same
+            // transaction as the migration's own DDL/DML — either everything
+            // commits or nothing does.
+            const insertCompiled = compileStatementNative({
+                kind: "insert",
+                table: this.#tableName,
+                values: [
+                    ["name", name],
+                    ["batch", batch],
+                ],
+            }, this.#dialect);
+            const [insertSql] = insertCompiled.statements;
+            if (insertSql === undefined) {
+                throw new AtlasError("MIGRATION_COMPILE_EMPTY", `compileStatementNative returned no statements for migration insert of '${name}'`);
+            }
+            const batchStatements = [
+                ...statements.map((sql) => ({ sql, params: [] })),
+                { sql: insertSql, params: insertCompiled.params },
+            ];
+            await this.#runAtomic(batchStatements, name);
+            executed.push(name);
+        }
+        return executed;
+    }
+    /** Rollback the last batch of migrations. */
+    async rollback() {
+        await this.init();
+        const batch = await this.#currentBatch();
+        if (batch === 0) {
+            return [];
+        }
+        const toRollback = await queryStmt(this.#db, this.#dialect, {
+            kind: "select",
+            table: this.#tableName,
+            select: ["name"],
+            wheres: [{ column: "batch", operator: "=", value: batch, type: "and" }],
+            orderBy: [{ column: "name", direction: "desc" }],
+            groupBy: [],
+            having: [],
+            limit: null,
+            offset: null,
+            distinct: false,
+            ctes: [],
+            unions: [],
+        });
+        const rolled = [];
+        for (const record of toRollback) {
+            this.#assertSafeName(record.name);
+            const migration = await this.#loadMigration(record.name);
+            const statements = await migration.getDownSQL();
+            const deleteCompiled = compileStatementNative({
+                kind: "delete",
+                table: this.#tableName,
+                wheres: [
+                    { column: "name", operator: "=", value: record.name, type: "and" },
+                ],
+            }, this.#dialect);
+            const [deleteSql] = deleteCompiled.statements;
+            if (deleteSql === undefined) {
+                throw new AtlasError("MIGRATION_COMPILE_EMPTY", `compileStatementNative returned no statements for migration delete of '${record.name}'`);
+            }
+            const batchStatements = [
+                ...statements.map((sql) => ({ sql, params: [] })),
+                { sql: deleteSql, params: deleteCompiled.params },
+            ];
+            await this.#runAtomic(batchStatements, record.name);
+            rolled.push(record.name);
+        }
+        return rolled;
+    }
+    /**
+     * Run a batch of statements in a single transaction if the adapter supports
+     * it; otherwise fall back to sequential execute (best-effort). Adapters that
+     * lack transaction support get a warning so integrators notice the risk.
+     */
+    async #runAtomic(batch, migrationName) {
+        if (this.#db.runInTransaction) {
+            await this.#db.runInTransaction(batch);
+            return;
+        }
+        // Fallback — log once and run sequentially. Not ideal; adapters should
+        // implement `runInTransaction` for production use.
+        console.warn(`[atlas] DatabaseAdapter does not support runInTransaction — running '${migrationName}' without atomicity.`);
+        for (const { sql, params } of batch) {
+            await this.#db.execute(sql, params);
+        }
+    }
+    /**
+     * Rollback + re-run a specific number of batches (or all if `steps` omitted).
+     * `migrate:refresh` in Lucid parlance.
+     *
+     * @implements Story 32.11
+     */
+    async refresh() {
+        const rolled = await this.reset();
+        const executed = await this.migrate();
+        return { rolled, executed };
+    }
+    /**
+     * Drop EVERY table the migrations created (via successive rollbacks) then
+     * run every migration from scratch. `migrate:fresh` in Lucid parlance.
+     *
+     * Distinct from `refresh()` only in intent — both end up with a fresh DB.
+     */
+    async fresh() {
+        return this.refresh();
+    }
+    /**
+     * Rollback every applied batch (alias for `migrate:reset`).
+     * Returns the list of rolled-back migration names (in rollback order).
+     */
+    async reset() {
+        await this.init();
+        const all = [];
+        // Roll back batches one by one until nothing remains.
+        while ((await this.#currentBatch()) > 0) {
+            const rolled = await this.rollback();
+            if (rolled.length === 0)
+                break;
+            all.push(...rolled);
+        }
+        return all;
+    }
+    /**
+     * Dry-run: compute the SQL statements that would be emitted by a migrate
+     * without executing them. Returns the full list of statements per pending
+     * migration file. Useful for CI pre-flight checks.
+     */
+    async dryRun() {
+        await this.init();
+        const applied = await queryStmt(this.#db, this.#dialect, {
+            kind: "select",
+            table: this.#tableName,
+            select: ["name"],
+            wheres: [],
+            orderBy: [],
+            groupBy: [],
+            having: [],
+            limit: null,
+            offset: null,
+            distinct: false,
+            ctes: [],
+            unions: [],
+        });
+        const appliedNames = new Set(applied.map((r) => r.name));
+        const files = (await this.#discoverFiles()).filter((f) => !appliedNames.has(f));
+        const result = [];
+        for (const name of files) {
+            this.#assertSafeName(name);
+            const migration = await this.#loadMigration(name);
+            const statements = await migration.getUpSQL();
+            result.push({ name, sql: statements });
+        }
+        return result;
+    }
+    async #currentBatch() {
+        // MAX(batch) — select expression uses quote_select_expr allowlist which permits MAX.
+        const rows = await queryStmt(this.#db, this.#dialect, {
+            kind: "select",
+            table: this.#tableName,
+            select: ["MAX(batch) AS max"],
+            wheres: [],
+            orderBy: [],
+            groupBy: [],
+            having: [],
+            limit: null,
+            offset: null,
+            distinct: false,
+            ctes: [],
+            unions: [],
+        });
+        return rows[0]?.max ?? 0;
+    }
+    /** Discover migration files sorted by name. Async — never blocks the event loop. */
+    async #discoverFiles() {
+        try {
+            const entries = await fsp.readdir(this.#migrationsDir);
+            return entries
+                .filter((f) => f.endsWith(".ts") || f.endsWith(".js"))
+                .sort()
+                .map((f) => f.replace(/\.(ts|js)$/, ""));
+        }
+        catch (err) {
+            // Missing directory → no migrations. Any other error propagates.
+            if (err.code === "ENOENT")
+                return [];
+            throw err;
+        }
+    }
+    /** Validate migration name — delegates to the shared safe-path helpers. */
+    #assertSafeName(name) {
+        assertSafeName(name, "MIGRATION_INVALID", "migration");
+    }
+    /** Load and instantiate a migration class. */
+    async #loadMigration(name) {
+        this.#assertSafeName(name);
+        assertPathInsideBase(this.#migrationsDir, `${name}.ts`, "MIGRATION_INVALID", "Migration");
+        const tsPath = path.join(this.#migrationsDir, `${name}.ts`);
+        const jsPath = path.join(this.#migrationsDir, `${name}.js`);
+        const tsExists = await pathExists(tsPath);
+        const filePath = tsExists ? tsPath : jsPath;
+        if (!tsExists && !(await pathExists(jsPath))) {
+            throw new AtlasError("MIGRATION_NOT_FOUND", `Migration file not found: ${name}`);
+        }
+        // ESM dynamic import on Windows REQUIRES a file:// URL — a bare
+        // `C:\…` path triggers ERR_UNSUPPORTED_ESM_URL_SCHEME. `pathToFileURL`
+        // normalizes both Windows and POSIX paths to a valid URL.
+        const mod = await import(pathToFileURL(path.resolve(filePath)).href);
+        const MigrationClass = mod.default;
+        if (!MigrationClass || typeof MigrationClass !== "function") {
+            throw new AtlasError("MIGRATION_INVALID", `Migration ${name} must export a default class`);
+        }
+        return new MigrationClass(this.#dialect);
+    }
+}
+//# sourceMappingURL=MigrationRunner.js.map

package/dist/schema/MigrationRunner.js.map

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

package/dist/schema/Schema.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Schema — top-level fluent API for DDL operations.
+ *
+ * Each method appends compiled SQL statements (via the Rust compiler) to an
+ * internal buffer that the migration runner can flush to the database.
+ *
+ * @implements FR34
+ */
+import { type AtlasDialect } from "../query/native.js";
+import { TableBuilder } from "./TableBuilder.js";
+export declare class Schema {
+    #private;
+    constructor(dialect?: AtlasDialect);
+    createTable(name: string, callback: (table: TableBuilder) => void): this;
+    dropTable(name: string): this;
+    createIndex(table: string, columns: string | string[], name?: string, unique?: boolean): this;
+    dropIndex(name: string): this;
+    raw(sql: string): this;
+    reset(): void;
+    toSQL(): string[];
+}
+//# sourceMappingURL=Schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Schema.d.ts","sourceRoot":"","sources":["../../src/schema/Schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACN,KAAK,YAAY,EAGjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,qBAAa,MAAM;;gBAIN,OAAO,GAAE,YAAgC;IAIrD,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAOxE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAS7B,WAAW,CACV,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,EAC1B,IAAI,CAAC,EAAE,MAAM,EACb,MAAM,UAAQ,GACZ,IAAI;IAWP,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAS7B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKtB,KAAK,IAAI,IAAI;IAIb,KAAK,IAAI,MAAM,EAAE;CAGjB"}

package/dist/schema/Schema.js

@@ -0,0 +1,51 @@
+/**
+ * Schema — top-level fluent API for DDL operations.
+ *
+ * Each method appends compiled SQL statements (via the Rust compiler) to an
+ * internal buffer that the migration runner can flush to the database.
+ *
+ * @implements FR34
+ */
+import { compileStatementNative, getAtlasDialect, } from "../query/native.js";
+import { TableBuilder } from "./TableBuilder.js";
+export class Schema {
+    #dialect;
+    #statements = [];
+    constructor(dialect = getAtlasDialect()) {
+        this.#dialect = dialect;
+    }
+    createTable(name, callback) {
+        const builder = new TableBuilder(name);
+        callback(builder);
+        this.#statements.push(...builder.toStatements(this.#dialect));
+        return this;
+    }
+    dropTable(name) {
+        const { statements } = compileStatementNative({ kind: "dropTable", table: name, ifExists: true }, this.#dialect);
+        this.#statements.push(...statements);
+        return this;
+    }
+    createIndex(table, columns, name, unique = false) {
+        const cols = Array.isArray(columns) ? columns : [columns];
+        const indexName = name ?? `idx_${table}_${cols.join("_")}`;
+        const { statements } = compileStatementNative({ kind: "createIndex", table, name: indexName, columns: cols, unique }, this.#dialect);
+        this.#statements.push(...statements);
+        return this;
+    }
+    dropIndex(name) {
+        const { statements } = compileStatementNative({ kind: "dropIndex", name, ifExists: true }, this.#dialect);
+        this.#statements.push(...statements);
+        return this;
+    }
+    raw(sql) {
+        this.#statements.push(sql);
+        return this;
+    }
+    reset() {
+        this.#statements = [];
+    }
+    toSQL() {
+        return [...this.#statements];
+    }
+}
+//# sourceMappingURL=Schema.js.map

package/dist/schema/Schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Schema.js","sourceRoot":"","sources":["../../src/schema/Schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAEN,sBAAsB,EACtB,eAAe,GACf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,OAAO,MAAM;IAClB,QAAQ,CAAe;IACvB,WAAW,GAAa,EAAE,CAAC;IAE3B,YAAY,UAAwB,eAAe,EAAE;QACpD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,WAAW,CAAC,IAAY,EAAE,QAAuC;QAChE,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;QACvC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAClB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC9D,OAAO,IAAI,CAAC;IACb,CAAC;IAED,SAAS,CAAC,IAAY;QACrB,MAAM,EAAE,UAAU,EAAE,GAAG,sBAAsB,CAC5C,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAClD,IAAI,CAAC,QAAQ,CACb,CAAC;QACF,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACb,CAAC;IAED,WAAW,CACV,KAAa,EACb,OAA0B,EAC1B,IAAa,EACb,MAAM,GAAG,KAAK;QAEd,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAC1D,MAAM,SAAS,GAAG,IAAI,IAAI,OAAO,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3D,MAAM,EAAE,UAAU,EAAE,GAAG,sBAAsB,CAC5C,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EACtE,IAAI,CAAC,QAAQ,CACb,CAAC;QACF,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACb,CAAC;IAED,SAAS,CAAC,IAAY;QACrB,MAAM,EAAE,UAAU,EAAE,GAAG,sBAAsB,CAC5C,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAC3C,IAAI,CAAC,QAAQ,CACb,CAAC;QACF,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACb,CAAC;IAED,GAAG,CAAC,GAAW;QACd,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC;IACb,CAAC;IAED,KAAK;QACJ,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;IACvB,CAAC;IAED,KAAK;QACJ,OAAO,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;IAC9B,CAAC;CACD"}

package/dist/schema/SchemaBuilder.d.ts

@@ -0,0 +1,14 @@
+/**
+ * SchemaBuilder — barrel re-export for backward compatibility.
+ *
+ * The classes were split into one-class-per-file:
+ *   - {@link Schema}        → ./Schema.ts
+ *   - {@link TableBuilder}  → ./TableBuilder.ts
+ *   - shared types          → ./types.ts
+ *
+ * @implements FR34
+ */
+export { Schema } from "./Schema.js";
+export { TableBuilder } from "./TableBuilder.js";
+export type { ColumnDefinition, ColumnType, IndexDefinition } from "./types.js";
+//# sourceMappingURL=SchemaBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaBuilder.d.ts","sourceRoot":"","sources":["../../src/schema/SchemaBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/schema/SchemaBuilder.js

@@ -0,0 +1,13 @@
+/**
+ * SchemaBuilder — barrel re-export for backward compatibility.
+ *
+ * The classes were split into one-class-per-file:
+ *   - {@link Schema}        → ./Schema.ts
+ *   - {@link TableBuilder}  → ./TableBuilder.ts
+ *   - shared types          → ./types.ts
+ *
+ * @implements FR34
+ */
+export { Schema } from "./Schema.js";
+export { TableBuilder } from "./TableBuilder.js";
+//# sourceMappingURL=SchemaBuilder.js.map

package/dist/schema/SchemaBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaBuilder.js","sourceRoot":"","sources":["../../src/schema/SchemaBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/schema/Seeder.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Seeder — populate the database with default / reference / test data.
+ *
+ * The canonical pattern:
+ *
+ *     export default class CountrySeeder extends BaseSeeder {
+ *       async run() {
+ *         // Idempotent via updateOrCreateMany — safe to re-run.
+ *         await Country.updateOrCreateMany('isoCode', [
+ *           { isoCode: 'FR', name: 'France' },
+ *           { isoCode: 'IN', name: 'India' },
+ *         ])
+ *       }
+ *     }
+ *
+ * @implements MISS-4, Story 32.12
+ */
+import type { DatabaseConnection } from "../BaseRepository.js";
+/**
+ * Base class for all seeders.
+ *
+ * Subclasses receive the database connection via the constructor so they can
+ * build repositories inside `run()` without resorting to globals.
+ */
+export declare abstract class BaseSeeder {
+    protected db: DatabaseConnection;
+    constructor(db: DatabaseConnection);
+    /** The seeder body. Should be idempotent — `updateOrCreateMany` is the recommended pattern. */
+    abstract run(): Promise<void> | void;
+}
+/** Legacy alias kept for code using the previous API. */
+export declare const Seeder: typeof BaseSeeder;
+/**
+ * Run a pre-built list of seeder INSTANCES in order. Each `run()` is awaited
+ * sequentially so ordering is deterministic and side effects are visible to
+ * subsequent seeders.
+ */
+export declare function runSeeders(seeders: BaseSeeder[], _db?: DatabaseConnection): Promise<void>;
+/**
+ * Discover seeder files under `dir`, import them in alphabetical order, build
+ * instances with the given DB connection, and run them sequentially.
+ *
+ * Usage: `await runSeederDirectory('./database/seeders', db)`
+ *
+ * @param dir      Directory containing `.ts` / `.js` seeder files
+ * @param db       Database connection passed to each seeder constructor
+ * @param options  Optional filter (`files: ['CountrySeeder']`) to run a subset
+ *
+ * @implements Story 32.12
+ */
+export declare function runSeederDirectory(dir: string, db: DatabaseConnection, options?: {
+    files?: readonly string[];
+}): Promise<string[]>;
+//# sourceMappingURL=Seeder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Seeder.d.ts","sourceRoot":"","sources":["../../src/schema/Seeder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;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,+FAA+F;IAC/F,QAAQ,CAAC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CACpC;AAED,yDAAyD;AACzD,eAAO,MAAM,MAAM,mBAAa,CAAC;AAEjC;;;;GAIG;AACH,wBAAsB,UAAU,CAC/B,OAAO,EAAE,UAAU,EAAE,EACrB,GAAG,CAAC,EAAE,kBAAkB,GACtB,OAAO,CAAC,IAAI,CAAC,CAIf;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"}