@groundbrick/db-core 0.0.1

package/dist/custom-types/MigrationRecord.d.ts

@@ -0,0 +1,6 @@
+import { MigrationStatus } from "../interfaces/MigrationStatus.js";
+/**
+ * @deprecated Use MigrationStatus instead
+ */
+export type MigrationRecord = MigrationStatus;
+//# sourceMappingURL=MigrationRecord.d.ts.map

package/dist/custom-types/MigrationRecord.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MigrationRecord.d.ts","sourceRoot":"","sources":["../../src/custom-types/MigrationRecord.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAOnE;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,eAAe,CAAC"}

package/dist/custom-types/MigrationRecord.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=MigrationRecord.js.map

package/dist/custom-types/MigrationRecord.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MigrationRecord.js","sourceRoot":"","sources":["../../src/custom-types/MigrationRecord.ts"],"names":[],"mappings":""}

package/dist/custom-types/QueryParams.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Utility types for better type safety
+ */
+export type QueryParams = any[];
+//# sourceMappingURL=QueryParams.d.ts.map

package/dist/custom-types/QueryParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryParams.d.ts","sourceRoot":"","sources":["../../src/custom-types/QueryParams.ts"],"names":[],"mappings":"AACA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC"}

package/dist/custom-types/QueryParams.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=QueryParams.js.map

package/dist/custom-types/QueryParams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryParams.js","sourceRoot":"","sources":["../../src/custom-types/QueryParams.ts"],"names":[],"mappings":""}

package/dist/custom-types/Transaction.d.ts

@@ -0,0 +1,6 @@
+import { DatabaseTransaction } from "../interfaces/DatabaseTransaction.js";
+/**
+ * @deprecated Use DatabaseTransaction instead
+ */
+export type Transaction = DatabaseTransaction;
+//# sourceMappingURL=Transaction.d.ts.map

package/dist/custom-types/Transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Transaction.d.ts","sourceRoot":"","sources":["../../src/custom-types/Transaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAO3E;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,mBAAmB,CAAC"}

package/dist/custom-types/Transaction.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Transaction.js.map

package/dist/custom-types/Transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Transaction.js","sourceRoot":"","sources":["../../src/custom-types/Transaction.ts"],"names":[],"mappings":""}

package/dist/custom-types/TransactionCallback.d.ts

@@ -0,0 +1,3 @@
+import { DatabaseTransaction } from "../interfaces/DatabaseTransaction.js";
+export type TransactionCallback<T> = (trx: DatabaseTransaction) => Promise<T>;
+//# sourceMappingURL=TransactionCallback.d.ts.map

package/dist/custom-types/TransactionCallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransactionCallback.d.ts","sourceRoot":"","sources":["../../src/custom-types/TransactionCallback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAE3E,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,mBAAmB,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC"}

package/dist/custom-types/TransactionCallback.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=TransactionCallback.js.map

package/dist/custom-types/TransactionCallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransactionCallback.js","sourceRoot":"","sources":["../../src/custom-types/TransactionCallback.ts"],"names":[],"mappings":""}

package/dist/error-handling/ConnectionError.d.ts

@@ -0,0 +1,8 @@
+import { DatabaseError } from "./DatabaseError.js";
+/**
+ * Connection error specifically for connection-related issues
+ */
+export declare class ConnectionError extends DatabaseError {
+    constructor(message: string, cause?: Error);
+}
+//# sourceMappingURL=ConnectionError.d.ts.map

package/dist/error-handling/ConnectionError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectionError.d.ts","sourceRoot":"","sources":["../../src/error-handling/ConnectionError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;GAEG;AACH,qBAAa,eAAgB,SAAQ,aAAa;gBAClC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAI7C"}

package/dist/error-handling/ConnectionError.js

@@ -0,0 +1,11 @@
+import { DatabaseError } from "./DatabaseError.js";
+/**
+ * Connection error specifically for connection-related issues
+ */
+export class ConnectionError extends DatabaseError {
+    constructor(message, cause) {
+        super(message, { cause });
+        this.name = 'ConnectionError';
+    }
+}
+//# sourceMappingURL=ConnectionError.js.map

