@carecard/telemetry 3.18.0 → 3.20.0

package/README.md

@@ -19,7 +19,7 @@ explicit narrowing in all TypeScript-family files (`.ts`, `.tsx`, `.mts`,
 ## Install
 
 ```sh
-npm install @carecard/telemetry@3.17.0 --save-exact
+npm install @carecard/telemetry@3.18.0 --save-exact
 ```
 
 ## Bootstrap

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carecard/telemetry",
-  "version": "3.18.0",
+  "version": "3.20.0",
   "description": "Privacy-safe OpenTelemetry tracing for CareCard Node.js services",
   "main": "index.js",
   "module": "index.mjs",
@@ -31,15 +31,17 @@
     "registry": "https://registry.npmjs.org/"
   },
   "scripts": {
-    "test": "node --test test/*.test.js test/*.test.mjs scripts/packageTaskRunner.test.mjs",
+    "test": "node scripts/runPackageTask.mjs test",
     "test:types": "tsc --noEmit",
-    "test:coverage": "node --test --experimental-test-coverage --test-coverage-lines=90 --test-coverage-functions=90 --test-coverage-branches=85 test/*.test.js test/*.test.mjs",
+    "test:coverage": "node test/index.test.mjs",
     "test:All": "node scripts/runPackageTask.mjs test:All",
-    "format": "prettier --write .",
-    "format:check": "prettier --check .",
+    "validate:audits": "node scripts/runRepositoryAudits.mjs",
+    "format": "prettier --write \"**/*.{js,jsx,mjs,cjs,ts,tsx,mts,cts}\"",
+    "format:check": "prettier --check \"**/*.{js,jsx,mjs,cjs,ts,tsx,mts,cts}\"",
+    "lint-staged": "lint-staged",
     "prepare": "husky",
-    "lint:fix": "eslint --fix .",
-    "lint": "eslint ."
+    "lint:fix": "eslint . --fix --max-warnings 0",
+    "lint": "eslint . --max-warnings 0"
   },
   "keywords": [
     "carecard",
@@ -65,14 +67,18 @@
     "@opentelemetry/sdk-trace-node": "2.10.0"
   },
   "devDependencies": {
+    "@eslint/js": "9.39.5",
     "@types/node": "25.9.3",
-    "eslint": "9.39.4",
+    "@typescript-eslint/parser": "8.67.0",
+    "eslint": "9.39.5",
+    "globals": "17.7.0",
     "husky": "9.1.7",
-    "prettier": "3.8.4",
+    "lint-staged": "17.2.0",
+    "prettier": "3.9.6",
     "typescript": "6.0.3"
   },
   "overrides": {
-    "brace-expansion": "5.0.8",
+    "brace-expansion": "5.0.9",
     "minimatch": "10.2.6"
   }
 }

package/src/initializeServiceTelemetry.js

@@ -63,7 +63,7 @@ function buildRuntime(provider, contextManager, instrumentations) {
       try {
         await provider.shutdown();
       } finally {
-        instrumentations.forEach((instrumentation) => instrumentation.disable());
+        instrumentations.forEach(instrumentation => instrumentation.disable());
         contextManager.disable();
       }
     },

package/src/instrumentations.js

@@ -32,11 +32,24 @@ function isRoutineRequest(request) {
   );
 }
 
+// Pattern: Normalizer - produces the bracketed URL host form for DNS, IPv4, and IPv6 inputs.
+function normalizeRequestHost(requestHost) {
+  const host = String(requestHost || '')
+    .replace(/^https?:\/\//, '')
+    .split('/')[0];
+  if (host.startsWith('[') || host.split(':').length <= 2) {
+    return host;
+  }
+  return `[${host}]`;
+}
+
 // Pattern: Normalizer - creates the endpoint host form without duplicating a supplied port.
 function requestHostWithPort(request) {
-  const requestHost = request.hostname || request.host || request.origin;
-  const normalizedHost = String(requestHost || '').replace(/^https?:\/\//, '');
-  if (!request.port || normalizedHost.includes(':')) {
+  const normalizedHost = normalizeRequestHost(request.hostname || request.host || request.origin);
+  const hasExplicitPort = normalizedHost.startsWith('[')
+    ? normalizedHost.includes(']:')
+    : normalizedHost.includes(':');
+  if (!request.port || hasExplicitPort) {
     return normalizedHost;
   }
   return `${normalizedHost}:${request.port}`;
@@ -53,7 +66,7 @@ function createInstrumentations(endpointUrl) {
   return [
     new HttpInstrumentation({
       ignoreIncomingRequestHook: isRoutineRequest,
-      ignoreOutgoingRequestHook: (request) => isExporterRequest(request, endpoint),
+      ignoreOutgoingRequestHook: request => isExporterRequest(request, endpoint),
     }),
     new ExpressInstrumentation(),
     new PgInstrumentation({
@@ -63,7 +76,7 @@ function createInstrumentations(endpointUrl) {
     }),
     new KafkaJsInstrumentation(),
     new UndiciInstrumentation({
-      ignoreRequestHook: (request) => isExporterRequest(request, endpoint),
+      ignoreRequestHook: request => isExporterRequest(request, endpoint),
     }),
   ];
 }

package/src/privacySafeSpanExporter.js

@@ -67,7 +67,7 @@ function sanitizeSpanAttributes(attributes = {}) {
 }
 
 function sanitizeEvents(events = []) {
-  return events.map((event) => ({
+  return events.map(event => ({
     ...event,
     name: SAFE_EVENT_NAMES.has(event.name) ? event.name : 'event',
     attributes: sanitizeExceptionAttributes(event.attributes),
@@ -80,7 +80,7 @@ function sanitizeExceptionAttributes(attributes = {}) {
 }
 
 function sanitizeLinks(links = []) {
-  return links.map((link) => ({ ...link, attributes: {} }));
+  return links.map(link => ({ ...link, attributes: {} }));
 }
 
 function buildSemanticSpanName(attributes) {

package/src/traceContext.js

@@ -67,7 +67,7 @@ async function runWithTraceparent({ spanName, traceparent }, operation) {
   validateOperation(spanName, operation);
   const tracer = trace.getTracer('@carecard/telemetry');
   const parentContext = extractParentContext(traceparent);
-  return tracer.startActiveSpan(spanName, { kind: SpanKind.INTERNAL }, parentContext, (span) =>
+  return tracer.startActiveSpan(spanName, { kind: SpanKind.INTERNAL }, parentContext, span =>
     invokeOperation(span, operation),
   );
 }

package/src/traceparentOnlyPropagator.js

@@ -31,7 +31,7 @@ function createTraceparentGetter(getter) {
       return key.toLowerCase() === TRACESTATE_HEADER ? undefined : getter.get(carrier, key);
     },
     keys(carrier) {
-      return getter.keys(carrier).filter((key) => key.toLowerCase() !== TRACESTATE_HEADER);
+      return getter.keys(carrier).filter(key => key.toLowerCase() !== TRACESTATE_HEADER);
     },
   };
 }