apitally 0.25.7 → 1.0.0-alpha.1

package/dist/requestObservation.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/requestObservation.ts"],"sourcesContent":["import { type Attributes, type Context, SpanKind, SpanStatusCode, trace } from \"@opentelemetry/api\";\nimport { getRPCMetadata, type RPCMetadata, RPCType, setRPCMetadata } from \"@opentelemetry/core\";\nimport type { BodyCapture, CapturedBody } from \"./bodyCapture.js\";\nimport { getConfig } from \"./config.js\";\nimport {\n  attachRequestRecordToRpcMetadata,\n  getConsumerHolder,\n  type RequestRecord,\n  type SpanHandle,\n  withRequestHolders,\n} from \"./context.js\";\nimport { coerceToException } from \"./exceptions.js\";\nimport { logWarning } from \"./logger.js\";\nimport { writeRequestAttribute } from \"./requestAttributes.js\";\nimport {\n  getActiveSpanPipeline,\n  isApitallySpanProcessorDeclared,\n  type RequestStash,\n} from \"./spanProcessor.js\";\n\ninterface StartRequestObservationOptions {\n  activeContext: Context;\n  extractedContext: Context;\n  tracerName: string;\n  method: string;\n  startAttributes: Attributes;\n  requestBodyCapture: BodyCapture;\n}\n\nexport interface StartedRequestObservation {\n  requestRecord: RequestRecord;\n  requestContext: Context;\n  spanHandle: SpanHandle;\n  rpcMetadata?: RPCMetadata;\n}\n\nexport interface HttpRequestStartAttributeInput {\n  method: string;\n  path?: string;\n  query?: string;\n  scheme?: string;\n  serverAddress?: string;\n  fullUrl?: string;\n  clientAddress?: string;\n  userAgent?: string;\n  requestBodySize?: number;\n}\n\nexport function resolveHttpRequestStartAttributes(\n  input: HttpRequestStartAttributeInput,\n): Attributes {\n  const attributes: Attributes = { \"http.request.method\": input.method };\n  const optionalAttributes: [string, string | number | undefined][] = [\n    [\"url.path\", input.path],\n    [\"url.query\", input.query],\n    [\"url.scheme\", input.scheme],\n    [\"url.full\", input.fullUrl],\n    [\"server.address\", input.serverAddress],\n    [\"client.address\", input.clientAddress],\n    [\"user_agent.original\", input.userAgent],\n    [\"http.request.body.size\", input.requestBodySize],\n  ];\n  for (const [name, value] of optionalAttributes) {\n    if (value !== undefined) {\n      attributes[name] = value;\n    }\n  }\n  return attributes;\n}\n\nexport function startRequestObservation(\n  options: StartRequestObservationOptions,\n): StartedRequestObservation {\n  const {\n    activeContext,\n    extractedContext,\n    tracerName,\n    method,\n    startAttributes,\n    requestBodyCapture,\n  } = options;\n  const requestRecord: RequestRecord = { attributes: {} };\n  const spanHandle: SpanHandle = {};\n  const consumerHolder = getConsumerHolder(activeContext) ?? {};\n  // Metrics and the exported span copy read from the request record, so the\n  // start attributes are mirrored into it on every path, span or no span.\n  Object.assign(requestRecord.attributes, startAttributes);\n  const activeSpan = trace.getSpan(activeContext);\n  const resolveUnavailableSpanDropReason = (): RequestRecord[\"dropReason\"] =>\n    getActiveSpanPipeline()?.resolveRequestDropReasonBeforeSampling(startAttributes) ??\n    \"sampled-out\";\n  let requestContext: Context;\n  // Span kind is not part of the OTel API surface, so read the SDK-level\n  // property from whichever package copy produced the span.\n  if (activeSpan?.isRecording() && (activeSpan as { kind?: unknown }).kind === SpanKind.SERVER) {\n    // A SERVER span produced by the user's own instrumentation is adopted:\n    // no second span, and the request runs under the user's context.\n    spanHandle.span = activeSpan;\n    requestRecord.serverSpanId = activeSpan.spanContext().spanId;\n    if (getActiveSpanPipeline()?.isRequestInFlight(requestRecord.serverSpanId) !== true) {\n      requestRecord.dropReason = resolveUnavailableSpanDropReason();\n    }\n    requestContext = withRequestHolders(activeContext, spanHandle, requestRecord, consumerHolder);\n  } else if (activeSpan && !activeSpan.isRecording()) {\n    requestRecord.dropReason = resolveUnavailableSpanDropReason();\n    if (requestRecord.dropReason === \"sampled-out\") {\n      warnAboutNonRecordingServerSpan();\n    }\n    requestContext = withRequestHolders(activeContext, spanHandle, requestRecord, consumerHolder);\n  } else {\n    requestContext = withRequestHolders(\n      extractedContext,\n      spanHandle,\n      requestRecord,\n      consumerHolder,\n    );\n    const ownSpan = trace\n      .getTracer(tracerName)\n      .startSpan(method, { kind: SpanKind.SERVER, attributes: startAttributes }, requestContext);\n    if (!ownSpan.isRecording()) {\n      requestRecord.dropReason = resolveUnavailableSpanDropReason();\n      if (requestRecord.dropReason === \"sampled-out\") {\n        warnAboutNonRecordingServerSpan();\n      }\n    } else {\n      spanHandle.span = ownSpan;\n      spanHandle.ownSpan = ownSpan;\n      if (isApitallySpanProcessorDeclared() && requestRecord.serverSpanId === undefined) {\n        requestRecord.dropReason = resolveUnavailableSpanDropReason();\n        if (requestRecord.dropReason === \"sampled-out\") {\n          warnAboutUnattachedSpanProcessor();\n        }\n      }\n    }\n    // A non-recording span still carries a valid span context, so user child\n    // spans parent to it and parent-based samplers drop them consistently.\n    requestContext = trace.setSpan(requestContext, ownSpan);\n  }\n\n  // Middleware-based span producers inspect OTel RPC metadata to demote duplicate\n  // transport spans; completion adds the route.\n  let rpcMetadata = getRPCMetadata(requestContext);\n  if (!rpcMetadata && spanHandle.span) {\n    rpcMetadata = { type: RPCType.HTTP, span: spanHandle.span };\n    requestContext = setRPCMetadata(requestContext, rpcMetadata);\n  }\n  attachRequestRecordToRpcMetadata(rpcMetadata, requestRecord);\n  if (requestRecord.dropReason !== undefined) {\n    requestBodyCapture.stopBuffering();\n  }\n  return { requestRecord, requestContext, spanHandle, rpcMetadata };\n}\n\nexport interface RequestObservation {\n  requestRecord: RequestRecord;\n  spanHandle: SpanHandle;\n  rpcMetadata?: RPCMetadata;\n  method: string;\n  startTimeMillis: number;\n}\n\nexport interface FinalizeRequestObservationOptions {\n  observation: RequestObservation;\n  completedAtMillis: number;\n  statusCode: number;\n  route?: string;\n  clientAddress?: string;\n  requestHeaders: Headers | Record<string, string | string[] | undefined>;\n  responseHeaders: Headers | Record<string, string | number | string[] | undefined>;\n  capturedRequestBody?: CapturedBody;\n  capturedResponseBody?: CapturedBody;\n}\n\nexport function finalizeRequestObservation(options: FinalizeRequestObservationOptions): void {\n  const { observation, statusCode, route } = options;\n  const { requestRecord, spanHandle, rpcMetadata, method } = observation;\n  requestRecord.durationSeconds = (options.completedAtMillis - observation.startTimeMillis) / 1000;\n  const { span, ownSpan } = spanHandle;\n  if (options.clientAddress !== undefined) {\n    writeRequestAttribute(span, requestRecord, \"client.address\", options.clientAddress);\n  }\n  writeRequestAttribute(span, requestRecord, \"http.response.status_code\", statusCode);\n  const requestBodySize = options.capturedRequestBody?.size;\n  if (requestBodySize !== undefined) {\n    writeRequestAttribute(span, requestRecord, \"http.request.body.size\", requestBodySize);\n  }\n  const responseBodySize = options.capturedResponseBody?.size;\n  if (responseBodySize !== undefined) {\n    writeRequestAttribute(span, requestRecord, \"http.response.body.size\", responseBodySize);\n  }\n  if (route !== undefined) {\n    writeRequestAttribute(span, requestRecord, \"http.route\", route);\n    if (rpcMetadata) {\n      rpcMetadata.route = route;\n    }\n    if (ownSpan?.isRecording()) {\n      ownSpan.updateName(`${method} ${route}`);\n    }\n  } else {\n    // An empty route clears one set by the producing instrumentation; request\n    // metrics omit empty routes.\n    requestRecord.attributes[\"http.route\"] = \"\";\n  }\n  if (ownSpan && statusCode >= 500) {\n    ownSpan.setStatus({ code: SpanStatusCode.ERROR });\n  }\n  // A dropped request's spans are never released, so a stash entry for it\n  // would sit unconsumed until the cap evicts it.\n  if (requestRecord.serverSpanId !== undefined && requestRecord.dropReason === undefined) {\n    const config = getConfig();\n    const stash: RequestStash = {};\n    if (config.captureRequestHeaders) {\n      stash.requestHeaders = normalizeHeaders(options.requestHeaders);\n    }\n    if (config.captureResponseHeaders) {\n      stash.responseHeaders = normalizeHeaders(options.responseHeaders);\n    }\n    const requestBody = options.capturedRequestBody?.body;\n    if (requestBody) {\n      stash.requestBody = requestBody;\n    }\n    const responseBody = options.capturedResponseBody?.body;\n    if (responseBody) {\n      stash.responseBody = responseBody;\n    }\n    if (Object.keys(stash).length > 0) {\n      getActiveSpanPipeline()?.updateStash(requestRecord.serverSpanId, stash);\n    }\n  }\n  ownSpan?.end(options.completedAtMillis);\n  getActiveSpanPipeline()?.handleTransportCompletion(requestRecord);\n}\n\nexport interface FinalizeRequestObservationWithErrorOptions {\n  requestRecord: RequestRecord;\n  spanHandle: SpanHandle;\n  error: unknown;\n  durationSeconds: number;\n}\n\nexport function finalizeRequestObservationWithError(\n  options: FinalizeRequestObservationWithErrorOptions,\n): void {\n  const { requestRecord, spanHandle, error, durationSeconds } = options;\n  requestRecord.durationSeconds = durationSeconds;\n  if (spanHandle.span?.isRecording()) {\n    spanHandle.span.recordException(coerceToException(error));\n  }\n  if (spanHandle.ownSpan) {\n    spanHandle.ownSpan.setStatus({ code: SpanStatusCode.ERROR });\n    spanHandle.ownSpan.end();\n  }\n  getActiveSpanPipeline()?.handleTransportCompletion(requestRecord);\n}\n\n// Values remain raw so all redaction happens at the export boundary.\nfunction normalizeHeaders(\n  headers: Headers | Record<string, string | number | string[] | undefined>,\n): Record<string, string | string[]> {\n  const normalized: Record<string, string | string[]> = {};\n  if (isWebHeaders(headers)) {\n    // The Headers API combines repeated values except Set-Cookie.\n    for (const [name, value] of headers) {\n      const existing = normalized[name];\n      if (existing === undefined) {\n        normalized[name] = value;\n      } else if (Array.isArray(existing)) {\n        existing.push(value);\n      } else {\n        normalized[name] = [existing, value];\n      }\n    }\n    return normalized;\n  }\n  for (const [name, value] of Object.entries(headers)) {\n    if (value !== undefined) {\n      normalized[name.toLowerCase()] = Array.isArray(value) ? value : String(value);\n    }\n  }\n  return normalized;\n}\n\n// Duck-typed on iterability: a plain header record has no Symbol.iterator, and\n// the Headers instance may come from another realm's implementation.\nfunction isWebHeaders(headers: object): headers is Headers {\n  return typeof (headers as Headers)[Symbol.iterator] === \"function\";\n}\n\nfunction warnAboutNonRecordingServerSpan(): void {\n  logWarning(\n    \"The OpenTelemetry sampler did not sample the SERVER span of a request. Only sampled requests are exported to Apitally as traces and request logs. Request metrics include all requests.\",\n  );\n}\n\nfunction warnAboutUnattachedSpanProcessor(): void {\n  logWarning(\n    \"The recording OpenTelemetry SERVER span created for a request did not reach ApitallySpanProcessor. Traces and request logs are unavailable while request metrics continue. To resolve this, add the ApitallySpanProcessor instance to your tracer provider's spanProcessors constructor option or the NodeSDK spanProcessors option.\",\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/requestObservation.d.cts