package/dist/error-handling/ConnectionError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectionError.js","sourceRoot":"","sources":["../../src/error-handling/ConnectionError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,aAAa;IAC9C,YAAY,OAAe,EAAE,KAAa;QACtC,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAClC,CAAC;CACJ"}

package/dist/error-handling/DatabaseError.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Base error class for database operations
+ */
+export declare class DatabaseError extends Error {
+    readonly code?: string;
+    readonly severity?: string;
+    readonly constraint?: string;
+    readonly detail?: string;
+    readonly cause?: Error;
+    constructor(message: string, options?: {
+        code?: string;
+        severity?: string;
+        constraint?: string;
+        detail?: string;
+        cause?: Error;
+    });
+}
+//# sourceMappingURL=DatabaseError.d.ts.map

package/dist/error-handling/DatabaseError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatabaseError.d.ts","sourceRoot":"","sources":["../../src/error-handling/DatabaseError.ts"],"names":[],"mappings":"AACA;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACpC,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClC,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpC,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChC,SAAgB,KAAK,CAAC,EAAE,KAAK,CAAC;gBAG1B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACN,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,KAAK,CAAC;KACjB;CAaR"}

package/dist/error-handling/DatabaseError.js

@@ -0,0 +1,22 @@
+/**
+ * Base error class for database operations
+ */
+export class DatabaseError extends Error {
+    code;
+    severity;
+    constraint;
+    detail;
+    cause;
+    constructor(message, options) {
+        super(message);
+        this.name = 'DatabaseError';
+        this.code = options?.code;
+        this.severity = options?.severity;
+        this.constraint = options?.constraint;
+        this.detail = options?.detail;
+        if (options?.cause) {
+            this.cause = options.cause;
+        }
+    }
+}
+//# sourceMappingURL=DatabaseError.js.map

package/dist/error-handling/DatabaseError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatabaseError.js","sourceRoot":"","sources":["../../src/error-handling/DatabaseError.ts"],"names":[],"mappings":"AACA;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IACpB,IAAI,CAAU;IACd,QAAQ,CAAU;IAClB,UAAU,CAAU;IACpB,MAAM,CAAU;IAChB,KAAK,CAAS;IAE9B,YACI,OAAe,EACf,OAMC;QAED,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,OAAO,EAAE,QAAQ,CAAC;QAClC,IAAI,CAAC,UAAU,GAAG,OAAO,EAAE,UAAU,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,CAAC;QAE9B,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;YACjB,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC/B,CAAC;IACL,CAAC;CACJ"}

package/dist/error-handling/MigrationError.d.ts

@@ -0,0 +1,8 @@
+import { DatabaseError } from "./DatabaseError.js";
+/**
+ * Migration error for migration-related issues
+ */
+export declare class MigrationError extends DatabaseError {
+    constructor(message: string, migrationId?: string, cause?: Error);
+}
+//# sourceMappingURL=MigrationError.d.ts.map

package/dist/error-handling/MigrationError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MigrationError.d.ts","sourceRoot":"","sources":["../../src/error-handling/MigrationError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;GAEG;AACH,qBAAa,cAAe,SAAQ,aAAa;gBACjC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAInE"}

package/dist/error-handling/MigrationError.js

@@ -0,0 +1,11 @@
+import { DatabaseError } from "./DatabaseError.js";
+/**
+ * Migration error for migration-related issues
+ */
+export class MigrationError extends DatabaseError {
+    constructor(message, migrationId, cause) {
+        super(message, { cause, code: 'MIGRATION_ERROR', severity: 'ERROR', constraint: migrationId ? `migration_${migrationId}` : undefined });
+        this.name = 'MigrationError';
+    }
+}
+//# sourceMappingURL=MigrationError.js.map

package/dist/error-handling/MigrationError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MigrationError.js","sourceRoot":"","sources":["../../src/error-handling/MigrationError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,aAAa;IAC7C,YAAY,OAAe,EAAE,WAAoB,EAAE,KAAa;QAC5D,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC,aAAa,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;QACxI,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IACjC,CAAC;CACJ"}

