brass-runtime 1.15.0 → 1.16.0

package/dist/observability/index.cjs

@@ -0,0 +1,677 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+var _chunkJNFRRJYHcjs = require('../chunk-JNFRRJYH.cjs');
+require('../chunk-JX3LZQJH.cjs');
+
+
+var _chunkWQ5QNU5Rcjs = require('../chunk-WQ5QNU5R.cjs');
+
+
+
+
+
+
+var _chunkDJQ7OMMBcjs = require('../chunk-DJQ7OMMB.cjs');
+require('../chunk-SPUEME2B.cjs');
+require('../chunk-OBGZSXTJ.cjs');
+
+// 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 = _chunkDJQ7OMMBcjs.asyncFlatMap.call(void 0, 
+        beginHttpObservation(req, resolved),
+        (state) => _chunkDJQ7OMMBcjs.asyncFlatMap.call(void 0, 
+          logHttpRequest(req, resolved),
+          () => _chunkDJQ7OMMBcjs.asyncFlatMap.call(void 0, 
+            prepareHttpRequest(req, resolved),
+            (wireReq) => _chunkDJQ7OMMBcjs.asyncFold.call(void 0, 
+              next(wireReq),
+              (error) => {
+                const finish = state.finishWithError(error);
+                const adaptiveLimiterAttrs = observeAdaptiveLimiter(wireReq, next, resolved);
+                return _chunkDJQ7OMMBcjs.asyncFlatMap.call(void 0, 
+                  _chunkJNFRRJYHcjs.spanEvent.call(void 0, "http.client.error", {
+                    ...finish.spanAttributes,
+                    ...adaptiveLimiterAttrs,
+                    "error.type": error._tag
+                  }),
+                  () => _chunkDJQ7OMMBcjs.asyncFlatMap.call(void 0, logHttpError(req, error, finish, resolved), () => _chunkDJQ7OMMBcjs.asyncFail.call(void 0, error))
+                );
+              },
+              (res) => {
+                const finish = state.finishWithResponse(res);
+                const adaptiveLimiterAttrs = observeAdaptiveLimiter(wireReq, next, resolved);
+                return _chunkDJQ7OMMBcjs.asyncFlatMap.call(void 0, 
+                  _chunkJNFRRJYHcjs.spanEvent.call(void 0, "http.client.response", {
+                    ...finish.spanAttributes,
+                    ...adaptiveLimiterAttrs
+                  }),
+                  () => _chunkDJQ7OMMBcjs.asyncFlatMap.call(void 0, logHttpResponse(req, res, finish, resolved), () => _chunkDJQ7OMMBcjs.asyncSucceed.call(void 0, res))
+                );
+              }
+            )
+          )
+        )
+      );
+      if (resolved.spans === false) return run;
+      return _chunkJNFRRJYHcjs.withSpan.call(void 0, spanName(req, resolved.spans), run, spanStartAttributes(req, resolved));
+    };
+  };
+}
+var makeHttpObservabilityMiddleware = withHttpObservability;
+function beginHttpObservation(req, options) {
+  return _chunkDJQ7OMMBcjs.asyncSync.call(void 0, () => {
+    const startedAt = options.clock();
+    let finished = false;
+    const inFlight = _optionalChain([options, 'access', _ => _.metrics, 'optionalAccess', _2 => _2.gauge, 'call', _3 => _3("brass_http_client_in_flight", requestBaseLabels(req, options))]);
+    _optionalChain([inFlight, 'optionalAccess', _4 => _4.increment, 'call', _5 => _5()]);
+    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();
+        _optionalChain([options, 'access', _6 => _6.metrics, 'optionalAccess', _7 => _7.counter, 'call', _8 => _8("brass_http_client_requests_total", labels), 'access', _9 => _9.increment, 'call', _10 => _10()]);
+        _optionalChain([options, 'access', _11 => _11.metrics, 'optionalAccess', _12 => _12.histogram, 'call', _13 => _13("brass_http_client_duration_ms", [..._nullishCoalesce(options.durationBuckets, () => ( DEFAULT_DURATION_BUCKETS))], labels), 'access', _14 => _14.observe, 'call', _15 => _15(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 = _chunkWQ5QNU5Rcjs.getCurrentFiber.call(void 0, );
+    _optionalChain([fiber, 'optionalAccess', _16 => _16.addFinalizer, 'optionalCall', _17 => _17(() => {
+      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 _chunkDJQ7OMMBcjs.asyncSucceed.call(void 0, req);
+  return _chunkDJQ7OMMBcjs.asyncSync.call(void 0, () => injectCurrentTraceContext(req));
+}
+function logHttpRequest(req, options) {
+  const level = options.logs === false ? false : _nullishCoalesce(options.logs.requestLevel, () => ( false));
+  if (!level) return _chunkDJQ7OMMBcjs.asyncSucceed.call(void 0, void 0);
+  return _chunkJNFRRJYHcjs.logEffect.call(void 0, level, "http.client.request", requestLogFields(req, options));
+}
+function logHttpResponse(req, res, finish, options) {
+  const configured = options.logs === false ? false : _nullishCoalesce(options.logs.responseLevel, () => ( false));
+  const level = configured || (finish.outcome === "error" ? options.logs !== false ? _nullishCoalesce(options.logs.errorLevel, () => ( "warn")) : false : false);
+  if (!level) return _chunkDJQ7OMMBcjs.asyncSucceed.call(void 0, void 0);
+  return _chunkJNFRRJYHcjs.logEffect.call(void 0, 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 : _nullishCoalesce(options.logs.errorLevel, () => ( "error"));
+  if (!level) return _chunkDJQ7OMMBcjs.asyncSucceed.call(void 0, void 0);
+  return _chunkJNFRRJYHcjs.logEffect.call(void 0, 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: _optionalChain([raw, 'optionalAccess', _18 => _18.metrics]) === false ? void 0 : _optionalChain([raw, 'optionalAccess', _19 => _19.metrics]),
+    logs: _nullishCoalesce(_optionalChain([raw, 'optionalAccess', _20 => _20.logs]), () => ( {})),
+    spans: _nullishCoalesce(_optionalChain([raw, 'optionalAccess', _21 => _21.spans]), () => ( {})),
+    adaptiveLimiter: resolveAdaptiveLimiterObservabilityOptions(_optionalChain([raw, 'optionalAccess', _22 => _22.adaptiveLimiter])),
+    injectTraceHeaders: _nullishCoalesce(_optionalChain([raw, 'optionalAccess', _23 => _23.injectTraceHeaders]), () => ( true)),
+    includeHostLabel: _nullishCoalesce(_optionalChain([raw, 'optionalAccess', _24 => _24.includeHostLabel]), () => ( true)),
+    route: _optionalChain([raw, 'optionalAccess', _25 => _25.route]),
+    clock: _nullishCoalesce(_optionalChain([raw, 'optionalAccess', _26 => _26.clock]), () => ( Date.now)),
+    durationBuckets: _optionalChain([raw, 'optionalAccess', _27 => _27.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: _nullishCoalesce(options.enabled, () => ( true)),
+    includeKeyLabel: _nullishCoalesce(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 _optionalChain([stats, 'access', _28 => _28.keys, 'optionalAccess', _29 => _29.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) : _nullishCoalesce(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: _nullishCoalesce(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 = _chunkWQ5QNU5Rcjs.getCurrentFiber.call(void 0, );
+  const trace = _optionalChain([fiber, 'optionalAccess', _30 => _30.fiberContext, 'optionalAccess', _31 => _31.trace]);
+  if (!_optionalChain([trace, 'optionalAccess', _32 => _32.traceId]) || !_optionalChain([trace, 'optionalAccess', _33 => _33.spanId])) return req;
+  return {
+    ...req,
+    headers: _chunkJNFRRJYHcjs.injectTraceContext.call(void 0, req.headers, trace)
+  };
+}
+function currentTraceExemplar(value, timestamp) {
+  const fiber = _chunkWQ5QNU5Rcjs.getCurrentFiber.call(void 0, );
+  return _chunkJNFRRJYHcjs.exemplarFromTraceContext.call(void 0, _optionalChain([fiber, 'optionalAccess', _34 => _34.fiberContext, 'optionalAccess', _35 => _35.trace]), value, timestamp);
+}
+function requestHost(req) {
+  try {
+    return new URL(req.url).host;
+  } catch (e) {
+    return void 0;
+  }
+}
+function urlScheme(url) {
+  try {
+    return new URL(url).protocol.replace(/:$/, "");
+  } catch (e2) {
+    return void 0;
+  }
+}
+function urlPath(url) {
+  try {
+    return new URL(url).pathname;
+  } catch (e3) {
+    return void 0;
+  }
+}
+function sanitizeUrl(url) {
+  try {
+    const parsed = new URL(url);
+    parsed.search = "";
+    parsed.hash = "";
+    return parsed.toString();
+  } catch (e4) {
+    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 _chunkJNFRRJYHcjs.makeRequestObservabilityContext.call(void 0, observability, {
+    headers: request.headers,
+    method: request.method,
+    target: _chunkJNFRRJYHcjs.sanitizeHttpTarget.call(void 0, request.url),
+    route: _nullishCoalesce(input.route, () => ( _chunkJNFRRJYHcjs.normalizeHttpRoute.call(void 0, urlPathname(request.url)))),
+    ...input
+  });
+}
+function makeNodeRequestObservabilityContext(observability, request, input = {}) {
+  return _chunkJNFRRJYHcjs.makeRequestObservabilityContext.call(void 0, observability, {
+    headers: request.headers,
+    method: request.method,
+    target: _chunkJNFRRJYHcjs.sanitizeHttpTarget.call(void 0, request.url),
+    route: _nullishCoalesce(input.route, () => ( _chunkJNFRRJYHcjs.normalizeHttpRoute.call(void 0, request.url))),
+    ...input
+  });
+}
+function makeExpressRequestObservabilityContext(observability, request, input = {}) {
+  return _chunkJNFRRJYHcjs.makeRequestObservabilityContext.call(void 0, observability, {
+    headers: request.headers,
+    method: request.method,
+    target: _chunkJNFRRJYHcjs.sanitizeHttpTarget.call(void 0, _nullishCoalesce(request.originalUrl, () => ( request.url))),
+    route: _nullishCoalesce(_nullishCoalesce(input.route, () => ( _optionalChain([request, 'access', _36 => _36.route, 'optionalAccess', _37 => _37.path]))), () => ( _chunkJNFRRJYHcjs.normalizeHttpRoute.call(void 0, _nullishCoalesce(request.path, () => ( request.url))))),
+    ...input
+  });
+}
+function makeFastifyRequestObservabilityContext(observability, request, input = {}) {
+  return _chunkJNFRRJYHcjs.makeRequestObservabilityContext.call(void 0, observability, {
+    headers: request.headers,
+    method: request.method,
+    target: _chunkJNFRRJYHcjs.sanitizeHttpTarget.call(void 0, request.url),
+    route: _nullishCoalesce(_nullishCoalesce(_nullishCoalesce(input.route, () => ( _optionalChain([request, 'access', _38 => _38.routeOptions, 'optionalAccess', _39 => _39.url]))), () => ( request.routerPath)), () => ( _chunkJNFRRJYHcjs.normalizeHttpRoute.call(void 0, 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 (e5) {
+    return url;
+  }
+}
+
+// src/observability/config.ts
+function makeNoopObservability() {
+  return _chunkJNFRRJYHcjs.makeObservability.call(void 0, {
+    metrics: false,
+    logs: false,
+    traces: false,
+    autoStart: false
+  });
+}
+function makeObservabilityPreset(preset, overrides = {}) {
+  if (preset === "disabled") return makeNoopObservability();
+  return _chunkJNFRRJYHcjs.makeObservability.call(void 0, mergeObservabilityOptions(observabilityOptionsForPreset(preset), overrides));
+}
+function makeObservabilityFromEnv(env = readProcessEnv(), overrides = {}) {
+  const preset = env.BRASS_OBSERVABILITY === "disabled" ? "disabled" : parsePreset(_nullishCoalesce(env.BRASS_OBSERVABILITY_PRESET, () => ( env.NODE_ENV)));
+  if (preset === "disabled") return makeNoopObservability();
+  return _chunkJNFRRJYHcjs.makeObservability.call(void 0, 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(_nullishCoalesce(env.BRASS_OBSERVABILITY_PRESET, () => ( env.NODE_ENV)))) {
+  const base = observabilityOptionsForPreset(preset);
+  const serviceName = _nullishCoalesce(env.OTEL_SERVICE_NAME, () => ( env.BRASS_SERVICE_NAME));
+  const serviceVersion = _nullishCoalesce(env.OTEL_SERVICE_VERSION, () => ( env.BRASS_SERVICE_VERSION));
+  const endpoint = trimTrailingSlash(env.OTEL_EXPORTER_OTLP_ENDPOINT);
+  const metricsUrl = _nullishCoalesce(env.OTEL_EXPORTER_OTLP_METRICS_ENDPOINT, () => ( (endpoint ? `${endpoint}/v1/metrics` : void 0)));
+  const tracesUrl = _nullishCoalesce(env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT, () => ( (endpoint ? `${endpoint}/v1/traces` : void 0)));
+  const logsUrl = _nullishCoalesce(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(_nullishCoalesce(env.BRASS_TRACE_SAMPLE_RATIO, () => ( env.OTEL_TRACES_SAMPLER_ARG)));
+  const minLevel = env.BRASS_OBSERVABILITY_LOG_LEVEL;
+  const otlp = {
+    ..._nullishCoalesce(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: _nullishCoalesce(overrides.metrics, () => ( base.metrics)),
+    logs: _nullishCoalesce(overrides.logs, () => ( base.logs)),
+    otlp: {
+      ..._nullishCoalesce(base.otlp, () => ( {})),
+      ..._nullishCoalesce(overrides.otlp, () => ( {})),
+      retry: _nullishCoalesce(_optionalChain([overrides, 'access', _40 => _40.otlp, 'optionalAccess', _41 => _41.retry]), () => ( _optionalChain([base, 'access', _42 => _42.otlp, 'optionalAccess', _43 => _43.retry]))),
+      pipeline: {
+        ..._nullishCoalesce(_optionalChain([base, 'access', _44 => _44.otlp, 'optionalAccess', _45 => _45.pipeline]), () => ( {})),
+        ..._nullishCoalesce(_optionalChain([overrides, 'access', _46 => _46.otlp, 'optionalAccess', _47 => _47.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 : {};
+}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.OTLP_JSON_CONTENT_TYPE = _chunkJNFRRJYHcjs.OTLP_JSON_CONTENT_TYPE; exports.PROMETHEUS_CONTENT_TYPE = _chunkJNFRRJYHcjs.PROMETHEUS_CONTENT_TYPE; exports.alwaysOffSampler = _chunkJNFRRJYHcjs.alwaysOffSampler; exports.alwaysOnSampler = _chunkJNFRRJYHcjs.alwaysOnSampler; exports.currentBaggage = _chunkJNFRRJYHcjs.currentBaggage; exports.currentSpanLink = _chunkJNFRRJYHcjs.currentSpanLink; exports.defaultStructuredLogWriter = _chunkJNFRRJYHcjs.defaultStructuredLogWriter; exports.exemplarFromTraceContext = _chunkJNFRRJYHcjs.exemplarFromTraceContext; exports.exportWithRetry = _chunkJNFRRJYHcjs.exportWithRetry; exports.extractBaggage = _chunkJNFRRJYHcjs.extractBaggage; exports.extractTraceContext = _chunkJNFRRJYHcjs.extractTraceContext; exports.formatBaggage = _chunkJNFRRJYHcjs.formatBaggage; exports.formatPrometheusMetrics = _chunkJNFRRJYHcjs.formatPrometheusMetrics; exports.formatStructuredLog = _chunkJNFRRJYHcjs.formatStructuredLog; exports.formatTraceparent = _chunkJNFRRJYHcjs.formatTraceparent; exports.healthToHttpResponse = _chunkJNFRRJYHcjs.healthToHttpResponse; exports.injectBaggage = _chunkJNFRRJYHcjs.injectBaggage; exports.injectTraceContext = _chunkJNFRRJYHcjs.injectTraceContext; exports.logEffect = _chunkJNFRRJYHcjs.logEffect; exports.makeCardinalityLimitedMetrics = _chunkJNFRRJYHcjs.makeCardinalityLimitedMetrics; exports.makeExportPipeline = _chunkJNFRRJYHcjs.makeExportPipeline; exports.makeExpressRequestObservabilityContext = makeExpressRequestObservabilityContext; exports.makeFastifyRequestObservabilityContext = makeFastifyRequestObservabilityContext; exports.makeFetchRequestObservabilityContext = makeFetchRequestObservabilityContext; exports.makeHttpObservabilityMiddleware = makeHttpObservabilityMiddleware; exports.makeNodeRequestObservabilityContext = makeNodeRequestObservabilityContext; exports.makeNoopObservability = makeNoopObservability; exports.makeObservability = _chunkJNFRRJYHcjs.makeObservability; exports.makeObservabilityFromEnv = makeObservabilityFromEnv; exports.makeObservabilityPreset = makeObservabilityPreset; exports.makeObservabilityRedactor = _chunkJNFRRJYHcjs.makeObservabilityRedactor; exports.makeOtlpHttpLogExporter = _chunkJNFRRJYHcjs.makeOtlpHttpLogExporter; exports.makeOtlpHttpMetricsExporter = _chunkJNFRRJYHcjs.makeOtlpHttpMetricsExporter; exports.makeOtlpHttpSpanExporter = _chunkJNFRRJYHcjs.makeOtlpHttpSpanExporter; exports.makePrometheusMetricsExporter = _chunkJNFRRJYHcjs.makePrometheusMetricsExporter; exports.makeRequestObservabilityContext = _chunkJNFRRJYHcjs.makeRequestObservabilityContext; exports.makeRuntimeHealth = _chunkJNFRRJYHcjs.makeRuntimeHealth; exports.makeRuntimeMetricsSink = _chunkJNFRRJYHcjs.makeRuntimeMetricsSink; exports.makeStructuredLogSink = _chunkJNFRRJYHcjs.makeStructuredLogSink; exports.makeTraceSampler = _chunkJNFRRJYHcjs.makeTraceSampler; exports.metricsSnapshotToOtlp = _chunkJNFRRJYHcjs.metricsSnapshotToOtlp; exports.normalizeHttpRoute = _chunkJNFRRJYHcjs.normalizeHttpRoute; exports.normalizeSpanId = _chunkJNFRRJYHcjs.normalizeSpanId; exports.normalizeTraceId = _chunkJNFRRJYHcjs.normalizeTraceId; exports.observabilityOptionsForPreset = observabilityOptionsForPreset; exports.observabilityOptionsFromEnv = observabilityOptionsFromEnv; exports.observeHttpServerRequest = _chunkJNFRRJYHcjs.observeHttpServerRequest; exports.otlpAnyValue = _chunkJNFRRJYHcjs.otlpAnyValue; exports.parseBaggage = _chunkJNFRRJYHcjs.parseBaggage; exports.parseTraceparent = _chunkJNFRRJYHcjs.parseTraceparent; exports.postOtlpJson = _chunkJNFRRJYHcjs.postOtlpJson; exports.ratioSampler = _chunkJNFRRJYHcjs.ratioSampler; exports.readiness = _chunkJNFRRJYHcjs.readiness; exports.resolveRequestBaggage = _chunkJNFRRJYHcjs.resolveRequestBaggage; exports.resolveRequestTraceSeed = _chunkJNFRRJYHcjs.resolveRequestTraceSeed; exports.resolveTraceSampling = _chunkJNFRRJYHcjs.resolveTraceSampling; exports.runObservedHttpServerEffect = _chunkJNFRRJYHcjs.runObservedHttpServerEffect; exports.runtimeHealth = _chunkJNFRRJYHcjs.runtimeHealth; exports.sanitizeHttpTarget = _chunkJNFRRJYHcjs.sanitizeHttpTarget; exports.shouldSampleWith = _chunkJNFRRJYHcjs.shouldSampleWith; exports.snapshotRuntimeHealth = _chunkJNFRRJYHcjs.snapshotRuntimeHealth; exports.spanEvent = _chunkJNFRRJYHcjs.spanEvent; exports.spanLink = _chunkJNFRRJYHcjs.spanLink; exports.spansToOtlp = _chunkJNFRRJYHcjs.spansToOtlp; exports.structuredLogsToOtlp = _chunkJNFRRJYHcjs.structuredLogsToOtlp; exports.toOtlpAttributes = _chunkJNFRRJYHcjs.toOtlpAttributes; exports.unixNanoFromMs = _chunkJNFRRJYHcjs.unixNanoFromMs; exports.withBaggage = _chunkJNFRRJYHcjs.withBaggage; exports.withFetchRequestObservability = withFetchRequestObservability; exports.withHttpObservability = withHttpObservability; exports.withLogContext = _chunkJNFRRJYHcjs.withLogContext; exports.withNodeRequestObservability = withNodeRequestObservability; exports.withSpan = _chunkJNFRRJYHcjs.withSpan; exports.withTimeout = _chunkJNFRRJYHcjs.withTimeout;