@dumanarge/xssrv-shared-lib 1.0.3 → 1.0.5

package/dist/logging/logging.module.d.ts

@@ -17,7 +17,11 @@ export declare const PINO_LOGGER_CONFIG: {
                 url: any;
                 headers: {
                     'x-request-id': any;
+                    'x-correlation-id': any;
                     'x-tenant-id': any;
+                    'x-user-id': any;
+                    'x-account-id': any;
+                    'x-user-email': any;
                     'user-agent': any;
                 };
             };
@@ -25,14 +29,27 @@ export declare const PINO_LOGGER_CONFIG: {
                 statusCode: any;
             };
         };
-        customProps: () => {
+        customProps: (req: any) => {
+            requestId: any;
+            correlationId: any;
+            tenantId: string;
+            userId: string;
+            accountId: string;
+            userEmail: string;
+            origin: "http" | "grpc" | "rabbitmq" | "cron" | "system";
+            operation: string;
+        } | {
             traceId: string;
             spanId: string;
             traceFlags: number;
-        } | {
-            traceId?: undefined;
-            spanId?: undefined;
-            traceFlags?: undefined;
+            requestId: any;
+            correlationId: any;
+            tenantId: string;
+            userId: string;
+            accountId: string;
+            userEmail: string;
+            origin: "http" | "grpc" | "rabbitmq" | "cron" | "system";
+            operation: string;
         };
         redact: {
             paths: string[];

package/dist/logging/logging.module.js

@@ -10,6 +10,19 @@ exports.LoggingModule = exports.PINO_LOGGER_CONFIG = void 0;
 const common_1 = require("@nestjs/common");
 const nestjs_pino_1 = require("nestjs-pino");
 const api_1 = require("@opentelemetry/api");
+const crypto_1 = require("crypto");
+const observability_context_1 = require("../context/observability-context");
+const isProduction = process.env.NODE_ENV === 'production';
+const redactPaths = [
+    'req.headers.authorization',
+    'req.headers.cookie',
+    'req.body.password',
+    'req.body.secret',
+    'req.body.token',
+];
+if (isProduction) {
+    redactPaths.push('req.headers.x-user-email', 'req.body.email', 'email', 'user.email');
+}
 exports.PINO_LOGGER_CONFIG = {
     pinoHttp: {
         level: process.env.LOG_LEVEL || 'info',
@@ -27,7 +40,11 @@ exports.PINO_LOGGER_CONFIG = {
                 url: req.url,
                 headers: {
                     'x-request-id': req.headers['x-request-id'],
+                    'x-correlation-id': req.headers['x-correlation-id'],
                     'x-tenant-id': req.headers['x-tenant-id'],
+                    'x-user-id': req.headers['x-user-id'],
+                    'x-account-id': req.headers['x-account-id'],
+                    'x-user-email': req.headers['x-user-email'],
                     'user-agent': req.headers['user-agent'],
                 },
             }),
@@ -35,30 +52,42 @@ exports.PINO_LOGGER_CONFIG = {
                 statusCode: res.statusCode,
             }),
         },
-        customProps: () => {
+        customProps: (req) => {
             const activeSpan = api_1.trace.getActiveSpan();
+            const contextData = observability_context_1.ObservabilityContext.get();
+            const requestId = contextData?.requestId ?? req?.id ?? req?.headers?.['x-request-id'];
+            const correlationId = contextData?.correlationId ?? req?.headers?.['x-correlation-id'] ?? requestId;
+            const baseProps = {
+                requestId,
+                correlationId,
+                tenantId: contextData?.tenantId,
+                userId: contextData?.userId,
+                accountId: contextData?.accountId,
+                userEmail: contextData?.userEmail,
+                origin: contextData?.origin,
+                operation: contextData?.operation,
+            };
             if (activeSpan) {
                 const spanContext = activeSpan.spanContext();
+                observability_context_1.ObservabilityContext.set({
+                    traceId: spanContext.traceId,
+                    spanId: spanContext.spanId,
+                });
                 return {
+                    ...baseProps,
                     traceId: spanContext.traceId,
                     spanId: spanContext.spanId,
                     traceFlags: spanContext.traceFlags,
                 };
             }
-            return {};
+            return baseProps;
         },
         redact: {
-            paths: [
-                'req.headers.authorization',
-                'req.headers.cookie',
-                'req.body.password',
-                'req.body.secret',
-                'req.body.token',
-            ],
+            paths: redactPaths,
             censor: '[REDACTED]',
         },
         genReqId: (req) => {
-            return req.headers['x-request-id'] || crypto.randomUUID();
+            return req.headers['x-request-id'] || (0, crypto_1.randomUUID)();
         },
     },
 };