package/dist/error-handling/QueryError.d.ts

@@ -0,0 +1,8 @@
+import { DatabaseError } from "./DatabaseError.js";
+/**
+ * Query error for SQL execution issues
+ */
+export declare class QueryError extends DatabaseError {
+    constructor(message: string, query?: string, params?: any[], originalError?: Error);
+}
+//# sourceMappingURL=QueryError.d.ts.map

package/dist/error-handling/QueryError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryError.d.ts","sourceRoot":"","sources":["../../src/error-handling/QueryError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;GAEG;AACH,qBAAa,UAAW,SAAQ,aAAa;gBAErC,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,GAAG,EAAE,EACd,aAAa,CAAC,EAAE,KAAK;CAK5B"}

package/dist/error-handling/QueryError.js

@@ -0,0 +1,11 @@
+import { DatabaseError } from "./DatabaseError.js";
+/**
+ * Query error for SQL execution issues
+ */
+export class QueryError extends DatabaseError {
+    constructor(message, query, params, originalError) {
+        super(message, { cause: originalError, code: 'QUERY_ERROR', severity: 'ERROR', detail: `Query error occurred${query ? ` for query: ${query}` : ''}` + (params ? ` with params: ${JSON.stringify(params)}` : '') });
+        this.name = 'QueryError';
+    }
+}
+//# sourceMappingURL=QueryError.js.map

package/dist/error-handling/QueryError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryError.js","sourceRoot":"","sources":["../../src/error-handling/QueryError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,aAAa;IACzC,YACI,OAAe,EACf,KAAc,EACd,MAAc,EACd,aAAqB;QAErB,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,uBAAuB,KAAK,CAAC,CAAC,CAAC,eAAe,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,iBAAiB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACnN,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC7B,CAAC;CACJ"}

package/dist/error-handling/TransactionError.d.ts

@@ -0,0 +1,8 @@
+import { DatabaseError } from "./DatabaseError.js";
+/**
+ * Transaction error for transaction-related issues
+ */
+export declare class TransactionError extends DatabaseError {
+    constructor(message: string, cause?: Error);
+}
+//# sourceMappingURL=TransactionError.d.ts.map

package/dist/error-handling/TransactionError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransactionError.d.ts","sourceRoot":"","sources":["../../src/error-handling/TransactionError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,aAAa;gBACnC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAI7C"}

package/dist/error-handling/TransactionError.js

@@ -0,0 +1,11 @@
+import { DatabaseError } from "./DatabaseError.js";
+/**
+ * Transaction error for transaction-related issues
+ */
+export class TransactionError extends DatabaseError {
+    constructor(message, cause) {
+        super(message, { cause });
+        this.name = 'TransactionError';
+    }
+}
+//# sourceMappingURL=TransactionError.js.map

package/dist/error-handling/TransactionError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransactionError.js","sourceRoot":"","sources":["../../src/error-handling/TransactionError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,aAAa;IAC/C,YAAY,OAAe,EAAE,KAAa;QACtC,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACnC,CAAC;CACJ"}

package/dist/index.d.ts

