@rudderjs/database 1.1.0 → 1.2.0

package/dist/native/schema/blueprint.js

@@ -0,0 +1,286 @@
+// ─── Blueprint (Laravel-style table definition) ────────────
+//
+// PURE: records the column / index / primary-key *intents* for one table. No
+// SQL is built here — the DDL compiler reads a Blueprint and emits statements
+// per-dialect. This is the object handed to a `Schema.create('users', t => …)`
+// callback.
+//
+// Column/timestamp naming follows the native engine's **camelCase** convention
+// (`createdAt` / `updatedAt` / `deletedAt`) — the same columns the read path's
+// soft-delete scoping already defaults to (`deletedAtColumn = 'deletedAt'`), and
+// consistent with the ORM's camelCase polymorphic columns. This is a deliberate
+// divergence from Laravel's snake_case.
+import { ColumnBuilder, makeColumn, normalizeForeignKeyAction, } from './column.js';
+import { NativeOrmError } from '../errors.js';
+/** Validate that an `enum`/`set` column got a non-empty value list. The values
+ *  themselves are quoted at compile time, so the only check here is presence. */
+function requireValues(kind, values) {
+    if (!Array.isArray(values) || values.length === 0) {
+        throw new NativeOrmError('NATIVE_DDL_EMPTY_ENUM', `[RudderJS ORM native] ${kind}() requires a non-empty list of allowed values.`);
+    }
+    return values;
+}
+/**
+ * Fluent builder for a table-level foreign key (`Blueprint.foreign(...)`).
+ * Mutates the {@link ForeignKeyDefinition} the Blueprint recorded and returns
+ * `this` so the constraint chains Laravel-style:
+ * `t.foreign('user_id').references('id').on('users').onDelete('cascade')`.
+ */
+export class ForeignKeyBuilder {
+    fk;
+    constructor(fk) {
+        this.fk = fk;
+    }
+    /** Referenced column(s) on the foreign table (defaults to `id`). */
+    references(columns) {
+        this.fk.references = Array.isArray(columns) ? columns : [columns];
+        return this;
+    }
+    /** Referenced table. */
+    on(table) {
+        this.fk.on = table;
+        return this;
+    }
+    onDelete(action) {
+        this.fk.onDelete = normalizeForeignKeyAction(action);
+        return this;
+    }
+    onUpdate(action) {
+        this.fk.onUpdate = normalizeForeignKeyAction(action);
+        return this;
+    }
+    /** `onDelete('cascade')`. */
+    cascadeOnDelete() { return this.onDelete('cascade'); }
+    /** `onDelete('restrict')`. */
+    restrictOnDelete() { return this.onDelete('restrict'); }
+    /** `onDelete('set null')` — pair with nullable column(s). */
+    nullOnDelete() { return this.onDelete('set null'); }
+    /** `onUpdate('cascade')`. */
+    cascadeOnUpdate() { return this.onUpdate('cascade'); }
+    /** Override the default `{table}_{col[_col…]}_foreign` constraint name. */
+    name(name) {
+        this.fk.name = name;
+        return this;
+    }
+}
+/**
+ * Records one table's shape. Mirrors Laravel's `Blueprint`: a column method
+ * returns a {@link ColumnBuilder} so modifiers chain; table-level helpers
+ * (`primary` / `unique` / `index`) record composite constraints.
+ */
+export class Blueprint {
+    table;
+    columns = [];
+    /** Composite (or explicitly-named single) primary key. Single-column PKs set
+     *  inline via `.primary()` live on the column instead. */
+    primaryColumns = null;
+    indexes = [];
+    /** Table-level foreign keys (`Blueprint.foreign(...)`). Column-level FKs
+     *  (`constrained()`) live on their {@link ColumnDefinition} instead; the
+     *  compiler collects both. */
+    foreignKeys = [];
+    constructor(table) {
+        this.table = table;
+    }
+    add(name, type, extra = {}) {
+        const def = makeColumn(name, type, extra);
+        this.columns.push(def);
+        return new ColumnBuilder(def);
+    }
+    // ── Auto-incrementing primary key ──
+    /** Auto-incrementing integer primary key (`id` by default). */
+    id(name = 'id') {
+        return this.increments(name);
+    }
+    /** Auto-incrementing integer primary key under an explicit name. */
+    increments(name) {
+        return this.add(name, 'increments', { autoIncrement: true, primary: true });
+    }
+    /** Alias of {@link increments} — bigint on pg/mysql, INTEGER on SQLite. */
+    bigIncrements(name) {
+        return this.add(name, 'increments', { autoIncrement: true, primary: true });
+    }
+    // ── Integers ──
+    integer(name) {
+        return this.add(name, 'integer');
+    }
+    bigInteger(name) {
+        return this.add(name, 'bigInteger');
+    }
+    /** Small integer — `smallint` (pg/mysql), `INTEGER` (sqlite). */
+    smallInteger(name) {
+        return this.add(name, 'smallInteger');
+    }
+    /** Tiny integer — `tinyint` (mysql), `smallint` (pg), `INTEGER` (sqlite). */
+    tinyInteger(name) {
+        return this.add(name, 'tinyInteger');
+    }
+    /** Medium integer — `mediumint` (mysql), `integer` (pg), `INTEGER` (sqlite). */
+    mediumInteger(name) {
+        return this.add(name, 'mediumInteger');
+    }
+    /** Unsigned big integer intended as a foreign key. Chain `.constrained()` (or
+     *  `.references(...).on(...)`) to attach the FK constraint. */
+    foreignId(name) {
+        return this.add(name, 'bigInteger', { unsigned: true });
+    }
+    /**
+     * Laravel `foreignIdFor`: an unsigned big-integer FK column whose name is
+     * derived from a related table (`'users'` → `userId`) unless `column` is given.
+     * Chain `.constrained()` to attach the constraint. Naming follows the engine's
+     * camelCase convention (singularize + `Id`), a divergence from Laravel's
+     * `{snake}_id`.
+     */
+    foreignIdFor(related, column) {
+        const singular = related.endsWith('s') ? related.slice(0, -1) : related;
+        return this.foreignId(column ?? `${singular}Id`);
+    }
+    // ── Strings / text ──
+    string(name, length = 255) {
+        return this.add(name, 'string', { length });
+    }
+    /** Fixed-length `char(length)` (pg/mysql); `TEXT` on sqlite. */
+    char(name, length = 255) {
+        return this.add(name, 'char', { length });
+    }
+    text(name) {
+        return this.add(name, 'text');
+    }
+    /** `mediumtext` (mysql); `text` (pg/sqlite). */
+    mediumText(name) {
+        return this.add(name, 'mediumText');
+    }
+    /** `longtext` (mysql); `text` (pg/sqlite). */
+    longText(name) {
+        return this.add(name, 'longText');
+    }
+    uuid(name = 'uuid') {
+        return this.add(name, 'uuid');
+    }
+    /** 26-char ULID — `char(26)` (pg/mysql), `TEXT` (sqlite). */
+    ulid(name = 'ulid') {
+        return this.add(name, 'ulid');
+    }
+    /** A `uuid` column intended as a foreign key — chain `.constrained()`. */
+    foreignUuid(name) {
+        return this.add(name, 'uuid');
+    }
+    /** A `ulid` column intended as a foreign key — chain `.constrained()`. */
+    foreignUlid(name) {
+        return this.add(name, 'ulid');
+    }
+    json(name) {
+        return this.add(name, 'json');
+    }
+    /** `jsonb` (pg) — binary JSON; falls back to `json` (mysql) / `TEXT` (sqlite). */
+    jsonb(name) {
+        return this.add(name, 'jsonb');
+    }
+    /**
+     * Enumerated string column. `enum(...)` on MySQL; `varchar(255)` + a
+     * `CHECK (… IN (…))` constraint on pg/sqlite. Values are migration-author
+     * supplied — rendered as quoted literals, never bound. Throws on an empty list.
+     */
+    enum(name, values) {
+        return this.add(name, 'enum', { enumValues: requireValues('enum', values) });
+    }
+    /** MySQL `set(...)` — multiple allowed values stored as a comma list. Throws a
+     *  clear NotImplemented on pg/sqlite (no native SET type). */
+    set(name, values) {
+        return this.add(name, 'set', { enumValues: requireValues('set', values) });
+    }
+    // ── Numbers ──
+    decimal(name, precision = 8, scale = 2) {
+        return this.add(name, 'decimal', { precision, scale });
+    }
+    float(name) {
+        return this.add(name, 'float');
+    }
+    /** Double-precision float — `double precision` (pg), `double` (mysql), `REAL` (sqlite). */
+    double(name) {
+        return this.add(name, 'double');
+    }
+    // ── Booleans / dates / binary ──
+    boolean(name) {
+        return this.add(name, 'boolean');
+    }
+    /** Calendar date (no time) — `date` (pg/mysql), `TEXT` (sqlite). */
+    date(name) {
+        return this.add(name, 'date');
+    }
+    /** Time of day (no date). Optional fractional-seconds `precision` → `time(p)`
+     *  on pg/mysql; `TEXT` on sqlite. */
+    time(name, precision) {
+        return this.add(name, 'time', precision === undefined ? {} : { precision });
+    }
+    dateTime(name) {
+        return this.add(name, 'dateTime');
+    }
+    timestamp(name) {
+        return this.add(name, 'timestamp');
+    }
+    binary(name) {
+        return this.add(name, 'binary');
+    }
+    // ── Convenience clusters ──
+    /** `createdAt` + `updatedAt`, nullable (Laravel parity), camelCase per engine
+     *  convention. */
+    timestamps() {
+        this.timestamp('createdAt').nullable();
+        this.timestamp('updatedAt').nullable();
+    }
+    /** `deletedAt` nullable — the column the soft-delete scope filters on. */
+    softDeletes(name = 'deletedAt') {
+        return this.timestamp(name).nullable();
+    }
+    /**
+     * Polymorphic relation columns (Laravel `morphs`): a `{name}Id` (unsigned big
+     * integer) + `{name}Type` (string) pair plus a composite index over both. The
+     * columns use the engine's **camelCase** morph convention (`commentableId` /
+     * `commentableType`) — the same columns `morphTo` / `morphMany` read/write —
+     * not Laravel's snake_case. The index covers `[{name}Type, {name}Id]` (type
+     * first, matching Laravel), defaulting to `{table}_{name}Type_{name}Id_index`;
+     * pass `indexName` to override (pair with the same name in {@link dropMorphs}).
+     */
+    morphs(name, indexName) {
+        this.bigInteger(`${name}Id`).unsigned();
+        this.string(`${name}Type`);
+        this.index([`${name}Type`, `${name}Id`], indexName);
+    }
+    /** Nullable variant of {@link morphs} — both columns allow NULL (the relation
+     *  is optional). Same `[{name}Type, {name}Id]` composite index. */
+    nullableMorphs(name, indexName) {
+        this.bigInteger(`${name}Id`).unsigned().nullable();
+        this.string(`${name}Type`).nullable();
+        this.index([`${name}Type`, `${name}Id`], indexName);
+    }
+    // ── Table-level constraints ──
+    /** Composite (or named single) primary key. */
+    primary(columns) {
+        this.primaryColumns = Array.isArray(columns) ? columns : [columns];
+    }
+    /** Composite (or single) unique index. */
+    unique(columns, name) {
+        this.indexes.push({ columns: Array.isArray(columns) ? columns : [columns], unique: true, ...(name !== undefined && { name }) });
+    }
+    /** Composite (or single) non-unique index. */
+    index(columns, name) {
+        this.indexes.push({ columns: Array.isArray(columns) ? columns : [columns], unique: false, ...(name !== undefined && { name }) });
+    }
+    /**
+     * Composite / explicit foreign key:
+     * `t.foreign('user_id').references('id').on('users').onDelete('cascade')`.
+     * Returns a {@link ForeignKeyBuilder}; the referenced column defaults to `id`.
+     * For the single-column shorthand, prefer `t.foreignId('user_id').constrained()`.
+     */
+    foreign(columns) {
+        const fk = {
+            columns: Array.isArray(columns) ? columns : [columns],
+            references: ['id'],
+            on: '',
+        };
+        this.foreignKeys.push(fk);
+        return new ForeignKeyBuilder(fk);
+    }
+}
+//# sourceMappingURL=blueprint.js.map