package/dist/logging/logging.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"logging.module.js","sourceRoot":"","sources":["../../src/logging/logging.module.ts"],"names":[],"mappings":";;;;;;;;;AAUA,2CAAwC;AACxC,6CAA+D;AAC/D,4CAAoD;AAEvC,QAAA,kBAAkB,GAAG;IAChC,QAAQ,EAAE;QACR,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM;QACtC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa;YAC/C,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE;YAC1E,CAAC,CAAC,SAAS;QACb,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,GAAQ,EAAE,EAAE;gBAEnB,OAAO,GAAG,CAAC,GAAG,KAAK,cAAc,IAAI,GAAG,CAAC,GAAG,KAAK,eAAe,IAAI,GAAG,CAAC,GAAG,KAAK,UAAU,CAAC;YAC7F,CAAC;SACF;QACD,WAAW,EAAE;YACX,GAAG,EAAE,CAAC,GAAQ,EAAE,EAAE,CAAC,CAAC;gBAClB,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,GAAG,EAAE,GAAG,CAAC,GAAG;gBACZ,OAAO,EAAE;oBACP,cAAc,EAAE,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC;oBAC3C,aAAa,EAAE,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC;oBACzC,YAAY,EAAE,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC;iBACxC;aACF,CAAC;YACF,GAAG,EAAE,CAAC,GAAQ,EAAE,EAAE,CAAC,CAAC;gBAClB,UAAU,EAAE,GAAG,CAAC,UAAU;aAC3B,CAAC;SACH;QACD,WAAW,EAAE,GAAG,EAAE;YAChB,MAAM,UAAU,GAAG,WAAK,CAAC,aAAa,EAAE,CAAC;YACzC,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,WAAW,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;gBAC7C,OAAO;oBACL,OAAO,EAAE,WAAW,CAAC,OAAO;oBAC5B,MAAM,EAAE,WAAW,CAAC,MAAM;oBAC1B,UAAU,EAAE,WAAW,CAAC,UAAU;iBACnC,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,EAAE;YACN,KAAK,EAAE;gBACL,2BAA2B;gBAC3B,oBAAoB;gBACpB,mBAAmB;gBACnB,iBAAiB;gBACjB,gBAAgB;aACjB;YACD,MAAM,EAAE,YAAY;SACrB;QACD,QAAQ,EAAE,CAAC,GAAQ,EAAE,EAAE;YACrB,OAAO,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QAC5D,CAAC;KACF;CACF,CAAC;AAMK,IAAM,aAAa,GAAnB,MAAM,aAAa;CAAG,CAAA;AAAhB,sCAAa;wBAAb,aAAa;IAJzB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,0BAAgB,CAAC,OAAO,CAAC,0BAAkB,CAAC,CAAC;QACvD,OAAO,EAAE,CAAC,0BAAgB,CAAC;KAC5B,CAAC;GACW,aAAa,CAAG"}
+{"version":3,"file":"logging.module.js","sourceRoot":"","sources":["../../src/logging/logging.module.ts"],"names":[],"mappings":"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"}

package/dist/logging/request-logging.interceptor.d.ts

@@ -0,0 +1,5 @@
+import { CallHandler, ExecutionContext, NestInterceptor } from '@nestjs/common';
+import { Observable } from 'rxjs';
+export declare class RequestLoggingInterceptor implements NestInterceptor {
+    intercept(context: ExecutionContext, next: CallHandler): Observable<unknown>;
+}

package/dist/logging/request-logging.interceptor.js

