@bitclaw/sqlite 1.1.0 → 1.2.0

package/README.md

@@ -36,7 +36,7 @@ Based on benchmarks from SecureLogin project:
 - **100% success rate** under load
 - **Prepared statement cache hit rate**: 100%
 
-These numbers reflect **direct SQLite pool operations** — no HTTP server, no ORM, no middleware. Application-level throughput (through TanStack Start + Prisma + SSR) will be lower. Use `bun run test:load` in each app for end-to-end numbers.
+These numbers reflect **direct SQLite pool operations** - no HTTP server, no ORM, no middleware. Application-level throughput (through TanStack Start + Prisma + SSR) will be lower. Use `bun run test:load` in each app for end-to-end numbers.
 
 ## Benchmarking Methodology
 
@@ -155,7 +155,7 @@ await cache.delete('user:123');
 
 ### Query Logger
 
-Dev-mode SQL logging for bun:sqlite — mirrors Prisma's `prisma:query` output. Zero overhead in production.
+Dev-mode SQL logging for bun:sqlite - mirrors Prisma's `prisma:query` output. Zero overhead in production.
 
 ```typescript
 import { Database } from 'bun:sqlite';
@@ -194,7 +194,7 @@ bootstrapCache.set(sessionId, data);
 return data;
 ```
 
-Unlike `WeakMap` per-request caching (which deduplicates within a single SSR request), `TTLCache` deduplicates **across** HTTP requests — e.g. when TanStack Router replays `beforeLoad` on client hydration, the server returns the cached result instantly (0 DB queries).
+Unlike `WeakMap` per-request caching (which deduplicates within a single SSR request), `TTLCache` deduplicates **across** HTTP requests - e.g. when TanStack Router replays `beforeLoad` on client hydration, the server returns the cached result instantly (0 DB queries).
 
 ## Configuration
 

package/dist/src/cache-lock.js

