@warlock.js/cascade 4.0.48 → 4.0.59

package/cjs/index.js

@@ -1,267 +1 @@
-'use strict';
-
-var databaseDataSourceContext = require('./context/database-data-source-context');
-var databaseTransactionContext = require('./context/database-transaction-context');
-var databaseDriver_contract = require('./contracts/database-driver.contract');
-var databaseIdGenerator_contract = require('./contracts/database-id-generator.contract');
-var databaseRemover_contract = require('./contracts/database-remover.contract');
-var databaseRestorer_contract = require('./contracts/database-restorer.contract');
-var databaseWriter_contract = require('./contracts/database-writer.contract');
-var migrationDriver_contract = require('./contracts/migration-driver.contract');
-var queryBuilder_contract = require('./contracts/query-builder.contract');
-var syncAdapter_contract = require('./contracts/sync-adapter.contract');
-var dataSource = require('./data-source/data-source');
-var dataSourceRegistry = require('./data-source/data-source-registry');
-var missingDataSource_error = require('./errors/missing-data-source.error');
-var databaseDirtyTracker = require('./database-dirty-tracker');
-var modelEvents = require('./events/model-events');
-var model = require('./model/model');
-var registerModel = require('./model/register-model');
-var databaseRemover = require('./remover/database-remover');
-var databaseRestorer = require('./restorer/database-restorer');
-var types = require('./types');
-var validation = require('./validation');
-var databaseWriter = require('./writer/database-writer');
-var expressions = require('./expressions');
-var mongoIdGenerator = require('./drivers/mongo/mongo-id-generator');
-var mongoQueryBuilder = require('./drivers/mongo/mongo-query-builder');
-var mongoSyncAdapter = require('./drivers/mongo/mongo-sync-adapter');
-var mongodbDriver = require('./drivers/mongo/mongodb-driver');
-var types$1 = require('./drivers/mongo/types');
-var modelSync = require('./sync/model-sync');
-var modelSyncOperation = require('./sync/model-sync-operation');
-var syncContext = require('./sync/sync-context');
-var syncManager = require('./sync/sync-manager');
-var connectToDatabase = require('./utils/connect-to-database');
-var databaseWriter_utils = require('./utils/database-writer.utils');
-var defineModel = require('./utils/define-model');
-var onceConnected = require('./utils/once-connected');
-var migration = require('./migration');
-var mongoMigrationDriver = require('./drivers/mongo/mongo-migration-driver');
-
-
-
-Object.defineProperty(exports, "modelSync", {
-  enumerable: true,
-  get: function () { return modelSync.modelSync; }
-});
-Object.defineProperty(exports, "ModelSyncOperation", {
-  enumerable: true,
-  get: function () { return modelSyncOperation.ModelSyncOperation; }
-});
-Object.defineProperty(exports, "DEFAULT_MAX_SYNC_DEPTH", {
-  enumerable: true,
-  get: function () { return syncContext.DEFAULT_MAX_SYNC_DEPTH; }
-});
-Object.defineProperty(exports, "SyncContextManager", {
-  enumerable: true,
-  get: function () { return syncContext.SyncContextManager; }
-});
-Object.defineProperty(exports, "SyncManager", {
-  enumerable: true,
-  get: function () { return syncManager.SyncManager; }
-});
-Object.defineProperty(exports, "MongoMigrationDriver", {
-  enumerable: true,
-  get: function () { return mongoMigrationDriver.MongoMigrationDriver; }
-});
-Object.keys(databaseDataSourceContext).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return databaseDataSourceContext[k]; }
-  });
-});
-Object.keys(databaseTransactionContext).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return databaseTransactionContext[k]; }
-  });
-});
-Object.keys(databaseDriver_contract).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return databaseDriver_contract[k]; }
-  });
-});
-Object.keys(databaseIdGenerator_contract).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return databaseIdGenerator_contract[k]; }
-  });
-});
-Object.keys(databaseRemover_contract).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return databaseRemover_contract[k]; }
-  });
-});
-Object.keys(databaseRestorer_contract).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return databaseRestorer_contract[k]; }
-  });
-});
-Object.keys(databaseWriter_contract).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return databaseWriter_contract[k]; }
-  });
-});
-Object.keys(migrationDriver_contract).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return migrationDriver_contract[k]; }
-  });
-});
-Object.keys(queryBuilder_contract).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return queryBuilder_contract[k]; }
-  });
-});
-Object.keys(syncAdapter_contract).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return syncAdapter_contract[k]; }
-  });
-});
-Object.keys(dataSource).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return dataSource[k]; }
-  });
-});
-Object.keys(dataSourceRegistry).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return dataSourceRegistry[k]; }
-  });
-});
-Object.keys(missingDataSource_error).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return missingDataSource_error[k]; }
-  });
-});
-Object.keys(databaseDirtyTracker).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return databaseDirtyTracker[k]; }
-  });
-});
-Object.keys(modelEvents).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return modelEvents[k]; }
-  });
-});
-Object.keys(model).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return model[k]; }
-  });
-});
-Object.keys(registerModel).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return registerModel[k]; }
-  });
-});
-Object.keys(databaseRemover).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return databaseRemover[k]; }
-  });
-});
-Object.keys(databaseRestorer).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return databaseRestorer[k]; }
-  });
-});
-Object.keys(types).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return types[k]; }
-  });
-});
-Object.keys(validation).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return validation[k]; }
-  });
-});
-Object.keys(databaseWriter).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return databaseWriter[k]; }
-  });
-});
-Object.keys(expressions).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return expressions[k]; }
-  });
-});
-Object.keys(mongoIdGenerator).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return mongoIdGenerator[k]; }
-  });
-});
-Object.keys(mongoQueryBuilder).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return mongoQueryBuilder[k]; }
-  });
-});
-Object.keys(mongoSyncAdapter).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return mongoSyncAdapter[k]; }
-  });
-});
-Object.keys(mongodbDriver).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return mongodbDriver[k]; }
-  });
-});
-Object.keys(types$1).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return types$1[k]; }
-  });
-});
-Object.keys(connectToDatabase).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return connectToDatabase[k]; }
-  });
-});
-Object.keys(databaseWriter_utils).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return databaseWriter_utils[k]; }
-  });
-});
-Object.keys(defineModel).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return defineModel[k]; }
-  });
-});
-Object.keys(onceConnected).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return onceConnected[k]; }
-  });
-});
-Object.keys(migration).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return migration[k]; }
-  });
-});
-//# sourceMappingURL=index.js.map
-//# 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'),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'),aggregateExpressions=require('./expressions/aggregate-expressions.js'),mongoIdGenerator=require('./drivers/mongo/mongo-id-generator.js'),mongoQueryBuilder=require('./drivers/mongo/mongo-query-builder.js'),mongoSyncAdapter=require('./drivers/mongo/mongo-sync-adapter.js'),mongodbDriver=require('./drivers/mongo/mongodb-driver.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'),mongoMigrationDriver=require('./drivers/mongo/mongo-migration-driver.js');exports.databaseDataSourceContext=databaseDataSourceContext.databaseDataSourceContext;exports.databaseTransactionContext=databaseTransactionContext.databaseTransactionContext;exports.DataSource=dataSource.DataSource;exports.dataSourceRegistry=dataSourceRegistry.dataSourceRegistry;exports.MissingDataSourceError=missingDataSource_error.MissingDataSourceError;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.DatabaseRemover=databaseRemover.DatabaseRemover;exports.DatabaseRestorer=databaseRestorer.DatabaseRestorer;exports.DatabaseWriterValidationError=databaseWriterValidationError.DatabaseWriterValidationError;exports.DatabaseWriter=databaseWriter.DatabaseWriter;exports.$agg=aggregateExpressions.$agg;exports.isAggregateExpression=aggregateExpressions.isAggregateExpression;exports.MongoIdGenerator=mongoIdGenerator.MongoIdGenerator;exports.MongoQueryBuilder=mongoQueryBuilder.MongoQueryBuilder;exports.MongoSyncAdapter=mongoSyncAdapter.MongoSyncAdapter;exports.MongoDbDriver=mongodbDriver.MongoDbDriver;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.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=mongoMigrationDriver.MongoMigrationDriver;//# sourceMappingURL=index.js.map

