@warlock.js/cascade 4.0.141 → 4.0.142

package/cjs/index.js

@@ -1 +1 @@
-'use strict';var databaseDataSourceContext=require('./context/database-data-source-context.js'),databaseTransactionContext=require('./context/database-transaction-context.js'),dataSource=require('./data-source/data-source.js'),dataSourceRegistry=require('./data-source/data-source-registry.js'),missingDataSource_error=require('./errors/missing-data-source.error.js'),transactionRollback_error=require('./errors/transaction-rollback.error.js'),databaseDirtyTracker=require('./database-dirty-tracker.js'),modelEvents=require('./events/model-events.js'),model=require('./model/model.js'),registerModel=require('./model/register-model.js'),databaseRemover=require('./remover/database-remover.js'),databaseRestorer=require('./restorer/database-restorer.js'),databaseWriterValidationError=require('./validation/database-writer-validation-error.js');require('./validation/database-seal-plugins.js');var databaseWriter=require('./writer/database-writer.js'),helpers=require('./relations/helpers.js'),relationLoader=require('./relations/relation-loader.js'),relationHydrator=require('./relations/relation-hydrator.js'),pivotOperations=require('./relations/pivot-operations.js'),aggregateExpressions=require('./expressions/aggregate-expressions.js'),mongodbDriver=require('./drivers/mongodb/mongodb-driver.js'),mongodbIdGenerator=require('./drivers/mongodb/mongodb-id-generator.js'),mongodbQueryBuilder=require('./drivers/mongodb/mongodb-query-builder.js'),mongodbSyncAdapter=require('./drivers/mongodb/mongodb-sync-adapter.js'),modelSync=require('./sync/model-sync.js'),modelSyncOperation=require('./sync/model-sync-operation.js'),syncContext=require('./sync/sync-context.js'),syncManager=require('./sync/sync-manager.js'),connectToDatabase=require('./utils/connect-to-database.js'),databaseWriter_utils=require('./utils/database-writer.utils.js'),defineModel=require('./utils/define-model.js'),onceConnected=require('./utils/once-connected.js'),columnBuilder=require('./migration/column-builder.js'),foreignKeyBuilder=require('./migration/foreign-key-builder.js'),migration=require('./migration/migration.js'),migrationRunner=require('./migration/migration-runner.js'),mongodbMigrationDriver=require('./drivers/mongodb/mongodb-migration-driver.js'),postgresBlueprint=require('./drivers/postgres/postgres-blueprint.js'),postgresDialect=require('./drivers/postgres/postgres-dialect.js'),postgresDriver=require('./drivers/postgres/postgres-driver.js'),postgresMigrationDriver=require('./drivers/postgres/postgres-migration-driver.js'),postgresQueryBuilder=require('./drivers/postgres/postgres-query-builder.js'),postgresQueryParser=require('./drivers/postgres/postgres-query-parser.js'),postgresSyncAdapter=require('./drivers/postgres/postgres-sync-adapter.js');exports.databaseDataSourceContext=databaseDataSourceContext.databaseDataSourceContext;exports.databaseTransactionContext=databaseTransactionContext.databaseTransactionContext;exports.DataSource=dataSource.DataSource;exports.dataSourceRegistry=dataSourceRegistry.dataSourceRegistry;exports.MissingDataSourceError=missingDataSource_error.MissingDataSourceError;exports.TransactionRollbackError=transactionRollback_error.TransactionRollbackError;exports.DatabaseDirtyTracker=databaseDirtyTracker.DatabaseDirtyTracker;exports.ModelEvents=modelEvents.ModelEvents;exports.globalModelEvents=modelEvents.globalModelEvents;exports.Model=model.Model;exports.RegisterModel=registerModel.RegisterModel;exports.cleanupModelsRegistery=registerModel.cleanupModelsRegistery;exports.getAllModelsFromRegistry=registerModel.getAllModelsFromRegistry;exports.getModelFromRegistry=registerModel.getModelFromRegistry;exports.registerModelInRegistry=registerModel.registerModelInRegistry;exports.removeModelFromRegistery=registerModel.removeModelFromRegistery;exports.resolveModelClass=registerModel.resolveModelClass;exports.DatabaseRemover=databaseRemover.DatabaseRemover;exports.DatabaseRestorer=databaseRestorer.DatabaseRestorer;exports.DatabaseWriterValidationError=databaseWriterValidationError.DatabaseWriterValidationError;exports.DatabaseWriter=databaseWriter.DatabaseWriter;exports.belongsTo=helpers.belongsTo;exports.belongsToMany=helpers.belongsToMany;exports.hasMany=helpers.hasMany;exports.hasOne=helpers.hasOne;exports.RelationLoader=relationLoader.RelationLoader;exports.RelationHydrator=relationHydrator.RelationHydrator;exports.PivotOperations=pivotOperations.PivotOperations;exports.createPivotOperations=pivotOperations.createPivotOperations;exports.$agg=aggregateExpressions.$agg;exports.isAggregateExpression=aggregateExpressions.isAggregateExpression;exports.MongoDbDriver=mongodbDriver.MongoDbDriver;exports.isMongoDBDriverLoaded=mongodbDriver.isMongoDBDriverLoaded;exports.MongoIdGenerator=mongodbIdGenerator.MongoIdGenerator;exports.MongoQueryBuilder=mongodbQueryBuilder.MongoQueryBuilder;exports.MongoSyncAdapter=mongodbSyncAdapter.MongoSyncAdapter;exports.modelSync=modelSync.modelSync;exports.ModelSyncOperation=modelSyncOperation.ModelSyncOperation;exports.DEFAULT_MAX_SYNC_DEPTH=syncContext.DEFAULT_MAX_SYNC_DEPTH;exports.SyncContextManager=syncContext.SyncContextManager;exports.SyncManager=syncManager.SyncManager;exports.connectToDatabase=connectToDatabase.connectToDatabase;exports.getDatabaseDriver=connectToDatabase.getDatabaseDriver;exports.transaction=connectToDatabase.transaction;exports.useModelTransformer=databaseWriter_utils.useModelTransformer;exports.defineModel=defineModel.defineModel;exports.onceConnected=onceConnected.onceConnected;exports.onceDisconnected=onceConnected.onceDisconnected;exports.ColumnBuilder=columnBuilder.ColumnBuilder;exports.ForeignKeyBuilder=foreignKeyBuilder.ForeignKeyBuilder;exports.Migration=migration.Migration;exports.migrate=migration.migrate;exports.MigrationRunner=migrationRunner.MigrationRunner;exports.migrationRunner=migrationRunner.migrationRunner;exports.MongoMigrationDriver=mongodbMigrationDriver.MongoMigrationDriver;exports.PostgresBlueprint=postgresBlueprint.PostgresBlueprint;exports.PostgresDialect=postgresDialect.PostgresDialect;exports.PostgresDriver=postgresDriver.PostgresDriver;exports.PostgresMigrationDriver=postgresMigrationDriver.PostgresMigrationDriver;exports.PostgresQueryBuilder=postgresQueryBuilder.PostgresQueryBuilder;exports.PostgresQueryParser=postgresQueryParser.PostgresQueryParser;exports.PostgresSyncAdapter=postgresSyncAdapter.PostgresSyncAdapter;//# sourceMappingURL=index.js.map
+'use strict';var databaseDataSourceContext=require('./context/database-data-source-context.js'),databaseTransactionContext=require('./context/database-transaction-context.js'),dataSource=require('./data-source/data-source.js'),dataSourceRegistry=require('./data-source/data-source-registry.js'),missingDataSource_error=require('./errors/missing-data-source.error.js'),transactionRollback_error=require('./errors/transaction-rollback.error.js'),databaseDirtyTracker=require('./database-dirty-tracker.js'),modelEvents=require('./events/model-events.js'),model=require('./model/model.js'),registerModel=require('./model/register-model.js'),databaseRemover=require('./remover/database-remover.js'),databaseRestorer=require('./restorer/database-restorer.js'),databaseWriterValidationError=require('./validation/database-writer-validation-error.js');require('./validation/database-seal-plugins.js');var databaseWriter=require('./writer/database-writer.js'),helpers=require('./relations/helpers.js'),relationLoader=require('./relations/relation-loader.js'),relationHydrator=require('./relations/relation-hydrator.js'),pivotOperations=require('./relations/pivot-operations.js'),aggregateExpressions=require('./expressions/aggregate-expressions.js'),mongodbDriver=require('./drivers/mongodb/mongodb-driver.js'),mongodbIdGenerator=require('./drivers/mongodb/mongodb-id-generator.js'),mongodbQueryBuilder=require('./drivers/mongodb/mongodb-query-builder.js'),mongodbSyncAdapter=require('./drivers/mongodb/mongodb-sync-adapter.js'),modelSync=require('./sync/model-sync.js'),modelSyncOperation=require('./sync/model-sync-operation.js'),syncContext=require('./sync/sync-context.js'),syncManager=require('./sync/sync-manager.js'),connectToDatabase=require('./utils/connect-to-database.js'),databaseWriter_utils=require('./utils/database-writer.utils.js'),defineModel=require('./utils/define-model.js'),onceConnected=require('./utils/once-connected.js'),columnBuilder=require('./migration/column-builder.js'),foreignKeyBuilder=require('./migration/foreign-key-builder.js'),columnHelpers=require('./migration/column-helpers.js'),migration=require('./migration/migration.js'),migrationRunner=require('./migration/migration-runner.js'),mongodbMigrationDriver=require('./drivers/mongodb/mongodb-migration-driver.js'),postgresBlueprint=require('./drivers/postgres/postgres-blueprint.js'),postgresDialect=require('./drivers/postgres/postgres-dialect.js'),postgresDriver=require('./drivers/postgres/postgres-driver.js'),postgresMigrationDriver=require('./drivers/postgres/postgres-migration-driver.js'),postgresQueryBuilder=require('./drivers/postgres/postgres-query-builder.js'),postgresQueryParser=require('./drivers/postgres/postgres-query-parser.js'),postgresSyncAdapter=require('./drivers/postgres/postgres-sync-adapter.js');exports.databaseDataSourceContext=databaseDataSourceContext.databaseDataSourceContext;exports.databaseTransactionContext=databaseTransactionContext.databaseTransactionContext;exports.DataSource=dataSource.DataSource;exports.dataSourceRegistry=dataSourceRegistry.dataSourceRegistry;exports.MissingDataSourceError=missingDataSource_error.MissingDataSourceError;exports.TransactionRollbackError=transactionRollback_error.TransactionRollbackError;exports.DatabaseDirtyTracker=databaseDirtyTracker.DatabaseDirtyTracker;exports.ModelEvents=modelEvents.ModelEvents;exports.globalModelEvents=modelEvents.globalModelEvents;exports.Model=model.Model;exports.RegisterModel=registerModel.RegisterModel;exports.cleanupModelsRegistery=registerModel.cleanupModelsRegistery;exports.getAllModelsFromRegistry=registerModel.getAllModelsFromRegistry;exports.getModelFromRegistry=registerModel.getModelFromRegistry;exports.registerModelInRegistry=registerModel.registerModelInRegistry;exports.removeModelFromRegistery=registerModel.removeModelFromRegistery;exports.resolveModelClass=registerModel.resolveModelClass;exports.DatabaseRemover=databaseRemover.DatabaseRemover;exports.DatabaseRestorer=databaseRestorer.DatabaseRestorer;exports.DatabaseWriterValidationError=databaseWriterValidationError.DatabaseWriterValidationError;exports.DatabaseWriter=databaseWriter.DatabaseWriter;exports.belongsTo=helpers.belongsTo;exports.belongsToMany=helpers.belongsToMany;exports.hasMany=helpers.hasMany;exports.hasOne=helpers.hasOne;exports.RelationLoader=relationLoader.RelationLoader;exports.RelationHydrator=relationHydrator.RelationHydrator;exports.PivotOperations=pivotOperations.PivotOperations;exports.createPivotOperations=pivotOperations.createPivotOperations;exports.$agg=aggregateExpressions.$agg;exports.isAggregateExpression=aggregateExpressions.isAggregateExpression;exports.MongoDbDriver=mongodbDriver.MongoDbDriver;exports.isMongoDBDriverLoaded=mongodbDriver.isMongoDBDriverLoaded;exports.MongoIdGenerator=mongodbIdGenerator.MongoIdGenerator;exports.MongoQueryBuilder=mongodbQueryBuilder.MongoQueryBuilder;exports.MongoSyncAdapter=mongodbSyncAdapter.MongoSyncAdapter;exports.modelSync=modelSync.modelSync;exports.ModelSyncOperation=modelSyncOperation.ModelSyncOperation;exports.DEFAULT_MAX_SYNC_DEPTH=syncContext.DEFAULT_MAX_SYNC_DEPTH;exports.SyncContextManager=syncContext.SyncContextManager;exports.SyncManager=syncManager.SyncManager;exports.connectToDatabase=connectToDatabase.connectToDatabase;exports.getDatabaseDriver=connectToDatabase.getDatabaseDriver;exports.transaction=connectToDatabase.transaction;exports.useModelTransformer=databaseWriter_utils.useModelTransformer;exports.defineModel=defineModel.defineModel;exports.onceConnected=onceConnected.onceConnected;exports.onceDisconnected=onceConnected.onceDisconnected;exports.ColumnBuilder=columnBuilder.ColumnBuilder;exports.ForeignKeyBuilder=foreignKeyBuilder.ForeignKeyBuilder;exports.DetachedColumnBuilder=columnHelpers.DetachedColumnBuilder;exports.arrayBigInt=columnHelpers.arrayBigInt;exports.arrayBoolean=columnHelpers.arrayBoolean;exports.arrayDate=columnHelpers.arrayDate;exports.arrayDecimal=columnHelpers.arrayDecimal;exports.arrayFloat=columnHelpers.arrayFloat;exports.arrayInt=columnHelpers.arrayInt;exports.arrayText=columnHelpers.arrayText;exports.arrayTimestamp=columnHelpers.arrayTimestamp;exports.arrayUuid=columnHelpers.arrayUuid;exports.bigInt=columnHelpers.bigInt;exports.bigInteger=columnHelpers.bigInteger;exports.binary=columnHelpers.binary;exports.blobCol=columnHelpers.blobCol;exports.bool=columnHelpers.boolCol;exports.boolCol=columnHelpers.boolCol;exports.char=columnHelpers.char;exports.date=columnHelpers.date;exports.dateTime=columnHelpers.dateTime;exports.decimal=columnHelpers.decimal;exports.double=columnHelpers.double;exports.enumCol=columnHelpers.enumCol;exports.float=columnHelpers.float;exports.geometry=columnHelpers.geometry;exports.int=columnHelpers.int;exports.integer=columnHelpers.integer;exports.ipAddress=columnHelpers.ipAddress;exports.json=columnHelpers.json;exports.lineString=columnHelpers.lineString;exports.longText=columnHelpers.longText;exports.macAddress=columnHelpers.macAddress;exports.mediumText=columnHelpers.mediumText;exports.objectCol=columnHelpers.objectCol;exports.point=columnHelpers.point;exports.polygon=columnHelpers.polygon;exports.setCol=columnHelpers.setCol;exports.smallInt=columnHelpers.smallInt;exports.smallInteger=columnHelpers.smallInteger;exports.string=columnHelpers.string;exports.text=columnHelpers.text;exports.time=columnHelpers.time;exports.timestamp=columnHelpers.timestamp;exports.tinyInt=columnHelpers.tinyInt;exports.tinyInteger=columnHelpers.tinyInteger;exports.ulid=columnHelpers.ulid;exports.uuid=columnHelpers.uuid;exports.vector=columnHelpers.vector;exports.year=columnHelpers.year;exports.Migration=migration.Migration;exports.migrate=migration.migrate;exports.MigrationRunner=migrationRunner.MigrationRunner;exports.migrationRunner=migrationRunner.migrationRunner;exports.MongoMigrationDriver=mongodbMigrationDriver.MongoMigrationDriver;exports.PostgresBlueprint=postgresBlueprint.PostgresBlueprint;exports.PostgresDialect=postgresDialect.PostgresDialect;exports.PostgresDriver=postgresDriver.PostgresDriver;exports.PostgresMigrationDriver=postgresMigrationDriver.PostgresMigrationDriver;exports.PostgresQueryBuilder=postgresQueryBuilder.PostgresQueryBuilder;exports.PostgresQueryParser=postgresQueryParser.PostgresQueryParser;exports.PostgresSyncAdapter=postgresSyncAdapter.PostgresSyncAdapter;//# sourceMappingURL=index.js.map

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

