brass-runtime 1.16.0 → 1.17.0

package/dist/observability/index.js

@@ -1,3 +1,19 @@
+import {
+  HTTP_OBSERVABILITY_CONTRACT,
+  makeExpressRequestObservabilityContext,
+  makeFastifyRequestObservabilityContext,
+  makeFetchRequestObservabilityContext,
+  makeHttpObservabilityMiddleware,
+  makeNodeRequestObservabilityContext,
+  makeNoopObservability,
+  makeObservabilityFromEnv,
+  makeObservabilityPreset,
+  observabilityOptionsForPreset,
+  observabilityOptionsFromEnv,
+  withFetchRequestObservability,
+  withHttpObservability,
+  withNodeRequestObservability
+} from "../chunk-VWIPB6I5.js";
 import {
   OTLP_JSON_CONTENT_TYPE,
   PROMETHEUS_CONTENT_TYPE,
@@ -25,6 +41,7 @@ import {
   makeOtlpHttpLogExporter,
   makeOtlpHttpMetricsExporter,
   makeOtlpHttpSpanExporter,
+  makeOtlpOptions,
   makePrometheusMetricsExporter,
   makeRequestObservabilityContext,
   makeRuntimeHealth,
@@ -60,546 +77,15 @@ import {
   withLogContext,
   withSpan,
   withTimeout
-} from "../chunk-7XOPAB5Q.js";
-import "../chunk-XDZOO4L5.js";
-import {
-  getCurrentFiber
-} from "../chunk-7LVI2GIN.js";
-import {
-  asyncFail,
-  asyncFlatMap,
-  asyncFold,
-  asyncSucceed,
-  asyncSync
-} from "../chunk-PNVFW245.js";
-import "../chunk-TDVMADDN.js";
+} from "../chunk-BKK77SBA.js";
+import "../chunk-RKGKFN2A.js";
+import "../chunk-3Y2RIUMM.js";
+import "../chunk-FH2X7BVP.js";
+import "../chunk-UB4B6OFY.js";
+import "../chunk-C3MDXTRZ.js";
 import "../chunk-3RG5ZIWI.js";
-
-// src/observability/http.ts
-var DEFAULT_DURATION_BUCKETS = [1, 5, 10, 25, 50, 100, 250, 500, 1e3, 2500, 5e3, 1e4];
-function withHttpObservability(options) {
-  const resolved = resolveHttpObservabilityOptions(options);
-  return (next) => {
-    return (req) => {
-      const run = asyncFlatMap(
-        beginHttpObservation(req, resolved),
-        (state) => asyncFlatMap(
-          logHttpRequest(req, resolved),
-          () => asyncFlatMap(
-            prepareHttpRequest(req, resolved),
-            (wireReq) => asyncFold(
-              next(wireReq),
-              (error) => {
-                const finish = state.finishWithError(error);
-                const adaptiveLimiterAttrs = observeAdaptiveLimiter(wireReq, next, resolved);
-                return asyncFlatMap(
-                  spanEvent("http.client.error", {
-                    ...finish.spanAttributes,
-                    ...adaptiveLimiterAttrs,
-                    "error.type": error._tag
-                  }),
-                  () => asyncFlatMap(logHttpError(req, error, finish, resolved), () => asyncFail(error))
-                );
-              },
-              (res) => {
-                const finish = state.finishWithResponse(res);
-                const adaptiveLimiterAttrs = observeAdaptiveLimiter(wireReq, next, resolved);
-                return asyncFlatMap(
-                  spanEvent("http.client.response", {
-                    ...finish.spanAttributes,
-                    ...adaptiveLimiterAttrs
-                  }),
-                  () => asyncFlatMap(logHttpResponse(req, res, finish, resolved), () => asyncSucceed(res))
-                );
-              }
-            )
-          )
-        )
-      );
-      if (resolved.spans === false) return run;
-      return withSpan(spanName(req, resolved.spans), run, spanStartAttributes(req, resolved));
-    };
-  };
-}
-var makeHttpObservabilityMiddleware = withHttpObservability;
-function beginHttpObservation(req, options) {
-  return asyncSync(() => {
-    const startedAt = options.clock();
-    let finished = false;
-    const inFlight = options.metrics?.gauge("brass_http_client_in_flight", requestBaseLabels(req, options));
-    inFlight?.increment();
-    const finish = (outcome, status, extra = {}) => {
-      const durationMs = Math.max(0, options.clock() - startedAt);
-      const labels = requestFinishLabels(req, outcome, status, options);
-      if (!finished) {
-        finished = true;
-        if (inFlight && inFlight.value() > 0) inFlight.decrement();
-        options.metrics?.counter("brass_http_client_requests_total", labels).increment();
-        options.metrics?.histogram("brass_http_client_duration_ms", [...options.durationBuckets ?? DEFAULT_DURATION_BUCKETS], labels).observe(durationMs, currentTraceExemplar(durationMs, startedAt + durationMs));
-      }
-      return {
-        durationMs,
-        outcome,
-        labels,
-        spanAttributes: {
-          "http.duration_ms": durationMs,
-          "http.outcome": outcome,
-          ...status ? { "http.status_code": Number(status) } : {},
-          ...status ? { "http.response.status_code": Number(status) } : {},
-          ...extra
-        }
-      };
-    };
-    const fiber = getCurrentFiber();
-    fiber?.addFinalizer?.(() => {
-      finish("abort", void 0, { "http.cancelled": true });
-    });
-    return {
-      finishWithResponse: (res) => finish(httpStatusOutcome(res.status), String(res.status)),
-      finishWithError: (error) => finish(httpErrorOutcome(error), void 0, { "error.type": error._tag })
-    };
-  });
-}
-function prepareHttpRequest(req, options) {
-  if (!options.injectTraceHeaders) return asyncSucceed(req);
-  return asyncSync(() => injectCurrentTraceContext(req));
-}
-function logHttpRequest(req, options) {
-  const level = options.logs === false ? false : options.logs.requestLevel ?? false;
-  if (!level) return asyncSucceed(void 0);
-  return logEffect(level, "http.client.request", requestLogFields(req, options));
-}
-function logHttpResponse(req, res, finish, options) {
-  const configured = options.logs === false ? false : options.logs.responseLevel ?? false;
-  const level = configured || (finish.outcome === "error" ? options.logs !== false ? options.logs.errorLevel ?? "warn" : false : false);
-  if (!level) return asyncSucceed(void 0);
-  return logEffect(level, "http.client.response", {
-    ...requestLogFields(req, options),
-    status: res.status,
-    statusText: res.statusText,
-    outcome: finish.outcome,
-    durationMs: finish.durationMs
-  });
-}
-function logHttpError(req, error, finish, options) {
-  const level = options.logs === false ? false : options.logs.errorLevel ?? "error";
-  if (!level) return asyncSucceed(void 0);
-  return logEffect(level, "http.client.error", {
-    ...requestLogFields(req, options),
-    outcome: finish.outcome,
-    durationMs: finish.durationMs,
-    errorTag: error._tag,
-    message: httpErrorMessage(error)
-  });
-}
-function resolveHttpObservabilityOptions(options) {
-  const maybeObservability = options && "eventBus" in options && "prometheus" in options ? options : void 0;
-  const raw = maybeObservability ? { metrics: maybeObservability.metrics } : options;
-  return {
-    metrics: raw?.metrics === false ? void 0 : raw?.metrics,
-    logs: raw?.logs ?? {},
-    spans: raw?.spans ?? {},
-    adaptiveLimiter: resolveAdaptiveLimiterObservabilityOptions(raw?.adaptiveLimiter),
-    injectTraceHeaders: raw?.injectTraceHeaders ?? true,
-    includeHostLabel: raw?.includeHostLabel ?? true,
-    route: raw?.route,
-    clock: raw?.clock ?? Date.now,
-    durationBuckets: raw?.durationBuckets
-  };
-}
-function resolveAdaptiveLimiterObservabilityOptions(options) {
-  if (options === false) return { enabled: false, includeKeyLabel: false };
-  if (options === true || options === void 0) return { enabled: true, includeKeyLabel: false };
-  return {
-    enabled: options.enabled ?? true,
-    includeKeyLabel: options.includeKeyLabel ?? false
-  };
-}
-function observeAdaptiveLimiter(req, next, options) {
-  if (!options.adaptiveLimiter.enabled) return {};
-  const limiter = adaptiveLimiterOf(next);
-  if (!limiter || !options.metrics && options.spans === false) return {};
-  const stats = limiter.stats();
-  const labels = adaptiveLimiterLabels(req, stats, options);
-  setGauge(options.metrics, "brass_http_adaptive_limiter_limit", stats.limit, labels);
-  setGauge(options.metrics, "brass_http_adaptive_limiter_in_flight", stats.inFlight, labels);
-  setGauge(options.metrics, "brass_http_adaptive_limiter_queue_depth", stats.queueDepth, labels);
-  setGauge(options.metrics, "brass_http_adaptive_limiter_state_count", stats.stateCount, labels);
-  setGauge(options.metrics, "brass_http_adaptive_limiter_utilization", stats.utilization, labels);
-  setGauge(options.metrics, "brass_http_adaptive_limiter_error_rate", stats.errorRate, labels);
-  setGauge(options.metrics, "brass_http_adaptive_limiter_requests_per_second", stats.requestsPerSecond, labels);
-  setGauge(options.metrics, "brass_http_adaptive_limiter_completions_per_second", stats.completionsPerSecond, labels);
-  setGauge(options.metrics, "brass_http_adaptive_limiter_rejection_rate", stats.rejectionRate, labels);
-  return compactSpanAttributes({
-    "http.adaptive_limiter.limit": stats.limit,
-    "http.adaptive_limiter.in_flight": stats.inFlight,
-    "http.adaptive_limiter.queue_depth": stats.queueDepth,
-    "http.adaptive_limiter.state_count": stats.stateCount,
-    "http.adaptive_limiter.utilization": stats.utilization,
-    "http.adaptive_limiter.error_rate": stats.errorRate,
-    "http.adaptive_limiter.requests_per_second": stats.requestsPerSecond,
-    "http.adaptive_limiter.completions_per_second": stats.completionsPerSecond,
-    "http.adaptive_limiter.rejection_rate": stats.rejectionRate
-  });
-}
-function adaptiveLimiterOf(next) {
-  const limiter = next.adaptiveLimiter;
-  return limiter && typeof limiter.stats === "function" ? limiter : void 0;
-}
-function adaptiveLimiterLabels(req, stats, options) {
-  const key = options.adaptiveLimiter.includeKeyLabel ? inferAdaptiveLimiterKey(req, stats) : void 0;
-  return compactLabels({
-    ...requestBaseLabels(req, options),
-    key
-  });
-}
-function inferAdaptiveLimiterKey(req, stats) {
-  if (req.poolKey) return req.poolKey;
-  const host = requestHost(req);
-  if (host) return host;
-  return stats.keys?.length === 1 ? stats.keys[0] : void 0;
-}
-function setGauge(metrics, name, value, labels) {
-  if (!metrics || value === void 0 || !Number.isFinite(value)) return;
-  metrics.gauge(name, labels).set(value);
-}
-function compactSpanAttributes(attrs) {
-  const out = {};
-  for (const [key, value] of Object.entries(attrs)) {
-    if (value !== void 0 && Number.isFinite(value)) out[key] = value;
-  }
-  return out;
-}
-function spanName(req, options) {
-  if (options && options.name) {
-    return typeof options.name === "function" ? options.name(req) : options.name;
-  }
-  return `HTTP ${req.method}`;
-}
-function spanStartAttributes(req, options) {
-  const spanOptions = options.spans === false ? {} : options.spans.attributes;
-  const custom = typeof spanOptions === "function" ? spanOptions(req) : spanOptions ?? {};
-  const host = requestHost(req);
-  const route = requestRoute(req, options);
-  return {
-    "span.kind": "client",
-    "http.method": req.method,
-    "http.request.method": req.method,
-    "http.url": sanitizeUrl(req.url),
-    "url.full": sanitizeUrl(req.url),
-    ...urlScheme(req.url) ? { "url.scheme": urlScheme(req.url) } : {},
-    ...urlPath(req.url) ? { "url.path": urlPath(req.url) } : {},
-    ...host ? { "server.address": host } : {},
-    ...route ? { "http.route": route } : {},
-    ...custom
-  };
-}
-function requestBaseLabels(req, options) {
-  return compactLabels({
-    method: req.method,
-    ...options.includeHostLabel ? { host: requestHost(req) } : {},
-    ...requestRoute(req, options) ? { route: requestRoute(req, options) } : {}
-  });
-}
-function requestFinishLabels(req, outcome, status, options) {
-  return {
-    ...requestBaseLabels(req, options),
-    outcome,
-    status: status ?? "none"
-  };
-}
-function requestLogFields(req, options) {
-  const host = requestHost(req);
-  const route = requestRoute(req, options);
-  return {
-    method: req.method,
-    url: sanitizeUrl(req.url),
-    ...host ? { host } : {},
-    ...route ? { route } : {}
-  };
-}
-function requestRoute(req, options) {
-  if (typeof options.route === "function") return options.route(req);
-  return options.route;
-}
-function httpStatusOutcome(status) {
-  return status >= 400 ? "error" : "success";
-}
-function httpErrorOutcome(error) {
-  switch (error._tag) {
-    case "Abort":
-      return "abort";
-    case "BadUrl":
-      return "bad_url";
-    case "FetchError":
-      return "fetch_error";
-    case "Timeout":
-      return "timeout";
-    case "PoolRejected":
-      return "pool_rejected";
-    case "PoolTimeout":
-      return "pool_timeout";
-    case "PoolClosed":
-      return "pool_closed";
-    case "BatchSplitError":
-      return "batch_split_error";
-  }
-}
-function httpErrorMessage(error) {
-  return "message" in error ? error.message : void 0;
-}
-function injectCurrentTraceContext(req) {
-  const fiber = getCurrentFiber();
-  const trace = fiber?.fiberContext?.trace;
-  if (!trace?.traceId || !trace?.spanId) return req;
-  return {
-    ...req,
-    headers: injectTraceContext(req.headers, trace)
-  };
-}
-function currentTraceExemplar(value, timestamp) {
-  const fiber = getCurrentFiber();
-  return exemplarFromTraceContext(fiber?.fiberContext?.trace, value, timestamp);
-}
-function requestHost(req) {
-  try {
-    return new URL(req.url).host;
-  } catch {
-    return void 0;
-  }
-}
-function urlScheme(url) {
-  try {
-    return new URL(url).protocol.replace(/:$/, "");
-  } catch {
-    return void 0;
-  }
-}
-function urlPath(url) {
-  try {
-    return new URL(url).pathname;
-  } catch {
-    return void 0;
-  }
-}
-function sanitizeUrl(url) {
-  try {
-    const parsed = new URL(url);
-    parsed.search = "";
-    parsed.hash = "";
-    return parsed.toString();
-  } catch {
-    const [withoutHash] = url.split("#", 1);
-    const [withoutQuery] = withoutHash.split("?", 1);
-    return withoutQuery;
-  }
-}
-function compactLabels(labels) {
-  const out = {};
-  for (const [key, value] of Object.entries(labels)) {
-    if (value !== void 0 && value !== "") out[key] = value;
-  }
-  return out;
-}
-
-// src/observability/adapters.ts
-function makeFetchRequestObservabilityContext(observability, request, input = {}) {
-  return makeRequestObservabilityContext(observability, {
-    headers: request.headers,
-    method: request.method,
-    target: sanitizeHttpTarget(request.url),
-    route: input.route ?? normalizeHttpRoute(urlPathname(request.url)),
-    ...input
-  });
-}
-function makeNodeRequestObservabilityContext(observability, request, input = {}) {
-  return makeRequestObservabilityContext(observability, {
-    headers: request.headers,
-    method: request.method,
-    target: sanitizeHttpTarget(request.url),
-    route: input.route ?? normalizeHttpRoute(request.url),
-    ...input
-  });
-}
-function makeExpressRequestObservabilityContext(observability, request, input = {}) {
-  return makeRequestObservabilityContext(observability, {
-    headers: request.headers,
-    method: request.method,
-    target: sanitizeHttpTarget(request.originalUrl ?? request.url),
-    route: input.route ?? request.route?.path ?? normalizeHttpRoute(request.path ?? request.url),
-    ...input
-  });
-}
-function makeFastifyRequestObservabilityContext(observability, request, input = {}) {
-  return makeRequestObservabilityContext(observability, {
-    headers: request.headers,
-    method: request.method,
-    target: sanitizeHttpTarget(request.url),
-    route: input.route ?? request.routeOptions?.url ?? request.routerPath ?? normalizeHttpRoute(request.url),
-    ...input
-  });
-}
-function withFetchRequestObservability(observability, handler, input = {}) {
-  return async (request) => handler(makeFetchRequestObservabilityContext(observability, request, input), request);
-}
-function withNodeRequestObservability(observability, handler, input = {}) {
-  return async (request) => handler(makeNodeRequestObservabilityContext(observability, request, input), request);
-}
-function urlPathname(url) {
-  if (!url) return void 0;
-  try {
-    return new URL(url, "http://local").pathname;
-  } catch {
-    return url;
-  }
-}
-
-// src/observability/config.ts
-function makeNoopObservability() {
-  return makeObservability({
-    metrics: false,
-    logs: false,
-    traces: false,
-    autoStart: false
-  });
-}
-function makeObservabilityPreset(preset, overrides = {}) {
-  if (preset === "disabled") return makeNoopObservability();
-  return makeObservability(mergeObservabilityOptions(observabilityOptionsForPreset(preset), overrides));
-}
-function makeObservabilityFromEnv(env = readProcessEnv(), overrides = {}) {
-  const preset = env.BRASS_OBSERVABILITY === "disabled" ? "disabled" : parsePreset(env.BRASS_OBSERVABILITY_PRESET ?? env.NODE_ENV);
-  if (preset === "disabled") return makeNoopObservability();
-  return makeObservability(mergeObservabilityOptions(observabilityOptionsFromEnv(env, preset), overrides));
-}
-function observabilityOptionsForPreset(preset) {
-  switch (preset) {
-    case "production":
-      return {
-        logs: { minLevel: "info" },
-        sampling: { ratio: 1, respectRemoteSampled: true, forceSampleOnError: true },
-        redaction: {},
-        cardinality: { maxValuesPerLabel: 100 },
-        otlp: {
-          timeoutMs: 1e4,
-          retry: { attempts: 3, initialDelayMs: 100, maxDelayMs: 2e3 },
-          pipeline: {
-            maxQueueSize: 1e4,
-            batchSize: 512,
-            dropPolicy: "drop-oldest",
-            shutdownTimeoutMs: 1e4
-          }
-        },
-        flushIntervalMs: 1e4,
-        autoStart: true
-      };
-    case "test":
-      return {
-        logs: false,
-        sampling: 1,
-        redaction: {},
-        otlp: {
-          timeoutMs: 1e3,
-          retry: { attempts: 1 },
-          pipeline: { maxQueueSize: 1e3, batchSize: 256, shutdownTimeoutMs: 1e3 }
-        },
-        autoStart: false
-      };
-    case "development":
-      return {
-        logs: { minLevel: "debug" },
-        sampling: 1,
-        redaction: {},
-        cardinality: { maxValuesPerLabel: 100 },
-        autoStart: false
-      };
-  }
-}
-function observabilityOptionsFromEnv(env = readProcessEnv(), preset = parsePreset(env.BRASS_OBSERVABILITY_PRESET ?? env.NODE_ENV)) {
-  const base = observabilityOptionsForPreset(preset);
-  const serviceName = env.OTEL_SERVICE_NAME ?? env.BRASS_SERVICE_NAME;
-  const serviceVersion = env.OTEL_SERVICE_VERSION ?? env.BRASS_SERVICE_VERSION;
-  const endpoint = trimTrailingSlash(env.OTEL_EXPORTER_OTLP_ENDPOINT);
-  const metricsUrl = env.OTEL_EXPORTER_OTLP_METRICS_ENDPOINT ?? (endpoint ? `${endpoint}/v1/metrics` : void 0);
-  const tracesUrl = env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT ?? (endpoint ? `${endpoint}/v1/traces` : void 0);
-  const logsUrl = env.OTEL_EXPORTER_OTLP_LOGS_ENDPOINT ?? (endpoint ? `${endpoint}/v1/logs` : void 0);
-  const headers = parseHeaders(env.OTEL_EXPORTER_OTLP_HEADERS);
-  const flushIntervalMs = parsePositiveInt(env.BRASS_OBSERVABILITY_FLUSH_INTERVAL_MS);
-  const timeoutMs = parsePositiveInt(env.BRASS_OBSERVABILITY_EXPORT_TIMEOUT_MS);
-  const sampleRatio = parseRatio(env.BRASS_TRACE_SAMPLE_RATIO ?? env.OTEL_TRACES_SAMPLER_ARG);
-  const minLevel = env.BRASS_OBSERVABILITY_LOG_LEVEL;
-  const otlp = {
-    ...base.otlp ?? {},
-    ...metricsUrl ? { metricsUrl } : {},
-    ...tracesUrl ? { tracesUrl } : {},
-    ...logsUrl ? { logsUrl } : {},
-    ...headers ? { headers } : {},
-    ...timeoutMs ? { timeoutMs } : {}
-  };
-  return mergeObservabilityOptions(base, {
-    ...serviceName ? { serviceName } : {},
-    ...serviceVersion ? { serviceVersion } : {},
-    ...Object.keys(otlp).length > 0 ? { otlp } : {},
-    ...flushIntervalMs ? { flushIntervalMs, autoStart: true } : {},
-    ...sampleRatio !== void 0 ? { sampling: { ratio: sampleRatio, respectRemoteSampled: true, forceSampleOnError: true } } : {},
-    ...minLevel === "debug" || minLevel === "info" || minLevel === "warn" || minLevel === "error" ? { logs: { minLevel } } : {}
-  });
-}
-function mergeObservabilityOptions(base, overrides) {
-  return {
-    ...base,
-    ...overrides,
-    metrics: overrides.metrics ?? base.metrics,
-    logs: overrides.logs ?? base.logs,
-    otlp: {
-      ...base.otlp ?? {},
-      ...overrides.otlp ?? {},
-      retry: overrides.otlp?.retry ?? base.otlp?.retry,
-      pipeline: {
-        ...base.otlp?.pipeline ?? {},
-        ...overrides.otlp?.pipeline ?? {}
-      }
-    }
-  };
-}
-function parsePreset(value) {
-  if (value === "production" || value === "prod") return "production";
-  if (value === "test") return "test";
-  return "development";
-}
-function parseHeaders(value) {
-  if (!value) return void 0;
-  const out = {};
-  for (const part of value.split(",")) {
-    const index = part.indexOf("=");
-    if (index <= 0) continue;
-    const key = part.slice(0, index).trim();
-    const headerValue = part.slice(index + 1).trim();
-    if (key) out[key] = headerValue;
-  }
-  return Object.keys(out).length > 0 ? out : void 0;
-}
-function parsePositiveInt(value) {
-  if (!value) return void 0;
-  const parsed = Number.parseInt(value, 10);
-  return Number.isFinite(parsed) && parsed > 0 ? parsed : void 0;
-}
-function parseRatio(value) {
-  if (!value) return void 0;
-  const parsed = Number.parseFloat(value);
-  if (!Number.isFinite(parsed)) return void 0;
-  return Math.max(0, Math.min(1, parsed));
-}
-function trimTrailingSlash(value) {
-  if (!value) return void 0;
-  let out = value;
-  while (out.endsWith("/")) out = out.slice(0, -1);
-  return out || void 0;
-}
-function readProcessEnv() {
-  return typeof process !== "undefined" ? process.env : {};
-}
 export {
+  HTTP_OBSERVABILITY_CONTRACT,
   OTLP_JSON_CONTENT_TYPE,
   PROMETHEUS_CONTENT_TYPE,
   alwaysOffSampler,
@@ -634,6 +120,7 @@ export {
   makeOtlpHttpLogExporter,
   makeOtlpHttpMetricsExporter,
   makeOtlpHttpSpanExporter,
+  makeOtlpOptions,
   makePrometheusMetricsExporter,
   makeRequestObservabilityContext,
   makeRuntimeHealth,