@rudderjs/database 1.1.0 → 1.2.0

package/dist/native/schema/schema-builder.js

@@ -0,0 +1,153 @@
+// ─── SchemaBuilder (executor-bound) ────────────────────────
+//
+// Node-capable: the runtime entry point for the schema builder. Holds an
+// {@link Executor} (a connection or a transaction scope) plus a {@link Dialect},
+// compiles a {@link Blueprint} via the pure DDL compiler, and runs the resulting
+// statements. This is what a migration's `up()` / `down()` drives — directly in
+// 7.1, and behind the static `Schema` facade once the migration runner (7.2)
+// binds a builder to the active connection.
+//
+// `hasTable` / `hasColumn` introspect the live database — SQLite via the
+// PRAGMA/`sqlite_master` catalog, Postgres + MySQL via `information_schema`
+// (scoped to `current_schema()` / `DATABASE()` respectively). They branch on
+// `dialect.name`.
+import { NativeNotImplementedError } from '../errors.js';
+import { Blueprint } from './blueprint.js';
+import { AlterBlueprint } from './alter-blueprint.js';
+import { compileCreateTable, compileDropTable, compileAlterTable, compileRenameTable } from './ddl-compiler.js';
+import { rebuildTable } from './rebuild.js';
+export class SchemaBuilder {
+    executor;
+    dialect;
+    constructor(executor, dialect) {
+        this.executor = executor;
+        this.dialect = dialect;
+    }
+    /** `CREATE TABLE` (+ any indexes) from a `Blueprint` callback. */
+    async create(table, build) {
+        const blueprint = new Blueprint(table);
+        build(blueprint);
+        for (const stmt of compileCreateTable(blueprint, this.dialect)) {
+            await this.executor.execute(stmt.sql, stmt.bindings);
+        }
+    }
+    /** `ALTER TABLE` — add/drop/rename/change columns + add/drop indexes and
+     *  foreign keys via a callback. A `.change()` (column type/constraint
+     *  change) is a native `ALTER COLUMN` / `MODIFY` on pg/mysql (7.4b); SQLite
+     *  can't change a column in place, so it routes through the table-rebuild
+     *  dance instead (which requires `change()` to be the only op in the call). */
+    async table(table, build) {
+        const blueprint = new AlterBlueprint(table);
+        build(blueprint);
+        if (this.dialect.name === 'sqlite' && blueprint.columns.some(c => c.change)) {
+            await rebuildTable(this.executor, this.dialect, blueprint);
+            return;
+        }
+        for (const stmt of compileAlterTable(blueprint, this.dialect)) {
+            await this.executor.execute(stmt.sql, stmt.bindings);
+        }
+    }
+    /** Rename a table. */
+    async rename(from, to) {
+        const stmt = compileRenameTable(from, to, this.dialect);
+        await this.executor.execute(stmt.sql, stmt.bindings);
+    }
+    /** `DROP TABLE`. */
+    async drop(table) {
+        const stmt = compileDropTable(table, {}, this.dialect);
+        await this.executor.execute(stmt.sql, stmt.bindings);
+    }
+    /** `DROP TABLE IF EXISTS`. */
+    async dropIfExists(table) {
+        const stmt = compileDropTable(table, { ifExists: true }, this.dialect);
+        await this.executor.execute(stmt.sql, stmt.bindings);
+    }
+    /**
+     * Names of every user table (catalog lookup) — includes the `migrations`
+     * state table, excludes the engine's internal tables (`sqlite_*`).
+     * `information_schema` on pg/mysql, `sqlite_master` on sqlite.
+     */
+    async allTables() {
+        const schemaFn = this.currentSchemaSql();
+        if (schemaFn) {
+            const rows = await this.executor.execute(`SELECT table_name AS name FROM information_schema.tables WHERE table_schema = ${schemaFn} AND table_type = 'BASE TABLE' ORDER BY table_name`, []);
+            // mysql2 may surface the alias upper-cased depending on server config.
+            return rows.map(r => String(r['name'] ?? r['NAME'] ?? r['TABLE_NAME']));
+        }
+        this.requireSqlite('allTables');
+        const rows = await this.executor.execute(`SELECT name FROM sqlite_master WHERE type = 'table' AND name NOT LIKE 'sqlite_%' ORDER BY name`, []);
+        return rows.map(r => String(r['name']));
+    }
+    /**
+     * Drop every user table — the `migrate:fresh` sweep (Laravel's
+     * `Schema::dropAllTables()` analog). Dialect-aware so foreign keys can't
+     * block it: pg drops with `CASCADE`, mysql disables `FOREIGN_KEY_CHECKS`
+     * for the batch (restored after, even on failure), sqlite drops in catalog
+     * order exactly as before.
+     */
+    async dropAllTables() {
+        const tables = await this.allTables();
+        if (tables.length === 0)
+            return;
+        if (this.dialect.name === 'pg') {
+            for (const t of tables) {
+                // A table dropped by an earlier CASCADE is covered by IF EXISTS.
+                await this.executor.execute(`DROP TABLE IF EXISTS ${this.dialect.quoteId(t)} CASCADE`, []);
+            }
+            return;
+        }
+        if (this.dialect.name === 'mysql') {
+            await this.executor.execute('SET FOREIGN_KEY_CHECKS = 0', []);
+            try {
+                for (const t of tables) {
+                    await this.executor.execute(`DROP TABLE IF EXISTS ${this.dialect.quoteId(t)}`, []);
+                }
+            }
+            finally {
+                await this.executor.execute('SET FOREIGN_KEY_CHECKS = 1', []);
+            }
+            return;
+        }
+        for (const t of tables) {
+            await this.drop(t);
+        }
+    }
+    /** Whether `table` exists (catalog lookup). */
+    async hasTable(table) {
+        const schemaFn = this.currentSchemaSql();
+        if (schemaFn) {
+            const rows = await this.executor.execute(`SELECT 1 FROM information_schema.tables WHERE table_schema = ${schemaFn} AND table_name = ${this.dialect.placeholder(0)}`, [table]);
+            return rows.length > 0;
+        }
+        this.requireSqlite('hasTable');
+        const rows = await this.executor.execute(`SELECT name FROM sqlite_master WHERE type = 'table' AND name = ?`, [table]);
+        return rows.length > 0;
+    }
+    /** Whether `table` has a `column` (catalog lookup). */
+    async hasColumn(table, column) {
+        const schemaFn = this.currentSchemaSql();
+        if (schemaFn) {
+            const rows = await this.executor.execute(`SELECT 1 FROM information_schema.columns WHERE table_schema = ${schemaFn} AND table_name = ${this.dialect.placeholder(0)} AND column_name = ${this.dialect.placeholder(1)}`, [table, column]);
+            return rows.length > 0;
+        }
+        this.requireSqlite('hasColumn');
+        // PRAGMA takes an identifier, not a bound value — quote+validate the name.
+        const rows = await this.executor.execute(`PRAGMA table_info(${this.dialect.quoteId(table)})`, []);
+        return rows.some(r => r['name'] === column);
+    }
+    /** The SQL expression naming the active schema/database for dialects that
+     *  introspect via `information_schema`, or `null` for the sqlite path. */
+    currentSchemaSql() {
+        if (this.dialect.name === 'pg')
+            return 'current_schema()';
+        if (this.dialect.name === 'mysql')
+            return 'DATABASE()';
+        return null;
+    }
+    requireSqlite(method) {
+        if (this.dialect.name !== 'sqlite') {
+            throw new NativeNotImplementedError(`SchemaBuilder.${method} on the "${this.dialect.name}" dialect`, 'a later phase');
+        }
+    }
+}
+//# sourceMappingURL=schema-builder.js.map