@@ -0,0 +1,59 @@
+"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.RequestLoggingInterceptor = void 0;
+const common_1 = require("@nestjs/common");
+const crypto_1 = require("crypto");
+const rxjs_1 = require("rxjs");
+const request_context_1 = require("../observability/request-context");
+const metrics_1 = require("../metrics");
+let RequestLoggingInterceptor = class RequestLoggingInterceptor {
+    intercept(context, next) {
+        if (context.getType() !== 'http') {
+            return next.handle();
+        }
+        const http = context.switchToHttp();
+        const request = http.getRequest();
+        const response = http.getResponse();
+        const ctx = (0, request_context_1.createHttpObservabilityContext)(request);
+        const requestId = ctx.requestId ?? request.id ?? (0, crypto_1.randomUUID)();
+        const correlationId = ctx.correlationId ?? requestId;
+        const startedAt = Date.now();
+        request.__requestStartedAt = startedAt;
+        if (response.setHeader) {
+            response.setHeader('x-request-id', requestId);
+            response.setHeader('x-correlation-id', correlationId);
+        }
+        return new rxjs_1.Observable((subscriber) => {
+            request_context_1.ObservabilityContextStorage.run({
+                ...ctx,
+                requestId,
+                correlationId,
+            }, () => {
+                next.handle().subscribe({
+                    next: (value) => subscriber.next(value),
+                    error: (error) => subscriber.error(error),
+                    complete: () => {
+                        (0, metrics_1.recordRequestDurationMetric)(Date.now() - startedAt, {
+                            service: process.env.SERVICE_NAME ?? 'unknown-service',
+                            transport: 'http',
+                            operation: String(request.url ?? 'unknown'),
+                            statusCode: response.statusCode,
+                        });
+                        subscriber.complete();
+                    },
+                });
+            });
+        });
+    }
+};
+exports.RequestLoggingInterceptor = RequestLoggingInterceptor;
+exports.RequestLoggingInterceptor = RequestLoggingInterceptor = __decorate([
+    (0, common_1.Injectable)()
+], RequestLoggingInterceptor);
+//# sourceMappingURL=request-logging.interceptor.js.map

package/dist/logging/request-logging.interceptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-logging.interceptor.js","sourceRoot":"","sources":["../../src/logging/request-logging.interceptor.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAKwB;AACxB,mCAAoC;AACpC,+BAAkC;AAClC,sEAG0C;AAC1C,wCAAyD;AAGlD,IAAM,yBAAyB,GAA/B,MAAM,yBAAyB;IACpC,SAAS,CAAC,OAAyB,EAAE,IAAiB;QACpD,IAAI,OAAO,CAAC,OAAO,EAAE,KAAK,MAAM,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,CAAC;QAED,MAAM,IAAI,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAI3B,CAAC;QACL,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAwD,CAAC;QAE1F,MAAM,GAAG,GAAG,IAAA,gDAA8B,EAAC,OAAO,CAAC,CAAC;QACpD,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,IAAI,OAAO,CAAC,EAAE,IAAI,IAAA,mBAAU,GAAE,CAAC;QAC9D,MAAM,aAAa,GAAG,GAAG,CAAC,aAAa,IAAI,SAAS,CAAC;QACrD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5B,OAAmC,CAAC,kBAAkB,GAAG,SAAS,CAAC;QAEpE,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;YACvB,QAAQ,CAAC,SAAS,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;YAC9C,QAAQ,CAAC,SAAS,CAAC,kBAAkB,EAAE,aAAa,CAAC,CAAC;QACxD,CAAC;QAED,OAAO,IAAI,iBAAU,CAAC,CAAC,UAAU,EAAE,EAAE;YACnC,6CAA2B,CAAC,GAAG,CAC7B;gBACE,GAAG,GAAG;gBACN,SAAS;gBACT,aAAa;aACd,EACD,GAAG,EAAE;gBACH,IAAI,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC;oBACtB,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC;oBACvC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC;oBACzC,QAAQ,EAAE,GAAG,EAAE;wBACb,IAAA,qCAA2B,EAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE;4BAClD,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,iBAAiB;4BACtD,SAAS,EAAE,MAAM;4BACjB,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,SAAS,CAAC;4BAC3C,UAAU,EAAG,QAAoC,CAAC,UAAgC;yBACnF,CAAC,CAAC;wBACH,UAAU,CAAC,QAAQ,EAAE,CAAC;oBACxB,CAAC;iBACF,CAAC,CAAC;YACL,CAAC,CACF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AAlDY,8DAAyB;oCAAzB,yBAAyB;IADrC,IAAA,mBAAU,GAAE;GACA,yBAAyB,CAkDrC"}

