@hedystia/db 2.0.0 → 2.0.2

package/dist/index.mjs

@@ -0,0 +1,21 @@
+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, 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_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_definition();
+init_templates();
+var src_default = database;
+//#endregion
+export { CacheError, CacheManager, ColumnBuilder, DatabaseError, DriverError, MigrationError, NamedColumnStarter, QueryError, SchemaError, SchemaRegistry, SyncError, Synchronizer, TableRepository, 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 };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +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  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;AAqE3F,IAAA,cAAe"}

package/dist/migrations/definition.cjs

@@ -0,0 +1,20 @@
+//#region src/migrations/definition.ts
+/**
+* Define a database migration
+* @param {string} name - Migration name (should match the file name)
+* @param {object} actions - Migration actions
+* @param {(ctx: MigrationContext) => Promise<void>} actions.up - Function to run when applying the migration
+* @param {(ctx: MigrationContext) => Promise<void>} actions.down - Function to run when reverting the migration
+* @returns {MigrationDefinition} The migration definition
+*/
+function migration(name, actions) {
+	return {
+		name,
+		up: actions.up,
+		down: actions.down
+	};
+}
+//#endregion
+exports.migration = migration;
+
+//# sourceMappingURL=definition.cjs.map

package/dist/migrations/definition.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.cjs","names":[],"sources":["../../src/migrations/definition.ts"],"sourcesContent":["import type { MigrationContext, MigrationDefinition } from \"../types\";\n\n/**\n * Define a database migration\n * @param {string} name - Migration name (should match the file name)\n * @param {object} actions - Migration actions\n * @param {(ctx: MigrationContext) => Promise<void>} actions.up - Function to run when applying the migration\n * @param {(ctx: MigrationContext) => Promise<void>} actions.down - Function to run when reverting the migration\n * @returns {MigrationDefinition} The migration definition\n */\nexport function migration(\n  name: string,\n  actions: {\n    up: (ctx: MigrationContext) => Promise<void>;\n    down: (ctx: MigrationContext) => Promise<void>;\n  },\n): MigrationDefinition {\n  return {\n    name,\n    up: actions.up,\n    down: actions.down,\n  };\n}\n"],"mappings":";;;;;;;;;AAUA,SAAgB,UACd,MACA,SAIqB;AACrB,QAAO;EACL;EACA,IAAI,QAAQ;EACZ,MAAM,QAAQ;EACf"}

package/dist/migrations/definition.d.cts

@@ -0,0 +1,18 @@
+import { MigrationContext, MigrationDefinition } from "../types.cjs";
+
+//#region src/migrations/definition.d.ts
+/**
+ * Define a database migration
+ * @param {string} name - Migration name (should match the file name)
+ * @param {object} actions - Migration actions
+ * @param {(ctx: MigrationContext) => Promise<void>} actions.up - Function to run when applying the migration
+ * @param {(ctx: MigrationContext) => Promise<void>} actions.down - Function to run when reverting the migration
+ * @returns {MigrationDefinition} The migration definition
+ */
+declare function migration(name: string, actions: {
+  up: (ctx: MigrationContext) => Promise<void>;
+  down: (ctx: MigrationContext) => Promise<void>;
+}): MigrationDefinition;
+//#endregion
+export { migration };
+//# sourceMappingURL=definition.d.cts.map

package/dist/migrations/definition.d.mts

@@ -0,0 +1,18 @@
+import { MigrationContext, MigrationDefinition } from "../types.mjs";
+
+//#region src/migrations/definition.d.ts
+/**
+ * Define a database migration
+ * @param {string} name - Migration name (should match the file name)
+ * @param {object} actions - Migration actions
+ * @param {(ctx: MigrationContext) => Promise<void>} actions.up - Function to run when applying the migration
+ * @param {(ctx: MigrationContext) => Promise<void>} actions.down - Function to run when reverting the migration
+ * @returns {MigrationDefinition} The migration definition
+ */
+declare function migration(name: string, actions: {
+  up: (ctx: MigrationContext) => Promise<void>;
+  down: (ctx: MigrationContext) => Promise<void>;
+}): MigrationDefinition;
+//#endregion
+export { migration };
+//# sourceMappingURL=definition.d.mts.map

package/dist/migrations/definition.mjs

