@hedystia/db 2.0.0 → 2.0.2

package/dist/schema/column.d.mts

@@ -0,0 +1,120 @@
+import { ColumnDataType, ColumnMetadata, DeferredRefMeta, ReferenceAction } from "../types.mjs";
+
+//#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.mts.map

package/dist/schema/column.mjs

@@ -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
+export { ColumnBuilder };
+
+//# sourceMappingURL=column.mjs.map

package/dist/schema/column.mjs.map

@@ -0,0 +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>} 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/columns/index.cjs

@@ -0,0 +1,202 @@
+const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
+const require_column = require("../column.cjs");
+//#region src/schema/columns/index.ts
+var columns_exports = /* @__PURE__ */ require_runtime.__exportAll({
+	NamedColumnStarter: () => NamedColumnStarter,
+	bigint: () => bigint,
+	blob: () => blob,
+	boolean: () => boolean,
+	char: () => char,
+	d: () => d,
+	datetime: () => datetime,
+	decimal: () => decimal,
+	float: () => float,
+	integer: () => integer,
+	json: () => json,
+	name: () => name,
+	text: () => text,
+	timestamp: () => timestamp,
+	varchar: () => varchar
+});
+/**
+* Create an INTEGER column
+* @returns {ColumnBuilder<number>} Column builder for integer type
+*/
+const integer = () => new require_column.ColumnBuilder("integer");
+/**
+* Create a BIGINT column
+* @returns {ColumnBuilder<number>} Column builder for bigint type
+*/
+const bigint = () => new require_column.ColumnBuilder("bigint");
+/**
+* Create a VARCHAR column with specified length
+* @param {number} [length=255] - Maximum character length
+* @returns {ColumnBuilder<string>} Column builder for varchar type
+*/
+const varchar = (length = 255) => new require_column.ColumnBuilder("varchar", length);
+/**
+* Create a CHAR column with specified length
+* @param {number} [length=1] - Fixed character length
+* @returns {ColumnBuilder<string>} Column builder for char type
+*/
+const char = (length = 1) => new require_column.ColumnBuilder("char", length);
+/**
+* Create a TEXT column
+* @returns {ColumnBuilder<string>} Column builder for text type
+*/
+const text = () => new require_column.ColumnBuilder("text");
+/**
+* Create a BOOLEAN column
+* @returns {ColumnBuilder<boolean>} Column builder for boolean type
+*/
+const boolean = () => new require_column.ColumnBuilder("boolean");
+/**
+* Create a JSON column
+* @returns {ColumnBuilder<unknown>} Column builder for json type
+*/
+const json = () => new require_column.ColumnBuilder("json");
+/**
+* Create a DATETIME column
+* @returns {ColumnBuilder<Date>} Column builder for datetime type
+*/
+const datetime = () => new require_column.ColumnBuilder("datetime");
+/**
+* Create a TIMESTAMP column
+* @returns {ColumnBuilder<Date>} Column builder for timestamp type
+*/
+const timestamp = () => new require_column.ColumnBuilder("timestamp");
+/**
+* Create a DECIMAL column with precision and scale
+* @param {number} [precision=10] - Total number of digits
+* @param {number} [scale=2] - Number of decimal digits
+* @returns {ColumnBuilder<number>} Column builder for decimal type
+*/
+const decimal = (precision = 10, scale = 2) => new require_column.ColumnBuilder("decimal", void 0, precision, scale);
+/**
+* Create a FLOAT column
+* @returns {ColumnBuilder<number>} Column builder for float type
+*/
+const float = () => new require_column.ColumnBuilder("float");
+/**
+* Create a BLOB column
+* @returns {ColumnBuilder<Buffer>} Column builder for blob type
+*/
+const blob = () => new require_column.ColumnBuilder("blob");
+/**
+* Starter class for creating columns with a pre-set database column name
+* @example
+* // Start with name, then pick column type
+* guildId: name("guild_id").varchar(255)
+*/
+var NamedColumnStarter = class {
+	_alias;
+	constructor(alias) {
+		this._alias = alias;
+	}
+	/** Create an INTEGER column with this database column name */
+	integer() {
+		return new require_column.ColumnBuilder("integer").name(this._alias);
+	}
+	/** Create a BIGINT column with this database column name */
+	bigint() {
+		return new require_column.ColumnBuilder("bigint").name(this._alias);
+	}
+	/** Create a VARCHAR column with this database column name
+	* @param {number} [length=255] - Maximum character length
+	*/
+	varchar(length = 255) {
+		return new require_column.ColumnBuilder("varchar", length).name(this._alias);
+	}
+	/** Create a CHAR column with this database column name
+	* @param {number} [length=1] - Fixed character length
+	*/
+	char(length = 1) {
+		return new require_column.ColumnBuilder("char", length).name(this._alias);
+	}
+	/** Create a TEXT column with this database column name */
+	text() {
+		return new require_column.ColumnBuilder("text").name(this._alias);
+	}
+	/** Create a BOOLEAN column with this database column name */
+	boolean() {
+		return new require_column.ColumnBuilder("boolean").name(this._alias);
+	}
+	/** Create a JSON column with this database column name */
+	json() {
+		return new require_column.ColumnBuilder("json").name(this._alias);
+	}
+	/** Create a DATETIME column with this database column name */
+	datetime() {
+		return new require_column.ColumnBuilder("datetime").name(this._alias);
+	}
+	/** Create a TIMESTAMP column with this database column name */
+	timestamp() {
+		return new require_column.ColumnBuilder("timestamp").name(this._alias);
+	}
+	/** Create a DECIMAL column with this database column name
+	* @param {number} [precision=10] - Total number of digits
+	* @param {number} [scale=2] - Number of decimal digits
+	*/
+	decimal(precision = 10, scale = 2) {
+		return new require_column.ColumnBuilder("decimal", void 0, precision, scale).name(this._alias);
+	}
+	/** Create a FLOAT column with this database column name */
+	float() {
+		return new require_column.ColumnBuilder("float").name(this._alias);
+	}
+	/** Create a BLOB column with this database column name */
+	blob() {
+		return new require_column.ColumnBuilder("blob").name(this._alias);
+	}
+};
+/**
+* Create a column with a custom database column name, then pick the column type
+* @param {string} alias - The column name to use in the database
+* @returns {NamedColumnStarter} A starter object to pick the column type
+* @example
+* guildId: name("guild_id").varchar(255).notNull()
+*/
+const name = (alias) => new NamedColumnStarter(alias);
+/**
+* Column type helpers object for schema definitions
+* @returns {typeof d} Column type helpers
+*/
+const d = {
+	integer,
+	bigint,
+	varchar,
+	char,
+	text,
+	boolean,
+	json,
+	datetime,
+	timestamp,
+	decimal,
+	float,
+	blob,
+	name
+};
+//#endregion
+exports.NamedColumnStarter = NamedColumnStarter;
+exports.bigint = bigint;
+exports.blob = blob;
+exports.boolean = boolean;
+exports.char = char;
+Object.defineProperty(exports, "columns_exports", {
+	enumerable: true,
+	get: function() {
+		return columns_exports;
+	}
+});
+exports.d = d;
+exports.datetime = datetime;
+exports.decimal = decimal;
+exports.float = float;
+exports.integer = integer;
+exports.json = json;
+exports.name = name;
+exports.text = text;
+exports.timestamp = timestamp;
+exports.varchar = varchar;
+
+//# sourceMappingURL=index.cjs.map

