@application-kit/observability 0.1.0 → 0.3.0

package/dist/cjs/health/health-checks.js

@@ -0,0 +1,53 @@
+"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.HealthChecks = void 0;
+const common_1 = require("@nestjs/common");
+const terminus_1 = require("@nestjs/terminus");
+const health_config_js_1 = require("./health.config.js");
+let HealthChecks = class HealthChecks {
+    database;
+    memory;
+    disk;
+    config;
+    constructor(database, memory, disk, config) {
+        this.database = database;
+        this.memory = memory;
+        this.disk = disk;
+        this.config = config;
+    }
+    build() {
+        return [
+            async () => this.database.pingCheck('typeorm'),
+            async () => this.memory.checkHeap('memory_heap', this.config.memoryHeapBytes),
+            async () => this.memory.checkRSS('memory_rss', this.config.memoryRssBytes),
+            async () => this.disk.checkStorage('disk', {
+                path: '/',
+                thresholdPercent: this.config.diskThresholdPercent,
+            }),
+        ];
+    }
+};
+exports.HealthChecks = HealthChecks;
+exports.HealthChecks = HealthChecks = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(terminus_1.TypeOrmHealthIndicator)),
+    __param(1, (0, common_1.Inject)(terminus_1.MemoryHealthIndicator)),
+    __param(2, (0, common_1.Inject)(terminus_1.DiskHealthIndicator)),
+    __param(3, (0, common_1.Inject)(health_config_js_1.HealthConfig)),
+    __metadata("design:paramtypes", [terminus_1.TypeOrmHealthIndicator,
+        terminus_1.MemoryHealthIndicator,
+        terminus_1.DiskHealthIndicator,
+        health_config_js_1.HealthConfig])
+], HealthChecks);

package/dist/cjs/health/health-http.module.d.ts

@@ -0,0 +1,5 @@
+import type { DynamicModule } from '@nestjs/common';
+import type { HealthCarrierOptionsInterface } from './health-module-options.interface.js';
+export declare class HealthHttpModule {
+    static forRoot(options?: HealthCarrierOptionsInterface): DynamicModule;
+}

package/dist/cjs/health/health-http.module.js

@@ -0,0 +1,26 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HealthHttpModule = void 0;
+const common_1 = require("@nestjs/common");
+const with_class_decorator_js_1 = require("../shared/with-class-decorator.js");
+const health_controller_js_1 = require("./health.controller.js");
+const migrations_health_indicator_js_1 = require("./migrations.health-indicator.js");
+let HealthHttpModule = class HealthHttpModule {
+    static forRoot(options = {}) {
+        return {
+            controllers: [(0, with_class_decorator_js_1.withClassDecorator)(health_controller_js_1.HealthController, options.publicRoute)],
+            module: this,
+            providers: [migrations_health_indicator_js_1.MigrationsHealthIndicator],
+        };
+    }
+};
+exports.HealthHttpModule = HealthHttpModule;
+exports.HealthHttpModule = HealthHttpModule = __decorate([
+    (0, common_1.Module)({})
+], HealthHttpModule);

package/dist/cjs/health/health-module-options.interface.d.ts

@@ -0,0 +1,9 @@
+import type { ModuleMetadata } from '@nestjs/common';
+import type { TerminusModuleOptions } from '@nestjs/terminus';
+export interface HealthCarrierOptionsInterface {
+    readonly publicRoute?: ClassDecorator;
+}
+export interface HealthModuleOptionsInterface {
+    readonly imports?: ModuleMetadata['imports'];
+    readonly terminus?: TerminusModuleOptions;
+}

package/dist/cjs/health/health-module-options.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/health/health.config.d.ts

@@ -0,0 +1,8 @@
+import { HealthEnvironment } from './health.environment.js';
+export declare class HealthConfig {
+    private readonly environment;
+    get diskThresholdPercent(): number;
+    get memoryHeapBytes(): number;
+    get memoryRssBytes(): number;
+    constructor(environment: HealthEnvironment);
+}

package/dist/cjs/health/health.config.js

