@dumanarge/xssrv-shared-lib 1.0.3 → 1.0.5

package/dist/filters/grpc-app-exception.filter.d.ts

@@ -0,0 +1,11 @@
+import { ArgumentsHost } from '@nestjs/common';
+import { type Observable } from 'rxjs';
+export declare const GRPC_APP_ERROR_METADATA_KEY = "x-app-error";
+export declare const GRPC_REQUEST_ID_METADATA_KEY = "x-request-id";
+export declare const GRPC_CORRELATION_ID_METADATA_KEY = "x-correlation-id";
+export declare class GrpcAppExceptionFilter {
+    private readonly serviceName;
+    private readonly logger;
+    constructor(serviceName: string);
+    catch(exception: unknown, host: ArgumentsHost): Observable<never>;
+}

package/dist/filters/grpc-app-exception.filter.js

@@ -0,0 +1,177 @@
+"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.GrpcAppExceptionFilter = exports.GRPC_CORRELATION_ID_METADATA_KEY = exports.GRPC_REQUEST_ID_METADATA_KEY = exports.GRPC_APP_ERROR_METADATA_KEY = void 0;
+const common_1 = require("@nestjs/common");
+const rxjs_1 = require("rxjs");
+const errors_1 = require("../errors");
+const context_1 = require("../context");
+const metrics_1 = require("../metrics");
+const severity_1 = require("./severity");
+const otel_log_emitter_1 = require("../observability/otel-log-emitter");
+exports.GRPC_APP_ERROR_METADATA_KEY = 'x-app-error';
+exports.GRPC_REQUEST_ID_METADATA_KEY = 'x-request-id';
+exports.GRPC_CORRELATION_ID_METADATA_KEY = 'x-correlation-id';
+function readMetadataValue(metadata, key) {
+    const values = metadata?.get(key);
+    if (!values?.length) {
+        return undefined;
+    }
+    const value = values[0];
+    if (typeof value === 'string') {
+        return value;
+    }
+    if (value instanceof Uint8Array) {
+        return Buffer.from(value).toString('utf8');
+    }
+    return undefined;
+}
+function setMetadataValue(metadata, key, value) {
+    if (!metadata) {
+        return;
+    }
+    if (typeof metadata.set === 'function') {
+        metadata.set(key, value);
+        return;
+    }
+    if (typeof metadata.add === 'function') {
+        metadata.add(key, value);
+    }
+}
+function readRpcMetadata(host) {
+    const context = host.switchToRpc().getContext();
+    if (context && typeof context.get === 'function') {
+        return context;
+    }
+    return context?.metadata;
+}
+function normalizeException(exception, requestId, correlationId) {
+    if (exception instanceof errors_1.AppError) {
+        return exception;
+    }
+    return errors_1.AppError.internal({
+        requestId,
+        correlationId,
+        cause: exception,
+    });
+}
+function logBySeverity(logger, severity, payload) {
+    if (severity === 'info') {
+        logger.log({ ...payload, severity }, 'gRPC info-level issue observed');
+        return;
+    }
+    if (severity === 'fatal') {
+        logger.error({ ...payload, severity }, 'Fatal gRPC application error observed');
+        return;
+    }
+    if (severity === 'error') {
+        logger.error({ ...payload, severity }, 'gRPC application error observed');
+        return;
+    }
+    logger.warn({ ...payload, severity }, 'gRPC application warning observed');
+}
+function readGrpcStartAt(host) {
+    const data = host.switchToRpc().getData();
+    const startedAt = data?.__requestStartedAt ??
+        data?.requestStartedAt;
+    if (typeof startedAt === 'number' && Number.isFinite(startedAt)) {
+        return startedAt;
+    }
+    return Date.now();
+}
+let GrpcAppExceptionFilter = class GrpcAppExceptionFilter {
+    serviceName;
+    logger;
+    constructor(serviceName) {
+        this.serviceName = serviceName;
+        this.logger = new common_1.Logger(`GrpcAppExceptionFilter[${serviceName}]`);
+    }
+    catch(exception, host) {
+        const metadata = readRpcMetadata(host);
+        const contextData = context_1.ObservabilityContext.get();
+        const requestId = contextData?.requestId ?? readMetadataValue(metadata, exports.GRPC_REQUEST_ID_METADATA_KEY);
+        const correlationId = contextData?.correlationId ?? readMetadataValue(metadata, exports.GRPC_CORRELATION_ID_METADATA_KEY);
+        const appError = normalizeException(exception, requestId, correlationId);
+        const payload = appError.toPayload();
+        const grpcCode = payload.status.grpc ?? 13;
+        const severity = (0, severity_1.resolveSeverity)({
+            declaredSeverity: payload.severity,
+            grpcCode,
+            category: payload.category,
+        });
+        (0, metrics_1.recordRequestDurationMetric)(Date.now() - readGrpcStartAt(host), {
+            service: this.serviceName,
+            transport: 'grpc',
+            operation: contextData?.operation ?? 'unknown',
+        });
+        (0, metrics_1.recordAppErrorMetric)({
+            service: this.serviceName,
+            category: payload.category,
+            code: payload.code,
+            severity,
+        });
+        logBySeverity(this.logger, severity, {
+            event: 'app_error',
+            service: this.serviceName,
+            transport: 'grpc',
+            errorCode: payload.code,
+            category: payload.category,
+            retryable: payload.retryable,
+            status: payload.status,
+            requestId: payload.requestId,
+            correlationId: payload.correlationId,
+            ...context_1.ObservabilityContext.toLogMeta(),
+            details: payload.details,
+            fields: payload.fields,
+            timestamp: payload.timestamp,
+        });
+        (0, otel_log_emitter_1.emitOtelLog)({
+            service: this.serviceName,
+            severity,
+            message: payload.message,
+            attributes: {
+                category: payload.category,
+                code: payload.code,
+                transport: 'grpc',
+                requestId: payload.requestId,
+                correlationId: payload.correlationId,
+                grpcCode,
+                environment: process.env.NODE_ENV ?? 'development',
+            },
+            body: {
+                event: 'app_error',
+                status: payload.status,
+                details: payload.details,
+                fields: payload.fields,
+            },
+        });
+        setMetadataValue(metadata, exports.GRPC_APP_ERROR_METADATA_KEY, JSON.stringify(payload));
+        if (payload.requestId) {
+            setMetadataValue(metadata, exports.GRPC_REQUEST_ID_METADATA_KEY, payload.requestId);
+        }
+        if (payload.correlationId) {
+            setMetadataValue(metadata, exports.GRPC_CORRELATION_ID_METADATA_KEY, payload.correlationId);
+        }
+        const grpcError = {
+            code: grpcCode,
+            details: payload.message,
+            message: payload.message,
+            metadata,
+        };
+        return (0, rxjs_1.throwError)(() => grpcError);
+    }
+};
+exports.GrpcAppExceptionFilter = GrpcAppExceptionFilter;
+exports.GrpcAppExceptionFilter = GrpcAppExceptionFilter = __decorate([
+    (0, common_1.Catch)(),
+    __metadata("design:paramtypes", [String])
+], GrpcAppExceptionFilter);
+//# sourceMappingURL=grpc-app-exception.filter.js.map

