@ciscode/database-kit 1.0.0

package/dist/filters/database-exception.filter.js

@@ -0,0 +1,236 @@
+"use strict";
+// src/filters/database-exception.filter.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 DatabaseExceptionFilter_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DatabaseExceptionFilter = void 0;
+const common_1 = require("@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 },
+ *   ],
+ * })
+ * ```
+ */
+let DatabaseExceptionFilter = DatabaseExceptionFilter_1 = class DatabaseExceptionFilter {
+    constructor() {
+        this.logger = new common_1.Logger(DatabaseExceptionFilter_1.name);
+    }
+    catch(exception, host) {
+        var _a, _b, _c;
+        const ctx = host.switchToHttp();
+        const response = ctx.getResponse();
+        const request = ctx.getRequest();
+        const { statusCode, message, error } = this.parseException(exception);
+        const errorResponse = {
+            statusCode,
+            message,
+            error,
+            timestamp: new Date().toISOString(),
+            path: (request === null || request === void 0 ? void 0 : request.url) || '/',
+        };
+        // Log the error
+        this.logError(exception, errorResponse);
+        (_c = (_b = (_a = response === null || response === void 0 ? void 0 : response.status) === null || _a === void 0 ? void 0 : _a.call(response, statusCode)) === null || _b === void 0 ? void 0 : _b.json) === null || _c === void 0 ? void 0 : _c.call(_b, errorResponse);
+    }
+    /**
+     * Parses an exception and extracts status code, message, and error type.
+     */
+    parseException(exception) {
+        // Handle NestJS HTTP exceptions
+        if (exception instanceof common_1.HttpException) {
+            const response = exception.getResponse();
+            const message = typeof response === 'string'
+                ? response
+                : response.message || exception.message;
+            return {
+                statusCode: exception.getStatus(),
+                message,
+                error: exception.name,
+            };
+        }
+        // Handle MongoDB errors
+        if (this.isMongoError(exception)) {
+            return this.parseMongoError(exception);
+        }
+        // Handle PostgreSQL/Knex errors
+        if (this.isKnexError(exception)) {
+            return this.parseKnexError(exception);
+        }
+        // Handle validation errors (class-validator)
+        if (this.isValidationError(exception)) {
+            return {
+                statusCode: common_1.HttpStatus.BAD_REQUEST,
+                message: exception.message,
+                error: 'ValidationError',
+            };
+        }
+        // Handle generic errors
+        if (exception instanceof Error) {
+            return {
+                statusCode: common_1.HttpStatus.INTERNAL_SERVER_ERROR,
+                message: exception.message || 'An unexpected error occurred',
+                error: exception.name || 'InternalServerError',
+            };
+        }
+        // Fallback for unknown errors
+        return {
+            statusCode: common_1.HttpStatus.INTERNAL_SERVER_ERROR,
+            message: 'An unexpected error occurred',
+            error: 'InternalServerError',
+        };
+    }
+    /**
+     * Checks if the exception is a MongoDB error.
+     */
+    isMongoError(exception) {
+        if (!exception || typeof exception !== 'object')
+            return false;
+        const err = exception;
+        return (err.name === 'MongoError' ||
+            err.name === 'MongoServerError' ||
+            err.name === 'MongooseError' ||
+            err.name === 'CastError' ||
+            err.name === 'ValidationError');
+    }
+    /**
+     * Parses MongoDB-specific errors.
+     */
+    parseMongoError(exception) {
+        const err = exception;
+        // Duplicate key error
+        if (err.code === 11000) {
+            return {
+                statusCode: common_1.HttpStatus.CONFLICT,
+                message: 'A record with this value already exists',
+                error: 'DuplicateKeyError',
+            };
+        }
+        // Cast error (invalid ObjectId, etc.)
+        if (err.name === 'CastError') {
+            return {
+                statusCode: common_1.HttpStatus.BAD_REQUEST,
+                message: 'Invalid ID format',
+                error: 'CastError',
+            };
+        }
+        // Mongoose validation error
+        if (err.name === 'ValidationError') {
+            return {
+                statusCode: common_1.HttpStatus.BAD_REQUEST,
+                message: err.message,
+                error: 'ValidationError',
+            };
+        }
+        return {
+            statusCode: common_1.HttpStatus.INTERNAL_SERVER_ERROR,
+            message: 'Database operation failed',
+            error: 'DatabaseError',
+        };
+    }
+    /**
+     * Checks if the exception is a Knex/PostgreSQL error.
+     */
+    isKnexError(exception) {
+        if (!exception || typeof exception !== 'object')
+            return false;
+        const err = exception;
+        // PostgreSQL error codes start with numbers
+        return typeof err.code === 'string' && /^[0-9A-Z]{5}$/.test(err.code);
+    }
+    /**
+     * Parses PostgreSQL/Knex-specific errors.
+     */
+    parseKnexError(exception) {
+        const err = exception;
+        // Unique constraint violation
+        if (err.code === '23505') {
+            return {
+                statusCode: common_1.HttpStatus.CONFLICT,
+                message: `A record with this value already exists${err.constraint ? ` (${err.constraint})` : ''}`,
+                error: 'UniqueConstraintViolation',
+            };
+        }
+        // Foreign key violation
+        if (err.code === '23503') {
+            return {
+                statusCode: common_1.HttpStatus.BAD_REQUEST,
+                message: 'Referenced record does not exist',
+                error: 'ForeignKeyViolation',
+            };
+        }
+        // Not null violation
+        if (err.code === '23502') {
+            return {
+                statusCode: common_1.HttpStatus.BAD_REQUEST,
+                message: 'Required field is missing',
+                error: 'NotNullViolation',
+            };
+        }
+        // Check constraint violation
+        if (err.code === '23514') {
+            return {
+                statusCode: common_1.HttpStatus.BAD_REQUEST,
+                message: 'Value does not meet constraint requirements',
+                error: 'CheckConstraintViolation',
+            };
+        }
+        // Connection errors
+        if (err.code === '08006' || err.code === '08001' || err.code === '08004') {
+            return {
+                statusCode: common_1.HttpStatus.SERVICE_UNAVAILABLE,
+                message: 'Database connection error',
+                error: 'ConnectionError',
+            };
+        }
+        return {
+            statusCode: common_1.HttpStatus.INTERNAL_SERVER_ERROR,
+            message: 'Database operation failed',
+            error: 'DatabaseError',
+        };
+    }
+    /**
+     * Checks if the exception is a validation error.
+     */
+    isValidationError(exception) {
+        if (!exception || typeof exception !== 'object')
+            return false;
+        const err = exception;
+        return err.name === 'ValidationError';
+    }
+    /**
+     * Logs the error with appropriate level and context.
+     */
+    logError(exception, errorResponse) {
+        const { statusCode, message, error, path } = errorResponse;
+        if (statusCode >= 500) {
+            this.logger.error(`[${error}] ${message} - ${path}`, exception instanceof Error ? exception.stack : undefined);
+        }
+        else if (statusCode >= 400) {
+            this.logger.warn(`[${error}] ${message} - ${path}`);
+        }
+        else {
+            this.logger.log(`[${error}] ${message} - ${path}`);
+        }
+    }
+};
+exports.DatabaseExceptionFilter = DatabaseExceptionFilter;
+exports.DatabaseExceptionFilter = DatabaseExceptionFilter = DatabaseExceptionFilter_1 = __decorate([
+    (0, common_1.Catch)()
+], DatabaseExceptionFilter);
+//# sourceMappingURL=database-exception.filter.js.map

package/dist/filters/database-exception.filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-exception.filter.js","sourceRoot":"","sources":["../../src/filters/database-exception.filter.ts"],"names":[],"mappings":";AAAA,2CAA2C;;;;;;;;;;AAE3C,2CAOwB;AAaxB;;;;;;;;;;;;;;;;GAgBG;AAEI,IAAM,uBAAuB,+BAA7B,MAAM,uBAAuB;IAA7B;QACc,WAAM,GAAG,IAAI,eAAM,CAAC,yBAAuB,CAAC,IAAI,CAAC,CAAC;IA8OvE,CAAC;IA5OG,KAAK,CAAC,SAAkB,EAAE,IAAmB;;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,EAAE,CAAC;QAEjC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QAEtE,MAAM,aAAa,GAAkB;YACjC,UAAU;YACV,OAAO;YACP,KAAK;YACL,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,IAAI,EAAE,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,GAAG,KAAI,GAAG;SAC5B,CAAC;QAEF,gBAAgB;QAChB,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QAExC,MAAA,MAAA,MAAA,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,MAAM,yDAAG,UAAU,CAAC,0CAAE,IAAI,mDAAG,aAAa,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,SAAkB;QAKrC,gCAAgC;QAChC,IAAI,SAAS,YAAY,sBAAa,EAAE,CAAC;YACrC,MAAM,QAAQ,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;YACzC,MAAM,OAAO,GAAG,OAAO,QAAQ,KAAK,QAAQ;gBACxC,CAAC,CAAC,QAAQ;gBACV,CAAC,CAAE,QAAiC,CAAC,OAAO,IAAI,SAAS,CAAC,OAAO,CAAC;YAEtE,OAAO;gBACH,UAAU,EAAE,SAAS,CAAC,SAAS,EAAE;gBACjC,OAAO;gBACP,KAAK,EAAE,SAAS,CAAC,IAAI;aACxB,CAAC;QACN,CAAC;QAED,wBAAwB;QACxB,IAAI,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;QAC3C,CAAC;QAED,gCAAgC;QAChC,IAAI,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QAC1C,CAAC;QAED,6CAA6C;QAC7C,IAAI,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC;YACpC,OAAO;gBACH,UAAU,EAAE,mBAAU,CAAC,WAAW;gBAClC,OAAO,EAAG,SAAiC,CAAC,OAAO;gBACnD,KAAK,EAAE,iBAAiB;aAC3B,CAAC;QACN,CAAC;QAED,wBAAwB;QACxB,IAAI,SAAS,YAAY,KAAK,EAAE,CAAC;YAC7B,OAAO;gBACH,UAAU,EAAE,mBAAU,CAAC,qBAAqB;gBAC5C,OAAO,EAAE,SAAS,CAAC,OAAO,IAAI,8BAA8B;gBAC5D,KAAK,EAAE,SAAS,CAAC,IAAI,IAAI,qBAAqB;aACjD,CAAC;QACN,CAAC;QAED,8BAA8B;QAC9B,OAAO;YACH,UAAU,EAAE,mBAAU,CAAC,qBAAqB;YAC5C,OAAO,EAAE,8BAA8B;YACvC,KAAK,EAAE,qBAAqB;SAC/B,CAAC;IACN,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,SAAkB;QACnC,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC9D,MAAM,GAAG,GAAG,SAA8B,CAAC;QAC3C,OAAO,CACH,GAAG,CAAC,IAAI,KAAK,YAAY;YACzB,GAAG,CAAC,IAAI,KAAK,kBAAkB;YAC/B,GAAG,CAAC,IAAI,KAAK,eAAe;YAC5B,GAAG,CAAC,IAAI,KAAK,WAAW;YACxB,GAAG,CAAC,IAAI,KAAK,iBAAiB,CACjC,CAAC;IACN,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,SAAkB;QAKtC,MAAM,GAAG,GAAG,SAA6D,CAAC;QAE1E,sBAAsB;QACtB,IAAI,GAAG,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YACrB,OAAO;gBACH,UAAU,EAAE,mBAAU,CAAC,QAAQ;gBAC/B,OAAO,EAAE,yCAAyC;gBAClD,KAAK,EAAE,mBAAmB;aAC7B,CAAC;QACN,CAAC;QAED,sCAAsC;QACtC,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC3B,OAAO;gBACH,UAAU,EAAE,mBAAU,CAAC,WAAW;gBAClC,OAAO,EAAE,mBAAmB;gBAC5B,KAAK,EAAE,WAAW;aACrB,CAAC;QACN,CAAC;QAED,4BAA4B;QAC5B,IAAI,GAAG,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;YACjC,OAAO;gBACH,UAAU,EAAE,mBAAU,CAAC,WAAW;gBAClC,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,KAAK,EAAE,iBAAiB;aAC3B,CAAC;QACN,CAAC;QAED,OAAO;YACH,UAAU,EAAE,mBAAU,CAAC,qBAAqB;YAC5C,OAAO,EAAE,2BAA2B;YACpC,KAAK,EAAE,eAAe;SACzB,CAAC;IACN,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,SAAkB;QAClC,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC9D,MAAM,GAAG,GAAG,SAA8B,CAAC;QAC3C,4CAA4C;QAC5C,OAAO,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1E,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,SAAkB;QAKrC,MAAM,GAAG,GAAG,SAAmE,CAAC;QAEhF,8BAA8B;QAC9B,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACvB,OAAO;gBACH,UAAU,EAAE,mBAAU,CAAC,QAAQ;gBAC/B,OAAO,EAAE,0CAA0C,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACjG,KAAK,EAAE,2BAA2B;aACrC,CAAC;QACN,CAAC;QAED,wBAAwB;QACxB,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACvB,OAAO;gBACH,UAAU,EAAE,mBAAU,CAAC,WAAW;gBAClC,OAAO,EAAE,kCAAkC;gBAC3C,KAAK,EAAE,qBAAqB;aAC/B,CAAC;QACN,CAAC;QAED,qBAAqB;QACrB,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACvB,OAAO;gBACH,UAAU,EAAE,mBAAU,CAAC,WAAW;gBAClC,OAAO,EAAE,2BAA2B;gBACpC,KAAK,EAAE,kBAAkB;aAC5B,CAAC;QACN,CAAC;QAED,6BAA6B;QAC7B,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACvB,OAAO;gBACH,UAAU,EAAE,mBAAU,CAAC,WAAW;gBAClC,OAAO,EAAE,6CAA6C;gBACtD,KAAK,EAAE,0BAA0B;aACpC,CAAC;QACN,CAAC;QAED,oBAAoB;QACpB,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACvE,OAAO;gBACH,UAAU,EAAE,mBAAU,CAAC,mBAAmB;gBAC1C,OAAO,EAAE,2BAA2B;gBACpC,KAAK,EAAE,iBAAiB;aAC3B,CAAC;QACN,CAAC;QAED,OAAO;YACH,UAAU,EAAE,mBAAU,CAAC,qBAAqB;YAC5C,OAAO,EAAE,2BAA2B;YACpC,KAAK,EAAE,eAAe;SACzB,CAAC;IACN,CAAC;IAED;;OAEG;IACK,iBAAiB,CAAC,SAAkB;QACxC,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC9D,MAAM,GAAG,GAAG,SAA8B,CAAC;QAC3C,OAAO,GAAG,CAAC,IAAI,KAAK,iBAAiB,CAAC;IAC1C,CAAC;IAED;;OAEG;IACK,QAAQ,CAAC,SAAkB,EAAE,aAA4B;QAC7D,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,aAAa,CAAC;QAE3D,IAAI,UAAU,IAAI,GAAG,EAAE,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,KAAK,CACb,IAAI,KAAK,KAAK,OAAO,MAAM,IAAI,EAAE,EACjC,SAAS,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAC3D,CAAC;QACN,CAAC;aAAM,IAAI,UAAU,IAAI,GAAG,EAAE,CAAC;YAC3B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,KAAK,OAAO,MAAM,IAAI,EAAE,CAAC,CAAC;QACxD,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,OAAO,MAAM,IAAI,EAAE,CAAC,CAAC;QACvD,CAAC;IACL,CAAC;CACJ,CAAA;AA/OY,0DAAuB;kCAAvB,uBAAuB;IADnC,IAAA,cAAK,GAAE;GACK,uBAAuB,CA+OnC"}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @ciscode/database-kit
+ *
+ * A NestJS-friendly, OOP-style database library providing a unified
+ * repository API for MongoDB and PostgreSQL.
+ *
+ * @packageDocumentation
+ */
+export { DatabaseKitModule } from './database-kit.module';
+export { DatabaseService } from './services/database.service';
+export { LoggerService } from './services/logger.service';
+export { InjectDatabase, InjectDatabaseByToken } from './middleware/database.decorators';
+export { DatabaseExceptionFilter } from './filters/database-exception.filter';
+export { DatabaseConfigHelper } from './config/database.config';
+export { DATABASE_TOKEN, DATABASE_OPTIONS_TOKEN, ENV_KEYS, DEFAULTS } from './config/database.constants';
+export { DatabaseType, DatabaseConfig, MongoDatabaseConfig, PostgresDatabaseConfig, DatabaseKitModuleOptions, DatabaseKitModuleAsyncOptions, InjectionToken, OptionalFactoryDependency, Repository, PageResult, PageOptions, MongoRepositoryOptions, PostgresEntityConfig, DATABASE_KIT_CONSTANTS, } from './contracts/database.contracts';
+export { normalizePaginationOptions, calculatePagination, createPageResult, parseSortString, calculateOffset, } from './utils/pagination.utils';
+export { isValidMongoId, isValidUuid, isPositiveInteger, sanitizeFilter, validateRequiredFields, pickFields, omitFields, } from './utils/validation.utils';
+//# 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":"AAEA;;;;;;;GAOG;AAUH,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAM1D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAM1D,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAMzF,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAM9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAMzG,OAAO,EAEH,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EAGtB,wBAAwB,EACxB,6BAA6B,EAC7B,cAAc,EACd,yBAAyB,EAGzB,UAAU,EAGV,UAAU,EACV,WAAW,EAGX,sBAAsB,EACtB,oBAAoB,EAGpB,sBAAsB,GACzB,MAAM,gCAAgC,CAAC;AAMxC,OAAO,EACH,0BAA0B,EAC1B,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,eAAe,GAClB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACH,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,UAAU,EACV,UAAU,GACb,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,78 @@
+"use strict";
+// src/index.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.omitFields = exports.pickFields = exports.validateRequiredFields = exports.sanitizeFilter = exports.isPositiveInteger = exports.isValidUuid = exports.isValidMongoId = exports.calculateOffset = exports.parseSortString = exports.createPageResult = exports.calculatePagination = exports.normalizePaginationOptions = exports.DATABASE_KIT_CONSTANTS = exports.DEFAULTS = exports.ENV_KEYS = exports.DATABASE_OPTIONS_TOKEN = exports.DATABASE_TOKEN = exports.DatabaseConfigHelper = exports.DatabaseExceptionFilter = exports.InjectDatabaseByToken = exports.InjectDatabase = exports.LoggerService = exports.DatabaseService = exports.DatabaseKitModule = void 0;
+/**
+ * @ciscode/database-kit
+ *
+ * A NestJS-friendly, OOP-style database library providing a unified
+ * repository API for MongoDB and PostgreSQL.
+ *
+ * @packageDocumentation
+ */
+// =============================================================================
+// PUBLIC API - Only export what host apps MUST use
+// =============================================================================
+// -----------------------------------------------------------------------------
+// Module (Primary export)
+// -----------------------------------------------------------------------------
+var database_kit_module_1 = require("./database-kit.module");
+Object.defineProperty(exports, "DatabaseKitModule", { enumerable: true, get: function () { return database_kit_module_1.DatabaseKitModule; } });
+// -----------------------------------------------------------------------------
+// Services (For direct injection if needed)
+// -----------------------------------------------------------------------------
+var database_service_1 = require("./services/database.service");
+Object.defineProperty(exports, "DatabaseService", { enumerable: true, get: function () { return database_service_1.DatabaseService; } });
+var logger_service_1 = require("./services/logger.service");
+Object.defineProperty(exports, "LoggerService", { enumerable: true, get: function () { return logger_service_1.LoggerService; } });
+// -----------------------------------------------------------------------------
+// Decorators (For dependency injection)
+// -----------------------------------------------------------------------------
+var database_decorators_1 = require("./middleware/database.decorators");
+Object.defineProperty(exports, "InjectDatabase", { enumerable: true, get: function () { return database_decorators_1.InjectDatabase; } });
+Object.defineProperty(exports, "InjectDatabaseByToken", { enumerable: true, get: function () { return database_decorators_1.InjectDatabaseByToken; } });
+// -----------------------------------------------------------------------------
+// Filters (For global exception handling)
+// -----------------------------------------------------------------------------
+var database_exception_filter_1 = require("./filters/database-exception.filter");
+Object.defineProperty(exports, "DatabaseExceptionFilter", { enumerable: true, get: function () { return database_exception_filter_1.DatabaseExceptionFilter; } });
+// -----------------------------------------------------------------------------
+// Configuration Helpers (For advanced configuration)
+// -----------------------------------------------------------------------------
+var database_config_1 = require("./config/database.config");
+Object.defineProperty(exports, "DatabaseConfigHelper", { enumerable: true, get: function () { return database_config_1.DatabaseConfigHelper; } });
+var database_constants_1 = require("./config/database.constants");
+Object.defineProperty(exports, "DATABASE_TOKEN", { enumerable: true, get: function () { return database_constants_1.DATABASE_TOKEN; } });
+Object.defineProperty(exports, "DATABASE_OPTIONS_TOKEN", { enumerable: true, get: function () { return database_constants_1.DATABASE_OPTIONS_TOKEN; } });
+Object.defineProperty(exports, "ENV_KEYS", { enumerable: true, get: function () { return database_constants_1.ENV_KEYS; } });
+Object.defineProperty(exports, "DEFAULTS", { enumerable: true, get: function () { return database_constants_1.DEFAULTS; } });
+// -----------------------------------------------------------------------------
+// Contracts (Types and Interfaces for consumers)
+// -----------------------------------------------------------------------------
+var database_contracts_1 = require("./contracts/database.contracts");
+// Constants
+Object.defineProperty(exports, "DATABASE_KIT_CONSTANTS", { enumerable: true, get: function () { return database_contracts_1.DATABASE_KIT_CONSTANTS; } });
+// -----------------------------------------------------------------------------
+// Utilities (For common operations)
+// -----------------------------------------------------------------------------
+var pagination_utils_1 = require("./utils/pagination.utils");
+Object.defineProperty(exports, "normalizePaginationOptions", { enumerable: true, get: function () { return pagination_utils_1.normalizePaginationOptions; } });
+Object.defineProperty(exports, "calculatePagination", { enumerable: true, get: function () { return pagination_utils_1.calculatePagination; } });
+Object.defineProperty(exports, "createPageResult", { enumerable: true, get: function () { return pagination_utils_1.createPageResult; } });
+Object.defineProperty(exports, "parseSortString", { enumerable: true, get: function () { return pagination_utils_1.parseSortString; } });
+Object.defineProperty(exports, "calculateOffset", { enumerable: true, get: function () { return pagination_utils_1.calculateOffset; } });
+var validation_utils_1 = require("./utils/validation.utils");
+Object.defineProperty(exports, "isValidMongoId", { enumerable: true, get: function () { return validation_utils_1.isValidMongoId; } });
+Object.defineProperty(exports, "isValidUuid", { enumerable: true, get: function () { return validation_utils_1.isValidUuid; } });
+Object.defineProperty(exports, "isPositiveInteger", { enumerable: true, get: function () { return validation_utils_1.isPositiveInteger; } });
+Object.defineProperty(exports, "sanitizeFilter", { enumerable: true, get: function () { return validation_utils_1.sanitizeFilter; } });
+Object.defineProperty(exports, "validateRequiredFields", { enumerable: true, get: function () { return validation_utils_1.validateRequiredFields; } });
+Object.defineProperty(exports, "pickFields", { enumerable: true, get: function () { return validation_utils_1.pickFields; } });
+Object.defineProperty(exports, "omitFields", { enumerable: true, get: function () { return validation_utils_1.omitFields; } });
+// =============================================================================
+// NOT EXPORTED (Internal implementation details)
+// =============================================================================
+// ❌ MongoAdapter - Internal adapter, use DatabaseService instead
+// ❌ PostgresAdapter - Internal adapter, use DatabaseService instead
+// ❌ Internal helper functions
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,eAAe;;;AAEf;;;;;;;GAOG;AAEH,gFAAgF;AAChF,mDAAmD;AACnD,gFAAgF;AAEhF,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAEhF,6DAA0D;AAAjD,wHAAA,iBAAiB,OAAA;AAE1B,gFAAgF;AAChF,4CAA4C;AAC5C,gFAAgF;AAEhF,gEAA8D;AAArD,mHAAA,eAAe,OAAA;AACxB,4DAA0D;AAAjD,+GAAA,aAAa,OAAA;AAEtB,gFAAgF;AAChF,wCAAwC;AACxC,gFAAgF;AAEhF,wEAAyF;AAAhF,qHAAA,cAAc,OAAA;AAAE,4HAAA,qBAAqB,OAAA;AAE9C,gFAAgF;AAChF,0CAA0C;AAC1C,gFAAgF;AAEhF,iFAA8E;AAArE,oIAAA,uBAAuB,OAAA;AAEhC,gFAAgF;AAChF,qDAAqD;AACrD,gFAAgF;AAEhF,4DAAgE;AAAvD,uHAAA,oBAAoB,OAAA;AAC7B,kEAAyG;AAAhG,oHAAA,cAAc,OAAA;AAAE,4HAAA,sBAAsB,OAAA;AAAE,8GAAA,QAAQ,OAAA;AAAE,8GAAA,QAAQ,OAAA;AAEnE,gFAAgF;AAChF,iDAAiD;AACjD,gFAAgF;AAEhF,qEA0BwC;AAFpC,YAAY;AACZ,4HAAA,sBAAsB,OAAA;AAG1B,gFAAgF;AAChF,oCAAoC;AACpC,gFAAgF;AAEhF,6DAMkC;AAL9B,8HAAA,0BAA0B,OAAA;AAC1B,uHAAA,mBAAmB,OAAA;AACnB,oHAAA,gBAAgB,OAAA;AAChB,mHAAA,eAAe,OAAA;AACf,mHAAA,eAAe,OAAA;AAGnB,6DAQkC;AAP9B,kHAAA,cAAc,OAAA;AACd,+GAAA,WAAW,OAAA;AACX,qHAAA,iBAAiB,OAAA;AACjB,kHAAA,cAAc,OAAA;AACd,0HAAA,sBAAsB,OAAA;AACtB,8GAAA,UAAU,OAAA;AACV,8GAAA,UAAU,OAAA;AAGd,gFAAgF;AAChF,iDAAiD;AACjD,gFAAgF;AAEhF,iEAAiE;AACjE,oEAAoE;AACpE,8BAA8B"}

package/dist/middleware/database.decorators.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Decorator to inject the DatabaseService instance.
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * export class UserService {
+ *   constructor(@InjectDatabase() private readonly db: DatabaseService) {}
+ * }
+ * ```
+ */
+export declare const InjectDatabase: () => ParameterDecorator;
+/**
+ * Creates a custom injection decorator for a named database connection.
+ * Use this when working with multiple database connections.
+ *
+ * @param token - The token used when registering the database with forFeature()
+ * @returns Parameter decorator
+ *
+ * @example
+ * ```typescript
+ * const InjectAnalyticsDb = () => InjectDatabaseByToken('ANALYTICS_DB');
+ *
+ * @Injectable()
+ * export class AnalyticsService {
+ *   constructor(@InjectAnalyticsDb() private readonly db: DatabaseService) {}
+ * }
+ * ```
+ */
+export declare const InjectDatabaseByToken: (token: string) => ParameterDecorator;
+//# sourceMappingURL=database.decorators.d.ts.map

