@hedystia/db 2.0.6 → 2.0.7

package/dist/errors.mjs

@@ -1,68 +1,52 @@
+import { __esmMin } from "./_virtual/_rolldown/runtime.mjs";
 //#region src/errors.ts
-/**
-* Base error for all database-related errors
-*/
-var DatabaseError = class extends Error {
-	constructor(message) {
-		super(message);
-		this.name = "DatabaseError";
-	}
-};
-/**
-* Error thrown when schema definition is invalid
-*/
-var SchemaError = class extends DatabaseError {
-	constructor(message) {
-		super(message);
-		this.name = "SchemaError";
-	}
-};
-/**
-* Error thrown when a database driver encounters an error
-*/
-var DriverError = class extends DatabaseError {
-	constructor(message) {
-		super(message);
-		this.name = "DriverError";
-	}
-};
-/**
-* Error thrown when a query is invalid
-*/
-var QueryError = class extends DatabaseError {
-	constructor(message) {
-		super(message);
-		this.name = "QueryError";
-	}
-};
-/**
-* Error thrown when schema synchronization fails
-*/
-var SyncError = class extends DatabaseError {
-	constructor(message) {
-		super(message);
-		this.name = "SyncError";
-	}
-};
-/**
-* Error thrown when migration execution fails
-*/
-var MigrationError = class extends DatabaseError {
-	constructor(message) {
-		super(message);
-		this.name = "MigrationError";
-	}
-};
-/**
-* Error thrown when cache operation fails
-*/
-var CacheError = class extends DatabaseError {
-	constructor(message) {
-		super(message);
-		this.name = "CacheError";
-	}
-};
+var DatabaseError, SchemaError, DriverError, QueryError, SyncError, MigrationError, CacheError;
+var init_errors = __esmMin((() => {
+	DatabaseError = class extends Error {
+		constructor(message) {
+			super(message);
+			this.name = "DatabaseError";
+		}
+	};
+	SchemaError = class extends DatabaseError {
+		constructor(message) {
+			super(message);
+			this.name = "SchemaError";
+		}
+	};
+	DriverError = class extends DatabaseError {
+		constructor(message) {
+			super(message);
+			this.name = "DriverError";
+		}
+	};
+	QueryError = class extends DatabaseError {
+		constructor(message) {
+			super(message);
+			this.name = "QueryError";
+		}
+	};
+	SyncError = class extends DatabaseError {
+		constructor(message) {
+			super(message);
+			this.name = "SyncError";
+		}
+	};
+	MigrationError = class extends DatabaseError {
+		constructor(message) {
+			super(message);
+			this.name = "MigrationError";
+		}
+	};
+	CacheError = class extends DatabaseError {
+		constructor(message) {
+			super(message);
+			this.name = "CacheError";
+		}
+	};
+}));
 //#endregion
-export { CacheError, DatabaseError, DriverError, MigrationError, QueryError, SchemaError, SyncError };
+init_errors();
+export { CacheError, DatabaseError, DriverError, MigrationError, QueryError, SchemaError, SyncError, init_errors };
 
 //# sourceMappingURL=errors.mjs.map

package/dist/errors.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"errors.mjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/**\n * Base error for all database-related errors\n */\nexport class DatabaseError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"DatabaseError\";\n  }\n}\n\n/**\n * Error thrown when schema definition is invalid\n */\nexport class SchemaError extends DatabaseError {\n  constructor(message: string) {\n    super(message);\n    this.name = \"SchemaError\";\n  }\n}\n\n/**\n * Error thrown when a database driver encounters an error\n */\nexport class DriverError extends DatabaseError {\n  constructor(message: string) {\n    super(message);\n    this.name = \"DriverError\";\n  }\n}\n\n/**\n * Error thrown when a query is invalid\n */\nexport class QueryError extends DatabaseError {\n  constructor(message: string) {\n    super(message);\n    this.name = \"QueryError\";\n  }\n}\n\n/**\n * Error thrown when schema synchronization fails\n */\nexport class SyncError extends DatabaseError {\n  constructor(message: string) {\n    super(message);\n    this.name = \"SyncError\";\n  }\n}\n\n/**\n * Error thrown when migration execution fails\n */\nexport class MigrationError extends DatabaseError {\n  constructor(message: string) {\n    super(message);\n    this.name = \"MigrationError\";\n  }\n}\n\n/**\n * Error thrown when cache operation fails\n */\nexport class CacheError extends DatabaseError {\n  constructor(message: string) {\n    super(message);\n    this.name = \"CacheError\";\n  }\n}\n"],"mappings":";;;;AAGA,IAAa,gBAAb,cAAmC,MAAM;CACvC,YAAY,SAAiB;AAC3B,QAAM,QAAQ;AACd,OAAK,OAAO;;;;;;AAOhB,IAAa,cAAb,cAAiC,cAAc;CAC7C,YAAY,SAAiB;AAC3B,QAAM,QAAQ;AACd,OAAK,OAAO;;;;;;AAOhB,IAAa,cAAb,cAAiC,cAAc;CAC7C,YAAY,SAAiB;AAC3B,QAAM,QAAQ;AACd,OAAK,OAAO;;;;;;AAOhB,IAAa,aAAb,cAAgC,cAAc;CAC5C,YAAY,SAAiB;AAC3B,QAAM,QAAQ;AACd,OAAK,OAAO;;;;;;AAOhB,IAAa,YAAb,cAA+B,cAAc;CAC3C,YAAY,SAAiB;AAC3B,QAAM,QAAQ;AACd,OAAK,OAAO;;;;;;AAOhB,IAAa,iBAAb,cAAoC,cAAc;CAChD,YAAY,SAAiB;AAC3B,QAAM,QAAQ;AACd,OAAK,OAAO;;;;;;AAOhB,IAAa,aAAb,cAAgC,cAAc;CAC5C,YAAY,SAAiB;AAC3B,QAAM,QAAQ;AACd,OAAK,OAAO"}
+{"version":3,"file":"errors.mjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/**\n * Base error for all database-related errors\n */\nexport class DatabaseError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"DatabaseError\";\n  }\n}\n\n/**\n * Error thrown when schema definition is invalid\n */\nexport class SchemaError extends DatabaseError {\n  constructor(message: string) {\n    super(message);\n    this.name = \"SchemaError\";\n  }\n}\n\n/**\n * Error thrown when a database driver encounters an error\n */\nexport class DriverError extends DatabaseError {\n  constructor(message: string) {\n    super(message);\n    this.name = \"DriverError\";\n  }\n}\n\n/**\n * Error thrown when a query is invalid\n */\nexport class QueryError extends DatabaseError {\n  constructor(message: string) {\n    super(message);\n    this.name = \"QueryError\";\n  }\n}\n\n/**\n * Error thrown when schema synchronization fails\n */\nexport class SyncError extends DatabaseError {\n  constructor(message: string) {\n    super(message);\n    this.name = \"SyncError\";\n  }\n}\n\n/**\n * Error thrown when migration execution fails\n */\nexport class MigrationError extends DatabaseError {\n  constructor(message: string) {\n    super(message);\n    this.name = \"MigrationError\";\n  }\n}\n\n/**\n * Error thrown when cache operation fails\n */\nexport class CacheError extends DatabaseError {\n  constructor(message: string) {\n    super(message);\n    this.name = \"CacheError\";\n  }\n}\n"],"mappings":";;;;AAGa,iBAAb,cAAmC,MAAM;EACvC,YAAY,SAAiB;AAC3B,SAAM,QAAQ;AACd,QAAK,OAAO;;;AAOH,eAAb,cAAiC,cAAc;EAC7C,YAAY,SAAiB;AAC3B,SAAM,QAAQ;AACd,QAAK,OAAO;;;AAOH,eAAb,cAAiC,cAAc;EAC7C,YAAY,SAAiB;AAC3B,SAAM,QAAQ;AACd,QAAK,OAAO;;;AAOH,cAAb,cAAgC,cAAc;EAC5C,YAAY,SAAiB;AAC3B,SAAM,QAAQ;AACd,QAAK,OAAO;;;AAOH,aAAb,cAA+B,cAAc;EAC3C,YAAY,SAAiB;AAC3B,SAAM,QAAQ;AACd,QAAK,OAAO;;;AAOH,kBAAb,cAAoC,cAAc;EAChD,YAAY,SAAiB;AAC3B,SAAM,QAAQ;AACd,QAAK,OAAO;;;AAOH,cAAb,cAAgC,cAAc;EAC5C,YAAY,SAAiB;AAC3B,SAAM,QAAQ;AACd,QAAK,OAAO"}