@@ -0,0 +1,60 @@
+import { Context, Attributes } from '@opentelemetry/api';
+import { RPCMetadata } from '@opentelemetry/core';
+import { CapturedBody, BodyCapture } from './bodyCapture.cjs';
+import { RequestRecord, SpanHandle } from './context.cjs';
+
+interface StartRequestObservationOptions {
+    activeContext: Context;
+    extractedContext: Context;
+    tracerName: string;
+    method: string;
+    startAttributes: Attributes;
+    requestBodyCapture: BodyCapture;
+}
+interface StartedRequestObservation {
+    requestRecord: RequestRecord;
+    requestContext: Context;
+    spanHandle: SpanHandle;
+    rpcMetadata?: RPCMetadata;
+}
+interface HttpRequestStartAttributeInput {
+    method: string;
+    path?: string;
+    query?: string;
+    scheme?: string;
+    serverAddress?: string;
+    fullUrl?: string;
+    clientAddress?: string;
+    userAgent?: string;
+    requestBodySize?: number;
+}
+declare function resolveHttpRequestStartAttributes(input: HttpRequestStartAttributeInput): Attributes;
+declare function startRequestObservation(options: StartRequestObservationOptions): StartedRequestObservation;
+interface RequestObservation {
+    requestRecord: RequestRecord;
+    spanHandle: SpanHandle;
+    rpcMetadata?: RPCMetadata;
+    method: string;
+    startTimeMillis: number;
+}
+interface FinalizeRequestObservationOptions {
+    observation: RequestObservation;
+    completedAtMillis: number;
+    statusCode: number;
+    route?: string;
+    clientAddress?: string;
+    requestHeaders: Headers | Record<string, string | string[] | undefined>;
+    responseHeaders: Headers | Record<string, string | number | string[] | undefined>;
+    capturedRequestBody?: CapturedBody;
+    capturedResponseBody?: CapturedBody;
+}
+declare function finalizeRequestObservation(options: FinalizeRequestObservationOptions): void;
+interface FinalizeRequestObservationWithErrorOptions {
+    requestRecord: RequestRecord;
+    spanHandle: SpanHandle;
+    error: unknown;
+    durationSeconds: number;
+}
+declare function finalizeRequestObservationWithError(options: FinalizeRequestObservationWithErrorOptions): void;
+
+export { type FinalizeRequestObservationOptions, type FinalizeRequestObservationWithErrorOptions, type HttpRequestStartAttributeInput, type RequestObservation, type StartedRequestObservation, finalizeRequestObservation, finalizeRequestObservationWithError, resolveHttpRequestStartAttributes, startRequestObservation };

