@ciscode/database-kit 1.0.0

package/dist/config/database.constants.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Injection token for the main DatabaseService instance.
+ * Use with @Inject(DATABASE_TOKEN) or @InjectDatabase() decorator.
+ */
+export declare const DATABASE_TOKEN = "DATABASE_KIT_DEFAULT";
+/**
+ * Injection token for DatabaseKit module options.
+ * Used internally for async configuration.
+ */
+export declare const DATABASE_OPTIONS_TOKEN = "DATABASE_KIT_OPTIONS";
+/**
+ * Environment variable names used by DatabaseKit.
+ */
+export declare const ENV_KEYS: {
+    /** MongoDB connection string */
+    readonly MONGO_URI: "MONGO_URI";
+    /** PostgreSQL connection string */
+    readonly POSTGRES_URI: "DATABASE_URL";
+    /** Database type ('mongo' or 'postgres') */
+    readonly DATABASE_TYPE: "DATABASE_TYPE";
+    /** Connection pool size */
+    readonly POOL_SIZE: "DATABASE_POOL_SIZE";
+    /** Connection timeout in milliseconds */
+    readonly CONNECTION_TIMEOUT: "DATABASE_CONNECTION_TIMEOUT";
+};
+/**
+ * Default configuration values.
+ */
+export declare const DEFAULTS: {
+    /** Default page size for pagination */
+    readonly PAGE_SIZE: 10;
+    /** Maximum allowed page size */
+    readonly MAX_PAGE_SIZE: 100;
+    /** Default connection pool size */
+    readonly POOL_SIZE: 10;
+    /** Default connection timeout in milliseconds */
+    readonly CONNECTION_TIMEOUT: 5000;
+    /** Default server selection timeout for MongoDB */
+    readonly SERVER_SELECTION_TIMEOUT: 5000;
+};
+//# sourceMappingURL=database.constants.d.ts.map

package/dist/config/database.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.constants.d.ts","sourceRoot":"","sources":["../../src/config/database.constants.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,cAAc,yBAAyB,CAAC;AAErD;;;GAGG;AACH,eAAO,MAAM,sBAAsB,yBAAyB,CAAC;AAE7D;;GAEG;AACH,eAAO,MAAM,QAAQ;IACnB,gCAAgC;;IAEhC,mCAAmC;;IAEnC,4CAA4C;;IAE5C,2BAA2B;;IAE3B,yCAAyC;;CAEjC,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,QAAQ;IACnB,uCAAuC;;IAEvC,gCAAgC;;IAEhC,mCAAmC;;IAEnC,iDAAiD;;IAEjD,mDAAmD;;CAE3C,CAAC"}

package/dist/config/database.constants.js

@@ -0,0 +1,45 @@
+"use strict";
+// src/config/database.constants.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULTS = exports.ENV_KEYS = exports.DATABASE_OPTIONS_TOKEN = exports.DATABASE_TOKEN = void 0;
+/**
+ * Injection token for the main DatabaseService instance.
+ * Use with @Inject(DATABASE_TOKEN) or @InjectDatabase() decorator.
+ */
+exports.DATABASE_TOKEN = 'DATABASE_KIT_DEFAULT';
+/**
+ * Injection token for DatabaseKit module options.
+ * Used internally for async configuration.
+ */
+exports.DATABASE_OPTIONS_TOKEN = 'DATABASE_KIT_OPTIONS';
+/**
+ * Environment variable names used by DatabaseKit.
+ */
+exports.ENV_KEYS = {
+    /** MongoDB connection string */
+    MONGO_URI: 'MONGO_URI',
+    /** PostgreSQL connection string */
+    POSTGRES_URI: 'DATABASE_URL',
+    /** Database type ('mongo' or 'postgres') */
+    DATABASE_TYPE: 'DATABASE_TYPE',
+    /** Connection pool size */
+    POOL_SIZE: 'DATABASE_POOL_SIZE',
+    /** Connection timeout in milliseconds */
+    CONNECTION_TIMEOUT: 'DATABASE_CONNECTION_TIMEOUT',
+};
+/**
+ * Default configuration values.
+ */
+exports.DEFAULTS = {
+    /** Default page size for pagination */
+    PAGE_SIZE: 10,
+    /** Maximum allowed page size */
+    MAX_PAGE_SIZE: 100,
+    /** Default connection pool size */
+    POOL_SIZE: 10,
+    /** Default connection timeout in milliseconds */
+    CONNECTION_TIMEOUT: 5000,
+    /** Default server selection timeout for MongoDB */
+    SERVER_SELECTION_TIMEOUT: 5000,
+};
+//# sourceMappingURL=database.constants.js.map

