nestjs-api-forge 1.0.5 → 1.0.7

package/README.md

@@ -473,23 +473,37 @@ rxjs             ^7
 
 ## 📋 Changelog
 
-### v1.1.0
+### v1.0.7 — Current
+
+- **10 new HTTP exception classes** — `NotAcceptableException` (406), `RequestTimeoutException` (408), `GoneException` (410), `PayloadTooLargeException` (413), `UnsupportedMediaTypeException` (415), `LockedException` (423), `FailedDependencyException` (424), `PreconditionRequiredException` (428), `NotImplementedException` (501), `BadGatewayException` (502)
+- **`ForgeHealthModule`** — configurable `/health` endpoint with custom checks, uptime, memory stats, and Forge-formatted responses; throws 503 automatically when any check fails
+- **Updated error-code map** — added `LOCKED`, `FAILED_DEPENDENCY`, `PRECONDITION_REQUIRED` mappings
+
+> Full history: [CHANGELOG.md](CHANGELOG.md)
+
+### v1.0.6
+- **Changelog updated** — all versions documented with accurate entries aligned to npm release history
+
+### v1.0.5
+- **Open source documentation** — full README rewrite with badges, "What it does" table, response shape examples, and complete API reference
+- **Community health files** — `CONTRIBUTING.md`, `CODE_OF_CONDUCT.md`, `CONTRIBUTORS.md`, `REPOSITORY_RULES.md`
+- **GitHub templates** — bug report and feature request issue templates, `FUNDING.yml`, `CODEOWNERS`
+- **ESLint setup** — ESLint v10 flat config (`eslint.config.mjs`) with `@typescript-eslint` integration; `npm run lint` now works out of the box
+
+### v1.0.4
 - `ForgeValidationPipe` — structured validation errors with nested field support (dot-notation)
 - `@ForgeMeta(extra)` — merge custom fields into response `meta` per route or controller
 - `@ForgeDeprecated(notice?)` — deprecation flag in `meta` + `Deprecation: true` response header
+- `@ForgeMessage`, `@ForgeRawResponse`, `@ApiForge` decorators
 - `ApiResponseDto.accepted()` — 202 Accepted helper
 - Correlation ID passthrough (`correlationIdHeader` option)
 - Response time measurement (`includeResponseTime` option)
 - `forRootAsync` fix — options factory now runs once instead of twice
 - 3 new exceptions: `MethodNotAllowedException`, `PaymentRequiredException`, `GatewayTimeoutException`
-
-### v1.0.4
-- Decorators: `@ForgeMessage`, `@ForgeRawResponse`, `@ForgeMeta`, `@ForgeDeprecated`, `@ApiForge`
-- `ForgeValidationPipe` with structured field-level errors
 - Response metadata support (`includePath`, `includeTimestamp`, `includeRequestId`, `includeResponseTime`)
 
 ### v1.0.3
-- Bump version, update repository URL
+- Update repository URL format in `package.json`
 
 ### v1.0.0
 - Initial release — `ApiForgeModule.forRoot()`, `ForgeExceptionFilter`, `ForgeResponseInterceptor`, `ApiResponseDto`, and 10 typed exceptions

package/dist/exceptions/api.exception.d.ts