package/dist/metrics/index.d.ts

@@ -0,0 +1 @@
+export { appErrorsCounter, requestDurationHistogram, recordAppErrorMetric, recordRequestDurationMetric, type AppMetricSeverity, type AppErrorMetricInput, type RequestDurationMetricInput, } from './metrics';

package/dist/metrics/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.recordRequestDurationMetric = exports.recordAppErrorMetric = exports.requestDurationHistogram = exports.appErrorsCounter = void 0;
+var metrics_1 = require("./metrics");
+Object.defineProperty(exports, "appErrorsCounter", { enumerable: true, get: function () { return metrics_1.appErrorsCounter; } });
+Object.defineProperty(exports, "requestDurationHistogram", { enumerable: true, get: function () { return metrics_1.requestDurationHistogram; } });
+Object.defineProperty(exports, "recordAppErrorMetric", { enumerable: true, get: function () { return metrics_1.recordAppErrorMetric; } });
+Object.defineProperty(exports, "recordRequestDurationMetric", { enumerable: true, get: function () { return metrics_1.recordRequestDurationMetric; } });
+//# sourceMappingURL=index.js.map

package/dist/metrics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/metrics/index.ts"],"names":[],"mappings":";;;AAAA,qCAQmB;AAPjB,2GAAA,gBAAgB,OAAA;AAChB,mHAAA,wBAAwB,OAAA;AACxB,+GAAA,oBAAoB,OAAA;AACpB,sHAAA,2BAA2B,OAAA"}

package/dist/metrics/metrics.d.ts

@@ -0,0 +1,17 @@
+export type AppMetricSeverity = 'info' | 'warn' | 'error' | 'fatal';
+export interface AppErrorMetricInput {
+    service: string;
+    category: string;
+    code: string;
+    severity: AppMetricSeverity;
+}
+export interface RequestDurationMetricInput {
+    service: string;
+    transport: 'http' | 'grpc' | 'rabbitmq' | 'system';
+    operation: string;
+    statusCode?: number;
+}
+export declare const appErrorsCounter: import("@opentelemetry/api").Counter<import("@opentelemetry/api").Attributes>;
+export declare const requestDurationHistogram: import("@opentelemetry/api").Histogram<import("@opentelemetry/api").Attributes>;
+export declare function recordAppErrorMetric(input: AppErrorMetricInput): void;
+export declare function recordRequestDurationMetric(durationMs: number, input: RequestDurationMetricInput): void;

package/dist/metrics/metrics.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requestDurationHistogram = exports.appErrorsCounter = void 0;
+exports.recordAppErrorMetric = recordAppErrorMetric;
+exports.recordRequestDurationMetric = recordRequestDurationMetric;
+const api_1 = require("@opentelemetry/api");
+const meter = api_1.metrics.getMeter('xenonsmart-backend');
+exports.appErrorsCounter = meter.createCounter('app_errors_total', {
+    description: 'Total application errors by service/category/code/severity',
+});
+exports.requestDurationHistogram = meter.createHistogram('app_request_duration_ms', {
+    description: 'Application request duration in milliseconds',
+    unit: 'ms',
+});
+function recordAppErrorMetric(input) {
+    exports.appErrorsCounter.add(1, {
+        service: input.service,
+        category: input.category,
+        code: input.code,
+        severity: input.severity,
+    });
+}
+function recordRequestDurationMetric(durationMs, input) {
+    exports.requestDurationHistogram.record(durationMs, {
+        service: input.service,
+        transport: input.transport,
+        operation: input.operation,
+        status_code: input.statusCode ? String(input.statusCode) : 'unknown',
+    });
+}
+//# sourceMappingURL=metrics.js.map

