@zola_do/observability 0.3.1

package/README.md

@@ -0,0 +1,94 @@
+# @zola_do/observability
+
+NestJS observability helpers for request correlation, OpenTelemetry trace IDs, and optional telemetry SDK bootstrap.
+
+## Installation
+
+```bash
+npm i @zola_do/observability
+```
+
+Install OpenTelemetry packages in the consuming application when telemetry export is needed.
+
+For **HTTP/protobuf** OTLP (port `4318`):
+
+```bash
+npm i @opentelemetry/api @opentelemetry/api-logs @opentelemetry/sdk-node @opentelemetry/sdk-logs @opentelemetry/exporter-trace-otlp-http @opentelemetry/exporter-metrics-otlp-http @opentelemetry/exporter-logs-otlp-http @opentelemetry/instrumentation-http @opentelemetry/instrumentation-nestjs-core @opentelemetry/instrumentation-pg @opentelemetry/resources @opentelemetry/semantic-conventions @opentelemetry/sdk-metrics
+```
+
+For **gRPC** OTLP (port `4317`):
+
+```bash
+npm i @opentelemetry/api @opentelemetry/sdk-node @opentelemetry/exporter-trace-otlp-grpc @opentelemetry/exporter-metrics-otlp-grpc @opentelemetry/instrumentation-http @opentelemetry/instrumentation-nestjs-core @opentelemetry/resources @opentelemetry/semantic-conventions @opentelemetry/sdk-metrics
+```
+
+## Request correlation
+
+```typescript
+import { Module } from '@nestjs/common';
+import { ZolaObservabilityModule } from '@zola_do/observability';
+
+@Module({
+  imports: [
+    ZolaObservabilityModule.forRoot({
+      serviceName: 'orders-api',
+      environment: process.env.NODE_ENV,
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+The module registers a global interceptor that:
+
+- forwards or creates `x-request-id`
+- forwards or creates `x-correlation-id`
+- attaches `request.requestId` and `request.correlationId`
+- echoes the headers on the response
+- adds `trace-id` and `span-id` response headers when an active OpenTelemetry span exists
+
+## OpenTelemetry bootstrap
+
+Call SDK startup before creating the Nest app (for example in `instrumentation.ts` imported before `NestFactory.create`).
+
+```typescript
+import {
+  resolveOtlpProtocol,
+  startZolaOpenTelemetry,
+} from '@zola_do/observability';
+
+startZolaOpenTelemetry({
+  serviceName: 'orders-api',
+  otlpEndpoint: process.env.OTEL_EXPORTER_OTLP_ENDPOINT,
+  otlpProtocol: resolveOtlpProtocol(process.env.OTEL_EXPORTER_OTLP_PROTOCOL),
+});
+```
+
+Environment variables:
+
+- `OTEL_EXPORTER_OTLP_ENDPOINT` — base OTLP URL (for example `http://collector:4318`; HTTP/protobuf signal paths such as `/v1/traces` are appended automatically)
+- `OTEL_EXPORTER_OTLP_PROTOCOL` — `http/protobuf` or `grpc` (defaults to `http/protobuf` when the endpoint uses port `4318`)
+- `OTEL_LOGS_EXPORTER` — set to `otlp` to export Nest/request logs to `/v1/logs`
+
+## Trace-aware Nest logger
+
+```typescript
+import { NestFactory } from '@nestjs/core';
+import { ZolaOtelLogger } from '@zola_do/observability';
+
+const app = await NestFactory.create(AppModule, {
+  logger: new ZolaOtelLogger(),
+});
+```
+
+Enable per-request OTLP logs (includes `trace_id` / `span_id`) via `ZolaObservabilityModule.forRoot({ logRequests: true })`.
+
+Use `getTraceLogFields()` to enrich custom structured logs:
+
+```typescript
+import { getTraceLogFields } from '@zola_do/observability';
+
+logger.log({ ...getTraceLogFields(), message: 'Order created' });
+```
+
+All OpenTelemetry packages are optional peers. Applications that do not install an SDK can still use request correlation safely.

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from './observability.constants';
+export * from './observability-options';
+export * from './observability.module';
+export * from './otel-log.helper';
+export * from './otel-sdk.helper';
+export * from './request-correlation.interceptor';
+export * from './trace-context.helper';
+export * from './zola-otel.logger';
+export * from './zola-request-logging.middleware';

package/dist/index.js