package/dist/schema/columns/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["ColumnBuilder"],"sources":["../../../src/schema/columns/index.ts"],"sourcesContent":["import { ColumnBuilder } from \"../column\";\n\n/**\n * Create an INTEGER column\n * @returns {ColumnBuilder<number>} Column builder for integer type\n */\nexport const integer = (): ColumnBuilder<number> => new ColumnBuilder<number>(\"integer\");\n\n/**\n * Create a BIGINT column\n * @returns {ColumnBuilder<number>} Column builder for bigint type\n */\nexport const bigint = (): ColumnBuilder<number> => new ColumnBuilder<number>(\"bigint\");\n\n/**\n * Create a VARCHAR column with specified length\n * @param {number} [length=255] - Maximum character length\n * @returns {ColumnBuilder<string>} Column builder for varchar type\n */\nexport const varchar = (length = 255): ColumnBuilder<string> =>\n  new ColumnBuilder<string>(\"varchar\", length);\n\n/**\n * Create a CHAR column with specified length\n * @param {number} [length=1] - Fixed character length\n * @returns {ColumnBuilder<string>} Column builder for char type\n */\nexport const char = (length = 1): ColumnBuilder<string> =>\n  new ColumnBuilder<string>(\"char\", length);\n\n/**\n * Create a TEXT column\n * @returns {ColumnBuilder<string>} Column builder for text type\n */\nexport const text = (): ColumnBuilder<string> => new ColumnBuilder<string>(\"text\");\n\n/**\n * Create a BOOLEAN column\n * @returns {ColumnBuilder<boolean>} Column builder for boolean type\n */\nexport const boolean = (): ColumnBuilder<boolean> => new ColumnBuilder<boolean>(\"boolean\");\n\n/**\n * Create a JSON column\n * @returns {ColumnBuilder<unknown>} Column builder for json type\n */\nexport const json = (): ColumnBuilder<unknown> => new ColumnBuilder<unknown>(\"json\");\n\n/**\n * Create a DATETIME column\n * @returns {ColumnBuilder<Date>} Column builder for datetime type\n */\nexport const datetime = (): ColumnBuilder<Date> => new ColumnBuilder<Date>(\"datetime\");\n\n/**\n * Create a TIMESTAMP column\n * @returns {ColumnBuilder<Date>} Column builder for timestamp type\n */\nexport const timestamp = (): ColumnBuilder<Date> => new ColumnBuilder<Date>(\"timestamp\");\n\n/**\n * Create a DECIMAL column with precision and scale\n * @param {number} [precision=10] - Total number of digits\n * @param {number} [scale=2] - Number of decimal digits\n * @returns {ColumnBuilder<number>} Column builder for decimal type\n */\nexport const decimal = (precision = 10, scale = 2): ColumnBuilder<number> =>\n  new ColumnBuilder<number>(\"decimal\", undefined, precision, scale);\n\n/**\n * Create a FLOAT column\n * @returns {ColumnBuilder<number>} Column builder for float type\n */\nexport const float = (): ColumnBuilder<number> => new ColumnBuilder<number>(\"float\");\n\n/**\n * Create a BLOB column\n * @returns {ColumnBuilder<Buffer>} Column builder for blob type\n */\nexport const blob = (): ColumnBuilder<Buffer> => new ColumnBuilder<Buffer>(\"blob\");\n\n/**\n * Starter class for creating columns with a pre-set database column name\n * @example\n * // Start with name, then pick column type\n * guildId: name(\"guild_id\").varchar(255)\n */\nexport class NamedColumnStarter {\n  private _alias: string;\n\n  constructor(alias: string) {\n    this._alias = alias;\n  }\n\n  /** Create an INTEGER column with this database column name */\n  integer(): ColumnBuilder<number> {\n    return new ColumnBuilder<number>(\"integer\").name(this._alias);\n  }\n\n  /** Create a BIGINT column with this database column name */\n  bigint(): ColumnBuilder<number> {\n    return new ColumnBuilder<number>(\"bigint\").name(this._alias);\n  }\n\n  /** Create a VARCHAR column with this database column name\n   * @param {number} [length=255] - Maximum character length\n   */\n  varchar(length = 255): ColumnBuilder<string> {\n    return new ColumnBuilder<string>(\"varchar\", length).name(this._alias);\n  }\n\n  /** Create a CHAR column with this database column name\n   * @param {number} [length=1] - Fixed character length\n   */\n  char(length = 1): ColumnBuilder<string> {\n    return new ColumnBuilder<string>(\"char\", length).name(this._alias);\n  }\n\n  /** Create a TEXT column with this database column name */\n  text(): ColumnBuilder<string> {\n    return new ColumnBuilder<string>(\"text\").name(this._alias);\n  }\n\n  /** Create a BOOLEAN column with this database column name */\n  boolean(): ColumnBuilder<boolean> {\n    return new ColumnBuilder<boolean>(\"boolean\").name(this._alias);\n  }\n\n  /** Create a JSON column with this database column name */\n  json(): ColumnBuilder<unknown> {\n    return new ColumnBuilder<unknown>(\"json\").name(this._alias);\n  }\n\n  /** Create a DATETIME column with this database column name */\n  datetime(): ColumnBuilder<Date> {\n    return new ColumnBuilder<Date>(\"datetime\").name(this._alias);\n  }\n\n  /** Create a TIMESTAMP column with this database column name */\n  timestamp(): ColumnBuilder<Date> {\n    return new ColumnBuilder<Date>(\"timestamp\").name(this._alias);\n  }\n\n  /** Create a DECIMAL column with this database column name\n   * @param {number} [precision=10] - Total number of digits\n   * @param {number} [scale=2] - Number of decimal digits\n   */\n  decimal(precision = 10, scale = 2): ColumnBuilder<number> {\n    return new ColumnBuilder<number>(\"decimal\", undefined, precision, scale).name(this._alias);\n  }\n\n  /** Create a FLOAT column with this database column name */\n  float(): ColumnBuilder<number> {\n    return new ColumnBuilder<number>(\"float\").name(this._alias);\n  }\n\n  /** Create a BLOB column with this database column name */\n  blob(): ColumnBuilder<Buffer> {\n    return new ColumnBuilder<Buffer>(\"blob\").name(this._alias);\n  }\n}\n\n/**\n * Create a column with a custom database column name, then pick the column type\n * @param {string} alias - The column name to use in the database\n * @returns {NamedColumnStarter} A starter object to pick the column type\n * @example\n * guildId: name(\"guild_id\").varchar(255).notNull()\n */\nexport const name = (alias: string): NamedColumnStarter => new NamedColumnStarter(alias);\n\n/**\n * Column type helpers object for schema definitions\n * @returns {typeof d} Column type helpers\n */\nexport const d = {\n  integer,\n  bigint,\n  varchar,\n  char,\n  text,\n  boolean,\n  json,\n  datetime,\n  timestamp,\n  decimal,\n  float,\n  blob,\n  name,\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAMA,MAAa,gBAAuC,IAAIA,eAAAA,cAAsB,UAAU;;;;;AAMxF,MAAa,eAAsC,IAAIA,eAAAA,cAAsB,SAAS;;;;;;AAOtF,MAAa,WAAW,SAAS,QAC/B,IAAIA,eAAAA,cAAsB,WAAW,OAAO;;;;;;AAO9C,MAAa,QAAQ,SAAS,MAC5B,IAAIA,eAAAA,cAAsB,QAAQ,OAAO;;;;;AAM3C,MAAa,aAAoC,IAAIA,eAAAA,cAAsB,OAAO;;;;;AAMlF,MAAa,gBAAwC,IAAIA,eAAAA,cAAuB,UAAU;;;;;AAM1F,MAAa,aAAqC,IAAIA,eAAAA,cAAuB,OAAO;;;;;AAMpF,MAAa,iBAAsC,IAAIA,eAAAA,cAAoB,WAAW;;;;;AAMtF,MAAa,kBAAuC,IAAIA,eAAAA,cAAoB,YAAY;;;;;;;AAQxF,MAAa,WAAW,YAAY,IAAI,QAAQ,MAC9C,IAAIA,eAAAA,cAAsB,WAAW,KAAA,GAAW,WAAW,MAAM;;;;;AAMnE,MAAa,cAAqC,IAAIA,eAAAA,cAAsB,QAAQ;;;;;AAMpF,MAAa,aAAoC,IAAIA,eAAAA,cAAsB,OAAO;;;;;;;AAQlF,IAAa,qBAAb,MAAgC;CAC9B;CAEA,YAAY,OAAe;AACzB,OAAK,SAAS;;;CAIhB,UAAiC;AAC/B,SAAO,IAAIA,eAAAA,cAAsB,UAAU,CAAC,KAAK,KAAK,OAAO;;;CAI/D,SAAgC;AAC9B,SAAO,IAAIA,eAAAA,cAAsB,SAAS,CAAC,KAAK,KAAK,OAAO;;;;;CAM9D,QAAQ,SAAS,KAA4B;AAC3C,SAAO,IAAIA,eAAAA,cAAsB,WAAW,OAAO,CAAC,KAAK,KAAK,OAAO;;;;;CAMvE,KAAK,SAAS,GAA0B;AACtC,SAAO,IAAIA,eAAAA,cAAsB,QAAQ,OAAO,CAAC,KAAK,KAAK,OAAO;;;CAIpE,OAA8B;AAC5B,SAAO,IAAIA,eAAAA,cAAsB,OAAO,CAAC,KAAK,KAAK,OAAO;;;CAI5D,UAAkC;AAChC,SAAO,IAAIA,eAAAA,cAAuB,UAAU,CAAC,KAAK,KAAK,OAAO;;;CAIhE,OAA+B;AAC7B,SAAO,IAAIA,eAAAA,cAAuB,OAAO,CAAC,KAAK,KAAK,OAAO;;;CAI7D,WAAgC;AAC9B,SAAO,IAAIA,eAAAA,cAAoB,WAAW,CAAC,KAAK,KAAK,OAAO;;;CAI9D,YAAiC;AAC/B,SAAO,IAAIA,eAAAA,cAAoB,YAAY,CAAC,KAAK,KAAK,OAAO;;;;;;CAO/D,QAAQ,YAAY,IAAI,QAAQ,GAA0B;AACxD,SAAO,IAAIA,eAAAA,cAAsB,WAAW,KAAA,GAAW,WAAW,MAAM,CAAC,KAAK,KAAK,OAAO;;;CAI5F,QAA+B;AAC7B,SAAO,IAAIA,eAAAA,cAAsB,QAAQ,CAAC,KAAK,KAAK,OAAO;;;CAI7D,OAA8B;AAC5B,SAAO,IAAIA,eAAAA,cAAsB,OAAO,CAAC,KAAK,KAAK,OAAO;;;;;;;;;;AAW9D,MAAa,QAAQ,UAAsC,IAAI,mBAAmB,MAAM;;;;;AAMxF,MAAa,IAAI;CACf;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD"}

