@bernierllc/database-adapter-core 1.1.0 → 3.0.0

package/dist/base/BaseDatabaseAdapter.js

@@ -14,8 +14,9 @@ const errors_1 = require("../errors");
  * Provides common functionality for all implementations
  */
 class BaseDatabaseAdapter {
+    config;
+    connected = false;
     constructor(config) {
-        this.connected = false;
         this.config = config;
     }
     /**
@@ -30,7 +31,7 @@ class BaseDatabaseAdapter {
      */
     ensureConnected() {
         if (!this.connected) {
-            throw new errors_1.ConnectionError('Database not connected. Call connect() first.', 'NOT_CONNECTED');
+            throw new errors_1.ConnectionError('Database not connected. Call connect() first.', { context: { code: 'NOT_CONNECTED' } });
         }
     }
     /**

package/dist/base/BaseMigrationManager.js

@@ -13,6 +13,8 @@ exports.BaseMigrationManager = void 0;
  * Tracks and executes schema migrations
  */
 class BaseMigrationManager {
+    adapter;
+    migrations;
     constructor(adapter, migrations) {
         this.adapter = adapter;
         this.migrations = migrations;

package/dist/base/BaseQueryBuilder.js

@@ -14,14 +14,14 @@ exports.BaseQueryBuilder = void 0;
  * @template T - Type of entity being queried
  */
 class BaseQueryBuilder {
-    constructor() {
-        this._select = [];
-        this._from = '';
-        this._where = [];
-        this._params = [];
-        this._orderBy = [];
-        this._joins = [];
-    }
+    _select = [];
+    _from = '';
+    _where = [];
+    _params = [];
+    _orderBy = [];
+    _limit;
+    _offset;
+    _joins = [];
     /**
      * Select specific columns
      */

package/dist/errors.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Typed error code union for database-adapter-core errors.
+ */
+export type DatabaseAdapterCoreErrorCode = 'DATABASE_ERROR' | 'CONNECTION_ERROR' | 'QUERY_ERROR' | 'INVALID_INPUT' | 'OPERATION_FAILED';
+/**
+ * Options bag accepted by all database-adapter-core error classes.
+ *
+ * - `cause`: chained underlying error (ES2022 Error.cause).
+ * - `code`: a typed error code from {@link DatabaseAdapterCoreErrorCode}.
+ * - `context`: arbitrary structured context — host/port/query/params/etc.
+ */
+export interface DatabaseAdapterCoreErrorOptions {
+    cause?: Error;
+    code?: DatabaseAdapterCoreErrorCode;
+    context?: Record<string, unknown>;
+}
+/**
+ * Base database error class.
+ * All database-specific errors inherit from this.
+ *
+ * Uses native ES2022 `Error.cause` for error chaining — read the underlying
+ * error via `error.cause` (not `.originalError`, which was removed in 2.0.0).
+ */
+export declare class DatabaseError extends Error {
+    readonly code: DatabaseAdapterCoreErrorCode;
+    readonly context?: Record<string, unknown>;
+    constructor(message: string, options?: DatabaseAdapterCoreErrorOptions);
+}
+/**
+ * Connection-specific database error.
+ * Thrown when connection operations fail.
+ *
+ * Host/port and similar details should be passed via `options.context`.
+ */
+export declare class ConnectionError extends DatabaseError {
+    constructor(message: string, options?: Omit<DatabaseAdapterCoreErrorOptions, 'code'>);
+}
+/**
+ * Query-specific database error.
+ * Thrown when query execution fails.
+ *
+ * SQL/params and similar details should be passed via `options.context`.
+ */
+export declare class QueryError extends DatabaseError {
+    constructor(message: string, options?: Omit<DatabaseAdapterCoreErrorOptions, 'code'>);
+}
+/**
+ * Cross-package naming alias for {@link DatabaseError}.
+ * Useful when consuming code wants to disambiguate between several
+ * package-specific base error classes via a fully qualified name.
+ */
+export { DatabaseError as DatabaseAdapterCoreError };
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,MAAM,MAAM,4BAA4B,GACpC,gBAAgB,GAChB,kBAAkB,GAClB,aAAa,GACb,eAAe,GACf,kBAAkB,CAAC;AAEvB;;;;;;GAMG;AACH,MAAM,WAAW,+BAA+B;IAC9C,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,IAAI,CAAC,EAAE,4BAA4B,CAAC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;;GAMG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,SAAgB,IAAI,EAAE,4BAA4B,CAAC;IACnD,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEtC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,+BAA+B;CASvE;AAED;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,aAAa;gBAE9C,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,IAAI,CAAC,+BAA+B,EAAE,MAAM,CAAC;CAK1D;AAED;;;;;GAKG;AACH,qBAAa,UAAW,SAAQ,aAAa;gBAEzC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,IAAI,CAAC,+BAA+B,EAAE,MAAM,CAAC;CAK1D;AAED;;;;GAIG;AACH,OAAO,EAAE,aAAa,IAAI,wBAAwB,EAAE,CAAC"}

package/dist/errors.js

@@ -0,0 +1,58 @@
+"use strict";
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DatabaseAdapterCoreError = exports.QueryError = exports.ConnectionError = exports.DatabaseError = void 0;
+/**
+ * Base database error class.
+ * All database-specific errors inherit from this.
+ *
+ * Uses native ES2022 `Error.cause` for error chaining — read the underlying
+ * error via `error.cause` (not `.originalError`, which was removed in 2.0.0).
+ */
+class DatabaseError extends Error {
+    code;
+    context;
+    constructor(message, options) {
+        super(message, options?.cause ? { cause: options.cause } : undefined);
+        this.name = 'DatabaseError';
+        this.code = options?.code ?? 'DATABASE_ERROR';
+        if (options?.context !== undefined) {
+            this.context = options.context;
+        }
+        Error.captureStackTrace?.(this, this.constructor);
+    }
+}
+exports.DatabaseError = DatabaseError;
+exports.DatabaseAdapterCoreError = DatabaseError;
+/**
+ * Connection-specific database error.
+ * Thrown when connection operations fail.
+ *
+ * Host/port and similar details should be passed via `options.context`.
+ */
+class ConnectionError extends DatabaseError {
+    constructor(message, options) {
+        super(message, { ...options, code: 'CONNECTION_ERROR' });
+        this.name = 'ConnectionError';
+    }
+}
+exports.ConnectionError = ConnectionError;
+/**
+ * Query-specific database error.
+ * Thrown when query execution fails.
+ *
+ * SQL/params and similar details should be passed via `options.context`.
+ */
+class QueryError extends DatabaseError {
+    constructor(message, options) {
+        super(message, { ...options, code: 'QUERY_ERROR' });
+        this.name = 'QueryError';
+    }
+}
+exports.QueryError = QueryError;

package/dist/rls/RLSContextManager.js

@@ -13,9 +13,7 @@ exports.RLSContextManager = void 0;
  * Enables multi-tenant security and user-based access control
  */
 class RLSContextManager {
-    constructor() {
-        this.context = null;
-    }
+    context = null;
     /**
      * Set RLS context for current operation
      * Context is scoped to this manager instance

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bernierllc/database-adapter-core",
-  "version": "1.1.0",
+  "version": "3.0.0",
   "description": "Abstract Database Interface for MECE Architecture - provides database-agnostic interfaces and base implementations for all database operations",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -19,8 +19,8 @@
   "author": "Bernier LLC",
   "license": "UNLICENSED",
   "dependencies": {
-    "@bernierllc/crypto-utils": "1.3.0",
-    "@bernierllc/logger": "1.6.0"
+    "@bernierllc/crypto-utils": "1.4.0",
+    "@bernierllc/logger": "1.7.0"
   },
   "devDependencies": {
     "@types/jest": "^29.5.0",
@@ -38,7 +38,7 @@
     "directory": "packages/core/database-adapter-core"
   },
   "files": [
-    "dist",
+    "dist/**/*",
     "README.md"
   ],
   "publishConfig": {

package/dist/errors/ConnectionError.d.ts

@@ -1,17 +0,0 @@
-import { DatabaseError } from './DatabaseError';
-/**
- * Connection-specific database error
- * Thrown when connection operations fail
- */
-export declare class ConnectionError extends DatabaseError {
-    /**
-     * Host that failed to connect
-     */
-    readonly host?: string;
-    /**
-     * Port that failed to connect
-     */
-    readonly port?: number;
-    constructor(message: string, code?: string, originalError?: Error, host?: string, port?: number);
-}
-//# sourceMappingURL=ConnectionError.d.ts.map

package/dist/errors/ConnectionError.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ConnectionError.d.ts","sourceRoot":"","sources":["../../src/errors/ConnectionError.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,aAAa;IAChD;;OAEG;IACH,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;gBAG5B,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,KAAK,EACrB,IAAI,CAAC,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM;CAWhB"}

package/dist/errors/ConnectionError.js

@@ -1,27 +0,0 @@
-"use strict";
-/*
-Copyright (c) 2025 Bernier LLC
-
-This file is licensed to the client under a limited-use license.
-The client may use and modify this code *only within the scope of the project it was delivered for*.
-Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
-*/
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ConnectionError = void 0;
-const DatabaseError_1 = require("./DatabaseError");
-/**
- * Connection-specific database error
- * Thrown when connection operations fail
- */
-class ConnectionError extends DatabaseError_1.DatabaseError {
-    constructor(message, code, originalError, host, port) {
-        super(message, code, originalError);
-        this.name = 'ConnectionError';
-        this.host = host;
-        this.port = port;
-        if (Error.captureStackTrace) {
-            Error.captureStackTrace(this, ConnectionError);
-        }
-    }
-}
-exports.ConnectionError = ConnectionError;

package/dist/errors/DatabaseError.d.ts

@@ -1,16 +0,0 @@
-/**
- * Base database error class
- * All database-specific errors inherit from this
- */
-export declare class DatabaseError extends Error {
-    /**
-     * Error code (database-specific)
-     */
-    readonly code?: string;
-    /**
-     * Original error if wrapped
-     */
-    readonly originalError?: Error;
-    constructor(message: string, code?: string, originalError?: Error);
-}
-//# sourceMappingURL=DatabaseError.d.ts.map

package/dist/errors/DatabaseError.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"DatabaseError.d.ts","sourceRoot":"","sources":["../../src/errors/DatabaseError.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC;;OAEG;IACH,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,SAAgB,aAAa,CAAC,EAAE,KAAK,CAAC;gBAE1B,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,KAAK;CAWlE"}

package/dist/errors/DatabaseError.js

@@ -1,27 +0,0 @@
-"use strict";
-/*
-Copyright (c) 2025 Bernier LLC
-
-This file is licensed to the client under a limited-use license.
-The client may use and modify this code *only within the scope of the project it was delivered for*.
-Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
-*/
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DatabaseError = void 0;
-/**
- * Base database error class
- * All database-specific errors inherit from this
- */
-class DatabaseError extends Error {
-    constructor(message, code, originalError) {
-        super(message);
-        this.name = 'DatabaseError';
-        this.code = code;
-        this.originalError = originalError;
-        // Maintain proper stack trace in V8 environments
-        if (Error.captureStackTrace) {
-            Error.captureStackTrace(this, DatabaseError);
-        }
-    }
-}
-exports.DatabaseError = DatabaseError;

package/dist/errors/QueryError.d.ts

@@ -1,17 +0,0 @@
-import { DatabaseError } from './DatabaseError';
-/**
- * Query-specific database error
- * Thrown when query execution fails
- */
-export declare class QueryError extends DatabaseError {
-    /**
-     * SQL query that failed
-     */
-    readonly query?: string;
-    /**
-     * Query parameters
-     */
-    readonly params?: any[];
-    constructor(message: string, code?: string, originalError?: Error, query?: string, params?: any[]);
-}
-//# sourceMappingURL=QueryError.d.ts.map

package/dist/errors/QueryError.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"QueryError.d.ts","sourceRoot":"","sources":["../../src/errors/QueryError.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;GAGG;AACH,qBAAa,UAAW,SAAQ,aAAa;IAC3C;;OAEG;IACH,SAAgB,KAAK,CAAC,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,SAAgB,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;gBAG7B,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,KAAK,EACrB,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,GAAG,EAAE;CAWjB"}

package/dist/errors/QueryError.js

@@ -1,27 +0,0 @@
-"use strict";
-/*
-Copyright (c) 2025 Bernier LLC
-
-This file is licensed to the client under a limited-use license.
-The client may use and modify this code *only within the scope of the project it was delivered for*.
-Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
-*/
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.QueryError = void 0;
-const DatabaseError_1 = require("./DatabaseError");
-/**
- * Query-specific database error
- * Thrown when query execution fails
- */
-class QueryError extends DatabaseError_1.DatabaseError {
-    constructor(message, code, originalError, query, params) {
-        super(message, code, originalError);
-        this.name = 'QueryError';
-        this.query = query;
-        this.params = params;
-        if (Error.captureStackTrace) {
-            Error.captureStackTrace(this, QueryError);
-        }
-    }
-}
-exports.QueryError = QueryError;

package/dist/errors/index.d.ts

@@ -1,4 +0,0 @@
-export * from './DatabaseError';
-export * from './ConnectionError';
-export * from './QueryError';
-//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAQA,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC"}

package/dist/errors/index.js

@@ -1,26 +0,0 @@
-"use strict";
-/*
-Copyright (c) 2025 Bernier LLC
-
-This file is licensed to the client under a limited-use license.
-The client may use and modify this code *only within the scope of the project it was delivered for*.
-Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
-*/
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./DatabaseError"), exports);
-__exportStar(require("./ConnectionError"), exports);
-__exportStar(require("./QueryError"), exports);