@@ -0,0 +1,26 @@
+"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("./observability.constants"), exports);
+__exportStar(require("./observability-options"), exports);
+__exportStar(require("./observability.module"), exports);
+__exportStar(require("./otel-log.helper"), exports);
+__exportStar(require("./otel-sdk.helper"), exports);
+__exportStar(require("./request-correlation.interceptor"), exports);
+__exportStar(require("./trace-context.helper"), exports);
+__exportStar(require("./zola-otel.logger"), exports);
+__exportStar(require("./zola-request-logging.middleware"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4DAA0C;AAC1C,0DAAwC;AACxC,yDAAuC;AACvC,oDAAkC;AAClC,oDAAkC;AAClC,oEAAkD;AAClD,yDAAuC;AACvC,qDAAmC;AACnC,oEAAkD"}

package/dist/observability-options.d.ts

@@ -0,0 +1,31 @@
+export interface ZolaObservabilityOptions {
+    serviceName?: string;
+    serviceVersion?: string;
+    environment?: string;
+    enabled?: boolean;
+    requestIdHeader?: string;
+    correlationIdHeader?: string;
+    exposeTraceHeaders?: boolean;
+    logRequests?: boolean;
+}
+export type ZolaOtlpProtocol = 'grpc' | 'http/protobuf';
+export interface ZolaOpenTelemetrySdkOptions extends ZolaObservabilityOptions {
+    otlpEndpoint?: string;
+    otlpProtocol?: ZolaOtlpProtocol | 'HttpProtobuf';
+    tracesEndpoint?: string;
+    metricsEndpoint?: string;
+    logsEndpoint?: string;
+    enableMetrics?: boolean;
+    enableLogs?: boolean;
+    enableHttpInstrumentation?: boolean;
+    enableNestInstrumentation?: boolean;
+    enablePgInstrumentation?: boolean;
+    enableAutoInstrumentations?: boolean;
+    instrumentations?: unknown[];
+    resourceAttributes?: Record<string, string | number | boolean>;
+}
+export interface ZolaTraceIds {
+    traceId?: string;
+    spanId?: string;
+    traceFlags?: number;
+}

package/dist/observability-options.js

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

package/dist/observability-options.js.map

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

package/dist/observability.constants.d.ts

@@ -0,0 +1,3 @@
+export declare const ZOLA_OBSERVABILITY_OPTIONS: unique symbol;
+export declare const DEFAULT_REQUEST_ID_HEADER = "x-request-id";
+export declare const DEFAULT_CORRELATION_ID_HEADER = "x-correlation-id";

package/dist/observability.constants.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CORRELATION_ID_HEADER = exports.DEFAULT_REQUEST_ID_HEADER = exports.ZOLA_OBSERVABILITY_OPTIONS = void 0;
+exports.ZOLA_OBSERVABILITY_OPTIONS = Symbol('ZOLA_OBSERVABILITY_OPTIONS');
+exports.DEFAULT_REQUEST_ID_HEADER = 'x-request-id';
+exports.DEFAULT_CORRELATION_ID_HEADER = 'x-correlation-id';
+//# sourceMappingURL=observability.constants.js.map

package/dist/observability.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.constants.js","sourceRoot":"","sources":["../src/observability.constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,0BAA0B,GAAG,MAAM,CAAC,4BAA4B,CAAC,CAAC;AAClE,QAAA,yBAAyB,GAAG,cAAc,CAAC;AAC3C,QAAA,6BAA6B,GAAG,kBAAkB,CAAC"}

package/dist/observability.module.d.ts

@@ -0,0 +1,6 @@
+import { DynamicModule, MiddlewareConsumer, NestModule } from '@nestjs/common';
+import { ZolaObservabilityOptions } from './observability-options';
+export declare class ZolaObservabilityModule implements NestModule {
+    static forRoot(options?: ZolaObservabilityOptions): DynamicModule;
+    configure(consumer: MiddlewareConsumer): void;
+}

package/dist/observability.module.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 ZolaObservabilityModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZolaObservabilityModule = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const observability_constants_1 = require("./observability.constants");
+const request_correlation_interceptor_1 = require("./request-correlation.interceptor");
+const zola_request_logging_middleware_1 = require("./zola-request-logging.middleware");
+let ZolaObservabilityModule = ZolaObservabilityModule_1 = class ZolaObservabilityModule {
+    static forRoot(options = {}) {
+        const enabled = options.enabled !== false;
+        return {
+            module: ZolaObservabilityModule_1,
+            providers: [
+                {
+                    provide: observability_constants_1.ZOLA_OBSERVABILITY_OPTIONS,
+                    useValue: options,
+                },
+                request_correlation_interceptor_1.ZolaRequestCorrelationInterceptor,
+                zola_request_logging_middleware_1.ZolaRequestLoggingMiddleware,
+                ...(enabled
+                    ? [
+                        {
+                            provide: core_1.APP_INTERCEPTOR,
+                            useExisting: request_correlation_interceptor_1.ZolaRequestCorrelationInterceptor,
+                        },
+                    ]
+                    : []),
+            ],
+            exports: [
+                observability_constants_1.ZOLA_OBSERVABILITY_OPTIONS,
+                request_correlation_interceptor_1.ZolaRequestCorrelationInterceptor,
+                zola_request_logging_middleware_1.ZolaRequestLoggingMiddleware,
+            ],
+        };
+    }
+    configure(consumer) {
+        consumer.apply(zola_request_logging_middleware_1.ZolaRequestLoggingMiddleware).forRoutes('*');
+    }
+};
+exports.ZolaObservabilityModule = ZolaObservabilityModule;
+exports.ZolaObservabilityModule = ZolaObservabilityModule = ZolaObservabilityModule_1 = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({})
+], ZolaObservabilityModule);
+//# sourceMappingURL=observability.module.js.map