package/dist/config/database.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.constants.js","sourceRoot":"","sources":["../../src/config/database.constants.ts"],"names":[],"mappings":";AAAA,mCAAmC;;;AAEnC;;;GAGG;AACU,QAAA,cAAc,GAAG,sBAAsB,CAAC;AAErD;;;GAGG;AACU,QAAA,sBAAsB,GAAG,sBAAsB,CAAC;AAE7D;;GAEG;AACU,QAAA,QAAQ,GAAG;IACtB,gCAAgC;IAChC,SAAS,EAAE,WAAW;IACtB,mCAAmC;IACnC,YAAY,EAAE,cAAc;IAC5B,4CAA4C;IAC5C,aAAa,EAAE,eAAe;IAC9B,2BAA2B;IAC3B,SAAS,EAAE,oBAAoB;IAC/B,yCAAyC;IACzC,kBAAkB,EAAE,6BAA6B;CACzC,CAAC;AAEX;;GAEG;AACU,QAAA,QAAQ,GAAG;IACtB,uCAAuC;IACvC,SAAS,EAAE,EAAE;IACb,gCAAgC;IAChC,aAAa,EAAE,GAAG;IAClB,mCAAmC;IACnC,SAAS,EAAE,EAAE;IACb,iDAAiD;IACjD,kBAAkB,EAAE,IAAI;IACxB,mDAAmD;IACnD,wBAAwB,EAAE,IAAI;CACtB,CAAC"}

package/dist/contracts/database.contracts.d.ts