package/dist/index.mjs

@@ -1,19 +1,31 @@
 import { CacheManager } from "./cache/manager.mjs";
-import { CacheError, DatabaseError, DriverError, MigrationError, QueryError, SchemaError, SyncError } from "./errors.mjs";
-import { compileColumnDef, compileCreateTable, compileDelete, compileInsert, compileSelect, compileUpdate, compileWhere } from "./drivers/sql-compiler.mjs";
-import { createDriver } from "./drivers/index.mjs";
-import { ColumnBuilder } from "./schema/column.mjs";
-import { NamedColumnStarter, array, bigint, blob, boolean, char, columns_exports, d, datetime, decimal, float, integer, json, name, text, timestamp, varchar } from "./schema/columns/index.mjs";
-import { SchemaRegistry } from "./schema/registry.mjs";
-import { table } from "./schema/table.mjs";
-import { TableRepository } from "./core/repository.mjs";
-import { database } from "./core/database.mjs";
+import { init_cache } from "./cache/index.mjs";
+import { CacheError, DatabaseError, DriverError, MigrationError, QueryError, SchemaError, SyncError, init_errors } from "./errors.mjs";
+import { compileColumnDef, compileCreateTable, compileDelete, compileInsert, compileSelect, compileUpdate, compileWhere, init_sql_compiler } from "./drivers/sql-compiler.mjs";
+import { createDriver, init_drivers } from "./drivers/index.mjs";
+import { ColumnBuilder, init_column } from "./schema/column.mjs";
+import { NamedColumnStarter, array, bigint, blob, boolean, char, columns_exports, d, datetime, decimal, float, init_columns, integer, json, name, text, timestamp, varchar } from "./schema/columns/index.mjs";
+import { SchemaRegistry, init_registry } from "./schema/registry.mjs";
+import { init_table, table } from "./schema/table.mjs";
+import { TableRepository, init_repository } from "./core/repository.mjs";
+import { database, init_database } from "./core/database.mjs";
 import { init_definition, migration } from "./migrations/definition.mjs";
 import { generateMigrationTemplate, generateSchemaTemplate, init_templates } from "./migrations/templates.mjs";
 import { Synchronizer } from "./sync/synchronizer.mjs";
 //#region src/index.ts
+init_cache();
+init_database();
+init_repository();
+init_drivers();
+init_sql_compiler();
 init_definition();
 init_templates();