package/dist/native/schema/blueprint.js.map

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

package/dist/native/schema/column.d.ts

@@ -0,0 +1,168 @@
+/**
+ * The referential actions a foreign key may take on `ON DELETE` / `ON UPDATE`.
+ * Stored in the canonical SQL-keyword-lowercase form; the compiler upper-cases
+ * it (`'set null'` → `SET NULL`). camelCase aliases (`setNull` / `noAction`) are
+ * accepted at the call site and normalized here.
+ */
+export type ForeignKeyAction = 'cascade' | 'restrict' | 'set null' | 'no action';
+/** What callers may pass to `onDelete` / `onUpdate` — the canonical forms plus
+ *  the camelCase aliases Laravel users reach for. */
+export type ForeignKeyActionInput = ForeignKeyAction | 'setNull' | 'noAction';
+/** A recorded foreign-key intent. Built by `ColumnBuilder.constrained()` /
+ *  `.references().on()` (column-level) or `Blueprint.foreign()` (table-level);
+ *  rendered as a `FOREIGN KEY` table constraint by the DDL compiler. */
+export interface ForeignKeyDefinition {
+    /** Local column(s) the constraint covers. */
+    columns: string[];
+    /** Referenced column(s) on the foreign table. Defaults to `['id']`. */
+    references: string[];
+    /** Referenced table. Required at compile time — `constrained()` infers it,
+     *  `.on(...)` sets it explicitly. Empty until one of those runs. */
+    on: string;
+    onDelete?: ForeignKeyAction;
+    onUpdate?: ForeignKeyAction;
+    /** Explicit constraint name; defaults to `{table}_{col[_col…]}_foreign`. */
+    name?: string;
+}
+/**
+ * Validate a referential action against the allowlist and normalize it to its
+ * canonical form. Accepts the SQL forms (`'set null'`) and the camelCase aliases
+ * (`'setNull'`). Throws {@link NativeOrmError} on anything else so arbitrary text
+ * never reaches the `ON DELETE` / `ON UPDATE` clause (DDL can't bind values).
+ */
+export declare function normalizeForeignKeyAction(input: string): ForeignKeyAction;
+/** Laravel-style table inference for `constrained()`: strip a trailing `_id` /
+ *  `Id` from the column name and naively pluralize (`user_id` → `users`,
+ *  `authorId` → `authors`). */
+export declare function inferForeignTable(column: string): string;
+/**
+ * The portable column types v1 supports — the common 80% (parent plan Part 2).
+ * Each dialect maps these to its own SQL type; SQLite's mapping lives in
+ * `SqliteDialect.columnTypeSql`. Exotic types (geometry, set, …) are deferred.
+ */
+export type ColumnType = 'increments' | 'integer' | 'bigInteger' | 'tinyInteger' | 'smallInteger' | 'mediumInteger' | 'string' | 'char' | 'text' | 'mediumText' | 'longText' | 'boolean' | 'date' | 'time' | 'dateTime' | 'timestamp' | 'json' | 'jsonb' | 'uuid' | 'ulid' | 'decimal' | 'float' | 'double' | 'binary' | 'enum' | 'set';
+/**
+ * The recorded shape of one column. Built by {@link ColumnBuilder}; consumed by
+ * the DDL compiler + the dialect's type mapper. Modifier flags default to the
+ * unset state so a bare `t.integer('age')` carries no surprises.
+ */
+export interface ColumnDefinition {
+    name: string;
+    type: ColumnType;
+    /** `string(name, length)` — kept for pg/mysql `varchar(N)`; SQLite ignores it. */
+    length?: number;
+    /** `decimal(name, precision, scale)`; also the fractional-seconds precision
+     *  for `time(name, precision)`. */
+    precision?: number;
+    scale?: number;
+    /** Allowed values for `enum(name, [...])` / `set(name, [...])`. Rendered as a
+     *  quoted literal list (mysql `enum(...)`/`set(...)`) or a `CHECK (... IN ...)`
+     *  constraint (pg/sqlite `enum`). Migration-author supplied — quoted, never bound. */
+    enumValues?: string[];
+    nullable: boolean;
+    /** Whether a DEFAULT was set (distinguishes `default(null)` from "no default"). */
+    hasDefault: boolean;
+    /** The default literal when {@link hasDefault}. DDL defaults are rendered as
+     *  literals (most databases reject bound parameters in DDL), so the value is
+     *  escaped, not parameterized — safe because migration authors, not end users,
+     *  write these. */
+    default?: unknown;
+    /** `useCurrent()` — `DEFAULT CURRENT_TIMESTAMP`. Takes precedence over `default`. */
+    useCurrent: boolean;
+    /** `useCurrentOnUpdate()` — `ON UPDATE CURRENT_TIMESTAMP`. MySQL-only (Laravel
+     *  grammar parity); silently ignored on pg/sqlite, which have no inline form. */
+    useCurrentOnUpdate: boolean;
+    /** `comment(text)` — a column comment. Rendered inline (`COMMENT '…'`) on MySQL,
+     *  as a separate `COMMENT ON COLUMN` statement on pg, and ignored on sqlite. */
+    comment?: string;
+    /** `after(column)` — position an added column after another (MySQL ALTER only). */
+    after?: string;
+    /** `first()` — position an added column first (MySQL ALTER only). */
+    first?: boolean;
+    /** Single-column inline `PRIMARY KEY`. Composite PKs go through `Blueprint.primary`. */
+    primary: boolean;
+    /** Emit a `CREATE UNIQUE INDEX` for this column (Laravel-style separate index). */
+    unique: boolean;
+    /** Emit a `CREATE INDEX` for this column. */
+    index: boolean;
+    /** `unsigned()` — recorded for pg/mysql; a no-op on SQLite. */
+    unsigned: boolean;
+    /** True for `increments()` — the dialect emits the full auto-increment PK
+     *  spec, so the compiler skips the other inline modifiers for this column. */
+    autoIncrement: boolean;
+    /** `change()` — in a `Schema.table` alter, modify the existing column rather
+     *  than add it. On SQLite this needs the table-rebuild dance (7.4b); the alter
+     *  compiler throws a clear "not yet" until then. */
+    change: boolean;
+    /** Column-level foreign key (`constrained()` / `.references().on()`). Recorded
+     *  here as an intent; the compiler emits it as a table-level `FOREIGN KEY`
+     *  constraint, not an inline column modifier. */
+    foreignKey?: ForeignKeyDefinition;
+}
+/**
+ * Fluent wrapper over a {@link ColumnDefinition}. Returned by every
+ * `Blueprint` column method so modifiers chain Laravel-style. Mutates its
+ * backing definition and returns `this`.
+ */
+export declare class ColumnBuilder {
+    readonly def: ColumnDefinition;
+    constructor(def: ColumnDefinition);
+    /** Allow NULLs (columns are `NOT NULL` by default, matching Laravel). */
+    nullable(value?: boolean): this;
+    /** Set a column default. Pass `null` for a literal `DEFAULT NULL`. */
+    default(value: unknown): this;
+    /** Default this timestamp/dateTime column to `CURRENT_TIMESTAMP`. */
+    useCurrent(): this;
+    /** Refresh this timestamp on UPDATE (`ON UPDATE CURRENT_TIMESTAMP`). MySQL-only;
+     *  a no-op on pg/sqlite (recorded for portability, ignored by their grammar). */
+    useCurrentOnUpdate(): this;
+    /** Attach a column comment. Inline on MySQL, a separate `COMMENT ON COLUMN`
+     *  statement on pg, ignored on sqlite (no column comments). */
+    comment(text: string): this;
+    /** Position this (added) column after another. MySQL ALTER only — ignored
+     *  elsewhere, matching Laravel. */
+    after(column: string): this;
+    /** Position this (added) column first. MySQL ALTER only — ignored elsewhere. */
+    first(): this;
+    /** Mark as the table's (single-column) primary key. */
+    primary(): this;
+    /** Add a unique index over this column. */
+    unique(): this;
+    /** Add a (non-unique) index over this column. */
+    index(): this;
+    /** Mark unsigned (pg/mysql); a no-op on SQLite, recorded for portability. */
+    unsigned(): this;
+    /** In a `Schema.table` alter, modify this existing column instead of adding it.
+     *  (SQLite implements this via a table rebuild — lands in 7.4b.) */
+    change(): this;
+    /**
+     * Laravel `constrained()`: add a foreign key on this column. With no argument
+     * the referenced table is inferred from the column name (`user_id` → `users`)
+     * and the referenced column defaults to `id`. Pass an explicit table (and
+     * optionally column) to override the inference.
+     */
+    constrained(table?: string, column?: string): this;
+    /** Set the referenced column(s). Pair with `.on(table)` for the full FK:
+     *  `t.foreignId('user_id').references('id').on('users')`. */
+    references(columns: string | string[]): this;
+    /** Set the referenced table for the FK started by `.references(...)`. */
+    on(table: string): this;
+    /** `ON DELETE` action (validated against the allowlist). */
+    onDelete(action: ForeignKeyActionInput): this;
+    /** `ON UPDATE` action (validated against the allowlist). */
+    onUpdate(action: ForeignKeyActionInput): this;
+    /** `onDelete('cascade')`. */
+    cascadeOnDelete(): this;
+    /** `onDelete('restrict')`. */
+    restrictOnDelete(): this;
+    /** `onDelete('set null')` — pair with a `.nullable()` column. */
+    nullOnDelete(): this;
+    /** `onUpdate('cascade')`. */
+    cascadeOnUpdate(): this;
+    /** Lazily create the FK intent on first FK-method call, then return it for
+     *  incremental building (`.references().on().onDelete()`). */
+    private foreignKey;
+}
+/** Build a {@link ColumnDefinition} with modifier defaults filled in. */
+export declare function makeColumn(name: string, type: ColumnType, extra?: Partial<ColumnDefinition>): ColumnDefinition;
+//# sourceMappingURL=column.d.ts.map