@@ -0,0 +1,191 @@
+/**
+ * Database configuration types and interfaces for DatabaseKit.
+ * These contracts define the public API surface for the package.
+ */
+/**
+ * Supported database types.
+ */
+export type DatabaseType = 'mongo' | 'postgres';
+/**
+ * Base configuration for all database types.
+ */
+export interface DatabaseConfigBase {
+    /** Which adapter to use */
+    type: DatabaseType;
+    /** Connection string for the database */
+    connectionString: string;
+}
+/**
+ * MongoDB-specific configuration.
+ */
+export interface MongoDatabaseConfig extends DatabaseConfigBase {
+    type: 'mongo';
+}
+/**
+ * PostgreSQL-specific configuration.
+ */
+export interface PostgresDatabaseConfig extends DatabaseConfigBase {
+    type: 'postgres';
+}
+/**
+ * Discriminated union for database configuration.
+ * TypeScript will narrow the type based on the `type` property.
+ */
+export type DatabaseConfig = MongoDatabaseConfig | PostgresDatabaseConfig;
+/**
+ * Result of a paginated query.
+ */
+export interface PageResult<T> {
+    /** Array of entities for the current page */
+    data: T[];
+    /** Current page number (1-indexed) */
+    page: number;
+    /** Number of items per page */
+    limit: number;
+    /** Total number of items matching the filter */
+    total: number;
+    /** Total number of pages */
+    pages: number;
+}
+/**
+ * Options for paginated queries.
+ */
+export interface PageOptions<Filter = Record<string, unknown>> {
+    /** Filter criteria */
+    filter?: Filter;
+    /** Page number (1-indexed, default: 1) */
+    page?: number;
+    /** Items per page (default: 10) */
+    limit?: number;
+    /** Sort order (string or object) */
+    sort?: string | Record<string, 1 | -1 | 'asc' | 'desc'>;
+}
+/**
+ * Generic repository interface for CRUD operations.
+ * Implemented by both MongoDB and PostgreSQL adapters.
+ *
+ * @typeParam T - The entity type
+ * @typeParam Filter - The filter type (defaults to Record<string, unknown>)
+ */
+export interface Repository<T = unknown, Filter = Record<string, unknown>> {
+    /**
+     * Creates a new entity.
+     * @param data - Partial entity data
+     * @returns The created entity
+     */
+    create(data: Partial<T>): Promise<T>;
+    /**
+     * Finds an entity by its ID.
+     * @param id - The entity ID
+     * @returns The entity or null if not found
+     */
+    findById(id: string | number): Promise<T | null>;
+    /**
+     * Finds all entities matching the filter.
+     * @param filter - Optional filter criteria
+     * @returns Array of matching entities
+     */
+    findAll(filter?: Filter): Promise<T[]>;
+    /**
+     * Finds entities with pagination support.
+     * @param options - Pagination options
+     * @returns Paginated result
+     */
+    findPage(options?: PageOptions<Filter>): Promise<PageResult<T>>;
+    /**
+     * Updates an entity by its ID.
+     * @param id - The entity ID
+     * @param update - Partial update data
+     * @returns The updated entity or null if not found
+     */
+    updateById(id: string | number, update: Partial<T>): Promise<T | null>;
+    /**
+     * Deletes an entity by its ID.
+     * @param id - The entity ID
+     * @returns True if deleted, false if not found
+     */
+    deleteById(id: string | number): Promise<boolean>;
+    /**
+     * Counts entities matching the filter.
+     * @param filter - Optional filter criteria
+     * @returns Number of matching entities
+     */
+    count(filter?: Filter): Promise<number>;
+    /**
+     * Checks if any entity matches the filter.
+     * @param filter - Optional filter criteria
+     * @returns True if at least one entity matches
+     */
+    exists(filter?: Filter): Promise<boolean>;
+}
+/**
+ * Options for creating a MongoDB repository.
+ */
+export interface MongoRepositoryOptions {
+    /** Mongoose Model instance */
+    model: unknown;
+}
+/**
+ * Options for creating a PostgreSQL repository.
+ */
+export interface PostgresEntityConfig {
+    /** Table name in PostgreSQL */
+    table: string;
+    /** Primary key column (default: "id") */
+    primaryKey?: string;
+    /**
+     * Whitelist of allowed columns for select/filter/sort.
+     * If empty, all columns are allowed (not recommended for public APIs).
+     */
+    columns?: string[];
+    /**
+     * Base filter automatically applied on every query.
+     * Useful for soft-delete patterns (e.g., { is_deleted: false }).
+     */
+    defaultFilter?: Record<string, unknown>;
+}
+/**
+ * Configuration options for DatabaseKitModule.forRoot().
+ */
+export interface DatabaseKitModuleOptions {
+    /** Database configuration */
+    config: DatabaseConfig;
+    /** Whether to auto-connect on module initialization (default: true) */
+    autoConnect?: boolean;
+}
+/**
+ * Type for NestJS injection tokens (compatible with @nestjs/common InjectionToken).
+ */
+export type InjectionToken = string | symbol | Function;
+/**
+ * Optional factory dependency for async module configuration.
+ */
+export interface OptionalFactoryDependency {
+    token: InjectionToken;
+    optional?: boolean;
+}
+/**
+ * Async configuration options for DatabaseKitModule.forRootAsync().
+ */
+export interface DatabaseKitModuleAsyncOptions {
+    /** Modules to import for dependency injection */
+    imports?: unknown[];
+    /** Factory function that returns the configuration */
+    useFactory: (...args: unknown[]) => Promise<DatabaseKitModuleOptions> | DatabaseKitModuleOptions;
+    /** Dependencies to inject into the factory function */
+    inject?: Array<InjectionToken | OptionalFactoryDependency>;
+}
+/**
+ * Default values and constants for DatabaseKit.
+ */
+export declare const DATABASE_KIT_CONSTANTS: {
+    /** Default page size for pagination */
+    readonly DEFAULT_PAGE_SIZE: 10;
+    /** Default maximum page size */
+    readonly MAX_PAGE_SIZE: 100;
+    /** Default connection pool size */
+    readonly DEFAULT_POOL_SIZE: 10;
+    /** Default connection timeout in milliseconds */
+    readonly DEFAULT_CONNECTION_TIMEOUT: 5000;
+};
+//# sourceMappingURL=database.contracts.d.ts.map

