@bernierllc/database-adapter-core 1.0.0

package/dist/base/BaseMigrationManager.js

@@ -0,0 +1,113 @@
+"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.BaseMigrationManager = void 0;
+/**
+ * Base migration manager implementation
+ * Tracks and executes schema migrations
+ */
+class BaseMigrationManager {
+    constructor(adapter, migrations) {
+        this.adapter = adapter;
+        this.migrations = migrations;
+    }
+    /**
+     * Run all pending migrations
+     * @throws Error if any migration fails
+     */
+    async up() {
+        await this.ensureMigrationsTable();
+        const applied = await this.getAppliedMigrations();
+        const pending = this.migrations.filter(m => !applied.includes(m.id));
+        for (const migration of pending) {
+            const transaction = await this.adapter.beginTransaction();
+            try {
+                await migration.up(this.adapter);
+                await this.recordMigration(migration.id, migration.name);
+                await transaction.commit();
+            }
+            catch (error) {
+                await transaction.rollback();
+                const message = error instanceof Error ? error.message : String(error);
+                throw new Error(`Migration ${migration.name} failed: ${message}`);
+            }
+        }
+    }
+    /**
+     * Rollback last applied migration
+     * @throws Error if no migrations to rollback or rollback fails
+     */
+    async down() {
+        const applied = await this.getAppliedMigrations();
+        if (applied.length === 0) {
+            throw new Error('No migrations to rollback');
+        }
+        const lastMigrationId = applied[applied.length - 1];
+        const migration = this.migrations.find(m => m.id === lastMigrationId);
+        if (!migration) {
+            throw new Error(`Migration ${lastMigrationId} not found`);
+        }
+        const transaction = await this.adapter.beginTransaction();
+        try {
+            await migration.down(this.adapter);
+            await this.removeMigration(migration.id);
+            await transaction.commit();
+        }
+        catch (error) {
+            await transaction.rollback();
+            const message = error instanceof Error ? error.message : String(error);
+            throw new Error(`Rollback of ${migration.name} failed: ${message}`);
+        }
+    }
+    /**
+     * Get status of all migrations
+     */
+    async status() {
+        await this.ensureMigrationsTable();
+        const applied = await this.getAppliedMigrations();
+        return this.migrations.map(m => ({
+            id: m.id,
+            name: m.name,
+            appliedAt: applied.includes(m.id) ? new Date() : null,
+            status: applied.includes(m.id) ? 'applied' : 'pending'
+        }));
+    }
+    /**
+     * Ensure migrations table exists
+     */
+    async ensureMigrationsTable() {
+        await this.adapter.query(`
+      CREATE TABLE IF NOT EXISTS migrations (
+        id VARCHAR(255) PRIMARY KEY,
+        name VARCHAR(255) NOT NULL,
+        applied_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+      )
+    `);
+    }
+    /**
+     * Get list of applied migration IDs in order
+     */
+    async getAppliedMigrations() {
+        const result = await this.adapter.query('SELECT id FROM migrations ORDER BY applied_at ASC');
+        return result.rows.map(r => r.id);
+    }
+    /**
+     * Record a migration as applied
+     */
+    async recordMigration(id, name) {
+        await this.adapter.query('INSERT INTO migrations (id, name) VALUES ($1, $2)', [id, name]);
+    }
+    /**
+     * Remove a migration record
+     */
+    async removeMigration(id) {
+        await this.adapter.query('DELETE FROM migrations WHERE id = $1', [id]);
+    }
+}
+exports.BaseMigrationManager = BaseMigrationManager;

package/dist/base/BaseQueryBuilder.d.ts

@@ -0,0 +1,68 @@
+import { IQueryBuilder, IDatabaseAdapter, IQueryResult } from '../interfaces';
+/**
+ * Base query builder implementation
+ * Provides common functionality for all SQL dialects
+ * @template T - Type of entity being queried
+ */
+export declare abstract class BaseQueryBuilder<T = any> implements IQueryBuilder<T> {
+    protected _select: string[];
+    protected _from: string;
+    protected _where: string[];
+    protected _params: any[];
+    protected _orderBy: string[];
+    protected _limit?: number;
+    protected _offset?: number;
+    protected _joins: string[];
+    /**
+     * Select specific columns
+     */
+    select(...columns: string[]): IQueryBuilder<T>;
+    /**
+     * Specify table to query from
+     */
+    from(table: string): IQueryBuilder<T>;
+    /**
+     * Add WHERE condition with parameters
+     */
+    where(condition: string, params?: readonly unknown[]): IQueryBuilder<T>;
+    /**
+     * Add WHERE IN condition
+     */
+    whereIn(column: string, values: readonly unknown[]): IQueryBuilder<T>;
+    /**
+     * Add ORDER BY clause
+     */
+    orderBy(column: string, direction?: 'ASC' | 'DESC'): IQueryBuilder<T>;
+    /**
+     * Limit number of results
+     */
+    limit(count: number): IQueryBuilder<T>;
+    /**
+     * Offset results (skip rows)
+     */
+    offset(count: number): IQueryBuilder<T>;
+    /**
+     * Add INNER JOIN
+     */
+    join(table: string, condition: string): IQueryBuilder<T>;
+    /**
+     * Add LEFT JOIN
+     */
+    leftJoin(table: string, condition: string): IQueryBuilder<T>;
+    /**
+     * Execute the query using provided adapter
+     */
+    execute(adapter: IDatabaseAdapter): Promise<IQueryResult<T>>;
+    /**
+     * Abstract methods - MUST be implemented by dialect-specific builders
+     */
+    abstract insert(data: Partial<T>): IQueryBuilder<T>;
+    abstract insertMany(data: Partial<T>[]): IQueryBuilder<T>;
+    abstract update(data: Partial<T>): IQueryBuilder<T>;
+    abstract delete(): IQueryBuilder<T>;
+    abstract build(): {
+        sql: string;
+        params: any[];
+    };
+}
+//# sourceMappingURL=BaseQueryBuilder.d.ts.map