@@ -0,0 +1,23 @@
+import { __esmMin } from "../_virtual/_rolldown/runtime.mjs";
+//#region src/migrations/definition.ts
+/**
+* Define a database migration
+* @param {string} name - Migration name (should match the file name)
+* @param {object} actions - Migration actions
+* @param {(ctx: MigrationContext) => Promise<void>} actions.up - Function to run when applying the migration
+* @param {(ctx: MigrationContext) => Promise<void>} actions.down - Function to run when reverting the migration
+* @returns {MigrationDefinition} The migration definition
+*/
+function migration(name, actions) {
+	return {
+		name,
+		up: actions.up,
+		down: actions.down
+	};
+}
+var init_definition = __esmMin((() => {}));
+//#endregion
+init_definition();
+export { init_definition, migration };
+
+//# sourceMappingURL=definition.mjs.map

package/dist/migrations/definition.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.mjs","names":[],"sources":["../../src/migrations/definition.ts"],"sourcesContent":["import type { MigrationContext, MigrationDefinition } from \"../types\";\n\n/**\n * Define a database migration\n * @param {string} name - Migration name (should match the file name)\n * @param {object} actions - Migration actions\n * @param {(ctx: MigrationContext) => Promise<void>} actions.up - Function to run when applying the migration\n * @param {(ctx: MigrationContext) => Promise<void>} actions.down - Function to run when reverting the migration\n * @returns {MigrationDefinition} The migration definition\n */\nexport function migration(\n  name: string,\n  actions: {\n    up: (ctx: MigrationContext) => Promise<void>;\n    down: (ctx: MigrationContext) => Promise<void>;\n  },\n): MigrationDefinition {\n  return {\n    name,\n    up: actions.up,\n    down: actions.down,\n  };\n}\n"],"mappings":";;;;;;;;;;AAUA,SAAgB,UACd,MACA,SAIqB;AACrB,QAAO;EACL;EACA,IAAI,QAAQ;EACZ,MAAM,QAAQ;EACf"}

package/dist/migrations/index.mjs

@@ -0,0 +1,12 @@
+import { __esmMin } from "../_virtual/_rolldown/runtime.mjs";
+import "./definition.mjs";
+import { init_templates } from "./templates.mjs";
+//#region src/migrations/index.ts
+var init_migrations = __esmMin((() => {
+	init_templates();
+}));
+//#endregion
+init_migrations();
+export { init_migrations };
+
+//# sourceMappingURL=index.mjs.map

package/dist/migrations/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/migrations/index.ts"],"sourcesContent":["export { migration } from \"./definition\";\nexport { generateMigrationTemplate, generateSchemaTemplate } from \"./templates\";\n"],"mappings":";;;;;iBACgF"}

package/dist/migrations/templates.cjs

@@ -0,0 +1,39 @@
+//#region src/migrations/templates.ts
+/**
+* Generate a migration file template
+* @param {string} name - Migration name
+* @returns {string} Migration file content
+*/
+function generateMigrationTemplate(name) {
+	return `import { migration } from "@hedystia/db";
+
+export default migration("${name}", {
+  async up({ schema, sql }) {
+    // Add your migration logic here
+  },
+  async down({ schema, sql }) {
+    // Add your rollback logic here
+  },
+});
+`;
+}
+/**
+* Generate a schema file template
+* @param {string} name - Table name
+* @returns {string} Schema file content
+*/
+function generateSchemaTemplate(name) {
+	return `import { table, integer, datetime } from "@hedystia/db";
+
+export const ${name} = table("${name}", {
+  id: integer().primaryKey().autoIncrement(),
+  createdAt: datetime().default(new Date()),
+  updatedAt: datetime().default(new Date()),
+});
+`;
+}
+//#endregion
+exports.generateMigrationTemplate = generateMigrationTemplate;
+exports.generateSchemaTemplate = generateSchemaTemplate;
+
+//# sourceMappingURL=templates.cjs.map

package/dist/migrations/templates.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.cjs","names":[],"sources":["../../src/migrations/templates.ts"],"sourcesContent":["/**\n * Generate a migration file template\n * @param {string} name - Migration name\n * @returns {string} Migration file content\n */\nexport function generateMigrationTemplate(name: string): string {\n  return `import { migration } from \"@hedystia/db\";\n\nexport default migration(\"${name}\", {\n  async up({ schema, sql }) {\n    // Add your migration logic here\n  },\n  async down({ schema, sql }) {\n    // Add your rollback logic here\n  },\n});\n`;\n}\n\n/**\n * Generate a schema file template\n * @param {string} name - Table name\n * @returns {string} Schema file content\n */\nexport function generateSchemaTemplate(name: string): string {\n  return `import { table, integer, datetime } from \"@hedystia/db\";\n\nexport const ${name} = table(\"${name}\", {\n  id: integer().primaryKey().autoIncrement(),\n  createdAt: datetime().default(new Date()),\n  updatedAt: datetime().default(new Date()),\n});\n`;\n}\n"],"mappings":";;;;;;AAKA,SAAgB,0BAA0B,MAAsB;AAC9D,QAAO;;4BAEmB,KAAK;;;;;;;;;;;;;;;AAgBjC,SAAgB,uBAAuB,MAAsB;AAC3D,QAAO;;eAEM,KAAK,YAAY,KAAK"}