package/dist/observability.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.module.js","sourceRoot":"","sources":["../src/observability.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAA+F;AAC/F,uCAA+C;AAE/C,uEAAuE;AAEvE,uFAAsF;AACtF,uFAAiF;AAI1E,IAAM,uBAAuB,+BAA7B,MAAM,uBAAuB;IAC3B,AAAP,MAAM,CAAC,OAAO,CAAC,OAAO,GAA6B,EAAE;QACnD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,KAAK,KAAK,CAAC;QAE1C,OAAO;YACL,MAAM,2BAAyB;YAC/B,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,oDAA0B;oBACnC,QAAQ,EAAE,OAAO;iBAClB;gBACD,mEAAiC;gBACjC,8DAA4B;gBAC5B,GAAG,CAAC,OAAO;oBACT,CAAC,CAAC;wBACE;4BACE,OAAO,EAAE,sBAAe;4BACxB,WAAW,EAAE,mEAAiC;yBAC/C;qBACF;oBACH,CAAC,CAAC,EAAE,CAAC;aACR;YACD,OAAO,EAAE;gBACP,oDAA0B;gBAC1B,mEAAiC;gBACjC,8DAA4B;aAC7B;SACF,CAAC;IACJ,CAAC;IAED,SAAS,CAAC,QAA4B;QACpC,QAAQ,CAAC,KAAK,CAAC,8DAA4B,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC9D,CAAC;CACF,CAAA;;kCAjCY,uBAAuB;IAFnC,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,uBAAuB,CAiCnC"}

package/dist/otel-log.helper.d.ts

@@ -0,0 +1,16 @@
+import { ZolaTraceIds } from './observability-options';
+export interface ZolaOtelLogInput {
+    severityNumber: number;
+    severityText: string;
+    body: string;
+    context?: string;
+    attributes?: Record<string, string | number | boolean>;
+    traceIds?: ZolaTraceIds;
+}
+export declare function emitOtelLog(input: ZolaOtelLogInput): void;
+export declare function emitExceptionLog(payload: Record<string, unknown>): void;
+export declare function emitHttpRequestLog(request: {
+    method?: string;
+    originalUrl?: string;
+    url?: string;
+}, statusCode?: number, traceIds?: ZolaTraceIds): void;

package/dist/otel-log.helper.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emitOtelLog = emitOtelLog;
+exports.emitExceptionLog = emitExceptionLog;
+exports.emitHttpRequestLog = emitHttpRequestLog;
+const trace_context_helper_1 = require("./trace-context.helper");
+function emitOtelLog(input) {
+    var _a, _b;
+    try {
+        const { logs, SeverityNumber } = require('@opentelemetry/api-logs');
+        const traceIds = (_a = input.traceIds) !== null && _a !== void 0 ? _a : (0, trace_context_helper_1.getActiveTraceIds)();
+        const logger = logs.getLogger(input.context || 'nestjs');
+        logger.emit(Object.assign({ severityNumber: (_b = input.severityNumber) !== null && _b !== void 0 ? _b : SeverityNumber.INFO, severityText: input.severityText, body: input.body, attributes: Object.assign(Object.assign(Object.assign(Object.assign({}, (input.context ? { 'log.context': input.context } : {})), (traceIds.traceId ? { trace_id: traceIds.traceId } : {})), (traceIds.spanId ? { span_id: traceIds.spanId } : {})), input.attributes) }, (traceIds.traceId
+            ? {
+                traceId: traceIds.traceId,
+                spanId: traceIds.spanId,
+                traceFlags: traceIds.traceFlags,
+            }
+            : {})));
+    }
+    catch (_c) {
+    }
+}
+function emitExceptionLog(payload) {
+    const statusCode = Number(payload.statusCode) || 500;
+    const severity = statusCode >= 500
+        ? { severityNumber: 17, severityText: 'ERROR' }
+        : { severityNumber: 13, severityText: 'WARN' };
+    emitOtelLog(Object.assign(Object.assign({}, severity), { body: JSON.stringify(payload), context: 'GlobalExceptionFilter', attributes: Object.assign(Object.assign(Object.assign({ 'http.status_code': statusCode }, (payload.path ? { 'http.target': String(payload.path) } : {})), (payload.exceptionMessage
+            ? { exception_message: String(payload.exceptionMessage) }
+            : {})), (payload.name ? { exception_name: String(payload.name) } : {})) }));
+}
+function emitHttpRequestLog(request, statusCode, traceIds) {
+    const method = request.method || 'GET';
+    const target = request.originalUrl || request.url || '/';
+    const code = statusCode !== null && statusCode !== void 0 ? statusCode : 0;
+    const severity = code >= 500
+        ? { severityNumber: 17, severityText: 'ERROR' }
+        : code >= 400
+            ? { severityNumber: 13, severityText: 'WARN' }
+            : { severityNumber: 9, severityText: 'INFO' };
+    emitOtelLog(Object.assign(Object.assign({}, severity), { body: `${method} ${target} ${code}`, context: 'http', traceIds, attributes: {
+            'http.method': method,
+            'http.target': target,
+            'http.status_code': code,
+        } }));
+}
+//# sourceMappingURL=otel-log.helper.js.map

package/dist/otel-log.helper.js.map

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

package/dist/otel-sdk.helper.d.ts

@@ -0,0 +1,5 @@
+import { ZolaOpenTelemetrySdkOptions, ZolaOtlpProtocol } from './observability-options';
+export declare function resolveOtlpProtocol(value?: string, endpoint?: string): ZolaOtlpProtocol;
+export declare function createZolaOpenTelemetrySdk(options?: ZolaOpenTelemetrySdkOptions): unknown;
+export declare function startZolaOpenTelemetry(options?: ZolaOpenTelemetrySdkOptions): unknown;
+export declare function resolveOtlpHttpSignalUrl(url: string | undefined, signal: 'traces' | 'metrics' | 'logs'): string | undefined;

