@bernierllc/database-adapter-core 1.0.0

package/dist/interfaces/IDatabaseAdapter.d.ts

@@ -0,0 +1,45 @@
+import { ITransaction } from './ITransaction';
+import { IQueryResult } from './IQueryResult';
+import { IDatabaseHealth } from './IDatabaseHealth';
+/**
+ * Abstract database adapter interface
+ * All concrete database adapters MUST implement this interface
+ */
+export interface IDatabaseAdapter {
+    /**
+     * Connect to database
+     * @throws ConnectionError if connection fails
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from database
+     * @throws Error if disconnection fails
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Check if database is connected
+     * @returns true if connected
+     */
+    isConnected(): boolean;
+    /**
+     * Begin a new transaction
+     * @returns Transaction instance
+     * @throws Error if not connected or transaction creation fails
+     */
+    beginTransaction(): Promise<ITransaction>;
+    /**
+     * Execute a query
+     * @template T - Type of rows returned
+     * @param sql - SQL query string
+     * @param params - Query parameters
+     * @returns Query result with rows and metadata
+     * @throws QueryError if query fails
+     */
+    query<T = any>(sql: string, params?: any[]): Promise<IQueryResult<T>>;
+    /**
+     * Check database health
+     * @returns Health status including connection state, latency, and version
+     */
+    healthCheck(): Promise<IDatabaseHealth>;
+}
+//# sourceMappingURL=IDatabaseAdapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IDatabaseAdapter.d.ts","sourceRoot":"","sources":["../../src/interfaces/IDatabaseAdapter.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB;;;OAGG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;;OAGG;IACH,WAAW,IAAI,OAAO,CAAC;IAEvB;;;;OAIG;IACH,gBAAgB,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IAE1C;;;;;;;OAOG;IACH,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAEtE;;;OAGG;IACH,WAAW,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;CACzC"}

package/dist/interfaces/IDatabaseAdapter.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 });

package/dist/interfaces/IDatabaseConfig.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Database connection configuration
+ */
+export interface IDatabaseConfig {
+    /** Database type */
+    type: 'postgresql' | 'mysql' | 'sqlite' | 'mssql';
+    /** Host address (not required for SQLite) */
+    host?: string;
+    /** Port number (not required for SQLite) */
+    port?: number;
+    /** Database name or file path (for SQLite) */
+    database: string;
+    /** Username for authentication */
+    username?: string;
+    /** Password for authentication */
+    password?: string;
+    /** SSL configuration */
+    ssl?: boolean | {
+        /** CA certificate */
+        ca?: string;
+        /** Client certificate */
+        cert?: string;
+        /** Client key */
+        key?: string;
+    };
+    /** Connection pooling configuration */
+    pooling?: {
+        /** Minimum number of connections in pool */
+        min: number;
+        /** Maximum number of connections in pool */
+        max: number;
+        /** Time in ms before idle connection is closed */
+        idleTimeoutMs: number;
+    };
+    /** Connection timeout in milliseconds */
+    connectionTimeoutMs?: number;
+    /** Query timeout in milliseconds */
+    queryTimeoutMs?: number;
+}
+//# sourceMappingURL=IDatabaseConfig.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IDatabaseConfig.d.ts","sourceRoot":"","sources":["../../src/interfaces/IDatabaseConfig.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oBAAoB;IACpB,IAAI,EAAE,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IAElD,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IAEjB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,wBAAwB;IACxB,GAAG,CAAC,EAAE,OAAO,GAAG;QACd,qBAAqB;QACrB,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,yBAAyB;QACzB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,iBAAiB;QACjB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;IAEF,uCAAuC;IACvC,OAAO,CAAC,EAAE;QACR,4CAA4C;QAC5C,GAAG,EAAE,MAAM,CAAC;QACZ,4CAA4C;QAC5C,GAAG,EAAE,MAAM,CAAC;QACZ,kDAAkD;QAClD,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IAEF,yCAAyC;IACzC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B,oCAAoC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB"}

package/dist/interfaces/IDatabaseConfig.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 });

