@hedystia/db 2.0.0 → 2.0.1

package/dist/schema/column.mjs

@@ -0,0 +1,129 @@
+//#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;
+	_references;
+	constructor(type, length, precision, scale) {
+		this._type = type;
+		this._length = length;
+		this._precision = precision;
+		this._scale = scale;
+	}
+	/**
+	* 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;
+	}
+	/**
+	* 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,
+			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
+		};
+	}
+	/**
+	* 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 {\n  ColumnDataType,\n  ColumnMetadata,\n  DeferredRefMeta,\n  ReferenceAction,\n} 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 _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   * 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   * 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,\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    };\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":";;;;;;;;AAcA,IAAa,gBAAb,MAKE;CAKA;CACA,cAAsB;CACtB,iBAAyB;CACzB,WAAmB;CACnB,UAAkB;CAClB,gBAAiC,KAAA;CACjC;CACA;CACA;CACA;CAOA,YAAY,MAAsB,QAAiB,WAAoB,OAAgB;AACrF,OAAK,QAAQ;AACb,OAAK,UAAU;AACf,OAAK,aAAa;AAClB,OAAK,SAAS;;;;;;CAOhB,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;;;;;;;CAQT,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;GACA,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;GACb;;;;;;CAOH,mBAKS;AACP,SAAO,KAAK,eAAe"}

package/dist/schema/columns/index.cjs

@@ -0,0 +1,110 @@
+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({
+	bigint: () => bigint,
+	blob: () => blob,
+	boolean: () => boolean,
+	char: () => char,
+	d: () => d,
+	datetime: () => datetime,
+	decimal: () => decimal,
+	float: () => float,
+	integer: () => integer,
+	json: () => json,
+	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");
+/**
+* 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
+};
+//#endregion
+Object.defineProperty(exports, "columns_exports", {
+	enumerable: true,
+	get: function() {
+		return columns_exports;
+	}
+});
+exports.d = d;
+
+//# 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 * 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};\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;;;;;AAMlF,MAAa,IAAI;CACf;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD"}

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

@@ -0,0 +1,91 @@
+import { ColumnBuilder } from "../column.cjs";
+
+//#region src/schema/columns/index.d.ts
+declare namespace index_d_exports {
+  export { bigint, blob, boolean, char, d, datetime, decimal, float, integer, json, 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>;
+/**
+ * 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>;
+};
+//#endregion
+export { d, index_d_exports };
+//# sourceMappingURL=index.d.cts.map

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

@@ -0,0 +1,91 @@
+import { ColumnBuilder } from "../column.mjs";
+
+//#region src/schema/columns/index.d.ts
+declare namespace index_d_exports {
+  export { bigint, blob, boolean, char, d, datetime, decimal, float, integer, json, 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>;
+/**
+ * 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>;
+};
+//#endregion
+export { d, index_d_exports };
+//# sourceMappingURL=index.d.mts.map

package/dist/schema/columns/index.mjs

@@ -0,0 +1,104 @@
+import { __exportAll } from "../../_virtual/_rolldown/runtime.mjs";
+import { ColumnBuilder } from "../column.mjs";
+//#region src/schema/columns/index.ts
+var columns_exports = /* @__PURE__ */ __exportAll({
+	bigint: () => bigint,
+	blob: () => blob,
+	boolean: () => boolean,
+	char: () => char,
+	d: () => d,
+	datetime: () => datetime,
+	decimal: () => decimal,
+	float: () => float,
+	integer: () => integer,
+	json: () => json,
+	text: () => text,
+	timestamp: () => timestamp,
+	varchar: () => varchar
+});
+/**
+* Create an INTEGER column
+* @returns {ColumnBuilder<number>} Column builder for integer type
+*/
+const integer = () => new ColumnBuilder("integer");
+/**
+* Create a BIGINT column
+* @returns {ColumnBuilder<number>} Column builder for bigint type
+*/
+const bigint = () => new 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 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 ColumnBuilder("char", length);
+/**
+* Create a TEXT column
+* @returns {ColumnBuilder<string>} Column builder for text type
+*/
+const text = () => new ColumnBuilder("text");
+/**
+* Create a BOOLEAN column
+* @returns {ColumnBuilder<boolean>} Column builder for boolean type
+*/
+const boolean = () => new ColumnBuilder("boolean");
+/**
+* Create a JSON column
+* @returns {ColumnBuilder<unknown>} Column builder for json type
+*/
+const json = () => new ColumnBuilder("json");
+/**
+* Create a DATETIME column
+* @returns {ColumnBuilder<Date>} Column builder for datetime type
+*/
+const datetime = () => new ColumnBuilder("datetime");
+/**
+* Create a TIMESTAMP column
+* @returns {ColumnBuilder<Date>} Column builder for timestamp type
+*/
+const timestamp = () => new 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 ColumnBuilder("decimal", void 0, precision, scale);
+/**
+* Create a FLOAT column
+* @returns {ColumnBuilder<number>} Column builder for float type
+*/
+const float = () => new ColumnBuilder("float");
+/**
+* Create a BLOB column
+* @returns {ColumnBuilder<Buffer>} Column builder for blob type
+*/
+const blob = () => new ColumnBuilder("blob");
+/**
+* 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
+};
+//#endregion
+export { columns_exports, d };
+
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"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 * 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};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAMA,MAAa,gBAAuC,IAAI,cAAsB,UAAU;;;;;AAMxF,MAAa,eAAsC,IAAI,cAAsB,SAAS;;;;;;AAOtF,MAAa,WAAW,SAAS,QAC/B,IAAI,cAAsB,WAAW,OAAO;;;;;;AAO9C,MAAa,QAAQ,SAAS,MAC5B,IAAI,cAAsB,QAAQ,OAAO;;;;;AAM3C,MAAa,aAAoC,IAAI,cAAsB,OAAO;;;;;AAMlF,MAAa,gBAAwC,IAAI,cAAuB,UAAU;;;;;AAM1F,MAAa,aAAqC,IAAI,cAAuB,OAAO;;;;;AAMpF,MAAa,iBAAsC,IAAI,cAAoB,WAAW;;;;;AAMtF,MAAa,kBAAuC,IAAI,cAAoB,YAAY;;;;;;;AAQxF,MAAa,WAAW,YAAY,IAAI,QAAQ,MAC9C,IAAI,cAAsB,WAAW,KAAA,GAAW,WAAW,MAAM;;;;;AAMnE,MAAa,cAAqC,IAAI,cAAsB,QAAQ;;;;;AAMpF,MAAa,aAAoC,IAAI,cAAsB,OAAO;;;;;AAMlF,MAAa,IAAI;CACf;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD"}

package/dist/schema/registry.cjs

@@ -0,0 +1,101 @@
+const require_errors = require("../errors.cjs");
+//#region src/schema/registry.ts
+/**
+* Schema registry that manages table definitions and resolves references
+*/
+var SchemaRegistry = class {
+	tables = /* @__PURE__ */ new Map();
+	definitions = /* @__PURE__ */ new Map();
+	relations = /* @__PURE__ */ new Map();
+	/**
+	* Register table definitions and resolve all deferred references
+	* @param {readonly TableDefinition[]} schemas - Table definitions to register
+	*/
+	register(schemas) {
+		for (const schema of schemas) {
+			if (!schema.__table || !schema.__name) throw new require_errors.SchemaError("Invalid table definition");
+			this.definitions.set(schema.__name, schema);
+			this.tables.set(schema.__name, {
+				name: schema.__name,
+				columns: [...schema.__columns]
+			});
+		}
+		for (const schema of schemas) for (const ref of schema.__deferredRefs) {
+			const resolved = ref.resolve();
+			if (!resolved.table || !resolved.column) throw new require_errors.SchemaError(`Failed to resolve reference for ${schema.__name}.${ref.columnName}`);
+			if (!this.tables.has(resolved.table)) throw new require_errors.SchemaError(`Referenced table "${resolved.table}" does not exist in schema registry`);
+			const column = schema.__columns.find((c) => c.name === ref.columnName);
+			if (column) column.references = {
+				table: resolved.table,
+				column: resolved.column,
+				onDelete: ref.onDelete,
+				onUpdate: ref.onUpdate,
+				relationName: ref.relationName
+			};
+			const relationName = ref.relationName || ref.columnName.replace(/Id$/, "").replace(/_id$/, "");
+			if (!this.relations.has(schema.__name)) this.relations.set(schema.__name, []);
+			this.relations.get(schema.__name).push({
+				from: {
+					table: schema.__name,
+					column: ref.columnName
+				},
+				to: {
+					table: resolved.table,
+					column: resolved.column
+				},
+				relationName
+			});
+			if (!this.relations.has(resolved.table)) this.relations.set(resolved.table, []);
+			const reverseRelationName = schema.__name;
+			this.relations.get(resolved.table).push({
+				from: {
+					table: resolved.table,
+					column: resolved.column
+				},
+				to: {
+					table: schema.__name,
+					column: ref.columnName
+				},
+				relationName: reverseRelationName
+			});
+		}
+	}
+	/**
+	* Get table metadata by name
+	* @param {string} name - Table name
+	* @returns {TableMetadata | undefined} The table metadata
+	*/
+	getTable(name) {
+		return this.tables.get(name);
+	}
+	/**
+	* Get all registered table metadata
+	* @returns {Map<string, TableMetadata>} All registered tables
+	*/
+	getAllTables() {
+		return this.tables;
+	}
+	/**
+	* Get relations for a table
+	* @param {string} tableName - Table name
+	* @returns {Array<object>} Relations for the table
+	*/
+	getRelations(tableName) {
+		return this.relations.get(tableName) ?? [];
+	}
+	/**
+	* Get the primary key column name for a table
+	* @param {string} tableName - Table name
+	* @returns {string | null} The primary key column name or null
+	*/
+	getPrimaryKey(tableName) {
+		const table = this.tables.get(tableName);
+		if (!table) return null;
+		for (const col of table.columns) if (col.primaryKey) return col.name;
+		return null;
+	}
+};
+//#endregion
+exports.SchemaRegistry = SchemaRegistry;
+
+//# sourceMappingURL=registry.cjs.map

