@housekit/orm 0.1.32 → 0.1.33

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/package.json

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