@c9up/atlas 0.1.3 → 0.1.4

package/dist/schema/Seeder.js

@@ -0,0 +1,89 @@
+/**
+ * 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 * as fsp from "node:fs/promises";
+import { pathToFileURL } from "node:url";
+import { AtlasError } from "../errors.js";
+import { assertPathInsideBase, assertSafeName, pathExists, } from "../utils/safePath.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 class BaseSeeder {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+}
+/** Legacy alias kept for code using the previous API. */
+export const Seeder = 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 async function runSeeders(seeders, _db) {
+    for (const seeder of seeders) {
+        await seeder.run();
+    }
+}
+/**
+ * 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 async function runSeederDirectory(dir, db, options) {
+    if (!(await pathExists(dir))) {
+        throw new AtlasError("E_SEEDER_DIR_NOT_FOUND", `Seeder directory not found: ${dir}`, {
+            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)$/, "")))
+        : allFiles;
+    const executed = [];
+    for (const file of selected) {
+        assertSafeName(file, "E_SEEDER_INVALID", "seeder");
+        const resolved = assertPathInsideBase(dir, file, "E_SEEDER_INVALID_PATH", "Seeder");
+        // `pathToFileURL` is required on Windows where bare `C:\…` paths
+        // trip ESM's ERR_UNSUPPORTED_ESM_URL_SCHEME on dynamic import.
+        const mod = await import(pathToFileURL(resolved).href);
+        const SeederClass = mod.default;
+        if (!SeederClass || typeof SeederClass !== "function") {
+            throw new AtlasError("E_SEEDER_INVALID", `Seeder ${file} must export a default class extending BaseSeeder`, {
+                hint: "Example: `export default class UserSeeder extends BaseSeeder { async run() { ... } }`",
+            });
+        }
+        const instance = new SeederClass(db);
+        await instance.run();
+        executed.push(file.replace(/\.(ts|js)$/, ""));
+    }
+    return executed;
+}
+//# sourceMappingURL=Seeder.js.map

package/dist/schema/Seeder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Seeder.js","sourceRoot":"","sources":["../../src/schema/Seeder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;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,CAC/B,OAAqB,EACrB,GAAwB;IAExB,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,oBAAoB,CACpC,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"}

package/dist/schema/TableBuilder.d.ts

@@ -0,0 +1,86 @@
+/**
+ * TableBuilder — fluent column/index builder used inside `Schema.createTable()`.
+ *
+ * Builds an in-memory column/index spec, then delegates SQL generation to the
+ * Rust compiler via `compileStatementNative`. No SQL strings are produced in TS.
+ *
+ * @implements FR34
+ */
+import { type AtlasDialect } from "../query/native.js";
+import { type ColumnDefinition, type IndexDefinition } from "./types.js";
+/** Table builder — used inside `schema.createTable(name, callback)`. */
+export declare class TableBuilder {
+    #private;
+    readonly tableName: string;
+    constructor(tableName: string);
+    uuid(name: string): this;
+    string(name: string, length?: number): this;
+    text(name: string): this;
+    integer(name: string): this;
+    bigInteger(name: string): this;
+    decimal(name: string, precision?: number, scale?: number): this;
+    boolean(name: string): this;
+    date(name: string): this;
+    timestamp(name: string): this;
+    json(name: string): this;
+    binary(name: string): this;
+    /**
+     * UUID primary key with Postgres-only `gen_random_uuid()` default.
+     *
+     * **Portability warning — DO NOT use in framework-shipped migration templates.**
+     *
+     * `gen_random_uuid()` is a Postgres-13+ built-in. SQLite and MySQL do NOT
+     * provide a function by that name; calling `id()` in a migration that
+     * runs on those dialects fails at `migrations:run` with a "no such
+     * function" error. The helper is retained for user-app migrations where
+     * the target dialect is known to be Postgres.
+     *
+     * In framework-shipped templates, write the column explicitly and supply
+     * the UUID at INSERT time:
+     *
+     *     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.
+     */
+    id(): this;
+    /**
+     * `created_at` + `updated_at` columns with Postgres-only `DEFAULT NOW()`.
+     *
+     * **Portability warning — DO NOT use in framework-shipped migration templates.**
+     *
+     * `NOW()` is a Postgres/MySQL function — SQLite does NOT recognise it
+     * (SQLite accepts `CURRENT_TIMESTAMP`, not `NOW()`). Calling
+     * `timestamps()` in a migration that runs on SQLite fails at
+     * `migrations:run` with a "no such function" error. The helper is
+     * retained for user-app migrations where the target dialect is known to
+     * be Postgres or MySQL.
+     *
+     * In framework-shipped templates, write the columns explicitly without a
+     * DEFAULT and supply the value at INSERT/UPSERT time:
+     *
+     *     t.timestamp('created_at').notNullable()  // no DEFAULT
+     *     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.
+     */
+    timestamps(): this;
+    primary(): this;
+    notNullable(): this;
+    nullable(): this;
+    unique(): this;
+    defaultTo(value: string): this;
+    references(table: string, column?: string): this;
+    index(columns: string | string[], name?: string): this;
+    uniqueIndex(columns: string | string[], name?: string): this;
+    getColumns(): ColumnDefinition[];
+    getIndexes(): IndexDefinition[];
+    /** Compile to SQL statements via the Rust compiler. */
+    toStatements(dialect?: AtlasDialect): string[];
+}
+//# sourceMappingURL=TableBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TableBuilder.d.ts","sourceRoot":"","sources":["../../src/schema/TableBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACN,KAAK,YAAY,EAGjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACN,KAAK,gBAAgB,EAErB,KAAK,eAAe,EAEpB,MAAM,YAAY,CAAC;AAEpB,wEAAwE;AACxE,qBAAa,YAAY;;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAKf,SAAS,EAAE,MAAM;IAM7B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIxB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,SAAM,GAAG,IAAI;IAMxC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAGxB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAG3B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI9B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAK,EAAE,KAAK,SAAI,GAAG,IAAI;IAStD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAG3B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAGxB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAG7B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAGxB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM1B;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,EAAE,IAAI,IAAI;IAIV;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,UAAU,IAAI,IAAI;IAQlB,OAAO,IAAI,IAAI;IAKf,WAAW,IAAI,IAAI;IAKnB,QAAQ,IAAI,IAAI;IAKhB,MAAM,IAAI,IAAI;IAKd,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK9B,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,SAAO,GAAG,IAAI;IAO9C,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAUtD,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAY5D,UAAU,IAAI,gBAAgB,EAAE;IAGhC,UAAU,IAAI,eAAe,EAAE;IAI/B,uDAAuD;IACvD,YAAY,CAAC,OAAO,GAAE,YAAgC,GAAG,MAAM,EAAE;CAsCjE"}