package/dist/requestObservation.d.ts

@@ -0,0 +1,60 @@
+import { Context, Attributes } from '@opentelemetry/api';
+import { RPCMetadata } from '@opentelemetry/core';
+import { CapturedBody, BodyCapture } from './bodyCapture.js';
+import { RequestRecord, SpanHandle } from './context.js';
+
+interface StartRequestObservationOptions {
+    activeContext: Context;
+    extractedContext: Context;
+    tracerName: string;
+    method: string;
+    startAttributes: Attributes;
+    requestBodyCapture: BodyCapture;
+}
+interface StartedRequestObservation {
+    requestRecord: RequestRecord;
+    requestContext: Context;
+    spanHandle: SpanHandle;
+    rpcMetadata?: RPCMetadata;
+}
+interface HttpRequestStartAttributeInput {
+    method: string;
+    path?: string;
+    query?: string;
+    scheme?: string;
+    serverAddress?: string;
+    fullUrl?: string;
+    clientAddress?: string;
+    userAgent?: string;
+    requestBodySize?: number;
+}
+declare function resolveHttpRequestStartAttributes(input: HttpRequestStartAttributeInput): Attributes;
+declare function startRequestObservation(options: StartRequestObservationOptions): StartedRequestObservation;
+interface RequestObservation {
+    requestRecord: RequestRecord;
+    spanHandle: SpanHandle;
+    rpcMetadata?: RPCMetadata;
+    method: string;
+    startTimeMillis: number;
+}
+interface FinalizeRequestObservationOptions {
+    observation: RequestObservation;
+    completedAtMillis: number;
+    statusCode: number;
+    route?: string;
+    clientAddress?: string;
+    requestHeaders: Headers | Record<string, string | string[] | undefined>;
+    responseHeaders: Headers | Record<string, string | number | string[] | undefined>;
+    capturedRequestBody?: CapturedBody;
+    capturedResponseBody?: CapturedBody;
+}
+declare function finalizeRequestObservation(options: FinalizeRequestObservationOptions): void;
+interface FinalizeRequestObservationWithErrorOptions {
+    requestRecord: RequestRecord;
+    spanHandle: SpanHandle;
+    error: unknown;
+    durationSeconds: number;
+}
+declare function finalizeRequestObservationWithError(options: FinalizeRequestObservationWithErrorOptions): void;
+
+export { type FinalizeRequestObservationOptions, type FinalizeRequestObservationWithErrorOptions, type HttpRequestStartAttributeInput, type RequestObservation, type StartedRequestObservation, finalizeRequestObservation, finalizeRequestObservationWithError, resolveHttpRequestStartAttributes, startRequestObservation };

package/dist/requestObservation.js