package/dist/otel-sdk.helper.js

@@ -0,0 +1,177 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveOtlpProtocol = resolveOtlpProtocol;
+exports.createZolaOpenTelemetrySdk = createZolaOpenTelemetrySdk;
+exports.startZolaOpenTelemetry = startZolaOpenTelemetry;
+exports.resolveOtlpHttpSignalUrl = resolveOtlpHttpSignalUrl;
+function resolveOtlpProtocol(value, endpoint) {
+    const normalized = (value || process.env.OTEL_EXPORTER_OTLP_PROTOCOL || '')
+        .trim()
+        .toLowerCase();
+    if (normalized === 'http/protobuf' ||
+        normalized === 'http_protobuf' ||
+        normalized === 'httpprotobuf') {
+        return 'http/protobuf';
+    }
+    if (normalized === 'grpc') {
+        return 'grpc';
+    }
+    const resolvedEndpoint = endpoint ||
+        process.env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT ||
+        process.env.OTEL_EXPORTER_OTLP_ENDPOINT ||
+        '';
+    if (/:4318(?:\/|$)/.test(resolvedEndpoint)) {
+        return 'http/protobuf';
+    }
+    return 'grpc';
+}
+function createZolaOpenTelemetrySdk(options = {}) {
+    if (options.enabled === false) {
+        return undefined;
+    }
+    const { NodeSDK } = require('@opentelemetry/sdk-node');
+    const resources = require('@opentelemetry/resources');
+    const semanticConventions = require('@opentelemetry/semantic-conventions');
+    const otlpEndpoint = options.otlpEndpoint || process.env.OTEL_EXPORTER_OTLP_ENDPOINT;
+    const otlpProtocol = resolveOtlpProtocol(options.otlpProtocol === 'HttpProtobuf'
+        ? 'http/protobuf'
+        : options.otlpProtocol, otlpEndpoint);
+    const resourceAttributes = Object.assign({ [semanticConventions.ATTR_SERVICE_NAME || 'service.name']: options.serviceName ||
+            process.env.OTEL_SERVICE_NAME ||
+            process.env.APPLICATION_NAME ||
+            process.env.APP_NAME ||
+            'nestjs-app', [semanticConventions.ATTR_SERVICE_VERSION || 'service.version']: options.serviceVersion ||
+            process.env.OTEL_SERVICE_VERSION ||
+            process.env.npm_package_version ||
+            'unknown', [semanticConventions.ATTR_DEPLOYMENT_ENVIRONMENT_NAME ||
+            'deployment.environment.name']: options.environment || process.env.NODE_ENV || 'development' }, options.resourceAttributes);
+    const tracesUrl = options.tracesEndpoint ||
+        options.otlpEndpoint ||
+        process.env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT ||
+        process.env.OTEL_EXPORTER_OTLP_ENDPOINT;
+    const sdkOptions = {
+        resource: createResource(resources, resourceAttributes),
+        traceExporter: createTraceExporter(otlpProtocol, tracesUrl),
+        instrumentations: buildInstrumentations(options),
+    };
+    if (options.enableMetrics !== false) {
+        const { PeriodicExportingMetricReader, } = require('@opentelemetry/sdk-metrics');
+        const metricsUrl = options.metricsEndpoint ||
+            options.otlpEndpoint ||
+            process.env.OTEL_EXPORTER_OTLP_METRICS_ENDPOINT ||
+            process.env.OTEL_EXPORTER_OTLP_ENDPOINT;
+        sdkOptions.metricReader = new PeriodicExportingMetricReader({
+            exporter: createMetricExporter(otlpProtocol, metricsUrl),
+        });
+    }
+    if (shouldEnableLogs(options)) {
+        const { BatchLogRecordProcessor } = require('@opentelemetry/sdk-logs');
+        const logsUrl = options.logsEndpoint ||
+            options.otlpEndpoint ||
+            process.env.OTEL_EXPORTER_OTLP_LOGS_ENDPOINT ||
+            process.env.OTEL_EXPORTER_OTLP_ENDPOINT;
+        sdkOptions.logRecordProcessors = [
+            new BatchLogRecordProcessor({
+                exporter: createLogExporter(otlpProtocol, logsUrl),
+            }),
+        ];
+    }
+    return new NodeSDK(sdkOptions);
+}
+function shouldEnableLogs(options) {
+    if (options.enableLogs === false) {
+        return false;
+    }
+    const exporter = (process.env.OTEL_LOGS_EXPORTER || '').trim().toLowerCase();
+    if (exporter === 'none' || exporter === 'false') {
+        return false;
+    }
+    if (options.enableLogs === true || exporter === 'otlp') {
+        return true;
+    }
+    return !!(options.logsEndpoint ||
+        options.otlpEndpoint ||
+        process.env.OTEL_EXPORTER_OTLP_LOGS_ENDPOINT ||
+        process.env.OTEL_EXPORTER_OTLP_ENDPOINT);
+}
+function startZolaOpenTelemetry(options = {}) {
+    const sdk = createZolaOpenTelemetrySdk(options);
+    if (sdk === null || sdk === void 0 ? void 0 : sdk.start) {
+        sdk.start();
+    }
+    return sdk;
+}
+function createTraceExporter(protocol, url) {
+    if (protocol === 'http/protobuf') {
+        const { OTLPTraceExporter, } = require('@opentelemetry/exporter-trace-otlp-http');
+        return new OTLPTraceExporter({
+            url: resolveOtlpHttpSignalUrl(url, 'traces'),
+        });
+    }
+    const { OTLPTraceExporter, } = require('@opentelemetry/exporter-trace-otlp-grpc');
+    return new OTLPTraceExporter({ url });
+}
+function createMetricExporter(protocol, url) {
+    if (protocol === 'http/protobuf') {
+        const { OTLPMetricExporter, } = require('@opentelemetry/exporter-metrics-otlp-http');
+        return new OTLPMetricExporter({
+            url: resolveOtlpHttpSignalUrl(url, 'metrics'),
+        });
+    }
+    const { OTLPMetricExporter, } = require('@opentelemetry/exporter-metrics-otlp-grpc');
+    return new OTLPMetricExporter({ url });
+}
+function createLogExporter(protocol, url) {
+    if (protocol === 'http/protobuf') {
+        const { OTLPLogExporter } = require('@opentelemetry/exporter-logs-otlp-http');
+        return new OTLPLogExporter({
+            url: resolveOtlpHttpSignalUrl(url, 'logs'),
+        });
+    }
+    const { OTLPLogExporter } = require('@opentelemetry/exporter-logs-otlp-grpc');
+    return new OTLPLogExporter({ url });
+}
+function resolveOtlpHttpSignalUrl(url, signal) {
+    if (!url) {
+        return undefined;
+    }
+    const normalized = url.replace(/\/+$/, '');
+    if (normalized.endsWith(`/v1/${signal}`)) {
+        return normalized;
+    }
+    return `${normalized}/v1/${signal}`;
+}
+function createResource(resources, attributes) {
+    if (typeof resources.resourceFromAttributes === 'function') {
+        return resources.resourceFromAttributes(attributes);
+    }
+    return new resources.Resource(attributes);
+}
+function buildInstrumentations(options) {
+    const instrumentations = [...(options.instrumentations || [])];
+    if (options.enableAutoInstrumentations) {
+        const { getNodeAutoInstrumentations, } = require('@opentelemetry/auto-instrumentations-node');
+        instrumentations.push(getNodeAutoInstrumentations());
+        return instrumentations;
+    }
+    if (options.enableHttpInstrumentation !== false) {
+        const { HttpInstrumentation, } = require('@opentelemetry/instrumentation-http');
+        instrumentations.push(new HttpInstrumentation());
+    }
+    if (options.enableNestInstrumentation !== false) {
+        const { NestInstrumentation, } = require('@opentelemetry/instrumentation-nestjs-core');
+        instrumentations.push(new NestInstrumentation());
+    }
+    if (options.enablePgInstrumentation !== false) {
+        try {
+            const { PgInstrumentation } = require('@opentelemetry/instrumentation-pg');
+            instrumentations.push(new PgInstrumentation({
+                enhancedDatabaseReporting: true,
+            }));
+        }
+        catch (_a) {
+        }
+    }
+    return instrumentations;
+}
+//# sourceMappingURL=otel-sdk.helper.js.map