package/dist/schema/TableBuilder.js

@@ -0,0 +1,211 @@
+/**
+ * TableBuilder — fluent column/index builder used inside `Schema.createTable()`.
+ *
+ * Builds an in-memory column/index spec, then delegates SQL generation to the
+ * Rust compiler via `compileStatementNative`. No SQL strings are produced in TS.
+ *
+ * @implements FR34
+ */
+import { compileStatementNative, getAtlasDialect, } from "../query/native.js";
+import { TYPE_KIND_MAP, } from "./types.js";
+/** Table builder — used inside `schema.createTable(name, callback)`. */
+export class TableBuilder {
+    tableName;
+    #columns = [];
+    #indexes = [];
+    #currentColumn;
+    constructor(tableName) {
+        this.tableName = tableName;
+    }
+    // ─── Column types ─────────────────────────────────────────
+    uuid(name) {
+        return this.#addColumn(name, "uuid");
+    }
+    string(name, length = 255) {
+        this.#addColumn(name, "string");
+        if (this.#currentColumn)
+            this.#currentColumn.length = length;
+        return this;
+    }
+    text(name) {
+        return this.#addColumn(name, "text");
+    }
+    integer(name) {
+        return this.#addColumn(name, "integer");
+    }
+    bigInteger(name) {
+        return this.#addColumn(name, "bigInteger");
+    }
+    decimal(name, precision = 10, scale = 2) {
+        this.#addColumn(name, "decimal");
+        if (this.#currentColumn) {
+            this.#currentColumn.precision = precision;
+            this.#currentColumn.scale = scale;
+        }
+        return this;
+    }
+    boolean(name) {
+        return this.#addColumn(name, "boolean");
+    }
+    date(name) {
+        return this.#addColumn(name, "date");
+    }
+    timestamp(name) {
+        return this.#addColumn(name, "timestamp");
+    }
+    json(name) {
+        return this.#addColumn(name, "json");
+    }
+    binary(name) {
+        return this.#addColumn(name, "binary");
+    }
+    // ─── Shortcuts ────────────────────────────────────────────
+    /**
+     * UUID primary key with Postgres-only `gen_random_uuid()` default.
+     *
+     * **Portability warning — DO NOT use in framework-shipped migration templates.**
+     *
+     * `gen_random_uuid()` is a Postgres-13+ built-in. SQLite and MySQL do NOT
+     * provide a function by that name; calling `id()` in a migration that
+     * runs on those dialects fails at `migrations:run` with a "no such
+     * function" error. The helper is retained for user-app migrations where
+     * the target dialect is known to be Postgres.
+     *
+     * In framework-shipped templates, write the column explicitly and supply
+     * the UUID at INSERT time:
+     *
+     *     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.
+     */
+    id() {
+        return this.uuid("id").primary().defaultTo("gen_random_uuid()");
+    }
+    /**
+     * `created_at` + `updated_at` columns with Postgres-only `DEFAULT NOW()`.
+     *
+     * **Portability warning — DO NOT use in framework-shipped migration templates.**
+     *
+     * `NOW()` is a Postgres/MySQL function — SQLite does NOT recognise it
+     * (SQLite accepts `CURRENT_TIMESTAMP`, not `NOW()`). Calling
+     * `timestamps()` in a migration that runs on SQLite fails at
+     * `migrations:run` with a "no such function" error. The helper is
+     * retained for user-app migrations where the target dialect is known to
+     * be Postgres or MySQL.
+     *
+     * In framework-shipped templates, write the columns explicitly without a
+     * DEFAULT and supply the value at INSERT/UPSERT time:
+     *
+     *     t.timestamp('created_at').notNullable()  // no DEFAULT
+     *     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.
+     */
+    timestamps() {
+        this.timestamp("created_at").notNullable().defaultTo("NOW()");
+        this.timestamp("updated_at").notNullable().defaultTo("NOW()");
+        return this;
+    }
+    // ─── Column modifiers ─────────────────────────────────────
+    primary() {
+        if (this.#currentColumn)
+            this.#currentColumn.primary = true;
+        return this;
+    }
+    notNullable() {
+        if (this.#currentColumn)
+            this.#currentColumn.nullable = false;
+        return this;
+    }
+    nullable() {
+        if (this.#currentColumn)
+            this.#currentColumn.nullable = true;
+        return this;
+    }
+    unique() {
+        if (this.#currentColumn)
+            this.#currentColumn.unique = true;
+        return this;
+    }
+    defaultTo(value) {
+        if (this.#currentColumn)
+            this.#currentColumn.defaultValue = value;
+        return this;
+    }
+    references(table, column = "id") {
+        if (this.#currentColumn)
+            this.#currentColumn.references = { table, column };
+        return this;
+    }
+    // ─── Indexes ──────────────────────────────────────────────
+    index(columns, name) {
+        const cols = Array.isArray(columns) ? columns : [columns];
+        this.#indexes.push({
+            name: name ?? `idx_${this.tableName}_${cols.join("_")}`,
+            columns: cols,
+            unique: false,
+        });
+        return this;
+    }
+    uniqueIndex(columns, name) {
+        const cols = Array.isArray(columns) ? columns : [columns];
+        this.#indexes.push({
+            name: name ?? `idx_${this.tableName}_${cols.join("_")}_unique`,
+            columns: cols,
+            unique: true,
+        });
+        return this;
+    }
+    // ─── Accessors ────────────────────────────────────────────
+    getColumns() {
+        return [...this.#columns];
+    }
+    getIndexes() {
+        return [...this.#indexes];
+    }
+    /** Compile to SQL statements via the Rust compiler. */
+    toStatements(dialect = getAtlasDialect()) {
+        const spec = {
+            kind: "createTable",
+            table: this.tableName,
+            columns: this.#columns.map((c) => ({
+                name: c.name,
+                kind: TYPE_KIND_MAP[c.type],
+                length: c.length ?? null,
+                precision: c.precision ?? null,
+                scale: c.scale ?? null,
+                nullable: c.nullable,
+                primary: c.primary,
+                unique: c.unique,
+                default: c.defaultValue ?? null,
+                references: c.references ?? null,
+            })),
+            indexes: this.#indexes.map((i) => ({
+                name: i.name,
+                columns: i.columns,
+                unique: i.unique,
+            })),
+            ifNotExists: false,
+        };
+        return compileStatementNative(spec, dialect).statements;
+    }
+    #addColumn(name, type) {
+        const col = {
+            name,
+            type,
+            nullable: true,
+            primary: false,
+            unique: false,
+        };
+        this.#columns.push(col);
+        this.#currentColumn = col;
+        return this;
+    }
+}
+//# sourceMappingURL=TableBuilder.js.map

