@stefaninigo/core 0.9.0

package/dist/libs/stefaninigo/core/dtos/problem-details.dto.js

@@ -0,0 +1,84 @@
+"use strict";
+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 __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProblemDetailsDto = exports.ValidationErrorDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+class ValidationErrorDto {
+}
+exports.ValidationErrorDto = ValidationErrorDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Campo que tiene el error',
+        example: 'email',
+    }),
+    __metadata("design:type", String)
+], ValidationErrorDto.prototype, "path", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Codigo del error',
+        example: 'required',
+    }),
+    __metadata("design:type", String)
+], ValidationErrorDto.prototype, "code", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Mensaje descriptivo del error',
+        example: 'El email es requerido',
+    }),
+    __metadata("design:type", String)
+], ValidationErrorDto.prototype, "message", void 0);
+class ProblemDetailsDto {
+}
+exports.ProblemDetailsDto = ProblemDetailsDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Tipo de error (URI)',
+        example: 'https://errors.sg.dev/validation-error',
+    }),
+    __metadata("design:type", String)
+], ProblemDetailsDto.prototype, "type", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Titulo del error',
+        example: 'Validation Error',
+    }),
+    __metadata("design:type", String)
+], ProblemDetailsDto.prototype, "title", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Codigo de estado HTTP',
+        example: 422,
+    }),
+    __metadata("design:type", Number)
+], ProblemDetailsDto.prototype, "status", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Descripcion detallada del error',
+        example: 'The provided payload is invalid.',
+    }),
+    __metadata("design:type", String)
+], ProblemDetailsDto.prototype, "detail", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Instancia especifica del error',
+        example: '/api/v1/resource',
+    }),
+    __metadata("design:type", String)
+], ProblemDetailsDto.prototype, "instance", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Errores de validacion especificos',
+        type: [ValidationErrorDto],
+        required: false,
+    }),
+    __metadata("design:type", Array)
+], ProblemDetailsDto.prototype, "errors", void 0);
+//# sourceMappingURL=problem-details.dto.js.map

package/dist/libs/stefaninigo/core/dtos/problem-details.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"problem-details.dto.js","sourceRoot":"","sources":["../../../../../libs/stefaninigo/src/core/dtos/problem-details.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6CAA8C;AAE9C,MAAa,kBAAkB;CAkB9B;AAlBD,gDAkBC;AAbC;IAJC,IAAA,qBAAW,EAAC;QACX,WAAW,EAAE,0BAA0B;QACvC,OAAO,EAAE,OAAO;KACjB,CAAC;;gDACW;AAMb;IAJC,IAAA,qBAAW,EAAC;QACX,WAAW,EAAE,kBAAkB;QAC/B,OAAO,EAAE,UAAU;KACpB,CAAC;;gDACW;AAMb;IAJC,IAAA,qBAAW,EAAC;QACX,WAAW,EAAE,+BAA+B;QAC5C,OAAO,EAAE,uBAAuB;KACjC,CAAC;;mDACc;AAGlB,MAAa,iBAAiB;CAqC7B;AArCD,8CAqCC;AAhCC;IAJC,IAAA,qBAAW,EAAC;QACX,WAAW,EAAE,qBAAqB;QAClC,OAAO,EAAE,wCAAwC;KAClD,CAAC;;+CACW;AAMb;IAJC,IAAA,qBAAW,EAAC;QACX,WAAW,EAAE,kBAAkB;QAC/B,OAAO,EAAE,kBAAkB;KAC5B,CAAC;;gDACY;AAMd;IAJC,IAAA,qBAAW,EAAC;QACX,WAAW,EAAE,uBAAuB;QACpC,OAAO,EAAE,GAAG;KACb,CAAC;;iDACa;AAMf;IAJC,IAAA,qBAAW,EAAC;QACX,WAAW,EAAE,iCAAiC;QAC9C,OAAO,EAAE,kCAAkC;KAC5C,CAAC;;iDACa;AAMf;IAJC,IAAA,qBAAW,EAAC;QACX,WAAW,EAAE,gCAAgC;QAC7C,OAAO,EAAE,kBAAkB;KAC5B,CAAC;;mDACe;AAOjB;IALC,IAAA,qBAAW,EAAC;QACX,WAAW,EAAE,mCAAmC;QAChD,IAAI,EAAE,CAAC,kBAAkB,CAAC;QAC1B,QAAQ,EAAE,KAAK;KAChB,CAAC;;iDAC4B"}