package/dist/native/schema/schema-builder.js.map

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

package/dist/native/schema/schema-facade.d.ts

@@ -0,0 +1,63 @@
+import type { Blueprint } from './blueprint.js';
+import type { AlterBlueprint } from './alter-blueprint.js';
+import { SchemaBuilder } from './schema-builder.js';
+/**
+ * The Laravel-style `Schema` facade. Static methods delegate to the bound
+ * {@link SchemaBuilder}. The {@link Migrator} owns binding via {@link Schema.use}
+ * / {@link Schema.reset}; migration authors only call the table operations.
+ */
+export declare const Schema: {
+    /** Bind the connection-scoped builder. Called by the migrator. `pretend`
+     *  marks a recording (dry-run) bind — see {@link Schema.connection}. */
+    readonly use: (builder: SchemaBuilder, opts?: {
+        pretend?: boolean;
+    }) => void;
+    /** Unbind. Called by the migrator after each migration. */
+    readonly reset: () => void;
+    /**
+     * The same table operations, scoped to a NAMED connection from
+     * `config/database.ts` (Laravel `Schema::connection('reporting')->create(…)`):
+     *
+     *   await Schema.connection('reporting').create('events', (t) => { … })
+     *
+     * Resolves through the same named-connection seam as `DB.connection()` —
+     * lazy (the connection opens at the first operation) and available wherever
+     * the app has booted, not only inside a migration run. The connection must
+     * use the native engine (`engine: 'native'`); prisma/drizzle connections
+     * throw a clear error.
+     *
+     * Two boundaries:
+     * - Inside a migration, DDL on another connection runs OUTSIDE the
+     *   migrator's batch transaction (a transaction can't span connections) —
+     *   a failed batch rolls back the bound connection only.
+     * - Throws under `migrate --pretend`: the dry-run records the bound
+     *   connection's SQL without executing, and there is no recording seam for
+     *   a second connection — executing its DDL for real would betray the dry run.
+     */
+    readonly connection: (name: string) => ConnectionSchemaOps;
+    readonly create: (table: string, build: (table: Blueprint) => void) => Promise<void>;
+    readonly table: (table: string, build: (table: AlterBlueprint) => void) => Promise<void>;
+    readonly rename: (from: string, to: string) => Promise<void>;
+    readonly drop: (table: string) => Promise<void>;
+    readonly dropIfExists: (table: string) => Promise<void>;
+    readonly hasTable: (table: string) => Promise<boolean>;
+    readonly hasColumn: (table: string, column: string) => Promise<boolean>;
+};
+/** The named-connection table operations returned by {@link Schema.connection}
+ *  — the facade's surface minus the migrator-owned bind/unbind. */
+export interface ConnectionSchemaOps {
+    create(table: string, build: (table: Blueprint) => void): Promise<void>;
+    table(table: string, build: (table: AlterBlueprint) => void): Promise<void>;
+    rename(from: string, to: string): Promise<void>;
+    drop(table: string): Promise<void>;
+    dropIfExists(table: string): Promise<void>;
+    hasTable(table: string): Promise<boolean>;
+    hasColumn(table: string, column: string): Promise<boolean>;
+}
+/** Run `fn` with `builder` bound to {@link Schema}, unbinding afterwards even on
+ *  throw. The migrator wraps each migration's up()/down() in this — `pretend`
+ *  marks the recording (dry-run) bind so `Schema.connection()` can refuse. */
+export declare function withSchema<T>(builder: SchemaBuilder, fn: () => Promise<T> | T, opts?: {
+    pretend?: boolean;
+}): Promise<T>;
+//# sourceMappingURL=schema-facade.d.ts.map