@@ -41,3 +41,33 @@ export declare class PaymentRequiredException extends ApiException {
 export declare class GatewayTimeoutException extends ApiException {
     constructor(message?: string);
 }
+export declare class NotAcceptableException extends ApiException {
+    constructor(message?: string);
+}
+export declare class RequestTimeoutException extends ApiException {
+    constructor(message?: string);
+}
+export declare class GoneException extends ApiException {
+    constructor(message?: string);
+}
+export declare class PayloadTooLargeException extends ApiException {
+    constructor(message?: string);
+}
+export declare class UnsupportedMediaTypeException extends ApiException {
+    constructor(message?: string);
+}
+export declare class LockedException extends ApiException {
+    constructor(message?: string);
+}
+export declare class FailedDependencyException extends ApiException {
+    constructor(message?: string);
+}
+export declare class PreconditionRequiredException extends ApiException {
+    constructor(message?: string);
+}
+export declare class NotImplementedException extends ApiException {
+    constructor(message?: string);
+}
+export declare class BadGatewayException extends ApiException {
+    constructor(message?: string);
+}

package/dist/exceptions/api.exception.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GatewayTimeoutException = exports.PaymentRequiredException = exports.MethodNotAllowedException = exports.ServiceUnavailableException = exports.InternalServerException = exports.TooManyRequestsException = exports.UnprocessableEntityException = exports.ConflictException = exports.NotFoundException = exports.ForbiddenException = exports.UnauthorizedException = exports.BadRequestException = exports.ApiException = void 0;
+exports.BadGatewayException = exports.NotImplementedException = exports.PreconditionRequiredException = exports.FailedDependencyException = exports.LockedException = exports.UnsupportedMediaTypeException = exports.PayloadTooLargeException = exports.GoneException = exports.RequestTimeoutException = exports.NotAcceptableException = exports.GatewayTimeoutException = exports.PaymentRequiredException = exports.MethodNotAllowedException = exports.ServiceUnavailableException = exports.InternalServerException = exports.TooManyRequestsException = exports.UnprocessableEntityException = exports.ConflictException = exports.NotFoundException = exports.ForbiddenException = exports.UnauthorizedException = exports.BadRequestException = exports.ApiException = void 0;
 const common_1 = require("@nestjs/common");
 class ApiException extends common_1.HttpException {
     constructor(message, statusCode, code, details) {
@@ -82,4 +82,64 @@ class GatewayTimeoutException extends ApiException {
     }
 }
 exports.GatewayTimeoutException = GatewayTimeoutException;
+class NotAcceptableException extends ApiException {
+    constructor(message = 'Not acceptable') {
+        super(message, common_1.HttpStatus.NOT_ACCEPTABLE, 'NOT_ACCEPTABLE');
+    }
+}
+exports.NotAcceptableException = NotAcceptableException;
+class RequestTimeoutException extends ApiException {
+    constructor(message = 'Request timeout') {
+        super(message, common_1.HttpStatus.REQUEST_TIMEOUT, 'REQUEST_TIMEOUT');
+    }
+}
+exports.RequestTimeoutException = RequestTimeoutException;
+class GoneException extends ApiException {
+    constructor(message = 'Resource no longer available') {
+        super(message, common_1.HttpStatus.GONE, 'GONE');
+    }
+}
+exports.GoneException = GoneException;
+class PayloadTooLargeException extends ApiException {
+    constructor(message = 'Payload too large') {
+        super(message, common_1.HttpStatus.PAYLOAD_TOO_LARGE, 'PAYLOAD_TOO_LARGE');
+    }
+}
+exports.PayloadTooLargeException = PayloadTooLargeException;
+class UnsupportedMediaTypeException extends ApiException {
+    constructor(message = 'Unsupported media type') {
+        super(message, common_1.HttpStatus.UNSUPPORTED_MEDIA_TYPE, 'UNSUPPORTED_MEDIA_TYPE');
+    }
+}
+exports.UnsupportedMediaTypeException = UnsupportedMediaTypeException;
+class LockedException extends ApiException {
+    constructor(message = 'Resource is locked') {
+        super(message, common_1.HttpStatus.LOCKED, 'LOCKED');
+    }
+}
+exports.LockedException = LockedException;
+class FailedDependencyException extends ApiException {
+    constructor(message = 'Failed dependency') {
+        super(message, common_1.HttpStatus.FAILED_DEPENDENCY, 'FAILED_DEPENDENCY');
+    }
+}
+exports.FailedDependencyException = FailedDependencyException;
+class PreconditionRequiredException extends ApiException {
+    constructor(message = 'Precondition required') {
+        super(message, common_1.HttpStatus.PRECONDITION_REQUIRED, 'PRECONDITION_REQUIRED');
+    }
+}
+exports.PreconditionRequiredException = PreconditionRequiredException;
+class NotImplementedException extends ApiException {
+    constructor(message = 'Not implemented') {
+        super(message, common_1.HttpStatus.NOT_IMPLEMENTED, 'NOT_IMPLEMENTED');
+    }
+}
+exports.NotImplementedException = NotImplementedException;
+class BadGatewayException extends ApiException {
+    constructor(message = 'Bad gateway') {
+        super(message, common_1.HttpStatus.BAD_GATEWAY, 'BAD_GATEWAY');
+    }
+}
+exports.BadGatewayException = BadGatewayException;
 //# sourceMappingURL=api.exception.js.map

package/dist/exceptions/api.exception.js.map

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

package/dist/health/forge-health.controller.d.ts

@@ -0,0 +1,6 @@
+import { ForgeHealthService } from './forge-health.service';
+export declare class ForgeHealthController {
+    protected readonly healthService: ForgeHealthService;
+    constructor(healthService: ForgeHealthService);
+    health(): Promise<import("..").ApiSuccessResponse<import("./forge-health.interfaces").ForgeHealthData>>;
+}

package/dist/health/forge-health.controller.js

@@ -0,0 +1,42 @@
+"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.ForgeHealthController = void 0;
+const common_1 = require("@nestjs/common");
+const dto_1 = require("../dto");
+const decorators_1 = require("../decorators");
+const exceptions_1 = require("../exceptions");
+const forge_health_service_1 = require("./forge-health.service");
+let ForgeHealthController = class ForgeHealthController {
+    constructor(healthService) {
+        this.healthService = healthService;
+    }
+    async health() {
+        const { data, ok } = await this.healthService.check();
+        if (!ok) {
+            throw new exceptions_1.ServiceUnavailableException('Service health checks failed');
+        }
+        return dto_1.ApiResponseDto.success(data, 'Service is healthy');
+    }
+};
+exports.ForgeHealthController = ForgeHealthController;
+__decorate([
+    (0, common_1.Get)(),
+    (0, decorators_1.ForgeRawResponse)(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], ForgeHealthController.prototype, "health", null);
+exports.ForgeHealthController = ForgeHealthController = __decorate([
+    (0, common_1.Controller)(),
+    __metadata("design:paramtypes", [forge_health_service_1.ForgeHealthService])
+], ForgeHealthController);
+//# sourceMappingURL=forge-health.controller.js.map

package/dist/health/forge-health.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forge-health.controller.js","sourceRoot":"","sources":["../../src/health/forge-health.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAiD;AACjD,gCAAwC;AACxC,8CAAiD;AACjD,8CAA4D;AAC5D,iEAA4D;AAGrD,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IAChC,YAA+B,aAAiC;QAAjC,kBAAa,GAAb,aAAa,CAAoB;IAAG,CAAC;IAI9D,AAAN,KAAK,CAAC,MAAM;QACV,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;QAEtD,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,IAAI,wCAA2B,CAAC,8BAA8B,CAAC,CAAC;QACxE,CAAC;QAED,OAAO,oBAAc,CAAC,OAAO,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC;IAC5D,CAAC;CACF,CAAA;AAdY,sDAAqB;AAK1B;IAFL,IAAA,YAAG,GAAE;IACL,IAAA,6BAAgB,GAAE;;;;mDASlB;gCAbU,qBAAqB;IADjC,IAAA,mBAAU,GAAE;qCAEmC,yCAAkB;GADrD,qBAAqB,CAcjC"}

package/dist/health/forge-health.interfaces.d.ts

@@ -0,0 +1,29 @@
+export interface ForgeHealthCheckResult {
+    status: 'ok' | 'error';
+    message?: string;
+    details?: unknown;
+}
+export interface ForgeHealthCheck {
+    name: string;
+    check: () => Promise<ForgeHealthCheckResult> | ForgeHealthCheckResult;
+}
+export interface ForgeHealthOptions {
+    path?: string;
+    includeUptime?: boolean;
+    includeMemory?: boolean;
+    version?: string;
+    checks?: ForgeHealthCheck[];
+}
+export interface ForgeHealthMemory {
+    rss: number;
+    heapUsed: number;
+    heapTotal: number;
+    external: number;
+}
+export interface ForgeHealthData {
+    status: 'ok' | 'degraded';
+    uptime?: number;
+    version?: string;
+    memory?: ForgeHealthMemory;
+    checks?: Record<string, ForgeHealthCheckResult>;
+}

package/dist/health/forge-health.interfaces.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=forge-health.interfaces.js.map

package/dist/health/forge-health.interfaces.js.map

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

package/dist/health/forge-health.module.d.ts

@@ -0,0 +1,5 @@
+import { DynamicModule } from '@nestjs/common';
+import { ForgeHealthOptions } from './forge-health.interfaces';
+export declare class ForgeHealthModule {
+    static register(options?: ForgeHealthOptions): DynamicModule;
+}

package/dist/health/forge-health.module.js

@@ -0,0 +1,36 @@
+"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 ForgeHealthModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ForgeHealthModule = void 0;
+const common_1 = require("@nestjs/common");
+const forge_health_controller_1 = require("./forge-health.controller");
+const forge_health_service_1 = require("./forge-health.service");
+let ForgeHealthModule = ForgeHealthModule_1 = class ForgeHealthModule {
+    static register(options = {}) {
+        const path = options.path ?? 'health';
+        let DynamicHealthController = class DynamicHealthController extends forge_health_controller_1.ForgeHealthController {
+        };
+        DynamicHealthController = __decorate([
+            (0, common_1.Controller)(path)
+        ], DynamicHealthController);
+        return {
+            module: ForgeHealthModule_1,
+            providers: [
+                { provide: forge_health_service_1.FORGE_HEALTH_OPTIONS, useValue: options },
+                forge_health_service_1.ForgeHealthService,
+            ],
+            controllers: [DynamicHealthController],
+        };
+    }
+};
+exports.ForgeHealthModule = ForgeHealthModule;
+exports.ForgeHealthModule = ForgeHealthModule = ForgeHealthModule_1 = __decorate([
+    (0, common_1.Module)({})
+], ForgeHealthModule);
+//# sourceMappingURL=forge-health.module.js.map

package/dist/health/forge-health.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forge-health.module.js","sourceRoot":"","sources":["../../src/health/forge-health.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAmE;AACnE,uEAAkE;AAElE,iEAAkF;AAG3E,IAAM,iBAAiB,yBAAvB,MAAM,iBAAiB;IACrB,AAAP,MAAM,CAAC,QAAQ,CAAC,UAA8B,EAAE;QAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,QAAQ,CAAC;QAGtC,IAAM,uBAAuB,GAA7B,MAAM,uBAAwB,SAAQ,+CAAqB;SAAG,CAAA;QAAxD,uBAAuB;YAD5B,IAAA,mBAAU,EAAC,IAAI,CAAC;WACX,uBAAuB,CAAiC;QAE9D,OAAO;YACL,MAAM,EAAE,mBAAiB;YACzB,SAAS,EAAE;gBACT,EAAE,OAAO,EAAE,2CAAoB,EAAE,QAAQ,EAAE,OAAO,EAAE;gBACpD,yCAAkB;aACnB;YACD,WAAW,EAAE,CAAC,uBAAuB,CAAC;SACvC,CAAC;IACJ,CAAC;CACF,CAAA;AAhBY,8CAAiB;4BAAjB,iBAAiB;IAD7B,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,iBAAiB,CAgB7B"}

package/dist/health/forge-health.service.d.ts

@@ -0,0 +1,10 @@
+import { ForgeHealthData, ForgeHealthOptions } from './forge-health.interfaces';
+export declare const FORGE_HEALTH_OPTIONS = "FORGE_HEALTH_OPTIONS";
+export declare class ForgeHealthService {
+    private readonly options;
+    constructor(options: ForgeHealthOptions);
+    check(): Promise<{
+        data: ForgeHealthData;
+        ok: boolean;
+    }>;
+}

package/dist/health/forge-health.service.js

@@ -0,0 +1,67 @@
+"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); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ForgeHealthService = exports.FORGE_HEALTH_OPTIONS = void 0;
+const common_1 = require("@nestjs/common");
+exports.FORGE_HEALTH_OPTIONS = 'FORGE_HEALTH_OPTIONS';
+let ForgeHealthService = class ForgeHealthService {
+    constructor(options) {
+        this.options = options;
+    }
+    async check() {
+        const data = { status: 'ok' };
+        if (this.options.includeUptime !== false) {
+            data.uptime = Math.round(process.uptime() * 1000) / 1000;
+        }
+        if (this.options.version) {
+            data.version = this.options.version;
+        }
+        if (this.options.includeMemory) {
+            const mem = process.memoryUsage();
+            data.memory = {
+                rss: mem.rss,
+                heapUsed: mem.heapUsed,
+                heapTotal: mem.heapTotal,
+                external: mem.external,
+            };
+        }
+        let ok = true;
+        if (this.options.checks?.length) {
+            data.checks = {};
+            for (const check of this.options.checks) {
+                try {
+                    const result = await check.check();
+                    data.checks[check.name] = result;
+                    if (result.status === 'error')
+                        ok = false;
+                }
+                catch (err) {
+                    const message = err instanceof Error ? err.message : 'Check failed';
+                    data.checks[check.name] = { status: 'error', message };
+                    ok = false;
+                }
+            }
+            if (!ok)
+                data.status = 'degraded';
+        }
+        return { data, ok };
+    }
+};
+exports.ForgeHealthService = ForgeHealthService;
+exports.ForgeHealthService = ForgeHealthService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(exports.FORGE_HEALTH_OPTIONS)),
+    __metadata("design:paramtypes", [Object])
+], ForgeHealthService);
+//# sourceMappingURL=forge-health.service.js.map