@@ -0,0 +1,39 @@
+"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.HealthConfig = void 0;
+const common_1 = require("@nestjs/common");
+const health_environment_js_1 = require("./health.environment.js");
+const BYTES_IN_MEGABYTE = 1024 * 1024;
+let HealthConfig = class HealthConfig {
+    environment;
+    get diskThresholdPercent() {
+        return this.environment.HEALTH_DISK_THRESHOLD_PERCENT;
+    }
+    get memoryHeapBytes() {
+        return this.environment.HEALTH_MEMORY_HEAP_MB * BYTES_IN_MEGABYTE;
+    }
+    get memoryRssBytes() {
+        return this.environment.HEALTH_MEMORY_RSS_MB * BYTES_IN_MEGABYTE;
+    }
+    constructor(environment) {
+        this.environment = environment;
+    }
+};
+exports.HealthConfig = HealthConfig;
+exports.HealthConfig = HealthConfig = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(health_environment_js_1.HealthEnvironment)),
+    __metadata("design:paramtypes", [health_environment_js_1.HealthEnvironment])
+], HealthConfig);

package/dist/cjs/health/health.controller.d.ts

@@ -0,0 +1,14 @@
+import type { HealthCheckResult } from '@nestjs/terminus';
+import { HealthCheckService, TypeOrmHealthIndicator } from '@nestjs/terminus';
+import { HealthChecks } from './health-checks.js';
+import { MigrationsHealthIndicator } from './migrations.health-indicator.js';
+export declare class HealthController {
+    private readonly health;
+    private readonly database;
+    private readonly migrations;
+    private readonly healthChecks;
+    constructor(health: HealthCheckService, database: TypeOrmHealthIndicator, migrations: MigrationsHealthIndicator, healthChecks: HealthChecks);
+    check(): Promise<HealthCheckResult>;
+    live(): Promise<HealthCheckResult>;
+    ready(): Promise<HealthCheckResult>;
+}

package/dist/cjs/health/health.controller.js

@@ -0,0 +1,78 @@
+"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.HealthController = void 0;
+const logging_1 = require("@application-kit/typeorm/logging");
+const common_1 = require("@nestjs/common");
+const terminus_1 = require("@nestjs/terminus");
+const infrastructure_paths_js_1 = require("../logging/infrastructure-paths.js");
+const health_checks_js_1 = require("./health-checks.js");
+const migrations_health_indicator_js_1 = require("./migrations.health-indicator.js");
+let HealthController = class HealthController {
+    health;
+    database;
+    migrations;
+    healthChecks;
+    constructor(health, database, migrations, healthChecks) {
+        this.health = health;
+        this.database = database;
+        this.migrations = migrations;
+        this.healthChecks = healthChecks;
+    }
+    async check() {
+        return (0, logging_1.runAsInfrastructureQuery)(async () => this.health.check(this.healthChecks.build()));
+    }
+    async live() {
+        return this.health.check([]);
+    }
+    async ready() {
+        return (0, logging_1.runAsInfrastructureQuery)(async () => this.health.check([
+            async () => this.database.pingCheck('typeorm'),
+            async () => this.migrations.isUpToDate('migrations'),
+        ]));
+    }
+};
+exports.HealthController = HealthController;
+__decorate([
+    (0, common_1.Get)(),
+    (0, terminus_1.HealthCheck)(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], HealthController.prototype, "check", null);
+__decorate([
+    (0, common_1.Get)('live'),
+    (0, terminus_1.HealthCheck)(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], HealthController.prototype, "live", null);
+__decorate([
+    (0, common_1.Get)('ready'),
+    (0, terminus_1.HealthCheck)(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], HealthController.prototype, "ready", null);
+exports.HealthController = HealthController = __decorate([
+    (0, common_1.Controller)(infrastructure_paths_js_1.HEALTH_ROUTE),
+    __param(0, (0, common_1.Inject)(terminus_1.HealthCheckService)),
+    __param(1, (0, common_1.Inject)(terminus_1.TypeOrmHealthIndicator)),
+    __param(2, (0, common_1.Inject)(migrations_health_indicator_js_1.MigrationsHealthIndicator)),
+    __param(3, (0, common_1.Inject)(health_checks_js_1.HealthChecks)),
+    __metadata("design:paramtypes", [terminus_1.HealthCheckService,
+        terminus_1.TypeOrmHealthIndicator,
+        migrations_health_indicator_js_1.MigrationsHealthIndicator,
+        health_checks_js_1.HealthChecks])
+], HealthController);

package/dist/cjs/health/health.environment.d.ts

@@ -0,0 +1,5 @@
+export declare class HealthEnvironment {
+    HEALTH_DISK_THRESHOLD_PERCENT: number;
+    HEALTH_MEMORY_HEAP_MB: number;
+    HEALTH_MEMORY_RSS_MB: number;
+}

package/dist/cjs/health/health.environment.js

@@ -0,0 +1,38 @@
+"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.HealthEnvironment = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+class HealthEnvironment {
+    HEALTH_DISK_THRESHOLD_PERCENT = 0.8;
+    HEALTH_MEMORY_HEAP_MB = 500;
+    HEALTH_MEMORY_RSS_MB = 800;
+}
+exports.HealthEnvironment = HealthEnvironment;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_transformer_1.Type)(() => Number),
+    __metadata("design:type", Object)
+], HealthEnvironment.prototype, "HEALTH_DISK_THRESHOLD_PERCENT", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_transformer_1.Type)(() => Number),
+    __metadata("design:type", Object)
+], HealthEnvironment.prototype, "HEALTH_MEMORY_HEAP_MB", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_transformer_1.Type)(() => Number),
+    __metadata("design:type", Object)
+], HealthEnvironment.prototype, "HEALTH_MEMORY_RSS_MB", void 0);