package/dist/contracts/database.contracts.d.ts.map

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

package/dist/contracts/database.contracts.js

@@ -0,0 +1,21 @@
+"use strict";
+// src/contracts/database.contracts.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DATABASE_KIT_CONSTANTS = void 0;
+// -----------------------------
+// Constants
+// -----------------------------
+/**
+ * Default values and constants for DatabaseKit.
+ */
+exports.DATABASE_KIT_CONSTANTS = {
+    /** Default page size for pagination */
+    DEFAULT_PAGE_SIZE: 10,
+    /** Default maximum page size */
+    MAX_PAGE_SIZE: 100,
+    /** Default connection pool size */
+    DEFAULT_POOL_SIZE: 10,
+    /** Default connection timeout in milliseconds */
+    DEFAULT_CONNECTION_TIMEOUT: 5000,
+};
+//# sourceMappingURL=database.contracts.js.map

package/dist/contracts/database.contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.contracts.js","sourceRoot":"","sources":["../../src/contracts/database.contracts.ts"],"names":[],"mappings":";AAAA,sCAAsC;;;AA8NtC,gCAAgC;AAChC,YAAY;AACZ,gCAAgC;AAEhC;;GAEG;AACU,QAAA,sBAAsB,GAAG;IAClC,uCAAuC;IACvC,iBAAiB,EAAE,EAAE;IACrB,gCAAgC;IAChC,aAAa,EAAE,GAAG;IAClB,mCAAmC;IACnC,iBAAiB,EAAE,EAAE;IACrB,iDAAiD;IACjD,0BAA0B,EAAE,IAAI;CAC1B,CAAC"}

package/dist/database-kit.module.d.ts

@@ -0,0 +1,71 @@
+import { DynamicModule } from '@nestjs/common';
+import { DatabaseConfig, DatabaseKitModuleOptions, DatabaseKitModuleAsyncOptions } from './contracts/database.contracts';
+/**
+ * DatabaseKitModule - Main NestJS module for DatabaseKit.
+ *
+ * Provides a unified database access layer for MongoDB and PostgreSQL.
+ * Use forRoot() for synchronous configuration or forRootAsync() for
+ * configuration that depends on other providers (e.g., ConfigService).
+ *
+ * @example Synchronous configuration
+ * ```typescript
+ * @Module({
+ *   imports: [
+ *     DatabaseKitModule.forRoot({
+ *       config: {
+ *         type: 'mongo',
+ *         connectionString: process.env.MONGO_URI!,
+ *       },
+ *     }),
+ *   ],
+ * })
+ * export class AppModule {}
+ * ```
+ *
+ * @example Async configuration with ConfigService
+ * ```typescript
+ * @Module({
+ *   imports: [
+ *     DatabaseKitModule.forRootAsync({
+ *       imports: [ConfigModule],
+ *       useFactory: (config: ConfigService) => ({
+ *         config: {
+ *           type: 'postgres',
+ *           connectionString: config.get('DATABASE_URL')!,
+ *         },
+ *       }),
+ *       inject: [ConfigService],
+ *     }),
+ *   ],
+ * })
+ * export class AppModule {}
+ * ```
+ */
+export declare class DatabaseKitModule {
+    private static readonly logger;
+    /**
+     * Configures DatabaseKitModule with synchronous options.
+     *
+     * @param options - Module configuration options
+     * @returns Dynamic module configuration
+     */
+    static forRoot(options: DatabaseKitModuleOptions): DynamicModule;
+    /**
+     * Configures DatabaseKitModule with asynchronous options.
+     * Useful when configuration depends on other providers like ConfigService.
+     *
+     * @param options - Async module configuration options
+     * @returns Dynamic module configuration
+     */
+    static forRootAsync(options: DatabaseKitModuleAsyncOptions): DynamicModule;
+    /**
+     * Creates a feature module for additional database connections.
+     * Useful for multi-database scenarios.
+     *
+     * @param token - Unique token for this database connection
+     * @param config - Database configuration
+     * @returns Dynamic module configuration
+     */
+    static forFeature(token: string, config: DatabaseConfig): DynamicModule;
+}
+//# sourceMappingURL=database-kit.module.d.ts.map

