@nodii/telemetry 0.15.0 → 0.16.0

package/dist/hono/index.d.ts

@@ -0,0 +1,64 @@
+import type { Context, MiddlewareHandler } from "hono";
+/** Canonical inbound W3C trace-context header (lower-case; Hono headers are case-insensitive). */
+export declare const TRACEPARENT_HEADER = "traceparent";
+/** Options for {@link honoTelemetry}. */
+export interface HonoTelemetryOptions {
+    /**
+     * Honor an inbound W3C `traceparent` header so the SERVER span inherits
+     * the upstream `trace_id` (distributed trace continuity) instead of
+     * starting a fresh root trace. Default `true`.
+     *
+     * A malformed inbound traceparent does NOT throw — `tracer.span` starts a
+     * root span and records the raw value under
+     * `telemetry.inbound_traceparent_malformed` (see `tracer.ts`).
+     *
+     * Set `false` to always start the request as a fresh root SERVER span
+     * (e.g. when the edge is the trusted trace root and upstream values are
+     * not trustworthy).
+     */
+    honorInboundTraceparent?: boolean;
+    /**
+     * Header to read the inbound traceparent from. Defaults to `traceparent`.
+     */
+    traceparentHeader?: string;
+    /**
+     * Customize the SERVER span name. Defaults to the OTel HTTP-semconv
+     * low-cardinality form: `"<METHOD> <route-template>"` when Hono resolved
+     * a route template (e.g. `"GET /users/:id"`), else `"<METHOD>"`. Override
+     * for services that want a different naming scheme.
+     *
+     * Avoid putting the raw `url.path` in the span name — that is HIGH
+     * cardinality (one name per id) and the per-OTel-semconv reason the
+     * default uses the route template, not the concrete path.
+     */
+    spanName?: (c: Context) => string;
+    /**
+     * Extra static attributes stamped on every SERVER span (e.g. a deploy
+     * marker). Per-request attributes should be added by downstream handlers
+     * via `getActiveSpan()` / `withSpanAttributes`.
+     */
+    attributes?: Record<string, unknown>;
+}
+/**
+ * Hono middleware factory that opens ONE OTel SERVER span per HTTP request
+ * and runs the rest of the pipeline INSIDE that span's context, so:
+ *   - every inbound request emits an HTTP SERVER span even on `Bun.serve`
+ *     (which bypasses `@opentelemetry/instrumentation-http`) — D154;
+ *   - child business spans + pg-query/outbox spans nest under it (the span
+ *     is the active stack parent for the downstream scope);
+ *   - the OTel HTTP semantic-convention attributes are stamped
+ *     (`http.request.method`, `url.path`, `url.scheme`,
+ *     `http.response.status_code`, `http.route`, …);
+ *   - span status maps from the response: `5xx` → ERROR (D27), and a
+ *     thrown handler error is recorded + re-thrown so the framework's own
+ *     error handler still runs.
+ *
+ * Mount it FIRST in the pipeline (before auth / context) so it wraps the
+ * full request duration, mirroring edge's `requestContext()`:
+ *
+ *   import { honoTelemetry } from "@nodii/telemetry/hono";
+ *   const app = new Hono();
+ *   app.use("*", honoTelemetry());
+ */
+export declare function honoTelemetry(options?: HonoTelemetryOptions): MiddlewareHandler;
+//# sourceMappingURL=index.d.ts.map

package/dist/hono/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hono/index.ts"],"names":[],"mappings":"AAwCA,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAgBvD,kGAAkG;AAClG,eAAO,MAAM,kBAAkB,gBAAgB,CAAC;AAEhD,yCAAyC;AACzC,MAAM,WAAW,oBAAoB;IACnC;;;;;;;;;;;;OAYG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,MAAM,CAAC;IAClC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAyED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CAC3B,OAAO,GAAE,oBAAyB,GACjC,iBAAiB,CAmGnB"}

package/dist/hono/index.js

