@hedystia/db 2.0.0 → 2.0.2

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

@@ -0,0 +1,141 @@
+import { ColumnBuilder } from "../column.mjs";
+
+//#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.mts.map

package/dist/schema/columns/index.mjs

@@ -0,0 +1,182 @@
+import { __exportAll } from "../../_virtual/_rolldown/runtime.mjs";
+import { ColumnBuilder } from "../column.mjs";
+//#region src/schema/columns/index.ts
+var columns_exports = /* @__PURE__ */ __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 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");
+/**
+* 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 ColumnBuilder("integer").name(this._alias);
+	}
+	/** Create a BIGINT column with this database column name */
+	bigint() {
+		return new 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 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 ColumnBuilder("char", length).name(this._alias);
+	}
+	/** Create a TEXT column with this database column name */
+	text() {
+		return new ColumnBuilder("text").name(this._alias);
+	}
+	/** Create a BOOLEAN column with this database column name */
+	boolean() {
+		return new ColumnBuilder("boolean").name(this._alias);
+	}
+	/** Create a JSON column with this database column name */
+	json() {
+		return new ColumnBuilder("json").name(this._alias);
+	}
+	/** Create a DATETIME column with this database column name */
+	datetime() {
+		return new ColumnBuilder("datetime").name(this._alias);
+	}
+	/** Create a TIMESTAMP column with this database column name */
+	timestamp() {
+		return new 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 ColumnBuilder("decimal", void 0, precision, scale).name(this._alias);
+	}
+	/** Create a FLOAT column with this database column name */
+	float() {
+		return new ColumnBuilder("float").name(this._alias);
+	}
+	/** Create a BLOB column with this database column name */
+	blob() {
+		return new 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
+export { NamedColumnStarter, bigint, blob, boolean, char, columns_exports, d, datetime, decimal, float, integer, json, name, text, timestamp, varchar };
+
+//# 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 * 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,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;;;;;;;AAQlF,IAAa,qBAAb,MAAgC;CAC9B;CAEA,YAAY,OAAe;AACzB,OAAK,SAAS;;;CAIhB,UAAiC;AAC/B,SAAO,IAAI,cAAsB,UAAU,CAAC,KAAK,KAAK,OAAO;;;CAI/D,SAAgC;AAC9B,SAAO,IAAI,cAAsB,SAAS,CAAC,KAAK,KAAK,OAAO;;;;;CAM9D,QAAQ,SAAS,KAA4B;AAC3C,SAAO,IAAI,cAAsB,WAAW,OAAO,CAAC,KAAK,KAAK,OAAO;;;;;CAMvE,KAAK,SAAS,GAA0B;AACtC,SAAO,IAAI,cAAsB,QAAQ,OAAO,CAAC,KAAK,KAAK,OAAO;;;CAIpE,OAA8B;AAC5B,SAAO,IAAI,cAAsB,OAAO,CAAC,KAAK,KAAK,OAAO;;;CAI5D,UAAkC;AAChC,SAAO,IAAI,cAAuB,UAAU,CAAC,KAAK,KAAK,OAAO;;;CAIhE,OAA+B;AAC7B,SAAO,IAAI,cAAuB,OAAO,CAAC,KAAK,KAAK,OAAO;;;CAI7D,WAAgC;AAC9B,SAAO,IAAI,cAAoB,WAAW,CAAC,KAAK,KAAK,OAAO;;;CAI9D,YAAiC;AAC/B,SAAO,IAAI,cAAoB,YAAY,CAAC,KAAK,KAAK,OAAO;;;;;;CAO/D,QAAQ,YAAY,IAAI,QAAQ,GAA0B;AACxD,SAAO,IAAI,cAAsB,WAAW,KAAA,GAAW,WAAW,MAAM,CAAC,KAAK,KAAK,OAAO;;;CAI5F,QAA+B;AAC7B,SAAO,IAAI,cAAsB,QAAQ,CAAC,KAAK,KAAK,OAAO;;;CAI7D,OAA8B;AAC5B,SAAO,IAAI,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/registry.cjs

@@ -0,0 +1,125 @@
+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();
+	columnMaps = /* @__PURE__ */ new Map();
+	reverseColumnMaps = /* @__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]
+			});
+			const colMap = schema.__columnMap ?? {};
+			this.columnMaps.set(schema.__name, colMap);
+			const reverseMap = {};
+			for (const [codeKey, dbName] of Object.entries(colMap)) reverseMap[dbName] = codeKey;
+			this.reverseColumnMaps.set(schema.__name, reverseMap);
+		}
+		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 dbColumnName = (this.columnMaps.get(schema.__name) ?? {})[ref.columnName] ?? ref.columnName;
+			const column = schema.__columns.find((c) => c.name === dbColumnName);
+			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: dbColumnName
+				},
+				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: dbColumnName
+				},
+				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 (returns DB column name)
+	* @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;
+	}
+	/**
+	* Get the column name map (code key -> DB column name) for a table
+	* @param {string} tableName - Table name
+	* @returns {Record<string, string>} Column name map
+	*/
+	getColumnMap(tableName) {
+		return this.columnMaps.get(tableName) ?? {};
+	}
+	/**
+	* Get the reverse column name map (DB column name -> code key) for a table
+	* @param {string} tableName - Table name
+	* @returns {Record<string, string>} Reverse column name map
+	*/
+	getReverseColumnMap(tableName) {
+		return this.reverseColumnMaps.get(tableName) ?? {};
+	}
+};
+//#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 columnMaps = new Map<string, Record<string, string>>();\n  private reverseColumnMaps = new Map<string, Record<string, string>>();\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      const colMap: Record<string, string> = schema.__columnMap ?? {};\n      this.columnMaps.set(schema.__name, colMap);\n      const reverseMap: Record<string, string> = {};\n      for (const [codeKey, dbName] of Object.entries(colMap)) {\n        reverseMap[dbName] = codeKey;\n      }\n      this.reverseColumnMaps.set(schema.__name, reverseMap);\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 colMap = this.columnMaps.get(schema.__name) ?? {};\n        const dbColumnName = colMap[ref.columnName] ?? ref.columnName;\n        const column = schema.__columns.find((c: any) => c.name === dbColumnName);\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: dbColumnName },\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: dbColumnName },\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 (returns DB column name)\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  /**\n   * Get the column name map (code key -> DB column name) for a table\n   * @param {string} tableName - Table name\n   * @returns {Record<string, string>} Column name map\n   */\n  getColumnMap(tableName: string): Record<string, string> {\n    return this.columnMaps.get(tableName) ?? {};\n  }\n\n  /**\n   * Get the reverse column name map (DB column name -> code key) for a table\n   * @param {string} tableName - Table name\n   * @returns {Record<string, string>} Reverse column name map\n   */\n  getReverseColumnMap(tableName: string): Record<string, string> {\n    return this.reverseColumnMaps.get(tableName) ?? {};\n  }\n}\n"],"mappings":"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"}