package/dist/otel-sdk.helper.js.map

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

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

@@ -0,0 +1,9 @@
+import { CallHandler, ExecutionContext, NestInterceptor } from '@nestjs/common';
+import { Observable } from 'rxjs';
+import { ZolaObservabilityOptions } from './observability-options';
+export declare class ZolaRequestCorrelationInterceptor implements NestInterceptor {
+    private readonly options;
+    constructor(options?: ZolaObservabilityOptions);
+    intercept(context: ExecutionContext, next: CallHandler): Observable<unknown>;
+    private setTraceHeaders;
+}

package/dist/request-correlation.interceptor.js

@@ -0,0 +1,76 @@
+"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.ZolaRequestCorrelationInterceptor = void 0;
+const common_1 = require("@nestjs/common");
+const crypto_1 = require("crypto");
+const operators_1 = require("rxjs/operators");
+const observability_constants_1 = require("./observability.constants");
+const trace_context_helper_1 = require("./trace-context.helper");
+let ZolaRequestCorrelationInterceptor = class ZolaRequestCorrelationInterceptor {
+    constructor(options = {}) {
+        this.options = options;
+    }
+    intercept(context, next) {
+        const http = context.switchToHttp();
+        const request = http.getRequest();
+        const response = http.getResponse();
+        if (!request || !response) {
+            return next.handle();
+        }
+        const requestIdHeader = normalizeHeaderName(this.options.requestIdHeader, observability_constants_1.DEFAULT_REQUEST_ID_HEADER);
+        const correlationIdHeader = normalizeHeaderName(this.options.correlationIdHeader, observability_constants_1.DEFAULT_CORRELATION_ID_HEADER);
+        const incomingRequestId = readHeader(request.headers, requestIdHeader);
+        const incomingCorrelationId = readHeader(request.headers, correlationIdHeader);
+        const requestId = incomingRequestId || (0, crypto_1.randomUUID)();
+        const correlationId = incomingCorrelationId || requestId;
+        request.requestId = requestId;
+        request.correlationId = correlationId;
+        response.setHeader(requestIdHeader, requestId);
+        response.setHeader(correlationIdHeader, correlationId);
+        return next.handle().pipe((0, operators_1.finalize)(() => {
+            this.setTraceHeaders(response);
+        }));
+    }
+    setTraceHeaders(response) {
+        if (this.options.exposeTraceHeaders === false || !response.setHeader) {
+            return;
+        }
+        const traceIds = (0, trace_context_helper_1.getActiveTraceIds)();
+        if (traceIds.traceId) {
+            response.setHeader('trace-id', traceIds.traceId);
+        }
+        if (traceIds.spanId) {
+            response.setHeader('span-id', traceIds.spanId);
+        }
+    }
+};
+exports.ZolaRequestCorrelationInterceptor = ZolaRequestCorrelationInterceptor;
+exports.ZolaRequestCorrelationInterceptor = ZolaRequestCorrelationInterceptor = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Optional)()),
+    __param(0, (0, common_1.Inject)(observability_constants_1.ZOLA_OBSERVABILITY_OPTIONS)),
+    __metadata("design:paramtypes", [Object])
+], ZolaRequestCorrelationInterceptor);
+function normalizeHeaderName(value, fallback) {
+    return (value || fallback).toLowerCase();
+}
+function readHeader(headers, name) {
+    const value = headers[name];
+    if (Array.isArray(value)) {
+        return value[0];
+    }
+    return value;
+}
+//# sourceMappingURL=request-correlation.interceptor.js.map

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

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

