@hedystia/db 2.0.1 → 2.0.2

package/dist/schema/registry.d.mts

@@ -7,6 +7,8 @@ import { TableDefinition, TableMetadata } from "../types.mjs";
 declare class SchemaRegistry {
   private tables;
   private definitions;
+  private columnMaps;
+  private reverseColumnMaps;
   private relations;
   /**
    * Register table definitions and resolve all deferred references
@@ -41,11 +43,23 @@ declare class SchemaRegistry {
     relationName: string;
   }>;
   /**
-   * Get the primary key column name for a table
+   * 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 };

package/dist/schema/registry.mjs

@@ -6,6 +6,8 @@ import { SchemaError } from "../errors.mjs";
 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
@@ -19,12 +21,18 @@ var SchemaRegistry = class {
 				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 SchemaError(`Failed to resolve reference for ${schema.__name}.${ref.columnName}`);
 			if (!this.tables.has(resolved.table)) throw new SchemaError(`Referenced table "${resolved.table}" does not exist in schema registry`);
-			const column = schema.__columns.find((c) => c.name === ref.columnName);
+			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,
@@ -37,7 +45,7 @@ var SchemaRegistry = class {
 			this.relations.get(schema.__name).push({
 				from: {
 					table: schema.__name,
-					column: ref.columnName
+					column: dbColumnName
 				},
 				to: {
 					table: resolved.table,
@@ -54,7 +62,7 @@ var SchemaRegistry = class {
 				},
 				to: {
 					table: schema.__name,
-					column: ref.columnName
+					column: dbColumnName
 				},
 				relationName: reverseRelationName
 			});
@@ -84,7 +92,7 @@ var SchemaRegistry = class {
 		return this.relations.get(tableName) ?? [];
 	}
 	/**
-	* Get the primary key column name for a table
+	* 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
 	*/
@@ -94,6 +102,22 @@ var SchemaRegistry = class {
 		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
 export { SchemaRegistry };

package/dist/schema/registry.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"registry.mjs","names":[],"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,IAAI,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,IAAI,YACR,mCAAmC,OAAO,OAAO,GAAG,IAAI,aACzD;AAGH,OAAI,CAAC,KAAK,OAAO,IAAI,SAAS,MAAM,CAClC,OAAM,IAAI,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"}
+{"version":3,"file":"registry.mjs","names":[],"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/table.cjs

@@ -8,9 +8,11 @@
 function table(name, columns) {
 	const columnsArray = [];
 	const deferredRefs = [];
+	const columnMap = {};
 	for (const [key, builder] of Object.entries(columns)) {
 		const meta = builder.__build(key);
 		columnsArray.push(meta);
+		columnMap[key] = meta.name;
 		const ref = builder.__getDeferredRef();
 		if (ref) deferredRefs.push({
 			columnName: key,
@@ -26,6 +28,7 @@ function table(name, columns) {
 		__table: true,
 		__name: name,
 		__columns: columnsArray,
+		__columnMap: columnMap,
 		__deferredRefs: deferredRefs,
 		...columns
 	};

package/dist/schema/table.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"table.cjs","names":[],"sources":["../../src/schema/table.ts"],"sourcesContent":["import type { ColumnMetadata, DeferredRefMeta, TableDefinition } from \"../types\";\nimport type { ColumnBuilder } from \"./column\";\n\ntype BindColumn<C, TableName extends string, ColName extends string> =\n  C extends ColumnBuilder<infer T, any, any, infer Ref>\n    ? ColumnBuilder<\n        T,\n        TableName,\n        ColName,\n        Ref extends DeferredRefMeta<any, infer ToTable, infer ToColumn, infer RelName>\n          ? DeferredRefMeta<ColName, ToTable, ToColumn, RelName>\n          : never\n      >\n    : never;\n\ntype BoundColumns<C extends Record<string, ColumnBuilder<any, any, any, any>>, N extends string> = {\n  [K in keyof C]: BindColumn<C[K], N, Extract<K, string>>;\n};\n\ntype ExtractDeferredRefs<C extends Record<string, ColumnBuilder<any, any, any, any>>> = {\n  [K in keyof C]: C[K] extends ColumnBuilder<any, any, any, infer Ref> ? Ref : never;\n}[keyof C];\n\n/**\n * Define a database table with its columns\n * @param {string} name - The table name\n * @param {Record<string, ColumnBuilder<any>>} columns - Column definitions\n * @returns {TableDefinition<T, C>} The table definition object with column accessors\n */\nexport function table<\n  N extends string,\n  C extends Record<string, ColumnBuilder<any, any, any, any>>,\n>(\n  name: N,\n  columns: C,\n): TableDefinition<\n  { [K in keyof C]: C[K][\"__type\"] },\n  BoundColumns<C, N>,\n  N,\n  ExtractDeferredRefs<BoundColumns<C, N>>\n> {\n  const columnsArray: ColumnMetadata[] = [];\n  const deferredRefs: TableDefinition[\"__deferredRefs\"] = [];\n\n  for (const [key, builder] of Object.entries(columns)) {\n    const meta = builder.__build(key);\n    columnsArray.push(meta);\n\n    const ref = builder.__getDeferredRef();\n    if (ref) {\n      deferredRefs.push({\n        columnName: key,\n        resolve: ref.resolve,\n        onDelete: ref.onDelete,\n        onUpdate: ref.onUpdate,\n        relationName: ref.relationName,\n      });\n    }\n\n    (builder as any).__tableName = name;\n    (builder as any).__columnName = key;\n  }\n\n  const def = {\n    __table: true,\n    __name: name,\n    __columns: columnsArray,\n    __deferredRefs: deferredRefs,\n    ...columns,\n  };\n\n  return def as any;\n}\n"],"mappings":";;;;;;;AA6BA,SAAgB,MAId,MACA,SAMA;CACA,MAAM,eAAiC,EAAE;CACzC,MAAM,eAAkD,EAAE;AAE1D,MAAK,MAAM,CAAC,KAAK,YAAY,OAAO,QAAQ,QAAQ,EAAE;EACpD,MAAM,OAAO,QAAQ,QAAQ,IAAI;AACjC,eAAa,KAAK,KAAK;EAEvB,MAAM,MAAM,QAAQ,kBAAkB;AACtC,MAAI,IACF,cAAa,KAAK;GAChB,YAAY;GACZ,SAAS,IAAI;GACb,UAAU,IAAI;GACd,UAAU,IAAI;GACd,cAAc,IAAI;GACnB,CAAC;AAGH,UAAgB,cAAc;AAC9B,UAAgB,eAAe;;AAWlC,QARY;EACV,SAAS;EACT,QAAQ;EACR,WAAW;EACX,gBAAgB;EAChB,GAAG;EACJ"}
+{"version":3,"file":"table.cjs","names":[],"sources":["../../src/schema/table.ts"],"sourcesContent":["import type { ColumnMetadata, DeferredRefMeta, TableDefinition } from \"../types\";\nimport type { ColumnBuilder } from \"./column\";\n\ntype BindColumn<C, TableName extends string, ColName extends string> =\n  C extends ColumnBuilder<infer T, any, any, infer Ref>\n    ? ColumnBuilder<\n        T,\n        TableName,\n        ColName,\n        Ref extends DeferredRefMeta<any, infer ToTable, infer ToColumn, infer RelName>\n          ? DeferredRefMeta<ColName, ToTable, ToColumn, RelName>\n          : never\n      >\n    : never;\n\ntype BoundColumns<C extends Record<string, ColumnBuilder<any, any, any, any>>, N extends string> = {\n  [K in keyof C]: BindColumn<C[K], N, Extract<K, string>>;\n};\n\ntype ExtractDeferredRefs<C extends Record<string, ColumnBuilder<any, any, any, any>>> = {\n  [K in keyof C]: C[K] extends ColumnBuilder<any, any, any, infer Ref> ? Ref : never;\n}[keyof C];\n\n/**\n * Define a database table with its columns\n * @param {string} name - The table name\n * @param {Record<string, ColumnBuilder<any>>} columns - Column definitions\n * @returns {TableDefinition<T, C>} The table definition object with column accessors\n */\nexport function table<\n  N extends string,\n  C extends Record<string, ColumnBuilder<any, any, any, any>>,\n>(\n  name: N,\n  columns: C,\n): TableDefinition<\n  { [K in keyof C]: C[K][\"__type\"] },\n  BoundColumns<C, N>,\n  N,\n  ExtractDeferredRefs<BoundColumns<C, N>>\n> {\n  const columnsArray: ColumnMetadata[] = [];\n  const deferredRefs: TableDefinition[\"__deferredRefs\"] = [];\n  const columnMap: Record<string, string> = {};\n\n  for (const [key, builder] of Object.entries(columns)) {\n    const meta = builder.__build(key);\n    columnsArray.push(meta);\n    columnMap[key] = meta.name;\n\n    const ref = builder.__getDeferredRef();\n    if (ref) {\n      deferredRefs.push({\n        columnName: key,\n        resolve: ref.resolve,\n        onDelete: ref.onDelete,\n        onUpdate: ref.onUpdate,\n        relationName: ref.relationName,\n      });\n    }\n\n    (builder as any).__tableName = name;\n    (builder as any).__columnName = key;\n  }\n\n  const def = {\n    __table: true,\n    __name: name,\n    __columns: columnsArray,\n    __columnMap: columnMap,\n    __deferredRefs: deferredRefs,\n    ...columns,\n  };\n\n  return def as any;\n}\n"],"mappings":";;;;;;;AA6BA,SAAgB,MAId,MACA,SAMA;CACA,MAAM,eAAiC,EAAE;CACzC,MAAM,eAAkD,EAAE;CAC1D,MAAM,YAAoC,EAAE;AAE5C,MAAK,MAAM,CAAC,KAAK,YAAY,OAAO,QAAQ,QAAQ,EAAE;EACpD,MAAM,OAAO,QAAQ,QAAQ,IAAI;AACjC,eAAa,KAAK,KAAK;AACvB,YAAU,OAAO,KAAK;EAEtB,MAAM,MAAM,QAAQ,kBAAkB;AACtC,MAAI,IACF,cAAa,KAAK;GAChB,YAAY;GACZ,SAAS,IAAI;GACb,UAAU,IAAI;GACd,UAAU,IAAI;GACd,cAAc,IAAI;GACnB,CAAC;AAGH,UAAgB,cAAc;AAC9B,UAAgB,eAAe;;AAYlC,QATY;EACV,SAAS;EACT,QAAQ;EACR,WAAW;EACX,aAAa;EACb,gBAAgB;EAChB,GAAG;EACJ"}

package/dist/schema/table.mjs

@@ -8,9 +8,11 @@
 function table(name, columns) {
 	const columnsArray = [];
 	const deferredRefs = [];
+	const columnMap = {};
 	for (const [key, builder] of Object.entries(columns)) {
 		const meta = builder.__build(key);
 		columnsArray.push(meta);
+		columnMap[key] = meta.name;
 		const ref = builder.__getDeferredRef();
 		if (ref) deferredRefs.push({
 			columnName: key,
@@ -26,6 +28,7 @@ function table(name, columns) {
 		__table: true,
 		__name: name,
 		__columns: columnsArray,
+		__columnMap: columnMap,
 		__deferredRefs: deferredRefs,
 		...columns
 	};

package/dist/schema/table.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"table.mjs","names":[],"sources":["../../src/schema/table.ts"],"sourcesContent":["import type { ColumnMetadata, DeferredRefMeta, TableDefinition } from \"../types\";\nimport type { ColumnBuilder } from \"./column\";\n\ntype BindColumn<C, TableName extends string, ColName extends string> =\n  C extends ColumnBuilder<infer T, any, any, infer Ref>\n    ? ColumnBuilder<\n        T,\n        TableName,\n        ColName,\n        Ref extends DeferredRefMeta<any, infer ToTable, infer ToColumn, infer RelName>\n          ? DeferredRefMeta<ColName, ToTable, ToColumn, RelName>\n          : never\n      >\n    : never;\n\ntype BoundColumns<C extends Record<string, ColumnBuilder<any, any, any, any>>, N extends string> = {\n  [K in keyof C]: BindColumn<C[K], N, Extract<K, string>>;\n};\n\ntype ExtractDeferredRefs<C extends Record<string, ColumnBuilder<any, any, any, any>>> = {\n  [K in keyof C]: C[K] extends ColumnBuilder<any, any, any, infer Ref> ? Ref : never;\n}[keyof C];\n\n/**\n * Define a database table with its columns\n * @param {string} name - The table name\n * @param {Record<string, ColumnBuilder<any>>} columns - Column definitions\n * @returns {TableDefinition<T, C>} The table definition object with column accessors\n */\nexport function table<\n  N extends string,\n  C extends Record<string, ColumnBuilder<any, any, any, any>>,\n>(\n  name: N,\n  columns: C,\n): TableDefinition<\n  { [K in keyof C]: C[K][\"__type\"] },\n  BoundColumns<C, N>,\n  N,\n  ExtractDeferredRefs<BoundColumns<C, N>>\n> {\n  const columnsArray: ColumnMetadata[] = [];\n  const deferredRefs: TableDefinition[\"__deferredRefs\"] = [];\n\n  for (const [key, builder] of Object.entries(columns)) {\n    const meta = builder.__build(key);\n    columnsArray.push(meta);\n\n    const ref = builder.__getDeferredRef();\n    if (ref) {\n      deferredRefs.push({\n        columnName: key,\n        resolve: ref.resolve,\n        onDelete: ref.onDelete,\n        onUpdate: ref.onUpdate,\n        relationName: ref.relationName,\n      });\n    }\n\n    (builder as any).__tableName = name;\n    (builder as any).__columnName = key;\n  }\n\n  const def = {\n    __table: true,\n    __name: name,\n    __columns: columnsArray,\n    __deferredRefs: deferredRefs,\n    ...columns,\n  };\n\n  return def as any;\n}\n"],"mappings":";;;;;;;AA6BA,SAAgB,MAId,MACA,SAMA;CACA,MAAM,eAAiC,EAAE;CACzC,MAAM,eAAkD,EAAE;AAE1D,MAAK,MAAM,CAAC,KAAK,YAAY,OAAO,QAAQ,QAAQ,EAAE;EACpD,MAAM,OAAO,QAAQ,QAAQ,IAAI;AACjC,eAAa,KAAK,KAAK;EAEvB,MAAM,MAAM,QAAQ,kBAAkB;AACtC,MAAI,IACF,cAAa,KAAK;GAChB,YAAY;GACZ,SAAS,IAAI;GACb,UAAU,IAAI;GACd,UAAU,IAAI;GACd,cAAc,IAAI;GACnB,CAAC;AAGH,UAAgB,cAAc;AAC9B,UAAgB,eAAe;;AAWlC,QARY;EACV,SAAS;EACT,QAAQ;EACR,WAAW;EACX,gBAAgB;EAChB,GAAG;EACJ"}
+{"version":3,"file":"table.mjs","names":[],"sources":["../../src/schema/table.ts"],"sourcesContent":["import type { ColumnMetadata, DeferredRefMeta, TableDefinition } from \"../types\";\nimport type { ColumnBuilder } from \"./column\";\n\ntype BindColumn<C, TableName extends string, ColName extends string> =\n  C extends ColumnBuilder<infer T, any, any, infer Ref>\n    ? ColumnBuilder<\n        T,\n        TableName,\n        ColName,\n        Ref extends DeferredRefMeta<any, infer ToTable, infer ToColumn, infer RelName>\n          ? DeferredRefMeta<ColName, ToTable, ToColumn, RelName>\n          : never\n      >\n    : never;\n\ntype BoundColumns<C extends Record<string, ColumnBuilder<any, any, any, any>>, N extends string> = {\n  [K in keyof C]: BindColumn<C[K], N, Extract<K, string>>;\n};\n\ntype ExtractDeferredRefs<C extends Record<string, ColumnBuilder<any, any, any, any>>> = {\n  [K in keyof C]: C[K] extends ColumnBuilder<any, any, any, infer Ref> ? Ref : never;\n}[keyof C];\n\n/**\n * Define a database table with its columns\n * @param {string} name - The table name\n * @param {Record<string, ColumnBuilder<any>>} columns - Column definitions\n * @returns {TableDefinition<T, C>} The table definition object with column accessors\n */\nexport function table<\n  N extends string,\n  C extends Record<string, ColumnBuilder<any, any, any, any>>,\n>(\n  name: N,\n  columns: C,\n): TableDefinition<\n  { [K in keyof C]: C[K][\"__type\"] },\n  BoundColumns<C, N>,\n  N,\n  ExtractDeferredRefs<BoundColumns<C, N>>\n> {\n  const columnsArray: ColumnMetadata[] = [];\n  const deferredRefs: TableDefinition[\"__deferredRefs\"] = [];\n  const columnMap: Record<string, string> = {};\n\n  for (const [key, builder] of Object.entries(columns)) {\n    const meta = builder.__build(key);\n    columnsArray.push(meta);\n    columnMap[key] = meta.name;\n\n    const ref = builder.__getDeferredRef();\n    if (ref) {\n      deferredRefs.push({\n        columnName: key,\n        resolve: ref.resolve,\n        onDelete: ref.onDelete,\n        onUpdate: ref.onUpdate,\n        relationName: ref.relationName,\n      });\n    }\n\n    (builder as any).__tableName = name;\n    (builder as any).__columnName = key;\n  }\n\n  const def = {\n    __table: true,\n    __name: name,\n    __columns: columnsArray,\n    __columnMap: columnMap,\n    __deferredRefs: deferredRefs,\n    ...columns,\n  };\n\n  return def as any;\n}\n"],"mappings":";;;;;;;AA6BA,SAAgB,MAId,MACA,SAMA;CACA,MAAM,eAAiC,EAAE;CACzC,MAAM,eAAkD,EAAE;CAC1D,MAAM,YAAoC,EAAE;AAE5C,MAAK,MAAM,CAAC,KAAK,YAAY,OAAO,QAAQ,QAAQ,EAAE;EACpD,MAAM,OAAO,QAAQ,QAAQ,IAAI;AACjC,eAAa,KAAK,KAAK;AACvB,YAAU,OAAO,KAAK;EAEtB,MAAM,MAAM,QAAQ,kBAAkB;AACtC,MAAI,IACF,cAAa,KAAK;GAChB,YAAY;GACZ,SAAS,IAAI;GACb,UAAU,IAAI;GACd,UAAU,IAAI;GACd,cAAc,IAAI;GACnB,CAAC;AAGH,UAAgB,cAAc;AAC9B,UAAgB,eAAe;;AAYlC,QATY;EACV,SAAS;EACT,QAAQ;EACR,WAAW;EACX,aAAa;EACb,gBAAgB;EAChB,GAAG;EACJ"}

package/dist/sync/synchronizer.cjs

@@ -26,8 +26,8 @@ var Synchronizer = class {
 		}
 		const existingCols = await this.driver.getTableColumns(meta.name);
 		const existingNames = new Set(existingCols.map((c) => c.name));
-		const schemaNames = new Set(meta.columns.keys());
-		for (const [colName, colMeta] of meta.columns) if (!existingNames.has(colName)) await this.driver.addColumn(meta.name, colMeta);
+		const schemaNames = new Set(meta.columns.map((c) => c.name));
+		for (const colMeta of meta.columns) if (!existingNames.has(colMeta.name)) await this.driver.addColumn(meta.name, colMeta);
 		if (force) {
 			for (const existingName of existingNames) if (!schemaNames.has(existingName)) try {
 				await this.driver.dropColumn(meta.name, existingName);

package/dist/sync/synchronizer.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"synchronizer.cjs","names":["SyncError"],"sources":["../../src/sync/synchronizer.ts"],"sourcesContent":["import { SyncError } from \"../errors\";\nimport type { SchemaRegistry } from \"../schema\";\nimport type { DatabaseDriver, TableMetadata } from \"../types\";\n\n/**\n * Schema synchronizer that compares the database state with the schema registry\n * and applies non-destructive changes\n */\nexport class Synchronizer {\n  private driver: DatabaseDriver;\n  private registry: SchemaRegistry;\n\n  constructor(driver: DatabaseDriver, registry: SchemaRegistry) {\n    this.driver = driver;\n    this.registry = registry;\n  }\n\n  /**\n   * Synchronize database schema with registry definitions\n   * @param {boolean} [force=false] - Allow destructive operations (drop columns)\n   */\n  async sync(force = false): Promise<void> {\n    const tables = this.registry.getAllTables();\n\n    for (const [, tableMeta] of tables) {\n      await this.syncTable(tableMeta, force);\n    }\n  }\n\n  private async syncTable(meta: TableMetadata, force: boolean): Promise<void> {\n    const exists = await this.driver.tableExists(meta.name);\n    if (!exists) {\n      await this.driver.createTable(meta);\n      return;\n    }\n\n    const existingCols = await this.driver.getTableColumns(meta.name);\n    const existingNames = new Set(existingCols.map((c) => c.name));\n    const schemaNames = new Set(meta.columns.keys());\n\n    for (const [colName, colMeta] of meta.columns) {\n      if (!existingNames.has(colName)) {\n        await this.driver.addColumn(meta.name, colMeta);\n      }\n    }\n\n    if (force) {\n      for (const existingName of existingNames) {\n        if (!schemaNames.has(existingName)) {\n          try {\n            await this.driver.dropColumn(meta.name, existingName);\n          } catch (err: any) {\n            throw new SyncError(`Failed to drop column ${existingName}: ${err.message}`);\n          }\n        }\n      }\n    }\n  }\n}\n"],"mappings":";;;;;;AAQA,IAAa,eAAb,MAA0B;CACxB;CACA;CAEA,YAAY,QAAwB,UAA0B;AAC5D,OAAK,SAAS;AACd,OAAK,WAAW;;;;;;CAOlB,MAAM,KAAK,QAAQ,OAAsB;EACvC,MAAM,SAAS,KAAK,SAAS,cAAc;AAE3C,OAAK,MAAM,GAAG,cAAc,OAC1B,OAAM,KAAK,UAAU,WAAW,MAAM;;CAI1C,MAAc,UAAU,MAAqB,OAA+B;AAE1E,MAAI,CADW,MAAM,KAAK,OAAO,YAAY,KAAK,KAAK,EAC1C;AACX,SAAM,KAAK,OAAO,YAAY,KAAK;AACnC;;EAGF,MAAM,eAAe,MAAM,KAAK,OAAO,gBAAgB,KAAK,KAAK;EACjE,MAAM,gBAAgB,IAAI,IAAI,aAAa,KAAK,MAAM,EAAE,KAAK,CAAC;EAC9D,MAAM,cAAc,IAAI,IAAI,KAAK,QAAQ,MAAM,CAAC;AAEhD,OAAK,MAAM,CAAC,SAAS,YAAY,KAAK,QACpC,KAAI,CAAC,cAAc,IAAI,QAAQ,CAC7B,OAAM,KAAK,OAAO,UAAU,KAAK,MAAM,QAAQ;AAInD,MAAI;QACG,MAAM,gBAAgB,cACzB,KAAI,CAAC,YAAY,IAAI,aAAa,CAChC,KAAI;AACF,UAAM,KAAK,OAAO,WAAW,KAAK,MAAM,aAAa;YAC9C,KAAU;AACjB,UAAM,IAAIA,eAAAA,UAAU,yBAAyB,aAAa,IAAI,IAAI,UAAU"}
+{"version":3,"file":"synchronizer.cjs","names":["SyncError"],"sources":["../../src/sync/synchronizer.ts"],"sourcesContent":["import { SyncError } from \"../errors\";\nimport type { SchemaRegistry } from \"../schema\";\nimport type { DatabaseDriver, TableMetadata } from \"../types\";\n\n/**\n * Schema synchronizer that compares the database state with the schema registry\n * and applies non-destructive changes\n */\nexport class Synchronizer {\n  private driver: DatabaseDriver;\n  private registry: SchemaRegistry;\n\n  constructor(driver: DatabaseDriver, registry: SchemaRegistry) {\n    this.driver = driver;\n    this.registry = registry;\n  }\n\n  /**\n   * Synchronize database schema with registry definitions\n   * @param {boolean} [force=false] - Allow destructive operations (drop columns)\n   */\n  async sync(force = false): Promise<void> {\n    const tables = this.registry.getAllTables();\n\n    for (const [, tableMeta] of tables) {\n      await this.syncTable(tableMeta, force);\n    }\n  }\n\n  private async syncTable(meta: TableMetadata, force: boolean): Promise<void> {\n    const exists = await this.driver.tableExists(meta.name);\n    if (!exists) {\n      await this.driver.createTable(meta);\n      return;\n    }\n\n    const existingCols = await this.driver.getTableColumns(meta.name);\n    const existingNames = new Set(existingCols.map((c) => c.name));\n    const schemaNames = new Set(meta.columns.map((c) => c.name));\n\n    for (const colMeta of meta.columns) {\n      if (!existingNames.has(colMeta.name)) {\n        await this.driver.addColumn(meta.name, colMeta);\n      }\n    }\n\n    if (force) {\n      for (const existingName of existingNames) {\n        if (!schemaNames.has(existingName)) {\n          try {\n            await this.driver.dropColumn(meta.name, existingName);\n          } catch (err: any) {\n            throw new SyncError(`Failed to drop column ${existingName}: ${err.message}`);\n          }\n        }\n      }\n    }\n  }\n}\n"],"mappings":";;;;;;AAQA,IAAa,eAAb,MAA0B;CACxB;CACA;CAEA,YAAY,QAAwB,UAA0B;AAC5D,OAAK,SAAS;AACd,OAAK,WAAW;;;;;;CAOlB,MAAM,KAAK,QAAQ,OAAsB;EACvC,MAAM,SAAS,KAAK,SAAS,cAAc;AAE3C,OAAK,MAAM,GAAG,cAAc,OAC1B,OAAM,KAAK,UAAU,WAAW,MAAM;;CAI1C,MAAc,UAAU,MAAqB,OAA+B;AAE1E,MAAI,CADW,MAAM,KAAK,OAAO,YAAY,KAAK,KAAK,EAC1C;AACX,SAAM,KAAK,OAAO,YAAY,KAAK;AACnC;;EAGF,MAAM,eAAe,MAAM,KAAK,OAAO,gBAAgB,KAAK,KAAK;EACjE,MAAM,gBAAgB,IAAI,IAAI,aAAa,KAAK,MAAM,EAAE,KAAK,CAAC;EAC9D,MAAM,cAAc,IAAI,IAAI,KAAK,QAAQ,KAAK,MAAM,EAAE,KAAK,CAAC;AAE5D,OAAK,MAAM,WAAW,KAAK,QACzB,KAAI,CAAC,cAAc,IAAI,QAAQ,KAAK,CAClC,OAAM,KAAK,OAAO,UAAU,KAAK,MAAM,QAAQ;AAInD,MAAI;QACG,MAAM,gBAAgB,cACzB,KAAI,CAAC,YAAY,IAAI,aAAa,CAChC,KAAI;AACF,UAAM,KAAK,OAAO,WAAW,KAAK,MAAM,aAAa;YAC9C,KAAU;AACjB,UAAM,IAAIA,eAAAA,UAAU,yBAAyB,aAAa,IAAI,IAAI,UAAU"}

package/dist/sync/synchronizer.mjs

@@ -26,8 +26,8 @@ var Synchronizer = class {
 		}
 		const existingCols = await this.driver.getTableColumns(meta.name);
 		const existingNames = new Set(existingCols.map((c) => c.name));
-		const schemaNames = new Set(meta.columns.keys());
-		for (const [colName, colMeta] of meta.columns) if (!existingNames.has(colName)) await this.driver.addColumn(meta.name, colMeta);
+		const schemaNames = new Set(meta.columns.map((c) => c.name));
+		for (const colMeta of meta.columns) if (!existingNames.has(colMeta.name)) await this.driver.addColumn(meta.name, colMeta);
 		if (force) {
 			for (const existingName of existingNames) if (!schemaNames.has(existingName)) try {
 				await this.driver.dropColumn(meta.name, existingName);

package/dist/sync/synchronizer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"synchronizer.mjs","names":[],"sources":["../../src/sync/synchronizer.ts"],"sourcesContent":["import { SyncError } from \"../errors\";\nimport type { SchemaRegistry } from \"../schema\";\nimport type { DatabaseDriver, TableMetadata } from \"../types\";\n\n/**\n * Schema synchronizer that compares the database state with the schema registry\n * and applies non-destructive changes\n */\nexport class Synchronizer {\n  private driver: DatabaseDriver;\n  private registry: SchemaRegistry;\n\n  constructor(driver: DatabaseDriver, registry: SchemaRegistry) {\n    this.driver = driver;\n    this.registry = registry;\n  }\n\n  /**\n   * Synchronize database schema with registry definitions\n   * @param {boolean} [force=false] - Allow destructive operations (drop columns)\n   */\n  async sync(force = false): Promise<void> {\n    const tables = this.registry.getAllTables();\n\n    for (const [, tableMeta] of tables) {\n      await this.syncTable(tableMeta, force);\n    }\n  }\n\n  private async syncTable(meta: TableMetadata, force: boolean): Promise<void> {\n    const exists = await this.driver.tableExists(meta.name);\n    if (!exists) {\n      await this.driver.createTable(meta);\n      return;\n    }\n\n    const existingCols = await this.driver.getTableColumns(meta.name);\n    const existingNames = new Set(existingCols.map((c) => c.name));\n    const schemaNames = new Set(meta.columns.keys());\n\n    for (const [colName, colMeta] of meta.columns) {\n      if (!existingNames.has(colName)) {\n        await this.driver.addColumn(meta.name, colMeta);\n      }\n    }\n\n    if (force) {\n      for (const existingName of existingNames) {\n        if (!schemaNames.has(existingName)) {\n          try {\n            await this.driver.dropColumn(meta.name, existingName);\n          } catch (err: any) {\n            throw new SyncError(`Failed to drop column ${existingName}: ${err.message}`);\n          }\n        }\n      }\n    }\n  }\n}\n"],"mappings":";;;;;;AAQA,IAAa,eAAb,MAA0B;CACxB;CACA;CAEA,YAAY,QAAwB,UAA0B;AAC5D,OAAK,SAAS;AACd,OAAK,WAAW;;;;;;CAOlB,MAAM,KAAK,QAAQ,OAAsB;EACvC,MAAM,SAAS,KAAK,SAAS,cAAc;AAE3C,OAAK,MAAM,GAAG,cAAc,OAC1B,OAAM,KAAK,UAAU,WAAW,MAAM;;CAI1C,MAAc,UAAU,MAAqB,OAA+B;AAE1E,MAAI,CADW,MAAM,KAAK,OAAO,YAAY,KAAK,KAAK,EAC1C;AACX,SAAM,KAAK,OAAO,YAAY,KAAK;AACnC;;EAGF,MAAM,eAAe,MAAM,KAAK,OAAO,gBAAgB,KAAK,KAAK;EACjE,MAAM,gBAAgB,IAAI,IAAI,aAAa,KAAK,MAAM,EAAE,KAAK,CAAC;EAC9D,MAAM,cAAc,IAAI,IAAI,KAAK,QAAQ,MAAM,CAAC;AAEhD,OAAK,MAAM,CAAC,SAAS,YAAY,KAAK,QACpC,KAAI,CAAC,cAAc,IAAI,QAAQ,CAC7B,OAAM,KAAK,OAAO,UAAU,KAAK,MAAM,QAAQ;AAInD,MAAI;QACG,MAAM,gBAAgB,cACzB,KAAI,CAAC,YAAY,IAAI,aAAa,CAChC,KAAI;AACF,UAAM,KAAK,OAAO,WAAW,KAAK,MAAM,aAAa;YAC9C,KAAU;AACjB,UAAM,IAAI,UAAU,yBAAyB,aAAa,IAAI,IAAI,UAAU"}
+{"version":3,"file":"synchronizer.mjs","names":[],"sources":["../../src/sync/synchronizer.ts"],"sourcesContent":["import { SyncError } from \"../errors\";\nimport type { SchemaRegistry } from \"../schema\";\nimport type { DatabaseDriver, TableMetadata } from \"../types\";\n\n/**\n * Schema synchronizer that compares the database state with the schema registry\n * and applies non-destructive changes\n */\nexport class Synchronizer {\n  private driver: DatabaseDriver;\n  private registry: SchemaRegistry;\n\n  constructor(driver: DatabaseDriver, registry: SchemaRegistry) {\n    this.driver = driver;\n    this.registry = registry;\n  }\n\n  /**\n   * Synchronize database schema with registry definitions\n   * @param {boolean} [force=false] - Allow destructive operations (drop columns)\n   */\n  async sync(force = false): Promise<void> {\n    const tables = this.registry.getAllTables();\n\n    for (const [, tableMeta] of tables) {\n      await this.syncTable(tableMeta, force);\n    }\n  }\n\n  private async syncTable(meta: TableMetadata, force: boolean): Promise<void> {\n    const exists = await this.driver.tableExists(meta.name);\n    if (!exists) {\n      await this.driver.createTable(meta);\n      return;\n    }\n\n    const existingCols = await this.driver.getTableColumns(meta.name);\n    const existingNames = new Set(existingCols.map((c) => c.name));\n    const schemaNames = new Set(meta.columns.map((c) => c.name));\n\n    for (const colMeta of meta.columns) {\n      if (!existingNames.has(colMeta.name)) {\n        await this.driver.addColumn(meta.name, colMeta);\n      }\n    }\n\n    if (force) {\n      for (const existingName of existingNames) {\n        if (!schemaNames.has(existingName)) {\n          try {\n            await this.driver.dropColumn(meta.name, existingName);\n          } catch (err: any) {\n            throw new SyncError(`Failed to drop column ${existingName}: ${err.message}`);\n          }\n        }\n      }\n    }\n  }\n}\n"],"mappings":";;;;;;AAQA,IAAa,eAAb,MAA0B;CACxB;CACA;CAEA,YAAY,QAAwB,UAA0B;AAC5D,OAAK,SAAS;AACd,OAAK,WAAW;;;;;;CAOlB,MAAM,KAAK,QAAQ,OAAsB;EACvC,MAAM,SAAS,KAAK,SAAS,cAAc;AAE3C,OAAK,MAAM,GAAG,cAAc,OAC1B,OAAM,KAAK,UAAU,WAAW,MAAM;;CAI1C,MAAc,UAAU,MAAqB,OAA+B;AAE1E,MAAI,CADW,MAAM,KAAK,OAAO,YAAY,KAAK,KAAK,EAC1C;AACX,SAAM,KAAK,OAAO,YAAY,KAAK;AACnC;;EAGF,MAAM,eAAe,MAAM,KAAK,OAAO,gBAAgB,KAAK,KAAK;EACjE,MAAM,gBAAgB,IAAI,IAAI,aAAa,KAAK,MAAM,EAAE,KAAK,CAAC;EAC9D,MAAM,cAAc,IAAI,IAAI,KAAK,QAAQ,KAAK,MAAM,EAAE,KAAK,CAAC;AAE5D,OAAK,MAAM,WAAW,KAAK,QACzB,KAAI,CAAC,cAAc,IAAI,QAAQ,KAAK,CAClC,OAAM,KAAK,OAAO,UAAU,KAAK,MAAM,QAAQ;AAInD,MAAI;QACG,MAAM,gBAAgB,cACzB,KAAI,CAAC,YAAY,IAAI,aAAa,CAChC,KAAI;AACF,UAAM,KAAK,OAAO,WAAW,KAAK,MAAM,aAAa;YAC9C,KAAU;AACjB,UAAM,IAAI,UAAU,yBAAyB,aAAa,IAAI,IAAI,UAAU"}

package/dist/types.d.cts

@@ -24,6 +24,7 @@ interface ColumnMetadata {
   length?: number;
   precision?: number;
   scale?: number;
+  columnAlias?: string;
   references?: {
     table: string;
     column: string;
@@ -51,6 +52,7 @@ type TableDefinition<T extends Record<string, any> = Record<string, any>, C exte
   __row: T;
   __refs: Refs;
   __columns: ColumnMetadata[];
+  __columnMap: Record<string, string>;
   __deferredRefs: Array<{
     columnName: string;
     resolve: () => {
@@ -88,8 +90,8 @@ type WhereClause<T = Record<string, any>> = { [K in keyof T]?: T[K] | WhereCondi
 };
 interface QueryOptions<T = Record<string, any>, Rel extends Record<string, any> = {}> {
   where?: WhereClause<T>;
-  select?: (keyof T)[];
-  orderBy?: Partial<Record<keyof T, "asc" | "desc">>;
+  select?: Extract<keyof T, string>[];
+  orderBy?: Partial<Record<Extract<keyof T, string>, "asc" | "desc">>;
   take?: number;
   skip?: number;
   with?: { [K in keyof Rel]?: boolean | QueryOptions<Rel[K] extends {

package/dist/types.d.mts

@@ -24,6 +24,7 @@ interface ColumnMetadata {
   length?: number;
   precision?: number;
   scale?: number;
+  columnAlias?: string;
   references?: {
     table: string;
     column: string;
@@ -51,6 +52,7 @@ type TableDefinition<T extends Record<string, any> = Record<string, any>, C exte
   __row: T;
   __refs: Refs;
   __columns: ColumnMetadata[];
+  __columnMap: Record<string, string>;
   __deferredRefs: Array<{
     columnName: string;
     resolve: () => {
@@ -88,8 +90,8 @@ type WhereClause<T = Record<string, any>> = { [K in keyof T]?: T[K] | WhereCondi
 };
 interface QueryOptions<T = Record<string, any>, Rel extends Record<string, any> = {}> {
   where?: WhereClause<T>;
-  select?: (keyof T)[];
-  orderBy?: Partial<Record<keyof T, "asc" | "desc">>;
+  select?: Extract<keyof T, string>[];
+  orderBy?: Partial<Record<Extract<keyof T, string>, "asc" | "desc">>;
   take?: number;
   skip?: number;
   with?: { [K in keyof Rel]?: boolean | QueryOptions<Rel[K] extends {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hedystia/db",
-  "version": "2.0.1",
+  "version": "2.0.2",
   "description": "Next-gen TypeScript ORM for building type-safe database layers at lightspeed",
   "homepage": "https://docs.hedystia.com",
   "devDependencies": {

package/readme.md

@@ -47,23 +47,25 @@ bun add mysql
 ### Define your schema
 
 ```ts
-import { table, d } from "@hedystia/db";
+import { table, integer, varchar, text } from "@hedystia/db";
 
 export const users = table("users", {
-  id: d.integer().primaryKey().autoIncrement(),
-  name: d.varchar(255).notNull(),
-  email: d.varchar(255).unique(),
-  age: d.integer().default(0),
+  id: integer().primaryKey().autoIncrement(),
+  name: varchar(255).notNull(),
+  email: varchar(255).unique(),
+  age: integer().default(0),
 });
 
 export const posts = table("posts", {
-  id: d.integer().primaryKey().autoIncrement(),
-  userId: d.integer().references(() => users.id, { onDelete: "CASCADE" }),
-  title: d.varchar(255).notNull(),
-  content: d.text(),
+  id: integer().primaryKey().autoIncrement(),
+  userId: integer().references(() => users.id, { onDelete: "CASCADE" }),
+  title: varchar(255).notNull(),
+  content: text(),
 });
 ```
 
+> **Note:** The `d.xxx()` prefix style (e.g., `d.integer()`) is still supported for backward compatibility.
+
 ### Create the database
 
 ```ts