package/dist/migrations/templates.d.cts

@@ -0,0 +1,16 @@
+//#region src/migrations/templates.d.ts
+/**
+ * Generate a migration file template
+ * @param {string} name - Migration name
+ * @returns {string} Migration file content
+ */
+declare function generateMigrationTemplate(name: string): string;
+/**
+ * Generate a schema file template
+ * @param {string} name - Table name
+ * @returns {string} Schema file content
+ */
+declare function generateSchemaTemplate(name: string): string;
+//#endregion
+export { generateMigrationTemplate, generateSchemaTemplate };
+//# sourceMappingURL=templates.d.cts.map

package/dist/migrations/templates.d.mts

@@ -0,0 +1,16 @@
+//#region src/migrations/templates.d.ts
+/**
+ * Generate a migration file template
+ * @param {string} name - Migration name
+ * @returns {string} Migration file content
+ */
+declare function generateMigrationTemplate(name: string): string;
+/**
+ * Generate a schema file template
+ * @param {string} name - Table name
+ * @returns {string} Schema file content
+ */
+declare function generateSchemaTemplate(name: string): string;
+//#endregion
+export { generateMigrationTemplate, generateSchemaTemplate };
+//# sourceMappingURL=templates.d.mts.map

package/dist/migrations/templates.mjs

@@ -0,0 +1,41 @@
+import { __esmMin } from "../_virtual/_rolldown/runtime.mjs";
+//#region src/migrations/templates.ts
+/**
+* Generate a migration file template
+* @param {string} name - Migration name
+* @returns {string} Migration file content
+*/
+function generateMigrationTemplate(name) {
+	return `import { migration } from "@hedystia/db";
+
+export default migration("${name}", {
+  async up({ schema, sql }) {
+    // Add your migration logic here
+  },
+  async down({ schema, sql }) {
+    // Add your rollback logic here
+  },
+});
+`;
+}
+/**
+* Generate a schema file template
+* @param {string} name - Table name
+* @returns {string} Schema file content
+*/
+function generateSchemaTemplate(name) {
+	return `import { table, integer, datetime } from "@hedystia/db";
+
+export const ${name} = table("${name}", {
+  id: integer().primaryKey().autoIncrement(),
+  createdAt: datetime().default(new Date()),
+  updatedAt: datetime().default(new Date()),
+});
+`;
+}
+var init_templates = __esmMin((() => {}));
+//#endregion
+init_templates();
+export { generateMigrationTemplate, generateSchemaTemplate, init_templates };
+
+//# sourceMappingURL=templates.mjs.map

package/dist/migrations/templates.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.mjs","names":[],"sources":["../../src/migrations/templates.ts"],"sourcesContent":["/**\n * Generate a migration file template\n * @param {string} name - Migration name\n * @returns {string} Migration file content\n */\nexport function generateMigrationTemplate(name: string): string {\n  return `import { migration } from \"@hedystia/db\";\n\nexport default migration(\"${name}\", {\n  async up({ schema, sql }) {\n    // Add your migration logic here\n  },\n  async down({ schema, sql }) {\n    // Add your rollback logic here\n  },\n});\n`;\n}\n\n/**\n * Generate a schema file template\n * @param {string} name - Table name\n * @returns {string} Schema file content\n */\nexport function generateSchemaTemplate(name: string): string {\n  return `import { table, integer, datetime } from \"@hedystia/db\";\n\nexport const ${name} = table(\"${name}\", {\n  id: integer().primaryKey().autoIncrement(),\n  createdAt: datetime().default(new Date()),\n  updatedAt: datetime().default(new Date()),\n});\n`;\n}\n"],"mappings":";;;;;;;AAKA,SAAgB,0BAA0B,MAAsB;AAC9D,QAAO;;4BAEmB,KAAK;;;;;;;;;;;;;;;AAgBjC,SAAgB,uBAAuB,MAAsB;AAC3D,QAAO;;eAEM,KAAK,YAAY,KAAK"}

