apitally 0.25.8 → 1.0.0-beta.1

package/dist/requestObservation.cjs

@@ -0,0 +1,246 @@
+"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 requestObservation_exports = {};
+__export(requestObservation_exports, {
+  finalizeRequestObservation: () => finalizeRequestObservation,
+  finalizeRequestObservationWithError: () => finalizeRequestObservationWithError,
+  resolveHttpRequestStartAttributes: () => resolveHttpRequestStartAttributes,
+  startRequestObservation: () => startRequestObservation
+});
+module.exports = __toCommonJS(requestObservation_exports);
+var import_api = require("@opentelemetry/api");
+var import_core = require("@opentelemetry/core");
+var import_config = require('./config.cjs');
+var import_context = require('./context.cjs');
+var import_exceptions = require('./exceptions.cjs');
+var import_logger = require('./logger.cjs');
+var import_requestAttributes = require('./requestAttributes.cjs');
+var import_serverErrors = require('./serverErrors.cjs');
+var import_spanProcessor = require('./spanProcessor.cjs');
+var import_validationErrors = require('./validationErrors.cjs');
+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 = (0, import_context.getConsumerHolder)(activeContext) ?? {};
+  Object.assign(requestRecord.attributes, startAttributes);
+  const activeSpan = import_api.trace.getSpan(activeContext);
+  const resolveUnavailableSpanDropReason = () => (0, import_spanProcessor.getActiveSpanPipeline)()?.resolveRequestDropReasonBeforeSampling(startAttributes) ?? "sampled-out";
+  let requestContext;
+  if (activeSpan?.isRecording() && activeSpan.kind === import_api.SpanKind.SERVER) {
+    spanHandle.span = activeSpan;
+    requestRecord.serverSpanId = activeSpan.spanContext().spanId;
+    (0, import_spanProcessor.getActiveSpanPipeline)()?.attachRequestRecord(requestRecord.serverSpanId, requestRecord);
+    if ((0, import_spanProcessor.getActiveSpanPipeline)()?.isRequestInFlight(requestRecord.serverSpanId) !== true) {
+      requestRecord.dropReason = resolveUnavailableSpanDropReason();
+    }
+    requestContext = (0, import_context.withRequestHolders)(activeContext, spanHandle, requestRecord, consumerHolder);
+  } else if (activeSpan && !activeSpan.isRecording() && !activeSpan.spanContext().isRemote) {
+    requestRecord.dropReason = resolveUnavailableSpanDropReason();
+    if (requestRecord.dropReason === "sampled-out") {
+      warnAboutNonRecordingServerSpan();
+    }
+    requestContext = (0, import_context.withRequestHolders)(activeContext, spanHandle, requestRecord, consumerHolder);
+  } else {
+    requestContext = (0, import_context.withRequestHolders)(
+      extractedContext,
+      spanHandle,
+      requestRecord,
+      consumerHolder
+    );
+    const ownSpan = import_api.trace.getTracer(tracerName).startSpan(method, { kind: import_api.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 ((0, import_spanProcessor.isApitallySpanProcessorDeclared)() && requestRecord.serverSpanId === void 0) {
+        requestRecord.dropReason = resolveUnavailableSpanDropReason();
+        if (requestRecord.dropReason === "sampled-out") {
+          warnAboutUnattachedSpanProcessor();
+        }
+      }
+    }
+    requestContext = import_api.trace.setSpan(requestContext, ownSpan);
+  }
+  let rpcMetadata = (0, import_core.getRPCMetadata)(requestContext);
+  if (!rpcMetadata && spanHandle.span) {
+    rpcMetadata = { type: import_core.RPCType.HTTP, span: spanHandle.span };
+    requestContext = (0, import_core.setRPCMetadata)(requestContext, rpcMetadata);
+  }
+  (0, import_context.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) {
+    (0, import_requestAttributes.writeRequestAttribute)(span, requestRecord, "client.address", options.clientAddress);
+  }
+  (0, import_requestAttributes.writeRequestAttribute)(span, requestRecord, "http.response.status_code", statusCode);
+  const requestBodySize = options.capturedRequestBody?.size;
+  if (requestBodySize !== void 0) {
+    (0, import_requestAttributes.writeRequestAttribute)(span, requestRecord, "http.request.body.size", requestBodySize);
+  }
+  const responseBodySize = options.capturedResponseBody?.size;
+  if (responseBodySize !== void 0) {
+    (0, import_requestAttributes.writeRequestAttribute)(span, requestRecord, "http.response.body.size", responseBodySize);
+  }
+  if (route !== void 0) {
+    (0, import_requestAttributes.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: import_api.SpanStatusCode.ERROR });
+  }
+  const consumer = requestRecord.attributes["apitally.consumer.identifier"];
+  const consumerIdentifier = typeof consumer === "string" ? consumer : void 0;
+  if (requestRecord.validationErrors && (0, import_validationErrors.isValidationResponseStatus)(statusCode)) {
+    (0, import_validationErrors.addValidationErrors)(consumerIdentifier, method, route ?? "", requestRecord.validationErrors);
+  }
+  if (statusCode === 500 && requestRecord.exception !== void 0) {
+    const sentryEventId = requestRecord.attributes["apitally.exception.sentry_event_id"];
+    (0, import_serverErrors.addServerError)(
+      consumerIdentifier,
+      method,
+      route ?? "",
+      requestRecord.exception,
+      typeof sentryEventId === "string" ? sentryEventId : void 0
+    );
+  }
+  if (requestRecord.serverSpanId !== void 0 && requestRecord.dropReason === void 0) {
+    const config = (0, import_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 && config.captureResponseBody) {
+      stash.responseBody = responseBody;
+    }
+    if (Object.keys(stash).length > 0) {
+      (0, import_spanProcessor.getActiveSpanPipeline)()?.updateStash(requestRecord.serverSpanId, stash);
+    }
+  }
+  ownSpan?.end(options.completedAtMillis);
+  (0, import_spanProcessor.getActiveSpanPipeline)()?.handleTransportCompletion(requestRecord);
+}
+function finalizeRequestObservationWithError(options) {
+  const { requestRecord, spanHandle, error, durationSeconds } = options;
+  requestRecord.durationSeconds = durationSeconds;
+  if (spanHandle.span?.isRecording()) {
+    spanHandle.span.recordException((0, import_exceptions.coerceToException)(error));
+  }
+  if (spanHandle.ownSpan) {
+    spanHandle.ownSpan.setStatus({ code: import_api.SpanStatusCode.ERROR });
+    spanHandle.ownSpan.end();
+  }
+  (0, import_spanProcessor.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() {
+  (0, import_logger.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() {
+  (0, import_logger.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."
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  finalizeRequestObservation,
+  finalizeRequestObservationWithError,
+  resolveHttpRequestStartAttributes,
+  startRequestObservation
+});
+//# sourceMappingURL=requestObservation.cjs.map

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 { addServerError } from \"./serverErrors.js\";\nimport {\n  getActiveSpanPipeline,\n  isApitallySpanProcessorDeclared,\n  type RequestStash,\n} from \"./spanProcessor.js\";\nimport { addValidationErrors, isValidationResponseStatus } from \"./validationErrors.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    getActiveSpanPipeline()?.attachRequestRecord(requestRecord.serverSpanId, requestRecord);\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() && !activeSpan.spanContext().isRemote) {\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  // Validation and server errors are counted for every routed request,\n  // including requests dropped from tracing.\n  const consumer = requestRecord.attributes[\"apitally.consumer.identifier\"];\n  const consumerIdentifier = typeof consumer === \"string\" ? consumer : undefined;\n  if (requestRecord.validationErrors && isValidationResponseStatus(statusCode)) {\n    addValidationErrors(consumerIdentifier, method, route ?? \"\", requestRecord.validationErrors);\n  }\n  if (statusCode === 500 && requestRecord.exception !== undefined) {\n    const sentryEventId = requestRecord.attributes[\"apitally.exception.sentry_event_id\"];\n    addServerError(\n      consumerIdentifier,\n      method,\n      route ?? \"\",\n      requestRecord.exception,\n      typeof sentryEventId === \"string\" ? sentryEventId : undefined,\n    );\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 && config.captureResponseBody) {\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,62 @@
+import { Context, Attributes } from '@opentelemetry/api';
+import { RPCMetadata } from '@opentelemetry/core';
+import { CapturedBody, BodyCapture } from './bodyCapture.cjs';
+import { RequestRecord, SpanHandle } from './context.cjs';
+import './validationErrors.cjs';
+import '@opentelemetry/api-logs';
+
+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,62 @@
+import { Context, Attributes } from '@opentelemetry/api';
+import { RPCMetadata } from '@opentelemetry/core';
+import { CapturedBody, BodyCapture } from './bodyCapture.js';
+import { RequestRecord, SpanHandle } from './context.js';
+import './validationErrors.js';
+import '@opentelemetry/api-logs';
+
+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,226 @@
+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 { addServerError } from "./serverErrors.js";
+import {
+  getActiveSpanPipeline,
+  isApitallySpanProcessorDeclared
+} from "./spanProcessor.js";
+import { addValidationErrors, isValidationResponseStatus } from "./validationErrors.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;
+    getActiveSpanPipeline()?.attachRequestRecord(requestRecord.serverSpanId, requestRecord);
+    if (getActiveSpanPipeline()?.isRequestInFlight(requestRecord.serverSpanId) !== true) {
+      requestRecord.dropReason = resolveUnavailableSpanDropReason();
+    }
+    requestContext = withRequestHolders(activeContext, spanHandle, requestRecord, consumerHolder);
+  } else if (activeSpan && !activeSpan.isRecording() && !activeSpan.spanContext().isRemote) {
+    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 });
+  }
+  const consumer = requestRecord.attributes["apitally.consumer.identifier"];
+  const consumerIdentifier = typeof consumer === "string" ? consumer : void 0;
+  if (requestRecord.validationErrors && isValidationResponseStatus(statusCode)) {
+    addValidationErrors(consumerIdentifier, method, route ?? "", requestRecord.validationErrors);
+  }
+  if (statusCode === 500 && requestRecord.exception !== void 0) {
+    const sentryEventId = requestRecord.attributes["apitally.exception.sentry_event_id"];
+    addServerError(
+      consumerIdentifier,
+      method,
+      route ?? "",
+      requestRecord.exception,
+      typeof sentryEventId === "string" ? sentryEventId : void 0
+    );
+  }
+  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 && config.captureResponseBody) {
+      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