package/dist/trace-context.helper.d.ts

@@ -0,0 +1,3 @@
+import { ZolaTraceIds } from './observability-options';
+export declare function getActiveTraceIds(): ZolaTraceIds;
+export declare function getTraceLogFields(): Record<string, string>;

package/dist/trace-context.helper.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getActiveTraceIds = getActiveTraceIds;
+exports.getTraceLogFields = getTraceLogFields;
+function getActiveTraceIds() {
+    var _a;
+    try {
+        const api = require('@opentelemetry/api');
+        const span = api.trace.getActiveSpan();
+        const context = (_a = span === null || span === void 0 ? void 0 : span.spanContext) === null || _a === void 0 ? void 0 : _a.call(span);
+        if (!context) {
+            return {};
+        }
+        return {
+            traceId: context.traceId,
+            spanId: context.spanId,
+            traceFlags: context.traceFlags,
+        };
+    }
+    catch (_b) {
+        return {};
+    }
+}
+function getTraceLogFields() {
+    const traceIds = getActiveTraceIds();
+    const fields = {};
+    if (traceIds.traceId) {
+        fields.trace_id = traceIds.traceId;
+    }
+    if (traceIds.spanId) {
+        fields.span_id = traceIds.spanId;
+    }
+    return fields;
+}
+//# sourceMappingURL=trace-context.helper.js.map

package/dist/trace-context.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-context.helper.js","sourceRoot":"","sources":["../src/trace-context.helper.ts"],"names":[],"mappings":";;;;AAEA;;IACE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,WAAW,+CAAjB,IAAI,CAAiB,CAAC;QAEtC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,UAAU,EAAE,OAAO,CAAC,UAAU;SAC/B,CAAC;IACJ,CAAC;eAAO,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;IACE,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;IACrC,MAAM,MAAM,GAA2B,EAAE,CAAC;IAE1C,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC;IACrC,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,CAAC,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC;IACnC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/zola-otel.logger.d.ts

@@ -0,0 +1,14 @@
+import { LoggerService, LogLevel } from '@nestjs/common';
+export declare class ZolaOtelLogger implements LoggerService {
+    private readonly context?;
+    constructor(context?: string);
+    log(message: unknown, context?: string): void;
+    error(message: unknown, stack?: string, context?: string): void;
+    warn(message: unknown, context?: string): void;
+    debug(message: unknown, context?: string): void;
+    verbose(message: unknown, context?: string): void;
+    fatal(message: unknown, context?: string): void;
+    setLogLevels?(_levels: LogLevel[]): void;
+    private write;
+    private formatBody;
+}

package/dist/zola-otel.logger.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZolaOtelLogger = void 0;
+const otel_log_helper_1 = require("./otel-log.helper");
+const SEVERITY = {
+    INFO: { severityNumber: 9, severityText: 'INFO' },
+    ERROR: { severityNumber: 17, severityText: 'ERROR' },
+    WARN: { severityNumber: 13, severityText: 'WARN' },
+    DEBUG: { severityNumber: 5, severityText: 'DEBUG' },
+    TRACE: { severityNumber: 1, severityText: 'TRACE' },
+    FATAL: { severityNumber: 21, severityText: 'FATAL' },
+};
+class ZolaOtelLogger {
+    constructor(context) {
+        this.context = context;
+    }
+    log(message, context) {
+        this.write('INFO', SEVERITY.INFO, message, context);
+    }
+    error(message, stack, context) {
+        this.write('ERROR', SEVERITY.ERROR, message, context, stack);
+    }
+    warn(message, context) {
+        this.write('WARN', SEVERITY.WARN, message, context);
+    }
+    debug(message, context) {
+        this.write('DEBUG', SEVERITY.DEBUG, message, context);
+    }
+    verbose(message, context) {
+        this.write('VERBOSE', SEVERITY.TRACE, message, context);
+    }
+    fatal(message, context) {
+        this.write('FATAL', SEVERITY.FATAL, message, context);
+    }
+    setLogLevels(_levels) {
+    }
+    write(consoleLevel, severity, message, context, stack) {
+        const resolvedContext = context || this.context || 'App';
+        const body = this.formatBody(message, stack);
+        console.log(`[Nest] ${process.pid}  - ${resolvedContext} ${body}`);
+        (0, otel_log_helper_1.emitOtelLog)({
+            severityNumber: severity.severityNumber,
+            severityText: severity.severityText,
+            body,
+            context: resolvedContext,
+        });
+    }
+    formatBody(message, stack) {
+        if (typeof message === 'string') {
+            return stack ? `${message}\n${stack}` : message;
+        }
+        if (message && typeof message === 'object') {
+            return JSON.stringify(message);
+        }
+        return String(message);
+    }
+}
+exports.ZolaOtelLogger = ZolaOtelLogger;
+//# sourceMappingURL=zola-otel.logger.js.map