package/dist/libs/stefaninigo/core/errors/bad-request.error.d.ts

@@ -0,0 +1,4 @@
+import { HttpError } from './http.error';
+export declare class BadRequestError extends HttpError {
+    constructor(message: string, errorCode?: string, details?: any);
+}

package/dist/libs/stefaninigo/core/errors/bad-request.error.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BadRequestError = void 0;
+const common_1 = require("@nestjs/common");
+const http_error_1 = require("./http.error");
+class BadRequestError extends http_error_1.HttpError {
+    constructor(message, errorCode = 'BAD_REQUEST', details) {
+        super(message, common_1.HttpStatus.BAD_REQUEST, errorCode, details);
+    }
+}
+exports.BadRequestError = BadRequestError;
+//# sourceMappingURL=bad-request.error.js.map

package/dist/libs/stefaninigo/core/errors/bad-request.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bad-request.error.js","sourceRoot":"","sources":["../../../../../libs/stefaninigo/src/core/errors/bad-request.error.ts"],"names":[],"mappings":";;;AAAA,2CAA4C;AAC5C,6CAAyC;AAEzC,MAAa,eAAgB,SAAQ,sBAAS;IAC5C,YACE,OAAe,EACf,YAAoB,aAAa,EACjC,OAAa;QAEb,KAAK,CAAC,OAAO,EAAE,mBAAU,CAAC,WAAW,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;CACF;AARD,0CAQC"}

package/dist/libs/stefaninigo/core/errors/conflict.error.d.ts

@@ -0,0 +1,4 @@
+import { HttpError } from './http.error';
+export declare class ConflictError extends HttpError {
+    constructor(message: string, errorCode?: string, details?: any);
+}

package/dist/libs/stefaninigo/core/errors/conflict.error.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConflictError = void 0;
+const common_1 = require("@nestjs/common");
+const http_error_1 = require("./http.error");
+class ConflictError extends http_error_1.HttpError {
+    constructor(message, errorCode = 'CONFLICT', details) {
+        super(message, common_1.HttpStatus.CONFLICT, errorCode, details);
+    }
+}
+exports.ConflictError = ConflictError;
+//# sourceMappingURL=conflict.error.js.map

package/dist/libs/stefaninigo/core/errors/conflict.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict.error.js","sourceRoot":"","sources":["../../../../../libs/stefaninigo/src/core/errors/conflict.error.ts"],"names":[],"mappings":";;;AAAA,2CAA4C;AAC5C,6CAAyC;AAEzC,MAAa,aAAc,SAAQ,sBAAS;IAC1C,YACE,OAAe,EACf,YAAoB,UAAU,EAC9B,OAAa;QAEb,KAAK,CAAC,OAAO,EAAE,mBAAU,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;CACF;AARD,sCAQC"}

package/dist/libs/stefaninigo/core/errors/forbidden.error.d.ts

@@ -0,0 +1,4 @@
+import { HttpError } from './http.error';
+export declare class ForbiddenError extends HttpError {
+    constructor(message: string, errorCode?: string, details?: any);
+}

package/dist/libs/stefaninigo/core/errors/forbidden.error.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ForbiddenError = void 0;
+const common_1 = require("@nestjs/common");
+const http_error_1 = require("./http.error");
+class ForbiddenError extends http_error_1.HttpError {
+    constructor(message, errorCode = 'FORBIDDEN', details) {
+        super(message, common_1.HttpStatus.FORBIDDEN, errorCode, details);
+    }
+}
+exports.ForbiddenError = ForbiddenError;
+//# sourceMappingURL=forbidden.error.js.map

package/dist/libs/stefaninigo/core/errors/forbidden.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forbidden.error.js","sourceRoot":"","sources":["../../../../../libs/stefaninigo/src/core/errors/forbidden.error.ts"],"names":[],"mappings":";;;AAAA,2CAA4C;AAC5C,6CAAyC;AAEzC,MAAa,cAAe,SAAQ,sBAAS;IAC3C,YACE,OAAe,EACf,YAAoB,WAAW,EAC/B,OAAa;QAEb,KAAK,CAAC,OAAO,EAAE,mBAAU,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC;CACF;AARD,wCAQC"}