package/dist/base/BaseQueryBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseQueryBuilder.d.ts","sourceRoot":"","sources":["../../src/base/BaseQueryBuilder.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE9E;;;;GAIG;AACH,8BAAsB,gBAAgB,CAAC,CAAC,GAAG,GAAG,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IACzE,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,CAAM;IACjC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAM;IAC7B,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,CAAM;IAChC,SAAS,CAAC,OAAO,EAAE,GAAG,EAAE,CAAM;IAC9B,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAM;IAClC,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,CAAM;IAEhC;;OAEG;IACI,MAAM,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC;IAKrD;;OAEG;IACI,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC;IAK5C;;OAEG;IACI,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC;IAQ9E;;OAEG;IACI,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC;IAS5E;;OAEG;IACI,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,GAAE,KAAK,GAAG,MAAc,GAAG,aAAa,CAAC,CAAC,CAAC;IAKnF;;OAEG;IACI,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC;IAK7C;;OAEG;IACI,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC;IAK9C;;OAEG;IACI,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC;IAK/D;;OAEG;IACI,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC;IAKnE;;OAEG;IACU,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAKzE;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC;IACzD,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,MAAM,IAAI,aAAa,CAAC,CAAC,CAAC;IACnC,QAAQ,CAAC,KAAK,IAAI;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,GAAG,EAAE,CAAA;KAAE;CACjD"}

package/dist/base/BaseQueryBuilder.js

@@ -0,0 +1,103 @@
+"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.BaseQueryBuilder = void 0;
+/**
+ * Base query builder implementation
+ * Provides common functionality for all SQL dialects
+ * @template T - Type of entity being queried
+ */
+class BaseQueryBuilder {
+    constructor() {
+        this._select = [];
+        this._from = '';
+        this._where = [];
+        this._params = [];
+        this._orderBy = [];
+        this._joins = [];
+    }
+    /**
+     * Select specific columns
+     */
+    select(...columns) {
+        this._select.push(...columns);
+        return this;
+    }
+    /**
+     * Specify table to query from
+     */
+    from(table) {
+        this._from = table;
+        return this;
+    }
+    /**
+     * Add WHERE condition with parameters
+     */
+    where(condition, params) {
+        this._where.push(condition);
+        if (params) {
+            this._params.push(...params);
+        }
+        return this;
+    }
+    /**
+     * Add WHERE IN condition
+     */
+    whereIn(column, values) {
+        const placeholders = values
+            .map((_, i) => `$${this._params.length + i + 1}`)
+            .join(', ');
+        this._where.push(`${column} IN (${placeholders})`);
+        this._params.push(...values);
+        return this;
+    }
+    /**
+     * Add ORDER BY clause
+     */
+    orderBy(column, direction = 'ASC') {
+        this._orderBy.push(`${column} ${direction}`);
+        return this;
+    }
+    /**
+     * Limit number of results
+     */
+    limit(count) {
+        this._limit = count;
+        return this;
+    }
+    /**
+     * Offset results (skip rows)
+     */
+    offset(count) {
+        this._offset = count;
+        return this;
+    }
+    /**
+     * Add INNER JOIN
+     */
+    join(table, condition) {
+        this._joins.push(`JOIN ${table} ON ${condition}`);
+        return this;
+    }
+    /**
+     * Add LEFT JOIN
+     */
+    leftJoin(table, condition) {
+        this._joins.push(`LEFT JOIN ${table} ON ${condition}`);
+        return this;
+    }
+    /**
+     * Execute the query using provided adapter
+     */
+    async execute(adapter) {
+        const { sql, params } = this.build();
+        return adapter.query(sql, params);
+    }
+}
+exports.BaseQueryBuilder = BaseQueryBuilder;

package/dist/base/BaseTransaction.d.ts