package/dist/metrics/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/metrics/metrics.ts"],"names":[],"mappings":";;;AA6BA,oDAOC;AAED,kEAUC;AAhDD,4CAA6C;AAkB7C,MAAM,KAAK,GAAG,aAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC;AAExC,QAAA,gBAAgB,GAAG,KAAK,CAAC,aAAa,CAAC,kBAAkB,EAAE;IACtE,WAAW,EAAE,4DAA4D;CAC1E,CAAC,CAAC;AAEU,QAAA,wBAAwB,GAAG,KAAK,CAAC,eAAe,CAAC,yBAAyB,EAAE;IACvF,WAAW,EAAE,8CAA8C;IAC3D,IAAI,EAAE,IAAI;CACX,CAAC,CAAC;AAEH,SAAgB,oBAAoB,CAAC,KAA0B;IAC7D,wBAAgB,CAAC,GAAG,CAAC,CAAC,EAAE;QACtB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAC,CAAC;AACL,CAAC;AAED,SAAgB,2BAA2B,CACzC,UAAkB,EAClB,KAAiC;IAEjC,gCAAwB,CAAC,MAAM,CAAC,UAAU,EAAE;QAC1C,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS;KACrE,CAAC,CAAC;AACL,CAAC"}

package/dist/observability/error-observability.d.ts

@@ -0,0 +1,32 @@
+export type AppErrorSeverity = 'info' | 'warn' | 'error';
+export type AppErrorLogPayload = {
+    service: string;
+    transport: 'http' | 'grpc' | 'rabbitmq' | 'system';
+    errorKey: string;
+    messageKey?: string;
+    category?: string;
+    retryable?: boolean;
+    httpCode?: number;
+    grpcCode?: number;
+    requestId?: string;
+    userId?: string;
+    accountId?: string;
+    email?: string;
+    details?: Record<string, unknown>;
+    fields?: Array<{
+        field?: string;
+        code?: string;
+        message?: string;
+    }>;
+    timestamp?: string;
+};
+export declare function resolveErrorSeverity(payload: AppErrorLogPayload): AppErrorSeverity;
+export declare function emitAppErrorObservability(payload: AppErrorLogPayload, options?: {
+    logger?: {
+        error?: (payload: unknown, message?: string) => void;
+        warn?: (payload: unknown, message?: string) => void;
+        info?: (payload: unknown, message?: string) => void;
+        log?: (payload: unknown, message?: string) => void;
+    };
+    severity?: AppErrorSeverity;
+}): AppErrorSeverity;

