hazo_connect 2.7.3 → 3.1.0

package/README.md

@@ -50,7 +50,7 @@ npm install hazo_connect
 ### Required Peer Dependencies
 
 ```bash
-npm install hazo_logs@>=1.0.5
+npm install hazo_core hazo_logs
 ```
 
 ### Optional Peer Dependencies
@@ -58,13 +58,13 @@ npm install hazo_logs@>=1.0.5
 For INI config file support:
 
 ```bash
-npm install hazo_config@>=1.3.0
+npm install hazo_config
 ```
 
 For the SQLite admin UI:
 
 ```bash
-npm install next@>=14.0.0 react@>=18.0.0 react-dom@>=18.0.0 lucide-react@^0.553.0 sonner@^2.0.7
+npm install hazo_ui hazo_debug next react react-dom lucide-react sonner
 ```
 
 ---
@@ -440,6 +440,28 @@ const hazo = createHazoConnect({
 })
 ```
 
+#### SQLite drivers
+
+The `sqlite` type supports two drivers:
+
+- `sql.js` (default) — pure-WASM, no native build; ideal for local dev, tests, and edge runtimes.
+- `better-sqlite3` — native engine for production-grade, file-backed SQLite with WAL
+  concurrency. Requires the optional `better-sqlite3` package (`npm install better-sqlite3`).
+
+```ts
+createHazoConnect({
+  type: 'sqlite',
+  sqlite: {
+    driver: 'better-sqlite3',       // default: 'sql.js'
+    database_path: './data/app.sqlite',
+    pragmas: { busy_timeout: 8000 },// optional overrides; WAL + foreign_keys on by default
+  },
+})
+```
+
+Or via env: `HAZO_CONNECT_SQLITE_DRIVER=better-sqlite3`.
+The SQLite admin UI is currently supported only with the `sql.js` driver.
+
 ### PostgREST Configuration
 
 ```typescript

package/dist/adapters/base-adapter.d.ts

@@ -3,67 +3,18 @@
  *
  * This file provides a base class for all database adapters.
  * Includes common error handling and optional logger support.
- * Zero dependencies - only Node.js built-ins and types.
  */
-import type { Logger, HazoConnectError } from '../types.js';
+import type { Logger } from '../types.js';
 import { ErrorCode } from '../types.js';
-/**
- * Abstract base adapter class
- * All adapters should extend this class
- */
 export declare abstract class BaseAdapter {
     protected logger: Logger;
     protected config: any;
-    /**
-     * Constructor
-     * @param config - Adapter-specific configuration
-     * @param logger - Optional logger instance
-     */
     constructor(config: any, logger?: Logger);
-    /**
-     * Create a standardized error object
-     * @param code - Error code
-     * @param message - Error message
-     * @param statusCode - Optional HTTP status code
-     * @param originalError - Optional original error
-     * @returns HazoConnectError object
-     */
-    protected createError(code: ErrorCode, message: string, statusCode?: number, originalError?: any): HazoConnectError;
-    /**
-     * Throw a standardized error
-     * @param code - Error code
-     * @param message - Error message
-     * @param statusCode - Optional HTTP status code
-     * @param originalError - Optional original error
-     */
-    protected throwError(code: ErrorCode, message: string, statusCode?: number, originalError?: any): never;
-    /**
-     * Detect if an error is a connection failure
-     * @param error - Error to check
-     * @returns True if connection failure
-     */
+    protected throwError(code: ErrorCode, message: string, _statusCode?: number, cause?: any): never;
     protected isConnectionError(error: any): boolean;
-    /**
-     * Handle connection errors
-     * @param error - Error to handle
-     */
     protected handleConnectionError(error: any): never;
-    /**
-     * Validate configuration
-     * @param requiredFields - Array of required field names
-     * @throws Error if validation fails
-     */
     protected validateConfig(requiredFields: string[]): void;
-    /**
-     * Log a query operation
-     * @param operation - Operation name
-     * @param details - Operation details
-     */
     protected logQuery(operation: string, details: any): void;
-    /**
-     * Get the adapter's configuration
-     * @returns Promise with adapter-specific config
-     */
     abstract getConfig(): Promise<any>;
 }
 //# sourceMappingURL=base-adapter.d.ts.map