package/dist/database-kit.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-kit.module.d.ts","sourceRoot":"","sources":["../src/database-kit.module.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAoC,MAAM,gBAAgB,CAAC;AAGjF,OAAO,EACH,cAAc,EACd,wBAAwB,EACxB,6BAA6B,EAChC,MAAM,gCAAgC,CAAC;AAGxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,qBAEa,iBAAiB;IAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAsC;IAEpE;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,wBAAwB,GAAG,aAAa;IA6BhE;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,6BAA6B,GAAG,aAAa;IAiC1E;;;;;;;OAOG;IACH,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,aAAa;CAmB1E"}

package/dist/database-kit.module.js

@@ -0,0 +1,158 @@
+"use strict";
+// src/database-kit.module.ts
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var DatabaseKitModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DatabaseKitModule = void 0;
+const common_1 = require("@nestjs/common");
+const database_service_1 = require("./services/database.service");
+const logger_service_1 = require("./services/logger.service");
+const database_constants_1 = require("./config/database.constants");
+/**
+ * DatabaseKitModule - Main NestJS module for DatabaseKit.
+ *
+ * Provides a unified database access layer for MongoDB and PostgreSQL.
+ * Use forRoot() for synchronous configuration or forRootAsync() for
+ * configuration that depends on other providers (e.g., ConfigService).
+ *
+ * @example Synchronous configuration
+ * ```typescript
+ * @Module({
+ *   imports: [
+ *     DatabaseKitModule.forRoot({
+ *       config: {
+ *         type: 'mongo',
+ *         connectionString: process.env.MONGO_URI!,
+ *       },
+ *     }),
+ *   ],
+ * })
+ * export class AppModule {}
+ * ```
+ *
+ * @example Async configuration with ConfigService
+ * ```typescript
+ * @Module({
+ *   imports: [
+ *     DatabaseKitModule.forRootAsync({
+ *       imports: [ConfigModule],
+ *       useFactory: (config: ConfigService) => ({
+ *         config: {
+ *           type: 'postgres',
+ *           connectionString: config.get('DATABASE_URL')!,
+ *         },
+ *       }),
+ *       inject: [ConfigService],
+ *     }),
+ *   ],
+ * })
+ * export class AppModule {}
+ * ```
+ */
+let DatabaseKitModule = DatabaseKitModule_1 = class DatabaseKitModule {
+    /**
+     * Configures DatabaseKitModule with synchronous options.
+     *
+     * @param options - Module configuration options
+     * @returns Dynamic module configuration
+     */
+    static forRoot(options) {
+        const providers = [
+            {
+                provide: database_constants_1.DATABASE_OPTIONS_TOKEN,
+                useValue: options,
+            },
+            {
+                provide: database_constants_1.DATABASE_TOKEN,
+                useFactory: async () => {
+                    const db = new database_service_1.DatabaseService(options.config);
+                    if (options.autoConnect !== false) {
+                        await db.connect();
+                        this.logger.log(`Database connected: ${options.config.type}`);
+                    }
+                    return db;
+                },
+            },
+            logger_service_1.LoggerService,
+        ];
+        return {
+            module: DatabaseKitModule_1,
+            providers,
+            exports: [database_constants_1.DATABASE_TOKEN, logger_service_1.LoggerService],
+        };
+    }
+    /**
+     * Configures DatabaseKitModule with asynchronous options.
+     * Useful when configuration depends on other providers like ConfigService.
+     *
+     * @param options - Async module configuration options
+     * @returns Dynamic module configuration
+     */
+    static forRootAsync(options) {
+        const providers = [
+            {
+                provide: database_constants_1.DATABASE_OPTIONS_TOKEN,
+                useFactory: options.useFactory,
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+                inject: (options.inject || []),
+            },
+            {
+                provide: database_constants_1.DATABASE_TOKEN,
+                useFactory: async (moduleOptions) => {
+                    const db = new database_service_1.DatabaseService(moduleOptions.config);
+                    if (moduleOptions.autoConnect !== false) {
+                        await db.connect();
+                        this.logger.log(`Database connected: ${moduleOptions.config.type}`);
+                    }
+                    return db;
+                },
+                inject: [database_constants_1.DATABASE_OPTIONS_TOKEN],
+            },
+            logger_service_1.LoggerService,
+        ];
+        return {
+            module: DatabaseKitModule_1,
+            imports: (options.imports || []),
+            providers,
+            exports: [database_constants_1.DATABASE_TOKEN, logger_service_1.LoggerService],
+        };
+    }
+    /**
+     * Creates a feature module for additional database connections.
+     * Useful for multi-database scenarios.
+     *
+     * @param token - Unique token for this database connection
+     * @param config - Database configuration
+     * @returns Dynamic module configuration
+     */
+    static forFeature(token, config) {
+        const providers = [
+            {
+                provide: token,
+                useFactory: async () => {
+                    const db = new database_service_1.DatabaseService(config);
+                    await db.connect();
+                    this.logger.log(`Feature database connected: ${token} (${config.type})`);
+                    return db;
+                },
+            },
+        ];
+        return {
+            module: DatabaseKitModule_1,
+            providers,
+            exports: [token],
+        };
+    }
+};
+exports.DatabaseKitModule = DatabaseKitModule;
+DatabaseKitModule.logger = new common_1.Logger(DatabaseKitModule_1.name);
+exports.DatabaseKitModule = DatabaseKitModule = DatabaseKitModule_1 = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({})
+], DatabaseKitModule);
+//# sourceMappingURL=database-kit.module.js.map