package/dist/cjs/health/health.module.d.ts

@@ -0,0 +1,5 @@
+import type { DynamicModule } from '@nestjs/common';
+import type { HealthModuleOptionsInterface } from './health-module-options.interface.js';
+export declare class HealthModule {
+    static forRoot(options?: HealthModuleOptionsInterface): DynamicModule;
+}

package/dist/cjs/health/health.module.js

@@ -0,0 +1,28 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HealthModule = void 0;
+const common_1 = require("@nestjs/common");
+const terminus_1 = require("@nestjs/terminus");
+const health_checks_js_1 = require("./health-checks.js");
+let HealthModule = class HealthModule {
+    static forRoot(options = {}) {
+        const terminus = terminus_1.TerminusModule.forRoot(options.terminus);
+        return {
+            exports: [health_checks_js_1.HealthChecks, terminus],
+            global: true,
+            imports: [...options.imports ?? [], terminus],
+            module: this,
+            providers: [health_checks_js_1.HealthChecks],
+        };
+    }
+};
+exports.HealthModule = HealthModule;
+exports.HealthModule = HealthModule = __decorate([
+    (0, common_1.Module)({})
+], HealthModule);

package/dist/cjs/health/index.d.ts

@@ -0,0 +1,8 @@
+export * from './health-checks.js';
+export * from './health-http.module.js';
+export * from './health-module-options.interface.js';
+export * from './health.config.js';
+export * from './health.controller.js';
+export * from './health.environment.js';
+export * from './health.module.js';
+export * from './migrations.health-indicator.js';

package/dist/cjs/health/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("./health-checks.js"), exports);
+__exportStar(require("./health-http.module.js"), exports);
+__exportStar(require("./health-module-options.interface.js"), exports);
+__exportStar(require("./health.config.js"), exports);
+__exportStar(require("./health.controller.js"), exports);
+__exportStar(require("./health.environment.js"), exports);
+__exportStar(require("./health.module.js"), exports);
+__exportStar(require("./migrations.health-indicator.js"), exports);

package/dist/cjs/health/migrations.health-indicator.d.ts

@@ -0,0 +1,9 @@
+import type { HealthIndicatorResult } from '@nestjs/terminus';
+import { HealthIndicatorService } from '@nestjs/terminus';
+import { DataSource } from 'typeorm';
+export declare class MigrationsHealthIndicator {
+    private readonly healthIndicatorService;
+    private readonly dataSource;
+    constructor(healthIndicatorService: HealthIndicatorService, dataSource: DataSource);
+    isUpToDate(key: string): Promise<HealthIndicatorResult>;
+}

package/dist/cjs/health/migrations.health-indicator.js