package/dist/native/schema/schema-facade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-facade.d.ts","sourceRoot":"","sources":["../../../src/native/schema/schema-facade.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAqBnD;;;;GAIG;AACH,eAAO,MAAM,MAAM;IACjB;4EACwE;4BAC3D,aAAa,SAAQ;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,KAAQ,IAAI;IAInE,2DAA2D;0BAClD,IAAI;IAKb;;;;;;;;;;;;;;;;;;;OAmBG;gCACc,MAAM,KAAG,mBAAmB;6BAiCzB,MAAM,SAAS,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,KAAG,OAAO,CAAC,IAAI,CAAC;4BAG1D,MAAM,SAAS,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,KAAG,OAAO,CAAC,IAAI,CAAC;4BAG9D,MAAM,MAAM,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;2BAGnC,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;mCAGd,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;+BAG1B,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;gCAGxB,MAAM,UAAU,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;CAGxD,CAAA;AAEV;mEACmE;AACnE,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3E,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/C,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClC,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACzC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CAC3D;AAED;;8EAE8E;AAC9E,wBAAsB,UAAU,CAAC,CAAC,EAChC,OAAO,EAAE,aAAa,EACtB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EACxB,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/B,OAAO,CAAC,CAAC,CAAC,CAOZ"}

package/dist/native/schema/schema-facade.js