@@ -0,0 +1,217 @@
+// `@nodii/telemetry/hono` — the HTTP SERVER-span middleware for Bun-served
+// Hono apps (D154: HTTP auto-instrumentation ON-by-default).
+//
+// Spec: `global/15-telemetry-doctrine.md` § 7.1 (D154 — HTTP+gRPC server
+//       spans ON by default) + `nodii-libs/features/telemetry.md` § 5.9
+//       (Hono middleware adapter) + § 5.11 (auto-instrumentation defaults).
+//
+// WHY THIS EXISTS (the gap it closes):
+//   `@opentelemetry/instrumentation-http` works by monkey-patching Node's
+//   built-in `http`/`https` modules. `Bun.serve` does NOT route through
+//   those modules — it has its own native HTTP server — so the standard
+//   OTel HTTP instrumentation NEVER fires on a Bun process. Every
+//   Bun-based Nodii service (auth, hr, edge, …) therefore emits ZERO HTTP
+//   SERVER spans despite D154 mandating HTTP instrumentation on-by-default
+//   (verified empirically: auth 0 server spans, hr 0 server spans).
+//
+//   This middleware restores the D154 guarantee at the framework layer:
+//   one OTel SERVER span per inbound HTTP request, with the OTel HTTP
+//   semantic-convention attributes, run with the rest of the Hono pipeline
+//   nested INSIDE the span's context so child business spans (and the
+//   pg-query / outbox spans) parent correctly onto the request span.
+//
+//   It GENERALIZES the bespoke `edge.request` request-span bridge that
+//   `nodii-edge`'s `requestContext()` middleware hand-rolls today (see
+//   `nodii-edge/src/lib/middleware/request-context.ts`). Once a service
+//   adopts this adapter, edge can retire its private copy.
+//
+// REAL SPANS (R1): the span is produced by the lib's own `tracer.span`,
+// which routes through the mandatory-attribute SpanProcessor (D26) and the
+// installed OTLP exporter (`installOtlpAdapter` → `_setSpanEmitter`). There
+// is NO Noop path here — when no OTLP adapter is installed the span still
+// flows to whatever emitter is set (the default no-op emitter is a
+// TEST-ONLY seam, never a production default; production calls
+// `installOtlpAdapter`).
+//
+// SCOPE: TS only. Hono is a TypeScript framework, so this lives behind a
+// TS subpath exactly like `/lambda` + `/worker`. The Python (FastAPI /
+// starlette) and Go HTTP middleware are SEPARATE adapters in their
+// respective language trees (§ 5.9) and are OUT OF SCOPE for this file.
+import { ATTR_ERROR_TYPE, ATTR_HTTP_REQUEST_METHOD, ATTR_HTTP_RESPONSE_STATUS_CODE, ATTR_HTTP_ROUTE, ATTR_NETWORK_PROTOCOL_VERSION, ATTR_SERVER_ADDRESS, ATTR_URL_PATH, ATTR_URL_QUERY, ATTR_URL_SCHEME, ATTR_USER_AGENT_ORIGINAL, } from "@opentelemetry/semantic-conventions";
+import { tracer } from "../tracer.js";
+/** Canonical inbound W3C trace-context header (lower-case; Hono headers are case-insensitive). */
+export const TRACEPARENT_HEADER = "traceparent";
+/** Prefer the proxy-forwarded scheme; fall back to the request URL; default `https`. */
+function urlScheme(c) {
+    const fwd = c.req.header("x-forwarded-proto");
+    if (fwd) {
+        const first = fwd.split(",")[0];
+        if (first)
+            return first.trim();
+    }
+    try {
+        return new URL(c.req.url).protocol.replace(":", "");
+    }
+    catch {
+        return "https";
+    }
+}
+/** The `url.query` component (without the leading `?`), or undefined when absent. */
+function urlQuery(c) {
+    try {
+        const q = new URL(c.req.url).search;
+        return q ? q.slice(1) : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Resolve the low-cardinality route TEMPLATE for the request (e.g.
+ * `/users/:id`), or `undefined` when no concrete handler route matched
+ * (e.g. a 404, where only the `/*` middleware route is present).
+ *
+ * `c.req.routePath` is only meaningful AFTER `next()` (once the matching
+ * handler has run). Because this middleware needs the template at
+ * span-OPEN (before `next()`), it reads `c.req.matchedRoutes` — which Hono
+ * populates at match time, before dispatch — and takes the most specific
+ * matched route: the last one whose path is NOT a `/*` / `/` middleware
+ * wildcard and whose method is NOT the `ALL` middleware pseudo-method.
+ */
+function resolveRouteTemplate(c) {
+    const matched = c.req
+        .matchedRoutes;
+    if (Array.isArray(matched)) {
+        for (let i = matched.length - 1; i >= 0; i--) {
+            const r = matched[i];
+            const p = r?.path;
+            if (p && p !== "/*" && p !== "/" && r?.method !== "ALL")
+                return p;
+        }
+        return undefined;
+    }
+    // Fallback for Hono builds without `matchedRoutes`: `routePath` (only set
+    // post-match, so this path is for the post-`next()` re-read).
+    const route = c.req.routePath;
+    if (route && route !== "/*" && route !== "/")
+        return route;
+    return undefined;
+}
+/**
+ * Default SERVER span name per OTel HTTP semconv: `"<METHOD> <route>"`
+ * (low cardinality — uses the route TEMPLATE, never the concrete path)
+ * when Hono matched a concrete handler route, else just `"<METHOD>"`.
+ */
+function defaultSpanName(c) {
+    const method = c.req.method;
+    const route = resolveRouteTemplate(c);
+    return route ? `${method} ${route}` : method;
+}
+/**
+ * Hono middleware factory that opens ONE OTel SERVER span per HTTP request
+ * and runs the rest of the pipeline INSIDE that span's context, so:
+ *   - every inbound request emits an HTTP SERVER span even on `Bun.serve`
+ *     (which bypasses `@opentelemetry/instrumentation-http`) — D154;
+ *   - child business spans + pg-query/outbox spans nest under it (the span
+ *     is the active stack parent for the downstream scope);
+ *   - the OTel HTTP semantic-convention attributes are stamped
+ *     (`http.request.method`, `url.path`, `url.scheme`,
+ *     `http.response.status_code`, `http.route`, …);
+ *   - span status maps from the response: `5xx` → ERROR (D27), and a
+ *     thrown handler error is recorded + re-thrown so the framework's own
+ *     error handler still runs.
+ *
+ * Mount it FIRST in the pipeline (before auth / context) so it wraps the
+ * full request duration, mirroring edge's `requestContext()`:
+ *
+ *   import { honoTelemetry } from "@nodii/telemetry/hono";
+ *   const app = new Hono();
+ *   app.use("*", honoTelemetry());
+ */
+export function honoTelemetry(options = {}) {
+    const honorInbound = options.honorInboundTraceparent ?? true;
+    const traceparentHeader = options.traceparentHeader ?? TRACEPARENT_HEADER;
+    const nameOf = options.spanName ?? defaultSpanName;
+    const staticAttrs = options.attributes;
+    return async (c, next) => {
+        const inboundTraceparent = honorInbound
+            ? c.req.header(traceparentHeader)
+            : undefined;
+        // Build the entry attributes per the OTel HTTP semconv. Status code +
+        // route are set AFTER `next()` (route may only resolve once matched;
+        // status is the response status).
+        const scheme = urlScheme(c);
+        const query = urlQuery(c);
+        const host = c.req.header("host");
+        const userAgent = c.req.header("user-agent");
+        const entryAttrs = {
+            [ATTR_HTTP_REQUEST_METHOD]: c.req.method,
+            [ATTR_URL_PATH]: c.req.path,
+            [ATTR_URL_SCHEME]: scheme,
+            ...(query !== undefined ? { [ATTR_URL_QUERY]: query } : {}),
+            ...(host ? { [ATTR_SERVER_ADDRESS]: host } : {}),
+            ...(userAgent ? { [ATTR_USER_AGENT_ORIGINAL]: userAgent } : {}),
+            [ATTR_NETWORK_PROTOCOL_VERSION]: "1.1",
+            ...(staticAttrs ?? {}),
+        };
+        await tracer.span(
+        // Span name is resolved at span-OPEN against the request line; the
+        // route template is also stamped post-`next()` once matched.
+        nameOf(c), async (span) => {
+            // Run the rest of the Hono pipeline INSIDE the SERVER span so
+            // downstream `tracer.span` calls nest under it (the lib's active
+            // span stack makes this span the parent for the downstream scope).
+            //
+            // NOTE on error capture: when a handler throws, Hono CATCHES it
+            // inside its own dispatch (compose) — whether or not an `onError`
+            // handler is registered — sets `c.error` + a 500 response, and
+            // `next()` RESOLVES normally (it does NOT re-throw past us). So the
+            // canonical way to observe the handler exception from middleware is
+            // `c.error` after `next()`, NOT a try/catch here. The try/catch is
+            // kept as a belt-and-suspenders for the rare case where an error
+            // genuinely propagates out of `next()` (e.g. a middleware that
+            // throws AFTER the response is built).
+            try {
+                await next();
+            }
+            catch (err) {
+                span.recordException(err);
+                span.setAttribute(ATTR_ERROR_TYPE, err instanceof Error ? err.name : "Error");
+                throw err;
+            }
+            // Post-pipeline: stamp the resolved route template + response
+            // status.
+            const route = resolveRouteTemplate(c);
+            if (route)
+                span.setAttribute(ATTR_HTTP_ROUTE, route);
+            // Capture the handler exception Hono stashed on `c.error` (present
+            // in both the `onError` and default-500 paths). This records the
+            // real `exception` span event + sets ERROR status per D27 — the
+            // information `instrumentation-http` would have captured.
+            const handlerError = c.error;
+            if (handlerError) {
+                span.recordException(handlerError);
+                span.setAttribute(ATTR_ERROR_TYPE, handlerError instanceof Error ? handlerError.name : "Error");
+                span.setStatus("ERROR");
+            }
+            const status = c.res.status;
+            span.setAttribute(ATTR_HTTP_RESPONSE_STATUS_CODE, status);
+            // D27 HTTP status mapping: 5xx → ERROR; 4xx is a client error and
+            // stays UNSET (the server behaved correctly). `error.type` carries
+            // the status string on 5xx for filterable error analytics. (When a
+            // handler exception was already recorded above, the span is ERROR
+            // regardless; the status-derived `error.type` still applies on 5xx.)
+            if (status >= 500) {
+                span.setAttribute(ATTR_ERROR_TYPE, String(status));
+                span.setStatus("ERROR", `http_status_${status}`);
+            }
+        }, {
+            kind: "SERVER",
+            attributes: entryAttrs,
+            // Inherit the inbound trace when present (distributed continuity);
+            // malformed values fall back to root + a forensic attr (no throw).
+            ...(inboundTraceparent ? { parent: inboundTraceparent } : {}),
+        });
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/hono/index.js.map

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

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA6BA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EACL,UAAU,EACV,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EACV,WAAW,EACX,aAAa,EACb,OAAO,EACP,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,YAAY,EACV,oBAAoB,EACpB,IAAI,EACJ,QAAQ,EACR,WAAW,EACX,UAAU,EACV,UAAU,EACV,UAAU,GACX,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5E,YAAY,EACV,aAAa,EACb,WAAW,EACX,eAAe,EACf,UAAU,EACV,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,wBAAwB,EACxB,gCAAgC,EAChC,yBAAyB,EACzB,cAAc,EACd,eAAe,EACf,8BAA8B,EAC9B,KAAK,EACL,iBAAiB,EACjB,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,SAAS,EACT,UAAU,EACV,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,YAAY,EACZ,WAAW,EACX,0BAA0B,GAC3B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,YAAY,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,UAAU,EACV,cAAc,EACd,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,cAAc,EACd,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,YAAY,EACV,SAAS,EACT,sBAAsB,EACtB,oBAAoB,EACpB,yBAAyB,EACzB,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,qBAAqB,EACrB,wBAAwB,EACxB,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAmCA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EACL,UAAU,EACV,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EACV,WAAW,EACX,aAAa,EACb,OAAO,EACP,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,YAAY,EACV,oBAAoB,EACpB,IAAI,EACJ,QAAQ,EACR,WAAW,EACX,UAAU,EACV,UAAU,EACV,UAAU,GACX,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5E,YAAY,EACV,aAAa,EACb,WAAW,EACX,eAAe,EACf,UAAU,EACV,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,wBAAwB,EACxB,gCAAgC,EAChC,yBAAyB,EACzB,cAAc,EACd,eAAe,EACf,8BAA8B,EAC9B,KAAK,EACL,iBAAiB,EACjB,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,SAAS,EACT,UAAU,EACV,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,YAAY,EACZ,WAAW,EACX,0BAA0B,GAC3B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,YAAY,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,UAAU,EACV,cAAc,EACd,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,cAAc,EACd,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,YAAY,EACV,SAAS,EACT,sBAAsB,EACtB,oBAAoB,EACpB,yBAAyB,EACzB,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,qBAAqB,EACrB,wBAAwB,EACxB,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -13,6 +13,12 @@
 //                                 force-flush-on-return so spans/metrics/
 //                                 logs survive the post-handler freeze.
 //                                 First consumer: s2s-auth-service.
+//   - @nodii/telemetry/hono     — HTTP SERVER-span middleware (D154). One
+//                                 OTel SERVER span per request for Bun-served
+//                                 Hono apps, which `instrumentation-http`
+//                                 BYPASSES (Bun.serve doesn't use Node http).
+//                                 Generalizes edge's bespoke `edge.request`
+//                                 request-span bridge. TS-only subpath.
 //
 // Not yet shipped (D44 § 6.5 lists them; no implementation exists yet —
 // they are tracked as follow-on requests, NOT advertised as vapor):

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,EAAE;AACF,0EAA0E;AAC1E,EAAE;AACF,0EAA0E;AAC1E,yEAAyE;AACzE,4EAA4E;AAC5E,2EAA2E;AAC3E,4EAA4E;AAC5E,wEAAwE;AACxE,0EAA0E;AAC1E,mEAAmE;AACnE,0EAA0E;AAC1E,wEAAwE;AACxE,oEAAoE;AACpE,EAAE;AACF,wEAAwE;AACxE,oEAAoE;AACpE,uEAAuE;AACvE,8DAA8D;AAC9D,mDAAmD;AACnD,EAAE;AACF,oEAAoE;AACpE,gBAAgB;AAChB,EAAE;AACF,oEAAoE;AACpE,gEAAgE;AAChE,0DAA0D;AAE1D,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EACL,UAAU,EACV,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAOnD,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAWjD,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAS5E,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,wBAAwB,EACxB,gCAAgC,EAChC,yBAAyB,EACzB,cAAc,EACd,eAAe,EACf,8BAA8B,EAC9B,KAAK,EACL,iBAAiB,EACjB,cAAc,GACf,MAAM,YAAY,CAAC;AAYpB,OAAO,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,EAAE,MAAM,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,UAAU,EACV,cAAc,EACd,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,cAAc,EACd,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AA0BrD,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,EAAE;AACF,0EAA0E;AAC1E,EAAE;AACF,0EAA0E;AAC1E,yEAAyE;AACzE,4EAA4E;AAC5E,2EAA2E;AAC3E,4EAA4E;AAC5E,wEAAwE;AACxE,0EAA0E;AAC1E,mEAAmE;AACnE,0EAA0E;AAC1E,wEAAwE;AACxE,oEAAoE;AACpE,0EAA0E;AAC1E,8EAA8E;AAC9E,0EAA0E;AAC1E,8EAA8E;AAC9E,4EAA4E;AAC5E,wEAAwE;AACxE,EAAE;AACF,wEAAwE;AACxE,oEAAoE;AACpE,uEAAuE;AACvE,8DAA8D;AAC9D,mDAAmD;AACnD,EAAE;AACF,oEAAoE;AACpE,gBAAgB;AAChB,EAAE;AACF,oEAAoE;AACpE,gEAAgE;AAChE,0DAA0D;AAE1D,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EACL,UAAU,EACV,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAOnD,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAWjD,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAS5E,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,wBAAwB,EACxB,gCAAgC,EAChC,yBAAyB,EACzB,cAAc,EACd,eAAe,EACf,8BAA8B,EAC9B,KAAK,EACL,iBAAiB,EACjB,cAAc,GACf,MAAM,YAAY,CAAC;AAYpB,OAAO,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,EAAE,MAAM,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,UAAU,EACV,cAAc,EACd,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,cAAc,EACd,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AA0BrD,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,YAAY,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodii/telemetry",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "Substrate observability library for the Nodii microservice stack — OTel wrapper, log envelope, intent lifecycle, audit signal, agent registry, context propagation. Spec: planning hub docKey=telemetry.",
   "license": "MIT",
   "type": "module",
@@ -27,6 +27,10 @@
       "types": "./dist/lambda/index.d.ts",
       "default": "./dist/lambda/index.js"
     },
+    "./hono": {
+      "types": "./dist/hono/index.d.ts",
+      "default": "./dist/hono/index.js"
+    },
     "./worker": {
       "types": "./dist/worker/index.d.ts",
       "default": "./dist/worker/index.js"