@@ -0,0 +1,40 @@
+"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.MigrationsHealthIndicator = void 0;
+const common_1 = require("@nestjs/common");
+const terminus_1 = require("@nestjs/terminus");
+const typeorm_1 = require("@nestjs/typeorm");
+const typeorm_2 = require("typeorm");
+let MigrationsHealthIndicator = class MigrationsHealthIndicator {
+    healthIndicatorService;
+    dataSource;
+    constructor(healthIndicatorService, dataSource) {
+        this.healthIndicatorService = healthIndicatorService;
+        this.dataSource = dataSource;
+    }
+    async isUpToDate(key) {
+        const hasPendingMigrations = await this.dataSource.showMigrations();
+        const indicator = this.healthIndicatorService.check(key);
+        return hasPendingMigrations ? indicator.down({ pendingMigrations: true }) : indicator.up();
+    }
+};
+exports.MigrationsHealthIndicator = MigrationsHealthIndicator;
+exports.MigrationsHealthIndicator = MigrationsHealthIndicator = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(terminus_1.HealthIndicatorService)),
+    __param(1, (0, typeorm_1.InjectDataSource)()),
+    __metadata("design:paramtypes", [terminus_1.HealthIndicatorService,
+        typeorm_2.DataSource])
+], MigrationsHealthIndicator);

package/dist/cjs/http/client-ip-options.interface.d.ts

@@ -0,0 +1,3 @@
+export interface ClientIpOptionsInterface {
+    readonly trustedHeaders?: readonly string[];
+}

package/dist/cjs/http/client-ip-options.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/http/index.d.ts

@@ -0,0 +1,2 @@
+export * from './client-ip-options.interface.js';
+export * from './resolve-client-ip.js';

package/dist/cjs/http/index.js

@@ -0,0 +1,18 @@
+"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("./client-ip-options.interface.js"), exports);
+__exportStar(require("./resolve-client-ip.js"), exports);

package/dist/cjs/http/resolve-client-ip.d.ts

@@ -0,0 +1,14 @@
+import type { ClientIpOptionsInterface } from './client-ip-options.interface.js';
+export interface ClientIpSourceInterface {
+    headers?: Record<string, string | string[] | undefined> | undefined;
+    ip?: string | undefined;
+    raw?: {
+        socket?: SocketLikeInterface | undefined;
+    } | undefined;
+    socket?: SocketLikeInterface | undefined;
+}
+interface SocketLikeInterface {
+    remoteAddress?: string | undefined;
+}
+export declare const resolveClientIp: (request: ClientIpSourceInterface, options?: ClientIpOptionsInterface) => string;
+export {};

package/dist/cjs/http/resolve-client-ip.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveClientIp = void 0;
+const firstHeaderValue = (value) => {
+    const single = Array.isArray(value) ? value[0] : value;
+    return (single ?? '').trim();
+};
+const trustedHeaderIp = (request, trustedHeaders) => {
+    const values = trustedHeaders?.map((header) => firstHeaderValue(request.headers?.[header]));
+    return values?.find((value) => value !== '') ?? '';
+};
+const rawSocketIp = (request) => request.raw?.socket?.remoteAddress ?? '';
+const socketIp = (request) => request.socket?.remoteAddress ?? rawSocketIp(request);
+const fallbackIp = (request) => {
+    const proxyAwareIp = (request.ip ?? '').trim();
+    return proxyAwareIp === '' ? socketIp(request) : proxyAwareIp;
+};
+const resolveClientIp = (request, options = {}) => {
+    const headerIp = trustedHeaderIp(request, options.trustedHeaders);
+    return headerIp === '' ? fallbackIp(request) : headerIp;
+};
+exports.resolveClientIp = resolveClientIp;

package/dist/cjs/logging/constants.d.ts

@@ -0,0 +1 @@
+export declare const OBSERVABILITY_LOGGER: unique symbol;

package/dist/cjs/logging/constants.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OBSERVABILITY_LOGGER = void 0;
+exports.OBSERVABILITY_LOGGER = Symbol('OBSERVABILITY_LOGGER');

package/dist/cjs/logging/index.d.ts