package/dist/interfaces/IDatabaseHealth.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Database health status information
+ */
+export interface IDatabaseHealth {
+    /** Whether database is connected */
+    connected: boolean;
+    /** Query latency in milliseconds */
+    latencyMs: number;
+    /** Database version string */
+    version: string;
+    /** Number of active connections (optional) */
+    activeConnections?: number;
+    /** Maximum allowed connections (optional) */
+    maxConnections?: number;
+}
+//# sourceMappingURL=IDatabaseHealth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IDatabaseHealth.d.ts","sourceRoot":"","sources":["../../src/interfaces/IDatabaseHealth.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,SAAS,EAAE,OAAO,CAAC;IAEnB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAElB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAEhB,8CAA8C;IAC9C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,6CAA6C;IAC7C,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB"}

package/dist/interfaces/IDatabaseHealth.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 });

package/dist/interfaces/IMigration.d.ts

@@ -0,0 +1,54 @@
+import { IDatabaseAdapter } from './IDatabaseAdapter';
+/**
+ * Database migration interface
+ */
+export interface IMigration {
+    /** Unique migration identifier */
+    id: string;
+    /** Human-readable migration name */
+    name: string;
+    /**
+     * Apply migration (upgrade schema)
+     * @param adapter - Database adapter to use
+     */
+    up(adapter: IDatabaseAdapter): Promise<void>;
+    /**
+     * Revert migration (downgrade schema)
+     * @param adapter - Database adapter to use
+     */
+    down(adapter: IDatabaseAdapter): Promise<void>;
+}
+/**
+ * Migration status information
+ */
+export interface IMigrationStatus {
+    /** Migration ID */
+    id: string;
+    /** Migration name */
+    name: string;
+    /** When migration was applied (null if not applied) */
+    appliedAt: Date | null;
+    /** Migration status */
+    status: 'pending' | 'applied' | 'failed';
+}
+/**
+ * Migration manager interface
+ */
+export interface IMigrationManager {
+    /**
+     * Run all pending migrations
+     * @throws Error if any migration fails
+     */
+    up(): Promise<void>;
+    /**
+     * Rollback last applied migration
+     * @throws Error if no migrations to rollback or rollback fails
+     */
+    down(): Promise<void>;
+    /**
+     * Get status of all migrations
+     * @returns Array of migration statuses
+     */
+    status(): Promise<IMigrationStatus[]>;
+}
+//# sourceMappingURL=IMigration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IMigration.d.ts","sourceRoot":"","sources":["../../src/interfaces/IMigration.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IAEX,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,EAAE,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C;;;OAGG;IACH,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mBAAmB;IACnB,EAAE,EAAE,MAAM,CAAC;IAEX,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IAEb,uDAAuD;IACvD,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IAEvB,uBAAuB;IACvB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpB;;;OAGG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB;;;OAGG;IACH,MAAM,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;CACvC"}

package/dist/interfaces/IMigration.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 });

package/dist/interfaces/IQueryBuilder.d.ts