package/dist/zola-otel.logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zola-otel.logger.js","sourceRoot":"","sources":["../src/zola-otel.logger.ts"],"names":[],"mappings":";;;AAEA,uDAAgD;AAEhD,MAAM,QAAQ,GAAG;IACf,IAAI,EAAE,EAAE,cAAc,EAAE,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE;IACjD,KAAK,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE;IACpD,IAAI,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE;IAClD,KAAK,EAAE,EAAE,cAAc,EAAE,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE;IACnD,KAAK,EAAE,EAAE,cAAc,EAAE,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE;IACnD,KAAK,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE;CACrD,CAAC;AAEF;IACE,YAA6B,OAAgB;uBAAhB,OAAO;IAAY,CAAC;IAEjD,GAAG,CAAC,OAAgB,EAAE,OAAgB;QACpC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,OAAgB,EAAE,KAAc,EAAE,OAAgB;QACtD,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,CAAC,OAAgB,EAAE,OAAgB;QACrC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,OAAgB,EAAE,OAAgB;QACtC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,CAAC,OAAgB,EAAE,OAAgB;QACxC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,OAAgB,EAAE,OAAgB;QACtC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAED,YAAY,CAAE,OAAmB;IAEjC,CAAC;IAEO,KAAK,CACX,YAAoB,EACpB,QAA0D,EAC1D,OAAgB,EAChB,OAAgB,EAChB,KAAc;QAEd,MAAM,eAAe,GAAG,OAAO,IAAI,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC;QACzD,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAE7C,OAAO,CAAC,GAAG,CAAC,UAAU,OAAO,CAAC,GAAG,OAAO,eAAe,IAAI,IAAI,EAAE,CAAC,CAAC;QAEnE,IAAA,6BAAW,EAAC;YACV,cAAc,EAAE,QAAQ,CAAC,cAAc;YACvC,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,IAAI;YACJ,OAAO,EAAE,eAAe;SACzB,CAAC,CAAC;IACL,CAAC;IAEO,UAAU,CAAC,OAAgB,EAAE,KAAc;QACjD,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QAClD,CAAC;QAED,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC3C,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;QAED,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;CACF"}

package/dist/zola-request-logging.middleware.d.ts

@@ -0,0 +1,8 @@
+import { NestMiddleware } from '@nestjs/common';
+import { NextFunction, Request, Response } from 'express';
+import { ZolaObservabilityOptions } from './observability-options';
+export declare class ZolaRequestLoggingMiddleware implements NestMiddleware {
+    private readonly options;
+    constructor(options: ZolaObservabilityOptions);
+    use(request: Request, response: Response, next: NextFunction): void;
+}

package/dist/zola-request-logging.middleware.js

@@ -0,0 +1,42 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZolaRequestLoggingMiddleware = void 0;
+const common_1 = require("@nestjs/common");
+const observability_constants_1 = require("./observability.constants");
+const otel_log_helper_1 = require("./otel-log.helper");
+const trace_context_helper_1 = require("./trace-context.helper");
+let ZolaRequestLoggingMiddleware = class ZolaRequestLoggingMiddleware {
+    constructor(options) {
+        this.options = options;
+    }
+    use(request, response, next) {
+        if (this.options.logRequests === false) {
+            next();
+            return;
+        }
+        const traceIds = (0, trace_context_helper_1.getActiveTraceIds)();
+        response.on('finish', () => {
+            (0, otel_log_helper_1.emitHttpRequestLog)(request, response.statusCode, traceIds);
+        });
+        next();
+    }
+};
+exports.ZolaRequestLoggingMiddleware = ZolaRequestLoggingMiddleware;
+exports.ZolaRequestLoggingMiddleware = ZolaRequestLoggingMiddleware = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(observability_constants_1.ZOLA_OBSERVABILITY_OPTIONS)),
+    __metadata("design:paramtypes", [Object])
+], ZolaRequestLoggingMiddleware);
+//# sourceMappingURL=zola-request-logging.middleware.js.map

