@breadstone/archipel-platform-telemetry 0.0.21 → 0.0.23

package/README.md

@@ -17,7 +17,7 @@ import { TelemetryModule } from '@breadstone/archipel-platform-telemetry';
 - **Metrics collection**: Counter, histogram, and gauge recording via `TelemetryFacade`
 - **Distributed tracing**: OpenTelemetry SDK integration with automatic span creation
 - **Operation interceptor**: `OperationTelemetryInterceptor` wraps controller methods in telemetry operations (returns `Observable<unknown>`)
-- **Graceful degradation**: Falls back to `NoopTelemetryFacade` when disabled — zero overhead
+- **Graceful degradation**: Falls back to `NoopTelemetryFacade` when disabled - zero overhead
 - **Health checks**: Integration with health module for observability readiness
 - **Structured logging**: `TelemetryLoggerService` with request correlation IDs
 - **Eager metric init**: `MetricsService` creates instruments at startup via `OnModuleInit`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@breadstone/archipel-platform-telemetry",
-  "version": "0.0.21",
+  "version": "0.0.23",
   "description": "OpenTelemetry integration with tracing, metrics, and graceful no-op fallback for NestJS.",
   "type": "commonjs",
   "main": "./src/index.js",
@@ -28,26 +28,60 @@
     "README.md"
   ],
   "dependencies": {
-    "@breadstone/archipel-platform-caching": "0.0.21",
-    "@breadstone/archipel-platform-core": "0.0.21",
-    "@opentelemetry/api": "1.9.1",
-    "@opentelemetry/exporter-metrics-otlp-http": "0.215.0",
-    "@opentelemetry/exporter-trace-otlp-http": "0.215.0",
-    "@opentelemetry/instrumentation-express": "0.63.0",
-    "@opentelemetry/instrumentation-http": "0.215.0",
-    "@opentelemetry/resources": "2.7.0",
-    "@opentelemetry/sdk-node": "0.215.0",
-    "@opentelemetry/semantic-conventions": "1.40.0",
+    "@breadstone/archipel-platform-caching": "0.0.23",
+    "@breadstone/archipel-platform-core": "0.0.23",
     "tslib": "2.8.1"
   },
   "peerDependencies": {
     "@nestjs/common": ">=11.0.0",
     "@nestjs/core": ">=11.0.0",
+    "@opentelemetry/api": ">=1.9.0",
+    "@opentelemetry/exporter-metrics-otlp-http": ">=0.200.0",
+    "@opentelemetry/exporter-trace-otlp-http": ">=0.200.0",
+    "@opentelemetry/instrumentation-express": ">=0.60.0",
+    "@opentelemetry/instrumentation-http": ">=0.200.0",
+    "@opentelemetry/resources": ">=2.0.0",
+    "@opentelemetry/sdk-node": ">=0.200.0",
+    "@opentelemetry/semantic-conventions": ">=1.30.0",
     "rxjs": ">=7.0.0"
   },
+  "peerDependenciesMeta": {
+    "@opentelemetry/api": {
+      "optional": true
+    },
+    "@opentelemetry/exporter-metrics-otlp-http": {
+      "optional": true
+    },
+    "@opentelemetry/exporter-trace-otlp-http": {
+      "optional": true
+    },
+    "@opentelemetry/instrumentation-express": {
+      "optional": true
+    },
+    "@opentelemetry/instrumentation-http": {
+      "optional": true
+    },
+    "@opentelemetry/resources": {
+      "optional": true
+    },
+    "@opentelemetry/sdk-node": {
+      "optional": true
+    },
+    "@opentelemetry/semantic-conventions": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@nestjs/common": "11.1.19",
     "@nestjs/core": "11.1.19",
+    "@opentelemetry/api": "1.9.1",
+    "@opentelemetry/exporter-metrics-otlp-http": "0.215.0",
+    "@opentelemetry/exporter-trace-otlp-http": "0.215.0",
+    "@opentelemetry/instrumentation-express": "0.63.0",
+    "@opentelemetry/instrumentation-http": "0.215.0",
+    "@opentelemetry/resources": "2.7.0",
+    "@opentelemetry/sdk-node": "0.215.0",
+    "@opentelemetry/semantic-conventions": "1.40.0",
     "rxjs": "7.8.2",
     "vitest": "4.1.4"
   }