package/dist/filters/grpc-app-exception.filter.js.map

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

package/dist/filters/http-app-exception.filter.d.ts

@@ -0,0 +1,7 @@
+import { ArgumentsHost } from '@nestjs/common';
+export declare class HttpAppExceptionFilter {
+    private readonly serviceName;
+    private readonly logger;
+    constructor(serviceName: string);
+    catch(exception: unknown, host: ArgumentsHost): void;
+}

package/dist/filters/http-app-exception.filter.js

@@ -0,0 +1,196 @@
+"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.HttpAppExceptionFilter = void 0;
+const common_1 = require("@nestjs/common");
+const errors_1 = require("../errors");
+const context_1 = require("../context");
+const metrics_1 = require("../metrics");
+const severity_1 = require("./severity");
+const otel_log_emitter_1 = require("../observability/otel-log-emitter");
+function readHttpStartAt(request) {
+    const startedAt = request.__requestStartedAt ??
+        request['requestStartedAt'];
+    if (typeof startedAt === 'number' && Number.isFinite(startedAt)) {
+        return startedAt;
+    }
+    return Date.now();
+}
+function normalizeException(exception, requestId, correlationId) {
+    if (exception instanceof errors_1.AppError) {
+        const payload = exception.toPayload();
+        return {
+            statusCode: payload.status.http,
+            errorCode: payload.code,
+            category: payload.category,
+            message: payload.message,
+            severity: payload.severity,
+            requestId: payload.requestId ?? requestId,
+            correlationId: payload.correlationId ?? correlationId,
+            retryable: payload.retryable,
+            timestamp: payload.timestamp,
+            details: payload.details,
+            fields: payload.fields,
+        };
+    }
+    if (exception instanceof common_1.HttpException) {
+        const statusCode = exception.getStatus();
+        const response = exception.getResponse();
+        const message = typeof response === 'object' && response !== null
+            ? (response.message ?? exception.message)
+            : exception.message;
+        return {
+            statusCode,
+            errorCode: `HTTP_${statusCode}`,
+            category: statusCode === 503 ? 'UNAVAILABLE' : statusCode >= 500 ? 'INTERNAL' : 'VALIDATION',
+            message,
+            requestId,
+            correlationId,
+            retryable: statusCode >= 500,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    if (exception instanceof Error) {
+        return {
+            statusCode: common_1.HttpStatus.INTERNAL_SERVER_ERROR,
+            errorCode: 'COMMON.INTERNAL',
+            category: 'INTERNAL',
+            message: exception.message,
+            requestId,
+            correlationId,
+            retryable: false,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    return {
+        statusCode: common_1.HttpStatus.INTERNAL_SERVER_ERROR,
+        errorCode: 'COMMON.INTERNAL',
+        category: 'INTERNAL',
+        message: 'An unexpected error occurred',
+        requestId,
+        correlationId,
+        retryable: false,
+        timestamp: new Date().toISOString(),
+    };
+}
+function logBySeverity(logger, severity, payload) {
+    if (severity === 'info') {
+        logger.log({ ...payload, severity }, 'Application info-level issue observed');
+        return;
+    }
+    if (severity === 'fatal') {
+        logger.error({ ...payload, severity }, 'Fatal application error observed');
+        return;
+    }
+    if (severity === 'error') {
+        logger.error({ ...payload, severity }, 'Application error observed');
+        return;
+    }
+    logger.warn({ ...payload, severity }, 'Application warning observed');
+}
+let HttpAppExceptionFilter = class HttpAppExceptionFilter {
+    serviceName;
+    logger;
+    constructor(serviceName) {
+        this.serviceName = serviceName;
+        this.logger = new common_1.Logger(`HttpAppExceptionFilter[${serviceName}]`);
+    }
+    catch(exception, host) {
+        const ctx = host.switchToHttp();
+        const request = ctx.getRequest();
+        const response = ctx.getResponse();
+        const contextData = context_1.ObservabilityContext.get();
+        const requestId = contextData?.requestId ?? request.headers?.['x-request-id'];
+        const correlationId = contextData?.correlationId ?? request.headers?.['x-correlation-id'];
+        const normalizedError = normalizeException(exception, requestId, correlationId);
+        const severity = (0, severity_1.resolveSeverity)({
+            declaredSeverity: normalizedError.severity,
+            httpStatus: normalizedError.statusCode,
+            category: normalizedError.category,
+        });
+        const durationMs = Date.now() - readHttpStartAt(request);
+        (0, metrics_1.recordRequestDurationMetric)(durationMs, {
+            service: this.serviceName,
+            transport: 'http',
+            operation: String(request.url ?? 'unknown'),
+            statusCode: normalizedError.statusCode,
+        });
+        (0, metrics_1.recordAppErrorMetric)({
+            service: this.serviceName,
+            category: normalizedError.category,
+            code: normalizedError.errorCode,
+            severity,
+        });
+        logBySeverity(this.logger, severity, {
+            event: 'app_error',
+            service: this.serviceName,
+            transport: 'http',
+            errorCode: normalizedError.errorCode,
+            category: normalizedError.category,
+            retryable: normalizedError.retryable,
+            status: { http: normalizedError.statusCode },
+            requestId: normalizedError.requestId,
+            correlationId: normalizedError.correlationId,
+            ...context_1.ObservabilityContext.toLogMeta(),
+            details: normalizedError.details,
+            fields: normalizedError.fields,
+            timestamp: normalizedError.timestamp,
+        });
+        (0, otel_log_emitter_1.emitOtelLog)({
+            service: this.serviceName,
+            severity,
+            message: typeof normalizedError.message === 'string' ? normalizedError.message : 'Application error',
+            attributes: {
+                category: normalizedError.category,
+                code: normalizedError.errorCode,
+                transport: 'http',
+                requestId: normalizedError.requestId,
+                correlationId: normalizedError.correlationId,
+                httpStatus: normalizedError.statusCode,
+                environment: process.env.NODE_ENV ?? 'development',
+            },
+            body: {
+                event: 'app_error',
+                status: { http: normalizedError.statusCode },
+                details: normalizedError.details,
+                fields: normalizedError.fields,
+            },
+        });
+        if (normalizedError.requestId && response.setHeader) {
+            response.setHeader('x-request-id', normalizedError.requestId);
+        }
+        if (normalizedError.correlationId && response.setHeader) {
+            response.setHeader('x-correlation-id', normalizedError.correlationId);
+        }
+        const responseBody = {
+            errorCode: normalizedError.errorCode,
+            category: normalizedError.category,
+            message: normalizedError.message,
+            requestId: normalizedError.requestId,
+            correlationId: normalizedError.correlationId,
+            timestamp: normalizedError.timestamp,
+            fields: normalizedError.fields,
+        };
+        if (typeof response.code === 'function') {
+            response.code(normalizedError.statusCode).send(responseBody);
+            return;
+        }
+        if (typeof response.status === 'function') {
+            response.status(normalizedError.statusCode).send(responseBody);
+        }
+    }
+};
+exports.HttpAppExceptionFilter = HttpAppExceptionFilter;
+exports.HttpAppExceptionFilter = HttpAppExceptionFilter = __decorate([
+    (0, common_1.Catch)(),
+    __metadata("design:paramtypes", [String])
+], HttpAppExceptionFilter);
+//# sourceMappingURL=http-app-exception.filter.js.map

package/dist/filters/http-app-exception.filter.js.map

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

package/dist/filters/index.d.ts

@@ -0,0 +1,3 @@
+export { HttpAppExceptionFilter } from './http-app-exception.filter';
+export { GrpcAppExceptionFilter, GRPC_APP_ERROR_METADATA_KEY, GRPC_REQUEST_ID_METADATA_KEY, GRPC_CORRELATION_ID_METADATA_KEY, } from './grpc-app-exception.filter';
+export { resolveSeverity } from './severity';

package/dist/filters/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSeverity = exports.GRPC_CORRELATION_ID_METADATA_KEY = exports.GRPC_REQUEST_ID_METADATA_KEY = exports.GRPC_APP_ERROR_METADATA_KEY = exports.GrpcAppExceptionFilter = exports.HttpAppExceptionFilter = void 0;
+var http_app_exception_filter_1 = require("./http-app-exception.filter");
+Object.defineProperty(exports, "HttpAppExceptionFilter", { enumerable: true, get: function () { return http_app_exception_filter_1.HttpAppExceptionFilter; } });
+var grpc_app_exception_filter_1 = require("./grpc-app-exception.filter");
+Object.defineProperty(exports, "GrpcAppExceptionFilter", { enumerable: true, get: function () { return grpc_app_exception_filter_1.GrpcAppExceptionFilter; } });
+Object.defineProperty(exports, "GRPC_APP_ERROR_METADATA_KEY", { enumerable: true, get: function () { return grpc_app_exception_filter_1.GRPC_APP_ERROR_METADATA_KEY; } });
+Object.defineProperty(exports, "GRPC_REQUEST_ID_METADATA_KEY", { enumerable: true, get: function () { return grpc_app_exception_filter_1.GRPC_REQUEST_ID_METADATA_KEY; } });
+Object.defineProperty(exports, "GRPC_CORRELATION_ID_METADATA_KEY", { enumerable: true, get: function () { return grpc_app_exception_filter_1.GRPC_CORRELATION_ID_METADATA_KEY; } });
+var severity_1 = require("./severity");
+Object.defineProperty(exports, "resolveSeverity", { enumerable: true, get: function () { return severity_1.resolveSeverity; } });
+//# sourceMappingURL=index.js.map

package/dist/filters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/filters/index.ts"],"names":[],"mappings":";;;AAAA,yEAAqE;AAA5D,mIAAA,sBAAsB,OAAA;AAC/B,yEAKqC;AAJnC,mIAAA,sBAAsB,OAAA;AACtB,wIAAA,2BAA2B,OAAA;AAC3B,yIAAA,4BAA4B,OAAA;AAC5B,6IAAA,gCAAgC,OAAA;AAElC,uCAA6C;AAApC,2GAAA,eAAe,OAAA"}

package/dist/filters/severity.d.ts

@@ -0,0 +1,7 @@
+import { AppMetricSeverity } from '../metrics';
+export declare function resolveSeverity(options: {
+    declaredSeverity?: AppMetricSeverity;
+    httpStatus?: number;
+    grpcCode?: number;
+    category?: string;
+}): AppMetricSeverity;

package/dist/filters/severity.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSeverity = resolveSeverity;
+const errors_1 = require("../errors");
+const SERVICE_DOWN_CATEGORIES = new Set(['UNAVAILABLE', 'DEPENDENCY', 'INFRASTRUCTURE']);
+const INFO_HTTP_STATUSES = new Set([404]);
+const WARN_HTTP_STATUSES = new Set([400, 401, 403, 409, 422, 429, 504]);
+const INFO_GRPC_CODES = new Set([5]);
+const WARN_GRPC_CODES = new Set([3, 4, 6, 7, 9, 16]);
+const ERROR_GRPC_CODES = new Set([2, 13, 15]);
+function resolveSeverity(options) {
+    if (options.declaredSeverity) {
+        return options.declaredSeverity;
+    }
+    const category = options.category?.toUpperCase();
+    const serviceDown = (options.httpStatus === 503 || options.grpcCode === 14) &&
+        (category ? SERVICE_DOWN_CATEGORIES.has(category) : true);
+    if (serviceDown) {
+        return 'fatal';
+    }
+    if (typeof options.httpStatus === 'number') {
+        if (INFO_HTTP_STATUSES.has(options.httpStatus)) {
+            return 'info';
+        }
+        if (WARN_HTTP_STATUSES.has(options.httpStatus)) {
+            return 'warn';
+        }
+        if (options.httpStatus >= 500) {
+            return 'error';
+        }
+        if (options.httpStatus >= 400) {
+            return 'warn';
+        }
+    }
+    if (typeof options.grpcCode === 'number') {
+        if (INFO_GRPC_CODES.has(options.grpcCode)) {
+            return 'info';
+        }
+        if (ERROR_GRPC_CODES.has(options.grpcCode)) {
+            return 'error';
+        }
+        if (WARN_GRPC_CODES.has(options.grpcCode) || options.grpcCode === 14) {
+            return 'warn';
+        }
+    }
+    if (category && category in errors_1.categorySeverityMap) {
+        return errors_1.categorySeverityMap[category];
+    }
+    return 'warn';
+}
+//# sourceMappingURL=severity.js.map

package/dist/filters/severity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"severity.js","sourceRoot":"","sources":["../../src/filters/severity.ts"],"names":[],"mappings":";;AAWA,0CAoDC;AA9DD,sCAAgD;AAEhD,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAC,CAAC,aAAa,EAAE,YAAY,EAAE,gBAAgB,CAAC,CAAC,CAAC;AACzF,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1C,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAExE,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACrC,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AACrD,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;AAE9C,SAAgB,eAAe,CAAC,OAK/B;IACC,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC7B,OAAO,OAAO,CAAC,gBAAgB,CAAC;IAClC,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC;IAEjD,MAAM,WAAW,GACf,CAAC,OAAO,CAAC,UAAU,KAAK,GAAG,IAAI,OAAO,CAAC,QAAQ,KAAK,EAAE,CAAC;QACvD,CAAC,QAAQ,CAAC,CAAC,CAAC,uBAAuB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAE5D,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC3C,IAAI,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/C,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,IAAI,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/C,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,IAAI,OAAO,CAAC,UAAU,IAAI,GAAG,EAAE,CAAC;YAC9B,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,IAAI,OAAO,CAAC,UAAU,IAAI,GAAG,EAAE,CAAC;YAC9B,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAED,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACzC,IAAI,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1C,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,IAAI,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3C,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,IAAI,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,KAAK,EAAE,EAAE,CAAC;YACrE,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,IAAI,QAAQ,IAAI,4BAAmB,EAAE,CAAC;QAChD,OAAO,4BAAmB,CAAC,QAA4C,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -1,8 +1,16 @@
 export { Span, trace, context, SpanStatusCode } from './tracing/span.decorator';
 export { LoggingModule, PINO_LOGGER_CONFIG } from './logging/logging.module';
+export { HttpAppExceptionFilter } from './logging/http-exception.filter';
+export { RequestLoggingInterceptor } from './logging/request-logging.interceptor';
+export * from './filters';
 export { HealthModule, HealthController, RedisHealthIndicator, RabbitMQHealthIndicator, } from './health/health.module';
 export { OutboxEvent, OutboxRepository, OutboxWorker, EventPublisher, RabbitMQEventPublisher, } from './outbox/outbox.module';
 export { TenantContext, TenantMiddleware, TenantGuard, createPrismaTenantMiddleware, extractTenantFromGrpcMetadata, } from './auth/tenant.middleware';
 export { AuditInterceptor, AuditEntry } from './auth/audit.interceptor';
+export * from './errors';
+export * from './context';
+export * from './metrics';
 export { GracefulShutdownService, GracefulShutdownModule, enableGracefulShutdown, ShutdownHook } from './config/graceful-shutdown';
 export { FeatureFlagService, FeatureFlag } from './config/feature-flags';
+export { emitAppErrorObservability, resolveErrorSeverity, type AppErrorSeverity, type AppErrorLogPayload, } from './observability/error-observability';
+export { ObservabilityContextStorage, type ObservabilityContextData, } from './observability/request-context';

package/dist/index.js

@@ -1,6 +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 });
-exports.FeatureFlagService = exports.enableGracefulShutdown = exports.GracefulShutdownModule = exports.GracefulShutdownService = exports.AuditInterceptor = exports.extractTenantFromGrpcMetadata = exports.createPrismaTenantMiddleware = exports.TenantGuard = exports.TenantMiddleware = exports.TenantContext = exports.RabbitMQEventPublisher = exports.EventPublisher = exports.OutboxWorker = exports.OutboxRepository = exports.RabbitMQHealthIndicator = exports.RedisHealthIndicator = exports.HealthController = exports.HealthModule = exports.PINO_LOGGER_CONFIG = exports.LoggingModule = exports.SpanStatusCode = exports.context = exports.trace = exports.Span = void 0;
+exports.ObservabilityContextStorage = exports.resolveErrorSeverity = exports.emitAppErrorObservability = exports.FeatureFlagService = exports.enableGracefulShutdown = exports.GracefulShutdownModule = exports.GracefulShutdownService = exports.AuditInterceptor = exports.extractTenantFromGrpcMetadata = exports.createPrismaTenantMiddleware = exports.TenantGuard = exports.TenantMiddleware = exports.TenantContext = exports.RabbitMQEventPublisher = exports.EventPublisher = exports.OutboxWorker = exports.OutboxRepository = exports.RabbitMQHealthIndicator = exports.RedisHealthIndicator = exports.HealthController = exports.HealthModule = exports.RequestLoggingInterceptor = exports.HttpAppExceptionFilter = exports.PINO_LOGGER_CONFIG = exports.LoggingModule = exports.SpanStatusCode = exports.context = exports.trace = exports.Span = void 0;
 var span_decorator_1 = require("./tracing/span.decorator");
 Object.defineProperty(exports, "Span", { enumerable: true, get: function () { return span_decorator_1.Span; } });
 Object.defineProperty(exports, "trace", { enumerable: true, get: function () { return span_decorator_1.trace; } });
@@ -9,6 +23,11 @@ Object.defineProperty(exports, "SpanStatusCode", { enumerable: true, get: functi
 var logging_module_1 = require("./logging/logging.module");
 Object.defineProperty(exports, "LoggingModule", { enumerable: true, get: function () { return logging_module_1.LoggingModule; } });
 Object.defineProperty(exports, "PINO_LOGGER_CONFIG", { enumerable: true, get: function () { return logging_module_1.PINO_LOGGER_CONFIG; } });
+var http_exception_filter_1 = require("./logging/http-exception.filter");
+Object.defineProperty(exports, "HttpAppExceptionFilter", { enumerable: true, get: function () { return http_exception_filter_1.HttpAppExceptionFilter; } });
+var request_logging_interceptor_1 = require("./logging/request-logging.interceptor");
+Object.defineProperty(exports, "RequestLoggingInterceptor", { enumerable: true, get: function () { return request_logging_interceptor_1.RequestLoggingInterceptor; } });
+__exportStar(require("./filters"), exports);
 var health_module_1 = require("./health/health.module");
 Object.defineProperty(exports, "HealthModule", { enumerable: true, get: function () { return health_module_1.HealthModule; } });
 Object.defineProperty(exports, "HealthController", { enumerable: true, get: function () { return health_module_1.HealthController; } });
@@ -27,10 +46,18 @@ Object.defineProperty(exports, "createPrismaTenantMiddleware", { enumerable: tru
 Object.defineProperty(exports, "extractTenantFromGrpcMetadata", { enumerable: true, get: function () { return tenant_middleware_1.extractTenantFromGrpcMetadata; } });
 var audit_interceptor_1 = require("./auth/audit.interceptor");
 Object.defineProperty(exports, "AuditInterceptor", { enumerable: true, get: function () { return audit_interceptor_1.AuditInterceptor; } });
+__exportStar(require("./errors"), exports);
+__exportStar(require("./context"), exports);
+__exportStar(require("./metrics"), exports);
 var graceful_shutdown_1 = require("./config/graceful-shutdown");
 Object.defineProperty(exports, "GracefulShutdownService", { enumerable: true, get: function () { return graceful_shutdown_1.GracefulShutdownService; } });
 Object.defineProperty(exports, "GracefulShutdownModule", { enumerable: true, get: function () { return graceful_shutdown_1.GracefulShutdownModule; } });
 Object.defineProperty(exports, "enableGracefulShutdown", { enumerable: true, get: function () { return graceful_shutdown_1.enableGracefulShutdown; } });
 var feature_flags_1 = require("./config/feature-flags");
 Object.defineProperty(exports, "FeatureFlagService", { enumerable: true, get: function () { return feature_flags_1.FeatureFlagService; } });
+var error_observability_1 = require("./observability/error-observability");
+Object.defineProperty(exports, "emitAppErrorObservability", { enumerable: true, get: function () { return error_observability_1.emitAppErrorObservability; } });
+Object.defineProperty(exports, "resolveErrorSeverity", { enumerable: true, get: function () { return error_observability_1.resolveErrorSeverity; } });
+var request_context_1 = require("./observability/request-context");
+Object.defineProperty(exports, "ObservabilityContextStorage", { enumerable: true, get: function () { return request_context_1.ObservabilityContextStorage; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,2DAAgF;AAAvE,sGAAA,IAAI,OAAA;AAAE,uGAAA,KAAK,OAAA;AAAE,yGAAA,OAAO,OAAA;AAAE,gHAAA,cAAc,OAAA;AAG7C,2DAA6E;AAApE,+GAAA,aAAa,OAAA;AAAE,oHAAA,kBAAkB,OAAA;AAG1C,wDAKgC;AAJ9B,6GAAA,YAAY,OAAA;AACZ,iHAAA,gBAAgB,OAAA;AAChB,qHAAA,oBAAoB,OAAA;AACpB,wHAAA,uBAAuB,OAAA;AAIzB,wDAMgC;AAJ9B,iHAAA,gBAAgB,OAAA;AAChB,6GAAA,YAAY,OAAA;AACZ,+GAAA,cAAc,OAAA;AACd,uHAAA,sBAAsB,OAAA;AAIxB,8DAMkC;AALhC,kHAAA,aAAa,OAAA;AACb,qHAAA,gBAAgB,OAAA;AAChB,gHAAA,WAAW,OAAA;AACX,iIAAA,4BAA4B,OAAA;AAC5B,kIAAA,6BAA6B,OAAA;AAG/B,8DAAwE;AAA/D,qHAAA,gBAAgB,OAAA;AAGzB,gEAAmI;AAA1H,4HAAA,uBAAuB,OAAA;AAAE,2HAAA,sBAAsB,OAAA;AAAE,2HAAA,sBAAsB,OAAA;AAChF,wDAAyE;AAAhE,mHAAA,kBAAkB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AACA,2DAAgF;AAAvE,sGAAA,IAAI,OAAA;AAAE,uGAAA,KAAK,OAAA;AAAE,yGAAA,OAAO,OAAA;AAAE,gHAAA,cAAc,OAAA;AAG7C,2DAA6E;AAApE,+GAAA,aAAa,OAAA;AAAE,oHAAA,kBAAkB,OAAA;AAC1C,yEAAyE;AAAhE,+HAAA,sBAAsB,OAAA;AAC/B,qFAAkF;AAAzE,wIAAA,yBAAyB,OAAA;AAGlC,4CAA0B;AAG1B,wDAKgC;AAJ9B,6GAAA,YAAY,OAAA;AACZ,iHAAA,gBAAgB,OAAA;AAChB,qHAAA,oBAAoB,OAAA;AACpB,wHAAA,uBAAuB,OAAA;AAIzB,wDAMgC;AAJ9B,iHAAA,gBAAgB,OAAA;AAChB,6GAAA,YAAY,OAAA;AACZ,+GAAA,cAAc,OAAA;AACd,uHAAA,sBAAsB,OAAA;AAIxB,8DAMkC;AALhC,kHAAA,aAAa,OAAA;AACb,qHAAA,gBAAgB,OAAA;AAChB,gHAAA,WAAW,OAAA;AACX,iIAAA,4BAA4B,OAAA;AAC5B,kIAAA,6BAA6B,OAAA;AAG/B,8DAAwE;AAA/D,qHAAA,gBAAgB,OAAA;AAGzB,2CAAyB;AAGzB,4CAA0B;AAG1B,4CAA0B;AAG1B,gEAAmI;AAA1H,4HAAA,uBAAuB,OAAA;AAAE,2HAAA,sBAAsB,OAAA;AAAE,2HAAA,sBAAsB,OAAA;AAChF,wDAAyE;AAAhE,mHAAA,kBAAkB,OAAA;AAG3B,2EAK6C;AAJ3C,gIAAA,yBAAyB,OAAA;AACzB,2HAAA,oBAAoB,OAAA;AAItB,mEAGyC;AAFvC,8HAAA,2BAA2B,OAAA"}

package/dist/logging/http-exception.filter.d.ts

@@ -0,0 +1 @@
+export { HttpAppExceptionFilter } from '../filters/http-app-exception.filter';

package/dist/logging/http-exception.filter.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpAppExceptionFilter = void 0;
+var http_app_exception_filter_1 = require("../filters/http-app-exception.filter");
+Object.defineProperty(exports, "HttpAppExceptionFilter", { enumerable: true, get: function () { return http_app_exception_filter_1.HttpAppExceptionFilter; } });
+//# sourceMappingURL=http-exception.filter.js.map

package/dist/logging/http-exception.filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-exception.filter.js","sourceRoot":"","sources":["../../src/logging/http-exception.filter.ts"],"names":[],"mappings":";;;AAAA,kFAA8E;AAArE,mIAAA,sBAAsB,OAAA"}