package/dist/libs/stefaninigo/core/errors/http.error.d.ts

@@ -0,0 +1,6 @@
+import { HttpException, HttpStatus } from '@nestjs/common';
+export declare class HttpError extends HttpException {
+    errorCode: string;
+    details?: any;
+    constructor(message: string, status: HttpStatus, errorCode: string, details?: any);
+}

package/dist/libs/stefaninigo/core/errors/http.error.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpError = void 0;
+const common_1 = require("@nestjs/common");
+class HttpError extends common_1.HttpException {
+    constructor(message, status, errorCode, details) {
+        super(message, status);
+        this.errorCode = errorCode;
+        this.details = details;
+    }
+}
+exports.HttpError = HttpError;
+//# sourceMappingURL=http.error.js.map

package/dist/libs/stefaninigo/core/errors/http.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.error.js","sourceRoot":"","sources":["../../../../../libs/stefaninigo/src/core/errors/http.error.ts"],"names":[],"mappings":";;;AAAA,2CAA2D;AAE3D,MAAa,SAAU,SAAQ,sBAAa;IAI1C,YACE,OAAe,EACf,MAAkB,EAClB,SAAiB,EACjB,OAAa;QAEb,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAdD,8BAcC"}

package/dist/libs/stefaninigo/core/errors/index.d.ts

@@ -0,0 +1,7 @@
+export * from './http.error';
+export * from './bad-request.error';
+export * from './not-found.error';
+export * from './unauthorized.error';
+export * from './forbidden.error';
+export * from './conflict.error';
+export * from './internal-server.error';

package/dist/libs/stefaninigo/core/errors/index.js

@@ -0,0 +1,24 @@
+"use strict";
+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("./http.error"), exports);
+__exportStar(require("./bad-request.error"), exports);
+__exportStar(require("./not-found.error"), exports);
+__exportStar(require("./unauthorized.error"), exports);
+__exportStar(require("./forbidden.error"), exports);
+__exportStar(require("./conflict.error"), exports);
+__exportStar(require("./internal-server.error"), exports);
+//# sourceMappingURL=index.js.map

package/dist/libs/stefaninigo/core/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/stefaninigo/src/core/errors/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,sDAAoC;AACpC,oDAAkC;AAClC,uDAAqC;AACrC,oDAAkC;AAClC,mDAAiC;AACjC,0DAAwC"}

package/dist/libs/stefaninigo/core/errors/internal-server.error.d.ts

@@ -0,0 +1,4 @@
+import { HttpError } from './http.error';
+export declare class InternalServerError extends HttpError {
+    constructor(message: string, errorCode?: string, details?: any);
+}

package/dist/libs/stefaninigo/core/errors/internal-server.error.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InternalServerError = void 0;
+const common_1 = require("@nestjs/common");
+const http_error_1 = require("./http.error");
+class InternalServerError extends http_error_1.HttpError {
+    constructor(message, errorCode = 'INTERNAL_SERVER_ERROR', details) {
+        super(message, common_1.HttpStatus.INTERNAL_SERVER_ERROR, errorCode, details);
+    }
+}
+exports.InternalServerError = InternalServerError;
+//# sourceMappingURL=internal-server.error.js.map

package/dist/libs/stefaninigo/core/errors/internal-server.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-server.error.js","sourceRoot":"","sources":["../../../../../libs/stefaninigo/src/core/errors/internal-server.error.ts"],"names":[],"mappings":";;;AAAA,2CAA4C;AAC5C,6CAAyC;AAEzC,MAAa,mBAAoB,SAAQ,sBAAS;IAChD,YACE,OAAe,EACf,YAAoB,uBAAuB,EAC3C,OAAa;QAEb,KAAK,CAAC,OAAO,EAAE,mBAAU,CAAC,qBAAqB,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;CACF;AARD,kDAQC"}

package/dist/libs/stefaninigo/core/errors/not-found.error.d.ts

@@ -0,0 +1,4 @@
+import { HttpError } from './http.error';
+export declare class NotFoundError extends HttpError {
+    constructor(message: string, errorCode?: string, details?: any);
+}