package/dist/database-kit.module.js.map

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

package/dist/filters/database-exception.filter.d.ts

@@ -0,0 +1,51 @@
+import { ExceptionFilter, ArgumentsHost } from '@nestjs/common';
+/**
+ * Global exception filter for handling database-related errors.
+ * Catches and formats various database errors into consistent HTTP responses.
+ *
+ * @example
+ * ```typescript
+ * // In main.ts or a module
+ * app.useGlobalFilters(new DatabaseExceptionFilter());
+ *
+ * // Or in a module
+ * @Module({
+ *   providers: [
+ *     { provide: APP_FILTER, useClass: DatabaseExceptionFilter },
+ *   ],
+ * })
+ * ```
+ */
+export declare class DatabaseExceptionFilter implements ExceptionFilter {
+    private readonly logger;
+    catch(exception: unknown, host: ArgumentsHost): void;
+    /**
+     * Parses an exception and extracts status code, message, and error type.
+     */
+    private parseException;
+    /**
+     * Checks if the exception is a MongoDB error.
+     */
+    private isMongoError;
+    /**
+     * Parses MongoDB-specific errors.
+     */
+    private parseMongoError;
+    /**
+     * Checks if the exception is a Knex/PostgreSQL error.
+     */
+    private isKnexError;
+    /**
+     * Parses PostgreSQL/Knex-specific errors.
+     */
+    private parseKnexError;
+    /**
+     * Checks if the exception is a validation error.
+     */
+    private isValidationError;
+    /**
+     * Logs the error with appropriate level and context.
+     */
+    private logError;
+}
+//# sourceMappingURL=database-exception.filter.d.ts.map

package/dist/filters/database-exception.filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-exception.filter.d.ts","sourceRoot":"","sources":["../../src/filters/database-exception.filter.ts"],"names":[],"mappings":"AAEA,OAAO,EACH,eAAe,EAEf,aAAa,EAIhB,MAAM,gBAAgB,CAAC;AAaxB;;;;;;;;;;;;;;;;GAgBG;AACH,qBACa,uBAAwB,YAAW,eAAe;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4C;IAEnE,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI;IAqBpD;;OAEG;IACH,OAAO,CAAC,cAAc;IAuDtB;;OAEG;IACH,OAAO,CAAC,YAAY;IAYpB;;OAEG;IACH,OAAO,CAAC,eAAe;IAyCvB;;OAEG;IACH,OAAO,CAAC,WAAW;IAOnB;;OAEG;IACH,OAAO,CAAC,cAAc;IA2DtB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;IACH,OAAO,CAAC,QAAQ;CAcnB"}