@@ -0,0 +1,208 @@
+import { SpanKind, SpanStatusCode, trace } from "@opentelemetry/api";
+import { getRPCMetadata, RPCType, setRPCMetadata } from "@opentelemetry/core";
+import { getConfig } from "./config.js";
+import {
+  attachRequestRecordToRpcMetadata,
+  getConsumerHolder,
+  withRequestHolders
+} from "./context.js";
+import { coerceToException } from "./exceptions.js";
+import { logWarning } from "./logger.js";
+import { writeRequestAttribute } from "./requestAttributes.js";
+import {
+  getActiveSpanPipeline,
+  isApitallySpanProcessorDeclared
+} from "./spanProcessor.js";
+function resolveHttpRequestStartAttributes(input) {
+  const attributes = { "http.request.method": input.method };
+  const optionalAttributes = [
+    ["url.path", input.path],
+    ["url.query", input.query],
+    ["url.scheme", input.scheme],
+    ["url.full", input.fullUrl],
+    ["server.address", input.serverAddress],
+    ["client.address", input.clientAddress],
+    ["user_agent.original", input.userAgent],
+    ["http.request.body.size", input.requestBodySize]
+  ];
+  for (const [name, value] of optionalAttributes) {
+    if (value !== void 0) {
+      attributes[name] = value;
+    }
+  }
+  return attributes;
+}
+function startRequestObservation(options) {
+  const {
+    activeContext,
+    extractedContext,
+    tracerName,
+    method,
+    startAttributes,
+    requestBodyCapture
+  } = options;
+  const requestRecord = { attributes: {} };
+  const spanHandle = {};
+  const consumerHolder = getConsumerHolder(activeContext) ?? {};
+  Object.assign(requestRecord.attributes, startAttributes);
+  const activeSpan = trace.getSpan(activeContext);
+  const resolveUnavailableSpanDropReason = () => getActiveSpanPipeline()?.resolveRequestDropReasonBeforeSampling(startAttributes) ?? "sampled-out";
+  let requestContext;
+  if (activeSpan?.isRecording() && activeSpan.kind === SpanKind.SERVER) {
+    spanHandle.span = activeSpan;
+    requestRecord.serverSpanId = activeSpan.spanContext().spanId;
+    if (getActiveSpanPipeline()?.isRequestInFlight(requestRecord.serverSpanId) !== true) {
+      requestRecord.dropReason = resolveUnavailableSpanDropReason();
+    }
+    requestContext = withRequestHolders(activeContext, spanHandle, requestRecord, consumerHolder);
+  } else if (activeSpan && !activeSpan.isRecording()) {
+    requestRecord.dropReason = resolveUnavailableSpanDropReason();
+    if (requestRecord.dropReason === "sampled-out") {
+      warnAboutNonRecordingServerSpan();
+    }
+    requestContext = withRequestHolders(activeContext, spanHandle, requestRecord, consumerHolder);
+  } else {
+    requestContext = withRequestHolders(
+      extractedContext,
+      spanHandle,
+      requestRecord,
+      consumerHolder
+    );
+    const ownSpan = trace.getTracer(tracerName).startSpan(method, { kind: SpanKind.SERVER, attributes: startAttributes }, requestContext);
+    if (!ownSpan.isRecording()) {
+      requestRecord.dropReason = resolveUnavailableSpanDropReason();
+      if (requestRecord.dropReason === "sampled-out") {
+        warnAboutNonRecordingServerSpan();
+      }
+    } else {
+      spanHandle.span = ownSpan;
+      spanHandle.ownSpan = ownSpan;
+      if (isApitallySpanProcessorDeclared() && requestRecord.serverSpanId === void 0) {
+        requestRecord.dropReason = resolveUnavailableSpanDropReason();
+        if (requestRecord.dropReason === "sampled-out") {
+          warnAboutUnattachedSpanProcessor();
+        }
+      }
+    }
+    requestContext = trace.setSpan(requestContext, ownSpan);
+  }
+  let rpcMetadata = getRPCMetadata(requestContext);
+  if (!rpcMetadata && spanHandle.span) {
+    rpcMetadata = { type: RPCType.HTTP, span: spanHandle.span };
+    requestContext = setRPCMetadata(requestContext, rpcMetadata);
+  }
+  attachRequestRecordToRpcMetadata(rpcMetadata, requestRecord);
+  if (requestRecord.dropReason !== void 0) {
+    requestBodyCapture.stopBuffering();
+  }
+  return { requestRecord, requestContext, spanHandle, rpcMetadata };
+}
+function finalizeRequestObservation(options) {
+  const { observation, statusCode, route } = options;
+  const { requestRecord, spanHandle, rpcMetadata, method } = observation;
+  requestRecord.durationSeconds = (options.completedAtMillis - observation.startTimeMillis) / 1e3;
+  const { span, ownSpan } = spanHandle;
+  if (options.clientAddress !== void 0) {
+    writeRequestAttribute(span, requestRecord, "client.address", options.clientAddress);
+  }
+  writeRequestAttribute(span, requestRecord, "http.response.status_code", statusCode);
+  const requestBodySize = options.capturedRequestBody?.size;
+  if (requestBodySize !== void 0) {
+    writeRequestAttribute(span, requestRecord, "http.request.body.size", requestBodySize);
+  }
+  const responseBodySize = options.capturedResponseBody?.size;
+  if (responseBodySize !== void 0) {
+    writeRequestAttribute(span, requestRecord, "http.response.body.size", responseBodySize);
+  }
+  if (route !== void 0) {
+    writeRequestAttribute(span, requestRecord, "http.route", route);
+    if (rpcMetadata) {
+      rpcMetadata.route = route;
+    }
+    if (ownSpan?.isRecording()) {
+      ownSpan.updateName(`${method} ${route}`);
+    }
+  } else {
+    requestRecord.attributes["http.route"] = "";
+  }
+  if (ownSpan && statusCode >= 500) {
+    ownSpan.setStatus({ code: SpanStatusCode.ERROR });
+  }
+  if (requestRecord.serverSpanId !== void 0 && requestRecord.dropReason === void 0) {
+    const config = getConfig();
+    const stash = {};
+    if (config.captureRequestHeaders) {
+      stash.requestHeaders = normalizeHeaders(options.requestHeaders);
+    }
+    if (config.captureResponseHeaders) {
+      stash.responseHeaders = normalizeHeaders(options.responseHeaders);
+    }
+    const requestBody = options.capturedRequestBody?.body;
+    if (requestBody) {
+      stash.requestBody = requestBody;
+    }
+    const responseBody = options.capturedResponseBody?.body;
+    if (responseBody) {
+      stash.responseBody = responseBody;
+    }
+    if (Object.keys(stash).length > 0) {
+      getActiveSpanPipeline()?.updateStash(requestRecord.serverSpanId, stash);
+    }
+  }
+  ownSpan?.end(options.completedAtMillis);
+  getActiveSpanPipeline()?.handleTransportCompletion(requestRecord);
+}
+function finalizeRequestObservationWithError(options) {
+  const { requestRecord, spanHandle, error, durationSeconds } = options;
+  requestRecord.durationSeconds = durationSeconds;
+  if (spanHandle.span?.isRecording()) {
+    spanHandle.span.recordException(coerceToException(error));
+  }
+  if (spanHandle.ownSpan) {
+    spanHandle.ownSpan.setStatus({ code: SpanStatusCode.ERROR });
+    spanHandle.ownSpan.end();
+  }
+  getActiveSpanPipeline()?.handleTransportCompletion(requestRecord);
+}
+function normalizeHeaders(headers) {
+  const normalized = {};
+  if (isWebHeaders(headers)) {
+    for (const [name, value] of headers) {
+      const existing = normalized[name];
+      if (existing === void 0) {
+        normalized[name] = value;
+      } else if (Array.isArray(existing)) {
+        existing.push(value);
+      } else {
+        normalized[name] = [existing, value];
+      }
+    }
+    return normalized;
+  }
+  for (const [name, value] of Object.entries(headers)) {
+    if (value !== void 0) {
+      normalized[name.toLowerCase()] = Array.isArray(value) ? value : String(value);
+    }
+  }
+  return normalized;
+}
+function isWebHeaders(headers) {
+  return typeof headers[Symbol.iterator] === "function";
+}
+function warnAboutNonRecordingServerSpan() {
+  logWarning(
+    "The OpenTelemetry sampler did not sample the SERVER span of a request. Only sampled requests are exported to Apitally as traces and request logs. Request metrics include all requests."
+  );
+}
+function warnAboutUnattachedSpanProcessor() {
+  logWarning(
+    "The recording OpenTelemetry SERVER span created for a request did not reach ApitallySpanProcessor. Traces and request logs are unavailable while request metrics continue. To resolve this, add the ApitallySpanProcessor instance to your tracer provider's spanProcessors constructor option or the NodeSDK spanProcessors option."
+  );
+}
+export {
+  finalizeRequestObservation,
+  finalizeRequestObservationWithError,
+  resolveHttpRequestStartAttributes,
+  startRequestObservation
+};
+//# sourceMappingURL=requestObservation.js.map