package/dist/libs/stefaninigo/core/errors/not-found.error.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotFoundError = void 0;
+const common_1 = require("@nestjs/common");
+const http_error_1 = require("./http.error");
+class NotFoundError extends http_error_1.HttpError {
+    constructor(message, errorCode = 'NOT_FOUND', details) {
+        super(message, common_1.HttpStatus.NOT_FOUND, errorCode, details);
+    }
+}
+exports.NotFoundError = NotFoundError;
+//# sourceMappingURL=not-found.error.js.map

package/dist/libs/stefaninigo/core/errors/not-found.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"not-found.error.js","sourceRoot":"","sources":["../../../../../libs/stefaninigo/src/core/errors/not-found.error.ts"],"names":[],"mappings":";;;AAAA,2CAA4C;AAC5C,6CAAyC;AAEzC,MAAa,aAAc,SAAQ,sBAAS;IAC1C,YACE,OAAe,EACf,YAAoB,WAAW,EAC/B,OAAa;QAEb,KAAK,CAAC,OAAO,EAAE,mBAAU,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC;CACF;AARD,sCAQC"}

package/dist/libs/stefaninigo/core/errors/unauthorized.error.d.ts

@@ -0,0 +1,4 @@
+import { HttpError } from './http.error';
+export declare class UnauthorizedError extends HttpError {
+    constructor(message: string, errorCode?: string, details?: any);
+}

package/dist/libs/stefaninigo/core/errors/unauthorized.error.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnauthorizedError = void 0;
+const common_1 = require("@nestjs/common");
+const http_error_1 = require("./http.error");
+class UnauthorizedError extends http_error_1.HttpError {
+    constructor(message, errorCode = 'UNAUTHORIZED', details) {
+        super(message, common_1.HttpStatus.UNAUTHORIZED, errorCode, details);
+    }
+}
+exports.UnauthorizedError = UnauthorizedError;
+//# sourceMappingURL=unauthorized.error.js.map

package/dist/libs/stefaninigo/core/errors/unauthorized.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unauthorized.error.js","sourceRoot":"","sources":["../../../../../libs/stefaninigo/src/core/errors/unauthorized.error.ts"],"names":[],"mappings":";;;AAAA,2CAA4C;AAC5C,6CAAyC;AAEzC,MAAa,iBAAkB,SAAQ,sBAAS;IAC9C,YACE,OAAe,EACf,YAAoB,cAAc,EAClC,OAAa;QAEb,KAAK,CAAC,OAAO,EAAE,mBAAU,CAAC,YAAY,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;CACF;AARD,8CAQC"}

package/dist/libs/stefaninigo/core/health/health.controller.d.ts

@@ -0,0 +1,9 @@
+import { HealthService } from './health.service';
+import { HealthSummary, LivenessReport, ReadinessReport } from './health.types';
+export declare class HealthController {
+    private readonly healthService;
+    constructor(healthService: HealthService);
+    health(): Promise<HealthSummary>;
+    readiness(): Promise<ReadinessReport>;
+    liveness(): LivenessReport;
+}

package/dist/libs/stefaninigo/core/health/health.controller.js