package/dist/health/forge-health.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forge-health.service.js","sourceRoot":"","sources":["../../src/health/forge-health.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAAoD;AAMvC,QAAA,oBAAoB,GAAG,sBAAsB,CAAC;AAGpD,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;IAC7B,YACiD,OAA2B;QAA3B,YAAO,GAAP,OAAO,CAAoB;IACzE,CAAC;IAEJ,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,GAAoB,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAE/C,IAAI,IAAI,CAAC,OAAO,CAAC,aAAa,KAAK,KAAK,EAAE,CAAC;YACzC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;QAC3D,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;QACtC,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;YAC/B,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;YAClC,IAAI,CAAC,MAAM,GAAG;gBACZ,GAAG,EAAE,GAAG,CAAC,GAAG;gBACZ,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,QAAQ,EAAE,GAAG,CAAC,QAAQ;aACvB,CAAC;QACJ,CAAC;QAED,IAAI,EAAE,GAAG,IAAI,CAAC;QAEd,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;YAChC,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;YACjB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBACxC,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;oBACnC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;oBACjC,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO;wBAAE,EAAE,GAAG,KAAK,CAAC;gBAC5C,CAAC;gBAAC,OAAO,GAAY,EAAE,CAAC;oBACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC;oBACpE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;oBACvD,EAAE,GAAG,KAAK,CAAC;gBACb,CAAC;YACH,CAAC;YACD,IAAI,CAAC,EAAE;gBAAE,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC;QACpC,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IACtB,CAAC;CACF,CAAA;AA9CY,gDAAkB;6BAAlB,kBAAkB;IAD9B,IAAA,mBAAU,GAAE;IAGR,WAAA,IAAA,eAAM,EAAC,4BAAoB,CAAC,CAAA;;GAFpB,kBAAkB,CA8C9B"}