package/dist/observability/error-observability.js

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveErrorSeverity = resolveErrorSeverity;
+exports.emitAppErrorObservability = emitAppErrorObservability;
+const api_1 = require("@opentelemetry/api");
+const meter = api_1.metrics.getMeter('xssrv-shared-observability');
+const appErrorLogCounter = meter.createCounter('app_error_log_total', {
+    description: 'Application error logs grouped by severity and error identity.',
+});
+function normalizeHttpCode(httpCode) {
+    if (typeof httpCode !== 'number' || Number.isNaN(httpCode)) {
+        return 'unknown';
+    }
+    return String(httpCode);
+}
+function readString(input) {
+    if (typeof input !== 'string') {
+        return undefined;
+    }
+    const value = input.trim();
+    return value.length > 0 ? value : undefined;
+}
+function firstValidationField(fields) {
+    if (!Array.isArray(fields) || fields.length === 0) {
+        return undefined;
+    }
+    const first = fields[0];
+    if (!first) {
+        return undefined;
+    }
+    return {
+        field: readString(first.field),
+        code: readString(first.code),
+        message: readString(first.message),
+    };
+}
+function firstDetailsValidation(details) {
+    const validationErrors = details
+        ?.validationErrors;
+    if (!Array.isArray(validationErrors) || validationErrors.length === 0) {
+        return undefined;
+    }
+    const first = validationErrors[0];
+    if (!first) {
+        return undefined;
+    }
+    const field = readString(first.property);
+    const constraints = first.constraints;
+    const constraintKey = constraints ? Object.keys(constraints)[0] : undefined;
+    const rule = readString(constraintKey);
+    const message = constraints && constraintKey ? readString(constraints[constraintKey]) : undefined;
+    return { field, rule, message };
+}
+function resolveErrorSeverity(payload) {
+    const category = payload.category?.toUpperCase();
+    const httpCode = payload.httpCode;
+    const grpcCode = payload.grpcCode;
+    if (httpCode === 503 || httpCode === 504) {
+        return 'warn';
+    }
+    if (typeof httpCode === 'number' && httpCode >= 500) {
+        return 'error';
+    }
+    if (grpcCode === 14 || grpcCode === 4) {
+        return 'warn';
+    }
+    if (grpcCode === 13 || grpcCode === 2 || grpcCode === 15) {
+        return 'error';
+    }
+    if (category === 'UNAVAILABLE' || category === 'TIMEOUT' || category === 'DEPENDENCY') {
+        return 'warn';
+    }
+    if (category === 'INTERNAL') {
+        return 'error';
+    }
+    return 'info';
+}
+function emitAppErrorObservability(payload, options) {
+    const severity = options?.severity ?? resolveErrorSeverity(payload);
+    const details = payload.details ?? {};
+    const validationField = firstValidationField(payload.fields);
+    const detailsValidation = firstDetailsValidation(details);
+    const source = details;
+    const targetService = readString(source.unavailableService) ??
+        readString(source.dependency) ??
+        readString(source.source);
+    const operation = readString(source.operation);
+    appErrorLogCounter.add(1, {
+        service: payload.service,
+        level: severity,
+        error_key: payload.errorKey,
+        category: payload.category ?? 'UNKNOWN',
+        transport: payload.transport,
+        http_code: normalizeHttpCode(payload.httpCode),
+    });
+    const logPayload = {
+        event: 'app_error',
+        level: severity,
+        service: payload.service,
+        sourceService: payload.service,
+        targetService,
+        operation,
+        transport: payload.transport,
+        errorKey: payload.errorKey,
+        messageKey: payload.messageKey,
+        category: payload.category,
+        retryable: payload.retryable,
+        status: {
+            http: payload.httpCode,
+            grpc: payload.grpcCode,
+        },
+        validation: validationField || detailsValidation
+            ? {
+                field: validationField?.field ?? detailsValidation?.field,
+                code: validationField?.code,
+                rule: detailsValidation?.rule,
+                message: validationField?.message ?? detailsValidation?.message,
+            }
+            : undefined,
+        user: {
+            userId: payload.userId,
+            accountId: payload.accountId,
+            email: payload.email,
+        },
+        requestId: payload.requestId,
+        details: payload.details,
+        timestamp: payload.timestamp ?? new Date().toISOString(),
+    };
+    const logger = options?.logger;
+    if (severity === 'error') {
+        logger?.error?.(logPayload, 'Application error observed');
+    }
+    else if (severity === 'warn') {
+        logger?.warn?.(logPayload, 'Application warning observed');
+    }
+    else {
+        if (logger?.info) {
+            logger.info(logPayload, 'Application info observed');
+        }
+        else {
+            logger?.log?.(logPayload, 'Application info observed');
+        }
+    }
+    return severity;
+}
+//# sourceMappingURL=error-observability.js.map

package/dist/observability/error-observability.js.map

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

package/dist/observability/otel-log-emitter.d.ts

@@ -0,0 +1,10 @@
+type OTelSeverity = 'info' | 'warn' | 'error' | 'fatal';
+type OTelLogInput = {
+    service: string;
+    severity: OTelSeverity;
+    message: string;
+    attributes?: Record<string, unknown>;
+    body?: Record<string, unknown>;
+};
+export declare function emitOtelLog(input: OTelLogInput): void;
+export {};