package/dist/schema/TableBuilder.js.map

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

package/dist/schema/types.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Shared schema types — column type names, definitions, and the
+ * mapping from logical TS types to the Rust ColumnTypeKind.
+ */
+export type ColumnType = "string" | "text" | "integer" | "bigInteger" | "decimal" | "boolean" | "date" | "timestamp" | "uuid" | "json" | "binary";
+/** Maps our logical type names to the ColumnTypeKind expected by the Rust compiler. */
+export declare const TYPE_KIND_MAP: Record<ColumnType, string>;
+export interface ColumnDefinition {
+    name: string;
+    type: ColumnType;
+    length?: number;
+    precision?: number;
+    scale?: number;
+    nullable: boolean;
+    primary: boolean;
+    unique: boolean;
+    defaultValue?: string;
+    references?: {
+        table: string;
+        column: string;
+    };
+}
+export interface IndexDefinition {
+    name: string;
+    columns: string[];
+    unique: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/schema/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,UAAU,GACnB,QAAQ,GACR,MAAM,GACN,SAAS,GACT,YAAY,GACZ,SAAS,GACT,SAAS,GACT,MAAM,GACN,WAAW,GACX,MAAM,GACN,MAAM,GACN,QAAQ,CAAC;AAEZ,uFAAuF;AACvF,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAYpD,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/C;AAED,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;CAChB"}

package/dist/schema/types.js

@@ -0,0 +1,19 @@
+/**
+ * Shared schema types — column type names, definitions, and the
+ * mapping from logical TS types to the Rust ColumnTypeKind.
+ */
+/** Maps our logical type names to the ColumnTypeKind expected by the Rust compiler. */
+export const TYPE_KIND_MAP = {
+    string: "string",
+    text: "text",
+    integer: "integer",
+    bigInteger: "bigInteger",
+    decimal: "decimal",
+    boolean: "boolean",
+    date: "date",
+    timestamp: "timestamp",
+    uuid: "uuid",
+    json: "json",
+    binary: "binary",
+};
+//# sourceMappingURL=types.js.map

package/dist/schema/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/schema/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAeH,uFAAuF;AACvF,MAAM,CAAC,MAAM,aAAa,GAA+B;IACxD,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,YAAY;IACxB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,WAAW;IACtB,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;CAChB,CAAC"}

package/dist/services/db.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Default `db` singleton — Adonis Lucid–style ergonomic access to the
+ * configured database connection.
+ *
+ *   import db from '@c9up/atlas/services/db'
+ *
+ *   const rows = await db.query('SELECT * FROM users WHERE id = ?', [id])
+ *
+ * Populated by `AtlasProvider.boot()`. The instance is whatever the
+ * `database.connections[default]` config block resolves to (typically
+ * a `NapiDbAdapter` wrapping the Rust sqlite driver, but apps can
+ * swap in a custom `AsyncDatabaseConnection` through the provider's
+ * container hooks).
+ */
+import type { AsyncDatabaseConnection } from "../adapters/NapiDbAdapter.js";
+/** @internal Bind the singleton (called by AtlasProvider). */
+export declare function setDb(connection: AsyncDatabaseConnection): void;
+/** @internal Read the singleton (or `undefined` pre-boot). */
+export declare function getDb(): AsyncDatabaseConnection | undefined;
+declare const db: AsyncDatabaseConnection;
+export default db;
+//# sourceMappingURL=db.d.ts.map

package/dist/services/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/services/db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAI5E,8DAA8D;AAC9D,wBAAgB,KAAK,CAAC,UAAU,EAAE,uBAAuB,GAAG,IAAI,CAE/D;AAED,8DAA8D;AAC9D,wBAAgB,KAAK,IAAI,uBAAuB,GAAG,SAAS,CAE3D;AAED,QAAA,MAAM,EAAE,EAAE,uBAaR,CAAC;AAEH,eAAe,EAAE,CAAC"}

package/dist/services/db.js

@@ -0,0 +1,37 @@
+/**
+ * Default `db` singleton — Adonis Lucid–style ergonomic access to the
+ * configured database connection.
+ *
+ *   import db from '@c9up/atlas/services/db'
+ *
+ *   const rows = await db.query('SELECT * FROM users WHERE id = ?', [id])
+ *
+ * Populated by `AtlasProvider.boot()`. The instance is whatever the
+ * `database.connections[default]` config block resolves to (typically
+ * a `NapiDbAdapter` wrapping the Rust sqlite driver, but apps can
+ * swap in a custom `AsyncDatabaseConnection` through the provider's
+ * container hooks).
+ */
+let instance;
+/** @internal Bind the singleton (called by AtlasProvider). */
+export function setDb(connection) {
+    instance = connection;
+}
+/** @internal Read the singleton (or `undefined` pre-boot). */
+export function getDb() {
+    return instance;
+}
+const db = new Proxy({}, {
+    get(_target, prop) {
+        if (!instance) {
+            throw new Error("[atlas] db singleton accessed before AtlasProvider.boot() ran. " +
+                "Check that `@c9up/atlas/provider` is listed in your reamrc.ts " +
+                "providers and that `config/database.ts` defines at least one " +
+                "connection.");
+        }
+        const value = Reflect.get(instance, prop, instance);
+        return typeof value === "function" ? value.bind(instance) : value;
+    },
+});
+export default db;
+//# sourceMappingURL=db.js.map

package/dist/services/db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../../src/services/db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,IAAI,QAA6C,CAAC;AAElD,8DAA8D;AAC9D,MAAM,UAAU,KAAK,CAAC,UAAmC;IACxD,QAAQ,GAAG,UAAU,CAAC;AACvB,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,KAAK;IACpB,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED,MAAM,EAAE,GAA4B,IAAI,KAAK,CAAC,EAA6B,EAAE;IAC5E,GAAG,CAAC,OAAO,EAAE,IAAI;QAChB,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACd,iEAAiE;gBAChE,gEAAgE;gBAChE,+DAA+D;gBAC/D,aAAa,CACd,CAAC;QACH,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QACpD,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACnE,CAAC;CACD,CAAC,CAAC;AAEH,eAAe,EAAE,CAAC"}

package/dist/testing/DatabaseCleanup.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Database cleanup utilities for testing.
+ *
+ * @implements MISS-19
+ */
+import type { AsyncDatabaseConnection } from "../adapters/NapiDbAdapter.js";
+/**
+ * Wrap a test in a savepoint that is rolled back after.
+ */
+export declare function useTransaction(db: AsyncDatabaseConnection): Promise<() => Promise<void>>;
+/**
+ * Truncate all user tables (excludes _migrations and internal tables).
+ *
+ * The SELECT on `sqlite_master` is SQLite-specific introspection and is kept
+ * as raw SQL intentionally — it's not a user query. The resulting DELETEs
+ * go through the Rust compiler.
+ */
+export declare function truncateAll(db: AsyncDatabaseConnection): Promise<void>;
+//# sourceMappingURL=DatabaseCleanup.d.ts.map

package/dist/testing/DatabaseCleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatabaseCleanup.d.ts","sourceRoot":"","sources":["../../src/testing/DatabaseCleanup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAG5E;;GAEG;AACH,wBAAsB,cAAc,CACnC,EAAE,EAAE,uBAAuB,GACzB,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAM9B;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,EAAE,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB5E"}

package/dist/testing/DatabaseCleanup.js

@@ -0,0 +1,40 @@
+/**
+ * Database cleanup utilities for testing.
+ *
+ * @implements MISS-19
+ */
+import { compileStatementNative, getAtlasDialect } from "../query/native.js";
+/**
+ * Wrap a test in a savepoint that is rolled back after.
+ */
+export async function useTransaction(db) {
+    await db.execute("SAVEPOINT test_savepoint");
+    return async () => {
+        await db.execute("ROLLBACK TO SAVEPOINT test_savepoint");
+        await db.execute("RELEASE SAVEPOINT test_savepoint");
+    };
+}
+/**
+ * Truncate all user tables (excludes _migrations and internal tables).
+ *
+ * The SELECT on `sqlite_master` is SQLite-specific introspection and is kept
+ * as raw SQL intentionally — it's not a user query. The resulting DELETEs
+ * go through the Rust compiler.
+ */
+export async function truncateAll(db) {
+    // SQL LIKE `_` is a single-char wildcard, not a literal underscore.
+    // `NOT LIKE '_%'` without `ESCAPE` matches NOTHING (every non-empty name
+    // matches `_%`). The `ESCAPE '\'` clause makes `\_` a literal underscore,
+    // so the exclusion targets only names starting with `_` (the convention
+    // for framework-private tables, including `_migrations`).
+    const tables = await db.query("SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE '\\_%' ESCAPE '\\' AND name NOT LIKE 'sqlite_%'");
+    const dialect = getAtlasDialect();
+    for (const row of tables) {
+        const name = row.name;
+        if (typeof name !== "string")
+            continue;
+        const compiled = compileStatementNative({ kind: "delete", table: name, wheres: [] }, dialect);
+        await db.execute(compiled.statements[0], compiled.params);
+    }
+}
+//# sourceMappingURL=DatabaseCleanup.js.map

package/dist/testing/DatabaseCleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatabaseCleanup.js","sourceRoot":"","sources":["../../src/testing/DatabaseCleanup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE7E;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,EAA2B;IAE3B,MAAM,EAAE,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAC7C,OAAO,KAAK,IAAI,EAAE;QACjB,MAAM,EAAE,CAAC,OAAO,CAAC,sCAAsC,CAAC,CAAC;QACzD,MAAM,EAAE,CAAC,OAAO,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,EAA2B;IAC5D,oEAAoE;IACpE,yEAAyE;IACzE,0EAA0E;IAC1E,wEAAwE;IACxE,0DAA0D;IAC1D,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,KAAK,CAC5B,qHAAqH,CACrH,CAAC;IACF,MAAM,OAAO,GAAG,eAAe,EAAE,CAAC;IAClC,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;QACtB,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,SAAS;QACvC,MAAM,QAAQ,GAAG,sBAAsB,CACtC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAC3C,OAAO,CACP,CAAC;QACF,MAAM,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3D,CAAC;AACF,CAAC"}