package/dist/requestObservation.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/requestObservation.ts"],"sourcesContent":["import { type Attributes, type Context, SpanKind, SpanStatusCode, trace } from \"@opentelemetry/api\";\nimport { getRPCMetadata, type RPCMetadata, RPCType, setRPCMetadata } from \"@opentelemetry/core\";\nimport type { BodyCapture, CapturedBody } from \"./bodyCapture.js\";\nimport { getConfig } from \"./config.js\";\nimport {\n  attachRequestRecordToRpcMetadata,\n  getConsumerHolder,\n  type RequestRecord,\n  type SpanHandle,\n  withRequestHolders,\n} from \"./context.js\";\nimport { coerceToException } from \"./exceptions.js\";\nimport { logWarning } from \"./logger.js\";\nimport { writeRequestAttribute } from \"./requestAttributes.js\";\nimport {\n  getActiveSpanPipeline,\n  isApitallySpanProcessorDeclared,\n  type RequestStash,\n} from \"./spanProcessor.js\";\n\ninterface StartRequestObservationOptions {\n  activeContext: Context;\n  extractedContext: Context;\n  tracerName: string;\n  method: string;\n  startAttributes: Attributes;\n  requestBodyCapture: BodyCapture;\n}\n\nexport interface StartedRequestObservation {\n  requestRecord: RequestRecord;\n  requestContext: Context;\n  spanHandle: SpanHandle;\n  rpcMetadata?: RPCMetadata;\n}\n\nexport interface HttpRequestStartAttributeInput {\n  method: string;\n  path?: string;\n  query?: string;\n  scheme?: string;\n  serverAddress?: string;\n  fullUrl?: string;\n  clientAddress?: string;\n  userAgent?: string;\n  requestBodySize?: number;\n}\n\nexport function resolveHttpRequestStartAttributes(\n  input: HttpRequestStartAttributeInput,\n): Attributes {\n  const attributes: Attributes = { \"http.request.method\": input.method };\n  const optionalAttributes: [string, string | number | undefined][] = [\n    [\"url.path\", input.path],\n    [\"url.query\", input.query],\n    [\"url.scheme\", input.scheme],\n    [\"url.full\", input.fullUrl],\n    [\"server.address\", input.serverAddress],\n    [\"client.address\", input.clientAddress],\n    [\"user_agent.original\", input.userAgent],\n    [\"http.request.body.size\", input.requestBodySize],\n  ];\n  for (const [name, value] of optionalAttributes) {\n    if (value !== undefined) {\n      attributes[name] = value;\n    }\n  }\n  return attributes;\n}\n\nexport function startRequestObservation(\n  options: StartRequestObservationOptions,\n): StartedRequestObservation {\n  const {\n    activeContext,\n    extractedContext,\n    tracerName,\n    method,\n    startAttributes,\n    requestBodyCapture,\n  } = options;\n  const requestRecord: RequestRecord = { attributes: {} };\n  const spanHandle: SpanHandle = {};\n  const consumerHolder = getConsumerHolder(activeContext) ?? {};\n  // Metrics and the exported span copy read from the request record, so the\n  // start attributes are mirrored into it on every path, span or no span.\n  Object.assign(requestRecord.attributes, startAttributes);\n  const activeSpan = trace.getSpan(activeContext);\n  const resolveUnavailableSpanDropReason = (): RequestRecord[\"dropReason\"] =>\n    getActiveSpanPipeline()?.resolveRequestDropReasonBeforeSampling(startAttributes) ??\n    \"sampled-out\";\n  let requestContext: Context;\n  // Span kind is not part of the OTel API surface, so read the SDK-level\n  // property from whichever package copy produced the span.\n  if (activeSpan?.isRecording() && (activeSpan as { kind?: unknown }).kind === SpanKind.SERVER) {\n    // A SERVER span produced by the user's own instrumentation is adopted:\n    // no second span, and the request runs under the user's context.\n    spanHandle.span = activeSpan;\n    requestRecord.serverSpanId = activeSpan.spanContext().spanId;\n    if (getActiveSpanPipeline()?.isRequestInFlight(requestRecord.serverSpanId) !== true) {\n      requestRecord.dropReason = resolveUnavailableSpanDropReason();\n    }\n    requestContext = withRequestHolders(activeContext, spanHandle, requestRecord, consumerHolder);\n  } else if (activeSpan && !activeSpan.isRecording()) {\n    requestRecord.dropReason = resolveUnavailableSpanDropReason();\n    if (requestRecord.dropReason === \"sampled-out\") {\n      warnAboutNonRecordingServerSpan();\n    }\n    requestContext = withRequestHolders(activeContext, spanHandle, requestRecord, consumerHolder);\n  } else {\n    requestContext = withRequestHolders(\n      extractedContext,\n      spanHandle,\n      requestRecord,\n      consumerHolder,\n    );\n    const ownSpan = trace\n      .getTracer(tracerName)\n      .startSpan(method, { kind: SpanKind.SERVER, attributes: startAttributes }, requestContext);\n    if (!ownSpan.isRecording()) {\n      requestRecord.dropReason = resolveUnavailableSpanDropReason();\n      if (requestRecord.dropReason === \"sampled-out\") {\n        warnAboutNonRecordingServerSpan();\n      }\n    } else {\n      spanHandle.span = ownSpan;\n      spanHandle.ownSpan = ownSpan;\n      if (isApitallySpanProcessorDeclared() && requestRecord.serverSpanId === undefined) {\n        requestRecord.dropReason = resolveUnavailableSpanDropReason();\n        if (requestRecord.dropReason === \"sampled-out\") {\n          warnAboutUnattachedSpanProcessor();\n        }\n      }\n    }\n    // A non-recording span still carries a valid span context, so user child\n    // spans parent to it and parent-based samplers drop them consistently.\n    requestContext = trace.setSpan(requestContext, ownSpan);\n  }\n\n  // Middleware-based span producers inspect OTel RPC metadata to demote duplicate\n  // transport spans; completion adds the route.\n  let rpcMetadata = getRPCMetadata(requestContext);\n  if (!rpcMetadata && spanHandle.span) {\n    rpcMetadata = { type: RPCType.HTTP, span: spanHandle.span };\n    requestContext = setRPCMetadata(requestContext, rpcMetadata);\n  }\n  attachRequestRecordToRpcMetadata(rpcMetadata, requestRecord);\n  if (requestRecord.dropReason !== undefined) {\n    requestBodyCapture.stopBuffering();\n  }\n  return { requestRecord, requestContext, spanHandle, rpcMetadata };\n}\n\nexport interface RequestObservation {\n  requestRecord: RequestRecord;\n  spanHandle: SpanHandle;\n  rpcMetadata?: RPCMetadata;\n  method: string;\n  startTimeMillis: number;\n}\n\nexport interface FinalizeRequestObservationOptions {\n  observation: RequestObservation;\n  completedAtMillis: number;\n  statusCode: number;\n  route?: string;\n  clientAddress?: string;\n  requestHeaders: Headers | Record<string, string | string[] | undefined>;\n  responseHeaders: Headers | Record<string, string | number | string[] | undefined>;\n  capturedRequestBody?: CapturedBody;\n  capturedResponseBody?: CapturedBody;\n}\n\nexport function finalizeRequestObservation(options: FinalizeRequestObservationOptions): void {\n  const { observation, statusCode, route } = options;\n  const { requestRecord, spanHandle, rpcMetadata, method } = observation;\n  requestRecord.durationSeconds = (options.completedAtMillis - observation.startTimeMillis) / 1000;\n  const { span, ownSpan } = spanHandle;\n  if (options.clientAddress !== undefined) {\n    writeRequestAttribute(span, requestRecord, \"client.address\", options.clientAddress);\n  }\n  writeRequestAttribute(span, requestRecord, \"http.response.status_code\", statusCode);\n  const requestBodySize = options.capturedRequestBody?.size;\n  if (requestBodySize !== undefined) {\n    writeRequestAttribute(span, requestRecord, \"http.request.body.size\", requestBodySize);\n  }\n  const responseBodySize = options.capturedResponseBody?.size;\n  if (responseBodySize !== undefined) {\n    writeRequestAttribute(span, requestRecord, \"http.response.body.size\", responseBodySize);\n  }\n  if (route !== undefined) {\n    writeRequestAttribute(span, requestRecord, \"http.route\", route);\n    if (rpcMetadata) {\n      rpcMetadata.route = route;\n    }\n    if (ownSpan?.isRecording()) {\n      ownSpan.updateName(`${method} ${route}`);\n    }\n  } else {\n    // An empty route clears one set by the producing instrumentation; request\n    // metrics omit empty routes.\n    requestRecord.attributes[\"http.route\"] = \"\";\n  }\n  if (ownSpan && statusCode >= 500) {\n    ownSpan.setStatus({ code: SpanStatusCode.ERROR });\n  }\n  // A dropped request's spans are never released, so a stash entry for it\n  // would sit unconsumed until the cap evicts it.\n  if (requestRecord.serverSpanId !== undefined && requestRecord.dropReason === undefined) {\n    const config = getConfig();\n    const stash: RequestStash = {};\n    if (config.captureRequestHeaders) {\n      stash.requestHeaders = normalizeHeaders(options.requestHeaders);\n    }\n    if (config.captureResponseHeaders) {\n      stash.responseHeaders = normalizeHeaders(options.responseHeaders);\n    }\n    const requestBody = options.capturedRequestBody?.body;\n    if (requestBody) {\n      stash.requestBody = requestBody;\n    }\n    const responseBody = options.capturedResponseBody?.body;\n    if (responseBody) {\n      stash.responseBody = responseBody;\n    }\n    if (Object.keys(stash).length > 0) {\n      getActiveSpanPipeline()?.updateStash(requestRecord.serverSpanId, stash);\n    }\n  }\n  ownSpan?.end(options.completedAtMillis);\n  getActiveSpanPipeline()?.handleTransportCompletion(requestRecord);\n}\n\nexport interface FinalizeRequestObservationWithErrorOptions {\n  requestRecord: RequestRecord;\n  spanHandle: SpanHandle;\n  error: unknown;\n  durationSeconds: number;\n}\n\nexport function finalizeRequestObservationWithError(\n  options: FinalizeRequestObservationWithErrorOptions,\n): void {\n  const { requestRecord, spanHandle, error, durationSeconds } = options;\n  requestRecord.durationSeconds = durationSeconds;\n  if (spanHandle.span?.isRecording()) {\n    spanHandle.span.recordException(coerceToException(error));\n  }\n  if (spanHandle.ownSpan) {\n    spanHandle.ownSpan.setStatus({ code: SpanStatusCode.ERROR });\n    spanHandle.ownSpan.end();\n  }\n  getActiveSpanPipeline()?.handleTransportCompletion(requestRecord);\n}\n\n// Values remain raw so all redaction happens at the export boundary.\nfunction normalizeHeaders(\n  headers: Headers | Record<string, string | number | string[] | undefined>,\n): Record<string, string | string[]> {\n  const normalized: Record<string, string | string[]> = {};\n  if (isWebHeaders(headers)) {\n    // The Headers API combines repeated values except Set-Cookie.\n    for (const [name, value] of headers) {\n      const existing = normalized[name];\n      if (existing === undefined) {\n        normalized[name] = value;\n      } else if (Array.isArray(existing)) {\n        existing.push(value);\n      } else {\n        normalized[name] = [existing, value];\n      }\n    }\n    return normalized;\n  }\n  for (const [name, value] of Object.entries(headers)) {\n    if (value !== undefined) {\n      normalized[name.toLowerCase()] = Array.isArray(value) ? value : String(value);\n    }\n  }\n  return normalized;\n}\n\n// Duck-typed on iterability: a plain header record has no Symbol.iterator, and\n// the Headers instance may come from another realm's implementation.\nfunction isWebHeaders(headers: object): headers is Headers {\n  return typeof (headers as Headers)[Symbol.iterator] === \"function\";\n}\n\nfunction warnAboutNonRecordingServerSpan(): void {\n  logWarning(\n    \"The OpenTelemetry sampler did not sample the SERVER span of a request. Only sampled requests are exported to Apitally as traces and request logs. Request metrics include all requests.\",\n  );\n}\n\nfunction warnAboutUnattachedSpanProcessor(): void {\n  logWarning(\n    \"The recording OpenTelemetry SERVER span created for a request did not reach ApitallySpanProcessor. Traces and request logs are unavailable while request metrics continue. To resolve this, add the ApitallySpanProcessor instance to your tracer provider's spanProcessors constructor option or the NodeSDK spanProcessors option.\",\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/requestObservationNode.cjs