@@ -0,0 +1,73 @@
+"use strict";
+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 __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HealthController = void 0;
+const common_1 = require("@nestjs/common");
+const swagger_1 = require("@nestjs/swagger");
+const health_service_1 = require("./health.service");
+let HealthController = class HealthController {
+    constructor(healthService) {
+        this.healthService = healthService;
+    }
+    async health() {
+        const report = await this.healthService.health();
+        if (report.status === 'error') {
+            const errorDetail = report.checks.database?.error ||
+                report.checks.system?.status === 'error' ? 'System health check failed' :
+                'Health check failed';
+            throw new common_1.HttpException(errorDetail, common_1.HttpStatus.SERVICE_UNAVAILABLE);
+        }
+        return report;
+    }
+    async readiness() {
+        const readiness = await this.healthService.readiness();
+        if (readiness.status === 'not_ready') {
+            throw new common_1.HttpException(readiness.reason || 'Service is not ready', common_1.HttpStatus.SERVICE_UNAVAILABLE);
+        }
+        return readiness;
+    }
+    liveness() {
+        return this.healthService.liveness();
+    }
+};
+exports.HealthController = HealthController;
+__decorate([
+    (0, common_1.Get)(),
+    (0, swagger_1.ApiOperation)({ summary: 'Comprehensive service health check' }),
+    (0, swagger_1.ApiResponse)({ status: 200, description: 'Health report returned' }),
+    (0, swagger_1.ApiResponse)({ status: 503, description: 'Service unavailable - health check failed' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], HealthController.prototype, "health", null);
+__decorate([
+    (0, common_1.Get)('ready'),
+    (0, swagger_1.ApiOperation)({ summary: 'Readiness probe for orchestrators' }),
+    (0, swagger_1.ApiResponse)({ status: 200, description: 'Service is ready' }),
+    (0, swagger_1.ApiResponse)({ status: 503, description: 'Service not ready' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], HealthController.prototype, "readiness", null);
+__decorate([
+    (0, common_1.Get)('live'),
+    (0, swagger_1.ApiOperation)({ summary: 'Liveness probe for orchestrators' }),
+    (0, swagger_1.ApiResponse)({ status: 200, description: 'Service is alive' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Object)
+], HealthController.prototype, "liveness", null);
+exports.HealthController = HealthController = __decorate([
+    (0, swagger_1.ApiTags)('health'),
+    (0, common_1.Controller)('health'),
+    __metadata("design:paramtypes", [health_service_1.HealthService])
+], HealthController);
+//# sourceMappingURL=health.controller.js.map

package/dist/libs/stefaninigo/core/health/health.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.controller.js","sourceRoot":"","sources":["../../../../../libs/stefaninigo/src/core/health/health.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4E;AAC5E,6CAAqE;AACrE,qDAAiD;AAK1C,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;IAC3B,YAA6B,aAA4B;QAA5B,kBAAa,GAAb,aAAa,CAAe;IAAG,CAAC;IAMvD,AAAN,KAAK,CAAC,MAAM;QACV,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;QAEjD,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;YAC9B,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK;gBAC9B,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC;gBACzE,qBAAqB,CAAC;YACzC,MAAM,IAAI,sBAAa,CAAC,WAAW,EAAE,mBAAU,CAAC,mBAAmB,CAAC,CAAC;QACvE,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAMK,AAAN,KAAK,CAAC,SAAS;QACb,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,CAAC;QAEvD,IAAI,SAAS,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YACrC,MAAM,IAAI,sBAAa,CACrB,SAAS,CAAC,MAAM,IAAI,sBAAsB,EAC1C,mBAAU,CAAC,mBAAmB,CAC/B,CAAC;QACJ,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAKD,QAAQ;QACN,OAAO,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC;IACvC,CAAC;CACF,CAAA;AA3CY,4CAAgB;AAOrB;IAJL,IAAA,YAAG,GAAE;IACL,IAAA,sBAAY,EAAC,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC;IAC/D,IAAA,qBAAW,EAAC,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,wBAAwB,EAAE,CAAC;IACnE,IAAA,qBAAW,EAAC,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,2CAA2C,EAAE,CAAC;;;;8CAYtF;AAMK;IAJL,IAAA,YAAG,EAAC,OAAO,CAAC;IACZ,IAAA,sBAAY,EAAC,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC;IAC9D,IAAA,qBAAW,EAAC,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAC7D,IAAA,qBAAW,EAAC,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,mBAAmB,EAAE,CAAC;;;;iDAY9D;AAKD;IAHC,IAAA,YAAG,EAAC,MAAM,CAAC;IACX,IAAA,sBAAY,EAAC,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC;IAC7D,IAAA,qBAAW,EAAC,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,kBAAkB,EAAE,CAAC;;;;gDAG7D;2BA1CU,gBAAgB;IAF5B,IAAA,iBAAO,EAAC,QAAQ,CAAC;IACjB,IAAA,mBAAU,EAAC,QAAQ,CAAC;qCAEyB,8BAAa;GAD9C,gBAAgB,CA2C5B"}

package/dist/libs/stefaninigo/core/health/health.module.d.ts

@@ -0,0 +1,9 @@
+import { DynamicModule } from '@nestjs/common';
+import { HealthConfig } from './health.types';
+interface HealthModuleOptions {
+    config: HealthConfig;
+}
+export declare class HealthModule {
+    static forRoot(options: HealthModuleOptions): DynamicModule;
+}
+export {};

package/dist/libs/stefaninigo/core/health/health.module.js

@@ -0,0 +1,56 @@
+"use strict";
+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 HealthModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HealthModule = void 0;
+const common_1 = require("@nestjs/common");
+const database_module_1 = require("../../database/database.module");
+const health_service_1 = require("./health.service");
+const health_controller_1 = require("./health.controller");
+const health_types_1 = require("./health.types");
+let HealthModule = HealthModule_1 = class HealthModule {
+    static forRoot(options) {
+        const providers = [
+            {
+                provide: health_types_1.HEALTH_CONFIG_TOKEN,
+                useValue: options.config,
+            },
+            health_service_1.HealthService,
+        ];
+        if (options.config.database) {
+            providers.push({
+                provide: health_types_1.HEALTH_DB_SERVICE_TOKEN,
+                useExisting: options.config.database.token,
+            });
+        }
+        else {
+            providers.push({
+                provide: health_types_1.HEALTH_DB_SERVICE_TOKEN,
+                useValue: undefined,
+            });
+        }
+        const imports = [];
+        if (options.config.database) {
+            imports.push(database_module_1.DatabaseModule.forRootAsync([
+                { name: options.config.database.token, provider: database_module_1.DatabaseModule.PROVIDERS.MONGODB },
+            ]));
+        }
+        return {
+            module: HealthModule_1,
+            imports,
+            controllers: [health_controller_1.HealthController],
+            providers,
+            exports: [health_service_1.HealthService],
+        };
+    }
+};
+exports.HealthModule = HealthModule;
+exports.HealthModule = HealthModule = HealthModule_1 = __decorate([
+    (0, common_1.Module)({})
+], HealthModule);
+//# sourceMappingURL=health.module.js.map

package/dist/libs/stefaninigo/core/health/health.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.module.js","sourceRoot":"","sources":["../../../../../libs/stefaninigo/src/core/health/health.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAiE;AACjE,oEAAgE;AAChE,qDAAiD;AACjD,2DAAuD;AACvD,iDAIwB;AAOjB,IAAM,YAAY,oBAAlB,MAAM,YAAY;IACvB,MAAM,CAAC,OAAO,CAAC,OAA4B;QACzC,MAAM,SAAS,GAAe;YAC5B;gBACE,OAAO,EAAE,kCAAmB;gBAC5B,QAAQ,EAAE,OAAO,CAAC,MAAM;aACzB;YACD,8BAAa;SACd,CAAC;QAEF,IAAI,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC5B,SAAS,CAAC,IAAI,CAAC;gBACb,OAAO,EAAE,sCAAuB;gBAChC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK;aAC3C,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,IAAI,CAAC;gBACb,OAAO,EAAE,sCAAuB;gBAChC,QAAQ,EAAE,SAAS;aACpB,CAAC,CAAC;QACL,CAAC;QAED,MAAM,OAAO,GAAG,EAAE,CAAC;QAEnB,IAAI,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC5B,OAAO,CAAC,IAAI,CACV,gCAAc,CAAC,YAAY,CAAC;gBAC1B,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,gCAAc,CAAC,SAAS,CAAC,OAAO,EAAE;aACpF,CAAC,CACH,CAAC;QACJ,CAAC;QAED,OAAO;YACL,MAAM,EAAE,cAAY;YACpB,OAAO;YACP,WAAW,EAAE,CAAC,oCAAgB,CAAC;YAC/B,SAAS;YACT,OAAO,EAAE,CAAC,8BAAa,CAAC;SACzB,CAAC;IACJ,CAAC;CACF,CAAA;AAxCY,oCAAY;uBAAZ,YAAY;IADxB,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,YAAY,CAwCxB"}

package/dist/libs/stefaninigo/core/health/health.service.d.ts

@@ -0,0 +1,16 @@
+import { HealthConfig, HealthSummary, ReadinessReport, LivenessReport } from './health.types';
+import { DatabaseService } from '../../database/database-service.interface';
+export declare class HealthService {
+    private readonly config;
+    private readonly databaseService?;
+    private readonly logger;
+    private readonly startTime;
+    constructor(config: HealthConfig, databaseService?: DatabaseService);
+    health(): Promise<HealthSummary>;
+    readiness(): Promise<ReadinessReport>;
+    liveness(): LivenessReport;
+    private checkDatabase;
+    private checkSystem;
+    private resolveStatus;
+    private timeout;
+}

package/dist/libs/stefaninigo/core/health/health.service.js

@@ -0,0 +1,143 @@
+"use strict";
+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 __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var HealthService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HealthService = void 0;
+const common_1 = require("@nestjs/common");
+const health_types_1 = require("./health.types");
+let HealthService = HealthService_1 = class HealthService {
+    constructor(config, databaseService) {
+        this.config = config;
+        this.databaseService = databaseService;
+        this.logger = new common_1.Logger(HealthService_1.name);
+        this.startTime = Date.now();
+    }
+    async health() {
+        const now = Date.now();
+        const timestamp = new Date(now).toISOString();
+        const uptimeSeconds = Math.floor((now - this.startTime) / 1000);
+        const [database, system] = await Promise.all([
+            this.checkDatabase(),
+            this.checkSystem(),
+        ]);
+        const status = this.resolveStatus(database.status, system.status);
+        return {
+            status,
+            timestamp,
+            service: {
+                name: this.config.serviceName,
+                version: this.config.version ?? '0.0.0',
+            },
+            environment: process.env.NODE_ENV ?? 'development',
+            uptimeSeconds,
+            checks: {
+                database,
+                system,
+            },
+        };
+    }
+    async readiness() {
+        const timestamp = new Date().toISOString();
+        const database = await this.checkDatabase();
+        if (database.status === 'error') {
+            return {
+                status: 'not_ready',
+                timestamp,
+                reason: database.error ?? 'database check failed',
+            };
+        }
+        return {
+            status: 'ready',
+            timestamp,
+        };
+    }
+    liveness() {
+        return {
+            status: 'alive',
+            timestamp: new Date().toISOString(),
+        };
+    }
+    async checkDatabase() {
+        if (!this.config.database || !this.databaseService) {
+            return { status: 'skipped' };
+        }
+        const startedAt = Date.now();
+        try {
+            const { timeoutMs } = this.config.database;
+            await Promise.race([
+                this.databaseService.ping(),
+                this.timeout(timeoutMs ?? 2000, 'database check timed out'),
+            ]);
+            return {
+                status: 'ok',
+                responseTimeMs: Date.now() - startedAt,
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'unknown error';
+            this.logger.warn(`Database health check failed: ${message}`);
+            return {
+                status: 'error',
+                error: message,
+            };
+        }
+    }
+    async checkSystem() {
+        const memoryUsage = process.memoryUsage();
+        const usagePercent = memoryUsage.heapTotal === 0
+            ? 0
+            : Number(((memoryUsage.heapUsed / memoryUsage.heapTotal) * 100).toFixed(2));
+        const { warnThresholdPercent = 75, errorThresholdPercent = 90 } = this.config.memory ?? {};
+        let status = 'ok';
+        if (usagePercent >= errorThresholdPercent) {
+            status = 'error';
+        }
+        else if (usagePercent >= warnThresholdPercent) {
+            status = 'degraded';
+        }
+        return {
+            status,
+            memory: {
+                rss: memoryUsage.rss,
+                heapTotal: memoryUsage.heapTotal,
+                heapUsed: memoryUsage.heapUsed,
+                external: memoryUsage.external,
+                arrayBuffers: memoryUsage.arrayBuffers,
+                usagePercent,
+            },
+        };
+    }
+    resolveStatus(databaseStatus, systemStatus) {
+        if ([databaseStatus, systemStatus].includes('error')) {
+            return 'error';
+        }
+        if ([databaseStatus, systemStatus].includes('degraded')) {
+            return 'degraded';
+        }
+        return 'ok';
+    }
+    async timeout(ms, message) {
+        return new Promise((_, reject) => {
+            setTimeout(() => reject(new Error(message)), ms);
+        });
+    }
+};
+exports.HealthService = HealthService;
+exports.HealthService = HealthService = HealthService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(health_types_1.HEALTH_CONFIG_TOKEN)),
+    __param(1, (0, common_1.Inject)(health_types_1.HEALTH_DB_SERVICE_TOKEN)),
+    __metadata("design:paramtypes", [Object, Object])
+], HealthService);
+//# sourceMappingURL=health.service.js.map

package/dist/libs/stefaninigo/core/health/health.service.js.map

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