@c9up/atlas 0.1.3 → 0.1.5

package/dist/query/QueryBuilder.d.ts.map

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

package/dist/query/QueryBuilder.js

@@ -0,0 +1,310 @@
+/**
+ * Fluent Query Builder — with advanced features (CTE, subqueries, unions, window functions).
+ *
+ * @implements FR31, FR32, FR33, FR36, FR37
+ */
+import { AtlasError } from "../errors.js";
+import { assertValidIdentifier } from "../utils/identifier.js";
+import { compileStatementNative, getAtlasDialect, } from "./native.js";
+const WHERE_OPERATORS = new Set([
+    "=",
+    "!=",
+    ">",
+    ">=",
+    "<",
+    "<=",
+    "LIKE",
+    "IN",
+    "NOT IN",
+    "IS NULL",
+    "IS NOT NULL",
+]);
+function isWhereOperator(v) {
+    return typeof v === "string" && WHERE_OPERATORS.has(v);
+}
+/** Typed raw SQL with parameterized values. */
+export class RawSql {
+    sql;
+    params;
+    constructor(sql, params = []) {
+        this.sql = sql;
+        this.params = params;
+    }
+    /** Tagged template literal for raw SQL with automatic parameterization. */
+    static sql(strings, ...values) {
+        let sql = "";
+        const params = [];
+        let paramIndex = 1;
+        for (let i = 0; i < strings.length; i++) {
+            sql += strings[i];
+            if (i < values.length) {
+                if (values[i] instanceof RawSql) {
+                    // Inline raw SQL fragments — re-index their $N placeholders
+                    const raw = values[i];
+                    let remapped = raw.sql;
+                    for (let j = raw.params.length; j >= 1; j--) {
+                        remapped = remapped.replace(new RegExp(`\\$${j}(?!\\d)`, "g"), `$${paramIndex + j - 1}`);
+                    }
+                    sql += remapped;
+                    params.push(...raw.params);
+                    paramIndex += raw.params.length;
+                }
+                else {
+                    sql += `$${paramIndex++}`;
+                    params.push(values[i]);
+                }
+            }
+        }
+        return new RawSql(sql, params);
+    }
+}
+// Identifier quoting and SQL compilation now handled by Rust (ream-query crate).
+// The TS QueryBuilder is a thin wrapper that serializes to JSON and calls the Rust compiler.
+/**
+ * Fluent query builder — type-safe, composable, with advanced features.
+ */
+export class QueryBuilder {
+    #table;
+    #select = ["*"];
+    #where = [];
+    #orderBy = [];
+    #groupBy = [];
+    #having = [];
+    #limit;
+    #offset;
+    #preload = [];
+    #ctes = [];
+    #unions = [];
+    #distinct = false;
+    /** SQL dialect for compilation — explicit override or process default. */
+    #dialect;
+    constructor(table, options) {
+        this.#table = table;
+        this.#dialect = options?.dialect ?? getAtlasDialect();
+    }
+    /** SELECT DISTINCT. */
+    distinct() {
+        this.#distinct = true;
+        return this;
+    }
+    /** Select specific columns (supports expressions like 'COUNT(*) AS total'). */
+    select(...columns) {
+        if (columns.length === 0) {
+            throw new AtlasError("EMPTY_SELECT", "select() requires at least one column");
+        }
+        this.#select = columns;
+        return this;
+    }
+    /** Add a WHERE condition. */
+    where(column, operatorOrValue, value) {
+        if (value === undefined) {
+            this.#where.push({
+                column,
+                operator: "=",
+                value: operatorOrValue,
+                type: "and",
+            });
+        }
+        else {
+            if (!isWhereOperator(operatorOrValue)) {
+                throw new AtlasError("INVALID_OPERATOR", `Invalid WHERE operator: ${String(operatorOrValue)}`);
+            }
+            this.#where.push({
+                column,
+                operator: operatorOrValue,
+                value,
+                type: "and",
+            });
+        }
+        return this;
+    }
+    /** Add an OR WHERE condition. */
+    orWhere(column, operatorOrValue, value) {
+        if (value === undefined) {
+            this.#where.push({
+                column,
+                operator: "=",
+                value: operatorOrValue,
+                type: "or",
+            });
+        }
+        else {
+            if (!isWhereOperator(operatorOrValue)) {
+                throw new AtlasError("INVALID_OPERATOR", `Invalid WHERE operator: ${String(operatorOrValue)}`);
+            }
+            this.#where.push({
+                column,
+                operator: operatorOrValue,
+                value,
+                type: "or",
+            });
+        }
+        return this;
+    }
+    /** WHERE column IN (values). */
+    whereIn(column, values) {
+        this.#where.push({ column, operator: "IN", value: values, type: "and" });
+        return this;
+    }
+    /** WHERE column IS NULL. */
+    whereNull(column) {
+        this.#where.push({ column, operator: "IS NULL", value: null, type: "and" });
+        return this;
+    }
+    /** WHERE column IS NOT NULL. */
+    whereNotNull(column) {
+        this.#where.push({
+            column,
+            operator: "IS NOT NULL",
+            value: null,
+            type: "and",
+        });
+        return this;
+    }
+    /** WHERE EXISTS (subquery). Subquery is deferred — toSQL() called at build time. */
+    whereExists(subquery) {
+        this.#where.push({ kind: "exists", subquery, type: "and" });
+        return this;
+    }
+    /** GROUP BY columns. */
+    groupBy(...columns) {
+        this.#groupBy.push(...columns);
+        return this;
+    }
+    /** HAVING condition (used after GROUP BY). Supports aggregate expressions. */
+    having(column, operatorOrValue, value) {
+        if (value === undefined) {
+            this.#having.push({
+                column,
+                operator: "=",
+                value: operatorOrValue,
+                type: "and",
+            });
+        }
+        else {
+            if (!isWhereOperator(operatorOrValue)) {
+                throw new AtlasError("INVALID_OPERATOR", `Invalid HAVING operator: ${String(operatorOrValue)}`);
+            }
+            this.#having.push({
+                column,
+                operator: operatorOrValue,
+                value,
+                type: "and",
+            });
+        }
+        return this;
+    }
+    /** ORDER BY column. */
+    orderBy(column, direction = "asc") {
+        this.#orderBy.push({ column, direction });
+        return this;
+    }
+    /** LIMIT results. */
+    limit(n) {
+        if (n < 0) {
+            throw new AtlasError("INVALID_LIMIT", "limit must be >= 0");
+        }
+        this.#limit = n;
+        return this;
+    }
+    /** OFFSET results. */
+    offset(n) {
+        if (n < 0) {
+            throw new AtlasError("INVALID_OFFSET", "offset must be >= 0");
+        }
+        this.#offset = n;
+        return this;
+    }
+    /** Paginate results. */
+    paginate(page, perPage = 20) {
+        if (page < 1) {
+            throw new AtlasError("INVALID_PAGE", "page must be >= 1");
+        }
+        if (perPage < 1) {
+            throw new AtlasError("INVALID_PER_PAGE", "perPage must be >= 1");
+        }
+        this.#limit = perPage;
+        this.#offset = (page - 1) * perPage;
+        return this;
+    }
+    /** Eager-load a relation. */
+    preload(relation) {
+        this.#preload.push(relation);
+        return this;
+    }
+    /** WITH (Common Table Expression). */
+    with(name, query) {
+        assertValidIdentifier(name, "CTE name", (msg) => new AtlasError("INVALID_CTE_NAME", msg));
+        this.#ctes.push({ name, query });
+        return this;
+    }
+    /** UNION with another query (wrapped in parentheses). */
+    union(query) {
+        this.#unions.push({ query, all: false });
+        return this;
+    }
+    /** UNION ALL with another query (wrapped in parentheses). */
+    unionAll(query) {
+        this.#unions.push({ query, all: true });
+        return this;
+    }
+    /**
+     * Serialize the query description to JSON for the Rust compiler.
+     */
+    #toQueryDescription() {
+        // Serialize CTEs — pre-compile sub-queries
+        const ctes = this.#ctes.map((cte) => {
+            if (cte.query instanceof RawSql) {
+                return { name: cte.name, sql: cte.query.sql, params: cte.query.params };
+            }
+            const sub = cte.query.toSQL();
+            return { name: cte.name, sql: sub.sql, params: sub.params };
+        });
+        // Serialize WHERE clauses
+        const wheres = this.#where.map((w) => {
+            if ("kind" in w) {
+                const sub = w.subquery.#toQueryDescription();
+                return { kind: "exists", subquery: sub, type: w.type };
+            }
+            return {
+                column: w.column,
+                operator: w.operator,
+                value: w.value,
+                type: w.type,
+            };
+        });
+        // Serialize UNIONs — pre-compile sub-queries
+        const unions = this.#unions.map((u) => {
+            const sub = u.query.toSQL();
+            return { sql: sub.sql, params: sub.params, all: u.all };
+        });
+        return {
+            table: this.#table,
+            select: this.#select,
+            wheres,
+            orderBy: this.#orderBy,
+            groupBy: this.#groupBy,
+            having: this.#having,
+            limit: this.#limit ?? null,
+            offset: this.#offset ?? null,
+            distinct: this.#distinct,
+            ctes,
+            unions,
+        };
+    }
+    /** Build the SQL query string via the Rust compiler. */
+    toSQL() {
+        const desc = this.#toQueryDescription();
+        const compiled = compileStatementNative({ kind: "select", ...desc }, this.#dialect);
+        return { sql: compiled.statements[0], params: compiled.params };
+    }
+    /** Get the table name. */
+    getTable() {
+        return this.#table;
+    }
+    /** Get preloaded relations. */
+    getPreloads() {
+        return [...this.#preload];
+    }
+}
+//# sourceMappingURL=QueryBuilder.js.map

package/dist/query/QueryBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryBuilder.js","sourceRoot":"","sources":["../../src/query/QueryBuilder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAEN,sBAAsB,EACtB,eAAe,GACf,MAAM,aAAa,CAAC;AAerB,MAAM,eAAe,GAAG,IAAI,GAAG,CAAS;IACvC,GAAG;IACH,IAAI;IACJ,GAAG;IACH,IAAI;IACJ,GAAG;IACH,IAAI;IACJ,MAAM;IACN,IAAI;IACJ,QAAQ;IACR,SAAS;IACT,aAAa;CACb,CAAC,CAAC;AAEH,SAAS,eAAe,CAAC,CAAU;IAClC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACxD,CAAC;AAgCD,+CAA+C;AAC/C,MAAM,OAAO,MAAM;IACT,GAAG,CAAS;IACZ,MAAM,CAAY;IAE3B,YAAY,GAAW,EAAE,SAAoB,EAAE;QAC9C,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACtB,CAAC;IAED,2EAA2E;IAC3E,MAAM,CAAC,GAAG,CAAC,OAA6B,EAAE,GAAG,MAAiB;QAC7D,IAAI,GAAG,GAAG,EAAE,CAAC;QACb,MAAM,MAAM,GAAc,EAAE,CAAC;QAC7B,IAAI,UAAU,GAAG,CAAC,CAAC;QAEnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;YAClB,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;gBACvB,IAAI,MAAM,CAAC,CAAC,CAAC,YAAY,MAAM,EAAE,CAAC;oBACjC,4DAA4D;oBAC5D,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAW,CAAC;oBAChC,IAAI,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC;oBACvB,KAAK,IAAI,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;wBAC7C,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAC1B,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,EACjC,IAAI,UAAU,GAAG,CAAC,GAAG,CAAC,EAAE,CACxB,CAAC;oBACH,CAAC;oBACD,GAAG,IAAI,QAAQ,CAAC;oBAChB,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;oBAC3B,UAAU,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC;gBACjC,CAAC;qBAAM,CAAC;oBACP,GAAG,IAAI,IAAI,UAAU,EAAE,EAAE,CAAC;oBAC1B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;gBACxB,CAAC;YACF,CAAC;QACF,CAAC;QAED,OAAO,IAAI,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAChC,CAAC;CACD;AAED,iFAAiF;AACjF,6FAA6F;AAE7F;;GAEG;AACH,MAAM,OAAO,YAAY;IACxB,MAAM,CAAS;IACf,OAAO,GAAa,CAAC,GAAG,CAAC,CAAC;IAC1B,MAAM,GAAsC,EAAE,CAAC;IAC/C,QAAQ,GAAoB,EAAE,CAAC;IAC/B,QAAQ,GAAa,EAAE,CAAC;IACxB,OAAO,GAAkB,EAAE,CAAC;IAC5B,MAAM,CAAU;IAChB,OAAO,CAAU;IACjB,QAAQ,GAAa,EAAE,CAAC;IACxB,KAAK,GAAoB,EAAE,CAAC;IAC5B,OAAO,GAAiD,EAAE,CAAC;IAC3D,SAAS,GAAG,KAAK,CAAC;IAClB,0EAA0E;IAC1E,QAAQ,CAAe;IAEvB,YAAY,KAAa,EAAE,OAAoC;QAC9D,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,QAAQ,GAAG,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,CAAC;IACvD,CAAC;IAED,uBAAuB;IACvB,QAAQ;QACP,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,OAAO,IAAI,CAAC;IACb,CAAC;IAED,+EAA+E;IAC/E,MAAM,CAAC,GAAG,OAAiB;QAC1B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,UAAU,CACnB,cAAc,EACd,uCAAuC,CACvC,CAAC;QACH,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,OAAO,IAAI,CAAC;IACb,CAAC;IAED,6BAA6B;IAC7B,KAAK,CACJ,MAAc,EACd,eAAwC,EACxC,KAAe;QAEf,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;gBAChB,MAAM;gBACN,QAAQ,EAAE,GAAG;gBACb,KAAK,EAAE,eAAe;gBACtB,IAAI,EAAE,KAAK;aACX,CAAC,CAAC;QACJ,CAAC;aAAM,CAAC;YACP,IAAI,CAAC,eAAe,CAAC,eAAe,CAAC,EAAE,CAAC;gBACvC,MAAM,IAAI,UAAU,CACnB,kBAAkB,EAClB,2BAA2B,MAAM,CAAC,eAAe,CAAC,EAAE,CACpD,CAAC;YACH,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;gBAChB,MAAM;gBACN,QAAQ,EAAE,eAAe;gBACzB,KAAK;gBACL,IAAI,EAAE,KAAK;aACX,CAAC,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACb,CAAC;IAED,iCAAiC;IACjC,OAAO,CACN,MAAc,EACd,eAAwC,EACxC,KAAe;QAEf,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;gBAChB,MAAM;gBACN,QAAQ,EAAE,GAAG;gBACb,KAAK,EAAE,eAAe;gBACtB,IAAI,EAAE,IAAI;aACV,CAAC,CAAC;QACJ,CAAC;aAAM,CAAC;YACP,IAAI,CAAC,eAAe,CAAC,eAAe,CAAC,EAAE,CAAC;gBACvC,MAAM,IAAI,UAAU,CACnB,kBAAkB,EAClB,2BAA2B,MAAM,CAAC,eAAe,CAAC,EAAE,CACpD,CAAC;YACH,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;gBAChB,MAAM;gBACN,QAAQ,EAAE,eAAe;gBACzB,KAAK;gBACL,IAAI,EAAE,IAAI;aACV,CAAC,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACb,CAAC;IAED,gCAAgC;IAChC,OAAO,CAAC,MAAc,EAAE,MAAiB;QACxC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACzE,OAAO,IAAI,CAAC;IACb,CAAC;IAED,4BAA4B;IAC5B,SAAS,CAAC,MAAc;QACvB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5E,OAAO,IAAI,CAAC;IACb,CAAC;IAED,gCAAgC;IAChC,YAAY,CAAC,MAAc;QAC1B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YAChB,MAAM;YACN,QAAQ,EAAE,aAAa;YACvB,KAAK,EAAE,IAAI;YACX,IAAI,EAAE,KAAK;SACX,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACb,CAAC;IAED,oFAAoF;IACpF,WAAW,CAAC,QAAsB;QACjC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5D,OAAO,IAAI,CAAC;IACb,CAAC;IAED,wBAAwB;IACxB,OAAO,CAAC,GAAG,OAAiB;QAC3B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;QAC/B,OAAO,IAAI,CAAC;IACb,CAAC;IAED,8EAA8E;IAC9E,MAAM,CACL,MAAc,EACd,eAAwC,EACxC,KAAe;QAEf,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;gBACjB,MAAM;gBACN,QAAQ,EAAE,GAAG;gBACb,KAAK,EAAE,eAAe;gBACtB,IAAI,EAAE,KAAK;aACX,CAAC,CAAC;QACJ,CAAC;aAAM,CAAC;YACP,IAAI,CAAC,eAAe,CAAC,eAAe,CAAC,EAAE,CAAC;gBACvC,MAAM,IAAI,UAAU,CACnB,kBAAkB,EAClB,4BAA4B,MAAM,CAAC,eAAe,CAAC,EAAE,CACrD,CAAC;YACH,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;gBACjB,MAAM;gBACN,QAAQ,EAAE,eAAe;gBACzB,KAAK;gBACL,IAAI,EAAE,KAAK;aACX,CAAC,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACb,CAAC;IAED,uBAAuB;IACvB,OAAO,CAAC,MAAc,EAAE,YAA4B,KAAK;QACxD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC;IACb,CAAC;IAED,qBAAqB;IACrB,KAAK,CAAC,CAAS;QACd,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACX,MAAM,IAAI,UAAU,CAAC,eAAe,EAAE,oBAAoB,CAAC,CAAC;QAC7D,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAChB,OAAO,IAAI,CAAC;IACb,CAAC;IAED,sBAAsB;IACtB,MAAM,CAAC,CAAS;QACf,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACX,MAAM,IAAI,UAAU,CAAC,gBAAgB,EAAE,qBAAqB,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC;IACb,CAAC;IAED,wBAAwB;IACxB,QAAQ,CAAC,IAAY,EAAE,OAAO,GAAG,EAAE;QAClC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;YACd,MAAM,IAAI,UAAU,CAAC,cAAc,EAAE,mBAAmB,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YACjB,MAAM,IAAI,UAAU,CAAC,kBAAkB,EAAE,sBAAsB,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC;QACpC,OAAO,IAAI,CAAC;IACb,CAAC;IAED,6BAA6B;IAC7B,OAAO,CAAC,QAAgB;QACvB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IACb,CAAC;IAED,sCAAsC;IACtC,IAAI,CAAC,IAAY,EAAE,KAA4B;QAC9C,qBAAqB,CACpB,IAAI,EACJ,UAAU,EACV,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,UAAU,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAChD,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC;IACb,CAAC;IAED,yDAAyD;IACzD,KAAK,CAAC,KAAmB;QACxB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC;IACb,CAAC;IAED,6DAA6D;IAC7D,QAAQ,CAAC,KAAmB;QAC3B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;OAEG;IACH,mBAAmB;QAClB,2CAA2C;QAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YACnC,IAAI,GAAG,CAAC,KAAK,YAAY,MAAM,EAAE,CAAC;gBACjC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YACzE,CAAC;YACD,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YAC9B,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;QAC7D,CAAC,CAAC,CAAC;QAEH,0BAA0B;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACpC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;gBACjB,MAAM,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,mBAAmB,EAAE,CAAC;gBAC7C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACxD,CAAC;YACD,OAAO;gBACN,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,IAAI,EAAE,CAAC,CAAC,IAAI;aACZ,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,6CAA6C;QAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACrC,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YAC5B,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;QACzD,CAAC,CAAC,CAAC;QAEH,OAAO;YACN,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,MAAM,EAAE,IAAI,CAAC,OAAO;YACpB,MAAM;YACN,OAAO,EAAE,IAAI,CAAC,QAAQ;YACtB,OAAO,EAAE,IAAI,CAAC,QAAQ;YACtB,MAAM,EAAE,IAAI,CAAC,OAAO;YACpB,KAAK,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI;YAC1B,MAAM,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI;YAC5B,QAAQ,EAAE,IAAI,CAAC,SAAS;YACxB,IAAI;YACJ,MAAM;SACN,CAAC;IACH,CAAC;IAED,wDAAwD;IACxD,KAAK;QACJ,MAAM,IAAI,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,sBAAsB,CACtC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,EAC3B,IAAI,CAAC,QAAQ,CACb,CAAC;QACF,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;IACjE,CAAC;IAED,0BAA0B;IAC1B,QAAQ;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACpB,CAAC;IAED,+BAA+B;IAC/B,WAAW;QACV,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC;CACD"}

package/dist/query/native.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Native query compiler loader — loads the Rust NAPI binary.
+ *
+ * @implements FR36
+ */
+export type AtlasDialect = "sqlite" | "postgres" | "mysql";
+export declare function setAtlasDialect(dialect: AtlasDialect): void;
+export declare function getAtlasDialect(): AtlasDialect;
+export interface CompiledStatement {
+    statements: string[];
+    params: unknown[];
+}
+/**
+ * Compile any statement (SELECT/INSERT/UPDATE/DELETE/DDL) via the Rust compiler.
+ * `spec` is a tagged object: `{ kind: 'select' | 'insert' | ..., ... }`.
+ */
+export declare function compileStatementNative(spec: object, dialect?: AtlasDialect): CompiledStatement;
+//# sourceMappingURL=native.d.ts.map

package/dist/query/native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../../src/query/native.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoCH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;AAK3D,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAE3D;AAED,wBAAgB,eAAe,IAAI,YAAY,CAE9C;AAED,MAAM,WAAW,iBAAiB;IACjC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,OAAO,EAAE,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,YAA6B,GACpC,iBAAiB,CAQnB"}

package/dist/query/native.js

@@ -0,0 +1,49 @@
+/**
+ * Native query compiler loader — loads the Rust NAPI binary.
+ *
+ * @implements FR36
+ */
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+import { arch, platform } from "node:process";
+import { fileURLToPath } from "node:url";
+const require2 = createRequire(import.meta.url);
+const __dirname2 = dirname(fileURLToPath(import.meta.url));
+const platformMap = {
+    "linux-x64": "linux-x64-gnu",
+    "darwin-x64": "darwin-x64",
+    "darwin-arm64": "darwin-arm64",
+    "win32-x64": "win32-x64-msvc",
+    "linux-arm64": "linux-arm64-gnu",
+};
+let native;
+let loadError;
+try {
+    const suffix = platformMap[`${platform}-${arch}`];
+    if (suffix) {
+        native = require2(join(__dirname2, `../../index.${suffix}.node`));
+    }
+}
+catch (e) {
+    loadError = e;
+}
+/** Module-level default dialect. Set by AtlasProvider at boot. */
+let defaultDialect = "sqlite";
+export function setAtlasDialect(dialect) {
+    defaultDialect = dialect;
+}
+export function getAtlasDialect() {
+    return defaultDialect;
+}
+/**
+ * Compile any statement (SELECT/INSERT/UPDATE/DELETE/DDL) via the Rust compiler.
+ * `spec` is a tagged object: `{ kind: 'select' | 'insert' | ..., ... }`.
+ */
+export function compileStatementNative(spec, dialect = defaultDialect) {
+    if (!native) {
+        throw new Error(`[ATLAS_NAPI_NOT_FOUND] Rust query compiler not available: ${loadError ?? "binary not found"}`);
+    }
+    const json = native.compileStatement(JSON.stringify(spec), dialect);
+    return JSON.parse(json);
+}
+//# sourceMappingURL=native.js.map

package/dist/query/native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.js","sourceRoot":"","sources":["../../src/query/native.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChD,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE3D,MAAM,WAAW,GAA2B;IAC3C,WAAW,EAAE,eAAe;IAC5B,YAAY,EAAE,YAAY;IAC1B,cAAc,EAAE,cAAc;IAC9B,WAAW,EAAE,gBAAgB;IAC7B,aAAa,EAAE,iBAAiB;CAChC,CAAC;AAOF,IAAI,MAAiC,CAAC;AAEtC,IAAI,SAAkB,CAAC;AAEvB,IAAI,CAAC;IACJ,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,QAAQ,IAAI,IAAI,EAAE,CAAC,CAAC;IAClD,IAAI,MAAM,EAAE,CAAC;QACZ,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,MAAM,OAAO,CAAC,CAAC,CAAC;IACnE,CAAC;AACF,CAAC;AAAC,OAAO,CAAC,EAAE,CAAC;IACZ,SAAS,GAAG,CAAC,CAAC;AACf,CAAC;AAID,kEAAkE;AAClE,IAAI,cAAc,GAAiB,QAAQ,CAAC;AAE5C,MAAM,UAAU,eAAe,CAAC,OAAqB;IACpD,cAAc,GAAG,OAAO,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,eAAe;IAC9B,OAAO,cAAc,CAAC;AACvB,CAAC;AAOD;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACrC,IAAY,EACZ,UAAwB,cAAc;IAEtC,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACd,6DAA6D,SAAS,IAAI,kBAAkB,EAAE,CAC9F,CAAC;IACH,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;IACpE,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC"}

package/dist/schema/Migration.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Migration base class — extend this to create database migrations.
+ *
+ * @implements FR34
+ */
+import type { AtlasDialect } from "../query/native.js";
+import { Schema } from "./SchemaBuilder.js";
+/**
+ * Base class for all migrations.
+ *
+ * Usage:
+ *   import { Migration } from '@c9up/atlas'
+ *
+ *   export default class CreateOrders extends Migration {
+ *     async up() {
+ *       this.schema.createTable('orders', (table) => {
+ *         table.id()
+ *         table.string('status', 50).notNullable().defaultTo("'pending'")
+ *         table.decimal('total', 10, 2).notNullable()
+ *         table.timestamps()
+ *       })
+ *     }
+ *
+ *     async down() {
+ *       this.schema.dropTable('orders')
+ *     }
+ *   }
+ */
+export declare abstract class Migration {
+    #private;
+    readonly schema: Schema;
+    constructor(dialect?: AtlasDialect);
+    /** Apply the migration. */
+    abstract up(): Promise<void> | void;
+    /** Rollback the migration. */
+    abstract down(): Promise<void> | void;
+    /** Helper: raw SQL expression (for DEFAULT values). */
+    raw(expression: string): string;
+    /**
+     * Dialect-aware "current timestamp" helper for column defaults.
+     *
+     * - `sqlite`   → `CURRENT_TIMESTAMP` (the only form SQLite understands)
+     * - `postgres` → `NOW()`
+     * - `mysql`    → `NOW()`
+     *
+     * Previously this always returned `NOW()`, which silently broke SQLite
+     * migrations — `NOW()` is not a recognised function there and the column
+     * default would blow up at DDL compile time.
+     */
+    now(): string;
+    /** Get the SQL statements generated by this migration. */
+    getUpSQL(): Promise<string[]>;
+    getDownSQL(): Promise<string[]>;
+}
+//# sourceMappingURL=Migration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Migration.d.ts","sourceRoot":"","sources":["../../src/schema/Migration.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,8BAAsB,SAAS;;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAGZ,OAAO,CAAC,EAAE,YAAY;IAQlC,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAEnC,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAErC,uDAAuD;IACvD,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAI/B;;;;;;;;;;OAUG;IACH,GAAG,IAAI,MAAM;IAIb,0DAA0D;IACpD,QAAQ,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAM7B,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAKrC"}

package/dist/schema/Migration.js

@@ -0,0 +1,68 @@
+/**
+ * Migration base class — extend this to create database migrations.
+ *
+ * @implements FR34
+ */
+import { Schema } from "./SchemaBuilder.js";
+/**
+ * Base class for all migrations.
+ *
+ * Usage:
+ *   import { Migration } from '@c9up/atlas'
+ *
+ *   export default class CreateOrders extends Migration {
+ *     async up() {
+ *       this.schema.createTable('orders', (table) => {
+ *         table.id()
+ *         table.string('status', 50).notNullable().defaultTo("'pending'")
+ *         table.decimal('total', 10, 2).notNullable()
+ *         table.timestamps()
+ *       })
+ *     }
+ *
+ *     async down() {
+ *       this.schema.dropTable('orders')
+ *     }
+ *   }
+ */
+export class Migration {
+    schema;
+    #dialect;
+    constructor(dialect) {
+        this.schema = new Schema(dialect);
+        // Default to sqlite when no dialect is passed — the generator emits
+        // sqlite-compatible helpers (`CURRENT_TIMESTAMP`) which happen to work
+        // on postgres/mysql too, so this is the safest conservative default.
+        this.#dialect = dialect ?? "sqlite";
+    }
+    /** Helper: raw SQL expression (for DEFAULT values). */
+    raw(expression) {
+        return expression;
+    }
+    /**
+     * Dialect-aware "current timestamp" helper for column defaults.
+     *
+     * - `sqlite`   → `CURRENT_TIMESTAMP` (the only form SQLite understands)
+     * - `postgres` → `NOW()`
+     * - `mysql`    → `NOW()`
+     *
+     * Previously this always returned `NOW()`, which silently broke SQLite
+     * migrations — `NOW()` is not a recognised function there and the column
+     * default would blow up at DDL compile time.
+     */
+    now() {
+        return this.#dialect === "sqlite" ? "CURRENT_TIMESTAMP" : "NOW()";
+    }
+    /** Get the SQL statements generated by this migration. */
+    async getUpSQL() {
+        this.schema.reset();
+        await this.up();
+        return this.schema.toSQL();
+    }
+    async getDownSQL() {
+        this.schema.reset();
+        await this.down();
+        return this.schema.toSQL();
+    }
+}
+//# sourceMappingURL=Migration.js.map

package/dist/schema/Migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Migration.js","sourceRoot":"","sources":["../../src/schema/Migration.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAgB,SAAS;IACrB,MAAM,CAAS;IACf,QAAQ,CAAe;IAEhC,YAAY,OAAsB;QACjC,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC;QAClC,oEAAoE;QACpE,uEAAuE;QACvE,qEAAqE;QACrE,IAAI,CAAC,QAAQ,GAAG,OAAO,IAAI,QAAQ,CAAC;IACrC,CAAC;IAQD,uDAAuD;IACvD,GAAG,CAAC,UAAkB;QACrB,OAAO,UAAU,CAAC;IACnB,CAAC;IAED;;;;;;;;;;OAUG;IACH,GAAG;QACF,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,OAAO,CAAC;IACnE,CAAC;IAED,0DAA0D;IAC1D,KAAK,CAAC,QAAQ;QACb,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,MAAM,IAAI,CAAC,EAAE,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,UAAU;QACf,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;CACD"}

package/dist/schema/MigrationRunner.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Migration Runner — discovers, executes, and tracks database migrations.
+ *
+ * @implements FR34
+ */
+import { type AtlasDialect } from "../query/native.js";
+export interface BatchStmt {
+    sql: string;
+    params?: unknown[];
+}
+export interface DatabaseAdapter {
+    /** Execute a SQL statement with optional parameterized values. */
+    execute(sql: string, params?: unknown[]): Promise<void>;
+    /** Query rows with optional parameterized values. */
+    query<T>(sql: string, params?: unknown[]): Promise<T[]>;
+    /**
+     * Run every statement in `batch` atomically in a single transaction.
+     * Required for migrations (used by `migrate()`/`rollback()` — see story
+     * "Migrations non transactionnelles" in the remediation audit).
+     */
+    runInTransaction?(batch: readonly BatchStmt[]): Promise<number>;
+    /** Close the connection. */
+    close(): Promise<void>;
+}
+export interface MigrationRecord {
+    name: string;
+    batch: number;
+    executed_at: string;
+}
+export type MigrationState = "applied" | "pending";
+export interface MigrationStatus {
+    name: string;
+    status: MigrationState;
+    batch?: number;
+}
+/**
+ * Runs migrations against a database.
+ */
+export declare class MigrationRunner {
+    #private;
+    /**
+     * @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: DatabaseAdapter, options?: {
+        migrationsDir?: string;
+        dialect?: AtlasDialect;
+        tableName?: string;
+    });
+    /** Ensure the ream_migrations tracking table exists. */
+    init(): Promise<void>;
+    /** Get the status of all migrations. */
+    status(): Promise<MigrationStatus[]>;
+    /** Run all pending migrations. */
+    migrate(): Promise<string[]>;
+    /** Rollback the last batch of migrations. */
+    rollback(): Promise<string[]>;
+    /**
+     * Rollback + re-run a specific number of batches (or all if `steps` omitted).
+     * `migrate:refresh` in Lucid parlance.
+     *
+     * @implements Story 32.11
+     */
+    refresh(): Promise<{
+        rolled: string[];
+        executed: string[];
+    }>;
+    /**
+     * 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.
+     */
+    fresh(): Promise<{
+        rolled: string[];
+        executed: string[];
+    }>;
+    /**
+     * Rollback every applied batch (alias for `migrate:reset`).
+     * Returns the list of rolled-back migration names (in rollback order).
+     */
+    reset(): Promise<string[]>;
+    /**
+     * 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.
+     */
+    dryRun(): Promise<Array<{
+        name: string;
+        sql: string[];
+    }>>;
+}
+//# sourceMappingURL=MigrationRunner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MigrationRunner.d.ts","sourceRoot":"","sources":["../../src/schema/MigrationRunner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EAAE,KAAK,YAAY,EAA0B,MAAM,oBAAoB,CAAC;AA2C/E,MAAM,WAAW,SAAS;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC/B,kEAAkE;IAClE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,qDAAqD;IACrD,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IACxD;;;;OAIG;IACH,gBAAgB,CAAC,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAChE,4BAA4B;IAC5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,CAAC;AAEnD,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,qBAAa,eAAe;;IAM3B;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;gBAEF,EAAE,EAAE,eAAe,EACnB,OAAO,CAAC,EAAE;QACT,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,OAAO,CAAC,EAAE,YAAY,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;KACnB;IAWF,wDAAwD;IAClD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA+D3B,wCAAwC;IAClC,MAAM,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAyB1C,kCAAkC;IAC5B,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAmElC,6CAA6C;IACvC,QAAQ,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAuFnC;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAMlE;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAIhE;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAYhC;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CA2G/D"}