package/dist/adapters/base-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-adapter.d.ts","sourceRoot":"","sources":["../../src/lib/adapters/base-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAY,MAAM,aAAa,CAAA;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAGvC;;;GAGG;AACH,8BAAsB,WAAW;IAC/B,SAAS,CAAC,MAAM,EAAE,MAAM,CAAA;IACxB,SAAS,CAAC,MAAM,EAAE,GAAG,CAAA;IAErB;;;;OAIG;gBACS,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM;IAaxC;;;;;;;OAOG;IACH,SAAS,CAAC,WAAW,CACnB,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,GAAG,GAClB,gBAAgB;IAsBnB;;;;;;OAMG;IACH,SAAS,CAAC,UAAU,CAClB,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,GAAG,GAClB,KAAK;IAaR;;;;OAIG;IACH,SAAS,CAAC,iBAAiB,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO;IAahD;;;OAGG;IACH,SAAS,CAAC,qBAAqB,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK;IAYlD;;;;OAIG;IACH,SAAS,CAAC,cAAc,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,IAAI;IAWxD;;;;OAIG;IACH,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,IAAI;IAQzD;;;OAGG;IACH,QAAQ,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC;CACnC"}
+{"version":3,"file":"base-adapter.d.ts","sourceRoot":"","sources":["../../src/lib/adapters/base-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,KAAK,EAAE,MAAM,EAAY,MAAM,aAAa,CAAA;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAGvC,8BAAsB,WAAW;IAC/B,SAAS,CAAC,MAAM,EAAE,MAAM,CAAA;IACxB,SAAS,CAAC,MAAM,EAAE,GAAG,CAAA;gBAET,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM;IAYxC,SAAS,CAAC,UAAU,CAClB,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE,GAAG,GACV,KAAK;IAyBR,SAAS,CAAC,iBAAiB,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO;IAYhD,SAAS,CAAC,qBAAqB,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK;IAOlD,SAAS,CAAC,cAAc,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,IAAI;IAQxD,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,IAAI;IAKzD,QAAQ,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC;CACnC"}

package/dist/adapters/base-adapter.js

@@ -4,25 +4,15 @@
  *
  * This file provides a base class for all database adapters.
  * Includes common error handling and optional logger support.
- * Zero dependencies - only Node.js built-ins and types.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BaseAdapter = void 0;
+const hazo_core_1 = require("hazo_core");
 const types_js_1 = require("../types.js");
 const default_logger_js_1 = require("../default-logger.js");
-/**
- * Abstract base adapter class
- * All adapters should extend this class
- */
 class BaseAdapter {
-    /**
-     * Constructor
-     * @param config - Adapter-specific configuration
-     * @param logger - Optional logger instance
-     */
     constructor(config, logger) {
         this.config = config;
-        // Use provided logger, or create one with log level from config
         if (logger) {
             this.logger = logger;
         }
@@ -33,56 +23,29 @@ class BaseAdapter {
             this.logger = default_logger_js_1.defaultLogger;
         }
     }
-    /**
-     * Create a standardized error object
-     * @param code - Error code
-     * @param message - Error message
-     * @param statusCode - Optional HTTP status code
-     * @param originalError - Optional original error
-     * @returns HazoConnectError object
-     */
-    createError(code, message, statusCode, originalError) {
-        // Convert enum to string to ensure it's serializable
-        const codeString = String(code);
-        const error = {
-            code: codeString,
+    throwError(code, message, _statusCode, cause) {
+        const opts = {
+            code: String(code),
+            pkg: 'hazo_connect',
             message,
-            statusCode,
-            originalError
+            cause: cause instanceof Error ? cause : undefined,
+            context: cause && !(cause instanceof Error) ? { originalError: String(cause) } : undefined,
         };
-        // Log the error
-        this.logger.error(`[${codeString}] ${message}`, {
-            code: codeString,
-            message,
-            statusCode,
-            originalError: originalError instanceof Error ? originalError.message : String(originalError)
-        });
-        return error;
-    }
-    /**
-     * Throw a standardized error
-     * @param code - Error code
-     * @param message - Error message
-     * @param statusCode - Optional HTTP status code
-     * @param originalError - Optional original error
-     */
-    throwError(code, message, statusCode, originalError) {
-        const error = this.createError(code, message, statusCode, originalError);
-        const err = new Error(message);
-        // Convert enum to string to ensure it's serializable
-        err.code = String(code);
-        err.statusCode = statusCode;
-        // Only include serializable error info
-        err.originalError = originalError instanceof Error
-            ? originalError.message
-            : (typeof originalError === 'object' ? JSON.stringify(originalError) : String(originalError));
-        throw err;
+        switch (code) {
+            case types_js_1.ErrorCode.CONFIG_ERROR:
+                throw new hazo_core_1.HazoConfigError(opts);
+            case types_js_1.ErrorCode.CONNECTION_FAILED:
+                throw new hazo_core_1.HazoUnavailableError({ code: opts.code, pkg: opts.pkg, message: opts.message, cause: opts.cause, context: opts.context });
+            case types_js_1.ErrorCode.QUERY_ERROR:
+                throw new hazo_core_1.HazoInternalError(opts);
+            case types_js_1.ErrorCode.NOT_IMPLEMENTED:
+                throw new hazo_core_1.HazoInternalError(opts);
+            case types_js_1.ErrorCode.VALIDATION_ERROR:
+                throw new hazo_core_1.HazoValidationError(opts);
+            default:
+                throw new hazo_core_1.HazoInternalError(opts);
+        }
     }
-    /**
-     * Detect if an error is a connection failure
-     * @param error - Error to check
-     * @returns True if connection failure
-     */
     isConnectionError(error) {
         if (!error)
             return false;
@@ -93,21 +56,12 @@ class BaseAdapter {
             message.includes('ETIMEDOUT') ||
             message.includes('Lost connection'));
     }
-    /**
-     * Handle connection errors
-     * @param error - Error to handle
-     */
     handleConnectionError(error) {
         if (this.isConnectionError(error)) {
             this.throwError(types_js_1.ErrorCode.CONNECTION_FAILED, 'Lost connection to database', undefined, error);
         }
         throw error;
     }
-    /**
-     * Validate configuration
-     * @param requiredFields - Array of required field names
-     * @throws Error if validation fails
-     */
     validateConfig(requiredFields) {
         for (const field of requiredFields) {
             if (!this.config || !this.config[field]) {
@@ -115,17 +69,9 @@ class BaseAdapter {
             }
         }
     }
-    /**
-     * Log a query operation
-     * @param operation - Operation name
-     * @param details - Operation details
-     */
     logQuery(operation, details) {
-        // Use debug level for query details to reduce noise from frequent operations (e.g., polling)
-        this.logger.debug(`[Query] ${operation}`, {
-            operation,
-            ...details
-        });
+        const correlationId = (0, hazo_core_1.getCorrelationId)();
+        this.logger.debug('adapter.query', { operation, ...details, ...(correlationId ? { correlationId } : {}) });
     }
 }
 exports.BaseAdapter = BaseAdapter;

package/dist/adapters/base-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"base-adapter.js","sourceRoot":"","sources":["../../src/lib/adapters/base-adapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"base-adapter.js","sourceRoot":"","sources":["../../src/lib/adapters/base-adapter.ts"],"names":[],"mappings":"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"}

package/dist/adapters/better-sqlite3-adapter.d.ts

@@ -0,0 +1,61 @@
+import type { ClaimRowsOptions, HazoConnectAdapter, Logger } from '../types.js';
+import { BaseAdapter } from './base-adapter.js';
+import { QueryBuilder } from '../query-builder.js';
+export interface BetterSqlite3TransactionContext {
+    query: (builder: QueryBuilder, method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE', body?: unknown) => Promise<any>;
+    rawQuery: (sql: string, options?: {
+        params?: unknown[];
+    }) => Promise<any>;
+    execScript: (sql: string) => Promise<void>;
+}
+export declare class BetterSqlite3Adapter extends BaseAdapter implements HazoConnectAdapter {
+    private readonly sqliteConfig;
+    private readonly isReadOnlyMode;
+    private readonly databasePath;
+    private readonly pragmas;
+    private readonly databasePromise;
+    private dbInstance?;
+    private inTransaction;
+    private _claimQueue;
+    constructor(config: any, logger?: Logger);
+    getConfig(): Promise<any>;
+    query(builder: QueryBuilder, method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE', body?: unknown): Promise<any>;
+    rawQuery(sql: string, options?: RequestInit & {
+        params?: unknown[];
+    }): Promise<any>;
+    private executeSelect;
+    private executeInsert;
+    private executeUpdate;
+    private executeDelete;
+    private runStatements;
+    private executeStatement;
+    /** better-sqlite3 rejects booleans and undefined; coerce to its accepted set. */
+    private toBindable;
+    private normalizeConfig;
+    private initializeDatabase;
+    private getDatabase;
+    private ensureWritable;
+    private normalizeInsertBody;
+    private normalizeUpdateBody;
+    private normalizeRawParams;
+    private isMutatingSql;
+    private translateWithHandling;
+    private handleSqliteError;
+    /**
+     * Execute one or more SQL statements separated by semicolons (DDL/migrations).
+     */
+    execScript(sql: string): Promise<void>;
+    /**
+     * Run a sequence of writes atomically via BEGIN/COMMIT/ROLLBACK. The callback
+     * receives a tx facade with the same query/rawQuery/execScript shape. Nested
+     * transactions throw.
+     */
+    transaction<T>(fn: (tx: BetterSqlite3TransactionContext) => Promise<T>): Promise<T>;
+    /**
+     * Atomically claim up to `limit` rows matching `where`, apply `set`, return the
+     * updated rows. Concurrent calls are serialized through a promise chain so a
+     * second call waits for the first transaction to commit (avoids nested BEGIN).
+     */
+    claimRows<T = Record<string, unknown>>(opts: ClaimRowsOptions): Promise<T[]>;
+}
+//# sourceMappingURL=better-sqlite3-adapter.d.ts.map

package/dist/adapters/better-sqlite3-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"better-sqlite3-adapter.d.ts","sourceRoot":"","sources":["../../src/lib/adapters/better-sqlite3-adapter.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AA2BlD,MAAM,WAAW,+BAA+B;IAC9C,KAAK,EAAE,CACL,OAAO,EAAE,YAAY,EACrB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,EACpD,IAAI,CAAC,EAAE,OAAO,KACX,OAAO,CAAC,GAAG,CAAC,CAAA;IACjB,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;IACzE,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3C;AAED,qBAAa,oBAAqB,SAAQ,WAAY,YAAW,kBAAkB;IACjF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;IACnD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiC;IACjE,OAAO,CAAC,UAAU,CAAC,CAAwB;IAC3C,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,WAAW,CAAsC;gBAE7C,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM;IASlC,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC;IAIzB,KAAK,CACT,OAAO,EAAE,YAAY,EACrB,MAAM,GAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAgB,EAC3D,IAAI,CAAC,EAAE,OAAO,GACb,OAAO,CAAC,GAAG,CAAC;IA2BT,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,WAAW,GAAG;QAAE,MAAM,CAAC,EAAE,OAAO,EAAE,CAAA;KAAO,GAAG,OAAO,CAAC,GAAG,CAAC;YAe/E,aAAa;YAQb,aAAa;YAYb,aAAa;YASb,aAAa;IAU3B,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,gBAAgB;IAUxB,iFAAiF;IACjF,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,eAAe;YAYT,kBAAkB;YA8BlB,WAAW;IAMzB,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,mBAAmB;IAgB3B,OAAO,CAAC,mBAAmB;IAS3B,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,qBAAqB;IAW7B,OAAO,CAAC,iBAAiB;IAWzB;;OAEG;IACG,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5C;;;;OAIG;IACG,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,+BAA+B,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAiCzF;;;;OAIG;IACG,SAAS,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;CAoCnF"}