@bernierllc/database-adapter-postgresql 1.5.1 → 1.5.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bernierllc/database-adapter-postgresql",
-  "version": "1.5.1",
+  "version": "1.5.3",
   "description": "PostgreSQL/Supabase Database Adapter Implementation with RLS, real-time subscriptions, and full-text search",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -20,9 +20,9 @@
     "@supabase/supabase-js": "^2.38.0",
     "pg": "^8.11.0",
     "@bernierllc/crypto-utils": "1.4.0",
-    "@bernierllc/logger": "1.7.0",
-    "@bernierllc/retry-policy": "0.7.0",
-    "@bernierllc/database-adapter-core": "3.0.0"
+    "@bernierllc/database-adapter-core": "3.0.2",
+    "@bernierllc/logger": "2.0.0",
+    "@bernierllc/retry-policy": "0.7.0"
   },
   "devDependencies": {
     "@types/jest": "^29.0.0",

package/dist/PostgreSQLAdapter.d.ts

@@ -1,65 +0,0 @@
-import { SupabaseClient } from '@supabase/supabase-js';
-import { BaseDatabaseAdapter, IDatabaseConfig, IDatabaseHealth, IQueryResult, ITransaction } from '@bernierllc/database-adapter-core';
-/**
- * Supabase-specific configuration
- */
-export interface ISupabaseConfig {
-    supabaseUrl?: string;
-    supabaseAnonKey?: string;
-    supabaseServiceKey?: string;
-}
-/**
- * PostgreSQL database adapter with Supabase support
- * Implements connection pooling, RLS, and real-time features
- */
-export declare class PostgreSQLAdapter extends BaseDatabaseAdapter {
-    private pool;
-    private supabase;
-    private rlsManager;
-    private logger;
-    constructor(config: IDatabaseConfig & ISupabaseConfig);
-    /**
-     * Connect to PostgreSQL with connection pooling
-     */
-    connect(): Promise<void>;
-    /**
-     * Disconnect and close pool
-     */
-    disconnect(): Promise<void>;
-    /**
-     * Execute query with RLS context
-     */
-    query<T = unknown>(sql: string, params?: unknown[]): Promise<IQueryResult<T>>;
-    /**
-     * Begin transaction with RLS context
-     */
-    beginTransaction(): Promise<ITransaction>;
-    /**
-     * Health check with connection pool stats
-     */
-    healthCheck(): Promise<IDatabaseHealth>;
-    /**
-     * Get Supabase client for real-time features
-     */
-    getSupabaseClient(): SupabaseClient | null;
-    /**
-     * Set RLS context for current operation
-     */
-    setRLSContext(userId: string, userRole: string, tenantId?: string): void;
-    /**
-     * Clear RLS context
-     */
-    clearRLSContext(): void;
-    /**
-     * Get current connection pool statistics
-     */
-    getPoolStats(): {
-        total: number;
-        idle: number;
-        waiting: number;
-    } | null;
-    /**
-     * Map PostgreSQL data type OID to name
-     */
-    private getDataTypeName;
-}

package/dist/PostgreSQLAdapter.js

@@ -1,254 +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.PostgreSQLAdapter = void 0;
-const pg_1 = require("pg");
-const supabase_js_1 = require("@supabase/supabase-js");
-const database_adapter_core_1 = require("@bernierllc/database-adapter-core");
-const retry_policy_1 = require("@bernierllc/retry-policy");
-const logger_1 = require("@bernierllc/logger");
-const PostgreSQLTransaction_1 = require("./PostgreSQLTransaction");
-/**
- * PostgreSQL database adapter with Supabase support
- * Implements connection pooling, RLS, and real-time features
- */
-class PostgreSQLAdapter extends database_adapter_core_1.BaseDatabaseAdapter {
-    pool = null;
-    supabase = null;
-    rlsManager;
-    logger;
-    constructor(config) {
-        super(config);
-        this.rlsManager = new database_adapter_core_1.RLSContextManager();
-        this.logger = (0, logger_1.createLogger)({ context: { component: 'PostgreSQLAdapter' } });
-        // Initialize Supabase client if configured
-        if (config.supabaseUrl && config.supabaseAnonKey) {
-            this.supabase = (0, supabase_js_1.createClient)(config.supabaseUrl, config.supabaseAnonKey, {
-                auth: {
-                    autoRefreshToken: true,
-                    persistSession: true,
-                    detectSessionInUrl: false
-                }
-            });
-        }
-    }
-    /**
-     * Connect to PostgreSQL with connection pooling
-     */
-    async connect() {
-        if (this.connected)
-            return;
-        this.pool = new pg_1.Pool({
-            host: this.config.host,
-            port: this.config.port || 5432,
-            database: this.config.database,
-            user: this.config.username,
-            password: this.config.password,
-            ssl: this.config.ssl,
-            min: this.config.pooling?.min || 2,
-            max: this.config.pooling?.max || 10,
-            idleTimeoutMillis: this.config.pooling?.idleTimeoutMs || 30000,
-            connectionTimeoutMillis: this.config.connectionTimeoutMs || 5000
-        });
-        // Test connection with retry
-        let attempt = 0;
-        const maxRetries = 3;
-        while (attempt < maxRetries) {
-            try {
-                const client = await this.pool.connect();
-                await client.query('SELECT NOW()');
-                client.release();
-                this.connected = true;
-                this.logger.info('PostgreSQL connection established', {
-                    database: this.config.database,
-                    host: this.config.host,
-                    poolMin: this.config.pooling?.min || 2,
-                    poolMax: this.config.pooling?.max || 10
-                });
-                return;
-            }
-            catch (error) {
-                attempt++;
-                if ((0, retry_policy_1.shouldRetry)(attempt, error, { maxRetries })) {
-                    const delay = (0, retry_policy_1.calculateRetryDelay)(attempt, {
-                        initialDelayMs: 1000,
-                        maxDelayMs: 5000,
-                        jitter: true
-                    });
-                    this.logger.warn('PostgreSQL connection failed, retrying', {
-                        attempt,
-                        maxRetries,
-                        delayMs: delay,
-                        error: this.sanitizeError(error)
-                    });
-                    await new Promise(resolve => setTimeout(resolve, delay));
-                }
-                else {
-                    throw this.sanitizeError(error);
-                }
-            }
-        }
-        throw new Error('Failed to connect to PostgreSQL after retries');
-    }
-    /**
-     * Disconnect and close pool
-     */
-    async disconnect() {
-        if (!this.pool)
-            return;
-        await this.pool.end();
-        this.pool = null;
-        this.connected = false;
-        this.logger.info('PostgreSQL connection closed');
-    }
-    /**
-     * Execute query with RLS context
-     */
-    async query(sql, params) {
-        this.ensureConnected();
-        const startTime = Date.now();
-        const client = await this.pool.connect();
-        try {
-            // Set RLS context if available
-            const rlsStatements = this.rlsManager.generateRLSStatements();
-            for (const stmt of rlsStatements) {
-                await client.query(stmt);
-            }
-            // Execute query
-            const result = await client.query(sql, params);
-            const duration = Date.now() - startTime;
-            this.logger.debug('Query executed', {
-                duration,
-                rowCount: result.rowCount,
-                command: result.command
-            });
-            return {
-                rows: result.rows,
-                rowCount: result.rowCount || 0,
-                fields: result.fields.map(f => ({
-                    name: f.name,
-                    dataTypeID: f.dataTypeID,
-                    dataTypeName: this.getDataTypeName(f.dataTypeID),
-                    nullable: true // PostgreSQL doesn't expose this easily
-                })),
-                command: result.command
-            };
-        }
-        catch (error) {
-            const sanitized = this.sanitizeError(error);
-            this.logger.error('Query execution failed', sanitized, {
-                duration: Date.now() - startTime
-            });
-            throw sanitized;
-        }
-        finally {
-            client.release();
-        }
-    }
-    /**
-     * Begin transaction with RLS context
-     */
-    async beginTransaction() {
-        this.ensureConnected();
-        const client = await this.pool.connect();
-        // Set RLS context for transaction
-        const rlsStatements = this.rlsManager.generateRLSStatements();
-        for (const stmt of rlsStatements) {
-            await client.query(stmt);
-        }
-        await client.query('BEGIN');
-        this.logger.debug('Transaction started');
-        return new PostgreSQLTransaction_1.PostgreSQLTransaction(client, this.rlsManager, this.logger);
-    }
-    /**
-     * Health check with connection pool stats
-     */
-    async healthCheck() {
-        if (!this.connected || !this.pool) {
-            return {
-                connected: false,
-                latencyMs: -1,
-                version: 'unknown'
-            };
-        }
-        const start = Date.now();
-        try {
-            const result = await this.pool.query('SELECT version()');
-            const latencyMs = Date.now() - start;
-            return {
-                connected: true,
-                latencyMs,
-                version: result.rows[0].version,
-                activeConnections: this.pool.totalCount,
-                maxConnections: this.pool.options.max
-            };
-        }
-        catch (error) {
-            const sanitized = this.sanitizeError(error);
-            this.logger.error('Health check failed', sanitized);
-            return {
-                connected: false,
-                latencyMs: -1,
-                version: 'error'
-            };
-        }
-    }
-    /**
-     * Get Supabase client for real-time features
-     */
-    getSupabaseClient() {
-        return this.supabase;
-    }
-    /**
-     * Set RLS context for current operation
-     */
-    setRLSContext(userId, userRole, tenantId) {
-        this.rlsManager.setContext({ userId, userRole, tenantId });
-        this.logger.debug('RLS context set', { userId, userRole, tenantId });
-    }
-    /**
-     * Clear RLS context
-     */
-    clearRLSContext() {
-        this.rlsManager.clearContext();
-        this.logger.debug('RLS context cleared');
-    }
-    /**
-     * Get current connection pool statistics
-     */
-    getPoolStats() {
-        if (!this.pool)
-            return null;
-        return {
-            total: this.pool.totalCount,
-            idle: this.pool.idleCount,
-            waiting: this.pool.waitingCount
-        };
-    }
-    /**
-     * Map PostgreSQL data type OID to name
-     */
-    getDataTypeName(oid) {
-        const typeMap = {
-            16: 'BOOL',
-            20: 'BIGINT',
-            21: 'SMALLINT',
-            23: 'INTEGER',
-            25: 'TEXT',
-            114: 'JSON',
-            1043: 'VARCHAR',
-            1082: 'DATE',
-            1114: 'TIMESTAMP',
-            1184: 'TIMESTAMPTZ',
-            3802: 'JSONB'
-        };
-        return typeMap[oid] || 'UNKNOWN';
-    }
-}
-exports.PostgreSQLAdapter = PostgreSQLAdapter;

package/dist/PostgreSQLTransaction.d.ts

@@ -1,46 +0,0 @@
-import { PoolClient } from 'pg';
-import { ITransaction, IQueryResult, RLSContextManager } from '@bernierllc/database-adapter-core';
-import { Logger } from '@bernierllc/logger';
-/**
- * PostgreSQL transaction implementation with RLS context support
- */
-export declare class PostgreSQLTransaction implements ITransaction {
-    private client;
-    private _rlsManager;
-    id: string;
-    private active;
-    private logger?;
-    constructor(client: PoolClient, _rlsManager: RLSContextManager, logger?: Logger);
-    /**
-     * Execute query within transaction
-     */
-    query<T = unknown>(sql: string, params?: unknown[]): Promise<IQueryResult<T>>;
-    /**
-     * Commit transaction and release client
-     */
-    commit(): Promise<void>;
-    /**
-     * Rollback transaction and release client
-     */
-    rollback(): Promise<void>;
-    /**
-     * Create a savepoint within the transaction
-     */
-    savepoint(name: string): Promise<void>;
-    /**
-     * Rollback to a savepoint
-     */
-    rollbackToSavepoint(name: string): Promise<void>;
-    /**
-     * Release a savepoint
-     */
-    releaseSavepoint(name: string): Promise<void>;
-    /**
-     * Check if transaction is still active
-     */
-    isActive(): boolean;
-    /**
-     * Map PostgreSQL data type OID to name
-     */
-    private getDataTypeName;
-}

package/dist/PostgreSQLTransaction.js

@@ -1,203 +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.PostgreSQLTransaction = void 0;
-/**
- * PostgreSQL transaction implementation with RLS context support
- */
-class PostgreSQLTransaction {
-    client;
-    _rlsManager;
-    id;
-    active = true;
-    logger;
-    constructor(client, 
-    // @ts-expect-error - Reserved for future RLS context support in transactions
-    _rlsManager, logger) {
-        this.client = client;
-        this._rlsManager = _rlsManager;
-        this.id = `txn_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
-        this.logger = logger;
-        if (this.logger) {
-            this.logger.debug('Transaction created', { id: this.id });
-        }
-    }
-    /**
-     * Execute query within transaction
-     */
-    async query(sql, params) {
-        if (!this.active) {
-            throw new Error('Transaction is not active');
-        }
-        const startTime = Date.now();
-        try {
-            const result = await this.client.query(sql, params);
-            const duration = Date.now() - startTime;
-            if (this.logger) {
-                this.logger.debug('Transaction query executed', {
-                    transactionId: this.id,
-                    duration,
-                    rowCount: result.rowCount,
-                    command: result.command
-                });
-            }
-            return {
-                rows: result.rows,
-                rowCount: result.rowCount || 0,
-                fields: result.fields.map(f => ({
-                    name: f.name,
-                    dataTypeID: f.dataTypeID,
-                    dataTypeName: this.getDataTypeName(f.dataTypeID),
-                    nullable: true
-                })),
-                command: result.command
-            };
-        }
-        catch (error) {
-            if (this.logger) {
-                this.logger.error('Transaction query failed', error instanceof Error ? error : new Error(String(error)), {
-                    transactionId: this.id,
-                    duration: Date.now() - startTime
-                });
-            }
-            throw error;
-        }
-    }
-    /**
-     * Commit transaction and release client
-     */
-    async commit() {
-        if (!this.active) {
-            throw new Error('Transaction is not active');
-        }
-        const startTime = Date.now();
-        try {
-            await this.client.query('COMMIT');
-            this.active = false;
-            if (this.logger) {
-                this.logger.debug('Transaction committed', {
-                    transactionId: this.id,
-                    duration: Date.now() - startTime
-                });
-            }
-        }
-        catch (error) {
-            if (this.logger) {
-                this.logger.error('Transaction commit failed', error instanceof Error ? error : new Error(String(error)), {
-                    transactionId: this.id
-                });
-            }
-            throw error;
-        }
-        finally {
-            this.client.release();
-        }
-    }
-    /**
-     * Rollback transaction and release client
-     */
-    async rollback() {
-        if (!this.active) {
-            throw new Error('Transaction is not active');
-        }
-        const startTime = Date.now();
-        try {
-            await this.client.query('ROLLBACK');
-            this.active = false;
-            if (this.logger) {
-                this.logger.debug('Transaction rolled back', {
-                    transactionId: this.id,
-                    duration: Date.now() - startTime
-                });
-            }
-        }
-        catch (error) {
-            if (this.logger) {
-                this.logger.error('Transaction rollback failed', error instanceof Error ? error : new Error(String(error)), {
-                    transactionId: this.id
-                });
-            }
-            throw error;
-        }
-        finally {
-            this.client.release();
-        }
-    }
-    /**
-     * Create a savepoint within the transaction
-     */
-    async savepoint(name) {
-        if (!this.active) {
-            throw new Error('Transaction is not active');
-        }
-        await this.client.query(`SAVEPOINT ${name}`);
-        if (this.logger) {
-            this.logger.debug('Savepoint created', {
-                transactionId: this.id,
-                savepoint: name
-            });
-        }
-    }
-    /**
-     * Rollback to a savepoint
-     */
-    async rollbackToSavepoint(name) {
-        if (!this.active) {
-            throw new Error('Transaction is not active');
-        }
-        await this.client.query(`ROLLBACK TO SAVEPOINT ${name}`);
-        if (this.logger) {
-            this.logger.debug('Rolled back to savepoint', {
-                transactionId: this.id,
-                savepoint: name
-            });
-        }
-    }
-    /**
-     * Release a savepoint
-     */
-    async releaseSavepoint(name) {
-        if (!this.active) {
-            throw new Error('Transaction is not active');
-        }
-        await this.client.query(`RELEASE SAVEPOINT ${name}`);
-        if (this.logger) {
-            this.logger.debug('Savepoint released', {
-                transactionId: this.id,
-                savepoint: name
-            });
-        }
-    }
-    /**
-     * Check if transaction is still active
-     */
-    isActive() {
-        return this.active;
-    }
-    /**
-     * Map PostgreSQL data type OID to name
-     */
-    getDataTypeName(oid) {
-        const typeMap = {
-            16: 'BOOL',
-            20: 'BIGINT',
-            21: 'SMALLINT',
-            23: 'INTEGER',
-            25: 'TEXT',
-            114: 'JSON',
-            1043: 'VARCHAR',
-            1082: 'DATE',
-            1114: 'TIMESTAMP',
-            1184: 'TIMESTAMPTZ',
-            3802: 'JSONB'
-        };
-        return typeMap[oid] || 'UNKNOWN';
-    }
-}
-exports.PostgreSQLTransaction = PostgreSQLTransaction;

package/dist/errors.d.ts

@@ -1,11 +0,0 @@
-export type DatabaseAdapterPostgresqlErrorCode = 'DATABASE_ADAPTER_POSTGRESQL_ERROR' | 'INVALID_INPUT' | 'OPERATION_FAILED';
-export interface DatabaseAdapterPostgresqlErrorOptions {
-    cause?: Error;
-    code?: DatabaseAdapterPostgresqlErrorCode;
-    context?: Record<string, unknown>;
-}
-export declare class DatabaseAdapterPostgresqlError extends Error {
-    readonly code: DatabaseAdapterPostgresqlErrorCode;
-    readonly context?: Record<string, unknown>;
-    constructor(message: string, options?: DatabaseAdapterPostgresqlErrorOptions);
-}

package/dist/errors.js

@@ -1,24 +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.DatabaseAdapterPostgresqlError = void 0;
-class DatabaseAdapterPostgresqlError extends Error {
-    code;
-    context;
-    constructor(message, options) {
-        super(message, options?.cause ? { cause: options.cause } : undefined);
-        this.name = 'DatabaseAdapterPostgresqlError';
-        this.code = options?.code ?? 'DATABASE_ADAPTER_POSTGRESQL_ERROR';
-        if (options?.context !== undefined) {
-            this.context = options.context;
-        }
-        Error.captureStackTrace?.(this, this.constructor);
-    }
-}
-exports.DatabaseAdapterPostgresqlError = DatabaseAdapterPostgresqlError;

package/dist/index.d.ts

@@ -1,8 +0,0 @@
-export { DatabaseAdapterPostgresqlError, type DatabaseAdapterPostgresqlErrorCode, type DatabaseAdapterPostgresqlErrorOptions, } from './errors';
-export { PostgreSQLAdapter, ISupabaseConfig } from './PostgreSQLAdapter';
-export { PostgreSQLTransaction } from './PostgreSQLTransaction';
-export { RLSPolicyGenerator } from './rls/RLSPolicyGenerator';
-export { ClerkIntegration } from './rls/ClerkIntegration';
-export { RealtimeManager, RealtimePayload, RealtimeCallbacks, PresenceData } from './realtime/RealtimeManager';
-export { FullTextSearchManager, SearchResult, SearchOptions } from './search/FullTextSearchManager';
-export { migration_001_initial_schema } from './migrations/001_initial_schema';

package/dist/index.js

@@ -1,32 +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.migration_001_initial_schema = exports.FullTextSearchManager = exports.RealtimeManager = exports.ClerkIntegration = exports.RLSPolicyGenerator = exports.PostgreSQLTransaction = exports.PostgreSQLAdapter = exports.DatabaseAdapterPostgresqlError = void 0;
-// Errors
-var errors_1 = require("./errors");
-Object.defineProperty(exports, "DatabaseAdapterPostgresqlError", { enumerable: true, get: function () { return errors_1.DatabaseAdapterPostgresqlError; } });
-// Main adapter
-var PostgreSQLAdapter_1 = require("./PostgreSQLAdapter");
-Object.defineProperty(exports, "PostgreSQLAdapter", { enumerable: true, get: function () { return PostgreSQLAdapter_1.PostgreSQLAdapter; } });
-var PostgreSQLTransaction_1 = require("./PostgreSQLTransaction");
-Object.defineProperty(exports, "PostgreSQLTransaction", { enumerable: true, get: function () { return PostgreSQLTransaction_1.PostgreSQLTransaction; } });
-// RLS components
-var RLSPolicyGenerator_1 = require("./rls/RLSPolicyGenerator");
-Object.defineProperty(exports, "RLSPolicyGenerator", { enumerable: true, get: function () { return RLSPolicyGenerator_1.RLSPolicyGenerator; } });
-var ClerkIntegration_1 = require("./rls/ClerkIntegration");
-Object.defineProperty(exports, "ClerkIntegration", { enumerable: true, get: function () { return ClerkIntegration_1.ClerkIntegration; } });
-// Real-time
-var RealtimeManager_1 = require("./realtime/RealtimeManager");
-Object.defineProperty(exports, "RealtimeManager", { enumerable: true, get: function () { return RealtimeManager_1.RealtimeManager; } });
-// Search
-var FullTextSearchManager_1 = require("./search/FullTextSearchManager");
-Object.defineProperty(exports, "FullTextSearchManager", { enumerable: true, get: function () { return FullTextSearchManager_1.FullTextSearchManager; } });
-// Migrations
-var _001_initial_schema_1 = require("./migrations/001_initial_schema");
-Object.defineProperty(exports, "migration_001_initial_schema", { enumerable: true, get: function () { return _001_initial_schema_1.migration_001_initial_schema; } });

package/dist/migrations/001_initial_schema.d.ts

@@ -1,2 +0,0 @@
-import { IMigration } from '@bernierllc/database-adapter-core';
-export declare const migration_001_initial_schema: IMigration;