@housekit/orm 0.1.32 → 0.1.34

package/dist/builders/insert.d.ts

@@ -54,16 +54,15 @@ export declare class ClickHouseInsertBuilder<TTable extends TableRuntime<any, an
     noReturning(): ClickHouseInsertBuilder<TTable, void>;
     /**
      * Force synchronous insert (disables async_insert).
-     * Use when you need immediate durability guarantee.
-     *
-     * Note: By default, HouseKit uses async_insert for better performance.
-     * The data is still durable, but ClickHouse batches writes internally.
+     * This is already the default in HouseKit for best performance.
      */
     syncInsert(): this;
     /**
-     * Enables asynchronous inserts on the server.
+     * Enable asynchronous inserts on the server (not the default).
      * ClickHouse will batch multiple small inserts into a single disk operation.
-     * Ideal for high-frequency logs or events.
+     *
+     * Note: Sync insert is faster for most use cases. Use async only when
+     * you need server-side batching for very high-frequency writes.
      */
     asyncInsert(waitForCompletion?: boolean): this;
     /**
@@ -94,33 +93,29 @@ export declare class ClickHouseInsertBuilder<TTable extends TableRuntime<any, an
      */
     append(row: CleanInsert<TTable>): Promise<void>;
     /**
-     * Force JSON format (useful for debugging or compatibility).
-     *
-     * Note: HouseKit uses RowBinary by default for maximum performance.
-     * Only use this when you need human-readable output or debugging.
+     * Use JSON format explicitly (this is already the default).
      *
      * @example
      * ```typescript
      * await db.insert(events)
      *   .values(rows)
-     *   .useJsonFormat() // For debugging
+     *   .useJsonFormat()
      *   .execute();
      * ```
      */
     useJsonFormat(): this;
     /**
-     * Force JSONCompactEachRow format (smaller than JSON, but slower than binary).
+     * Use JSONCompactEachRow format (smaller payload than JSON).
      */
     useCompactFormat(): this;
     /**
-     * Force RowBinary format (this is already the default via 'auto').
-     * Explicit call for documentation purposes.
+     * Force RowBinary format.
+     * Uses direct HTTP request (bypasses official client).
      */
     useBinaryFormat(): this;
     /**
-     * Activates "Turbo Mode" (RowBinary).
-     * Sends data in native binary format, skipping JSON parsing on the server.
-     * Up to 5x faster than normal insertion.
+     * Alias for useBinaryFormat().
+     * @deprecated Binary format is not faster than JSON with the official client.
      */
     turbo(): this;
     execute(): Promise<TReturn>;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { type TableDefinition, type TableColumns } from './core';
-import { createClientFromConfigObject, type ClientConfigWithSchema, type HousekitClient as HousekitClientType, type HousekitClientConfig } from './client';
+import { type ClientConfigWithSchema, type HousekitClient as HousekitClientType, type HousekitClientConfig, type HousekitClient } from './client';
 import { generateSelectSchema, generateInsertSchema } from './codegen/zod';
 export { ClickHouseColumn } from './column';
 export { type TableDefinition, type TableColumns, type TableOptions, type IndexDefinition, type ProjectionDefinition, type InsertModel, type TableModel, type TableInsertArray, type TableRuntime, type TableInsert, index, projection, deriveTable, renderSchema } from './table';
@@ -73,10 +73,10 @@ export declare function createSchema<TCols extends TableColumns>(table: TableDef
     select: import("zod").ZodObject<any, import("zod/v4/core").$strip>;
     insert: import("zod").ZodObject<any, import("zod/v4/core").$strip>;
 };
-export type HousekitClient = ReturnType<typeof createClientFromConfigObject>;
-export declare function createClient(): Promise<HousekitClient>;
-export declare function createClient(config: ClientConfigWithSchema): HousekitClient;
-export declare function createClient(databaseName: string): Promise<HousekitClient>;
+export type { HousekitClient };
+export declare function createClient(): Promise<HousekitClientType>;
+export declare function createClient(config: ClientConfigWithSchema): HousekitClientType;
+export declare function createClient(databaseName: string): Promise<HousekitClientType>;
 export declare function tableExists(client: HousekitClient, tableName: string): Promise<boolean>;
 export declare function ensureTable<TCols extends TableColumns>(client: HousekitClient, table: TableDefinition<TCols>): Promise<void>;
 export declare function dropTable(client: HousekitClient, tableName: string, options?: {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@housekit/orm",
-    "version": "0.1.32",
+    "version": "0.1.34",
     "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",