package/dist/observability/otel-log-emitter.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emitOtelLog = emitOtelLog;
+let cachedLogger;
+function toSeverityNumber(level) {
+    switch (level) {
+        case 'fatal':
+            return 21;
+        case 'error':
+            return 17;
+        case 'warn':
+            return 13;
+        default:
+            return 9;
+    }
+}
+function getLogger() {
+    if (cachedLogger !== undefined) {
+        return cachedLogger;
+    }
+    try {
+        const apiLogs = require('@opentelemetry/api-logs');
+        cachedLogger = apiLogs.logs.getLogger('xenonsmart-backend');
+    }
+    catch {
+        cachedLogger = null;
+    }
+    return cachedLogger;
+}
+function emitOtelLog(input) {
+    const logger = getLogger();
+    if (!logger) {
+        return;
+    }
+    const severityText = input.severity.toUpperCase();
+    logger.emit({
+        severityNumber: toSeverityNumber(input.severity),
+        severityText,
+        body: input.body ?? { message: input.message },
+        attributes: {
+            service: input.service,
+            severity: input.severity,
+            ...input.attributes,
+        },
+    });
+}
+//# sourceMappingURL=otel-log-emitter.js.map

package/dist/observability/otel-log-emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel-log-emitter.js","sourceRoot":"","sources":["../../src/observability/otel-log-emitter.ts"],"names":[],"mappings":";;AAmDA,kCAkBC;AAlDD,IAAI,YAA+C,CAAC;AAEpD,SAAS,gBAAgB,CAAC,KAAmB;IAC3C,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,OAAO;YACV,OAAO,EAAE,CAAC;QACZ,KAAK,OAAO;YACV,OAAO,EAAE,CAAC;QACZ,KAAK,MAAM;YACT,OAAO,EAAE,CAAC;QACZ;YACE,OAAO,CAAC,CAAC;IACb,CAAC;AACH,CAAC;AAED,SAAS,SAAS;IAChB,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,OAAO,CAAC,yBAAyB,CAEhD,CAAC;QACF,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,YAAY,GAAG,IAAI,CAAC;IACtB,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,SAAgB,WAAW,CAAC,KAAmB;IAC7C,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;IACT,CAAC;IAED,MAAM,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IAElD,MAAM,CAAC,IAAI,CAAC;QACV,cAAc,EAAE,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC;QAChD,YAAY;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE;QAC9C,UAAU,EAAE;YACV,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,GAAG,KAAK,CAAC,UAAU;SACpB;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/observability/request-context.d.ts

@@ -0,0 +1,12 @@
+import { createHttpObservabilityContext, type ObservabilityContextData as BaseObservabilityContextData } from '../context/observability-context';
+export interface ObservabilityContextData extends BaseObservabilityContextData {
+    email?: string;
+    source?: BaseObservabilityContextData['origin'];
+}
+export declare class ObservabilityContextStorage {
+    static run<T>(context: ObservabilityContextData, callback: () => T): T;
+    static get(): ObservabilityContextData | undefined;
+    static patch(input: Partial<ObservabilityContextData>): void;
+    static toLogMeta(): Record<string, string | undefined>;
+}
+export { createHttpObservabilityContext };

package/dist/observability/request-context.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createHttpObservabilityContext = exports.ObservabilityContextStorage = void 0;
+const observability_context_1 = require("../context/observability-context");
+Object.defineProperty(exports, "createHttpObservabilityContext", { enumerable: true, get: function () { return observability_context_1.createHttpObservabilityContext; } });
+class ObservabilityContextStorage {
+    static run(context, callback) {
+        return observability_context_1.ObservabilityContext.run({
+            ...context,
+            userEmail: context.userEmail ?? context.email,
+            origin: context.origin ?? context.source,
+        }, callback);
+    }
+    static get() {
+        const current = observability_context_1.ObservabilityContext.get();
+        if (!current) {
+            return undefined;
+        }
+        return {
+            ...current,
+            email: current.userEmail,
+            source: current.origin,
+        };
+    }
+    static patch(input) {
+        observability_context_1.ObservabilityContext.set({
+            ...input,
+            userEmail: input.userEmail ?? input.email,
+            origin: input.origin ?? input.source,
+        });
+    }
+    static toLogMeta() {
+        const context = ObservabilityContextStorage.get();
+        return {
+            requestId: context?.requestId,
+            correlationId: context?.correlationId,
+            tenantId: context?.tenantId,
+            userId: context?.userId,
+            accountId: context?.accountId,
+            email: context?.email,
+            source: context?.source,
+            operation: context?.operation,
+            traceId: context?.traceId,
+            spanId: context?.spanId,
+        };
+    }
+}
+exports.ObservabilityContextStorage = ObservabilityContextStorage;
+//# sourceMappingURL=request-context.js.map