package/dist/health/index.d.ts

@@ -0,0 +1,3 @@
+export * from './forge-health.interfaces';
+export * from './forge-health.module';
+export * from './forge-health.service';

package/dist/health/index.js

@@ -0,0 +1,20 @@
+"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("./forge-health.interfaces"), exports);
+__exportStar(require("./forge-health.module"), exports);
+__exportStar(require("./forge-health.service"), exports);
+//# sourceMappingURL=index.js.map

package/dist/health/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/health/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4DAA0C;AAC1C,wDAAsC;AACtC,yDAAuC"}

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export * from './decorators';
 export * from './dto';
 export * from './exceptions';
 export * from './filters';
+export * from './health';
 export * from './interceptors';
 export * from './interfaces';
 export * from './pipes';

package/dist/index.js

@@ -19,6 +19,7 @@ __exportStar(require("./decorators"), exports);
 __exportStar(require("./dto"), exports);
 __exportStar(require("./exceptions"), exports);
 __exportStar(require("./filters"), exports);
+__exportStar(require("./health"), exports);
 __exportStar(require("./interceptors"), exports);
 __exportStar(require("./interfaces"), exports);
 __exportStar(require("./pipes"), exports);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,+CAA6B;AAC7B,wCAAsB;AACtB,+CAA6B;AAC7B,4CAA0B;AAC1B,iDAA+B;AAC/B,+CAA6B;AAC7B,0CAAwB;AACxB,0CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,+CAA6B;AAC7B,wCAAsB;AACtB,+CAA6B;AAC7B,4CAA0B;AAC1B,2CAAyB;AACzB,iDAA+B;AAC/B,+CAA6B;AAC7B,0CAAwB;AACxB,0CAAwB"}