@warlock.js/cascade 4.0.141 → 4.0.143

package/cjs/migration/column-helpers.d.ts

@@ -0,0 +1,269 @@
+import { ColumnBuilder } from "./column-builder";
+/**
+ * A no-op migration sink used by standalone column helpers.
+ *
+ * When column helpers are used in `Migration.create()` / `Migration.alter()`,
+ * the builder is constructed without a real migration context. The actual
+ * operations are dequeued from the ColumnBuilder's definition and replayed
+ * onto the real migration instance at execution time.
+ *
+ * Index and FK operations queued on this sink are collected and transferred
+ * to the real migration by the factory methods.
+ */
+declare class DetachedMigrationSink {
+    /** Pending indexes registered via .unique() / .index() on a helper column. */
+    readonly pendingIndexes: {
+        columns: string[];
+        unique?: boolean;
+    }[];
+    /** Pending FK definitions registered via .references() on a helper column. */
+    readonly pendingForeignKeys: object[];
+    addPendingIndex(index: {
+        columns: string[];
+        unique?: boolean;
+    }): void;
+    addForeignKeyOperation(fk: object): void;
+}
+/**
+ * A `ColumnBuilder` that carries its own detached sink so it can be
+ * constructed outside of a migration class and later merged in.
+ */
+export declare class DetachedColumnBuilder extends ColumnBuilder {
+    readonly sink: DetachedMigrationSink;
+    constructor(type: ConstructorParameters<typeof ColumnBuilder>[2], name: string, options?: ConstructorParameters<typeof ColumnBuilder>[3]);
+}
+/**
+ * Standalone column helper: string / varchar.
+ *
+ * @example
+ * ```typescript
+ * import { Migration, string } from "@warlock.js/cascade";
+ *
+ * export default Migration.create(User, {
+ *   username: string(50).unique(),
+ * });
+ * ```
+ */
+export declare function string(length?: number): DetachedColumnBuilder;
+/**
+ * Standalone column helper: fixed-length CHAR.
+ *
+ * @example
+ * ```typescript
+ * code: char(3) // CHAR(3)
+ * ```
+ */
+export declare function char(length: number): DetachedColumnBuilder;
+/**
+ * Standalone column helper: TEXT (unlimited length).
+ *
+ * @example
+ * ```typescript
+ * import { Migration, text } from "@warlock.js/cascade";
+ *
+ * export default Migration.create(User, {
+ *   bio: text().nullable(),
+ * });
+ * ```
+ */
+export declare function text(): DetachedColumnBuilder;
+/**
+ * Standalone column helper: MEDIUMTEXT.
+ */
+export declare function mediumText(): DetachedColumnBuilder;
+/**
+ * Standalone column helper: LONGTEXT.
+ */
+export declare function longText(): DetachedColumnBuilder;
+/**
+ * Standalone column helper: INTEGER.
+ *
+ * @example
+ * ```typescript
+ * age: integer().unsigned()
+ * ```
+ */
+export declare function integer(): DetachedColumnBuilder;
+/** Alias for `integer()`. */
+export declare const int: typeof integer;
+/**
+ * Standalone column helper: SMALLINT.
+ */
+export declare function smallInteger(): DetachedColumnBuilder;
+/** Alias for `smallInteger()`. */
+export declare const smallInt: typeof smallInteger;
+/**
+ * Standalone column helper: TINYINT.
+ */
+export declare function tinyInteger(): DetachedColumnBuilder;
+/** Alias for `tinyInteger()`. */
+export declare const tinyInt: typeof tinyInteger;
+/**
+ * Standalone column helper: BIGINT.
+ */
+export declare function bigInteger(): DetachedColumnBuilder;
+/** Alias for `bigInteger()`. */
+export declare const bigInt: typeof bigInteger;
+/**
+ * Standalone column helper: FLOAT.
+ */
+export declare function float(): DetachedColumnBuilder;
+/**
+ * Standalone column helper: DOUBLE.
+ */
+export declare function double(): DetachedColumnBuilder;
+/**
+ * Standalone column helper: DECIMAL.
+ *
+ * @example
+ * ```typescript
+ * price: decimal(10, 2) // DECIMAL(10,2)
+ * ```
+ */
+export declare function decimal(precision?: number, scale?: number): DetachedColumnBuilder;
+/**
+ * Standalone column helper: BOOLEAN.
+ *
+ * Named `boolCol` to avoid collision with the TypeScript / JS `boolean` primitive.
+ *
+ * @example
+ * ```typescript
+ * is_active: boolCol().default(true)
+ * ```
+ */
+export declare function boolCol(): DetachedColumnBuilder;
+/** Alias for `boolCol()`. */
+export { boolCol as bool };
+/**
+ * Standalone column helper: DATE.
+ */
+export declare function date(): DetachedColumnBuilder;
+/**
+ * Standalone column helper: DATETIME.
+ */
+export declare function dateTime(): DetachedColumnBuilder;
+/**
+ * Standalone column helper: TIMESTAMP.
+ *
+ * @example
+ * ```typescript
+ * started_at: timestamp().default("NOW()")
+ * ```
+ */
+export declare function timestamp(): DetachedColumnBuilder;
+/**
+ * Standalone column helper: TIME.
+ */
+export declare function time(): DetachedColumnBuilder;
+/**
+ * Standalone column helper: YEAR.
+ */
+export declare function year(): DetachedColumnBuilder;
+/**
+ * Standalone column helper: JSON.
+ *
+ * Named `jsonCol` to avoid collision with the TS/JSON built-in names.
+ * Use `json()` is fine for most cases though — this alias exists for clarity.
+ *
+ * @example
+ * ```typescript
+ * metadata: json().nullable()
+ * ```
+ */
+export declare function json(): DetachedColumnBuilder;
+/**
+ * Alias for `json()`. Named `objectCol` to avoid collision with TS `object` type.
+ */
+export declare function objectCol(): DetachedColumnBuilder;
+/**
+ * Standalone column helper: BINARY / BLOB.
+ */
+export declare function binary(): DetachedColumnBuilder;
+/**
+ * Alias for `binary()`. Named `blobCol` to avoid collision with the Web `Blob` API.
+ */
+export declare function blobCol(): DetachedColumnBuilder;
+/**
+ * Standalone column helper: UUID.
+ *
+ * @example
+ * ```typescript
+ * import { Migration, uuid } from "@warlock.js/cascade";
+ *
+ * export default Migration.create(Chat, {
+ *   organization_id: uuid().references(Organization).onDelete("cascade"),
+ * });
+ * ```
+ */
+export declare function uuid(): DetachedColumnBuilder;
+/**
+ * Standalone column helper: ULID.
+ */
+export declare function ulid(): DetachedColumnBuilder;
+/**
+ * Standalone column helper: IP address.
+ */
+export declare function ipAddress(): DetachedColumnBuilder;
+/**
+ * Standalone column helper: MAC address.
+ */
+export declare function macAddress(): DetachedColumnBuilder;
+/**
+ * Standalone column helper: geo point.
+ */
+export declare function point(): DetachedColumnBuilder;
+/**
+ * Standalone column helper: polygon.
+ */
+export declare function polygon(): DetachedColumnBuilder;
+/**
+ * Standalone column helper: line string.
+ */
+export declare function lineString(): DetachedColumnBuilder;
+/**
+ * Standalone column helper: generic geometry.
+ */
+export declare function geometry(): DetachedColumnBuilder;
+/**
+ * Standalone column helper: vector (for AI embeddings).
+ *
+ * @param dimensions - Embedding size (e.g. 1536 for text-embedding-3-small)
+ *
+ * @example
+ * ```typescript
+ * embedding: vector(1536)
+ * ```
+ */
+export declare function vector(dimensions: number): DetachedColumnBuilder;
+/**
+ * Standalone column helper: ENUM.
+ *
+ * @example
+ * ```typescript
+ * status: enumCol(["active", "inactive", "pending"])
+ * ```
+ */
+export declare function enumCol(values: string[]): DetachedColumnBuilder;
+/**
+ * Standalone column helper: SET (multiple values).
+ */
+export declare function setCol(values: string[]): DetachedColumnBuilder;
+/** Standalone helper: INTEGER[] */
+export declare function arrayInt(): DetachedColumnBuilder;
+/** Standalone helper: BIGINT[] */
+export declare function arrayBigInt(): DetachedColumnBuilder;
+/** Standalone helper: REAL[] */
+export declare function arrayFloat(): DetachedColumnBuilder;
+/** Standalone helper: DECIMAL[] */
+export declare function arrayDecimal(precision?: number, scale?: number): DetachedColumnBuilder;
+/** Standalone helper: BOOLEAN[] */
+export declare function arrayBoolean(): DetachedColumnBuilder;
+/** Standalone helper: TEXT[] */
+export declare function arrayText(): DetachedColumnBuilder;
+/** Standalone helper: DATE[] */
+export declare function arrayDate(): DetachedColumnBuilder;
+/** Standalone helper: TIMESTAMPTZ[] */
+export declare function arrayTimestamp(): DetachedColumnBuilder;
+/** Standalone helper: UUID[] */
+export declare function arrayUuid(): DetachedColumnBuilder;
+//# sourceMappingURL=column-helpers.d.ts.map

