@manifest-cyber/observability-ts 0.2.6 → 0.2.7

package/dist/index.d.ts

@@ -55,5 +55,7 @@ export { injectTraceContext, extractTraceContext, getTraceparent, parseTracepare
 export type { Span, Tracer, Context, SpanAttributes } from '@opentelemetry/api';
 export { SpanStatusCode, SpanKind } from '@opentelemetry/api';
 export type { ServiceMetricsConfig, MetricLabels, DurationMetricOptions, Logger, } from './types';
-export type { TracingConfig, ExporterConfig, SamplingConfig, SpanOptions, TracedResult, HttpSpanAttributes, DbSpanAttributes, MessagingSpanAttributes, } from './tracing/types';
+export type { TracingConfig, ExporterConfig, SamplingConfig, SpanOptions, TracedResult, HttpSpanAttributes, DbSpanAttributes, MessagingSpanAttributes, TraceContext, } from './tracing/types';
+export { initObservability } from './init';
+export type { InitObservabilityConfig, InitObservabilityResult } from './init';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAOH,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAG7D,OAAO,EACL,aAAa,EACb,eAAe,EACf,WAAW,EACX,OAAO,EACP,gBAAgB,EAAE,mCAAmC;AACrD,WAAW,EACX,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1D,OAAO,EACL,KAAK,EACL,cAAc,EACd,eAAe,EACf,cAAc,GACf,MAAM,2BAA2B,CAAC;AAGnC,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAOvE,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,SAAS,EACT,UAAU,EACV,QAAQ,EACR,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,4BAA4B,EAC5B,yBAAyB,EACzB,0BAA0B,EAC1B,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAM9D,YAAY,EACV,oBAAoB,EACpB,YAAY,EACZ,qBAAqB,EACrB,MAAM,GACP,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,aAAa,EACb,cAAc,EACd,cAAc,EACd,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAOH,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAG7D,OAAO,EACL,aAAa,EACb,eAAe,EACf,WAAW,EACX,OAAO,EACP,gBAAgB,EAAE,mCAAmC;AACrD,WAAW,EACX,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1D,OAAO,EACL,KAAK,EACL,cAAc,EACd,eAAe,EACf,cAAc,GACf,MAAM,2BAA2B,CAAC;AAGnC,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAOvE,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,SAAS,EACT,UAAU,EACV,QAAQ,EACR,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,4BAA4B,EAC5B,yBAAyB,EACzB,0BAA0B,EAC1B,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAM9D,YAAY,EACV,oBAAoB,EACpB,YAAY,EACZ,qBAAqB,EACrB,MAAM,GACP,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,aAAa,EACb,cAAc,EACd,cAAc,EACd,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,uBAAuB,EACvB,YAAY,GACb,MAAM,iBAAiB,CAAC;AAMzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAC3C,YAAY,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,QAAQ,CAAC"}

package/dist/index.js

@@ -43,7 +43,7 @@
  * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SpanKind = exports.SpanStatusCode = exports.withExtractedContextAsync = exports.withExtractedContext = exports.extractMessageTraceContext = exports.createMessageTraceContext = exports.createContextFromTraceparent = exports.parseTraceparent = exports.getTraceparent = exports.extractTraceContext = exports.injectTraceContext = exports.withActiveSpanAsync = exports.withActiveSpan = exports.recordException = exports.setSpanAttributes = exports.addSpanEvent = exports.getCurrentSpanId = exports.getCurrentTraceId = exports.getCurrentSpan = exports.withSpanResult = exports.withSpan = exports.createSpan = exports.getTracer = exports.shutdownTracing = exports.getTracerProvider = exports.isTracingInitialized = exports.initTracing = exports.trackOperation = exports.instrumentAsync = exports.MetricsContext = exports.Timer = exports.ENV_KEY_SERVICE_NAME = exports.MetricNames = exports.DURATION_BUCKETS = exports.BUCKETS = exports.createGauge = exports.createHistogram = exports.createCounter = exports.startMetricsServer = exports.resetRegistry = exports.getRegistry = void 0;
+exports.initObservability = exports.SpanKind = exports.SpanStatusCode = exports.withExtractedContextAsync = exports.withExtractedContext = exports.extractMessageTraceContext = exports.createMessageTraceContext = exports.createContextFromTraceparent = exports.parseTraceparent = exports.getTraceparent = exports.extractTraceContext = exports.injectTraceContext = exports.withActiveSpanAsync = exports.withActiveSpan = exports.recordException = exports.setSpanAttributes = exports.addSpanEvent = exports.getCurrentSpanId = exports.getCurrentTraceId = exports.getCurrentSpan = exports.withSpanResult = exports.withSpan = exports.createSpan = exports.getTracer = exports.shutdownTracing = exports.getTracerProvider = exports.isTracingInitialized = exports.initTracing = exports.trackOperation = exports.instrumentAsync = exports.MetricsContext = exports.Timer = exports.ENV_KEY_SERVICE_NAME = exports.MetricNames = exports.DURATION_BUCKETS = exports.BUCKETS = exports.createGauge = exports.createHistogram = exports.createCounter = exports.startMetricsServer = exports.resetRegistry = exports.getRegistry = void 0;
 // ====================
 // METRICS EXPORTS
 // ====================
@@ -106,4 +106,9 @@ Object.defineProperty(exports, "withExtractedContextAsync", { enumerable: true,
 var api_1 = require("@opentelemetry/api");
 Object.defineProperty(exports, "SpanStatusCode", { enumerable: true, get: function () { return api_1.SpanStatusCode; } });
 Object.defineProperty(exports, "SpanKind", { enumerable: true, get: function () { return api_1.SpanKind; } });
+// ====================
+// INITIALIZATION HELPERS
+// ====================
+var init_1 = require("./init");
+Object.defineProperty(exports, "initObservability", { enumerable: true, get: function () { return init_1.initObservability; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;;;AAEH,uBAAuB;AACvB,kBAAkB;AAClB,uBAAuB;AAEvB,sBAAsB;AACtB,+CAAgE;AAAvD,uGAAA,WAAW,OAAA;AAAE,yGAAA,aAAa,OAAA;AAEnC,eAAe;AACf,2CAAsD;AAA7C,4GAAA,kBAAkB,OAAA;AAG3B,kBAAkB;AAClB,+CAQ4B;AAP1B,yGAAA,aAAa,OAAA;AACb,2GAAA,eAAe,OAAA;AACf,uGAAA,WAAW,OAAA;AACX,mGAAA,OAAO,OAAA;AACP,4GAAA,gBAAgB,OAAA;AAChB,uGAAA,WAAW,OAAA;AACX,gHAAA,oBAAoB,OAAA;AAItB,0BAA0B;AAC1B,6DAKmC;AAJjC,wGAAA,KAAK,OAAA;AACL,iHAAA,cAAc,OAAA;AACd,kHAAA,eAAe,OAAA;AACf,iHAAA,cAAc,OAAA;AAMhB,uBAAuB;AACvB,kBAAkB;AAClB,uBAAuB;AAEvB,2BAA2B;AAC3B,yCAKyB;AAJvB,oGAAA,WAAW,OAAA;AACX,6GAAA,oBAAoB,OAAA;AACpB,0GAAA,iBAAiB,OAAA;AACjB,wGAAA,eAAe,OAAA;AAGjB,kBAAkB;AAClB,yCAayB;AAZvB,kGAAA,SAAS,OAAA;AACT,mGAAA,UAAU,OAAA;AACV,iGAAA,QAAQ,OAAA;AACR,uGAAA,cAAc,OAAA;AACd,uGAAA,cAAc,OAAA;AACd,0GAAA,iBAAiB,OAAA;AACjB,yGAAA,gBAAgB,OAAA;AAChB,qGAAA,YAAY,OAAA;AACZ,0GAAA,iBAAiB,OAAA;AACjB,wGAAA,eAAe,OAAA;AACf,uGAAA,cAAc,OAAA;AACd,4GAAA,mBAAmB,OAAA;AAGrB,sBAAsB;AACtB,6CAU2B;AATzB,6GAAA,kBAAkB,OAAA;AAClB,8GAAA,mBAAmB,OAAA;AACnB,yGAAA,cAAc,OAAA;AACd,2GAAA,gBAAgB,OAAA;AAChB,uHAAA,4BAA4B,OAAA;AAC5B,oHAAA,yBAAyB,OAAA;AACzB,qHAAA,0BAA0B,OAAA;AAC1B,+GAAA,oBAAoB,OAAA;AACpB,oHAAA,yBAAyB,OAAA;AAK3B,0CAA8D;AAArD,qGAAA,cAAc,OAAA;AAAE,+FAAA,QAAQ,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;;;AAEH,uBAAuB;AACvB,kBAAkB;AAClB,uBAAuB;AAEvB,sBAAsB;AACtB,+CAAgE;AAAvD,uGAAA,WAAW,OAAA;AAAE,yGAAA,aAAa,OAAA;AAEnC,eAAe;AACf,2CAAsD;AAA7C,4GAAA,kBAAkB,OAAA;AAG3B,kBAAkB;AAClB,+CAQ4B;AAP1B,yGAAA,aAAa,OAAA;AACb,2GAAA,eAAe,OAAA;AACf,uGAAA,WAAW,OAAA;AACX,mGAAA,OAAO,OAAA;AACP,4GAAA,gBAAgB,OAAA;AAChB,uGAAA,WAAW,OAAA;AACX,gHAAA,oBAAoB,OAAA;AAItB,0BAA0B;AAC1B,6DAKmC;AAJjC,wGAAA,KAAK,OAAA;AACL,iHAAA,cAAc,OAAA;AACd,kHAAA,eAAe,OAAA;AACf,iHAAA,cAAc,OAAA;AAMhB,uBAAuB;AACvB,kBAAkB;AAClB,uBAAuB;AAEvB,2BAA2B;AAC3B,yCAKyB;AAJvB,oGAAA,WAAW,OAAA;AACX,6GAAA,oBAAoB,OAAA;AACpB,0GAAA,iBAAiB,OAAA;AACjB,wGAAA,eAAe,OAAA;AAGjB,kBAAkB;AAClB,yCAayB;AAZvB,kGAAA,SAAS,OAAA;AACT,mGAAA,UAAU,OAAA;AACV,iGAAA,QAAQ,OAAA;AACR,uGAAA,cAAc,OAAA;AACd,uGAAA,cAAc,OAAA;AACd,0GAAA,iBAAiB,OAAA;AACjB,yGAAA,gBAAgB,OAAA;AAChB,qGAAA,YAAY,OAAA;AACZ,0GAAA,iBAAiB,OAAA;AACjB,wGAAA,eAAe,OAAA;AACf,uGAAA,cAAc,OAAA;AACd,4GAAA,mBAAmB,OAAA;AAGrB,sBAAsB;AACtB,6CAU2B;AATzB,6GAAA,kBAAkB,OAAA;AAClB,8GAAA,mBAAmB,OAAA;AACnB,yGAAA,cAAc,OAAA;AACd,2GAAA,gBAAgB,OAAA;AAChB,uHAAA,4BAA4B,OAAA;AAC5B,oHAAA,yBAAyB,OAAA;AACzB,qHAAA,0BAA0B,OAAA;AAC1B,+GAAA,oBAAoB,OAAA;AACpB,oHAAA,yBAAyB,OAAA;AAK3B,0CAA8D;AAArD,qGAAA,cAAc,OAAA;AAAE,+FAAA,QAAQ,OAAA;AAyBjC,uBAAuB;AACvB,yBAAyB;AACzB,uBAAuB;AAEvB,+BAA2C;AAAlC,yGAAA,iBAAiB,OAAA"}

package/dist/init.d.ts

@@ -0,0 +1,42 @@
+/**
+ * High-level initialization helpers for observability setup.
+ * Simplifies the setup of tracing, metrics, and logging for services.
+ */
+export interface InitObservabilityConfig {
+    /** Service name for telemetry */
+    serviceName: string;
+    /** Port for metrics server (default: 9090) */
+    metricsPort?: number;
+    /** Enable/disable tracing (default: true, checks OTEL_TRACING_ENABLED env) */
+    tracingEnabled?: boolean;
+    /** Sampling ratio 0.0-1.0 (default: auto-configured based on ENV) */
+    samplingRatio?: number;
+    /** OTLP endpoint for traces (default: http://localhost:4317) */
+    otlpEndpoint?: string;
+}
+export interface InitObservabilityResult {
+    /** Service name used */
+    serviceName: string;
+    /** Whether tracing was initialized */
+    tracingInitialized: boolean;
+    /** Metrics server port */
+    metricsPort: number;
+}
+/**
+ * Initialize observability for a service (metrics + tracing).
+ * Call this once at service startup.
+ *
+ * @example
+ * ```typescript
+ * import { initObservability } from '@manifest-cyber/observability-ts';
+ *
+ * const { serviceName, tracingInitialized } = await initObservability({
+ *   serviceName: 'my-service',
+ *   metricsPort: 9090,
+ * });
+ *
+ * console.log(`Observability initialized for ${serviceName}`);
+ * ```
+ */
+export declare function initObservability(config: InitObservabilityConfig): Promise<InitObservabilityResult>;
+//# sourceMappingURL=init.d.ts.map

package/dist/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,uBAAuB;IACtC,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,uBAAuB,CAAC,CAsClC"}

package/dist/init.js

@@ -0,0 +1,77 @@
+"use strict";
+/**
+ * High-level initialization helpers for observability setup.
+ * Simplifies the setup of tracing, metrics, and logging for services.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initObservability = initObservability;
+const setup_1 = require("./tracing/setup");
+const server_1 = require("./metrics/server");
+/**
+ * Initialize observability for a service (metrics + tracing).
+ * Call this once at service startup.
+ *
+ * @example
+ * ```typescript
+ * import { initObservability } from '@manifest-cyber/observability-ts';
+ *
+ * const { serviceName, tracingInitialized } = await initObservability({
+ *   serviceName: 'my-service',
+ *   metricsPort: 9090,
+ * });
+ *
+ * console.log(`Observability initialized for ${serviceName}`);
+ * ```
+ */
+async function initObservability(config) {
+    const { serviceName, metricsPort = 9090, tracingEnabled = process.env.OTEL_TRACING_ENABLED !== 'false', samplingRatio = getSamplingRatio(), otlpEndpoint = process.env.OTEL_EXPORTER_OTLP_ENDPOINT || 'http://localhost:4317', } = config;
+    let tracingInitialized = false;
+    // Initialize tracing
+    if (tracingEnabled) {
+        await (0, setup_1.initTracing)({
+            serviceName,
+            exporter: {
+                type: 'otlp-grpc',
+                endpoint: otlpEndpoint,
+            },
+            sampling: {
+                rate: samplingRatio,
+                alwaysOnError: true,
+            },
+        });
+        tracingInitialized = true;
+    }
+    // Start metrics server
+    await (0, server_1.startMetricsServer)({
+        serviceName,
+        port: metricsPort,
+    });
+    return {
+        serviceName,
+        tracingInitialized,
+        metricsPort,
+    };
+}
+/**
+ * Get default sampling ratio based on environment.
+ * Can be overridden with OTEL_SAMPLING_RATIO environment variable.
+ */
+function getSamplingRatio() {
+    // Check for explicit sampling ratio override
+    const envSamplingRatio = process.env.OTEL_SAMPLING_RATIO;
+    if (envSamplingRatio) {
+        const ratio = parseFloat(envSamplingRatio);
+        if (!isNaN(ratio) && ratio >= 0 && ratio <= 1) {
+            return ratio;
+        }
+    }
+    // Default based on environment
+    const env = process.env.ENV || 'development';
+    // 100% sampling in dev/staging
+    if (env !== 'production') {
+        return 1.0;
+    }
+    // 10% sampling in production
+    return 0.1;
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AA2CH,8CAwCC;AAjFD,2CAA8C;AAC9C,6CAAsD;AAwBtD;;;;;;;;;;;;;;;GAeG;AACI,KAAK,UAAU,iBAAiB,CACrC,MAA+B;IAE/B,MAAM,EACJ,WAAW,EACX,WAAW,GAAG,IAAI,EAClB,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,OAAO,EAC7D,aAAa,GAAG,gBAAgB,EAAE,EAClC,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,uBAAuB,GAClF,GAAG,MAAM,CAAC;IAEX,IAAI,kBAAkB,GAAG,KAAK,CAAC;IAE/B,qBAAqB;IACrB,IAAI,cAAc,EAAE,CAAC;QACnB,MAAM,IAAA,mBAAW,EAAC;YAChB,WAAW;YACX,QAAQ,EAAE;gBACR,IAAI,EAAE,WAAW;gBACjB,QAAQ,EAAE,YAAY;aACvB;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,aAAa;gBACnB,aAAa,EAAE,IAAI;aACpB;SACF,CAAC,CAAC;QACH,kBAAkB,GAAG,IAAI,CAAC;IAC5B,CAAC;IAED,uBAAuB;IACvB,MAAM,IAAA,2BAAkB,EAAC;QACvB,WAAW;QACX,IAAI,EAAE,WAAW;KAClB,CAAC,CAAC;IAEH,OAAO;QACL,WAAW;QACX,kBAAkB;QAClB,WAAW;KACZ,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,gBAAgB;IACvB,6CAA6C;IAC7C,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IACzD,IAAI,gBAAgB,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,UAAU,CAAC,gBAAgB,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YAC9C,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,+BAA+B;IAC/B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,aAAa,CAAC;IAE7C,+BAA+B;IAC/B,IAAI,GAAG,KAAK,YAAY,EAAE,CAAC;QACzB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,6BAA6B;IAC7B,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/tracing/types.d.ts

@@ -155,4 +155,16 @@ export interface Logger {
     warn?: (message: string, ...args: any[]) => void;
     debug?: (message: string, ...args: any[]) => void;
 }
+/**
+ * W3C Trace Context for distributed tracing across message queues.
+ * Used for propagating trace context through messaging systems like SQS and RabbitMQ.
+ *
+ * @see https://www.w3.org/TR/trace-context/
+ */
+export interface TraceContext {
+    /** W3C traceparent header: "00-{trace-id}-{span-id}-{flags}" */
+    traceparent?: string;
+    /** W3C tracestate header: optional vendor-specific trace data */
+    tracestate?: string;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/tracing/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tracing/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tracing/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;IAE1B;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IAE/D;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,IAAI,CAAC,EAAE,WAAW,GAAG,WAAW,CAAC;IAEjC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,UAAU,CAAC,EAAE,cAAc,CAAC;IAE5B;;OAEG;IACH,MAAM,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC;IAExB;;OAEG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC;CACnE;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B;;OAEG;IACH,KAAK,EAAE,CAAC,CAAC;IAET;;OAEG;IACH,IAAI,EAAE,IAAI,CAAC;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6BAA6B,CAAC,EAAE,MAAM,CAAC;IACvC,8BAA8B,CAAC,EAAE,MAAM,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,4BAA4B,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IACjD,qBAAqB,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IACvD,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,2BAA2B,CAAC,EAAE,MAAM,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAChD,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IACjD,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IACjD,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;CACnD;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@manifest-cyber/observability-ts",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "description": "Unified observability library for Manifest Cyber services - Metrics (Prometheus) and Tracing (OpenTelemetry)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",