@@ -0,0 +1,106 @@
+import { IDatabaseAdapter } from './IDatabaseAdapter';
+import { IQueryResult } from './IQueryResult';
+/**
+ * Abstract query builder interface
+ * Enables type-safe SQL generation without string concatenation
+ * @template T - Type of entity being queried
+ */
+export interface IQueryBuilder<T = any> {
+    /**
+     * Select specific columns
+     * @param columns - Column names to select
+     * @returns Query builder for chaining
+     */
+    select(...columns: string[]): IQueryBuilder<T>;
+    /**
+     * Specify table to query from
+     * @param table - Table name
+     * @returns Query builder for chaining
+     */
+    from(table: string): IQueryBuilder<T>;
+    /**
+     * Add WHERE condition
+     * @param condition - SQL condition string
+     * @param params - Parameters for parameterized query
+     * @returns Query builder for chaining
+     */
+    where(condition: string, params?: any[]): IQueryBuilder<T>;
+    /**
+     * Add WHERE IN condition
+     * @param column - Column name
+     * @param values - Array of values for IN clause
+     * @returns Query builder for chaining
+     */
+    whereIn(column: string, values: any[]): IQueryBuilder<T>;
+    /**
+     * Add ORDER BY clause
+     * @param column - Column to order by
+     * @param direction - Sort direction (default: ASC)
+     * @returns Query builder for chaining
+     */
+    orderBy(column: string, direction?: 'ASC' | 'DESC'): IQueryBuilder<T>;
+    /**
+     * Limit number of results
+     * @param count - Maximum number of rows
+     * @returns Query builder for chaining
+     */
+    limit(count: number): IQueryBuilder<T>;
+    /**
+     * Offset results (skip rows)
+     * @param count - Number of rows to skip
+     * @returns Query builder for chaining
+     */
+    offset(count: number): IQueryBuilder<T>;
+    /**
+     * Add INNER JOIN
+     * @param table - Table to join
+     * @param condition - Join condition
+     * @returns Query builder for chaining
+     */
+    join(table: string, condition: string): IQueryBuilder<T>;
+    /**
+     * Add LEFT JOIN
+     * @param table - Table to join
+     * @param condition - Join condition
+     * @returns Query builder for chaining
+     */
+    leftJoin(table: string, condition: string): IQueryBuilder<T>;
+    /**
+     * Insert single row
+     * @param data - Data to insert
+     * @returns Query builder for chaining
+     */
+    insert(data: Partial<T>): IQueryBuilder<T>;
+    /**
+     * Insert multiple rows
+     * @param data - Array of data to insert
+     * @returns Query builder for chaining
+     */
+    insertMany(data: Partial<T>[]): IQueryBuilder<T>;
+    /**
+     * Update rows
+     * @param data - Data to update
+     * @returns Query builder for chaining
+     */
+    update(data: Partial<T>): IQueryBuilder<T>;
+    /**
+     * Delete rows
+     * @returns Query builder for chaining
+     */
+    delete(): IQueryBuilder<T>;
+    /**
+     * Build the query
+     * @returns SQL string and parameters
+     */
+    build(): {
+        sql: string;
+        params: any[];
+    };
+    /**
+     * Execute the query
+     * @param adapter - Database adapter to use
+     * @returns Query result
+     */
+    execute(adapter: IDatabaseAdapter): Promise<IQueryResult<T>>;
+}
+//# sourceMappingURL=IQueryBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IQueryBuilder.d.ts","sourceRoot":"","sources":["../../src/interfaces/IQueryBuilder.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;;GAIG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,GAAG;IACpC;;;;OAIG;IACH,MAAM,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IAE/C;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IAEtC;;;;;OAKG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IAE3D;;;;;OAKG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IAEzD;;;;;OAKG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IAEtE;;;;OAIG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IAEvC;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IAExC;;;;;OAKG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IAEzD;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IAE7D;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IAE3C;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IAEjD;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IAE3C;;;OAGG;IACH,MAAM,IAAI,aAAa,CAAC,CAAC,CAAC,CAAC;IAE3B;;;OAGG;IACH,KAAK,IAAI;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,GAAG,EAAE,CAAA;KAAE,CAAC;IAExC;;;;OAIG;IACH,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;CAC9D"}

package/dist/interfaces/IQueryBuilder.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 });

package/dist/interfaces/IQueryResult.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Field metadata information
+ */
+export interface IFieldInfo {
+    /** Field name */
+    name: string;
+    /** Database-specific type ID */
+    dataTypeID: number;
+    /** Human-readable type name (e.g., 'varchar', 'integer') */
+    dataTypeName: string;
+    /** Whether the field can contain null values */
+    nullable: boolean;
+}
+/**
+ * Query result with metadata
+ * @template T - Type of rows returned
+ */
+export interface IQueryResult<T = any> {
+    /** Result rows */
+    rows: T[];
+    /** Number of rows returned */
+    rowCount: number;
+    /** Field metadata for each column */
+    fields: IFieldInfo[];
+    /** SQL command executed (e.g., SELECT, INSERT, UPDATE, DELETE) */
+    command: string;
+}
+//# sourceMappingURL=IQueryResult.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IQueryResult.d.ts","sourceRoot":"","sources":["../../src/interfaces/IQueryResult.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,GAAG;IACnC,kBAAkB;IAClB,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/interfaces/IQueryResult.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 });