package/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js","sourcesContent":[]}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

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

@@ -0,0 +1,167 @@
+import type { ColumnDefinition, ColumnType } from "../contracts/migration-driver.contract";
+/**
+ * Reference to the Migration type to avoid circular imports.
+ * The actual type is injected at runtime.
+ */
+type MigrationLike = {
+    addPendingIndex(index: {
+        columns: string[];
+        unique?: boolean;
+    }): void;
+};
+/**
+ * Fluent builder for defining column properties.
+ *
+ * Allows chaining modifiers like `.nullable()`, `.unique()`, `.default()`.
+ * Each column builder is bound to a parent migration and accumulates
+ * the column definition through method chains.
+ *
+ * @example
+ * ```typescript
+ * this.string("email")
+ *   .nullable()
+ *   .unique()
+ *   .default("guest@example.com");
+ * ```
+ *
+ * @example
+ * ```typescript
+ * this.integer("age")
+ *   .unsigned()
+ *   .comment("User's age in years");
+ * ```
+ */
+export declare class ColumnBuilder {
+    private readonly migration;
+    /** Mutable column definition being accumulated */
+    private readonly definition;
+    /**
+     * Create a new column builder.
+     *
+     * @param migration - Parent migration instance for index registration
+     * @param name - Column name
+     * @param type - Column data type
+     * @param options - Optional initial configuration
+     */
+    constructor(migration: MigrationLike, name: string, type: ColumnType, options?: Partial<Pick<ColumnDefinition, "length" | "precision" | "scale" | "dimensions" | "values">>);
+    /**
+     * Mark column as nullable (allows NULL values).
+     *
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.string("middleName").nullable();
+     * ```
+     */
+    nullable(): this;
+    /**
+     * Mark column as not nullable (disallows NULL values).
+     *
+     * This is the default, but can be used for clarity.
+     *
+     * @returns This builder for chaining
+     */
+    notNullable(): this;
+    /**
+     * Set default value for the column.
+     *
+     * @param value - Default value (can be a literal or expression)
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.boolean("isActive").default(true);
+     * this.dateTime("createdAt").default("NOW()");
+     * ```
+     */
+    default(value: unknown): this;
+    /**
+     * Add unique constraint/index on this column.
+     *
+     * Registers a pending unique index with the parent migration.
+     *
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.string("email").unique();
+     * ```
+     */
+    unique(): this;
+    /**
+     * Add regular index on this column.
+     *
+     * Registers a pending index with the parent migration.
+     *
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.string("email").index();
+     * ```
+     */
+    index(): this;
+    /**
+     * Mark as primary key.
+     *
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.integer("id").primary();
+     * ```
+     */
+    primary(): this;
+    /**
+     * Mark as auto-increment (numeric types only).
+     *
+     * SQL databases will use native AUTO_INCREMENT/SERIAL.
+     * NoSQL databases ignore this.
+     *
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.integer("id").primary().autoIncrement();
+     * ```
+     */
+    autoIncrement(): this;
+    /**
+     * Mark as unsigned (numeric types only).
+     *
+     * Disallows negative values and doubles the positive range.
+     *
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.integer("age").unsigned();
+     * ```
+     */
+    unsigned(): this;
+    /**
+     * Add comment/description to column.
+     *
+     * Stored as column metadata in the database.
+     *
+     * @param text - Comment text
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.string("sku").comment("Stock Keeping Unit code");
+     * ```
+     */
+    comment(text: string): this;
+    /**
+     * Get the built column definition.
+     *
+     * Called internally by the Migration class to extract the final definition.
+     *
+     * @returns The accumulated column definition
+     */
+    getDefinition(): ColumnDefinition;
+}
+export {};
+//# sourceMappingURL=column-builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"column-builder.d.ts","sourceRoot":"","sources":["../../src/migration/column-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AAE3F;;;GAGG;AACH,KAAK,aAAa,GAAG;IACnB,eAAe,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;CACvE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,aAAa;IAatB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAZ5B,kDAAkD;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmB;IAE9C;;;;;;;OAOG;gBAEgB,SAAS,EAAE,aAAa,EACzC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,UAAU,EAChB,OAAO,GAAE,OAAO,CACd,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,WAAW,GAAG,OAAO,GAAG,YAAY,GAAG,QAAQ,CAAC,CAC9E;IAcR;;;;;;;;;OASG;IACI,QAAQ,IAAI,IAAI;IAKvB;;;;;;OAMG;IACI,WAAW,IAAI,IAAI;IAS1B;;;;;;;;;;;OAWG;IACI,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IASpC;;;;;;;;;;;OAWG;IACI,MAAM,IAAI,IAAI;IAQrB;;;;;;;;;;;OAWG;IACI,KAAK,IAAI,IAAI;IAWpB;;;;;;;;;OASG;IACI,OAAO,IAAI,IAAI;IAKtB;;;;;;;;;;;;OAYG;IACI,aAAa,IAAI,IAAI;IAS5B;;;;;;;;;;;OAWG;IACI,QAAQ,IAAI,IAAI;IASvB;;;;;;;;;;;;OAYG;IACI,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IASlC;;;;;;OAMG;IACI,aAAa,IAAI,gBAAgB;CAGzC"}