@@ -0,0 +1,138 @@
+import { ConnectionError } from './error-handling/ConnectionError.js';
+import { DatabaseError } from './error-handling/DatabaseError.js';
+import { MigrationError } from './error-handling/MigrationError.js';
+import { QueryError } from './error-handling/QueryError.js';
+import { TransactionError } from './error-handling/TransactionError.js';
+import { DatabaseConfig } from './interfaces/DatabaseConfig.js';
+/**
+ * Core database client interface that all database implementations must follow.
+ * This ensures consistency between PostgreSQL, MySQL, and future database types.
+ */
+export type { DatabaseClient } from './interfaces/DatabaseClient.js';
+/**
+ * SQL adapter interface for adapting SQL queries to specific database types.
+ * This allows for consistent query handling across different databases.
+ */
+export type { SqlAdapter } from './interfaces/SqlAdapter.js';
+/**
+ * Transaction interface - common methods for all database types
+ */
+export type { DatabaseTransaction } from './interfaces/DatabaseTransaction.js';
+/**
+ * Alias for DatabaseTransaction (for backward compatibility)
+ */
+export type { DatabaseTransaction as Transaction } from './interfaces/DatabaseTransaction.js';
+/**
+ * Database factory interface for creating database instances
+ */
+export type { DatabaseFactory } from './interfaces/DatabaseFactory.js';
+/**
+ * Migration manager interface for database schema versioning
+ */
+export type { MigrationManager } from './interfaces/MigrationManager.js';
+/**
+ * Configuration validation interface
+ */
+export type { ConfigValidator } from './interfaces/ConfigValidator.js';
+/**
+ * Base transaction class that provides common transaction logic
+ */
+export { BaseTransaction } from './base/BaseTransaction.js';
+/**
+ * Database adapter for switching between database types
+ */
+export { DatabaseAdapter } from './adapters/DatabaseAdapter.js';
+export { BaseSqlAdapter } from './adapters/BaseSqlAdapter.js';
+export type { AdapterConfig, DatabaseType } from './adapters/DatabaseAdapter.js';
+/**
+ * Generic database configuration that can be extended by specific database types
+ */
+export type { DatabaseConfig } from './interfaces/DatabaseConfig.js';
+/**
+ * Standard query result structure
+ */
+export type { QueryResult } from './interfaces/QueryResult.js';
+/**
+ * Health check result
+ */
+export type { HealthCheckResult } from './interfaces/HealthCheckResult.js';
+/**
+ * Migration interface
+ */
+export type { Migration } from './interfaces/Migration.js';
+/**
+ * Migration status
+ */
+export type { MigrationStatus } from './interfaces/MigrationStatus.js';
+/**
+ * Alias for MigrationStatus (for backward compatibility)
+ */
+export type { MigrationStatus as MigrationRecord } from './interfaces/MigrationStatus.js';
+/**
+ * Query parameters type
+ */
+export type { QueryParams } from './custom-types/QueryParams.js';
+/**
+ * Transaction callback type
+ */
+export type { TransactionCallback } from './custom-types/TransactionCallback.js';
+/**
+ * Base error class for database operations
+ */
+export { DatabaseError } from './error-handling/DatabaseError.js';
+/**
+ * Connection error specifically for connection-related issues
+ */
+export { ConnectionError } from './error-handling/ConnectionError.js';
+/**
+ * Query error for SQL execution issues
+ */
+export { QueryError } from './error-handling/QueryError.js';
+/**
+ * Transaction error for transaction-related issues
+ */
+export { TransactionError } from './error-handling/TransactionError.js';
+/**
+ * Migration error for migration-related issues
+ */
+export { MigrationError } from './error-handling/MigrationError.js';
+/**
+ * Type guards for error checking
+ */
+export declare const isDatabaseError: (error: any) => error is DatabaseError;
+export declare const isConnectionError: (error: any) => error is ConnectionError;
+export declare const isQueryError: (error: any) => error is QueryError;
+export declare const isTransactionError: (error: any) => error is TransactionError;
+export declare const isMigrationError: (error: any) => error is MigrationError;
+/**
+ * Validation helper for database configuration
+ */
+export declare const validateDatabaseConfig: (config: any) => config is DatabaseConfig;
+/**
+ * Helper to create a connection key for caching
+ */
+export declare const createConnectionKey: (config: DatabaseConfig) => string;
+/**
+ * Helper to sanitize config for logging (removes password)
+ */
+export declare const sanitizeConfigForLogging: (config: DatabaseConfig) => Partial<DatabaseConfig>;
+/**
+ * Default pool configuration
+ */
+export declare const DEFAULT_POOL_CONFIG: {
+    readonly max: 10;
+    readonly min: 2;
+    readonly connectionTimeoutMillis: 60000;
+    readonly idleTimeoutMillis: 30000;
+    readonly acquireTimeout: 60000;
+    readonly timeout: 60000;
+};
+/**
+ * Migration file pattern
+ */
+export declare const MIGRATION_FILE_PATTERN: RegExp;
+/**
+ * Supported database types
+ */
+export type SupportedDatabases = 'postgresql' | 'mysql';
+//# 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":"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"}

package/dist/index.js

