@housekit/orm 0.1.1

package/dist/utils/binary-worker-pool.d.ts

@@ -0,0 +1,76 @@
+/**
+ * HouseKit Binary Worker Pool - High-Performance Parallel Serialization
+ *
+ * Manages a pool of worker threads for parallel RowBinary serialization.
+ * Automatically distributes work across available CPU cores.
+ */
+import { EventEmitter } from 'events';
+interface ColumnConfig {
+    name: string;
+    type: string;
+    isNullable: boolean;
+}
+export interface BinaryWorkerPoolOptions {
+    /** Number of worker threads (default: CPU cores - 1) */
+    poolSize?: number;
+    /** Maximum rows per batch sent to a worker */
+    batchSize?: number;
+    /** Enable high-water mark backpressure */
+    highWaterMark?: number;
+}
+export declare class BinaryWorkerPool extends EventEmitter {
+    private workers;
+    private columns;
+    private batchIdCounter;
+    private queue;
+    private isShutdown;
+    private readonly options;
+    constructor(options?: BinaryWorkerPoolOptions);
+    /**
+     * Initialize the worker pool with column configuration
+     */
+    initialize(columns: ColumnConfig[]): Promise<void>;
+    private spawnWorker;
+    private handleWorkerMessage;
+    /**
+     * Serialize rows to binary format using worker pool
+     */
+    serialize(rows: Array<Record<string, any>>): Promise<Buffer>;
+    /**
+     * Serialize rows in batches, returning an async iterator of buffers
+     */
+    serializeStream(rows: AsyncIterable<Record<string, any>> | Iterable<Record<string, any>>): AsyncGenerator<Buffer>;
+    private processQueue;
+    /**
+     * Get pool statistics
+     */
+    getStats(): {
+        workers: number;
+        busy: number;
+        queueSize: number;
+    };
+    /**
+     * Shutdown all workers
+     */
+    shutdown(): Promise<void>;
+}
+/**
+ * Get or create the default worker pool
+ */
+export declare function getDefaultBinaryPool(columns?: ColumnConfig[]): Promise<BinaryWorkerPool>;
+/**
+ * Shutdown the default pool
+ */
+export declare function shutdownDefaultBinaryPool(): Promise<void>;
+/**
+ * Synchronous fallback serializer for environments without Worker support
+ */
+export declare class SyncBinarySerializer {
+    private encoders;
+    private columns;
+    private writer;
+    constructor(columns: ColumnConfig[]);
+    serialize(rows: Array<Record<string, any>>): Buffer;
+    serializeStream(rows: AsyncIterable<Record<string, any>> | Iterable<Record<string, any>>, batchSize?: number): AsyncGenerator<Buffer>;
+}
+export {};

package/dist/utils/binary-worker.d.ts

@@ -0,0 +1,12 @@
+/**
+ * HouseKit Binary Worker - Parallel RowBinary Serialization
+ *
+ * This worker thread handles binary serialization off the main thread,
+ * allowing the main thread to focus on I/O while serialization happens in parallel.
+ *
+ * Benefits:
+ * - Main thread stays responsive for network I/O
+ * - Serialization uses separate CPU core
+ * - Can saturate 10Gbps links without blocking Node.js event loop
+ */
+export {};

package/dist/utils/insert-processing.d.ts

@@ -0,0 +1,23 @@
+import { ClickHouseColumn, type TableDefinition } from '../core';
+type UUIDVersion = 1 | 3 | 4 | 5 | 6 | 7;
+type PreparedInsertColumn = {
+    propKey: string;
+    column: ClickHouseColumn;
+    columnName: string;
+    hasDefault: boolean;
+    defaultValue: any;
+    defaultFn: ((row: Record<string, any>) => any) | null;
+    autoUUIDVersion: UUIDVersion | null;
+    useServerUUID: boolean;
+    transform: (value: any) => any;
+};
+export type InsertPlan = {
+    columns: PreparedInsertColumn[];
+    keyToColumn: Map<string, PreparedInsertColumn>;
+    columnNames: string[];
+    useCompact: boolean;
+};
+export declare function buildInsertPlan(table: TableDefinition<any>): InsertPlan;
+export declare function processRowWithPlan(row: Record<string, any>, plan: InsertPlan, mode?: 'compact' | 'json'): Record<string, any> | any[];
+export declare function processRowsStream(rows: AsyncIterable<Record<string, any>> | Iterable<Record<string, any>>, plan: InsertPlan, mode?: 'compact' | 'json'): AsyncGenerator<any[] | Record<string, any>, void, unknown>;
+export {};

package/dist/utils/lru-cache.d.ts

@@ -0,0 +1,10 @@
+export declare class LRUCache<K, V> {
+    private map;
+    private readonly max;
+    constructor(options: {
+        max: number;
+    });
+    get(key: K): V | undefined;
+    set(key: K, value: V): void;
+    clear(): void;
+}

package/package.json

@@ -0,0 +1,68 @@
+{
+    "name": "@housekit/orm",
+    "version": "0.1.1",
+    "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",
+    "types": "./dist/index.d.ts",
+    "sideEffects": false,
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js"
+        }
+    },
+    "license": "MIT",
+    "author": "Pablo Fernandez Ruiz",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/pablofdezr/housekit.git",
+        "directory": "packages/orm"
+    },
+    "homepage": "https://github.com/pablofdezr/housekit#readme",
+    "bugs": {
+        "url": "https://github.com/pablofdezr/housekit/issues"
+    },
+    "keywords": [
+        "clickhouse",
+        "orm",
+        "typescript",
+        "type-safe",
+        "query-builder",
+        "database",
+        "sql",
+        "analytics",
+        "olap",
+        "drizzle",
+        "turbo-mode",
+        "rowbinary"
+    ],
+    "files": [
+        "dist/**/*",
+        "LICENSE",
+        "README.md"
+    ],
+    "scripts": {
+        "build": "bun run build-worker.ts && bun build ./src/index.ts --outdir ./dist --target node --external \"*\" && tsc --project tsconfig.build.json",
+        "prepublishOnly": "bun run build",
+        "clean": "rm -rf dist"
+    },
+    "dependencies": {
+        "uuid": "^13.0.0",
+        "zod": "^4.2.1"
+    },
+    "peerDependencies": {
+        "@clickhouse/client": "^1.0.0"
+    },
+    "devDependencies": {
+        "@clickhouse/client": "^1.14.0",
+        "@types/uuid": "^11.0.0",
+        "typescript": "^5.0.0"
+    },
+    "publishConfig": {
+        "access": "public"
+    },
+    "engines": {
+        "node": ">=18.0.0"
+    }
+}