package/dist/zola-request-logging.middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zola-request-logging.middleware.js","sourceRoot":"","sources":["../src/zola-request-logging.middleware.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAAoE;AAGpE,uEAAuE;AAEvE,uDAAuD;AACvD,iEAA2D;AAGpD,IAAM,4BAA4B,GAAlC,MAAM,4BAA4B;IACvC,YAEmB,OAAiC;uBAAjC,OAAO;IACvB,CAAC;IAEJ,GAAG,CAAC,OAAgB,EAAE,QAAkB,EAAE,IAAkB;QAC1D,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,KAAK,KAAK,EAAE,CAAC;YACvC,IAAI,EAAE,CAAC;YACP,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,IAAA,wCAAiB,GAAE,CAAC;QAErC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;YACzB,IAAA,oCAAkB,EAAC,OAAO,EAAE,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;QAEH,IAAI,EAAE,CAAC;IACT,CAAC;CACF,CAAA;;uCApBY,4BAA4B;IADxC,IAAA,mBAAU,GAAE;IAGR,WAAA,IAAA,eAAM,EAAC,oDAA0B,CAAC,CAAA;;GAF1B,4BAA4B,CAoBxC"}

package/package.json

@@ -0,0 +1,138 @@
+{
+  "name": "@zola_do/observability",
+  "version": "0.3.1",
+  "description": "NestJS observability helpers for OpenTelemetry, request correlation, and trace-aware logging",
+  "author": "zolaDO",
+  "license": "ISC",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "clean": "rimraf dist",
+    "typecheck": "tsc --noEmit",
+    "build": "rimraf dist && tsc",
+    "prepublishOnly": "rimraf dist && tsc"
+  },
+  "peerDependencies": {
+    "@nestjs/common": "^10.0.0 || ^11.0.0 || ^12.0.0",
+    "@nestjs/core": "^10.0.0 || ^11.0.0 || ^12.0.0",
+    "@opentelemetry/api": "^1.0.0",
+    "@opentelemetry/api-logs": "^0.205.0",
+    "@opentelemetry/auto-instrumentations-node": "^0.60.0",
+    "@opentelemetry/exporter-logs-otlp-grpc": "^0.205.0",
+    "@opentelemetry/exporter-logs-otlp-http": "^0.205.0",
+    "@opentelemetry/exporter-metrics-otlp-grpc": "^0.205.0",
+    "@opentelemetry/exporter-metrics-otlp-http": "^0.205.0",
+    "@opentelemetry/exporter-trace-otlp-grpc": "^0.205.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.205.0",
+    "@opentelemetry/instrumentation-http": "^0.205.0",
+    "@opentelemetry/instrumentation-nestjs-core": "^0.52.0",
+    "@opentelemetry/instrumentation-pg": "^0.54.0",
+    "@opentelemetry/resources": "^2.0.0",
+    "@opentelemetry/sdk-node": "^0.205.0",
+    "@opentelemetry/sdk-logs": "^0.205.0",
+    "@opentelemetry/semantic-conventions": "^1.37.0",
+    "reflect-metadata": "^0.1.0 || ^0.2.0",
+    "rxjs": "^7.0.0 || ^8.0.0",
+    "@opentelemetry/sdk-metrics": "^2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@opentelemetry/api": {
+      "optional": true
+    },
+    "@opentelemetry/api-logs": {
+      "optional": true
+    },
+    "@opentelemetry/auto-instrumentations-node": {
+      "optional": true
+    },
+    "@opentelemetry/exporter-logs-otlp-grpc": {
+      "optional": true
+    },
+    "@opentelemetry/exporter-logs-otlp-http": {
+      "optional": true
+    },
+    "@opentelemetry/exporter-metrics-otlp-grpc": {
+      "optional": true
+    },
+    "@opentelemetry/exporter-metrics-otlp-http": {
+      "optional": true
+    },
+    "@opentelemetry/exporter-trace-otlp-grpc": {
+      "optional": true
+    },
+    "@opentelemetry/exporter-trace-otlp-http": {
+      "optional": true
+    },
+    "@opentelemetry/instrumentation-http": {
+      "optional": true
+    },
+    "@opentelemetry/instrumentation-nestjs-core": {
+      "optional": true
+    },
+    "@opentelemetry/instrumentation-pg": {
+      "optional": true
+    },
+    "@opentelemetry/resources": {
+      "optional": true
+    },
+    "@opentelemetry/sdk-node": {
+      "optional": true
+    },
+    "@opentelemetry/sdk-logs": {
+      "optional": true
+    },
+    "@opentelemetry/semantic-conventions": {
+      "optional": true
+    },
+    "@opentelemetry/sdk-metrics": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "rimraf": "^6.1.3",
+    "@typescript/native": "npm:typescript@^7.0.2",
+    "typescript": "npm:@typescript/typescript6@^6.0.2"
+  },
+  "repository": {
+    "directory": "packages/observability",
+    "type": "git",
+    "url": "https://github.com/zola0031/zola-nestjs-shared.git"
+  },
+  "homepage": "https://github.com/zola0031/zola-nestjs-shared#readme",
+  "bugs": {
+    "url": "https://github.com/zola0031/zola-nestjs-shared/issues"
+  },
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/zola0031"
+  },
+  "keywords": [
+    "nestjs",
+    "typescript",
+    "observability",
+    "opentelemetry",
+    "telemetry",
+    "tracing",
+    "metrics",
+    "zola_do",
+    "nestjs-shared"
+  ]
+}