@@ -0,0 +1,124 @@
+// ─── Schema facade (Laravel `Schema::`) ────────────────────
+//
+// The static entry point migration files call: `Schema.create(...)`,
+// `Schema.dropIfExists(...)`, etc. It delegates to a {@link SchemaBuilder} the
+// {@link Migrator} binds (`Schema.use(builder)`) for the duration of each
+// migration's `up()` / `down()`, then unbinds (`Schema.reset()`). This mirrors
+// Laravel's facade resolving the schema builder from the active connection.
+//
+// Migrations run serially in a single CLI process, so a module-level "current
+// builder" is sufficient — there's no concurrency to guard. Calling a `Schema`
+// method with nothing bound (e.g. importing `Schema` and using it outside a
+// migration run) throws a clear error rather than a null-deref.
+import { NativeOrmError } from '../errors.js';
+import { resolveConnectionResolver } from '../../registry-bridge.js';
+let current = null;
+// `--pretend` runs bind a RECORDING builder — a `Schema.connection()` call in
+// that window would execute REAL DDL on the named connection while the bound
+// connection only records. Tracked here so connection() can refuse instead.
+let pretending = false;
+function active() {
+    if (!current) {
+        throw new NativeOrmError('NATIVE_SCHEMA_UNBOUND', `[RudderJS ORM native] Schema is not bound to a connection. ` +
+            `Schema methods may only be called from a migration's up()/down() run by the migrator.`);
+    }
+    return current;
+}
+/**
+ * The Laravel-style `Schema` facade. Static methods delegate to the bound
+ * {@link SchemaBuilder}. The {@link Migrator} owns binding via {@link Schema.use}
+ * / {@link Schema.reset}; migration authors only call the table operations.
+ */
+export const Schema = {
+    /** Bind the connection-scoped builder. Called by the migrator. `pretend`
+     *  marks a recording (dry-run) bind — see {@link Schema.connection}. */
+    use(builder, opts = {}) {
+        current = builder;
+        pretending = opts.pretend === true;
+    },
+    /** Unbind. Called by the migrator after each migration. */
+    reset() {
+        current = null;
+        pretending = false;
+    },
+    /**
+     * The same table operations, scoped to a NAMED connection from
+     * `config/database.ts` (Laravel `Schema::connection('reporting')->create(…)`):
+     *
+     *   await Schema.connection('reporting').create('events', (t) => { … })
+     *
+     * Resolves through the same named-connection seam as `DB.connection()` —
+     * lazy (the connection opens at the first operation) and available wherever
+     * the app has booted, not only inside a migration run. The connection must
+     * use the native engine (`engine: 'native'`); prisma/drizzle connections
+     * throw a clear error.
+     *
+     * Two boundaries:
+     * - Inside a migration, DDL on another connection runs OUTSIDE the
+     *   migrator's batch transaction (a transaction can't span connections) —
+     *   a failed batch rolls back the bound connection only.
+     * - Throws under `migrate --pretend`: the dry-run records the bound
+     *   connection's SQL without executing, and there is no recording seam for
+     *   a second connection — executing its DDL for real would betray the dry run.
+     */
+    connection(name) {
+        if (pretending) {
+            throw new NativeOrmError('NATIVE_SCHEMA_PRETEND_CONNECTION', `[RudderJS ORM native] Schema.connection("${name}") is not supported under --pretend — ` +
+                `the dry run records the bound connection only; DDL on a second connection would execute for real.`);
+        }
+        const builder = async () => {
+            const adapter = await resolveConnectionResolver()(name);
+            if (typeof adapter.schemaBuilder !== 'function') {
+                throw new NativeOrmError('NATIVE_SCHEMA_CONNECTION_ENGINE', `[RudderJS ORM native] Connection "${name}" does not use the native engine — ` +
+                    `Schema.connection() needs an \`engine: 'native'\` connection (prisma/drizzle manage schema with their own tooling).`);
+            }
+            return adapter.schemaBuilder();
+        };
+        return {
+            async create(table, build) { return (await builder()).create(table, build); },
+            async table(table, build) { return (await builder()).table(table, build); },
+            async rename(from, to) { return (await builder()).rename(from, to); },
+            async drop(table) { return (await builder()).drop(table); },
+            async dropIfExists(table) { return (await builder()).dropIfExists(table); },
+            async hasTable(table) { return (await builder()).hasTable(table); },
+            async hasColumn(table, column) { return (await builder()).hasColumn(table, column); },
+        };
+    },
+    // These are `async` (not just Promise-returning) so an unbound call — where
+    // `active()` throws — surfaces as a rejected promise, not a synchronous throw.
+    // Callers `await` them, so a uniform rejection is the least surprising contract.
+    async create(table, build) {
+        return active().create(table, build);
+    },
+    async table(table, build) {
+        return active().table(table, build);
+    },
+    async rename(from, to) {
+        return active().rename(from, to);
+    },
+    async drop(table) {
+        return active().drop(table);
+    },
+    async dropIfExists(table) {
+        return active().dropIfExists(table);
+    },
+    async hasTable(table) {
+        return active().hasTable(table);
+    },
+    async hasColumn(table, column) {
+        return active().hasColumn(table, column);
+    },
+};
+/** Run `fn` with `builder` bound to {@link Schema}, unbinding afterwards even on
+ *  throw. The migrator wraps each migration's up()/down() in this — `pretend`
+ *  marks the recording (dry-run) bind so `Schema.connection()` can refuse. */
+export async function withSchema(builder, fn, opts = {}) {
+    Schema.use(builder, opts);
+    try {
+        return await fn();
+    }
+    finally {
+        Schema.reset();
+    }
+}
+//# sourceMappingURL=schema-facade.js.map