@@ -0,0 +1,193 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var requestObservationNode_exports = {};
+__export(requestObservationNode_exports, {
+  captureNodeResponse: () => captureNodeResponse,
+  registerServerCloseFlush: () => registerServerCloseFlush,
+  startNodeRequestObservation: () => startNodeRequestObservation
+});
+module.exports = __toCommonJS(requestObservationNode_exports);
+var import_api = require("@opentelemetry/api");
+var import_activation = require('./activation.cjs');
+var import_bodyCapture = require('./bodyCapture.cjs');
+var import_config = require('./config.cjs');
+var import_logger = require('./logger.cjs');
+var import_requestObservation = require('./requestObservation.cjs');
+const flushOnCloseServers = /* @__PURE__ */ new WeakSet();
+function startNodeRequestObservation(options) {
+  const { request } = options;
+  const startTimeMillis = performance.now();
+  const method = (request.method ?? "GET").toUpperCase();
+  const requestUrl = request.url ?? "/";
+  const requestBodyCapture = new import_bodyCapture.BodyCapture({
+    captureBody: (0, import_config.getConfig)().captureRequestBody,
+    contentType: request.headers["content-type"],
+    contentLength: request.headers["content-length"],
+    transferEncoding: request.headers["transfer-encoding"]
+  });
+  observeRequestBody(request, requestBodyCapture);
+  const queryIndex = requestUrl.indexOf("?");
+  const scheme = request.socket?.encrypted ? "https" : "http";
+  const host = request.headers.host;
+  let serverAddress;
+  if (host) {
+    try {
+      serverAddress = new URL(`${scheme}://${host}`).hostname;
+    } catch {
+    }
+  }
+  const startAttributes = (0, import_requestObservation.resolveHttpRequestStartAttributes)({
+    method,
+    path: queryIndex === -1 ? requestUrl : requestUrl.slice(0, queryIndex),
+    query: queryIndex === -1 ? void 0 : requestUrl.slice(queryIndex + 1) || void 0,
+    scheme,
+    serverAddress,
+    fullUrl: host ? `${scheme}://${host}${requestUrl}` : void 0,
+    clientAddress: request.socket?.remoteAddress || void 0,
+    userAgent: typeof request.headers["user-agent"] === "string" ? request.headers["user-agent"] : void 0,
+    requestBodySize: requestBodyCapture.size
+  });
+  const { requestRecord, requestContext, spanHandle, rpcMetadata } = (0, import_requestObservation.startRequestObservation)({
+    activeContext: import_api.context.active(),
+    extractedContext: import_api.propagation.extract(import_api.ROOT_CONTEXT, request.headers),
+    tracerName: options.tracerName,
+    method,
+    startAttributes,
+    requestBodyCapture
+  });
+  return {
+    observation: {
+      requestRecord,
+      spanHandle,
+      rpcMetadata,
+      requestBodyCapture,
+      startTimeMillis,
+      method,
+      requestUrl
+    },
+    requestContext
+  };
+}
+function captureNodeResponse(response, shouldCaptureBody, requestBodyCapture, resolveResponseHeader = (name) => response.getHeader(name)) {
+  let responseBodyCapture;
+  const ensureResponseBodyCapture = () => {
+    responseBodyCapture ??= new import_bodyCapture.BodyCapture({
+      captureBody: shouldCaptureBody,
+      contentType: firstStringValue(resolveResponseHeader("content-type")),
+      contentLength: resolveResponseHeader("content-length"),
+      transferEncoding: resolveResponseHeader("transfer-encoding")
+    });
+    return responseBodyCapture;
+  };
+  const recordResponseChunk = (args) => {
+    try {
+      const chunk = args[0];
+      if (typeof chunk === "string" || Buffer.isBuffer(chunk) || chunk instanceof Uint8Array) {
+        ensureResponseBodyCapture().addChunk(
+          chunk,
+          typeof args[1] === "string" ? args[1] : void 0
+        );
+      }
+    } catch (error) {
+      (0, import_logger.logDebug)(`Error observing a response chunk: ${String(error)}`);
+    }
+  };
+  const originalWrite = response.write;
+  response.write = function(...args) {
+    recordResponseChunk(args);
+    return originalWrite.apply(this, args);
+  };
+  const originalEnd = response.end;
+  response.end = function(...args) {
+    recordResponseChunk(args);
+    return originalEnd.apply(this, args);
+  };
+  return new Promise((resolve) => {
+    let completed = false;
+    const complete = (responseFinished) => {
+      if (completed) {
+        return;
+      }
+      completed = true;
+      const completedAtMillis = performance.now();
+      const capture = ensureResponseBodyCapture();
+      if (responseFinished) {
+        capture.markComplete();
+      }
+      resolve({
+        body: capture.body,
+        size: capture.size,
+        completedAtMillis,
+        responseFinished,
+        requestBody: {
+          body: requestBodyCapture?.body,
+          size: requestBodyCapture?.size
+        }
+      });
+    };
+    response.on("finish", () => complete(true));
+    response.on("close", () => complete(false));
+  });
+}
+function registerServerCloseFlush(request) {
+  const server = request.socket?.server;
+  if (!server || typeof server.on !== "function" || flushOnCloseServers.has(server)) {
+    return;
+  }
+  flushOnCloseServers.add(server);
+  server.on("close", () => {
+    (0, import_activation.flushTelemetry)().catch((error) => {
+      (0, import_logger.logDebug)(`Error flushing telemetry on server close: ${String(error)}`);
+    });
+  });
+}
+function observeRequestBody(request, requestBodyCapture) {
+  const originalEmit = request.emit;
+  request.emit = function(event, ...args) {
+    try {
+      if (event === "data") {
+        const chunk = args[0];
+        if (typeof chunk === "string" || Buffer.isBuffer(chunk) || chunk instanceof Uint8Array) {
+          requestBodyCapture.addChunk(chunk);
+        }
+      } else if (event === "end") {
+        requestBodyCapture.markComplete();
+      }
+    } catch (error) {
+      (0, import_logger.logDebug)(`Error observing a request body chunk: ${String(error)}`);
+    }
+    return originalEmit.call(this, event, ...args);
+  };
+}
+function firstStringValue(value) {
+  if (typeof value === "string") {
+    return value;
+  }
+  if (Array.isArray(value)) {
+    return value[0];
+  }
+  return void 0;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  captureNodeResponse,
+  registerServerCloseFlush,
+  startNodeRequestObservation
+});
+//# sourceMappingURL=requestObservationNode.cjs.map

