@housekit/orm 0.1.2 → 0.1.3

package/README.md

@@ -152,9 +152,10 @@ const builder = db.insert(webEvents)
     flushIntervalMs: 5000 
   });
 
-// These calls return immediately, flushing happens in the background
-builder.values(row1).execute();
-builder.values(row2).execute();
+// Add rows to the background queue.
+// Proccessing and flushing happen automatically.
+await builder.append(row1);
+await builder.append(row2);
 ```
 
 ---

package/dist/builders/insert.d.ts

@@ -64,6 +64,16 @@ export declare class ClickHouseInsertBuilder<TTable extends TableDefinition<Tabl
      * Default: 1000
      */
     batchSize(size: number): this;
+    /**
+     * Add a row to the background batcher.
+     *
+     * If batching is not yet configured, it will use default settings
+     * (10,000 rows or 5 seconds).
+     *
+     * 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>;
     /**
      * Force JSON format (useful for debugging or compatibility).
      *

package/package.json

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