package/dist/native/schema/schema-facade.js.map

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

package/dist/native/schema/schema-types.d.ts

@@ -0,0 +1,27 @@
+import type { Executor } from '../driver.js';
+import type { Dialect } from '../dialect.js';
+import { type TableTypes } from './types-generator.js';
+/** A model's contribution to type resolution: its table name + declared casts. */
+export interface ModelCastInfo {
+    table: string;
+    casts: Record<string, string>;
+}
+/**
+ * Introspect every user table and build the {@link TableTypes} for each, folding
+ * in `casts` for any table a model declares them on (matched by table name).
+ * Pure-ish: only reads the DB, returns data — the file write is separate so this
+ * is unit-testable against an in-memory connection.
+ */
+export declare function collectSchemaTypes(executor: Executor, dialect: Dialect, models?: ModelCastInfo[]): Promise<TableTypes[]>;
+/** Default output path for the generated registry, relative to an app root. */
+export declare function registryDtsPath(cwd: string): string;
+/**
+ * Full `schema:types` run: introspect → emit → write
+ * `app/Models/__schema/registry.d.ts`. Returns the written path + table count
+ * for the CLI to report. Creating the dir is idempotent.
+ */
+export declare function generateSchemaTypes(executor: Executor, dialect: Dialect, cwd: string, models?: ModelCastInfo[]): Promise<{
+    path: string;
+    tableCount: number;
+}>;
+//# sourceMappingURL=schema-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema-types.d.ts","sourceRoot":"","sources":["../../../src/native/schema/schema-types.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAE5C,OAAO,EAA+E,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEnI,kFAAkF;AAClF,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC9B;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,OAAO,EAChB,MAAM,GAAE,aAAa,EAAO,GAC3B,OAAO,CAAC,UAAU,EAAE,CAAC,CAgBvB;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,aAAa,EAAO,GAC3B,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAO/C"}

package/dist/native/schema/schema-types.js