package/dist/requestObservationNode.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/requestObservationNode.ts"],"sourcesContent":["import type { IncomingMessage, ServerResponse } from \"node:http\";\nimport { type Context, context, propagation, ROOT_CONTEXT } from \"@opentelemetry/api\";\nimport { flushTelemetry } from \"./activation.js\";\nimport { BodyCapture, type CapturedBody } from \"./bodyCapture.js\";\nimport { getConfig } from \"./config.js\";\nimport { logDebug } from \"./logger.js\";\nimport {\n  type RequestObservation,\n  resolveHttpRequestStartAttributes,\n  startRequestObservation,\n} from \"./requestObservation.js\";\n\nconst flushOnCloseServers = new WeakSet<object>();\n\nexport interface StartNodeRequestObservationOptions {\n  request: IncomingMessage;\n  tracerName: string;\n}\n\nexport interface NodeRequestObservation extends RequestObservation {\n  requestBodyCapture: BodyCapture;\n  requestUrl: string;\n}\n\nexport interface StartedNodeRequestObservation {\n  observation: NodeRequestObservation;\n  requestContext: Context;\n}\n\nexport function startNodeRequestObservation(\n  options: StartNodeRequestObservationOptions,\n): StartedNodeRequestObservation {\n  const { request } = options;\n  const startTimeMillis = performance.now();\n  const method = (request.method ?? \"GET\").toUpperCase();\n  const requestUrl = request.url ?? \"/\";\n  const requestBodyCapture = new BodyCapture({\n    captureBody: getConfig().captureRequestBody,\n    contentType: request.headers[\"content-type\"],\n    contentLength: request.headers[\"content-length\"],\n    transferEncoding: request.headers[\"transfer-encoding\"],\n  });\n  observeRequestBody(request, requestBodyCapture);\n\n  const queryIndex = requestUrl.indexOf(\"?\");\n  const scheme = (request.socket as { encrypted?: boolean } | undefined)?.encrypted\n    ? \"https\"\n    : \"http\";\n  const host = request.headers.host;\n  let serverAddress: string | undefined;\n  if (host) {\n    try {\n      serverAddress = new URL(`${scheme}://${host}`).hostname;\n    } catch {\n      // An invalid Host header leaves the server address unset.\n    }\n  }\n  const startAttributes = resolveHttpRequestStartAttributes({\n    method,\n    path: queryIndex === -1 ? requestUrl : requestUrl.slice(0, queryIndex),\n    query: queryIndex === -1 ? undefined : requestUrl.slice(queryIndex + 1) || undefined,\n    scheme,\n    serverAddress,\n    fullUrl: host ? `${scheme}://${host}${requestUrl}` : undefined,\n    clientAddress: request.socket?.remoteAddress || undefined,\n    userAgent:\n      typeof request.headers[\"user-agent\"] === \"string\" ? request.headers[\"user-agent\"] : undefined,\n    requestBodySize: requestBodyCapture.size,\n  });\n  const { requestRecord, requestContext, spanHandle, rpcMetadata } = startRequestObservation({\n    activeContext: context.active(),\n    extractedContext: propagation.extract(ROOT_CONTEXT, request.headers),\n    tracerName: options.tracerName,\n    method,\n    startAttributes,\n    requestBodyCapture,\n  });\n  return {\n    observation: {\n      requestRecord,\n      spanHandle,\n      rpcMetadata,\n      requestBodyCapture,\n      startTimeMillis,\n      method,\n      requestUrl,\n    },\n    requestContext,\n  };\n}\n\nexport interface NodeResponseCompletion extends CapturedBody {\n  completedAtMillis: number;\n  responseFinished: boolean;\n  requestBody: CapturedBody;\n}\n\n// Patching write and end before framework dispatch lets compression wrappers\n// feed their final wire bytes through capture.\nexport function captureNodeResponse(\n  response: ServerResponse,\n  shouldCaptureBody: boolean,\n  requestBodyCapture?: BodyCapture,\n  resolveResponseHeader: (name: string) => string | number | string[] | undefined = (name) =>\n    response.getHeader(name),\n): Promise<NodeResponseCompletion> {\n  let responseBodyCapture: BodyCapture | undefined;\n  const ensureResponseBodyCapture = (): BodyCapture => {\n    responseBodyCapture ??= new BodyCapture({\n      captureBody: shouldCaptureBody,\n      contentType: firstStringValue(resolveResponseHeader(\"content-type\")),\n      contentLength: resolveResponseHeader(\"content-length\"),\n      transferEncoding: resolveResponseHeader(\"transfer-encoding\") as string | string[] | undefined,\n    });\n    return responseBodyCapture;\n  };\n  const recordResponseChunk = (args: unknown[]): void => {\n    try {\n      const chunk = args[0];\n      if (typeof chunk === \"string\" || Buffer.isBuffer(chunk) || chunk instanceof Uint8Array) {\n        ensureResponseBodyCapture().addChunk(\n          chunk,\n          typeof args[1] === \"string\" ? (args[1] as BufferEncoding) : undefined,\n        );\n      }\n    } catch (error) {\n      logDebug(`Error observing a response chunk: ${String(error)}`);\n    }\n  };\n  const originalWrite = response.write as (...args: unknown[]) => boolean;\n  response.write = function (this: ServerResponse, ...args: unknown[]): boolean {\n    recordResponseChunk(args);\n    return originalWrite.apply(this, args);\n  } as typeof response.write;\n  const originalEnd = response.end as (...args: unknown[]) => ServerResponse;\n  response.end = function (this: ServerResponse, ...args: unknown[]): ServerResponse {\n    recordResponseChunk(args);\n    return originalEnd.apply(this, args);\n  } as typeof response.end;\n\n  return new Promise((resolve) => {\n    let completed = false;\n    const complete = (responseFinished: boolean): void => {\n      if (completed) {\n        return;\n      }\n      completed = true;\n      const completedAtMillis = performance.now();\n      const capture = ensureResponseBodyCapture();\n      if (responseFinished) {\n        capture.markComplete();\n      }\n      resolve({\n        body: capture.body,\n        size: capture.size,\n        completedAtMillis,\n        responseFinished,\n        requestBody: {\n          body: requestBodyCapture?.body,\n          size: requestBodyCapture?.size,\n        },\n      });\n    };\n    response.on(\"finish\", () => complete(true));\n    response.on(\"close\", () => complete(false));\n  });\n}\n\n// Closing a server triggers a flush of buffered telemetry, never a teardown:\n// an app bound to several servers keeps exporting on the still-open ones.\nexport function registerServerCloseFlush(request: IncomingMessage): void {\n  const server = (request.socket as { server?: unknown } | undefined)?.server;\n  if (\n    !server ||\n    typeof (server as { on?: unknown }).on !== \"function\" ||\n    flushOnCloseServers.has(server as object)\n  ) {\n    return;\n  }\n  flushOnCloseServers.add(server as object);\n  (server as { on: (event: string, listener: () => void) => void }).on(\"close\", () => {\n    flushTelemetry().catch((error: unknown) => {\n      logDebug(`Error flushing telemetry on server close: ${String(error)}`);\n    });\n  });\n}\n\n// Wrapping emit observes only bytes delivered to application consumers and does\n// not change the stream's flow state.\nfunction observeRequestBody(request: IncomingMessage, requestBodyCapture: BodyCapture): void {\n  const originalEmit = request.emit as (...args: unknown[]) => boolean;\n  (request as { emit: unknown }).emit = function (\n    this: IncomingMessage,\n    event: string | symbol,\n    ...args: unknown[]\n  ): boolean {\n    try {\n      if (event === \"data\") {\n        const chunk = args[0];\n        if (typeof chunk === \"string\" || Buffer.isBuffer(chunk) || chunk instanceof Uint8Array) {\n          requestBodyCapture.addChunk(chunk);\n        }\n      } else if (event === \"end\") {\n        requestBodyCapture.markComplete();\n      }\n    } catch (error) {\n      logDebug(`Error observing a request body chunk: ${String(error)}`);\n    }\n    return originalEmit.call(this, event, ...args);\n  };\n}\n\nfunction firstStringValue(value: string | number | string[] | undefined): string | undefined {\n  if (typeof value === \"string\") {\n    return value;\n  }\n  if (Array.isArray(value)) {\n    return value[0];\n  }\n  return undefined;\n}\n"],"mappings":"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","names":[]}