package/dist/interfaces/IRLSContext.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Row Level Security context
+ * Used for multi-tenant security and user-based access control
+ */
+export interface IRLSContext {
+    /** User ID for RLS filtering */
+    userId: string;
+    /** User role (e.g., 'admin', 'user', 'guest') */
+    userRole: string;
+    /** Tenant ID for multi-tenant systems (optional) */
+    tenantId?: string;
+    /** Additional claims for fine-grained access control (optional) */
+    claims?: Record<string, any>;
+}
+//# sourceMappingURL=IRLSContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IRLSContext.d.ts","sourceRoot":"","sources":["../../src/interfaces/IRLSContext.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IAEf,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IAEjB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B"}

package/dist/interfaces/IRLSContext.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 });

package/dist/interfaces/ITransaction.d.ts

@@ -0,0 +1,32 @@
+import { IQueryResult } from './IQueryResult';
+/**
+ * Transaction interface for ACID operations
+ */
+export interface ITransaction {
+    /** Unique transaction identifier */
+    id: string;
+    /**
+     * Execute query within transaction
+     * @template T - Type of rows returned
+     * @param sql - SQL query string
+     * @param params - Query parameters
+     * @returns Query result
+     */
+    query<T = any>(sql: string, params?: any[]): Promise<IQueryResult<T>>;
+    /**
+     * Commit transaction changes
+     * @throws Error if transaction is not active
+     */
+    commit(): Promise<void>;
+    /**
+     * Rollback transaction changes
+     * @throws Error if transaction is not active
+     */
+    rollback(): Promise<void>;
+    /**
+     * Check if transaction is active
+     * @returns true if transaction is active
+     */
+    isActive(): boolean;
+}
+//# sourceMappingURL=ITransaction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ITransaction.d.ts","sourceRoot":"","sources":["../../src/interfaces/ITransaction.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,EAAE,EAAE,MAAM,CAAC;IAEX;;;;;;OAMG;IACH,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAEtE;;;OAGG;IACH,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAExB;;;OAGG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B;;;OAGG;IACH,QAAQ,IAAI,OAAO,CAAC;CACrB"}

package/dist/interfaces/ITransaction.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 });

package/dist/interfaces/index.d.ts

@@ -0,0 +1,10 @@
+export * from './IDatabaseAdapter';
+export * from './ITransaction';
+export * from './IQueryResult';
+export * from './IDatabaseConfig';
+export * from './IDatabaseHealth';
+export * from './IRLSContext';
+export * from './IMigration';
+export * from './IConnectionPool';
+export * from './IQueryBuilder';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":"AAQA,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC"}

package/dist/interfaces/index.js

@@ -0,0 +1,32 @@
+"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("./IDatabaseAdapter"), exports);
+__exportStar(require("./ITransaction"), exports);
+__exportStar(require("./IQueryResult"), exports);
+__exportStar(require("./IDatabaseConfig"), exports);
+__exportStar(require("./IDatabaseHealth"), exports);
+__exportStar(require("./IRLSContext"), exports);
+__exportStar(require("./IMigration"), exports);
+__exportStar(require("./IConnectionPool"), exports);
+__exportStar(require("./IQueryBuilder"), exports);

package/dist/rls/RLSContextManager.d.ts

