@housekit/orm 0.1.17 → 0.1.18

package/README.md

@@ -178,11 +178,7 @@ await repository.insertEvents([
 ]);
 ```
 
-### How It Works
-
-When you write `table.$inferInsert`, it includes a callable signature. TypeScript interprets `table[]` as invoking that callable and applying the array type, giving you `TableInsert<T>[]` automatically.
-
-### Alternative Approaches
+### Type Helpers
 
 ```typescript
 import { TableInsertArray } from '@housekit/orm';
@@ -198,7 +194,7 @@ async insertEvents(events: typeof salesEvents.$inferInsert[]) {
 }
 ```
 
-**Recommended**: Use `table[]` for the cleanest, most ergonomic DX.
+**Note**: Autocomplete shows clean data types by default without exposing internal types.
 
 ---
 

package/dist/builders/insert.d.ts

@@ -1,5 +1,5 @@
 import type { ClickHouseClient } from '@clickhouse/client';
-import { type TableDefinition, type TableInsert, type TableColumns } from '../core';
+import { type TableDefinition, type TableColumns, type CleanInsert } from '../core';
 import { type BatchTransformOptions } from '../utils/batch-transform';
 import { Readable } from 'stream';
 import { type BatchConfig } from '../utils/background-batcher';
@@ -32,7 +32,9 @@ export declare class ClickHouseInsertBuilder<TTable extends TableDefinition<Tabl
     private _batchConfig;
     private _forceJson;
     constructor(client: ClickHouseClient, table: TTable);
-    values(value: TableInsert<TTable['$columns']> | Array<TableInsert<TTable['$columns']>> | Iterable<TableInsert<TTable['$columns']>> | AsyncIterable<TableInsert<TTable['$columns']>> | Readable): this;
+    values(value: CleanInsert<TTable> | Array<CleanInsert<TTable>> | Iterable<CleanInsert<TTable>> | AsyncIterable<CleanInsert<TTable>> | Readable): this;
+    /** @template [T = CleanInsert<TTable>] */
+    insert(data: CleanInsert<TTable> | CleanInsert<TTable>[]): Promise<this>;
     /**
      * Force synchronous insert (disables async_insert).
      * Use when you need immediate durability guarantee.
@@ -73,7 +75,7 @@ export declare class ClickHouseInsertBuilder<TTable extends TableDefinition<Tabl
      * Note: This method is "fire-and-forget" and does not wait for
      * the database to acknowledge the insert.
      */
-    append(row: TableInsert<TTable['$columns']>): Promise<void>;
+    append(row: CleanInsert<TTable>): Promise<void>;
     /**
      * Force JSON format (useful for debugging or compatibility).
      *

package/dist/index.js

@@ -4394,6 +4394,9 @@ class ClickHouseInsertBuilder {
     this._values = value;
     return this;
   }
+  async insert(data) {
+    return this.values(data);
+  }
   syncInsert() {
     this._async = false;
     return this;

package/dist/table.d.ts

@@ -86,6 +86,24 @@ export type InferInsertModel<T extends {
     (): TableInsert<T['$columns']>[];
     (): TableInsert<T['$columns']>;
 };
+export type CleanInsert<T extends {
+    $inferInsert?: any;
+}> = T extends {
+    $inferInsert?: infer I;
+} ? I : never;
+export type CleanSelect<T extends {
+    $inferSelect?: any;
+}> = T extends {
+    $inferSelect?: infer S;
+} ? S : never;
+export type InferInsertValue<TCols extends TableColumns, K extends keyof TCols> = TCols[K] extends ClickHouseColumn<infer Type, infer NotNull, any> ? NotNull extends true ? Type : Type | undefined | null : never;
+export type TableInsertArray<T extends TableDefinition<TableColumns>> = T['$inferInsert'][];
+export type TableModel<T extends TableDefinition<TableColumns>> = PublicSelectModel<T>;
+export type InsertModel<T extends TableDefinition<TableColumns>> = PublicInsertModel<T>;
+type PublicSelectModel<T extends TableDefinition<TableColumns>> = {
+    [K in keyof T['$columns']]: GetColumnType<T['$columns'][K]>;
+};
+type PublicInsertModel<T extends TableDefinition<TableColumns>> = TableInsert<T['$columns']>;
 export type TableDefinition<TCols extends TableColumns, TOptions = TableOptions> = {
     $table: string;
     $columns: TCols;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@housekit/orm",
-    "version": "0.1.17",
+    "version": "0.1.18",
     "description": "Type-safe ClickHouse ORM with modern DX and ClickHouse-specific optimizations. Features Turbo Mode (RowBinary), full engine support, and advanced query capabilities.",
     "type": "module",
     "main": "./dist/index.js",