package/dist/requestObservationNode.d.cts

@@ -0,0 +1,29 @@
+import { IncomingMessage, ServerResponse } from 'node:http';
+import { Context } from '@opentelemetry/api';
+import { BodyCapture, CapturedBody } from './bodyCapture.cjs';
+import { RequestObservation } from './requestObservation.cjs';
+import '@opentelemetry/core';
+import './context.cjs';
+
+interface StartNodeRequestObservationOptions {
+    request: IncomingMessage;
+    tracerName: string;
+}
+interface NodeRequestObservation extends RequestObservation {
+    requestBodyCapture: BodyCapture;
+    requestUrl: string;
+}
+interface StartedNodeRequestObservation {
+    observation: NodeRequestObservation;
+    requestContext: Context;
+}
+declare function startNodeRequestObservation(options: StartNodeRequestObservationOptions): StartedNodeRequestObservation;
+interface NodeResponseCompletion extends CapturedBody {
+    completedAtMillis: number;
+    responseFinished: boolean;
+    requestBody: CapturedBody;
+}
+declare function captureNodeResponse(response: ServerResponse, shouldCaptureBody: boolean, requestBodyCapture?: BodyCapture, resolveResponseHeader?: (name: string) => string | number | string[] | undefined): Promise<NodeResponseCompletion>;
+declare function registerServerCloseFlush(request: IncomingMessage): void;
+
+export { type NodeRequestObservation, type NodeResponseCompletion, type StartNodeRequestObservationOptions, type StartedNodeRequestObservation, captureNodeResponse, registerServerCloseFlush, startNodeRequestObservation };