@@ -40,7 +40,7 @@ export class CacheLock {
         const result = this.db.transaction(() => {
             // Remove expired lock for this key first
             this.deleteExpiredStmt.run({ $key: key, $now: now });
-            // Try to insert — OR IGNORE means it fails silently if key exists
+            // Try to insert - OR IGNORE means it fails silently if key exists
             this.acquireStmt.run({
                 $key: key,
                 $owner: actualOwner,

package/dist/src/connection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/connection.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,QAAQ,CA+BvE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAalD;AAkCD;;GAEG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,GAAG;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CA6BA;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiB9D"}
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/connection.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,QAAQ,CAsBvE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAalD;AAkCD;;GAEG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,GAAG;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CA6BA;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiB9D"}

package/dist/src/connection.js

@@ -12,20 +12,14 @@ export function initializeConnection(config) {
     });
     // Apply optimal PRAGMA settings
     if (config.path !== ':memory:') {
-        // WAL mode for better concurrency
         db.run('PRAGMA journal_mode = WAL');
-        // Reduced busy timeout for worker coordination
-        db.run('PRAGMA busy_timeout = 5000');
-        // More frequent checkpoints
-        db.run('PRAGMA wal_autocheckpoint = 100');
-        // Note: cache_shared is not available in bun:sqlite
+        db.run('PRAGMA busy_timeout = 10000');
     }
-    // Performance optimizations
     db.run('PRAGMA foreign_keys = ON');
-    db.run('PRAGMA synchronous = NORMAL'); // Safe with WAL
-    db.run('PRAGMA cache_size = -4000'); // 4MB cache
+    db.run('PRAGMA synchronous = NORMAL');
+    db.run('PRAGMA cache_size = -20000'); // 20MB cache
     db.run('PRAGMA temp_store = MEMORY');
-    db.run('PRAGMA mmap_size = 67108864'); // 64MB mmap
+    db.run('PRAGMA mmap_size = 268435456'); // 256MB mmap
     // Query optimizer
     db.run('PRAGMA optimize');
     return db;

package/dist/src/prisma-immediate-tx.js

@@ -3,7 +3,7 @@
 //
 // Prisma's $transaction() uses BEGIN DEFERRED by default. When a deferred
 // transaction tries to upgrade from read to write lock, SQLite returns
-// SQLITE_BUSY *immediately* — bypassing busy_timeout entirely.
+// SQLITE_BUSY *immediately* - bypassing busy_timeout entirely.
 //
 // This helper wraps writes in BEGIN IMMEDIATE via $executeRawUnsafe,
 // which acquires the write lock upfront and respects busy_timeout.

package/dist/src/query-logger.d.ts

@@ -13,7 +13,7 @@ export type QueryLoggerOptions = {
  *
  * In production, returns the database unchanged (zero overhead).
  *
- * Usage — always wrap, logging auto-enables in dev:
+ * Usage - always wrap, logging auto-enables in dev:
  *
  *   const db = wrapWithQueryLogging(new Database(path), { label: 'ws:abc123' });
  */

package/dist/src/query-logger.js

@@ -1,11 +1,11 @@
 // packages/sqlite/src/query-logger.ts
-// Dev-mode query logging for bun:sqlite — mirrors Prisma's `prisma:query` output.
+// Dev-mode query logging for bun:sqlite - mirrors Prisma's `prisma:query` output.
 // Wraps a Database with a transparent Proxy that logs SQL on query/run/exec/prepare.
 // Zero overhead in production: returns the database as-is when NODE_ENV !== 'development'.
 // biome-ignore lint/suspicious/noConsole: intentional dev-mode query logging (mirrors Prisma's log: ['query'])
 const log = console.log;
 const isDev = process.env.NODE_ENV === 'development';
-// ANSI green for the prefix — contrasts with Prisma's blue `prisma:query`
+// ANSI green for the prefix - contrasts with Prisma's blue `prisma:query`
 const GREEN = '\x1b[32m';
 const RESET = '\x1b[0m';
 const formatSql = (sql) => sql.replace(/\s+/g, ' ').trim();
@@ -19,7 +19,7 @@ const formatSql = (sql) => sql.replace(/\s+/g, ' ').trim();
  *
  * In production, returns the database unchanged (zero overhead).
  *
- * Usage — always wrap, logging auto-enables in dev:
+ * Usage - always wrap, logging auto-enables in dev:
  *
  *   const db = wrapWithQueryLogging(new Database(path), { label: 'ws:abc123' });
  */

package/dist/src/statement-cache.d.ts

@@ -0,0 +1,23 @@
+import type { Database, Statement } from 'bun:sqlite';
+type CachedStatement = Statement<unknown>;
+export declare class StatementCache {
+    private cache;
+    private maxSize;
+    private hits;
+    private misses;
+    constructor(options?: {
+        maxSize?: number;
+    });
+    getOrPrepare(db: Database, sql: string): CachedStatement;
+    get(sql: string): CachedStatement | null;
+    set(sql: string, stmt: CachedStatement): void;
+    getStats(): {
+        hits: number;
+        misses: number;
+        size: number;
+        hitRate: number;
+    };
+    clear(): void;
+}
+export {};
+//# sourceMappingURL=statement-cache.d.ts.map

package/dist/src/statement-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statement-cache.d.ts","sourceRoot":"","sources":["../../src/statement-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGtD,KAAK,eAAe,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;AAE1C,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,MAAM,CAAK;gBAEP,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAI1C,YAAY,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,eAAe;IASxD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAWxC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,IAAI;IAW7C,QAAQ,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAU3E,KAAK,IAAI,IAAI;CAKd"}

package/dist/src/statement-cache.js

@@ -0,0 +1,52 @@
+export class StatementCache {
+    cache = new Map();
+    maxSize;
+    hits = 0;
+    misses = 0;
+    constructor(options) {
+        this.maxSize = options?.maxSize ?? 256;
+    }
+    getOrPrepare(db, sql) {
+        const normalized = sql.trim().replace(/\s+/g, ' ');
+        const cached = this.get(normalized);
+        if (cached)
+            return cached;
+        const stmt = db.query(normalized);
+        this.set(normalized, stmt);
+        return stmt;
+    }
+    get(sql) {
+        const stmt = this.cache.get(sql);
+        if (stmt) {
+            this.hits += 1;
+            this.cache.delete(sql);
+            this.cache.set(sql, stmt);
+            return stmt;
+        }
+        return null;
+    }
+    set(sql, stmt) {
+        this.misses += 1;
+        if (this.cache.size >= this.maxSize) {
+            const firstKey = this.cache.keys().next().value;
+            if (firstKey) {
+                this.cache.delete(firstKey);
+            }
+        }
+        this.cache.set(sql, stmt);
+    }
+    getStats() {
+        const total = this.hits + this.misses;
+        return {
+            hits: this.hits,
+            misses: this.misses,
+            size: this.cache.size,
+            hitRate: total > 0 ? (this.hits / total) * 100 : 0
+        };
+    }
+    clear() {
+        this.cache.clear();
+        this.hits = 0;
+        this.misses = 0;
+    }
+}

package/dist/src/tenant-db.d.ts

@@ -0,0 +1,21 @@
+import { Database } from 'bun:sqlite';
+export type TenantDbConfig = {
+    maxConnections?: number;
+    idleTimeoutMs?: number;
+    cleanupIntervalMs?: number;
+    onOpen?: (db: Database, tenantId: string) => void;
+    wrapDb?: (raw: Database, tenantId: string) => Database;
+};
+export type TenantDbManager = {
+    getDb: (tenantId: string, dbPath: string) => Database;
+    withWriteLock: <T>(tenantId: string, fn: () => T | Promise<T>) => Promise<T>;
+    evict: (tenantId: string) => void;
+    evictIdle: (maxIdleMs?: number) => number;
+    closeAll: () => void;
+    getStats: () => {
+        activeConnections: number;
+        oldestAccess: number | null;
+    };
+};
+export declare const createTenantDbManager: (config?: TenantDbConfig) => TenantDbManager;
+//# sourceMappingURL=tenant-db.d.ts.map

package/dist/src/tenant-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-db.d.ts","sourceRoot":"","sources":["../../src/tenant-db.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAKtC,MAAM,MAAM,cAAc,GAAG;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,KAAK,QAAQ,CAAC;CACxD,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,QAAQ,CAAC;IACtD,aAAa,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAC7E,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,SAAS,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC1C,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM;QAAE,iBAAiB,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CAC5E,CAAC;AAmBF,eAAO,MAAM,qBAAqB,GAChC,SAAS,cAAc,KACtB,eA8IF,CAAC"}

package/dist/src/tenant-db.js

@@ -0,0 +1,143 @@
+import { Database } from 'bun:sqlite';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { WriteMutexMap } from './write-mutex';
+const applyPragmas = (db, dbPath) => {
+    if (dbPath !== ':memory:') {
+        db.run('PRAGMA journal_mode = WAL');
+        db.run('PRAGMA busy_timeout = 10000');
+    }
+    db.run('PRAGMA synchronous = NORMAL');
+    db.run('PRAGMA cache_size = -20000'); // 20MB
+    db.run('PRAGMA temp_store = MEMORY');
+    db.run('PRAGMA mmap_size = 268435456'); // 256MB
+    db.run('PRAGMA foreign_keys = ON');
+};
+export const createTenantDbManager = (config) => {
+    const maxConnections = config?.maxConnections ?? 200;
+    const idleTimeoutMs = config?.idleTimeoutMs ?? 300_000;
+    const cleanupIntervalMs = config?.cleanupIntervalMs ?? 60_000;
+    const connections = new Map();
+    const writeMutexes = new WriteMutexMap();
+    let cleanupIntervalId = null;
+    const startCleanup = () => {
+        if (cleanupIntervalId)
+            return;
+        cleanupIntervalId = setInterval(() => {
+            evictIdle();
+            for (const conn of connections.values()) {
+                try {
+                    conn.db.run('PRAGMA wal_checkpoint(PASSIVE)');
+                    conn.db.run('PRAGMA optimize');
+                }
+                catch {
+                    // Non-critical
+                }
+            }
+        }, cleanupIntervalMs);
+        if (cleanupIntervalId.unref) {
+            cleanupIntervalId.unref();
+        }
+    };
+    const evict = (tenantId) => {
+        const entry = connections.get(tenantId);
+        if (entry) {
+            try {
+                entry.db.close();
+            }
+            catch {
+                // Ignore
+            }
+            connections.delete(tenantId);
+            writeMutexes.delete(tenantId);
+        }
+    };
+    const evictIdle = (maxIdleMs = idleTimeoutMs) => {
+        const now = Date.now();
+        let evicted = 0;
+        for (const [id, conn] of connections) {
+            if (now - conn.lastAccessed > maxIdleMs) {
+                try {
+                    conn.db.close();
+                }
+                catch {
+                    // Ignore
+                }
+                connections.delete(id);
+                writeMutexes.delete(id);
+                evicted++;
+            }
+        }
+        return evicted;
+    };
+    const getDb = (tenantId, dbPath) => {
+        const cached = connections.get(tenantId);
+        if (cached) {
+            cached.lastAccessed = Date.now();
+            return cached.db;
+        }
+        const dir = path.dirname(dbPath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        const raw = new Database(dbPath);
+        applyPragmas(raw, dbPath);
+        try {
+            config?.onOpen?.(raw, tenantId);
+        }
+        catch (err) {
+            raw.close();
+            throw err;
+        }
+        const db = config?.wrapDb ? config.wrapDb(raw, tenantId) : raw;
+        connections.set(tenantId, { db, lastAccessed: Date.now() });
+        if (connections.size > maxConnections) {
+            let lruId = null;
+            let lruAccessed = Number.MAX_SAFE_INTEGER;
+            for (const [id, conn] of connections) {
+                if (conn.lastAccessed < lruAccessed) {
+                    lruAccessed = conn.lastAccessed;
+                    lruId = id;
+                }
+            }
+            if (lruId) {
+                try {
+                    connections.get(lruId)?.db.close();
+                }
+                catch {
+                    // Ignore
+                }
+                connections.delete(lruId);
+                writeMutexes.delete(lruId);
+            }
+        }
+        startCleanup();
+        return db;
+    };
+    const withWriteLock = (tenantId, fn) => writeMutexes.withLock(tenantId, fn);
+    const closeAll = () => {
+        for (const [, conn] of connections) {
+            try {
+                conn.db.close();
+            }
+            catch {
+                // Ignore
+            }
+        }
+        connections.clear();
+        if (cleanupIntervalId) {
+            clearInterval(cleanupIntervalId);
+            cleanupIntervalId = null;
+        }
+    };
+    const getStats = () => {
+        let oldestAccess = null;
+        for (const conn of connections.values()) {
+            if (oldestAccess === null || conn.lastAccessed < oldestAccess) {
+                oldestAccess = conn.lastAccessed;
+            }
+        }
+        return { activeConnections: connections.size, oldestAccess };
+    };
+    return { getDb, withWriteLock, evict, evictIdle, closeAll, getStats };
+};

package/dist/src/ttl-cache.d.ts

@@ -13,7 +13,7 @@ export type TTLCacheOptions = {
  * `maxSize`.
  *
  * Unlike WeakMap per-request caching (which deduplicates within a single
- * request), TTLCache deduplicates across requests — e.g. when TanStack
+ * request), TTLCache deduplicates across requests - e.g. when TanStack
  * Router replays `beforeLoad` on client hydration, the server returns the
  * cached result instantly (0 DB queries).
  *

package/dist/src/ttl-cache.js

@@ -11,7 +11,7 @@
  * `maxSize`.
  *
  * Unlike WeakMap per-request caching (which deduplicates within a single
- * request), TTLCache deduplicates across requests — e.g. when TanStack
+ * request), TTLCache deduplicates across requests - e.g. when TanStack
  * Router replays `beforeLoad` on client hydration, the server returns the
  * cached result instantly (0 DB queries).
  *

package/dist/src/worker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/worker.ts"],"names":[],"mappings":"AAoEA,KAAK,cAAc,GAAG;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QACP,OAAO,CAAC,EACJ,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC,GAC3D,SAAS,CAAC;QACd,aAAa,EAAE,OAAO,CAAC;KACxB,CAAC;CACH,CAAC;AAEF,KAAK,aAAa,GAAG;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AA6DF,qBAAa,YAAY;IACvB,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,CAAC,EAAE,cAAc;YAKrB,kBAAkB;IAkD1B,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IA6CpE,OAAO,CAAC,YAAY;IAoDpB,QAAQ,IAAI,IAAI;IAchB,WAAW,IAAI,MAAM;CAGtB"}
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/worker.ts"],"names":[],"mappings":"AAcA,KAAK,cAAc,GAAG;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QACP,OAAO,CAAC,EACJ,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC,GAC3D,SAAS,CAAC;QACd,aAAa,EAAE,OAAO,CAAC;KACxB,CAAC;CACH,CAAC;AAEF,KAAK,aAAa,GAAG;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAkDF,qBAAa,YAAY;IACvB,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,CAAC,EAAE,cAAc;YAKrB,kBAAkB;IAgC1B,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IA6CpE,OAAO,CAAC,YAAY;IAoDpB,QAAQ,IAAI,IAAI;IAchB,WAAW,IAAI,MAAM;CAGtB"}

package/dist/src/worker.js

@@ -3,53 +3,9 @@
 // Uses bun:sqlite for 3-6x faster reads compared to better-sqlite3
 import { Database } from 'bun:sqlite';
 import { parentPort, workerData } from 'node:worker_threads';
+import { StatementCache } from './statement-cache';
 const isDevelopment = process.env.NODE_ENV === 'development';
 const isTest = process.env.NODE_ENV === 'test';
-// ---------------------------------------------------------------------------
-// Prepared-statement LRU cache for optimal performance
-// ---------------------------------------------------------------------------
-class StatementCache {
-    cache = new Map();
-    maxSize = 256;
-    hits = 0;
-    misses = 0;
-    get(sql) {
-        const stmt = this.cache.get(sql);
-        if (stmt) {
-            this.hits += 1;
-            // Move to end (LRU behavior)
-            this.cache.delete(sql);
-            this.cache.set(sql, stmt);
-            return stmt;
-        }
-        return null;
-    }
-    set(sql, stmt) {
-        this.misses += 1;
-        // If at capacity, remove oldest
-        if (this.cache.size >= this.maxSize) {
-            const firstKey = this.cache.keys().next().value;
-            if (firstKey) {
-                this.cache.delete(firstKey);
-            }
-        }
-        this.cache.set(sql, stmt);
-    }
-    getStats() {
-        const total = this.hits + this.misses;
-        return {
-            hits: this.hits,
-            misses: this.misses,
-            size: this.cache.size,
-            hitRate: total > 0 ? (this.hits / total) * 100 : 0
-        };
-    }
-    clear() {
-        this.cache.clear();
-        this.hits = 0;
-        this.misses = 0;
-    }
-}
 const stmtCache = new StatementCache();
 // Worker-specific database configuration
 async function getDbConfig() {
@@ -89,16 +45,7 @@ async function getDbConfig() {
     };
 }
 function getOrCreateStatement(db, sql) {
-    // Normalize SQL for better cache hits
-    const normalizedSql = sql.trim().replace(/\s+/g, ' ');
-    let stmt = stmtCache.get(normalizedSql);
-    if (stmt) {
-        return stmt;
-    }
-    // Cache miss → prepare + insert (bun:sqlite uses .query() instead of .prepare())
-    stmt = db.query(normalizedSql);
-    stmtCache.set(normalizedSql, stmt);
-    return stmt;
+    return stmtCache.getOrPrepare(db, sql);
 }
 // SQLite Worker class
 export class SQLiteWorker {
@@ -122,27 +69,15 @@ export class SQLiteWorker {
                 create: !this.config.options.fileMustExist,
                 readonly: false
             });
-            // ✅ OPTIMIZED: Enhanced multi-worker SQLite configuration
-            // bun:sqlite uses run() for PRAGMA statements instead of pragma()
             if (this.config.path !== ':memory:') {
-                // WAL mode with optimized settings
                 this.db.run('PRAGMA journal_mode = WAL');
-                // ✅ CRITICAL: Reduced timeout for better worker coordination
-                this.db.run('PRAGMA busy_timeout = 5000');
-                // ✅ PERFORMANCE: More frequent checkpoints for multi-worker
-                this.db.run('PRAGMA wal_autocheckpoint = 100');
-                // ✅ CONCURRENCY: Enable shared cache for same-process workers
-                // Note: cache_shared is not available in bun:sqlite, skip it
+                this.db.run('PRAGMA busy_timeout = 10000');
             }
-            // ✅ PERFORMANCE: Optimized PRAGMA settings for workers
             this.db.run('PRAGMA foreign_keys = ON');
-            this.db.run('PRAGMA synchronous = NORMAL'); // Optimal for WAL mode
-            // ✅ MEMORY: 4MB per worker cache
-            this.db.run('PRAGMA cache_size = -4000');
+            this.db.run('PRAGMA synchronous = NORMAL');
+            this.db.run('PRAGMA cache_size = -20000'); // 20MB cache
             this.db.run('PRAGMA temp_store = MEMORY');
-            // ✅ CONCURRENCY: Optimized mmap for multi-worker
-            this.db.run('PRAGMA mmap_size = 67108864'); // 64MB
-            // ✅ PERFORMANCE: Enable query planner optimizations
+            this.db.run('PRAGMA mmap_size = 268435456'); // 256MB mmap
             this.db.run('PRAGMA optimize');
         }
         catch (error) {

package/dist/src/write-mutex.d.ts

@@ -1,6 +1,6 @@
 /**
  * A simple async mutex that serializes write access to a resource.
- * Bun is single-threaded, so this works as a plain promise queue —
+ * Bun is single-threaded, so this works as a plain promise queue -
  * no atomic operations needed.
  */
 export declare class WriteMutex {

package/dist/src/write-mutex.js

@@ -2,7 +2,7 @@
 // Promise-based per-resource write mutex for SQLite concurrency
 /**
  * A simple async mutex that serializes write access to a resource.
- * Bun is single-threaded, so this works as a plain promise queue —
+ * Bun is single-threaded, so this works as a plain promise queue -
  * no atomic operations needed.
  */
 export class WriteMutex {

package/package.json

@@ -1,21 +1,67 @@
 {
   "name": "@bitclaw/sqlite",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "High-performance SQLite worker pool and utilities using bun:sqlite",
-  "files": ["dist", "scripts", "LICENSE", "README.md"],
+  "files": [
+    "dist",
+    "scripts",
+    "LICENSE",
+    "README.md"
+  ],
   "type": "module",
   "exports": {
-    "./pool": { "types": "./dist/src/pool.d.ts", "default": "./dist/src/pool.js" },
-    "./worker": { "types": "./dist/src/worker.d.ts", "default": "./dist/src/worker.js" },
-    "./connection": { "types": "./dist/src/connection.d.ts", "default": "./dist/src/connection.js" },
-    "./json-cache": { "types": "./dist/src/json-cache.d.ts", "default": "./dist/src/json-cache.js" },
-    "./retry": { "types": "./dist/src/retry.d.ts", "default": "./dist/src/retry.js" },
-    "./write-mutex": { "types": "./dist/src/write-mutex.d.ts", "default": "./dist/src/write-mutex.js" },
-    "./prisma-immediate-tx": { "types": "./dist/src/prisma-immediate-tx.d.ts", "default": "./dist/src/prisma-immediate-tx.js" },
-    "./query-logger": { "types": "./dist/src/query-logger.d.ts", "default": "./dist/src/query-logger.js" },
-    "./ttl-cache": { "types": "./dist/src/ttl-cache.d.ts", "default": "./dist/src/ttl-cache.js" },
-    "./cache-lock": { "types": "./dist/src/cache-lock.d.ts", "default": "./dist/src/cache-lock.js" },
-    "./load-test-utils": { "types": "./dist/scripts/load-test-utils.d.ts", "default": "./dist/scripts/load-test-utils.js" }
+    "./pool": {
+      "types": "./dist/src/pool.d.ts",
+      "default": "./dist/src/pool.js"
+    },
+    "./worker": {
+      "types": "./dist/src/worker.d.ts",
+      "default": "./dist/src/worker.js"
+    },
+    "./connection": {
+      "types": "./dist/src/connection.d.ts",
+      "default": "./dist/src/connection.js"
+    },
+    "./json-cache": {
+      "types": "./dist/src/json-cache.d.ts",
+      "default": "./dist/src/json-cache.js"
+    },
+    "./retry": {
+      "types": "./dist/src/retry.d.ts",
+      "default": "./dist/src/retry.js"
+    },
+    "./write-mutex": {
+      "types": "./dist/src/write-mutex.d.ts",
+      "default": "./dist/src/write-mutex.js"
+    },
+    "./prisma-immediate-tx": {
+      "types": "./dist/src/prisma-immediate-tx.d.ts",
+      "default": "./dist/src/prisma-immediate-tx.js"
+    },
+    "./query-logger": {
+      "types": "./dist/src/query-logger.d.ts",
+      "default": "./dist/src/query-logger.js"
+    },
+    "./ttl-cache": {
+      "types": "./dist/src/ttl-cache.d.ts",
+      "default": "./dist/src/ttl-cache.js"
+    },
+    "./cache-lock": {
+      "types": "./dist/src/cache-lock.d.ts",
+      "default": "./dist/src/cache-lock.js"
+    },
+    "./tenant-db": {
+      "types": "./dist/src/tenant-db.d.ts",
+      "default": "./dist/src/tenant-db.js"
+    },
+    "./statement-cache": {
+      "types": "./dist/src/statement-cache.d.ts",
+      "default": "./dist/src/statement-cache.js"
+    },
+    "./load-test-utils": {
+      "types": "./dist/scripts/load-test-utils.d.ts",
+      "default": "./dist/scripts/load-test-utils.js"
+    }
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
@@ -34,10 +80,18 @@
     "publish:minor": "npm whoami && npm version minor && git push --follow-tags && npm publish --access public",
     "publish:major": "npm whoami && npm version major && git push --follow-tags && npm publish --access public"
   },
-  "keywords": ["sqlite", "bun", "worker-pool", "json-cache", "ttl-cache"],
+  "keywords": [
+    "sqlite",
+    "bun",
+    "worker-pool",
+    "json-cache",
+    "ttl-cache"
+  ],
   "author": "bitclaw",
   "license": "MIT",
-  "engines": { "bun": ">=1.3.0" },
+  "engines": {
+    "bun": ">=1.3.0"
+  },
   "devDependencies": {
     "@biomejs/biome": "^2.4.15",
     "knip": "^6.12.1",