package/cjs/migration/column-helpers.d.ts.map

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

package/cjs/migration/column-helpers.js

@@ -0,0 +1,384 @@
+'use strict';var columnBuilder=require('./column-builder.js');/**
+ * A no-op migration sink used by standalone column helpers.
+ *
+ * When column helpers are used in `Migration.create()` / `Migration.alter()`,
+ * the builder is constructed without a real migration context. The actual
+ * operations are dequeued from the ColumnBuilder's definition and replayed
+ * onto the real migration instance at execution time.
+ *
+ * Index and FK operations queued on this sink are collected and transferred
+ * to the real migration by the factory methods.
+ */
+class DetachedMigrationSink {
+    /** Pending indexes registered via .unique() / .index() on a helper column. */
+    pendingIndexes = [];
+    /** Pending FK definitions registered via .references() on a helper column. */
+    pendingForeignKeys = [];
+    addPendingIndex(index) {
+        this.pendingIndexes.push(index);
+    }
+    addForeignKeyOperation(fk) {
+        this.pendingForeignKeys.push(fk);
+    }
+}
+/**
+ * A `ColumnBuilder` that carries its own detached sink so it can be
+ * constructed outside of a migration class and later merged in.
+ */
+class DetachedColumnBuilder extends columnBuilder.ColumnBuilder {
+    sink;
+    constructor(type, name, options = {}) {
+        const sink = new DetachedMigrationSink();
+        super(sink, name, type, options);
+        this.sink = sink;
+    }
+}
+// ============================================================================
+// STRING HELPERS
+// ============================================================================
+/**
+ * Standalone column helper: string / varchar.
+ *
+ * @example
+ * ```typescript
+ * import { Migration, string } from "@warlock.js/cascade";
+ *
+ * export default Migration.create(User, {
+ *   username: string(50).unique(),
+ * });
+ * ```
+ */
+function string(length = 255) {
+    return new DetachedColumnBuilder("string", "__placeholder__", { length });
+}
+/**
+ * Standalone column helper: fixed-length CHAR.
+ *
+ * @example
+ * ```typescript
+ * code: char(3) // CHAR(3)
+ * ```
+ */
+function char(length) {
+    return new DetachedColumnBuilder("char", "__placeholder__", { length });
+}
+/**
+ * Standalone column helper: TEXT (unlimited length).
+ *
+ * @example
+ * ```typescript
+ * import { Migration, text } from "@warlock.js/cascade";
+ *
+ * export default Migration.create(User, {
+ *   bio: text().nullable(),
+ * });
+ * ```
+ */
+function text() {
+    return new DetachedColumnBuilder("text", "__placeholder__");
+}
+/**
+ * Standalone column helper: MEDIUMTEXT.
+ */
+function mediumText() {
+    return new DetachedColumnBuilder("mediumText", "__placeholder__");
+}
+/**
+ * Standalone column helper: LONGTEXT.
+ */
+function longText() {
+    return new DetachedColumnBuilder("longText", "__placeholder__");
+}
+// ============================================================================
+// NUMERIC HELPERS
+// ============================================================================
+/**
+ * Standalone column helper: INTEGER.
+ *
+ * @example
+ * ```typescript
+ * age: integer().unsigned()
+ * ```
+ */
+function integer() {
+    return new DetachedColumnBuilder("integer", "__placeholder__");
+}
+/** Alias for `integer()`. */
+const int = integer;
+/**
+ * Standalone column helper: SMALLINT.
+ */
+function smallInteger() {
+    return new DetachedColumnBuilder("smallInteger", "__placeholder__");
+}
+/** Alias for `smallInteger()`. */
+const smallInt = smallInteger;
+/**
+ * Standalone column helper: TINYINT.
+ */
+function tinyInteger() {
+    return new DetachedColumnBuilder("tinyInteger", "__placeholder__");
+}
+/** Alias for `tinyInteger()`. */
+const tinyInt = tinyInteger;
+/**
+ * Standalone column helper: BIGINT.
+ */
+function bigInteger() {
+    return new DetachedColumnBuilder("bigInteger", "__placeholder__");
+}
+/** Alias for `bigInteger()`. */
+const bigInt = bigInteger;
+/**
+ * Standalone column helper: FLOAT.
+ */
+function float() {
+    return new DetachedColumnBuilder("float", "__placeholder__");
+}
+/**
+ * Standalone column helper: DOUBLE.
+ */
+function double() {
+    return new DetachedColumnBuilder("double", "__placeholder__");
+}
+/**
+ * Standalone column helper: DECIMAL.
+ *
+ * @example
+ * ```typescript
+ * price: decimal(10, 2) // DECIMAL(10,2)
+ * ```
+ */
+function decimal(precision = 8, scale = 2) {
+    return new DetachedColumnBuilder("decimal", "__placeholder__", { precision, scale });
+}
+// ============================================================================
+// BOOLEAN HELPERS
+// ============================================================================
+/**
+ * Standalone column helper: BOOLEAN.
+ *
+ * Named `boolCol` to avoid collision with the TypeScript / JS `boolean` primitive.
+ *
+ * @example
+ * ```typescript
+ * is_active: boolCol().default(true)
+ * ```
+ */
+function boolCol() {
+    return new DetachedColumnBuilder("boolean", "__placeholder__");
+}
+// ============================================================================
+// DATE / TIME HELPERS
+// ============================================================================
+/**
+ * Standalone column helper: DATE.
+ */
+function date() {
+    return new DetachedColumnBuilder("date", "__placeholder__");
+}
+/**
+ * Standalone column helper: DATETIME.
+ */
+function dateTime() {
+    return new DetachedColumnBuilder("dateTime", "__placeholder__");
+}
+/**
+ * Standalone column helper: TIMESTAMP.
+ *
+ * @example
+ * ```typescript
+ * started_at: timestamp().default("NOW()")
+ * ```
+ */
+function timestamp() {
+    return new DetachedColumnBuilder("timestamp", "__placeholder__");
+}
+/**
+ * Standalone column helper: TIME.
+ */
+function time() {
+    return new DetachedColumnBuilder("time", "__placeholder__");
+}
+/**
+ * Standalone column helper: YEAR.
+ */
+function year() {
+    return new DetachedColumnBuilder("year", "__placeholder__");
+}
+// ============================================================================
+// JSON & BINARY HELPERS
+// ============================================================================
+/**
+ * Standalone column helper: JSON.
+ *
+ * Named `jsonCol` to avoid collision with the TS/JSON built-in names.
+ * Use `json()` is fine for most cases though — this alias exists for clarity.
+ *
+ * @example
+ * ```typescript
+ * metadata: json().nullable()
+ * ```
+ */
+function json() {
+    return new DetachedColumnBuilder("json", "__placeholder__");
+}
+/**
+ * Alias for `json()`. Named `objectCol` to avoid collision with TS `object` type.
+ */
+function objectCol() {
+    return new DetachedColumnBuilder("json", "__placeholder__");
+}
+/**
+ * Standalone column helper: BINARY / BLOB.
+ */
+function binary() {
+    return new DetachedColumnBuilder("binary", "__placeholder__");
+}
+/**
+ * Alias for `binary()`. Named `blobCol` to avoid collision with the Web `Blob` API.
+ */
+function blobCol() {
+    return new DetachedColumnBuilder("binary", "__placeholder__");
+}
+// ============================================================================
+// IDENTIFIER HELPERS
+// ============================================================================
+/**
+ * Standalone column helper: UUID.
+ *
+ * @example
+ * ```typescript
+ * import { Migration, uuid } from "@warlock.js/cascade";
+ *
+ * export default Migration.create(Chat, {
+ *   organization_id: uuid().references(Organization).onDelete("cascade"),
+ * });
+ * ```
+ */
+function uuid() {
+    return new DetachedColumnBuilder("uuid", "__placeholder__");
+}
+/**
+ * Standalone column helper: ULID.
+ */
+function ulid() {
+    return new DetachedColumnBuilder("ulid", "__placeholder__");
+}
+// ============================================================================
+// NETWORK HELPERS
+// ============================================================================
+/**
+ * Standalone column helper: IP address.
+ */
+function ipAddress() {
+    return new DetachedColumnBuilder("ipAddress", "__placeholder__");
+}
+/**
+ * Standalone column helper: MAC address.
+ */
+function macAddress() {
+    return new DetachedColumnBuilder("macAddress", "__placeholder__");
+}
+// ============================================================================
+// SPATIAL HELPERS
+// ============================================================================
+/**
+ * Standalone column helper: geo point.
+ */
+function point() {
+    return new DetachedColumnBuilder("point", "__placeholder__");
+}
+/**
+ * Standalone column helper: polygon.
+ */
+function polygon() {
+    return new DetachedColumnBuilder("polygon", "__placeholder__");
+}
+/**
+ * Standalone column helper: line string.
+ */
+function lineString() {
+    return new DetachedColumnBuilder("lineString", "__placeholder__");
+}
+/**
+ * Standalone column helper: generic geometry.
+ */
+function geometry() {
+    return new DetachedColumnBuilder("geometry", "__placeholder__");
+}
+// ============================================================================
+// AI / ML HELPERS
+// ============================================================================
+/**
+ * Standalone column helper: vector (for AI embeddings).
+ *
+ * @param dimensions - Embedding size (e.g. 1536 for text-embedding-3-small)
+ *
+ * @example
+ * ```typescript
+ * embedding: vector(1536)
+ * ```
+ */
+function vector(dimensions) {
+    return new DetachedColumnBuilder("vector", "__placeholder__", { dimensions });
+}
+// ============================================================================
+// ENUM & SET HELPERS
+// ============================================================================
+/**
+ * Standalone column helper: ENUM.
+ *
+ * @example
+ * ```typescript
+ * status: enumCol(["active", "inactive", "pending"])
+ * ```
+ */
+function enumCol(values) {
+    return new DetachedColumnBuilder("enum", "__placeholder__", { values });
+}
+/**
+ * Standalone column helper: SET (multiple values).
+ */
+function setCol(values) {
+    return new DetachedColumnBuilder("set", "__placeholder__", { values });
+}
+// ============================================================================
+// POSTGRESQL ARRAY HELPERS
+// ============================================================================
+/** Standalone helper: INTEGER[] */
+function arrayInt() {
+    return new DetachedColumnBuilder("arrayInt", "__placeholder__");
+}
+/** Standalone helper: BIGINT[] */
+function arrayBigInt() {
+    return new DetachedColumnBuilder("arrayBigInt", "__placeholder__");
+}
+/** Standalone helper: REAL[] */
+function arrayFloat() {
+    return new DetachedColumnBuilder("arrayFloat", "__placeholder__");
+}
+/** Standalone helper: DECIMAL[] */
+function arrayDecimal(precision, scale) {
+    return new DetachedColumnBuilder("arrayDecimal", "__placeholder__", { precision, scale });
+}
+/** Standalone helper: BOOLEAN[] */
+function arrayBoolean() {
+    return new DetachedColumnBuilder("arrayBoolean", "__placeholder__");
+}
+/** Standalone helper: TEXT[] */
+function arrayText() {
+    return new DetachedColumnBuilder("arrayText", "__placeholder__");
+}
+/** Standalone helper: DATE[] */
+function arrayDate() {
+    return new DetachedColumnBuilder("arrayDate", "__placeholder__");
+}
+/** Standalone helper: TIMESTAMPTZ[] */
+function arrayTimestamp() {
+    return new DetachedColumnBuilder("arrayTimestamp", "__placeholder__");
+}
+/** Standalone helper: UUID[] */
+function arrayUuid() {
+    return new DetachedColumnBuilder("arrayUuid", "__placeholder__");
+}exports.DetachedColumnBuilder=DetachedColumnBuilder;exports.arrayBigInt=arrayBigInt;exports.arrayBoolean=arrayBoolean;exports.arrayDate=arrayDate;exports.arrayDecimal=arrayDecimal;exports.arrayFloat=arrayFloat;exports.arrayInt=arrayInt;exports.arrayText=arrayText;exports.arrayTimestamp=arrayTimestamp;exports.arrayUuid=arrayUuid;exports.bigInt=bigInt;exports.bigInteger=bigInteger;exports.binary=binary;exports.blobCol=blobCol;exports.bool=boolCol;exports.boolCol=boolCol;exports.char=char;exports.date=date;exports.dateTime=dateTime;exports.decimal=decimal;exports.double=double;exports.enumCol=enumCol;exports.float=float;exports.geometry=geometry;exports.int=int;exports.integer=integer;exports.ipAddress=ipAddress;exports.json=json;exports.lineString=lineString;exports.longText=longText;exports.macAddress=macAddress;exports.mediumText=mediumText;exports.objectCol=objectCol;exports.point=point;exports.polygon=polygon;exports.setCol=setCol;exports.smallInt=smallInt;exports.smallInteger=smallInteger;exports.string=string;exports.text=text;exports.time=time;exports.timestamp=timestamp;exports.tinyInt=tinyInt;exports.tinyInteger=tinyInteger;exports.ulid=ulid;exports.uuid=uuid;exports.vector=vector;exports.year=year;//# sourceMappingURL=column-helpers.js.map

package/cjs/migration/column-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-helpers.js","sources":["../../src/migration/column-helpers.ts"],"sourcesContent":[null],"names":["ColumnBuilder"],"mappings":"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"}

package/cjs/migration/index.d.ts

@@ -1,5 +1,6 @@
 export { ColumnBuilder } from "./column-builder";
 export { ForeignKeyBuilder } from "./foreign-key-builder";
+export * from "./column-helpers";
 export * from "./migration";
 export * from "./migration-runner";
 export type { MigrationRecord, MigrationResult, MigrationRunnerOptions, MigrationStatus, PendingMigration, RollbackOptions, RunMigrationsOptions, } from "./types";

package/cjs/migration/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/migration/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AAGnC,YAAY,EACV,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,oBAAoB,GACrB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/migration/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AAGnC,YAAY,EACV,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,oBAAoB,GACrB,MAAM,SAAS,CAAC"}