package/dist/middleware/database.decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.decorators.d.ts","sourceRoot":"","sources":["../../src/middleware/database.decorators.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,QAAO,kBAA4C,CAAC;AAE/E;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,qBAAqB,GAAI,OAAO,MAAM,KAAG,kBAAmC,CAAC"}

package/dist/middleware/database.decorators.js

@@ -0,0 +1,39 @@
+"use strict";
+// src/middleware/database.decorators.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InjectDatabaseByToken = exports.InjectDatabase = void 0;
+const common_1 = require("@nestjs/common");
+const database_constants_1 = require("../config/database.constants");
+/**
+ * Decorator to inject the DatabaseService instance.
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * export class UserService {
+ *   constructor(@InjectDatabase() private readonly db: DatabaseService) {}
+ * }
+ * ```
+ */
+const InjectDatabase = () => (0, common_1.Inject)(database_constants_1.DATABASE_TOKEN);
+exports.InjectDatabase = InjectDatabase;
+/**
+ * Creates a custom injection decorator for a named database connection.
+ * Use this when working with multiple database connections.
+ *
+ * @param token - The token used when registering the database with forFeature()
+ * @returns Parameter decorator
+ *
+ * @example
+ * ```typescript
+ * const InjectAnalyticsDb = () => InjectDatabaseByToken('ANALYTICS_DB');
+ *
+ * @Injectable()
+ * export class AnalyticsService {
+ *   constructor(@InjectAnalyticsDb() private readonly db: DatabaseService) {}
+ * }
+ * ```
+ */
+const InjectDatabaseByToken = (token) => (0, common_1.Inject)(token);
+exports.InjectDatabaseByToken = InjectDatabaseByToken;
+//# sourceMappingURL=database.decorators.js.map