@@ -244,22 +244,32 @@ export declare class ColumnBuilder {
     /**
      * Declare a foreign key constraint on this column.
      *
+     * Accepts either a raw table-name string or a Model class (anything with a
+     * static `table` property). Using a Model class is preferred — it is
+     * type-safe and automatically tracks table renames.
+     *
      * Pushes an `addForeignKey` operation immediately using a mutable reference —
      * subsequent `.on()`, `.onDelete()`, `.onUpdate()` calls mutate the same
      * definition that is already queued, so no `.add()` terminator is needed.
      *
      * Referenced column defaults to `"id"` — use `.on()` to override.
      *
-     * @param table - Referenced table name
+     * @param tableOrModel - Referenced table name OR a Model class with a static `table` property
      * @returns This builder for chaining
      *
      * @example
      * ```typescript
-     * this.integer("user_id").references("users");
-     * this.integer("user_id").references("users").on("custom_id").onDelete("cascade");
+     * // Preferred — model class reference (type-safe, rename-proof)
+     * this.uuid("organization_id").references(Organization).onDelete("cascade");
+     *
+     * // Also supported — raw table string
+     * this.uuid("organization_id").references("organizations").onDelete("cascade");
+     * this.uuid("organization_id").references(Organization.table).onDelete("cascade");
      * ```
      */
-    references(table: string): this;
+    references(tableOrModel: string | {
+        table: string;
+    }): this;
     /**
      * Set the referenced column for the foreign key.
      *

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

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

package/cjs/migration/column-builder.js

@@ -322,25 +322,34 @@ class ColumnBuilder {
     /**
      * Declare a foreign key constraint on this column.
      *
+     * Accepts either a raw table-name string or a Model class (anything with a
+     * static `table` property). Using a Model class is preferred — it is
+     * type-safe and automatically tracks table renames.
+     *
      * Pushes an `addForeignKey` operation immediately using a mutable reference —
      * subsequent `.on()`, `.onDelete()`, `.onUpdate()` calls mutate the same
      * definition that is already queued, so no `.add()` terminator is needed.
      *
      * Referenced column defaults to `"id"` — use `.on()` to override.
      *
-     * @param table - Referenced table name
+     * @param tableOrModel - Referenced table name OR a Model class with a static `table` property
      * @returns This builder for chaining
      *
      * @example
      * ```typescript
-     * this.integer("user_id").references("users");
-     * this.integer("user_id").references("users").on("custom_id").onDelete("cascade");
+     * // Preferred — model class reference (type-safe, rename-proof)
+     * this.uuid("organization_id").references(Organization).onDelete("cascade");
+     *
+     * // Also supported — raw table string
+     * this.uuid("organization_id").references("organizations").onDelete("cascade");
+     * this.uuid("organization_id").references(Organization.table).onDelete("cascade");
      * ```
      */
-    references(table) {
+    references(tableOrModel) {
+        const tableName = typeof tableOrModel === "string" ? tableOrModel : tableOrModel.table;
         this.fkDefinition = {
             column: this.definition.name,
-            referencesTable: table,
+            referencesTable: tableName,
             referencesColumn: "id",
             onDelete: "restrict",
             onUpdate: "restrict",

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

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

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":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;;;;;;;;;GAUG;AACH,cAAM,qBAAqB;IACzB,8EAA8E;IAC9E,SAAgB,cAAc,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,CAAM;IAE/E,8EAA8E;IAC9E,SAAgB,kBAAkB,EAAE,MAAM,EAAE,CAAM;IAE3C,eAAe,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAIrE,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;CAGhD;AAED;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,aAAa;IACtD,SAAgB,IAAI,EAAE,qBAAqB,CAAC;gBAG1C,IAAI,EAAE,qBAAqB,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,EACpD,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,qBAAqB,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAM;CAM/D;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,MAAM,SAAM,GAAG,qBAAqB,CAE1D;AAED;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,qBAAqB,CAE1D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,IAAI,IAAI,qBAAqB,CAE5C;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,qBAAqB,CAElD;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,qBAAqB,CAEhD;AAMD;;;;;;;GAOG;AACH,wBAAgB,OAAO,IAAI,qBAAqB,CAE/C;AAED,6BAA6B;AAC7B,eAAO,MAAM,GAAG,gBAAU,CAAC;AAE3B;;GAEG;AACH,wBAAgB,YAAY,IAAI,qBAAqB,CAEpD;AAED,kCAAkC;AAClC,eAAO,MAAM,QAAQ,qBAAe,CAAC;AAErC;;GAEG;AACH,wBAAgB,WAAW,IAAI,qBAAqB,CAEnD;AAED,iCAAiC;AACjC,eAAO,MAAM,OAAO,oBAAc,CAAC;AAEnC;;GAEG;AACH,wBAAgB,UAAU,IAAI,qBAAqB,CAElD;AAED,gCAAgC;AAChC,eAAO,MAAM,MAAM,mBAAa,CAAC;AAEjC;;GAEG;AACH,wBAAgB,KAAK,IAAI,qBAAqB,CAE7C;AAED;;GAEG;AACH,wBAAgB,MAAM,IAAI,qBAAqB,CAE9C;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,SAAS,SAAI,EAAE,KAAK,SAAI,GAAG,qBAAqB,CAEvE;AAMD;;;;;;;;;GASG;AACH,wBAAgB,OAAO,IAAI,qBAAqB,CAE/C;AAED,6BAA6B;AAC7B,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,CAAC;AAM3B;;GAEG;AACH,wBAAgB,IAAI,IAAI,qBAAqB,CAE5C;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,qBAAqB,CAEhD;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,IAAI,qBAAqB,CAEjD;AAED;;GAEG;AACH,wBAAgB,IAAI,IAAI,qBAAqB,CAE5C;AAED;;GAEG;AACH,wBAAgB,IAAI,IAAI,qBAAqB,CAE5C;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,IAAI,IAAI,qBAAqB,CAE5C;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,qBAAqB,CAEjD;AAED;;GAEG;AACH,wBAAgB,MAAM,IAAI,qBAAqB,CAE9C;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,qBAAqB,CAE/C;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,IAAI,IAAI,qBAAqB,CAE5C;AAED;;GAEG;AACH,wBAAgB,IAAI,IAAI,qBAAqB,CAE5C;AAMD;;GAEG;AACH,wBAAgB,SAAS,IAAI,qBAAqB,CAEjD;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,qBAAqB,CAElD;AAMD;;GAEG;AACH,wBAAgB,KAAK,IAAI,qBAAqB,CAE7C;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,qBAAqB,CAE/C;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,qBAAqB,CAElD;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,qBAAqB,CAEhD;AAMD;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,qBAAqB,CAEhE;AAMD;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,qBAAqB,CAE/D;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,qBAAqB,CAE9D;AAMD,mCAAmC;AACnC,wBAAgB,QAAQ,IAAI,qBAAqB,CAEhD;AAED,kCAAkC;AAClC,wBAAgB,WAAW,IAAI,qBAAqB,CAEnD;AAED,gCAAgC;AAChC,wBAAgB,UAAU,IAAI,qBAAqB,CAElD;AAED,mCAAmC;AACnC,wBAAgB,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,qBAAqB,CAEtF;AAED,mCAAmC;AACnC,wBAAgB,YAAY,IAAI,qBAAqB,CAEpD;AAED,gCAAgC;AAChC,wBAAgB,SAAS,IAAI,qBAAqB,CAEjD;AAED,gCAAgC;AAChC,wBAAgB,SAAS,IAAI,qBAAqB,CAEjD;AAED,uCAAuC;AACvC,wBAAgB,cAAc,IAAI,qBAAqB,CAEtD;AAED,gCAAgC;AAChC,wBAAgB,SAAS,IAAI,qBAAqB,CAEjD"}