@@ -0,0 +1,13 @@
+import { ITransaction, IQueryResult } from '../interfaces';
+/**
+ * Abstract transaction base class
+ * Provides base structure for transaction implementations
+ */
+export declare abstract class BaseTransaction implements ITransaction {
+    abstract id: string;
+    abstract query<T = any>(sql: string, params?: any[]): Promise<IQueryResult<T>>;
+    abstract commit(): Promise<void>;
+    abstract rollback(): Promise<void>;
+    abstract isActive(): boolean;
+}
+//# sourceMappingURL=BaseTransaction.d.ts.map

package/dist/base/BaseTransaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseTransaction.d.ts","sourceRoot":"","sources":["../../src/base/BaseTransaction.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE3D;;;GAGG;AACH,8BAAsB,eAAgB,YAAW,YAAY;IAC3D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC9E,QAAQ,CAAC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAChC,QAAQ,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAClC,QAAQ,CAAC,QAAQ,IAAI,OAAO;CAC7B"}

package/dist/base/BaseTransaction.js

@@ -0,0 +1,17 @@
+"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.BaseTransaction = void 0;
+/**
+ * Abstract transaction base class
+ * Provides base structure for transaction implementations
+ */
+class BaseTransaction {
+}
+exports.BaseTransaction = BaseTransaction;

package/dist/base/index.d.ts

@@ -0,0 +1,5 @@
+export * from './BaseDatabaseAdapter';
+export * from './BaseTransaction';
+export * from './BaseQueryBuilder';
+export * from './BaseMigrationManager';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/base/index.ts"],"names":[],"mappings":"AAQA,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC"}

package/dist/base/index.js

@@ -0,0 +1,27 @@
+"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("./BaseDatabaseAdapter"), exports);
+__exportStar(require("./BaseTransaction"), exports);
+__exportStar(require("./BaseQueryBuilder"), exports);
+__exportStar(require("./BaseMigrationManager"), exports);

package/dist/errors/ConnectionError.d.ts

@@ -0,0 +1,17 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,27 @@
+"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

@@ -0,0 +1,16 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,27 @@
+"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

@@ -0,0 +1,17 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,27 @@
+"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

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

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,26 @@
+"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);

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @bernierllc/database-adapter-core
+ *
+ * Abstract Database Interface for MECE Architecture
+ * Provides database-agnostic interfaces and base implementations for all database operations
+ */
+export * from './interfaces';
+export * from './base';
+export * from './rls';
+export * from './errors';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA;;;;;GAKG;AAGH,cAAc,cAAc,CAAC;AAG7B,cAAc,QAAQ,CAAC;AAGvB,cAAc,OAAO,CAAC;AAGtB,cAAc,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,37 @@
+"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 });
+/**
+ * @bernierllc/database-adapter-core
+ *
+ * Abstract Database Interface for MECE Architecture
+ * Provides database-agnostic interfaces and base implementations for all database operations
+ */
+// Interfaces
+__exportStar(require("./interfaces"), exports);
+// Base classes
+__exportStar(require("./base"), exports);
+// RLS support
+__exportStar(require("./rls"), exports);
+// Errors
+__exportStar(require("./errors"), exports);

package/dist/interfaces/IConnectionPool.d.ts

@@ -0,0 +1,41 @@
+import { IDatabaseAdapter } from './IDatabaseAdapter';
+/**
+ * Connection pool statistics
+ */
+export interface IPoolStats {
+    /** Total number of connections in pool */
+    totalConnections: number;
+    /** Number of active (in-use) connections */
+    activeConnections: number;
+    /** Number of idle (available) connections */
+    idleConnections: number;
+    /** Number of requests waiting for a connection */
+    waitingRequests: number;
+}
+/**
+ * Connection pool interface
+ * Manages database connection lifecycle
+ */
+export interface IConnectionPool {
+    /**
+     * Acquire a connection from the pool
+     * @returns Database adapter connection
+     * @throws Error if pool is exhausted or timeout occurs
+     */
+    acquire(): Promise<IDatabaseAdapter>;
+    /**
+     * Return a connection to the pool
+     * @param connection - Connection to release
+     */
+    release(connection: IDatabaseAdapter): Promise<void>;
+    /**
+     * Close all connections in the pool
+     */
+    closeAll(): Promise<void>;
+    /**
+     * Get pool statistics
+     * @returns Current pool statistics
+     */
+    stats(): IPoolStats;
+}
+//# sourceMappingURL=IConnectionPool.d.ts.map

package/dist/interfaces/IConnectionPool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IConnectionPool.d.ts","sourceRoot":"","sources":["../../src/interfaces/IConnectionPool.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,0CAA0C;IAC1C,gBAAgB,EAAE,MAAM,CAAC;IAEzB,4CAA4C;IAC5C,iBAAiB,EAAE,MAAM,CAAC;IAE1B,6CAA6C;IAC7C,eAAe,EAAE,MAAM,CAAC;IAExB,kDAAkD;IAClD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAErC;;;OAGG;IACH,OAAO,CAAC,UAAU,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErD;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B;;;OAGG;IACH,KAAK,IAAI,UAAU,CAAC;CACrB"}

package/dist/interfaces/IConnectionPool.js

@@ -0,0 +1,9 @@
+"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 });