@@ -0,0 +1,105 @@
+// Central export file for all shared database interfaces, types, and utilities
+import { ConnectionError } from './error-handling/ConnectionError.js';
+import { DatabaseError } from './error-handling/DatabaseError.js';
+import { MigrationError } from './error-handling/MigrationError.js';
+import { QueryError } from './error-handling/QueryError.js';
+import { TransactionError } from './error-handling/TransactionError.js';
+// ============================================================================
+// BASE CLASSES (exported as classes for inheritance)
+// ============================================================================
+/**
+ * Base transaction class that provides common transaction logic
+ */
+export { BaseTransaction } from './base/BaseTransaction.js';
+/**
+ * Database adapter for switching between database types
+ */
+export { DatabaseAdapter } from './adapters/DatabaseAdapter.js';
+export { BaseSqlAdapter } from './adapters/BaseSqlAdapter.js';
+// ============================================================================
+// ERROR CLASSES
+// ============================================================================
+/**
+ * Base error class for database operations
+ */
+export { DatabaseError } from './error-handling/DatabaseError.js';
+/**
+ * Connection error specifically for connection-related issues
+ */
+export { ConnectionError } from './error-handling/ConnectionError.js';
+/**
+ * Query error for SQL execution issues
+ */
+export { QueryError } from './error-handling/QueryError.js';
+/**
+ * Transaction error for transaction-related issues
+ */
+export { TransactionError } from './error-handling/TransactionError.js';
+/**
+ * Migration error for migration-related issues
+ */
+export { MigrationError } from './error-handling/MigrationError.js';
+// ============================================================================
+// UTILITY FUNCTIONS
+// ============================================================================
+/**
+ * Type guards for error checking
+ */
+export const isDatabaseError = (error) => {
+    return error instanceof DatabaseError;
+};
+export const isConnectionError = (error) => {
+    return error instanceof ConnectionError;
+};
+export const isQueryError = (error) => {
+    return error instanceof QueryError;
+};
+export const isTransactionError = (error) => {
+    return error instanceof TransactionError;
+};
+export const isMigrationError = (error) => {
+    return error instanceof MigrationError;
+};
+/**
+ * Validation helper for database configuration
+ */
+export const validateDatabaseConfig = (config) => {
+    return !!(config &&
+        typeof config.host === 'string' &&
+        typeof config.port === 'number' &&
+        typeof config.database === 'string' &&
+        typeof config.user === 'string' &&
+        typeof config.password === 'string');
+};
+/**
+ * Helper to create a connection key for caching
+ */
+export const createConnectionKey = (config) => {
+    return `${config.host}:${config.port}:${config.database}:${config.user}`;
+};
+/**
+ * Helper to sanitize config for logging (removes password)
+ */
+export const sanitizeConfigForLogging = (config) => {
+    const { password, ...sanitized } = config;
+    return sanitized;
+};
+// ============================================================================
+// CONSTANTS & DEFAULTS
+// ============================================================================
+/**
+ * Default pool configuration
+ */
+export const DEFAULT_POOL_CONFIG = {
+    max: 10,
+    min: 2,
+    connectionTimeoutMillis: 60000,
+    idleTimeoutMillis: 30000,
+    acquireTimeout: 60000,
+    timeout: 60000
+};
+/**
+ * Migration file pattern
+ */
+export const MIGRATION_FILE_PATTERN = /^(\d{3})_(.+)\.sql$/;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/interfaces/ConfigValidator.d.ts

@@ -0,0 +1,10 @@
+import { DatabaseConfig } from "./DatabaseConfig.js";
+/**
+ * Configuration validation interface
+ */
+export interface ConfigValidator {
+    validate(config: DatabaseConfig): void;
+    getRequiredFields(): string[];
+    getOptionalFields(): string[];
+}
+//# sourceMappingURL=ConfigValidator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigValidator.d.ts","sourceRoot":"","sources":["../../src/interfaces/ConfigValidator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IACvC,iBAAiB,IAAI,MAAM,EAAE,CAAC;IAC9B,iBAAiB,IAAI,MAAM,EAAE,CAAC;CACjC"}