package/dist/schema/column.cjs

@@ -0,0 +1,161 @@
+//#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>} ref - A function returning the referenced column
+	* @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 = 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
+exports.ColumnBuilder = ColumnBuilder;
+
+//# sourceMappingURL=column.cjs.map

package/dist/schema/column.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"column.cjs","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>} ref - A function returning the referenced column\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,\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 = 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,KAAK;AACjB,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"}

package/dist/schema/column.d.cts

@@ -0,0 +1,120 @@
+import { ColumnDataType, ColumnMetadata, DeferredRefMeta, ReferenceAction } from "../types.cjs";
+
+//#region src/schema/column.d.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())
+ */
+declare class ColumnBuilder<T = unknown, TN extends string = string, CN extends string = string, Ref extends DeferredRefMeta = never> {
+  readonly __type: T;
+  readonly __tableName: TN;
+  readonly __columnName: CN;
+  readonly __ref: Ref;
+  private _type;
+  private _primaryKey;
+  private _autoIncrement;
+  private _notNull;
+  private _unique;
+  private _defaultValue;
+  private _length?;
+  private _precision?;
+  private _scale?;
+  private _columnAlias?;
+  private _references?;
+  constructor(type: ColumnDataType, length?: number, precision?: number, scale?: number);
+  /**
+   * 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: string): ColumnBuilder<T, TN, CN, Ref>;
+  /**
+   * 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<U>(): ColumnBuilder<U, TN, CN, Ref>;
+  /**
+   * Mark this column as a primary key
+   * @returns {ColumnBuilder<T, TN, CN, Ref>} The column builder for chaining
+   */
+  primaryKey(): ColumnBuilder<T, TN, CN, Ref>;
+  /**
+   * Mark this column as auto-incrementing
+   * @returns {ColumnBuilder<T, TN, CN, Ref>} The column builder for chaining
+   */
+  autoIncrement(): ColumnBuilder<T, TN, CN, Ref>;
+  /**
+   * Mark this column as NOT NULL
+   * @returns {ColumnBuilder<NonNullable<T>, TN, CN, Ref>} The column builder for chaining
+   */
+  notNull(): ColumnBuilder<NonNullable<T>, TN, CN, Ref>;
+  /**
+   * Mark this column as nullable
+   * @returns {ColumnBuilder<T | null, TN, CN, Ref>} The column builder for chaining
+   */
+  nullable(): ColumnBuilder<T | null, TN, CN, Ref>;
+  /**
+   * Mark this column as nullable (alias for {@link nullable})
+   * @returns {ColumnBuilder<T | null, TN, CN, Ref>} The column builder for chaining
+   */
+  null(): ColumnBuilder<T | null, TN, CN, Ref>;
+  /**
+   * 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: T): ColumnBuilder<T, TN, CN, Ref>;
+  /**
+   * Mark this column as having a unique constraint
+   * @returns {ColumnBuilder<T, TN, CN, Ref>} The column builder for chaining
+   */
+  unique(): ColumnBuilder<T, TN, CN, Ref>;
+  /**
+   * Add a foreign key reference to another table's column
+   * @param {() => ColumnBuilder<any>} ref - A function returning the referenced column
+   * @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<R extends ColumnBuilder<any, string, string, any>, O extends {
+    onDelete?: ReferenceAction;
+    onUpdate?: ReferenceAction;
+    relationName?: string;
+  } = never>(ref: () => R, options?: O): ColumnBuilder<T, TN, CN, DeferredRefMeta<CN, R["__tableName"], R["__columnName"], O extends {
+    relationName: infer N extends string;
+  } ? N : undefined>>;
+  /**
+   * Build the column metadata from the builder configuration
+   * @param {string} name - The column name
+   * @returns {ColumnMetadata} The built column metadata
+   */
+  __build(name: string): ColumnMetadata;
+  /**
+   * Get deferred reference data if this column has a foreign key reference
+   * @returns {object | null} The deferred reference data or null
+   */
+  __getDeferredRef(): {
+    resolve: () => {
+      table: string;
+      column: string;
+    };
+    onDelete?: ReferenceAction;
+    onUpdate?: ReferenceAction;
+    relationName?: string;
+  } | null;
+}
+//#endregion
+export { ColumnBuilder };
+//# sourceMappingURL=column.d.cts.map