package/dist/schema/registry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.cjs","names":["SchemaError"],"sources":["../../src/schema/registry.ts"],"sourcesContent":["import { SchemaError } from \"../errors\";\nimport type { TableDefinition, TableMetadata } from \"../types\";\n\n/**\n * Schema registry that manages table definitions and resolves references\n */\nexport class SchemaRegistry {\n  private tables = new Map<string, TableMetadata>();\n  private definitions = new Map<string, TableDefinition>();\n  private relations = new Map<\n    string,\n    Array<{\n      from: { table: string; column: string };\n      to: { table: string; column: string };\n      relationName: string;\n    }>\n  >();\n\n  /**\n   * Register table definitions and resolve all deferred references\n   * @param {readonly TableDefinition[]} schemas - Table definitions to register\n   */\n  register(schemas: readonly TableDefinition<any, any, any, any>[]): void {\n    for (const schema of schemas) {\n      if (!schema.__table || !schema.__name) {\n        throw new SchemaError(\"Invalid table definition\");\n      }\n\n      this.definitions.set(schema.__name, schema);\n      this.tables.set(schema.__name, {\n        name: schema.__name,\n        columns: [...schema.__columns],\n      });\n    }\n\n    for (const schema of schemas) {\n      for (const ref of schema.__deferredRefs) {\n        const resolved = ref.resolve();\n        if (!resolved.table || !resolved.column) {\n          throw new SchemaError(\n            `Failed to resolve reference for ${schema.__name}.${ref.columnName}`,\n          );\n        }\n\n        if (!this.tables.has(resolved.table)) {\n          throw new SchemaError(\n            `Referenced table \"${resolved.table}\" does not exist in schema registry`,\n          );\n        }\n\n        const column = schema.__columns.find((c) => c.name === ref.columnName);\n        if (column) {\n          column.references = {\n            table: resolved.table,\n            column: resolved.column,\n            onDelete: ref.onDelete,\n            onUpdate: ref.onUpdate,\n            relationName: ref.relationName,\n          };\n        }\n\n        const relationName =\n          ref.relationName || ref.columnName.replace(/Id$/, \"\").replace(/_id$/, \"\");\n\n        if (!this.relations.has(schema.__name)) {\n          this.relations.set(schema.__name, []);\n        }\n        this.relations.get(schema.__name)!.push({\n          from: { table: schema.__name, column: ref.columnName },\n          to: { table: resolved.table, column: resolved.column },\n          relationName,\n        });\n\n        if (!this.relations.has(resolved.table)) {\n          this.relations.set(resolved.table, []);\n        }\n        const reverseRelationName = schema.__name;\n        this.relations.get(resolved.table)!.push({\n          from: { table: resolved.table, column: resolved.column },\n          to: { table: schema.__name, column: ref.columnName },\n          relationName: reverseRelationName,\n        });\n      }\n    }\n  }\n\n  /**\n   * Get table metadata by name\n   * @param {string} name - Table name\n   * @returns {TableMetadata | undefined} The table metadata\n   */\n  getTable(name: string): TableMetadata | undefined {\n    return this.tables.get(name);\n  }\n\n  /**\n   * Get all registered table metadata\n   * @returns {Map<string, TableMetadata>} All registered tables\n   */\n  getAllTables(): Map<string, TableMetadata> {\n    return this.tables;\n  }\n\n  /**\n   * Get relations for a table\n   * @param {string} tableName - Table name\n   * @returns {Array<object>} Relations for the table\n   */\n  getRelations(tableName: string): Array<{\n    from: { table: string; column: string };\n    to: { table: string; column: string };\n    relationName: string;\n  }> {\n    return this.relations.get(tableName) ?? [];\n  }\n\n  /**\n   * Get the primary key column name for a table\n   * @param {string} tableName - Table name\n   * @returns {string | null} The primary key column name or null\n   */\n  getPrimaryKey(tableName: string): string | null {\n    const table = this.tables.get(tableName);\n    if (!table) {\n      return null;\n    }\n    for (const col of table.columns) {\n      if (col.primaryKey) {\n        return col.name;\n      }\n    }\n    return null;\n  }\n}\n"],"mappings":";;;;;AAMA,IAAa,iBAAb,MAA4B;CAC1B,yBAAiB,IAAI,KAA4B;CACjD,8BAAsB,IAAI,KAA8B;CACxD,4BAAoB,IAAI,KAOrB;;;;;CAMH,SAAS,SAA+D;AACtE,OAAK,MAAM,UAAU,SAAS;AAC5B,OAAI,CAAC,OAAO,WAAW,CAAC,OAAO,OAC7B,OAAM,IAAIA,eAAAA,YAAY,2BAA2B;AAGnD,QAAK,YAAY,IAAI,OAAO,QAAQ,OAAO;AAC3C,QAAK,OAAO,IAAI,OAAO,QAAQ;IAC7B,MAAM,OAAO;IACb,SAAS,CAAC,GAAG,OAAO,UAAU;IAC/B,CAAC;;AAGJ,OAAK,MAAM,UAAU,QACnB,MAAK,MAAM,OAAO,OAAO,gBAAgB;GACvC,MAAM,WAAW,IAAI,SAAS;AAC9B,OAAI,CAAC,SAAS,SAAS,CAAC,SAAS,OAC/B,OAAM,IAAIA,eAAAA,YACR,mCAAmC,OAAO,OAAO,GAAG,IAAI,aACzD;AAGH,OAAI,CAAC,KAAK,OAAO,IAAI,SAAS,MAAM,CAClC,OAAM,IAAIA,eAAAA,YACR,qBAAqB,SAAS,MAAM,qCACrC;GAGH,MAAM,SAAS,OAAO,UAAU,MAAM,MAAM,EAAE,SAAS,IAAI,WAAW;AACtE,OAAI,OACF,QAAO,aAAa;IAClB,OAAO,SAAS;IAChB,QAAQ,SAAS;IACjB,UAAU,IAAI;IACd,UAAU,IAAI;IACd,cAAc,IAAI;IACnB;GAGH,MAAM,eACJ,IAAI,gBAAgB,IAAI,WAAW,QAAQ,OAAO,GAAG,CAAC,QAAQ,QAAQ,GAAG;AAE3E,OAAI,CAAC,KAAK,UAAU,IAAI,OAAO,OAAO,CACpC,MAAK,UAAU,IAAI,OAAO,QAAQ,EAAE,CAAC;AAEvC,QAAK,UAAU,IAAI,OAAO,OAAO,CAAE,KAAK;IACtC,MAAM;KAAE,OAAO,OAAO;KAAQ,QAAQ,IAAI;KAAY;IACtD,IAAI;KAAE,OAAO,SAAS;KAAO,QAAQ,SAAS;KAAQ;IACtD;IACD,CAAC;AAEF,OAAI,CAAC,KAAK,UAAU,IAAI,SAAS,MAAM,CACrC,MAAK,UAAU,IAAI,SAAS,OAAO,EAAE,CAAC;GAExC,MAAM,sBAAsB,OAAO;AACnC,QAAK,UAAU,IAAI,SAAS,MAAM,CAAE,KAAK;IACvC,MAAM;KAAE,OAAO,SAAS;KAAO,QAAQ,SAAS;KAAQ;IACxD,IAAI;KAAE,OAAO,OAAO;KAAQ,QAAQ,IAAI;KAAY;IACpD,cAAc;IACf,CAAC;;;;;;;;CAUR,SAAS,MAAyC;AAChD,SAAO,KAAK,OAAO,IAAI,KAAK;;;;;;CAO9B,eAA2C;AACzC,SAAO,KAAK;;;;;;;CAQd,aAAa,WAIV;AACD,SAAO,KAAK,UAAU,IAAI,UAAU,IAAI,EAAE;;;;;;;CAQ5C,cAAc,WAAkC;EAC9C,MAAM,QAAQ,KAAK,OAAO,IAAI,UAAU;AACxC,MAAI,CAAC,MACH,QAAO;AAET,OAAK,MAAM,OAAO,MAAM,QACtB,KAAI,IAAI,WACN,QAAO,IAAI;AAGf,SAAO"}