package/dist/interfaces/ConfigValidator.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ConfigValidator.js.map

package/dist/interfaces/ConfigValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigValidator.js","sourceRoot":"","sources":["../../src/interfaces/ConfigValidator.ts"],"names":[],"mappings":""}

package/dist/interfaces/DatabaseClient.d.ts

@@ -0,0 +1,18 @@
+import { HealthCheckResult } from "./HealthCheckResult.js";
+import { QueryResult } from './QueryResult.js';
+import { DatabaseTransaction } from './DatabaseTransaction.js';
+export interface DatabaseClient {
+    initialize(): Promise<void>;
+    close(): Promise<void>;
+    query<T>(sql: string, params?: any[]): Promise<QueryResult<T>>;
+    transaction<T>(callback: (tx: DatabaseTransaction) => Promise<T>): Promise<T>;
+    getDatabaseType(): 'postgresql' | 'mysql';
+    supportsReturning(): boolean;
+    healthCheck(): Promise<HealthCheckResult>;
+    getConnectionInfo?(): {
+        total: number;
+        idle: number;
+        waiting: number;
+    };
+}
+//# sourceMappingURL=DatabaseClient.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DatabaseClient.d.ts","sourceRoot":"","sources":["../../src/interfaces/DatabaseClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,MAAM,WAAW,cAAc;IAE3B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IAG/D,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,mBAAmB,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAG9E,eAAe,IAAI,YAAY,GAAG,OAAO,CAAC;IAC1C,iBAAiB,IAAI,OAAO,CAAC;IAG7B,WAAW,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE1C,iBAAiB,CAAC,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1E"}

package/dist/interfaces/DatabaseClient.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=DatabaseClient.js.map

package/dist/interfaces/DatabaseClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatabaseClient.js","sourceRoot":"","sources":["../../src/interfaces/DatabaseClient.ts"],"names":[],"mappings":""}

package/dist/interfaces/DatabaseConfig.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Generic database configuration that can be extended by specific database types
+ */
+export interface DatabaseConfig {
+    host: string;
+    port: number;
+    database: string;
+    user: string;
+    password: string;
+    ssl?: boolean | object;
+    max?: number;
+    min?: number;
+    idleTimeoutMillis?: number;
+    connectionTimeoutMillis?: number;
+    acquireTimeoutMillis?: number;
+    createTimeoutMillis?: number;
+    destroyTimeoutMillis?: number;
+    reapIntervalMillis?: number;
+    createRetryIntervalMillis?: number;
+    [key: string]: any;
+}
+//# sourceMappingURL=DatabaseConfig.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DatabaseConfig.d.ts","sourceRoot":"","sources":["../../src/interfaces/DatabaseConfig.ts"],"names":[],"mappings":"AACA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,yBAAyB,CAAC,EAAE,MAAM,CAAC;IAEnC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB"}

package/dist/interfaces/DatabaseConfig.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=DatabaseConfig.js.map

package/dist/interfaces/DatabaseConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatabaseConfig.js","sourceRoot":"","sources":["../../src/interfaces/DatabaseConfig.ts"],"names":[],"mappings":""}

package/dist/interfaces/DatabaseFactory.d.ts

@@ -0,0 +1,11 @@
+import { Logger } from "@groundbrick/logger";
+import { DatabaseConfig, DatabaseClient } from "./index.js";
+/**
+ * Database factory interface for creating database instances
+ */
+export interface DatabaseFactory {
+    getInstance(config: DatabaseConfig, logger?: Logger): DatabaseClient;
+    closeInstance?(): Promise<void>;
+    closeInstance?(): Promise<void>;
+}
+//# sourceMappingURL=DatabaseFactory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DatabaseFactory.d.ts","sourceRoot":"","sources":["../../src/interfaces/DatabaseFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,WAAW,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC;IACrE,aAAa,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,aAAa,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC"}

package/dist/interfaces/DatabaseFactory.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=DatabaseFactory.js.map

package/dist/interfaces/DatabaseFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatabaseFactory.js","sourceRoot":"","sources":["../../src/interfaces/DatabaseFactory.ts"],"names":[],"mappings":""}