package/dist/middleware/database.decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.decorators.js","sourceRoot":"","sources":["../../src/middleware/database.decorators.ts"],"names":[],"mappings":";AAAA,wCAAwC;;;AAExC,2CAAwC;AACxC,qEAA8D;AAE9D;;;;;;;;;;GAUG;AACI,MAAM,cAAc,GAAG,GAAuB,EAAE,CAAC,IAAA,eAAM,EAAC,mCAAc,CAAC,CAAC;AAAlE,QAAA,cAAc,kBAAoD;AAE/E;;;;;;;;;;;;;;;;GAgBG;AACI,MAAM,qBAAqB,GAAG,CAAC,KAAa,EAAsB,EAAE,CAAC,IAAA,eAAM,EAAC,KAAK,CAAC,CAAC;AAA7E,QAAA,qBAAqB,yBAAwD"}

package/dist/services/database.service.d.ts

@@ -0,0 +1,99 @@
+import { OnModuleDestroy } from '@nestjs/common';
+import { DatabaseConfig, MongoRepositoryOptions, PostgresEntityConfig, Repository } from '../contracts/database.contracts';
+import { MongoAdapter } from '../adapters/mongo.adapter';
+import { PostgresAdapter } from '../adapters/postgres.adapter';
+/**
+ * Main database service that provides a unified interface
+ * for database operations across MongoDB and PostgreSQL.
+ *
+ * This service acts as a facade over the underlying adapters,
+ * providing a clean API for creating repositories and managing connections.
+ *
+ * @example
+ * ```typescript
+ * // In a NestJS service
+ * @Injectable()
+ * export class UserService {
+ *   private readonly usersRepo: Repository<User>;
+ *
+ *   constructor(@InjectDatabase() private readonly db: DatabaseService) {
+ *     this.usersRepo = db.createMongoRepository({ model: UserModel });
+ *   }
+ * }
+ * ```
+ */
+export declare class DatabaseService implements OnModuleDestroy {
+    private readonly logger;
+    private readonly config;
+    private mongoAdapter?;
+    private postgresAdapter?;
+    constructor(config: DatabaseConfig);
+    /**
+     * Lifecycle hook called when the module is being destroyed.
+     * Gracefully closes all database connections.
+     */
+    onModuleDestroy(): Promise<void>;
+    /**
+     * Returns the current database type.
+     */
+    get type(): 'mongo' | 'postgres';
+    /**
+     * Checks if the database is connected.
+     */
+    isConnected(): boolean;
+    /**
+     * Initializes the underlying driver connection.
+     * Must be awaited before using repositories.
+     */
+    connect(): Promise<void>;
+    /**
+     * Gracefully disconnects from the database.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Creates a MongoDB repository using a Mongoose model.
+     *
+     * @param options - Options containing the Mongoose model
+     * @returns Repository instance with CRUD methods
+     * @throws Error if database type is not 'mongo'
+     *
+     * @example
+     * ```typescript
+     * const usersRepo = db.createMongoRepository<User>({ model: UserModel });
+     * const user = await usersRepo.create({ name: 'John' });
+     * ```
+     */
+    createMongoRepository<T = unknown>(options: MongoRepositoryOptions): Repository<T>;
+    /**
+     * Creates a PostgreSQL repository using a table configuration.
+     *
+     * @param cfg - Configuration for the entity/table
+     * @returns Repository instance with CRUD methods
+     * @throws Error if database type is not 'postgres'
+     *
+     * @example
+     * ```typescript
+     * const ordersRepo = db.createPostgresRepository<Order>({
+     *   table: 'orders',
+     *   primaryKey: 'id',
+     *   columns: ['id', 'user_id', 'total', 'created_at'],
+     * });
+     * ```
+     */
+    createPostgresRepository<T = unknown>(cfg: PostgresEntityConfig): Repository<T>;
+    /**
+     * Returns the underlying MongoDB adapter.
+     * Useful for advanced operations not covered by the repository interface.
+     *
+     * @throws Error if database type is not 'mongo'
+     */
+    getMongoAdapter(): MongoAdapter;
+    /**
+     * Returns the underlying PostgreSQL adapter.
+     * Useful for advanced operations not covered by the repository interface.
+     *
+     * @throws Error if database type is not 'postgres'
+     */
+    getPostgresAdapter(): PostgresAdapter;
+}
+//# sourceMappingURL=database.service.d.ts.map

package/dist/services/database.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.service.d.ts","sourceRoot":"","sources":["../../src/services/database.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAsB,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EACH,cAAc,EAGd,sBAAsB,EACtB,oBAAoB,EACpB,UAAU,EACb,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBACa,eAAgB,YAAW,eAAe;IACnD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IAExC,OAAO,CAAC,YAAY,CAAC,CAAe;IACpC,OAAO,CAAC,eAAe,CAAC,CAAkB;gBAE9B,MAAM,EAAE,cAAc;IAKlC;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtC;;OAEG;IACH,IAAI,IAAI,IAAI,OAAO,GAAG,UAAU,CAE/B;IAED;;OAEG;IACH,WAAW,IAAI,OAAO;IAWtB;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBjC;;;;;;;;;;;;OAYG;IACH,qBAAqB,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,sBAAsB,GAAG,UAAU,CAAC,CAAC,CAAC;IAclF;;;;;;;;;;;;;;;OAeG;IACH,wBAAwB,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,oBAAoB,GAAG,UAAU,CAAC,CAAC,CAAC;IAe/E;;;;;OAKG;IACH,eAAe,IAAI,YAAY;IAY/B;;;;;OAKG;IACH,kBAAkB,IAAI,eAAe;CAWxC"}