package/dist/observability/request-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.js","sourceRoot":"","sources":["../../src/observability/request-context.ts"],"names":[],"mappings":";;;AAAA,4EAI0C;AAwDjC,+GA3DP,sDAA8B,OA2DO;AAjDvC,MAAa,2BAA2B;IACtC,MAAM,CAAC,GAAG,CAAI,OAAiC,EAAE,QAAiB;QAChE,OAAO,4CAAoB,CAAC,GAAG,CAC7B;YACE,GAAG,OAAO;YACV,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,KAAK;YAC7C,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM;SACzC,EACD,QAAQ,CACT,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,GAAG;QACR,MAAM,OAAO,GAAG,4CAAoB,CAAC,GAAG,EAAE,CAAC;QAC3C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO;YACL,GAAG,OAAO;YACV,KAAK,EAAE,OAAO,CAAC,SAAS;YACxB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,KAAwC;QACnD,4CAAoB,CAAC,GAAG,CAAC;YACvB,GAAG,KAAK;YACR,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,KAAK;YACzC,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM;SACrC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,SAAS;QACd,MAAM,OAAO,GAAG,2BAA2B,CAAC,GAAG,EAAE,CAAC;QAClD,OAAO;YACL,SAAS,EAAE,OAAO,EAAE,SAAS;YAC7B,aAAa,EAAE,OAAO,EAAE,aAAa;YACrC,QAAQ,EAAE,OAAO,EAAE,QAAQ;YAC3B,MAAM,EAAE,OAAO,EAAE,MAAM;YACvB,SAAS,EAAE,OAAO,EAAE,SAAS;YAC7B,KAAK,EAAE,OAAO,EAAE,KAAK;YACrB,MAAM,EAAE,OAAO,EAAE,MAAM;YACvB,SAAS,EAAE,OAAO,EAAE,SAAS;YAC7B,OAAO,EAAE,OAAO,EAAE,OAAO;YACzB,MAAM,EAAE,OAAO,EAAE,MAAM;SACxB,CAAC;IACJ,CAAC;CACF;AA/CD,kEA+CC"}

package/dist/tracing/tracing.js

@@ -28,6 +28,24 @@ const metricReader = new sdk_metrics_1.PeriodicExportingMetricReader({
     exporter: new exporter_metrics_otlp_grpc_1.OTLPMetricExporter({ url: otelEndpoint }),
     exportIntervalMillis: 15000,
 });
+let logProvider = null;
+function setupOtelLogs() {
+    try {
+        const sdkLogs = require('@opentelemetry/sdk-logs');
+        const exporterLogs = require('@opentelemetry/exporter-logs-otlp-grpc');
+        const apiLogs = require('@opentelemetry/api-logs');
+        const provider = new sdkLogs.LoggerProvider({ resource });
+        const exporter = new exporterLogs.OTLPLogExporter({ url: otelEndpoint });
+        provider.addLogRecordProcessor(new sdkLogs.BatchLogRecordProcessor(exporter));
+        apiLogs.logs.setGlobalLoggerProvider(provider);
+        logProvider = provider;
+    }
+    catch (error) {
+        if (process.env.OTEL_DEBUG === 'true') {
+            console.warn('OpenTelemetry logs SDK is not available. Install @opentelemetry/sdk-logs, @opentelemetry/api-logs and @opentelemetry/exporter-logs-otlp-grpc.', error);
+        }
+    }
+}
 const sdk = new sdk_node_1.NodeSDK({
     resource,
     traceExporter,
@@ -46,10 +64,14 @@ const sdk = new sdk_node_1.NodeSDK({
     ],
 });
 exports.sdk = sdk;
+setupOtelLogs();
 sdk.start();
 const shutdown = async () => {
     try {
         await sdk.shutdown();
+        if (logProvider) {
+            await logProvider.shutdown();
+        }
         console.log('OpenTelemetry SDK shut down successfully');
     }
     catch (err) {