package/dist/schema/columns/index.d.cts

@@ -0,0 +1,141 @@
+import { ColumnBuilder } from "../column.cjs";
+
+//#region src/schema/columns/index.d.ts
+declare namespace index_d_exports {
+  export { NamedColumnStarter, bigint, blob, boolean, char, d, datetime, decimal, float, integer, json, name, text, timestamp, varchar };
+}
+/**
+ * Create an INTEGER column
+ * @returns {ColumnBuilder<number>} Column builder for integer type
+ */
+declare const integer: () => ColumnBuilder<number>;
+/**
+ * Create a BIGINT column
+ * @returns {ColumnBuilder<number>} Column builder for bigint type
+ */
+declare const bigint: () => ColumnBuilder<number>;
+/**
+ * Create a VARCHAR column with specified length
+ * @param {number} [length=255] - Maximum character length
+ * @returns {ColumnBuilder<string>} Column builder for varchar type
+ */
+declare const varchar: (length?: number) => ColumnBuilder<string>;
+/**
+ * Create a CHAR column with specified length
+ * @param {number} [length=1] - Fixed character length
+ * @returns {ColumnBuilder<string>} Column builder for char type
+ */
+declare const char: (length?: number) => ColumnBuilder<string>;
+/**
+ * Create a TEXT column
+ * @returns {ColumnBuilder<string>} Column builder for text type
+ */
+declare const text: () => ColumnBuilder<string>;
+/**
+ * Create a BOOLEAN column
+ * @returns {ColumnBuilder<boolean>} Column builder for boolean type
+ */
+declare const boolean: () => ColumnBuilder<boolean>;
+/**
+ * Create a JSON column
+ * @returns {ColumnBuilder<unknown>} Column builder for json type
+ */
+declare const json: () => ColumnBuilder<unknown>;
+/**
+ * Create a DATETIME column
+ * @returns {ColumnBuilder<Date>} Column builder for datetime type
+ */
+declare const datetime: () => ColumnBuilder<Date>;
+/**
+ * Create a TIMESTAMP column
+ * @returns {ColumnBuilder<Date>} Column builder for timestamp type
+ */
+declare const timestamp: () => ColumnBuilder<Date>;
+/**
+ * Create a DECIMAL column with precision and scale
+ * @param {number} [precision=10] - Total number of digits
+ * @param {number} [scale=2] - Number of decimal digits
+ * @returns {ColumnBuilder<number>} Column builder for decimal type
+ */
+declare const decimal: (precision?: number, scale?: number) => ColumnBuilder<number>;
+/**
+ * Create a FLOAT column
+ * @returns {ColumnBuilder<number>} Column builder for float type
+ */
+declare const float: () => ColumnBuilder<number>;
+/**
+ * Create a BLOB column
+ * @returns {ColumnBuilder<Buffer>} Column builder for blob type
+ */
+declare const blob: () => ColumnBuilder<Buffer>;
+/**
+ * Starter class for creating columns with a pre-set database column name
+ * @example
+ * // Start with name, then pick column type
+ * guildId: name("guild_id").varchar(255)
+ */
+declare class NamedColumnStarter {
+  private _alias;
+  constructor(alias: string);
+  /** Create an INTEGER column with this database column name */
+  integer(): ColumnBuilder<number>;
+  /** Create a BIGINT column with this database column name */
+  bigint(): ColumnBuilder<number>;
+  /** Create a VARCHAR column with this database column name
+   * @param {number} [length=255] - Maximum character length
+   */
+  varchar(length?: number): ColumnBuilder<string>;
+  /** Create a CHAR column with this database column name
+   * @param {number} [length=1] - Fixed character length
+   */
+  char(length?: number): ColumnBuilder<string>;
+  /** Create a TEXT column with this database column name */
+  text(): ColumnBuilder<string>;
+  /** Create a BOOLEAN column with this database column name */
+  boolean(): ColumnBuilder<boolean>;
+  /** Create a JSON column with this database column name */
+  json(): ColumnBuilder<unknown>;
+  /** Create a DATETIME column with this database column name */
+  datetime(): ColumnBuilder<Date>;
+  /** Create a TIMESTAMP column with this database column name */
+  timestamp(): ColumnBuilder<Date>;
+  /** Create a DECIMAL column with this database column name
+   * @param {number} [precision=10] - Total number of digits
+   * @param {number} [scale=2] - Number of decimal digits
+   */
+  decimal(precision?: number, scale?: number): ColumnBuilder<number>;
+  /** Create a FLOAT column with this database column name */
+  float(): ColumnBuilder<number>;
+  /** Create a BLOB column with this database column name */
+  blob(): ColumnBuilder<Buffer>;
+}
+/**
+ * Create a column with a custom database column name, then pick the column type
+ * @param {string} alias - The column name to use in the database
+ * @returns {NamedColumnStarter} A starter object to pick the column type
+ * @example
+ * guildId: name("guild_id").varchar(255).notNull()
+ */
+declare const name: (alias: string) => NamedColumnStarter;
+/**
+ * Column type helpers object for schema definitions
+ * @returns {typeof d} Column type helpers
+ */
+declare const d: {
+  integer: () => ColumnBuilder<number>;
+  bigint: () => ColumnBuilder<number>;
+  varchar: (length?: number) => ColumnBuilder<string>;
+  char: (length?: number) => ColumnBuilder<string>;
+  text: () => ColumnBuilder<string>;
+  boolean: () => ColumnBuilder<boolean>;
+  json: () => ColumnBuilder<unknown>;
+  datetime: () => ColumnBuilder<Date>;
+  timestamp: () => ColumnBuilder<Date>;
+  decimal: (precision?: number, scale?: number) => ColumnBuilder<number>;
+  float: () => ColumnBuilder<number>;
+  blob: () => ColumnBuilder<Buffer>;
+  name: (alias: string) => NamedColumnStarter;
+};
+//#endregion
+export { NamedColumnStarter, bigint, blob, boolean, char, d, datetime, decimal, float, index_d_exports, integer, json, name, text, timestamp, varchar };
+//# sourceMappingURL=index.d.cts.map