+init_column();
+init_columns();
+init_registry();
+init_table();
+init_errors();
+init_columns();
 var src_default = database;
 //#endregion
 export { CacheError, CacheManager, ColumnBuilder, DatabaseError, DriverError, MigrationError, NamedColumnStarter, QueryError, SchemaError, SchemaRegistry, SyncError, Synchronizer, TableRepository, array, bigint, blob, boolean, char, columns_exports as columns, compileColumnDef, compileCreateTable, compileDelete, compileInsert, compileSelect, compileUpdate, compileWhere, createDriver, d, database, datetime, decimal, src_default as default, float, generateMigrationTemplate, generateSchemaTemplate, integer, json, migration, name, table, text, timestamp, varchar };

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { CacheManager } from \"./cache\";\nimport { database } from \"./core/database\";\nimport { TableRepository } from \"./core/repository\";\nimport { createDriver } from \"./drivers\";\nimport {\n  compileColumnDef,\n  compileCreateTable,\n  compileDelete,\n  compileInsert,\n  compileSelect,\n  compileUpdate,\n  compileWhere,\n} from \"./drivers/sql-compiler\";\nimport { migration } from \"./migrations/definition\";\nimport { generateMigrationTemplate, generateSchemaTemplate } from \"./migrations/templates\";\nimport { ColumnBuilder } from \"./schema/column\";\nimport * as columns from \"./schema/columns\";\nimport { SchemaRegistry } from \"./schema/registry\";\nimport { table } from \"./schema/table\";\nimport { Synchronizer } from \"./sync/synchronizer\";\n\nexport {\n  CacheError,\n  DatabaseError,\n  DriverError,\n  MigrationError,\n  QueryError,\n  SchemaError,\n  SyncError,\n} from \"./errors\";\nexport * from \"./schema/columns\";\nexport type {\n  CacheConfig,\n  ColumnDataType,\n  ColumnMetadata,\n  ConnectionConfig,\n  DatabaseConfig,\n  DatabaseDriver,\n  DatabaseType,\n  DeferredRefMeta,\n  DeleteOptions,\n  FileConnectionConfig,\n  InferInsert,\n  InferRow,\n  InferUpdate,\n  MigrationContext,\n  MigrationDefinition,\n  MySQLConnectionConfig,\n  QueryOptions,\n  ReferenceAction,\n  RelationQueryMap,\n  RelationsFor,\n  Repository,\n  ResolveResult,\n  SQLiteConnectionConfig,\n  TableCacheConfig,\n  TableDefinition,\n  TableMetadata,\n  UpdateOptions,\n  WhereClause,\n  WhereCondition,\n} from \"./types\";\nexport {\n  CacheManager,\n  ColumnBuilder,\n  columns,\n  compileColumnDef,\n  compileCreateTable,\n  compileDelete,\n  compileInsert,\n  compileSelect,\n  compileUpdate,\n  compileWhere,\n  createDriver,\n  database,\n  generateMigrationTemplate,\n  generateSchemaTemplate,\n  migration,\n  SchemaRegistry,\n  Synchronizer,\n  TableRepository,\n  table,\n};\n\nexport default database;\n"],"mappings":";;;;;;;;;;;;;;iBAaoD;gBACuC;AAsE3F,IAAA,cAAe"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { CacheManager } from \"./cache\";\nimport { database } from \"./core/database\";\nimport { TableRepository } from \"./core/repository\";\nimport { createDriver } from \"./drivers\";\nimport {\n  compileColumnDef,\n  compileCreateTable,\n  compileDelete,\n  compileInsert,\n  compileSelect,\n  compileUpdate,\n  compileWhere,\n} from \"./drivers/sql-compiler\";\nimport { migration } from \"./migrations/definition\";\nimport { generateMigrationTemplate, generateSchemaTemplate } from \"./migrations/templates\";\nimport { ColumnBuilder } from \"./schema/column\";\nimport * as columns from \"./schema/columns\";\nimport { SchemaRegistry } from \"./schema/registry\";\nimport { table } from \"./schema/table\";\nimport { Synchronizer } from \"./sync/synchronizer\";\n\nexport {\n  CacheError,\n  DatabaseError,\n  DriverError,\n  MigrationError,\n  QueryError,\n  SchemaError,\n  SyncError,\n} from \"./errors\";\nexport * from \"./schema/columns\";\nexport type {\n  CacheConfig,\n  ColumnDataType,\n  ColumnMetadata,\n  ConnectionConfig,\n  DatabaseConfig,\n  DatabaseDriver,\n  DatabaseType,\n  DeferredRefMeta,\n  DeleteOptions,\n  FileConnectionConfig,\n  InferInsert,\n  InferRow,\n  InferUpdate,\n  MigrationContext,\n  MigrationDefinition,\n  MySQLConnectionConfig,\n  QueryOptions,\n  ReferenceAction,\n  RelationQueryMap,\n  RelationsFor,\n  Repository,\n  ResolveResult,\n  SQLiteConnectionConfig,\n  TableCacheConfig,\n  TableDefinition,\n  TableMetadata,\n  UpdateOptions,\n  WhereClause,\n  WhereCondition,\n} from \"./types\";\nexport {\n  CacheManager,\n  ColumnBuilder,\n  columns,\n  compileColumnDef,\n  compileCreateTable,\n  compileDelete,\n  compileInsert,\n  compileSelect,\n  compileUpdate,\n  compileWhere,\n  createDriver,\n  database,\n  generateMigrationTemplate,\n  generateSchemaTemplate,\n  migration,\n  SchemaRegistry,\n  Synchronizer,\n  TableRepository,\n  table,\n};\n\nexport default database;\n"],"mappings":";;;;;;;;;;;;;;;YAAuC;eACI;iBACS;cACX;mBAST;iBACoB;gBACuC;aAC3C;cACJ;eACO;YACZ;aAWrB;;AAuDlB,IAAA,cAAe"}

package/dist/schema/column.mjs

@@ -1,161 +1,159 @@
+import { __esmMin } from "../_virtual/_rolldown/runtime.mjs";
 //#region src/schema/column.ts