package/cjs/migration/column-builder.js

@@ -0,0 +1,217 @@
+'use strict';/**
+ * Fluent builder for defining column properties.
+ *
+ * Allows chaining modifiers like `.nullable()`, `.unique()`, `.default()`.
+ * Each column builder is bound to a parent migration and accumulates
+ * the column definition through method chains.
+ *
+ * @example
+ * ```typescript
+ * this.string("email")
+ *   .nullable()
+ *   .unique()
+ *   .default("guest@example.com");
+ * ```
+ *
+ * @example
+ * ```typescript
+ * this.integer("age")
+ *   .unsigned()
+ *   .comment("User's age in years");
+ * ```
+ */
+class ColumnBuilder {
+    migration;
+    /** Mutable column definition being accumulated */
+    definition;
+    /**
+     * Create a new column builder.
+     *
+     * @param migration - Parent migration instance for index registration
+     * @param name - Column name
+     * @param type - Column data type
+     * @param options - Optional initial configuration
+     */
+    constructor(migration, name, type, options = {}) {
+        this.migration = migration;
+        this.definition = {
+            name,
+            type,
+            nullable: false,
+            ...options,
+        };
+    }
+    // ============================================================================
+    // NULLABILITY
+    // ============================================================================
+    /**
+     * Mark column as nullable (allows NULL values).
+     *
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.string("middleName").nullable();
+     * ```
+     */
+    nullable() {
+        this.definition.nullable = true;
+        return this;
+    }
+    /**
+     * Mark column as not nullable (disallows NULL values).
+     *
+     * This is the default, but can be used for clarity.
+     *
+     * @returns This builder for chaining
+     */
+    notNullable() {
+        this.definition.nullable = false;
+        return this;
+    }
+    // ============================================================================
+    // DEFAULT VALUES
+    // ============================================================================
+    /**
+     * Set default value for the column.
+     *
+     * @param value - Default value (can be a literal or expression)
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.boolean("isActive").default(true);
+     * this.dateTime("createdAt").default("NOW()");
+     * ```
+     */
+    default(value) {
+        this.definition.defaultValue = value;
+        return this;
+    }
+    // ============================================================================
+    // INDEXES
+    // ============================================================================
+    /**
+     * Add unique constraint/index on this column.
+     *
+     * Registers a pending unique index with the parent migration.
+     *
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.string("email").unique();
+     * ```
+     */
+    unique() {
+        this.migration.addPendingIndex({
+            columns: [this.definition.name],
+            unique: true,
+        });
+        return this;
+    }
+    /**
+     * Add regular index on this column.
+     *
+     * Registers a pending index with the parent migration.
+     *
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.string("email").index();
+     * ```
+     */
+    index() {
+        this.migration.addPendingIndex({
+            columns: [this.definition.name],
+        });
+        return this;
+    }
+    // ============================================================================
+    // PRIMARY KEY & AUTO INCREMENT
+    // ============================================================================
+    /**
+     * Mark as primary key.
+     *
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.integer("id").primary();
+     * ```
+     */
+    primary() {
+        this.definition.primary = true;
+        return this;
+    }
+    /**
+     * Mark as auto-increment (numeric types only).
+     *
+     * SQL databases will use native AUTO_INCREMENT/SERIAL.
+     * NoSQL databases ignore this.
+     *
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.integer("id").primary().autoIncrement();
+     * ```
+     */
+    autoIncrement() {
+        this.definition.autoIncrement = true;
+        return this;
+    }
+    // ============================================================================
+    // NUMERIC MODIFIERS
+    // ============================================================================
+    /**
+     * Mark as unsigned (numeric types only).
+     *
+     * Disallows negative values and doubles the positive range.
+     *
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.integer("age").unsigned();
+     * ```
+     */
+    unsigned() {
+        this.definition.unsigned = true;
+        return this;
+    }
+    // ============================================================================
+    // METADATA
+    // ============================================================================
+    /**
+     * Add comment/description to column.
+     *
+     * Stored as column metadata in the database.
+     *
+     * @param text - Comment text
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * this.string("sku").comment("Stock Keeping Unit code");
+     * ```
+     */
+    comment(text) {
+        this.definition.comment = text;
+        return this;
+    }
+    // ============================================================================
+    // ACCESSOR
+    // ============================================================================
+    /**
+     * Get the built column definition.
+     *
+     * Called internally by the Migration class to extract the final definition.
+     *
+     * @returns The accumulated column definition
+     */
+    getDefinition() {
+        return this.definition;
+    }
+}exports.ColumnBuilder=ColumnBuilder;//# sourceMappingURL=column-builder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"column-builder.js","sources":["../../src/migration/column-builder.ts"],"sourcesContent":[null],"names":[],"mappings":"aAUA;;;;;;;;;;;;;;;;;;;;;AAqBG;MACU,aAAa,CAAA;AAaL,IAAA,SAAA,CAAA;;AAXF,IAAA,UAAU,CAAmB;AAE9C;;;;;;;AAOG;AACH,IAAA,WAAA,CACmB,SAAwB,EACzC,IAAY,EACZ,IAAgB,EAChB,UAEI,EAAE,EAAA;QALW,IAAS,CAAA,SAAA,GAAT,SAAS,CAAe;QAOzC,IAAI,CAAC,UAAU,GAAG;YAChB,IAAI;YACJ,IAAI;AACJ,YAAA,QAAQ,EAAE,KAAK;AACf,YAAA,GAAG,OAAO;SACX,CAAC;KACH;;;;AAMD;;;;;;;;;AASG;IACI,QAAQ,GAAA;AACb,QAAA,IAAI,CAAC,UAAU,CAAC,QAAQ,GAAG,IAAI,CAAC;AAChC,QAAA,OAAO,IAAI,CAAC;KACb;AAED;;;;;;AAMG;IACI,WAAW,GAAA;AAChB,QAAA,IAAI,CAAC,UAAU,CAAC,QAAQ,GAAG,KAAK,CAAC;AACjC,QAAA,OAAO,IAAI,CAAC;KACb;;;;AAMD;;;;;;;;;;;AAWG;AACI,IAAA,OAAO,CAAC,KAAc,EAAA;AAC3B,QAAA,IAAI,CAAC,UAAU,CAAC,YAAY,GAAG,KAAK,CAAC;AACrC,QAAA,OAAO,IAAI,CAAC;KACb;;;;AAMD;;;;;;;;;;;AAWG;IACI,MAAM,GAAA;AACX,QAAA,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC;AAC7B,YAAA,OAAO,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;AAC/B,YAAA,MAAM,EAAE,IAAI;AACb,SAAA,CAAC,CAAC;AACH,QAAA,OAAO,IAAI,CAAC;KACb;AAED;;;;;;;;;;;AAWG;IACI,KAAK,GAAA;AACV,QAAA,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC;AAC7B,YAAA,OAAO,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;AAChC,SAAA,CAAC,CAAC;AACH,QAAA,OAAO,IAAI,CAAC;KACb;;;;AAMD;;;;;;;;;AASG;IACI,OAAO,GAAA;AACZ,QAAA,IAAI,CAAC,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC;AAC/B,QAAA,OAAO,IAAI,CAAC;KACb;AAED;;;;;;;;;;;;AAYG;IACI,aAAa,GAAA;AAClB,QAAA,IAAI,CAAC,UAAU,CAAC,aAAa,GAAG,IAAI,CAAC;AACrC,QAAA,OAAO,IAAI,CAAC;KACb;;;;AAMD;;;;;;;;;;;AAWG;IACI,QAAQ,GAAA;AACb,QAAA,IAAI,CAAC,UAAU,CAAC,QAAQ,GAAG,IAAI,CAAC;AAChC,QAAA,OAAO,IAAI,CAAC;KACb;;;;AAMD;;;;;;;;;;;;AAYG;AACI,IAAA,OAAO,CAAC,IAAY,EAAA;AACzB,QAAA,IAAI,CAAC,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC;AAC/B,QAAA,OAAO,IAAI,CAAC;KACb;;;;AAMD;;;;;;AAMG;IACI,aAAa,GAAA;QAClB,OAAO,IAAI,CAAC,UAAU,CAAC;KACxB;AACF"}