@@ -0,0 +1,8 @@
+export * from './constants.js';
+export * from './infrastructure-paths.js';
+export * from './logger.environment.js';
+export * from './observability-logger.interface.js';
+export * from './pino-logger-options.interface.js';
+export * from './pino-logger.config.js';
+export * from './resolve-request-id.js';
+export * from './resolve-support-id.js';

package/dist/cjs/logging/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("./constants.js"), exports);
+__exportStar(require("./infrastructure-paths.js"), exports);
+__exportStar(require("./logger.environment.js"), exports);
+__exportStar(require("./observability-logger.interface.js"), exports);
+__exportStar(require("./pino-logger-options.interface.js"), exports);
+__exportStar(require("./pino-logger.config.js"), exports);
+__exportStar(require("./resolve-request-id.js"), exports);
+__exportStar(require("./resolve-support-id.js"), exports);

package/dist/cjs/logging/infrastructure-paths.d.ts

@@ -0,0 +1,4 @@
+export declare const HEALTH_ROUTE = "health";
+export declare const METRICS_ROUTE = "metrics";
+export declare const INFRASTRUCTURE_PATHS: readonly string[];
+export declare const isInfrastructurePath: (path: string) => boolean;

package/dist/cjs/logging/infrastructure-paths.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isInfrastructurePath = exports.INFRASTRUCTURE_PATHS = exports.METRICS_ROUTE = exports.HEALTH_ROUTE = void 0;
+exports.HEALTH_ROUTE = 'health';
+exports.METRICS_ROUTE = 'metrics';
+exports.INFRASTRUCTURE_PATHS = [`/${exports.HEALTH_ROUTE}`, `/${exports.METRICS_ROUTE}`];
+const isInfrastructurePath = (path) => exports.INFRASTRUCTURE_PATHS
+    .some((prefix) => path === prefix || path.startsWith(`${prefix}/`));
+exports.isInfrastructurePath = isInfrastructurePath;

package/dist/cjs/logging/logger.environment.d.ts

@@ -0,0 +1,4 @@
+import type { LevelWithSilent } from 'pino';
+export declare class LoggerEnvironment {
+    LOG_LEVEL: LevelWithSilent;
+}

package/dist/cjs/logging/logger.environment.js

@@ -0,0 +1,24 @@
+"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.LoggerEnvironment = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const LOG_LEVELS = ['trace', 'debug', 'info', 'warn', 'error', 'fatal', 'silent'];
+class LoggerEnvironment {
+    LOG_LEVEL = 'warn';
+}
+exports.LoggerEnvironment = LoggerEnvironment;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsIn)(LOG_LEVELS),
+    __metadata("design:type", String)
+], LoggerEnvironment.prototype, "LOG_LEVEL", void 0);

package/dist/cjs/logging/observability-logger.interface.d.ts

@@ -0,0 +1,4 @@
+export interface ObservabilityLoggerInterface {
+    error(payload: object, message: string): void;
+    info(payload: object, message: string): void;
+}

package/dist/cjs/logging/observability-logger.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/logging/pino-logger-options.interface.d.ts

@@ -0,0 +1,5 @@
+import type { ClientIpSourceInterface } from '../http/resolve-client-ip.js';
+export type ClientIpResolver = (request: ClientIpSourceInterface) => string;
+export interface PinoLoggerOptionsInterface {
+    readonly resolveClientIp?: ClientIpResolver;
+}

package/dist/cjs/logging/pino-logger-options.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/logging/pino-logger.config.d.ts

@@ -0,0 +1,15 @@
+import type { Params } from 'nestjs-pino';
+import type { Level } from 'pino';
+import type { PinoLoggerOptionsInterface } from './pino-logger-options.interface.js';
+import { LoggerEnvironment } from './logger.environment.js';
+export declare const responseLogLevel: (request: {
+    url?: string | undefined;
+}, response: {
+    statusCode: number;
+}, error?: Error) => Level;
+export declare const traceContextMixin: () => Record<string, number | string>;
+export declare class PinoLoggerConfig {
+    private readonly environment;
+    constructor(environment: LoggerEnvironment);
+    createOptions(options?: PinoLoggerOptionsInterface): Params;
+}