-/**
-* Base column builder with chainable methods for defining column properties
-* @template T - The TypeScript type this column resolves to
-* @template TN - The table name this column belongs to (set by table())
-* @template CN - The column name (set by table())
-* @template Ref - The deferred reference metadata (set by references())
-*/
-var ColumnBuilder = class {
-	_type;
-	_primaryKey = false;
-	_autoIncrement = false;
-	_notNull = false;
-	_unique = false;
-	_defaultValue = void 0;
-	_length;
-	_precision;
-	_scale;
-	_columnAlias;
-	_references;
-	constructor(type, length, precision, scale) {
-		this._type = type;
-		this._length = length;
-		this._precision = precision;
-		this._scale = scale;
-	}
-	/**
-	* Set a custom database column name different from the property key
-	* @param {string} alias - The column name to use in the database
-	* @returns {ColumnBuilder<T, TN, CN, Ref>} The column builder for chaining
-	* @example
-	* // In code: guildId, In database: guild_id
-	* guildId: varchar(255).name("guild_id")
-	*/
-	name(alias) {
-		this._columnAlias = alias;
-		return this;
-	}
-	/**
-	* Override the TypeScript type for this column with a custom type literal
-	* @template U - The custom type to use
-	* @returns {ColumnBuilder<U, TN, CN, Ref>} The column builder with the new type
-	* @example
-	* // Limits autocomplete to specific values
-	* locale: varchar(25).type<"en_US" | "es_ES">()
-	*/
-	type() {
-		return this;
-	}
-	/**
-	* Mark this column as a primary key
-	* @returns {ColumnBuilder<T, TN, CN, Ref>} The column builder for chaining
-	*/
-	primaryKey() {
-		this._primaryKey = true;
-		return this;
-	}
-	/**
-	* Mark this column as auto-incrementing
-	* @returns {ColumnBuilder<T, TN, CN, Ref>} The column builder for chaining
-	*/
-	autoIncrement() {
-		this._autoIncrement = true;
-		return this;
-	}
-	/**
-	* Mark this column as NOT NULL
-	* @returns {ColumnBuilder<NonNullable<T>, TN, CN, Ref>} The column builder for chaining
-	*/
-	notNull() {
-		this._notNull = true;
-		return this;
-	}
-	/**
-	* Mark this column as nullable
-	* @returns {ColumnBuilder<T | null, TN, CN, Ref>} The column builder for chaining
-	*/
-	nullable() {
-		this._notNull = false;
-		return this;
-	}
-	/**
-	* Mark this column as nullable (alias for {@link nullable})
-	* @returns {ColumnBuilder<T | null, TN, CN, Ref>} The column builder for chaining
-	*/
-	null() {
-		return this.nullable();
-	}
-	/**
-	* Set a default value for this column
-	* @param {T} value - The default value
-	* @returns {ColumnBuilder<T, TN, CN, Ref>} The column builder for chaining
-	*/
-	default(value) {
-		this._defaultValue = value;
-		return this;
-	}
-	/**
-	* Mark this column as having a unique constraint
-	* @returns {ColumnBuilder<T, TN, CN, Ref>} The column builder for chaining
-	*/
-	unique() {
-		this._unique = true;
-		return this;
-	}
-	/**
-	* Add a foreign key reference to another table's column
-	* @param {(() => ColumnBuilder<any>) | ColumnBuilder<any>} ref - A column reference or a function returning one
-	* @param {object} [options] - Reference options
-	* @param {ReferenceAction} [options.onDelete] - Action on delete
-	* @param {ReferenceAction} [options.onUpdate] - Action on update
-	* @param {string} [options.relationName] - Name for the relation
-	* @returns {ColumnBuilder<T>} The column builder for chaining
-	*/
-	references(ref, options) {
-		this._references = {
-			resolve: () => {
-				const col = typeof ref === "function" ? ref() : ref;
-				return {
-					table: col.__tableName ?? "",
-					column: col.__columnName ?? ""
-				};
-			},
-			onDelete: options?.onDelete,
-			onUpdate: options?.onUpdate,
-			relationName: options?.relationName
-		};
-		return this;
-	}
-	/**
-	* Build the column metadata from the builder configuration
-	* @param {string} name - The column name
-	* @returns {ColumnMetadata} The built column metadata
-	*/
-	__build(name) {
-		return {
-			name: this._columnAlias ?? name,
-			type: this._type,
-			primaryKey: this._primaryKey,
-			autoIncrement: this._autoIncrement,
-			notNull: this._notNull || this._primaryKey,
-			unique: this._unique || this._primaryKey,
-			defaultValue: this._defaultValue,
-			length: this._length,
-			precision: this._precision,
-			scale: this._scale,
-			columnAlias: this._columnAlias
-		};
-	}
-	/**
-	* Get deferred reference data if this column has a foreign key reference
-	* @returns {object | null} The deferred reference data or null
-	*/
-	__getDeferredRef() {
-		return this._references ?? null;
-	}
-};
+var ColumnBuilder;
+var init_column = __esmMin((() => {
+	ColumnBuilder = class {
+		_type;
+		_primaryKey = false;
+		_autoIncrement = false;
+		_notNull = false;
+		_unique = false;
+		_defaultValue = void 0;
+		_length;
+		_precision;
+		_scale;
+		_columnAlias;
+		_references;
+		constructor(type, length, precision, scale) {
+			this._type = type;
+			this._length = length;
+			this._precision = precision;
+			this._scale = scale;
+		}
+		/**
+		* Set a custom database column name different from the property key
+		* @param {string} alias - The column name to use in the database
+		* @returns {ColumnBuilder<T, TN, CN, Ref>} The column builder for chaining
+		* @example
+		* // In code: guildId, In database: guild_id
+		* guildId: varchar(255).name("guild_id")
+		*/
+		name(alias) {
+			this._columnAlias = alias;
+			return this;
+		}
+		/**
+		* Override the TypeScript type for this column with a custom type literal
+		* @template U - The custom type to use
+		* @returns {ColumnBuilder<U, TN, CN, Ref>} The column builder with the new type
+		* @example
+		* // Limits autocomplete to specific values
+		* locale: varchar(25).type<"en_US" | "es_ES">()
+		*/
+		type() {
+			return this;
+		}
+		/**
+		* Mark this column as a primary key
+		* @returns {ColumnBuilder<T, TN, CN, Ref>} The column builder for chaining
+		*/
+		primaryKey() {
+			this._primaryKey = true;
+			return this;
+		}
+		/**
+		* Mark this column as auto-incrementing
+		* @returns {ColumnBuilder<T, TN, CN, Ref>} The column builder for chaining
+		*/
+		autoIncrement() {
+			this._autoIncrement = true;
+			return this;
+		}
+		/**
+		* Mark this column as NOT NULL
+		* @returns {ColumnBuilder<NonNullable<T>, TN, CN, Ref>} The column builder for chaining
+		*/
+		notNull() {
+			this._notNull = true;
+			return this;
+		}
+		/**
+		* Mark this column as nullable
+		* @returns {ColumnBuilder<T | null, TN, CN, Ref>} The column builder for chaining
+		*/
+		nullable() {
+			this._notNull = false;
+			return this;
+		}
+		/**
+		* Mark this column as nullable (alias for {@link nullable})
+		* @returns {ColumnBuilder<T | null, TN, CN, Ref>} The column builder for chaining
+		*/
+		null() {
+			return this.nullable();
+		}
+		/**
+		* Set a default value for this column
+		* @param {T} value - The default value
+		* @returns {ColumnBuilder<T, TN, CN, Ref>} The column builder for chaining
+		*/
+		default(value) {
+			this._defaultValue = value;
+			return this;
+		}
+		/**
+		* Mark this column as having a unique constraint
+		* @returns {ColumnBuilder<T, TN, CN, Ref>} The column builder for chaining
+		*/
+		unique() {
+			this._unique = true;
+			return this;
+		}
+		/**
+		* Add a foreign key reference to another table's column
+		* @param {(() => ColumnBuilder<any>) | ColumnBuilder<any>} ref - A column reference or a function returning one
+		* @param {object} [options] - Reference options
+		* @param {ReferenceAction} [options.onDelete] - Action on delete
+		* @param {ReferenceAction} [options.onUpdate] - Action on update
+		* @param {string} [options.relationName] - Name for the relation
+		* @returns {ColumnBuilder<T>} The column builder for chaining
+		*/
+		references(ref, options) {
+			this._references = {
+				resolve: () => {
+					const col = typeof ref === "function" ? ref() : ref;
+					return {
+						table: col.__tableName ?? "",
+						column: col.__columnName ?? ""
+					};
+				},
+				onDelete: options?.onDelete,
+				onUpdate: options?.onUpdate,
+				relationName: options?.relationName
+			};
+			return this;
+		}
+		/**
+		* Build the column metadata from the builder configuration
+		* @param {string} name - The column name
+		* @returns {ColumnMetadata} The built column metadata
+		*/
+		__build(name) {
+			return {
+				name: this._columnAlias ?? name,
+				type: this._type,
+				primaryKey: this._primaryKey,
+				autoIncrement: this._autoIncrement,
+				notNull: this._notNull || this._primaryKey,
+				unique: this._unique || this._primaryKey,
+				defaultValue: this._defaultValue,
+				length: this._length,
+				precision: this._precision,
+				scale: this._scale,
+				columnAlias: this._columnAlias
+			};
+		}
+		/**
+		* Get deferred reference data if this column has a foreign key reference
+		* @returns {object | null} The deferred reference data or null
+		*/
+		__getDeferredRef() {
+			return this._references ?? null;
+		}
+	};
+}));
 //#endregion