@@ -0,0 +1,52 @@
+// ─── schema:types orchestration (GATE 7-types, node-only) ──
+//
+// Node-only glue: introspect every user table on a connection, fold in each
+// model's declared `casts` (so a `boolean` cast surfaces as `boolean`, not the
+// raw stored `number`), and write `app/Models/__schema/registry.d.ts`. The pure
+// column→TS mapping lives in `types-generator.ts`; the live catalog reads in
+// `introspect.ts`. Run automatically after `migrate` / `migrate:fresh`, and on
+// demand via `rudder schema:types`.
+import { mkdir, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { readTables, readColumns } from './introspect.js';
+import { buildTableTypes, emitRegistryDts, sqliteTypeToTs, pgTypeToTs, mysqlTypeToTs } from './types-generator.js';
+/**
+ * Introspect every user table and build the {@link TableTypes} for each, folding
+ * in `casts` for any table a model declares them on (matched by table name).
+ * Pure-ish: only reads the DB, returns data — the file write is separate so this
+ * is unit-testable against an in-memory connection.
+ */
+export async function collectSchemaTypes(executor, dialect, models = []) {
+    const castsByTable = new Map(models.map((m) => [m.table, m.casts]));
+    // Per-dialect storage→TS mapper: Postgres / MySQL data types differ from
+    // SQLite's fuzzy affinities (e.g. `jsonb`, `timestamptz`, `numeric`/`decimal`
+    // as string, `tinyint`→number).
+    const typeToTs = dialect.name === 'pg' ? pgTypeToTs :
+        dialect.name === 'mysql' ? mysqlTypeToTs :
+            sqliteTypeToTs;
+    const tables = await readTables(executor, dialect);
+    const out = [];
+    for (const table of tables) {
+        const columns = await readColumns(executor, dialect, table);
+        out.push(buildTableTypes(table, columns, castsByTable.get(table) ?? {}, typeToTs));
+    }
+    return out;
+}
+/** Default output path for the generated registry, relative to an app root. */
+export function registryDtsPath(cwd) {
+    return join(cwd, 'app', 'Models', '__schema', 'registry.d.ts');
+}
+/**
+ * Full `schema:types` run: introspect → emit → write
+ * `app/Models/__schema/registry.d.ts`. Returns the written path + table count
+ * for the CLI to report. Creating the dir is idempotent.
+ */
+export async function generateSchemaTypes(executor, dialect, cwd, models = []) {
+    const tables = await collectSchemaTypes(executor, dialect, models);
+    const contents = emitRegistryDts(tables);
+    const path = registryDtsPath(cwd);
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, contents, 'utf8');
+    return { path, tableCount: tables.length };
+}
+//# sourceMappingURL=schema-types.js.map

package/dist/native/schema/schema-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-types.js","sourceRoot":"","sources":["../../../src/native/schema/schema-types.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,EAAE;AACF,4EAA4E;AAC5E,+EAA+E;AAC/E,gFAAgF;AAChF,6EAA6E;AAC7E,+EAA+E;AAC/E,oCAAoC;AAEpC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAGzC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AACzD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAmB,MAAM,sBAAsB,CAAA;AAQnI;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAAkB,EAClB,OAAgB,EAChB,SAA0B,EAAE;IAE5B,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IACnE,yEAAyE;IACzE,8EAA8E;IAC9E,gCAAgC;IAChC,MAAM,QAAQ,GACZ,OAAO,CAAC,IAAI,KAAK,IAAI,CAAI,CAAC,CAAC,UAAU,CAAC,CAAC;QACvC,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;YAC1C,cAAc,CAAA;IAChB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAClD,MAAM,GAAG,GAAiB,EAAE,CAAA;IAC5B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;QAC3D,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAA;IACpF,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAO,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,CAAC,CAAA;AAChE,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,QAAkB,EAClB,OAAgB,EAChB,GAAW,EACX,SAA0B,EAAE;IAE5B,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;IAClE,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,CAAA;IACxC,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,CAAA;IACjC,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC/C,MAAM,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;IACvC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,CAAA;AAC5C,CAAC"}

package/dist/native/schema/types-generator.d.ts