package/src/OtelSdkHolder.d.ts

@@ -12,7 +12,7 @@ export declare class OtelSdkHolder implements OnApplicationShutdown {
     private _sdk?;
     /**
      * Stores the SDK reference so it can be shut down later.
-     * Can only be called once — subsequent calls are ignored.
+     * Can only be called once - subsequent calls are ignored.
      */
     setSdk(sdk: unknown): void;
     /** @inheritdoc */

package/src/OtelSdkHolder.js

@@ -24,11 +24,11 @@ let OtelSdkHolder = OtelSdkHolder_1 = class OtelSdkHolder {
     // #region Methods
     /**
      * Stores the SDK reference so it can be shut down later.
-     * Can only be called once — subsequent calls are ignored.
+     * Can only be called once - subsequent calls are ignored.
      */
     setSdk(sdk) {
         if (this._sdk) {
-            this._logger.warn('OtelSdkHolder.setSdk() called more than once — ignoring.');
+            this._logger.warn('OtelSdkHolder.setSdk() called more than once - ignoring.');
             return;
         }
         this._sdk = sdk;

package/src/TelemetryModule.js

@@ -14,14 +14,14 @@ const MetricsService_1 = require("./metrics/MetricsService");
 const TelemetryOptions_1 = require("./options/TelemetryOptions");
 const OtelSdkHolder_1 = require("./OtelSdkHolder");
 const TelemetryRuleEngine_1 = require("./rules/TelemetryRuleEngine");
-const tokens_1 = require("./tokens");
+const TelemetryTokens_1 = require("./tokens/TelemetryTokens");
 let TelemetryModule = TelemetryModule_1 = class TelemetryModule {
     static register(options) {
         return {
             module: TelemetryModule_1,
             providers: [
                 {
-                    provide: tokens_1.TELEMETRY_OPTIONS,
+                    provide: TelemetryTokens_1.TELEMETRY_OPTIONS,
                     useFactory: () => {
                         const merged = {
                             ...TelemetryOptions_1.defaultTelemetryOptions,
@@ -32,21 +32,21 @@ let TelemetryModule = TelemetryModule_1 = class TelemetryModule {
                     },
                 },
                 {
-                    provide: tokens_1.TELEMETRY_ENABLED,
-                    inject: [tokens_1.TELEMETRY_OPTIONS],
+                    provide: TelemetryTokens_1.TELEMETRY_ENABLED,
+                    inject: [TelemetryTokens_1.TELEMETRY_OPTIONS],
                     useFactory: (cfg) => cfg.enabled,
                 },
                 {
                     provide: TelemetryRuleEngine_1.TelemetryRuleEngine,
-                    inject: [tokens_1.TELEMETRY_OPTIONS, MetricsService_1.MetricsService],
+                    inject: [TelemetryTokens_1.TELEMETRY_OPTIONS, MetricsService_1.MetricsService],
                     useFactory: (cfg, metricsService) => new TelemetryRuleEngine_1.TelemetryRuleEngine(cfg, metricsService),
                 },
                 TelemetryLoggerService_1.TelemetryLoggerService,
                 OtelSdkHolder_1.OtelSdkHolder,
                 MetricsService_1.MetricsService,
                 {
-                    provide: tokens_1.TELEMETRY_FACADE,
-                    inject: [tokens_1.TELEMETRY_OPTIONS, tokens_1.TELEMETRY_ENABLED, OtelSdkHolder_1.OtelSdkHolder],
+                    provide: TelemetryTokens_1.TELEMETRY_FACADE,
+                    inject: [TelemetryTokens_1.TELEMETRY_OPTIONS, TelemetryTokens_1.TELEMETRY_ENABLED, OtelSdkHolder_1.OtelSdkHolder],
                     useFactory: async (cfg, enabled, sdkHolder) => {
                         if (!enabled)
                             return new NoopTelemetryFacade_1.NoopTelemetryFacade();
@@ -63,13 +63,13 @@ let TelemetryModule = TelemetryModule_1 = class TelemetryModule {
                 },
                 {
                     provide: core_1.APP_INTERCEPTOR,
-                    inject: [tokens_1.TELEMETRY_FACADE, tokens_1.TELEMETRY_OPTIONS],
+                    inject: [TelemetryTokens_1.TELEMETRY_FACADE, TelemetryTokens_1.TELEMETRY_OPTIONS],
                     useFactory: (facade, cfg) => cfg.interceptor?.operation
                         ? new OperationTelemetryInterceptor_1.OperationTelemetryInterceptor(facade)
                         : { intercept: (_, next) => next.handle() },
                 },
             ],
-            exports: [tokens_1.TELEMETRY_FACADE, MetricsService_1.MetricsService],
+            exports: [TelemetryTokens_1.TELEMETRY_FACADE, MetricsService_1.MetricsService],
         };
     }
 };

package/src/core/TelemetryCacheMetricsRecorder.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TelemetryCacheMetricsRecorder = void 0;
 const tslib_1 = require("tslib");
 const common_1 = require("@nestjs/common");
-const tokens_1 = require("../tokens");
+const TelemetryTokens_1 = require("../tokens/TelemetryTokens");
 // #endregion
 /**
  * Generic cache metrics recorder that forwards cache lifecycle events
@@ -56,7 +56,7 @@ let TelemetryCacheMetricsRecorder = class TelemetryCacheMetricsRecorder {
 exports.TelemetryCacheMetricsRecorder = TelemetryCacheMetricsRecorder;
 exports.TelemetryCacheMetricsRecorder = TelemetryCacheMetricsRecorder = tslib_1.__decorate([
     (0, common_1.Injectable)(),
-    tslib_1.__param(0, (0, common_1.Inject)(tokens_1.TELEMETRY_FACADE)),
+    tslib_1.__param(0, (0, common_1.Inject)(TelemetryTokens_1.TELEMETRY_FACADE)),
     tslib_1.__metadata("design:paramtypes", [Object])
 ], TelemetryCacheMetricsRecorder);
 //# sourceMappingURL=TelemetryCacheMetricsRecorder.js.map

package/src/index.d.ts

@@ -7,4 +7,4 @@ export * from './options/TelemetryOptions';
 export { OtelSdkHolder } from './OtelSdkHolder';
 export * from './rules/TelemetryRuleEngine';
 export { TelemetryModule } from './TelemetryModule';
-export * from './tokens';
+export * from './tokens/TelemetryTokens';

package/src/index.js

@@ -13,5 +13,5 @@ Object.defineProperty(exports, "OtelSdkHolder", { enumerable: true, get: functio
 tslib_1.__exportStar(require("./rules/TelemetryRuleEngine"), exports);
 var TelemetryModule_1 = require("./TelemetryModule");
 Object.defineProperty(exports, "TelemetryModule", { enumerable: true, get: function () { return TelemetryModule_1.TelemetryModule; } });
-tslib_1.__exportStar(require("./tokens"), exports);
+tslib_1.__exportStar(require("./tokens/TelemetryTokens"), exports);
 //# sourceMappingURL=index.js.map

package/src/{tokens.js → tokens/TelemetryTokens.js}

@@ -5,4 +5,4 @@ exports.TELEMETRY_ENABLED = exports.TELEMETRY_FACADE = exports.TELEMETRY_OPTIONS
 exports.TELEMETRY_OPTIONS = Symbol('TELEMETRY_OPTIONS');
 exports.TELEMETRY_FACADE = Symbol('TELEMETRY_FACADE');
 exports.TELEMETRY_ENABLED = Symbol('TELEMETRY_ENABLED');
-//# sourceMappingURL=tokens.js.map
+//# sourceMappingURL=TelemetryTokens.js.map