package/dist/native/schema/column.d.ts.map

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

package/dist/native/schema/column.js

@@ -0,0 +1,190 @@
+// ─── Column definition + chainable builder ─────────────────
+//
+// PURE: no driver, no `node:`, no I/O. A `ColumnBuilder` records the *intent*
+// of one column (type + modifiers) as a plain {@link ColumnDefinition}; the DDL
+// compiler turns those intents into SQL per-dialect. This mirrors the read
+// path's split — the query builder records state, the compiler emits SQL.
+//
+// Laravel's `Blueprint` column methods return a fluent column object so
+// modifiers chain (`t.string('email').nullable().unique()`); `ColumnBuilder` is
+// that object. It mutates its backing definition in place and returns `this`.
+import { NativeOrmError } from '../errors.js';
+const FK_ACTIONS = {
+    'cascade': 'cascade',
+    'restrict': 'restrict',
+    'set null': 'set null',
+    'setnull': 'set null',
+    'no action': 'no action',
+    'noaction': 'no action',
+};
+/**
+ * Validate a referential action against the allowlist and normalize it to its
+ * canonical form. Accepts the SQL forms (`'set null'`) and the camelCase aliases
+ * (`'setNull'`). Throws {@link NativeOrmError} on anything else so arbitrary text
+ * never reaches the `ON DELETE` / `ON UPDATE` clause (DDL can't bind values).
+ */
+export function normalizeForeignKeyAction(input) {
+    const action = FK_ACTIONS[String(input).trim().toLowerCase()];
+    if (!action) {
+        throw new NativeOrmError('NATIVE_DDL_BAD_FK_ACTION', `[RudderJS ORM native] Invalid foreign-key action ${JSON.stringify(input)}. ` +
+            `Use one of: cascade, restrict, set null (setNull), no action (noAction).`);
+    }
+    return action;
+}
+/** Laravel-style table inference for `constrained()`: strip a trailing `_id` /
+ *  `Id` from the column name and naively pluralize (`user_id` → `users`,
+ *  `authorId` → `authors`). */
+export function inferForeignTable(column) {
+    let base = column;
+    if (base.endsWith('_id'))
+        base = base.slice(0, -3);
+    else if (base.endsWith('Id'))
+        base = base.slice(0, -2);
+    return base.endsWith('s') ? base : `${base}s`;
+}
+function toColumns(columns) {
+    return Array.isArray(columns) ? columns : [columns];
+}
+/**
+ * Fluent wrapper over a {@link ColumnDefinition}. Returned by every
+ * `Blueprint` column method so modifiers chain Laravel-style. Mutates its
+ * backing definition and returns `this`.
+ */
+export class ColumnBuilder {
+    def;
+    constructor(def) {
+        this.def = def;
+    }
+    /** Allow NULLs (columns are `NOT NULL` by default, matching Laravel). */
+    nullable(value = true) {
+        this.def.nullable = value;
+        return this;
+    }
+    /** Set a column default. Pass `null` for a literal `DEFAULT NULL`. */
+    default(value) {
+        this.def.hasDefault = true;
+        this.def.default = value;
+        return this;
+    }
+    /** Default this timestamp/dateTime column to `CURRENT_TIMESTAMP`. */
+    useCurrent() {
+        this.def.useCurrent = true;
+        return this;
+    }
+    /** Refresh this timestamp on UPDATE (`ON UPDATE CURRENT_TIMESTAMP`). MySQL-only;
+     *  a no-op on pg/sqlite (recorded for portability, ignored by their grammar). */
+    useCurrentOnUpdate() {
+        this.def.useCurrentOnUpdate = true;
+        return this;
+    }
+    /** Attach a column comment. Inline on MySQL, a separate `COMMENT ON COLUMN`
+     *  statement on pg, ignored on sqlite (no column comments). */
+    comment(text) {
+        this.def.comment = text;
+        return this;
+    }
+    /** Position this (added) column after another. MySQL ALTER only — ignored
+     *  elsewhere, matching Laravel. */
+    after(column) {
+        this.def.after = column;
+        return this;
+    }
+    /** Position this (added) column first. MySQL ALTER only — ignored elsewhere. */
+    first() {
+        this.def.first = true;
+        return this;
+    }
+    /** Mark as the table's (single-column) primary key. */
+    primary() {
+        this.def.primary = true;
+        return this;
+    }
+    /** Add a unique index over this column. */
+    unique() {
+        this.def.unique = true;
+        return this;
+    }
+    /** Add a (non-unique) index over this column. */
+    index() {
+        this.def.index = true;
+        return this;
+    }
+    /** Mark unsigned (pg/mysql); a no-op on SQLite, recorded for portability. */
+    unsigned() {
+        this.def.unsigned = true;
+        return this;
+    }
+    /** In a `Schema.table` alter, modify this existing column instead of adding it.
+     *  (SQLite implements this via a table rebuild — lands in 7.4b.) */
+    change() {
+        this.def.change = true;
+        return this;
+    }
+    // ── Foreign keys (column-level) ──
+    /**
+     * Laravel `constrained()`: add a foreign key on this column. With no argument
+     * the referenced table is inferred from the column name (`user_id` → `users`)
+     * and the referenced column defaults to `id`. Pass an explicit table (and
+     * optionally column) to override the inference.
+     */
+    constrained(table, column = 'id') {
+        const fk = this.foreignKey();
+        fk.on = table ?? inferForeignTable(this.def.name);
+        fk.references = [column];
+        return this;
+    }
+    /** Set the referenced column(s). Pair with `.on(table)` for the full FK:
+     *  `t.foreignId('user_id').references('id').on('users')`. */
+    references(columns) {
+        this.foreignKey().references = toColumns(columns);
+        return this;
+    }
+    /** Set the referenced table for the FK started by `.references(...)`. */
+    on(table) {
+        this.foreignKey().on = table;
+        return this;
+    }
+    /** `ON DELETE` action (validated against the allowlist). */
+    onDelete(action) {
+        this.foreignKey().onDelete = normalizeForeignKeyAction(action);
+        return this;
+    }
+    /** `ON UPDATE` action (validated against the allowlist). */
+    onUpdate(action) {
+        this.foreignKey().onUpdate = normalizeForeignKeyAction(action);
+        return this;
+    }
+    // ── Referential-action shorthands (Laravel parity) ──
+    /** `onDelete('cascade')`. */
+    cascadeOnDelete() { return this.onDelete('cascade'); }
+    /** `onDelete('restrict')`. */
+    restrictOnDelete() { return this.onDelete('restrict'); }
+    /** `onDelete('set null')` — pair with a `.nullable()` column. */
+    nullOnDelete() { return this.onDelete('set null'); }
+    /** `onUpdate('cascade')`. */
+    cascadeOnUpdate() { return this.onUpdate('cascade'); }
+    /** Lazily create the FK intent on first FK-method call, then return it for
+     *  incremental building (`.references().on().onDelete()`). */
+    foreignKey() {
+        return (this.def.foreignKey ??= { columns: [this.def.name], references: ['id'], on: '' });
+    }
+}
+/** Build a {@link ColumnDefinition} with modifier defaults filled in. */
+export function makeColumn(name, type, extra = {}) {
+    return {
+        name,
+        type,
+        nullable: false,
+        hasDefault: false,
+        useCurrent: false,
+        useCurrentOnUpdate: false,
+        primary: false,
+        unique: false,
+        index: false,
+        unsigned: false,
+        autoIncrement: false,
+        change: false,
+        ...extra,
+    };
+}
+//# sourceMappingURL=column.js.map