@@ -0,0 +1,45 @@
+import { IRLSContext } from '../interfaces';
+/**
+ * Row Level Security context manager
+ * Enables multi-tenant security and user-based access control
+ */
+export declare class RLSContextManager {
+    private context;
+    /**
+     * Set RLS context for current operation
+     * Context is scoped to this manager instance
+     * @param context - RLS context to set
+     */
+    setContext(context: IRLSContext): void;
+    /**
+     * Get current RLS context
+     * @returns Current context or null if not set
+     */
+    getContext(): IRLSContext | null;
+    /**
+     * Clear RLS context
+     */
+    clearContext(): void;
+    /**
+     * Execute function with RLS context
+     * Restores previous context after execution
+     * @template T - Return type of function
+     * @param context - RLS context to use
+     * @param fn - Function to execute
+     * @returns Result of function execution
+     */
+    withContext<T>(context: IRLSContext, fn: () => Promise<T>): Promise<T>;
+    /**
+     * Generate PostgreSQL SET statements for RLS
+     * These statements set session variables that can be used in RLS policies
+     * @returns Array of SQL SET statements
+     */
+    generateRLSStatements(): string[];
+    /**
+     * Escape single quotes in values for SQL safety
+     * @param value - Value to escape
+     * @returns Escaped value
+     */
+    private escapeValue;
+}
+//# sourceMappingURL=RLSContextManager.d.ts.map

package/dist/rls/RLSContextManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RLSContextManager.d.ts","sourceRoot":"","sources":["../../src/rls/RLSContextManager.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAA4B;IAE3C;;;;OAIG;IACI,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAI7C;;;OAGG;IACI,UAAU,IAAI,WAAW,GAAG,IAAI;IAIvC;;OAEG;IACI,YAAY,IAAI,IAAI;IAI3B;;;;;;;OAOG;IACU,WAAW,CAAC,CAAC,EACxB,OAAO,EAAE,WAAW,EACpB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC;IAUb;;;;OAIG;IACI,qBAAqB,IAAI,MAAM,EAAE;IAyBxC;;;;OAIG;IACH,OAAO,CAAC,WAAW;CAGpB"}

package/dist/rls/RLSContextManager.js

@@ -0,0 +1,88 @@
+"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.RLSContextManager = void 0;
+/**
+ * Row Level Security context manager
+ * Enables multi-tenant security and user-based access control
+ */
+class RLSContextManager {
+    constructor() {
+        this.context = null;
+    }
+    /**
+     * Set RLS context for current operation
+     * Context is scoped to this manager instance
+     * @param context - RLS context to set
+     */
+    setContext(context) {
+        this.context = context;
+    }
+    /**
+     * Get current RLS context
+     * @returns Current context or null if not set
+     */
+    getContext() {
+        return this.context;
+    }
+    /**
+     * Clear RLS context
+     */
+    clearContext() {
+        this.context = null;
+    }
+    /**
+     * Execute function with RLS context
+     * Restores previous context after execution
+     * @template T - Return type of function
+     * @param context - RLS context to use
+     * @param fn - Function to execute
+     * @returns Result of function execution
+     */
+    async withContext(context, fn) {
+        const previous = this.context;
+        this.context = context;
+        try {
+            return await fn();
+        }
+        finally {
+            this.context = previous;
+        }
+    }
+    /**
+     * Generate PostgreSQL SET statements for RLS
+     * These statements set session variables that can be used in RLS policies
+     * @returns Array of SQL SET statements
+     */
+    generateRLSStatements() {
+        if (!this.context) {
+            return [];
+        }
+        const statements = [
+            `SET LOCAL "app.user_id" = '${this.escapeValue(this.context.userId)}';`,
+            `SET LOCAL "app.user_role" = '${this.escapeValue(this.context.userRole)}';`
+        ];
+        if (this.context.tenantId) {
+            statements.push(`SET LOCAL "app.tenant_id" = '${this.escapeValue(this.context.tenantId)}';`);
+        }
+        if (this.context.claims) {
+            statements.push(`SET LOCAL "app.claims" = '${this.escapeValue(JSON.stringify(this.context.claims))}';`);
+        }
+        return statements;
+    }
+    /**
+     * Escape single quotes in values for SQL safety
+     * @param value - Value to escape
+     * @returns Escaped value
+     */
+    escapeValue(value) {
+        return value.replace(/'/g, "''");
+    }
+}
+exports.RLSContextManager = RLSContextManager;

package/dist/rls/index.d.ts

@@ -0,0 +1,2 @@
+export * from './RLSContextManager';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rls/index.ts"],"names":[],"mappings":"AAQA,cAAc,qBAAqB,CAAC"}