@@ -0,0 +1,73 @@
+import type { RawColumn } from './introspect.js';
+import type { BuiltInCast } from '@rudderjs/contracts';
+/** A column's resolved TypeScript type plus whether it's optional on read. */
+export interface GeneratedColumnType {
+    /** The TS type expression, e.g. `string`, `number | null`, `Date`. */
+    ts: string;
+    /** Column name (carried through for the emitter). */
+    name: string;
+}
+/** One table's generated shape: name → ordered column types. */
+export interface TableTypes {
+    table: string;
+    columns: GeneratedColumnType[];
+}
+/**
+ * Map a SQLite declared type (`PRAGMA table_info.type`) to a base TS type. The
+ * mapping is by affinity rules — SQLite types are fuzzy, so we match on
+ * substrings the same way SQLite's own affinity algorithm does (INT→integer,
+ * CHAR/CLOB/TEXT→text, BLOB→blob, REAL/FLOA/DOUB→real, else numeric).
+ */
+export declare function sqliteTypeToTs(declared: string): string;
+/**
+ * Map a Postgres `information_schema.columns.data_type` to a base TS type. The
+ * mapping reflects what the porsager driver actually returns on READ (so the
+ * generated type matches runtime), which `casts` then refine:
+ *  - `int8`/`bigint` → `number` (the pg driver parses OID 20 to a JS number);
+ *  - `numeric`/`money` → `string` (porsager keeps these as strings for
+ *    precision safety — a `float`/`decimal` cast refines them to `number`);
+ *  - `json`/`jsonb` → `unknown` (a `json` cast or a typed `casts` entry refines);
+ *  - `timestamp*`/`date` → `Date`; `bytea` → `Uint8Array`; the rest → `string`.
+ */
+export declare function pgTypeToTs(declared: string): string;
+/**
+ * Map a MySQL `information_schema.columns.data_type` to a base TS type. The
+ * `data_type` is the base type WITHOUT length/precision, which `casts` then
+ * refine:
+ *  - integer family (`tinyint`/`smallint`/`mediumint`/`int`/`bigint`) → `number`.
+ *    Note `tinyint(1)` (MySQL's BOOLEAN alias) surfaces as `tinyint` here → `number`;
+ *    a declared `boolean` cast refines it to `boolean` (same treatment as pg);
+ *  - `decimal`/`numeric` → `string` (precision safety, matching pg — a
+ *    `float`/`decimal` cast refines to `number`);
+ *  - `float`/`double`/`real` → `number`;
+ *  - `json` → `unknown` (a `json` cast or typed `casts` entry refines);
+ *  - `date`/`datetime`/`timestamp` → `Date`; `blob`/`binary` → `Uint8Array`;
+ *  - char/text families → `string`; everything else → `unknown`.
+ */
+export declare function mysqlTypeToTs(declared: string): string;
+/**
+ * The TS type a declared cast produces on READ (`toJSON`/hydration). Casts
+ * OVERRIDE the storage type — a `boolean` cast turns an INTEGER column into
+ * `boolean`, a `json` cast turns TEXT into `unknown`, etc. Returns null for
+ * casts that don't change the read type (or unknown cast names), so the caller
+ * falls back to the storage mapping.
+ */
+export declare function castToTs(cast: BuiltInCast | string): string | null;
+/**
+ * Resolve one column's TS type: a declared cast wins over the storage mapping,
+ * and a nullable column widens with `| null`. The primary key and NOT NULL
+ * columns stay non-null. `typeToTs` is the per-dialect storage mapper
+ * ({@link sqliteTypeToTs} by default; {@link pgTypeToTs} for Postgres).
+ */
+export declare function resolveColumnType(col: RawColumn, casts: Record<string, string>, typeToTs?: (declared: string) => string): GeneratedColumnType;
+/** Build one table's {@link TableTypes} from its columns + casts, using the
+ *  given per-dialect storage mapper (defaults to the SQLite mapping). */
+export declare function buildTableTypes(table: string, columns: RawColumn[], casts?: Record<string, string>, typeToTs?: (declared: string) => string): TableTypes;
+/**
+ * Emit the full `registry.d.ts` contents: a `declare module '@rudderjs/orm'`
+ * augmentation extending `SchemaRegistry` with one entry per table. Tables are
+ * sorted for deterministic output (stable diffs / git). An empty schema still
+ * emits a valid (empty) augmentation so a stale file is always overwritten.
+ */
+export declare function emitRegistryDts(tables: TableTypes[]): string;
+//# sourceMappingURL=types-generator.d.ts.map

package/dist/native/schema/types-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-generator.d.ts","sourceRoot":"","sources":["../../../src/native/schema/types-generator.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAEtD,8EAA8E;AAC9E,MAAM,WAAW,mBAAmB;IAClC,sEAAsE;IACtE,EAAE,EAAQ,MAAM,CAAA;IAChB,qDAAqD;IACrD,IAAI,EAAM,MAAM,CAAA;CACjB;AAED,gEAAgE;AAChE,MAAM,WAAW,UAAU;IACzB,KAAK,EAAI,MAAM,CAAA;IACf,OAAO,EAAE,mBAAmB,EAAE,CAAA;CAC/B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOvD;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAsBnD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAyBtD;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAmBlE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,SAAS,EACd,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7B,QAAQ,GAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAuB,GACtD,mBAAmB,CAMrB;AAED;yEACyE;AACzE,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,SAAS,EAAE,EACpB,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EAClC,QAAQ,GAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAuB,GACtD,UAAU,CAEZ;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAiB5D"}