-export { ColumnBuilder };
+init_column();
+export { ColumnBuilder, init_column };
 
 //# sourceMappingURL=column.mjs.map

package/dist/schema/column.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"column.mjs","names":[],"sources":["../../src/schema/column.ts"],"sourcesContent":["import type { ColumnDataType, ColumnMetadata, DeferredRefMeta, ReferenceAction } from \"../types\";\n\n/**\n * Base column builder with chainable methods for defining column properties\n * @template T - The TypeScript type this column resolves to\n * @template TN - The table name this column belongs to (set by table())\n * @template CN - The column name (set by table())\n * @template Ref - The deferred reference metadata (set by references())\n */\nexport class ColumnBuilder<\n  T = unknown,\n  TN extends string = string,\n  CN extends string = string,\n  Ref extends DeferredRefMeta = never,\n> {\n  declare readonly __type: T;\n  declare readonly __tableName: TN;\n  declare readonly __columnName: CN;\n  declare readonly __ref: Ref;\n  private _type: ColumnDataType;\n  private _primaryKey = false;\n  private _autoIncrement = false;\n  private _notNull = false;\n  private _unique = false;\n  private _defaultValue: unknown = undefined;\n  private _length?: number;\n  private _precision?: number;\n  private _scale?: number;\n  private _columnAlias?: string;\n  private _references?: {\n    resolve: () => { table: string; column: string };\n    onDelete?: ReferenceAction;\n    onUpdate?: ReferenceAction;\n    relationName?: string;\n  };\n\n  constructor(type: ColumnDataType, length?: number, precision?: number, scale?: number) {\n    this._type = type;\n    this._length = length;\n    this._precision = precision;\n    this._scale = scale;\n  }\n\n  /**\n   * Set a custom database column name different from the property key\n   * @param {string} alias - The column name to use in the database\n   * @returns {ColumnBuilder<T, TN, CN, Ref>} The column builder for chaining\n   * @example\n   * // In code: guildId, In database: guild_id\n   * guildId: varchar(255).name(\"guild_id\")\n   */\n  name(alias: string): ColumnBuilder<T, TN, CN, Ref> {\n    this._columnAlias = alias;\n    return this;\n  }\n\n  /**\n   * Override the TypeScript type for this column with a custom type literal\n   * @template U - The custom type to use\n   * @returns {ColumnBuilder<U, TN, CN, Ref>} The column builder with the new type\n   * @example\n   * // Limits autocomplete to specific values\n   * locale: varchar(25).type<\"en_US\" | \"es_ES\">()\n   */\n  type<U>(): ColumnBuilder<U, TN, CN, Ref> {\n    return this as unknown as ColumnBuilder<U, TN, CN, Ref>;\n  }\n\n  /**\n   * Mark this column as a primary key\n   * @returns {ColumnBuilder<T, TN, CN, Ref>} The column builder for chaining\n   */\n  primaryKey(): ColumnBuilder<T, TN, CN, Ref> {\n    this._primaryKey = true;\n    return this;\n  }\n\n  /**\n   * Mark this column as auto-incrementing\n   * @returns {ColumnBuilder<T, TN, CN, Ref>} The column builder for chaining\n   */\n  autoIncrement(): ColumnBuilder<T, TN, CN, Ref> {\n    this._autoIncrement = true;\n    return this;\n  }\n\n  /**\n   * Mark this column as NOT NULL\n   * @returns {ColumnBuilder<NonNullable<T>, TN, CN, Ref>} The column builder for chaining\n   */\n  notNull(): ColumnBuilder<NonNullable<T>, TN, CN, Ref> {\n    this._notNull = true;\n    return this as unknown as ColumnBuilder<NonNullable<T>, TN, CN, Ref>;\n  }\n\n  /**\n   * Mark this column as nullable\n   * @returns {ColumnBuilder<T | null, TN, CN, Ref>} The column builder for chaining\n   */\n  nullable(): ColumnBuilder<T | null, TN, CN, Ref> {\n    this._notNull = false;\n    return this as unknown as ColumnBuilder<T | null, TN, CN, Ref>;\n  }\n\n  /**\n   * Mark this column as nullable (alias for {@link nullable})\n   * @returns {ColumnBuilder<T | null, TN, CN, Ref>} The column builder for chaining\n   */\n  null(): ColumnBuilder<T | null, TN, CN, Ref> {\n    return this.nullable();\n  }\n\n  /**\n   * Set a default value for this column\n   * @param {T} value - The default value\n   * @returns {ColumnBuilder<T, TN, CN, Ref>} The column builder for chaining\n   */\n  default(value: T): ColumnBuilder<T, TN, CN, Ref> {\n    this._defaultValue = value;\n    return this;\n  }\n\n  /**\n   * Mark this column as having a unique constraint\n   * @returns {ColumnBuilder<T, TN, CN, Ref>} The column builder for chaining\n   */\n  unique(): ColumnBuilder<T, TN, CN, Ref> {\n    this._unique = true;\n    return this;\n  }\n\n  /**\n   * Add a foreign key reference to another table's column\n   * @param {(() => ColumnBuilder<any>) | ColumnBuilder<any>} ref - A column reference or a function returning one\n   * @param {object} [options] - Reference options\n   * @param {ReferenceAction} [options.onDelete] - Action on delete\n   * @param {ReferenceAction} [options.onUpdate] - Action on update\n   * @param {string} [options.relationName] - Name for the relation\n   * @returns {ColumnBuilder<T>} The column builder for chaining\n   */\n  references<\n    R extends ColumnBuilder<any, string, string, any>,\n    O extends {\n      onDelete?: ReferenceAction;\n      onUpdate?: ReferenceAction;\n      relationName?: string;\n    } = never,\n  >(\n    ref: (() => R) | R,\n    options?: O,\n  ): ColumnBuilder<\n    T,\n    TN,\n    CN,\n    DeferredRefMeta<\n      CN,\n      R[\"__tableName\"],\n      R[\"__columnName\"],\n      O extends { relationName: infer N extends string } ? N : undefined\n    >\n  > {\n    this._references = {\n      resolve: () => {\n        const col = typeof ref === \"function\" ? ref() : ref;\n        return {\n          table: (col as any).__tableName ?? \"\",\n          column: (col as any).__columnName ?? \"\",\n        };\n      },\n      onDelete: options?.onDelete,\n      onUpdate: options?.onUpdate,\n      relationName: options?.relationName,\n    };\n    return this as any;\n  }\n\n  /**\n   * Build the column metadata from the builder configuration\n   * @param {string} name - The column name\n   * @returns {ColumnMetadata} The built column metadata\n   */\n  __build(name: string): ColumnMetadata {\n    return {\n      name: this._columnAlias ?? name,\n      type: this._type,\n      primaryKey: this._primaryKey,\n      autoIncrement: this._autoIncrement,\n      notNull: this._notNull || this._primaryKey,\n      unique: this._unique || this._primaryKey,\n      defaultValue: this._defaultValue,\n      length: this._length,\n      precision: this._precision,\n      scale: this._scale,\n      columnAlias: this._columnAlias,\n    };\n  }\n\n  /**\n   * Get deferred reference data if this column has a foreign key reference\n   * @returns {object | null} The deferred reference data or null\n   */\n  __getDeferredRef(): {\n    resolve: () => { table: string; column: string };\n    onDelete?: ReferenceAction;\n    onUpdate?: ReferenceAction;\n    relationName?: string;\n  } | null {\n    return this._references ?? null;\n  }\n}\n"],"mappings":";;;;;;;;AASA,IAAa,gBAAb,MAKE;CAKA;CACA,cAAsB;CACtB,iBAAyB;CACzB,WAAmB;CACnB,UAAkB;CAClB,gBAAiC,KAAA;CACjC;CACA;CACA;CACA;CACA;CAOA,YAAY,MAAsB,QAAiB,WAAoB,OAAgB;AACrF,OAAK,QAAQ;AACb,OAAK,UAAU;AACf,OAAK,aAAa;AAClB,OAAK,SAAS;;;;;;;;;;CAWhB,KAAK,OAA8C;AACjD,OAAK,eAAe;AACpB,SAAO;;;;;;;;;;CAWT,OAAyC;AACvC,SAAO;;;;;;CAOT,aAA4C;AAC1C,OAAK,cAAc;AACnB,SAAO;;;;;;CAOT,gBAA+C;AAC7C,OAAK,iBAAiB;AACtB,SAAO;;;;;;CAOT,UAAsD;AACpD,OAAK,WAAW;AAChB,SAAO;;;;;;CAOT,WAAiD;AAC/C,OAAK,WAAW;AAChB,SAAO;;;;;;CAOT,OAA6C;AAC3C,SAAO,KAAK,UAAU;;;;;;;CAQxB,QAAQ,OAAyC;AAC/C,OAAK,gBAAgB;AACrB,SAAO;;;;;;CAOT,SAAwC;AACtC,OAAK,UAAU;AACf,SAAO;;;;;;;;;;;CAYT,WAQE,KACA,SAWA;AACA,OAAK,cAAc;GACjB,eAAe;IACb,MAAM,MAAM,OAAO,QAAQ,aAAa,KAAK,GAAG;AAChD,WAAO;KACL,OAAQ,IAAY,eAAe;KACnC,QAAS,IAAY,gBAAgB;KACtC;;GAEH,UAAU,SAAS;GACnB,UAAU,SAAS;GACnB,cAAc,SAAS;GACxB;AACD,SAAO;;;;;;;CAQT,QAAQ,MAA8B;AACpC,SAAO;GACL,MAAM,KAAK,gBAAgB;GAC3B,MAAM,KAAK;GACX,YAAY,KAAK;GACjB,eAAe,KAAK;GACpB,SAAS,KAAK,YAAY,KAAK;GAC/B,QAAQ,KAAK,WAAW,KAAK;GAC7B,cAAc,KAAK;GACnB,QAAQ,KAAK;GACb,WAAW,KAAK;GAChB,OAAO,KAAK;GACZ,aAAa,KAAK;GACnB;;;;;;CAOH,mBAKS;AACP,SAAO,KAAK,eAAe"}
+{"version":3,"file":"column.mjs","names":[],"sources":["../../src/schema/column.ts"],"sourcesContent":["import type { ColumnDataType, ColumnMetadata, DeferredRefMeta, ReferenceAction } from \"../types\";\n\n/**\n * Base column builder with chainable methods for defining column properties\n * @template T - The TypeScript type this column resolves to\n * @template TN - The table name this column belongs to (set by table())\n * @template CN - The column name (set by table())\n * @template Ref - The deferred reference metadata (set by references())\n */\nexport class ColumnBuilder<\n  T = unknown,\n  TN extends string = string,\n  CN extends string = string,\n  Ref extends DeferredRefMeta = never,\n> {\n  declare readonly __type: T;\n  declare readonly __tableName: TN;\n  declare readonly __columnName: CN;\n  declare readonly __ref: Ref;\n  private _type: ColumnDataType;\n  private _primaryKey = false;\n  private _autoIncrement = false;\n  private _notNull = false;\n  private _unique = false;\n  private _defaultValue: unknown = undefined;\n  private _length?: number;\n  private _precision?: number;\n  private _scale?: number;\n  private _columnAlias?: string;\n  private _references?: {\n    resolve: () => { table: string; column: string };\n    onDelete?: ReferenceAction;\n    onUpdate?: ReferenceAction;\n    relationName?: string;\n  };\n\n  constructor(type: ColumnDataType, length?: number, precision?: number, scale?: number) {\n    this._type = type;\n    this._length = length;\n    this._precision = precision;\n    this._scale = scale;\n  }\n\n  /**\n   * Set a custom database column name different from the property key\n   * @param {string} alias - The column name to use in the database\n   * @returns {ColumnBuilder<T, TN, CN, Ref>} The column builder for chaining\n   * @example\n   * // In code: guildId, In database: guild_id\n   * guildId: varchar(255).name(\"guild_id\")\n   */\n  name(alias: string): ColumnBuilder<T, TN, CN, Ref> {\n    this._columnAlias = alias;\n    return this;\n  }\n\n  /**\n   * Override the TypeScript type for this column with a custom type literal\n   * @template U - The custom type to use\n   * @returns {ColumnBuilder<U, TN, CN, Ref>} The column builder with the new type\n   * @example\n   * // Limits autocomplete to specific values\n   * locale: varchar(25).type<\"en_US\" | \"es_ES\">()\n   */\n  type<U>(): ColumnBuilder<U, TN, CN, Ref> {\n    return this as unknown as ColumnBuilder<U, TN, CN, Ref>;\n  }\n\n  /**\n   * Mark this column as a primary key\n   * @returns {ColumnBuilder<T, TN, CN, Ref>} The column builder for chaining\n   */\n  primaryKey(): ColumnBuilder<T, TN, CN, Ref> {\n    this._primaryKey = true;\n    return this;\n  }\n\n  /**\n   * Mark this column as auto-incrementing\n   * @returns {ColumnBuilder<T, TN, CN, Ref>} The column builder for chaining\n   */\n  autoIncrement(): ColumnBuilder<T, TN, CN, Ref> {\n    this._autoIncrement = true;\n    return this;\n  }\n\n  /**\n   * Mark this column as NOT NULL\n   * @returns {ColumnBuilder<NonNullable<T>, TN, CN, Ref>} The column builder for chaining\n   */\n  notNull(): ColumnBuilder<NonNullable<T>, TN, CN, Ref> {\n    this._notNull = true;\n    return this as unknown as ColumnBuilder<NonNullable<T>, TN, CN, Ref>;\n  }\n\n  /**\n   * Mark this column as nullable\n   * @returns {ColumnBuilder<T | null, TN, CN, Ref>} The column builder for chaining\n   */\n  nullable(): ColumnBuilder<T | null, TN, CN, Ref> {\n    this._notNull = false;\n    return this as unknown as ColumnBuilder<T | null, TN, CN, Ref>;\n  }\n\n  /**\n   * Mark this column as nullable (alias for {@link nullable})\n   * @returns {ColumnBuilder<T | null, TN, CN, Ref>} The column builder for chaining\n   */\n  null(): ColumnBuilder<T | null, TN, CN, Ref> {\n    return this.nullable();\n  }\n\n  /**\n   * Set a default value for this column\n   * @param {T} value - The default value\n   * @returns {ColumnBuilder<T, TN, CN, Ref>} The column builder for chaining\n   */\n  default(value: T): ColumnBuilder<T, TN, CN, Ref> {\n    this._defaultValue = value;\n    return this;\n  }\n\n  /**\n   * Mark this column as having a unique constraint\n   * @returns {ColumnBuilder<T, TN, CN, Ref>} The column builder for chaining\n   */\n  unique(): ColumnBuilder<T, TN, CN, Ref> {\n    this._unique = true;\n    return this;\n  }\n\n  /**\n   * Add a foreign key reference to another table's column\n   * @param {(() => ColumnBuilder<any>) | ColumnBuilder<any>} ref - A column reference or a function returning one\n   * @param {object} [options] - Reference options\n   * @param {ReferenceAction} [options.onDelete] - Action on delete\n   * @param {ReferenceAction} [options.onUpdate] - Action on update\n   * @param {string} [options.relationName] - Name for the relation\n   * @returns {ColumnBuilder<T>} The column builder for chaining\n   */\n  references<\n    R extends ColumnBuilder<any, string, string, any>,\n    O extends {\n      onDelete?: ReferenceAction;\n      onUpdate?: ReferenceAction;\n      relationName?: string;\n    } = never,\n  >(\n    ref: (() => R) | R,\n    options?: O,\n  ): ColumnBuilder<\n    T,\n    TN,\n    CN,\n    DeferredRefMeta<\n      CN,\n      R[\"__tableName\"],\n      R[\"__columnName\"],\n      O extends { relationName: infer N extends string } ? N : undefined\n    >\n  > {\n    this._references = {\n      resolve: () => {\n        const col = typeof ref === \"function\" ? ref() : ref;\n        return {\n          table: (col as any).__tableName ?? \"\",\n          column: (col as any).__columnName ?? \"\",\n        };\n      },\n      onDelete: options?.onDelete,\n      onUpdate: options?.onUpdate,\n      relationName: options?.relationName,\n    };\n    return this as any;\n  }\n\n  /**\n   * Build the column metadata from the builder configuration\n   * @param {string} name - The column name\n   * @returns {ColumnMetadata} The built column metadata\n   */\n  __build(name: string): ColumnMetadata {\n    return {\n      name: this._columnAlias ?? name,\n      type: this._type,\n      primaryKey: this._primaryKey,\n      autoIncrement: this._autoIncrement,\n      notNull: this._notNull || this._primaryKey,\n      unique: this._unique || this._primaryKey,\n      defaultValue: this._defaultValue,\n      length: this._length,\n      precision: this._precision,\n      scale: this._scale,\n      columnAlias: this._columnAlias,\n    };\n  }\n\n  /**\n   * Get deferred reference data if this column has a foreign key reference\n   * @returns {object | null} The deferred reference data or null\n   */\n  __getDeferredRef(): {\n    resolve: () => { table: string; column: string };\n    onDelete?: ReferenceAction;\n    onUpdate?: ReferenceAction;\n    relationName?: string;\n  } | null {\n    return this._references ?? null;\n  }\n}\n"],"mappings":";;;;AASa,iBAAb,MAKE;EAKA;EACA,cAAsB;EACtB,iBAAyB;EACzB,WAAmB;EACnB,UAAkB;EAClB,gBAAiC,KAAA;EACjC;EACA;EACA;EACA;EACA;EAOA,YAAY,MAAsB,QAAiB,WAAoB,OAAgB;AACrF,QAAK,QAAQ;AACb,QAAK,UAAU;AACf,QAAK,aAAa;AAClB,QAAK,SAAS;;;;;;;;;;EAWhB,KAAK,OAA8C;AACjD,QAAK,eAAe;AACpB,UAAO;;;;;;;;;;EAWT,OAAyC;AACvC,UAAO;;;;;;EAOT,aAA4C;AAC1C,QAAK,cAAc;AACnB,UAAO;;;;;;EAOT,gBAA+C;AAC7C,QAAK,iBAAiB;AACtB,UAAO;;;;;;EAOT,UAAsD;AACpD,QAAK,WAAW;AAChB,UAAO;;;;;;EAOT,WAAiD;AAC/C,QAAK,WAAW;AAChB,UAAO;;;;;;EAOT,OAA6C;AAC3C,UAAO,KAAK,UAAU;;;;;;;EAQxB,QAAQ,OAAyC;AAC/C,QAAK,gBAAgB;AACrB,UAAO;;;;;;EAOT,SAAwC;AACtC,QAAK,UAAU;AACf,UAAO;;;;;;;;;;;EAYT,WAQE,KACA,SAWA;AACA,QAAK,cAAc;IACjB,eAAe;KACb,MAAM,MAAM,OAAO,QAAQ,aAAa,KAAK,GAAG;AAChD,YAAO;MACL,OAAQ,IAAY,eAAe;MACnC,QAAS,IAAY,gBAAgB;MACtC;;IAEH,UAAU,SAAS;IACnB,UAAU,SAAS;IACnB,cAAc,SAAS;IACxB;AACD,UAAO;;;;;;;EAQT,QAAQ,MAA8B;AACpC,UAAO;IACL,MAAM,KAAK,gBAAgB;IAC3B,MAAM,KAAK;IACX,YAAY,KAAK;IACjB,eAAe,KAAK;IACpB,SAAS,KAAK,YAAY,KAAK;IAC/B,QAAQ,KAAK,WAAW,KAAK;IAC7B,cAAc,KAAK;IACnB,QAAQ,KAAK;IACb,WAAW,KAAK;IAChB,OAAO,KAAK;IACZ,aAAa,KAAK;IACnB;;;;;;EAOH,mBAKS;AACP,UAAO,KAAK,eAAe"}