package/dist/schema/registry.d.cts

@@ -0,0 +1,66 @@
+import { TableDefinition, TableMetadata } from "../types.cjs";
+
+//#region src/schema/registry.d.ts
+/**
+ * Schema registry that manages table definitions and resolves references
+ */
+declare class SchemaRegistry {
+  private tables;
+  private definitions;
+  private columnMaps;
+  private reverseColumnMaps;
+  private relations;
+  /**
+   * Register table definitions and resolve all deferred references
+   * @param {readonly TableDefinition[]} schemas - Table definitions to register
+   */
+  register(schemas: readonly TableDefinition<any, any, any, any>[]): void;
+  /**
+   * Get table metadata by name
+   * @param {string} name - Table name
+   * @returns {TableMetadata | undefined} The table metadata
+   */
+  getTable(name: string): TableMetadata | undefined;
+  /**
+   * Get all registered table metadata
+   * @returns {Map<string, TableMetadata>} All registered tables
+   */
+  getAllTables(): Map<string, TableMetadata>;
+  /**
+   * Get relations for a table
+   * @param {string} tableName - Table name
+   * @returns {Array<object>} Relations for the table
+   */
+  getRelations(tableName: string): Array<{
+    from: {
+      table: string;
+      column: string;
+    };
+    to: {
+      table: string;
+      column: string;
+    };
+    relationName: string;
+  }>;
+  /**
+   * Get the primary key column name for a table (returns DB column name)
+   * @param {string} tableName - Table name
+   * @returns {string | null} The primary key column name or null
+   */
+  getPrimaryKey(tableName: string): string | null;
+  /**
+   * Get the column name map (code key -> DB column name) for a table
+   * @param {string} tableName - Table name
+   * @returns {Record<string, string>} Column name map
+   */
+  getColumnMap(tableName: string): Record<string, string>;
+  /**
+   * Get the reverse column name map (DB column name -> code key) for a table
+   * @param {string} tableName - Table name
+   * @returns {Record<string, string>} Reverse column name map
+   */
+  getReverseColumnMap(tableName: string): Record<string, string>;
+}
+//#endregion
+export { SchemaRegistry };
+//# sourceMappingURL=registry.d.cts.map

package/dist/schema/registry.d.mts

@@ -0,0 +1,66 @@
+import { TableDefinition, TableMetadata } from "../types.mjs";
+
+//#region src/schema/registry.d.ts
+/**
+ * Schema registry that manages table definitions and resolves references
+ */
+declare class SchemaRegistry {
+  private tables;
+  private definitions;
+  private columnMaps;
+  private reverseColumnMaps;
+  private relations;
+  /**
+   * Register table definitions and resolve all deferred references
+   * @param {readonly TableDefinition[]} schemas - Table definitions to register
+   */
+  register(schemas: readonly TableDefinition<any, any, any, any>[]): void;
+  /**
+   * Get table metadata by name
+   * @param {string} name - Table name
+   * @returns {TableMetadata | undefined} The table metadata
+   */
+  getTable(name: string): TableMetadata | undefined;
+  /**
+   * Get all registered table metadata
+   * @returns {Map<string, TableMetadata>} All registered tables
+   */
+  getAllTables(): Map<string, TableMetadata>;
+  /**
+   * Get relations for a table
+   * @param {string} tableName - Table name
+   * @returns {Array<object>} Relations for the table
+   */
+  getRelations(tableName: string): Array<{
+    from: {
+      table: string;
+      column: string;
+    };
+    to: {
+      table: string;
+      column: string;
+    };
+    relationName: string;
+  }>;
+  /**
+   * Get the primary key column name for a table (returns DB column name)
+   * @param {string} tableName - Table name
+   * @returns {string | null} The primary key column name or null
+   */
+  getPrimaryKey(tableName: string): string | null;
+  /**
+   * Get the column name map (code key -> DB column name) for a table
+   * @param {string} tableName - Table name
+   * @returns {Record<string, string>} Column name map
+   */
+  getColumnMap(tableName: string): Record<string, string>;
+  /**
+   * Get the reverse column name map (DB column name -> code key) for a table
+   * @param {string} tableName - Table name
+   * @returns {Record<string, string>} Reverse column name map
+   */
+  getReverseColumnMap(tableName: string): Record<string, string>;
+}
+//#endregion
+export { SchemaRegistry };
+//# sourceMappingURL=registry.d.mts.map