@zerotal/telemetry 1.3.0 → 1.5.0

package/CHANGELOG.md

@@ -4,10 +4,45 @@ All notable changes to this package are documented here. The format is
 based on [Keep a Changelog](https://keepachangelog.com/); this package
 follows the Zerotal monorepo's unified versioning.
 
-**Maturity: `beta`**
+**Maturity: `stable`**
 
 ## [Unreleased]
 
+## [1.5.0] — 2026-08-15
+
+### Added
+
+- **Tests for the exporters and the request middleware — the package's entire
+  output path.** Spans, context propagation and the event bridge were all covered,
+  which left the untested part the part that actually produces something. Both of
+  its failure modes are quiet:
+
+  - **A mistyped attribute.** OTLP types each value (`stringValue`, `intValue`,
+    `doubleValue`, `boolValue`), and a backend indexes on that type — an integer
+    sent as a string still shows in the trace but stops being aggregatable. Now
+    pinned per type, along with millisecond→nanosecond conversion (sending
+    milliseconds puts every span in 1970 with no error raised) and the empty
+    `parentSpanId` a root span needs, since a null there makes a collector drop
+    the batch.
+  - **An exporter that throws.** A collector being down must never surface as a
+    500 on a user's request; that the `fetch` failure is swallowed is now a test
+    rather than a comment.
+
+  `TelemetryMiddleware` gained coverage for the root span every child span
+  attaches to: the `http.*` attributes, 5xx as error while 4xx stays ok (marking
+  404s as errors makes an error-rate dashboard useless), the span ending even when
+  no response was produced, and staying inert when no tracer is configured.
+  35 tests → 56.
+
+### Changed
+
+- **`NoopSpan` and `_randomHex` are marked `@internal`** — a null-object span and a
+  hex generator for trace ids, neither of them API. The promise is 12 exports, not 14.
+
+- **Maturity is now `stable`** — the public API follows SemVer strictly for the rest
+  of the 1.x line. Every promised export is documented, the output path is covered,
+  and the only dependency is `@zerotal/core`.
+
 ## [1.0.3] — 2026-08-07
 
 ### Changed

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@zerotal/telemetry",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "license": "MIT",
-  "maturity": "beta",
+  "maturity": "stable",
   "private": false,
   "type": "module",
   "main": "./src/index.ts",
@@ -29,7 +29,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@zerotal/core": "1.3.0"
+    "@zerotal/core": "1.5.0"
   },
   "devDependencies": {
     "typescript": "^5.8.0"

package/src/Span.ts

@@ -102,6 +102,8 @@ export class Span {
 /**
  * A span whose methods are all no-ops.
  * Used when telemetry is disabled so call sites never need null-checks.
+ *
+ * @internal
  */
 export class NoopSpan extends Span {
   constructor() {
@@ -127,6 +129,11 @@ export class NoopSpan extends Span {
 
 // ── Helpers ───────────────────────────────────────────────────────────────────
 
+/**
+ * Random hex for trace and span ids.
+ *
+ * @internal
+ */
 export function _randomHex(bytes: number): string {
   return Array.from(crypto.getRandomValues(new Uint8Array(bytes)))
     .map((b) => b.toString(16).padStart(2, "0"))