@elto/telemetry 0.1.0

package/dist/node/index.cjs

@@ -0,0 +1,204 @@
+"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);
+
+// src/node/index.ts
+var node_exports = {};
+__export(node_exports, {
+  DEFAULT_OTEL_ENDPOINT: () => DEFAULT_OTEL_ENDPOINT,
+  createEndpoints: () => createEndpoints,
+  createNodeOtelLayer: () => createNodeOtelLayer
+});
+module.exports = __toCommonJS(node_exports);
+
+// src/node/sdk.ts
+var import_opentelemetry = require("@effect/opentelemetry");
+var import_exporter_trace_otlp_http = require("@opentelemetry/exporter-trace-otlp-http");
+var import_exporter_metrics_otlp_http = require("@opentelemetry/exporter-metrics-otlp-http");
+var import_exporter_logs_otlp_http = require("@opentelemetry/exporter-logs-otlp-http");
+var import_sdk_trace_base = require("@opentelemetry/sdk-trace-base");
+var import_sdk_metrics = require("@opentelemetry/sdk-metrics");
+var import_sdk_logs = require("@opentelemetry/sdk-logs");
+
+// src/common/span-processors.ts
+var DROP_ATTRIBUTE_KEY = "telemetry.drop";
+var REDACTED_VALUE = "[redacted]";
+var STATEMENT_MAX_LENGTH = 12;
+var STATEMENT_HEAD_LENGTH = 3;
+var STATEMENT_TAIL_LENGTH = 3;
+var PII_ATTRIBUTE_KEYS = /* @__PURE__ */ new Set(["user.email", "note.id", "profile.id"]);
+var getAttributes = (span) => span.attributes ?? {};
+var setAttribute = (span, key, value) => {
+  const target = span;
+  if (typeof target.setAttribute === "function") {
+    target.setAttribute(key, value);
+  }
+  if (target.attributes) {
+    target.attributes[key] = value;
+  }
+};
+var hashString = (value) => {
+  let hash = 2166136261;
+  for (let index = 0; index < value.length; index += 1) {
+    hash ^= value.charCodeAt(index);
+    hash = Math.imul(hash, 16777619);
+  }
+  return (hash >>> 0).toString(16).padStart(8, "0");
+};
+var hashAttributeValue = (value) => {
+  if (Array.isArray(value)) {
+    return hashString(value.map((item) => String(item)).join("|"));
+  }
+  return hashString(String(value));
+};
+var redactConnectionString = (value) => value.replace(/\/\/([^@/]+)@/, "//***:***@");
+var stripUrlQuery = (value) => value.split("?")[0] ?? value;
+var shortenStatement = (statement) => {
+  if (statement.length <= STATEMENT_MAX_LENGTH) {
+    return statement;
+  }
+  const head = statement.slice(0, STATEMENT_HEAD_LENGTH);
+  const tail = statement.slice(-STATEMENT_TAIL_LENGTH);
+  const removed = statement.length - (STATEMENT_HEAD_LENGTH + STATEMENT_TAIL_LENGTH);
+  return `${head}...${tail} (+ ${removed} characters)`;
+};
+var shouldDropSpan = (span) => {
+  const attributes = getAttributes(span);
+  const drop = attributes[DROP_ATTRIBUTE_KEY];
+  return drop === true || drop === "true";
+};
+var sanitizeAttributes = (span, piiAttributes) => {
+  const attributes = getAttributes(span);
+  let redactions = 0;
+  let transformed = 0;
+  const piiKeys = piiAttributes ?? PII_ATTRIBUTE_KEYS;
+  for (const [key, value] of Object.entries(attributes)) {
+    if (value === void 0) {
+      continue;
+    }
+    if (piiKeys.has(key)) {
+      setAttribute(span, `${key}_hash`, hashAttributeValue(value));
+      setAttribute(span, key, REDACTED_VALUE);
+      redactions += 1;
+      continue;
+    }
+    if (key === "db.connection_string" && typeof value === "string") {
+      setAttribute(span, "db.connection_string_redacted", redactConnectionString(value));
+      setAttribute(span, key, REDACTED_VALUE);
+      redactions += 1;
+      continue;
+    }
+    if (key === "db.statement" && typeof value === "string") {
+      const shortened = shortenStatement(value);
+      if (shortened !== value) {
+        setAttribute(span, key, shortened);
+        transformed += 1;
+      }
+      continue;
+    }
+    if (key === "http.url" && typeof value === "string") {
+      const sanitized = stripUrlQuery(value);
+      if (sanitized !== value) {
+        setAttribute(span, key, sanitized);
+        transformed += 1;
+      }
+    }
+  }
+  const statusCode = attributes["http.status_code"];
+  if (typeof statusCode === "number") {
+    setAttribute(span, "http.status_category", `${Math.floor(statusCode / 100)}xx`);
+    transformed += 1;
+  }
+  if (redactions > 0 || transformed > 0) {
+    setAttribute(span, "telemetry.redactions", redactions);
+    setAttribute(span, "telemetry.transformations", transformed);
+  }
+};
+var CustomSpanProcessor = class {
+  constructor(delegate, piiAttributes) {
+    this.delegate = delegate;
+    this.piiAttributes = piiAttributes;
+  }
+  onStart(span, parentContext) {
+    sanitizeAttributes(span, this.piiAttributes);
+    this.delegate.onStart(span, parentContext);
+  }
+  onEnd(span) {
+    sanitizeAttributes(span, this.piiAttributes);
+    if (shouldDropSpan(span)) {
+      return;
+    }
+    this.delegate.onEnd(span);
+  }
+  shutdown() {
+    return this.delegate.shutdown();
+  }
+  forceFlush() {
+    return this.delegate.forceFlush();
+  }
+};
+var createCustomSpanProcessor = (delegate, piiConfig) => new CustomSpanProcessor(delegate, piiConfig?.piiAttributeKeys);
+
+// src/node/sdk.ts
+var DEFAULT_OTEL_ENDPOINT = "http://localhost:4318";
+function createEndpoints(baseUrl = DEFAULT_OTEL_ENDPOINT) {
+  return {
+    traces: `${baseUrl}/v1/traces`,
+    logs: `${baseUrl}/v1/logs`,
+    metrics: `${baseUrl}/v1/metrics`
+  };
+}
+function createNodeOtelLayer(config) {
+  const { resource, endpoints, metricExportIntervalMs = 1e4 } = config;
+  if (!endpoints.metrics) {
+    throw new Error("metrics endpoint is required for Node.js SDK");
+  }
+  const metricsUrl = endpoints.metrics;
+  return import_opentelemetry.NodeSdk.layer(() => ({
+    resource: {
+      serviceName: resource.serviceName,
+      serviceVersion: resource.serviceVersion
+    },
+    spanProcessor: createCustomSpanProcessor(
+      new import_sdk_trace_base.BatchSpanProcessor(
+        new import_exporter_trace_otlp_http.OTLPTraceExporter({
+          url: endpoints.traces
+        })
+      ),
+      config.piiConfig
+    ),
+    metricReader: new import_sdk_metrics.PeriodicExportingMetricReader({
+      exporter: new import_exporter_metrics_otlp_http.OTLPMetricExporter({
+        url: metricsUrl
+      }),
+      exportIntervalMillis: metricExportIntervalMs
+    }),
+    logRecordProcessor: new import_sdk_logs.BatchLogRecordProcessor(
+      new import_exporter_logs_otlp_http.OTLPLogExporter({
+        url: endpoints.logs
+      })
+    )
+  }));
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_OTEL_ENDPOINT,
+  createEndpoints,
+  createNodeOtelLayer
+});
+//# sourceMappingURL=index.cjs.map

package/dist/node/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/node/index.ts","../../src/node/sdk.ts","../../src/common/span-processors.ts"],"sourcesContent":["/**\n * Node.js OpenTelemetry integration for Effect\n *\n * This module provides utilities for configuring OpenTelemetry in Node.js applications.\n *\n * @example\n * ```typescript\n * import { createNodeOtelLayer, createEndpoints } from \"@elto/telemetry/node\";\n *\n * const OtelLive = createNodeOtelLayer({\n *   resource: {\n *     serviceName: \"api-server\",\n *     serviceVersion: \"1.0.0\",\n *   },\n *   endpoints: createEndpoints(\"http://localhost:4318\"),\n * });\n * ```\n *\n * @packageDocumentation\n */\nexport { createNodeOtelLayer, createEndpoints, DEFAULT_OTEL_ENDPOINT } from \"./sdk.js\";\n\nexport type { NodeSdkConfig, ResourceConfig, EndpointConfig } from \"../common/types.js\";\n","import { NodeSdk } from \"@effect/opentelemetry\";\nimport { OTLPTraceExporter } from \"@opentelemetry/exporter-trace-otlp-http\";\nimport { OTLPMetricExporter } from \"@opentelemetry/exporter-metrics-otlp-http\";\nimport { OTLPLogExporter } from \"@opentelemetry/exporter-logs-otlp-http\";\nimport { BatchSpanProcessor } from \"@opentelemetry/sdk-trace-base\";\nimport { PeriodicExportingMetricReader } from \"@opentelemetry/sdk-metrics\";\nimport { BatchLogRecordProcessor } from \"@opentelemetry/sdk-logs\";\nimport { createCustomSpanProcessor } from \"../common/span-processors.js\";\nimport type { NodeSdkConfig, EndpointConfig } from \"../common/types.js\";\n\n/**\n * Default OpenTelemetry collector endpoint\n */\nexport const DEFAULT_OTEL_ENDPOINT = \"http://localhost:4318\";\n\n/**\n * Create endpoint URLs for OTLP exporters\n *\n * @param baseUrl - Base URL of the OpenTelemetry collector (e.g., \"http://localhost:4318\")\n * @returns Endpoint configuration object\n *\n * @example\n * ```typescript\n * const endpoints = createEndpoints(\"http://localhost:4318\");\n * // Returns: {\n * //   traces: \"http://localhost:4318/v1/traces\",\n * //   logs: \"http://localhost:4318/v1/logs\",\n * //   metrics: \"http://localhost:4318/v1/metrics\"\n * // }\n * ```\n */\nexport function createEndpoints(baseUrl: string = DEFAULT_OTEL_ENDPOINT): EndpointConfig {\n  return {\n    traces: `${baseUrl}/v1/traces`,\n    logs: `${baseUrl}/v1/logs`,\n    metrics: `${baseUrl}/v1/metrics`,\n  };\n}\n\n/**\n * Create an OpenTelemetry Layer for Node.js applications\n *\n * This layer configures:\n * - OTLP HTTP exporter for traces (to Jaeger)\n * - OTLP HTTP exporter for metrics (to Prometheus)\n * - OTLP HTTP exporter for logs (to Loki)\n * - Custom span processor for redaction/filtering before export\n * - Batch processors for efficient batching\n *\n * @param config - Configuration object\n * @returns Effect Layer for OpenTelemetry\n *\n * @example\n * ```typescript\n * import { createNodeOtelLayer, createEndpoints } from \"@elto/telemetry/node\";\n *\n * const OtelLive = createNodeOtelLayer({\n *   resource: {\n *     serviceName: \"api-server\",\n *     serviceVersion: \"1.0.0\",\n *   },\n *   endpoints: createEndpoints(\"http://localhost:4318\"),\n *   metricExportIntervalMs: 10000, // optional, default 10000\n * });\n * ```\n */\nexport function createNodeOtelLayer(config: NodeSdkConfig) {\n  const { resource, endpoints, metricExportIntervalMs = 10000 } = config;\n\n  if (!endpoints.metrics) {\n    throw new Error(\"metrics endpoint is required for Node.js SDK\");\n  }\n\n  const metricsUrl = endpoints.metrics;\n\n  return NodeSdk.layer(() => ({\n    resource: {\n      serviceName: resource.serviceName,\n      serviceVersion: resource.serviceVersion,\n    },\n    spanProcessor: createCustomSpanProcessor(\n      new BatchSpanProcessor(\n        new OTLPTraceExporter({\n          url: endpoints.traces,\n        }),\n      ),\n      config.piiConfig,\n    ),\n    metricReader: new PeriodicExportingMetricReader({\n      exporter: new OTLPMetricExporter({\n        url: metricsUrl,\n      }),\n      exportIntervalMillis: metricExportIntervalMs,\n    }),\n    logRecordProcessor: new BatchLogRecordProcessor(\n      new OTLPLogExporter({\n        url: endpoints.logs,\n      }),\n    ),\n  }));\n}\n","import type { AttributeValue, Context } from \"@opentelemetry/api\";\nimport type { ReadableSpan, Span, SpanProcessor } from \"@opentelemetry/sdk-trace-base\";\nimport type { PIIConfig } from \"./types\";\n\n/**\n * Default span processor used by @elto/telemetry to normalize and sanitize\n * attributes before export. It is intentionally small and opinionated so\n * demo traces stay safe and readable.\n */\ntype SpanAttributes = Record<string, AttributeValue | undefined>;\n\nconst DROP_ATTRIBUTE_KEY = \"telemetry.drop\";\nconst REDACTED_VALUE = \"[redacted]\";\nconst STATEMENT_MAX_LENGTH = 12;\nconst STATEMENT_HEAD_LENGTH = 3;\nconst STATEMENT_TAIL_LENGTH = 3;\n\nconst PII_ATTRIBUTE_KEYS = new Set([\"user.email\", \"note.id\", \"profile.id\"]);\n\nconst getAttributes = (span: Span | ReadableSpan): SpanAttributes =>\n  (span as { attributes?: SpanAttributes }).attributes ?? {};\n\nconst setAttribute = (span: Span | ReadableSpan, key: string, value: AttributeValue) => {\n  const target = span as {\n    setAttribute?: (attributeKey: string, attributeValue: AttributeValue) => void;\n    attributes?: SpanAttributes;\n  };\n\n  if (typeof target.setAttribute === \"function\") {\n    target.setAttribute(key, value);\n  }\n\n  if (target.attributes) {\n    target.attributes[key] = value;\n  }\n};\n\nconst hashString = (value: string) => {\n  let hash = 2166136261;\n  for (let index = 0; index < value.length; index += 1) {\n    hash ^= value.charCodeAt(index);\n    hash = Math.imul(hash, 16777619);\n  }\n  return (hash >>> 0).toString(16).padStart(8, \"0\");\n};\n\nconst hashAttributeValue = (value: AttributeValue) => {\n  if (Array.isArray(value)) {\n    return hashString(value.map((item) => String(item)).join(\"|\"));\n  }\n  return hashString(String(value));\n};\n\nconst redactConnectionString = (value: string) => value.replace(/\\/\\/([^@/]+)@/, \"//***:***@\");\n\nconst stripUrlQuery = (value: string) => value.split(\"?\")[0] ?? value;\n\n/**\n * Shorten a long SQL statement to a leading head + tail with a marker that\n * explains how many characters were removed.\n */\nconst shortenStatement = (statement: string) => {\n  if (statement.length <= STATEMENT_MAX_LENGTH) {\n    return statement;\n  }\n\n  const head = statement.slice(0, STATEMENT_HEAD_LENGTH);\n  const tail = statement.slice(-STATEMENT_TAIL_LENGTH);\n  const removed = statement.length - (STATEMENT_HEAD_LENGTH + STATEMENT_TAIL_LENGTH);\n  return `${head}...${tail} (+ ${removed} characters)`;\n};\n\nconst shouldDropSpan = (span: ReadableSpan) => {\n  const attributes = getAttributes(span);\n  const drop = attributes[DROP_ATTRIBUTE_KEY];\n  return drop === true || drop === \"true\";\n};\n\nconst sanitizeAttributes = (span: Span | ReadableSpan, piiAttributes?: Set<string>) => {\n  const attributes = getAttributes(span);\n  let redactions = 0;\n  let transformed = 0;\n\n  const piiKeys = piiAttributes ?? PII_ATTRIBUTE_KEYS;\n  for (const [key, value] of Object.entries(attributes)) {\n    if (value === undefined) {\n      continue;\n    }\n\n    if (piiKeys.has(key)) {\n      setAttribute(span, `${key}_hash`, hashAttributeValue(value));\n      setAttribute(span, key, REDACTED_VALUE);\n      redactions += 1;\n      continue;\n    }\n\n    if (key === \"db.connection_string\" && typeof value === \"string\") {\n      setAttribute(span, \"db.connection_string_redacted\", redactConnectionString(value));\n      setAttribute(span, key, REDACTED_VALUE);\n      redactions += 1;\n      continue;\n    }\n\n    if (key === \"db.statement\" && typeof value === \"string\") {\n      const shortened = shortenStatement(value);\n      if (shortened !== value) {\n        setAttribute(span, key, shortened);\n        transformed += 1;\n      }\n      continue;\n    }\n\n    if (key === \"http.url\" && typeof value === \"string\") {\n      const sanitized = stripUrlQuery(value);\n      if (sanitized !== value) {\n        setAttribute(span, key, sanitized);\n        transformed += 1;\n      }\n    }\n  }\n\n  const statusCode = attributes[\"http.status_code\"];\n  if (typeof statusCode === \"number\") {\n    setAttribute(span, \"http.status_category\", `${Math.floor(statusCode / 100)}xx`);\n    transformed += 1;\n  }\n\n  if (redactions > 0 || transformed > 0) {\n    setAttribute(span, \"telemetry.redactions\", redactions);\n    setAttribute(span, \"telemetry.transformations\", transformed);\n  }\n};\n\n/**\n * A SpanProcessor that applies redaction, attribute normalization, and optional\n * dropping before delegating to another processor (typically a BatchSpanProcessor).\n *\n * Behavior:\n * - Redacts `user.email`, `note.id`, and `profile.id` while adding `<key>_hash`.\n * - Redacts `db.connection_string` and stores a sanitized copy in\n *   `db.connection_string_redacted`.\n * - Shortens `db.statement` when it exceeds the configured threshold.\n * - Strips query strings from `http.url`.\n * - Adds `http.status_category` when `http.status_code` is present.\n * - Adds `telemetry.redactions` and `telemetry.transformations` counters.\n * - Drops spans when `telemetry.drop` is `true` or `\"true\"`.\n *\n * @param delegate - The SpanProcessor to delegate to after sanitization\n * @param piiAttributes - Optional set of span attribute keys whose values will be redacted.\n *   If provided, this overrides the default {@link PII_ATTRIBUTE_KEYS} (`user.email`, `note.id`, `profile.id`).\n *   For each matching key, the original value is replaced with `[redacted]` and a hash\n *   is stored in a `<key>_hash` attribute.\n */\nexport class CustomSpanProcessor implements SpanProcessor {\n  constructor(\n    private readonly delegate: SpanProcessor,\n    private readonly piiAttributes?: Set<string>,\n  ) {}\n\n  onStart(span: Span, parentContext: Context): void {\n    sanitizeAttributes(span, this.piiAttributes);\n    this.delegate.onStart(span, parentContext);\n  }\n\n  onEnd(span: ReadableSpan): void {\n    sanitizeAttributes(span, this.piiAttributes);\n    if (shouldDropSpan(span)) {\n      return;\n    }\n    this.delegate.onEnd(span);\n  }\n\n  shutdown(): Promise<void> {\n    return this.delegate.shutdown();\n  }\n\n  forceFlush(): Promise<void> {\n    return this.delegate.forceFlush();\n  }\n}\n\n/**\n * Convenience factory for wrapping a delegate SpanProcessor with the\n * @elto/telemetry custom sanitation behavior.\n */\nexport const createCustomSpanProcessor = (delegate: SpanProcessor, piiConfig?: PIIConfig) =>\n  new CustomSpanProcessor(delegate, piiConfig?.piiAttributeKeys);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,2BAAwB;AACxB,sCAAkC;AAClC,wCAAmC;AACnC,qCAAgC;AAChC,4BAAmC;AACnC,yBAA8C;AAC9C,sBAAwC;;;ACKxC,IAAM,qBAAqB;AAC3B,IAAM,iBAAiB;AACvB,IAAM,uBAAuB;AAC7B,IAAM,wBAAwB;AAC9B,IAAM,wBAAwB;AAE9B,IAAM,qBAAqB,oBAAI,IAAI,CAAC,cAAc,WAAW,YAAY,CAAC;AAE1E,IAAM,gBAAgB,CAAC,SACpB,KAAyC,cAAc,CAAC;AAE3D,IAAM,eAAe,CAAC,MAA2B,KAAa,UAA0B;AACtF,QAAM,SAAS;AAKf,MAAI,OAAO,OAAO,iBAAiB,YAAY;AAC7C,WAAO,aAAa,KAAK,KAAK;AAAA,EAChC;AAEA,MAAI,OAAO,YAAY;AACrB,WAAO,WAAW,GAAG,IAAI;AAAA,EAC3B;AACF;AAEA,IAAM,aAAa,CAAC,UAAkB;AACpC,MAAI,OAAO;AACX,WAAS,QAAQ,GAAG,QAAQ,MAAM,QAAQ,SAAS,GAAG;AACpD,YAAQ,MAAM,WAAW,KAAK;AAC9B,WAAO,KAAK,KAAK,MAAM,QAAQ;AAAA,EACjC;AACA,UAAQ,SAAS,GAAG,SAAS,EAAE,EAAE,SAAS,GAAG,GAAG;AAClD;AAEA,IAAM,qBAAqB,CAAC,UAA0B;AACpD,MAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,WAAO,WAAW,MAAM,IAAI,CAAC,SAAS,OAAO,IAAI,CAAC,EAAE,KAAK,GAAG,CAAC;AAAA,EAC/D;AACA,SAAO,WAAW,OAAO,KAAK,CAAC;AACjC;AAEA,IAAM,yBAAyB,CAAC,UAAkB,MAAM,QAAQ,iBAAiB,YAAY;AAE7F,IAAM,gBAAgB,CAAC,UAAkB,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK;AAMhE,IAAM,mBAAmB,CAAC,cAAsB;AAC9C,MAAI,UAAU,UAAU,sBAAsB;AAC5C,WAAO;AAAA,EACT;AAEA,QAAM,OAAO,UAAU,MAAM,GAAG,qBAAqB;AACrD,QAAM,OAAO,UAAU,MAAM,CAAC,qBAAqB;AACnD,QAAM,UAAU,UAAU,UAAU,wBAAwB;AAC5D,SAAO,GAAG,IAAI,MAAM,IAAI,OAAO,OAAO;AACxC;AAEA,IAAM,iBAAiB,CAAC,SAAuB;AAC7C,QAAM,aAAa,cAAc,IAAI;AACrC,QAAM,OAAO,WAAW,kBAAkB;AAC1C,SAAO,SAAS,QAAQ,SAAS;AACnC;AAEA,IAAM,qBAAqB,CAAC,MAA2B,kBAAgC;AACrF,QAAM,aAAa,cAAc,IAAI;AACrC,MAAI,aAAa;AACjB,MAAI,cAAc;AAElB,QAAM,UAAU,iBAAiB;AACjC,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,UAAU,GAAG;AACrD,QAAI,UAAU,QAAW;AACvB;AAAA,IACF;AAEA,QAAI,QAAQ,IAAI,GAAG,GAAG;AACpB,mBAAa,MAAM,GAAG,GAAG,SAAS,mBAAmB,KAAK,CAAC;AAC3D,mBAAa,MAAM,KAAK,cAAc;AACtC,oBAAc;AACd;AAAA,IACF;AAEA,QAAI,QAAQ,0BAA0B,OAAO,UAAU,UAAU;AAC/D,mBAAa,MAAM,iCAAiC,uBAAuB,KAAK,CAAC;AACjF,mBAAa,MAAM,KAAK,cAAc;AACtC,oBAAc;AACd;AAAA,IACF;AAEA,QAAI,QAAQ,kBAAkB,OAAO,UAAU,UAAU;AACvD,YAAM,YAAY,iBAAiB,KAAK;AACxC,UAAI,cAAc,OAAO;AACvB,qBAAa,MAAM,KAAK,SAAS;AACjC,uBAAe;AAAA,MACjB;AACA;AAAA,IACF;AAEA,QAAI,QAAQ,cAAc,OAAO,UAAU,UAAU;AACnD,YAAM,YAAY,cAAc,KAAK;AACrC,UAAI,cAAc,OAAO;AACvB,qBAAa,MAAM,KAAK,SAAS;AACjC,uBAAe;AAAA,MACjB;AAAA,IACF;AAAA,EACF;AAEA,QAAM,aAAa,WAAW,kBAAkB;AAChD,MAAI,OAAO,eAAe,UAAU;AAClC,iBAAa,MAAM,wBAAwB,GAAG,KAAK,MAAM,aAAa,GAAG,CAAC,IAAI;AAC9E,mBAAe;AAAA,EACjB;AAEA,MAAI,aAAa,KAAK,cAAc,GAAG;AACrC,iBAAa,MAAM,wBAAwB,UAAU;AACrD,iBAAa,MAAM,6BAA6B,WAAW;AAAA,EAC7D;AACF;AAsBO,IAAM,sBAAN,MAAmD;AAAA,EACxD,YACmB,UACA,eACjB;AAFiB;AACA;AAAA,EAChB;AAAA,EAEH,QAAQ,MAAY,eAA8B;AAChD,uBAAmB,MAAM,KAAK,aAAa;AAC3C,SAAK,SAAS,QAAQ,MAAM,aAAa;AAAA,EAC3C;AAAA,EAEA,MAAM,MAA0B;AAC9B,uBAAmB,MAAM,KAAK,aAAa;AAC3C,QAAI,eAAe,IAAI,GAAG;AACxB;AAAA,IACF;AACA,SAAK,SAAS,MAAM,IAAI;AAAA,EAC1B;AAAA,EAEA,WAA0B;AACxB,WAAO,KAAK,SAAS,SAAS;AAAA,EAChC;AAAA,EAEA,aAA4B;AAC1B,WAAO,KAAK,SAAS,WAAW;AAAA,EAClC;AACF;AAMO,IAAM,4BAA4B,CAAC,UAAyB,cACjE,IAAI,oBAAoB,UAAU,WAAW,gBAAgB;;;AD7KxD,IAAM,wBAAwB;AAkB9B,SAAS,gBAAgB,UAAkB,uBAAuC;AACvF,SAAO;AAAA,IACL,QAAQ,GAAG,OAAO;AAAA,IAClB,MAAM,GAAG,OAAO;AAAA,IAChB,SAAS,GAAG,OAAO;AAAA,EACrB;AACF;AA6BO,SAAS,oBAAoB,QAAuB;AACzD,QAAM,EAAE,UAAU,WAAW,yBAAyB,IAAM,IAAI;AAEhE,MAAI,CAAC,UAAU,SAAS;AACtB,UAAM,IAAI,MAAM,8CAA8C;AAAA,EAChE;AAEA,QAAM,aAAa,UAAU;AAE7B,SAAO,6BAAQ,MAAM,OAAO;AAAA,IAC1B,UAAU;AAAA,MACR,aAAa,SAAS;AAAA,MACtB,gBAAgB,SAAS;AAAA,IAC3B;AAAA,IACA,eAAe;AAAA,MACb,IAAI;AAAA,QACF,IAAI,kDAAkB;AAAA,UACpB,KAAK,UAAU;AAAA,QACjB,CAAC;AAAA,MACH;AAAA,MACA,OAAO;AAAA,IACT;AAAA,IACA,cAAc,IAAI,iDAA8B;AAAA,MAC9C,UAAU,IAAI,qDAAmB;AAAA,QAC/B,KAAK;AAAA,MACP,CAAC;AAAA,MACD,sBAAsB;AAAA,IACxB,CAAC;AAAA,IACD,oBAAoB,IAAI;AAAA,MACtB,IAAI,+CAAgB;AAAA,QAClB,KAAK,UAAU;AAAA,MACjB,CAAC;AAAA,IACH;AAAA,EACF,EAAE;AACJ;","names":[]}

package/dist/node/index.d.cts

@@ -0,0 +1,91 @@
+import * as effect_Layer from 'effect/Layer';
+import * as _effect_opentelemetry_Resource from '@effect/opentelemetry/Resource';
+
+interface PIIConfig {
+    /**
+     * Set of span attribute keys whose values will be redacted.
+     */
+    piiAttributeKeys?: Set<string>;
+    /**
+     * Redacted value placeholder.
+     *
+     * @default "[redacted]"
+     */
+    redactedValue?: string;
+}
+/**
+ * Resource configuration for OpenTelemetry
+ */
+interface ResourceConfig {
+    serviceName: string;
+    serviceVersion: string;
+}
+/**
+ * Endpoint configuration for OpenTelemetry exporters
+ */
+interface EndpointConfig {
+    traces: string;
+    logs: string;
+    metrics?: string;
+}
+/**
+ * Configuration for Node.js OpenTelemetry SDK
+ */
+interface NodeSdkConfig {
+    resource: ResourceConfig;
+    endpoints: EndpointConfig;
+    metricExportIntervalMs?: number;
+    piiConfig?: PIIConfig;
+}
+
+/**
+ * Default OpenTelemetry collector endpoint
+ */
+declare const DEFAULT_OTEL_ENDPOINT = "http://localhost:4318";
+/**
+ * Create endpoint URLs for OTLP exporters
+ *
+ * @param baseUrl - Base URL of the OpenTelemetry collector (e.g., "http://localhost:4318")
+ * @returns Endpoint configuration object
+ *
+ * @example
+ * ```typescript
+ * const endpoints = createEndpoints("http://localhost:4318");
+ * // Returns: {
+ * //   traces: "http://localhost:4318/v1/traces",
+ * //   logs: "http://localhost:4318/v1/logs",
+ * //   metrics: "http://localhost:4318/v1/metrics"
+ * // }
+ * ```
+ */
+declare function createEndpoints(baseUrl?: string): EndpointConfig;
+/**
+ * Create an OpenTelemetry Layer for Node.js applications
+ *
+ * This layer configures:
+ * - OTLP HTTP exporter for traces (to Jaeger)
+ * - OTLP HTTP exporter for metrics (to Prometheus)
+ * - OTLP HTTP exporter for logs (to Loki)
+ * - Custom span processor for redaction/filtering before export
+ * - Batch processors for efficient batching
+ *
+ * @param config - Configuration object
+ * @returns Effect Layer for OpenTelemetry
+ *
+ * @example
+ * ```typescript
+ * import { createNodeOtelLayer, createEndpoints } from "@elto/telemetry/node";
+ *
+ * const OtelLive = createNodeOtelLayer({
+ *   resource: {
+ *     serviceName: "api-server",
+ *     serviceVersion: "1.0.0",
+ *   },
+ *   endpoints: createEndpoints("http://localhost:4318"),
+ *   metricExportIntervalMs: 10000, // optional, default 10000
+ * });
+ * ```
+ */
+declare function createNodeOtelLayer(config: NodeSdkConfig): effect_Layer.Layer<_effect_opentelemetry_Resource.Resource, never, never>;
+
+export { DEFAULT_OTEL_ENDPOINT, type EndpointConfig, type NodeSdkConfig, type ResourceConfig, createEndpoints, createNodeOtelLayer };

package/dist/node/index.d.ts

@@ -0,0 +1,91 @@
+import * as effect_Layer from 'effect/Layer';
+import * as _effect_opentelemetry_Resource from '@effect/opentelemetry/Resource';
+
+interface PIIConfig {
+    /**
+     * Set of span attribute keys whose values will be redacted.
+     */
+    piiAttributeKeys?: Set<string>;
+    /**
+     * Redacted value placeholder.
+     *
+     * @default "[redacted]"
+     */
+    redactedValue?: string;
+}
+/**
+ * Resource configuration for OpenTelemetry
+ */
+interface ResourceConfig {
+    serviceName: string;
+    serviceVersion: string;
+}
+/**
+ * Endpoint configuration for OpenTelemetry exporters
+ */
+interface EndpointConfig {
+    traces: string;
+    logs: string;
+    metrics?: string;
+}
+/**
+ * Configuration for Node.js OpenTelemetry SDK
+ */
+interface NodeSdkConfig {
+    resource: ResourceConfig;
+    endpoints: EndpointConfig;
+    metricExportIntervalMs?: number;
+    piiConfig?: PIIConfig;
+}
+
+/**
+ * Default OpenTelemetry collector endpoint
+ */
+declare const DEFAULT_OTEL_ENDPOINT = "http://localhost:4318";
+/**
+ * Create endpoint URLs for OTLP exporters
+ *
+ * @param baseUrl - Base URL of the OpenTelemetry collector (e.g., "http://localhost:4318")
+ * @returns Endpoint configuration object
+ *
+ * @example
+ * ```typescript
+ * const endpoints = createEndpoints("http://localhost:4318");
+ * // Returns: {
+ * //   traces: "http://localhost:4318/v1/traces",
+ * //   logs: "http://localhost:4318/v1/logs",
+ * //   metrics: "http://localhost:4318/v1/metrics"
+ * // }
+ * ```
+ */
+declare function createEndpoints(baseUrl?: string): EndpointConfig;
+/**
+ * Create an OpenTelemetry Layer for Node.js applications
+ *
+ * This layer configures:
+ * - OTLP HTTP exporter for traces (to Jaeger)
+ * - OTLP HTTP exporter for metrics (to Prometheus)
+ * - OTLP HTTP exporter for logs (to Loki)
+ * - Custom span processor for redaction/filtering before export
+ * - Batch processors for efficient batching
+ *
+ * @param config - Configuration object
+ * @returns Effect Layer for OpenTelemetry
+ *
+ * @example
+ * ```typescript
+ * import { createNodeOtelLayer, createEndpoints } from "@elto/telemetry/node";
+ *
+ * const OtelLive = createNodeOtelLayer({
+ *   resource: {
+ *     serviceName: "api-server",
+ *     serviceVersion: "1.0.0",
+ *   },
+ *   endpoints: createEndpoints("http://localhost:4318"),
+ *   metricExportIntervalMs: 10000, // optional, default 10000
+ * });
+ * ```
+ */
+declare function createNodeOtelLayer(config: NodeSdkConfig): effect_Layer.Layer<_effect_opentelemetry_Resource.Resource, never, never>;
+
+export { DEFAULT_OTEL_ENDPOINT, type EndpointConfig, type NodeSdkConfig, type ResourceConfig, createEndpoints, createNodeOtelLayer };

package/dist/node/index.js

@@ -0,0 +1,175 @@
+// src/node/sdk.ts
+import { NodeSdk } from "@effect/opentelemetry";
+import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
+import { OTLPMetricExporter } from "@opentelemetry/exporter-metrics-otlp-http";
+import { OTLPLogExporter } from "@opentelemetry/exporter-logs-otlp-http";
+import { BatchSpanProcessor } from "@opentelemetry/sdk-trace-base";
+import { PeriodicExportingMetricReader } from "@opentelemetry/sdk-metrics";
+import { BatchLogRecordProcessor } from "@opentelemetry/sdk-logs";
+
+// src/common/span-processors.ts
+var DROP_ATTRIBUTE_KEY = "telemetry.drop";
+var REDACTED_VALUE = "[redacted]";
+var STATEMENT_MAX_LENGTH = 12;
+var STATEMENT_HEAD_LENGTH = 3;
+var STATEMENT_TAIL_LENGTH = 3;
+var PII_ATTRIBUTE_KEYS = /* @__PURE__ */ new Set(["user.email", "note.id", "profile.id"]);
+var getAttributes = (span) => span.attributes ?? {};
+var setAttribute = (span, key, value) => {
+  const target = span;
+  if (typeof target.setAttribute === "function") {
+    target.setAttribute(key, value);
+  }
+  if (target.attributes) {
+    target.attributes[key] = value;
+  }
+};
+var hashString = (value) => {
+  let hash = 2166136261;
+  for (let index = 0; index < value.length; index += 1) {
+    hash ^= value.charCodeAt(index);
+    hash = Math.imul(hash, 16777619);
+  }
+  return (hash >>> 0).toString(16).padStart(8, "0");
+};
+var hashAttributeValue = (value) => {
+  if (Array.isArray(value)) {
+    return hashString(value.map((item) => String(item)).join("|"));
+  }
+  return hashString(String(value));
+};
+var redactConnectionString = (value) => value.replace(/\/\/([^@/]+)@/, "//***:***@");
+var stripUrlQuery = (value) => value.split("?")[0] ?? value;
+var shortenStatement = (statement) => {
+  if (statement.length <= STATEMENT_MAX_LENGTH) {
+    return statement;
+  }
+  const head = statement.slice(0, STATEMENT_HEAD_LENGTH);
+  const tail = statement.slice(-STATEMENT_TAIL_LENGTH);
+  const removed = statement.length - (STATEMENT_HEAD_LENGTH + STATEMENT_TAIL_LENGTH);
+  return `${head}...${tail} (+ ${removed} characters)`;
+};
+var shouldDropSpan = (span) => {
+  const attributes = getAttributes(span);
+  const drop = attributes[DROP_ATTRIBUTE_KEY];
+  return drop === true || drop === "true";
+};
+var sanitizeAttributes = (span, piiAttributes) => {
+  const attributes = getAttributes(span);
+  let redactions = 0;
+  let transformed = 0;
+  const piiKeys = piiAttributes ?? PII_ATTRIBUTE_KEYS;
+  for (const [key, value] of Object.entries(attributes)) {
+    if (value === void 0) {
+      continue;
+    }
+    if (piiKeys.has(key)) {
+      setAttribute(span, `${key}_hash`, hashAttributeValue(value));
+      setAttribute(span, key, REDACTED_VALUE);
+      redactions += 1;
+      continue;
+    }
+    if (key === "db.connection_string" && typeof value === "string") {
+      setAttribute(span, "db.connection_string_redacted", redactConnectionString(value));
+      setAttribute(span, key, REDACTED_VALUE);
+      redactions += 1;
+      continue;
+    }
+    if (key === "db.statement" && typeof value === "string") {
+      const shortened = shortenStatement(value);
+      if (shortened !== value) {
+        setAttribute(span, key, shortened);
+        transformed += 1;
+      }
+      continue;
+    }
+    if (key === "http.url" && typeof value === "string") {
+      const sanitized = stripUrlQuery(value);
+      if (sanitized !== value) {
+        setAttribute(span, key, sanitized);
+        transformed += 1;
+      }
+    }
+  }
+  const statusCode = attributes["http.status_code"];
+  if (typeof statusCode === "number") {
+    setAttribute(span, "http.status_category", `${Math.floor(statusCode / 100)}xx`);
+    transformed += 1;
+  }
+  if (redactions > 0 || transformed > 0) {
+    setAttribute(span, "telemetry.redactions", redactions);
+    setAttribute(span, "telemetry.transformations", transformed);
+  }
+};
+var CustomSpanProcessor = class {
+  constructor(delegate, piiAttributes) {
+    this.delegate = delegate;
+    this.piiAttributes = piiAttributes;
+  }
+  onStart(span, parentContext) {
+    sanitizeAttributes(span, this.piiAttributes);
+    this.delegate.onStart(span, parentContext);
+  }
+  onEnd(span) {
+    sanitizeAttributes(span, this.piiAttributes);
+    if (shouldDropSpan(span)) {
+      return;
+    }
+    this.delegate.onEnd(span);
+  }
+  shutdown() {
+    return this.delegate.shutdown();
+  }
+  forceFlush() {
+    return this.delegate.forceFlush();
+  }
+};
+var createCustomSpanProcessor = (delegate, piiConfig) => new CustomSpanProcessor(delegate, piiConfig?.piiAttributeKeys);
+
+// src/node/sdk.ts
+var DEFAULT_OTEL_ENDPOINT = "http://localhost:4318";
+function createEndpoints(baseUrl = DEFAULT_OTEL_ENDPOINT) {
+  return {
+    traces: `${baseUrl}/v1/traces`,
+    logs: `${baseUrl}/v1/logs`,
+    metrics: `${baseUrl}/v1/metrics`
+  };
+}
+function createNodeOtelLayer(config) {
+  const { resource, endpoints, metricExportIntervalMs = 1e4 } = config;
+  if (!endpoints.metrics) {
+    throw new Error("metrics endpoint is required for Node.js SDK");
+  }
+  const metricsUrl = endpoints.metrics;
+  return NodeSdk.layer(() => ({
+    resource: {
+      serviceName: resource.serviceName,
+      serviceVersion: resource.serviceVersion
+    },
+    spanProcessor: createCustomSpanProcessor(
+      new BatchSpanProcessor(
+        new OTLPTraceExporter({
+          url: endpoints.traces
+        })
+      ),
+      config.piiConfig
+    ),
+    metricReader: new PeriodicExportingMetricReader({
+      exporter: new OTLPMetricExporter({
+        url: metricsUrl
+      }),
+      exportIntervalMillis: metricExportIntervalMs
+    }),
+    logRecordProcessor: new BatchLogRecordProcessor(
+      new OTLPLogExporter({
+        url: endpoints.logs
+      })
+    )
+  }));
+}
+export {
+  DEFAULT_OTEL_ENDPOINT,
+  createEndpoints,
+  createNodeOtelLayer
+};
+//# sourceMappingURL=index.js.map

package/dist/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/node/sdk.ts","../../src/common/span-processors.ts"],"sourcesContent":["import { NodeSdk } from \"@effect/opentelemetry\";\nimport { OTLPTraceExporter } from \"@opentelemetry/exporter-trace-otlp-http\";\nimport { OTLPMetricExporter } from \"@opentelemetry/exporter-metrics-otlp-http\";\nimport { OTLPLogExporter } from \"@opentelemetry/exporter-logs-otlp-http\";\nimport { BatchSpanProcessor } from \"@opentelemetry/sdk-trace-base\";\nimport { PeriodicExportingMetricReader } from \"@opentelemetry/sdk-metrics\";\nimport { BatchLogRecordProcessor } from \"@opentelemetry/sdk-logs\";\nimport { createCustomSpanProcessor } from \"../common/span-processors.js\";\nimport type { NodeSdkConfig, EndpointConfig } from \"../common/types.js\";\n\n/**\n * Default OpenTelemetry collector endpoint\n */\nexport const DEFAULT_OTEL_ENDPOINT = \"http://localhost:4318\";\n\n/**\n * Create endpoint URLs for OTLP exporters\n *\n * @param baseUrl - Base URL of the OpenTelemetry collector (e.g., \"http://localhost:4318\")\n * @returns Endpoint configuration object\n *\n * @example\n * ```typescript\n * const endpoints = createEndpoints(\"http://localhost:4318\");\n * // Returns: {\n * //   traces: \"http://localhost:4318/v1/traces\",\n * //   logs: \"http://localhost:4318/v1/logs\",\n * //   metrics: \"http://localhost:4318/v1/metrics\"\n * // }\n * ```\n */\nexport function createEndpoints(baseUrl: string = DEFAULT_OTEL_ENDPOINT): EndpointConfig {\n  return {\n    traces: `${baseUrl}/v1/traces`,\n    logs: `${baseUrl}/v1/logs`,\n    metrics: `${baseUrl}/v1/metrics`,\n  };\n}\n\n/**\n * Create an OpenTelemetry Layer for Node.js applications\n *\n * This layer configures:\n * - OTLP HTTP exporter for traces (to Jaeger)\n * - OTLP HTTP exporter for metrics (to Prometheus)\n * - OTLP HTTP exporter for logs (to Loki)\n * - Custom span processor for redaction/filtering before export\n * - Batch processors for efficient batching\n *\n * @param config - Configuration object\n * @returns Effect Layer for OpenTelemetry\n *\n * @example\n * ```typescript\n * import { createNodeOtelLayer, createEndpoints } from \"@elto/telemetry/node\";\n *\n * const OtelLive = createNodeOtelLayer({\n *   resource: {\n *     serviceName: \"api-server\",\n *     serviceVersion: \"1.0.0\",\n *   },\n *   endpoints: createEndpoints(\"http://localhost:4318\"),\n *   metricExportIntervalMs: 10000, // optional, default 10000\n * });\n * ```\n */\nexport function createNodeOtelLayer(config: NodeSdkConfig) {\n  const { resource, endpoints, metricExportIntervalMs = 10000 } = config;\n\n  if (!endpoints.metrics) {\n    throw new Error(\"metrics endpoint is required for Node.js SDK\");\n  }\n\n  const metricsUrl = endpoints.metrics;\n\n  return NodeSdk.layer(() => ({\n    resource: {\n      serviceName: resource.serviceName,\n      serviceVersion: resource.serviceVersion,\n    },\n    spanProcessor: createCustomSpanProcessor(\n      new BatchSpanProcessor(\n        new OTLPTraceExporter({\n          url: endpoints.traces,\n        }),\n      ),\n      config.piiConfig,\n    ),\n    metricReader: new PeriodicExportingMetricReader({\n      exporter: new OTLPMetricExporter({\n        url: metricsUrl,\n      }),\n      exportIntervalMillis: metricExportIntervalMs,\n    }),\n    logRecordProcessor: new BatchLogRecordProcessor(\n      new OTLPLogExporter({\n        url: endpoints.logs,\n      }),\n    ),\n  }));\n}\n","import type { AttributeValue, Context } from \"@opentelemetry/api\";\nimport type { ReadableSpan, Span, SpanProcessor } from \"@opentelemetry/sdk-trace-base\";\nimport type { PIIConfig } from \"./types\";\n\n/**\n * Default span processor used by @elto/telemetry to normalize and sanitize\n * attributes before export. It is intentionally small and opinionated so\n * demo traces stay safe and readable.\n */\ntype SpanAttributes = Record<string, AttributeValue | undefined>;\n\nconst DROP_ATTRIBUTE_KEY = \"telemetry.drop\";\nconst REDACTED_VALUE = \"[redacted]\";\nconst STATEMENT_MAX_LENGTH = 12;\nconst STATEMENT_HEAD_LENGTH = 3;\nconst STATEMENT_TAIL_LENGTH = 3;\n\nconst PII_ATTRIBUTE_KEYS = new Set([\"user.email\", \"note.id\", \"profile.id\"]);\n\nconst getAttributes = (span: Span | ReadableSpan): SpanAttributes =>\n  (span as { attributes?: SpanAttributes }).attributes ?? {};\n\nconst setAttribute = (span: Span | ReadableSpan, key: string, value: AttributeValue) => {\n  const target = span as {\n    setAttribute?: (attributeKey: string, attributeValue: AttributeValue) => void;\n    attributes?: SpanAttributes;\n  };\n\n  if (typeof target.setAttribute === \"function\") {\n    target.setAttribute(key, value);\n  }\n\n  if (target.attributes) {\n    target.attributes[key] = value;\n  }\n};\n\nconst hashString = (value: string) => {\n  let hash = 2166136261;\n  for (let index = 0; index < value.length; index += 1) {\n    hash ^= value.charCodeAt(index);\n    hash = Math.imul(hash, 16777619);\n  }\n  return (hash >>> 0).toString(16).padStart(8, \"0\");\n};\n\nconst hashAttributeValue = (value: AttributeValue) => {\n  if (Array.isArray(value)) {\n    return hashString(value.map((item) => String(item)).join(\"|\"));\n  }\n  return hashString(String(value));\n};\n\nconst redactConnectionString = (value: string) => value.replace(/\\/\\/([^@/]+)@/, \"//***:***@\");\n\nconst stripUrlQuery = (value: string) => value.split(\"?\")[0] ?? value;\n\n/**\n * Shorten a long SQL statement to a leading head + tail with a marker that\n * explains how many characters were removed.\n */\nconst shortenStatement = (statement: string) => {\n  if (statement.length <= STATEMENT_MAX_LENGTH) {\n    return statement;\n  }\n\n  const head = statement.slice(0, STATEMENT_HEAD_LENGTH);\n  const tail = statement.slice(-STATEMENT_TAIL_LENGTH);\n  const removed = statement.length - (STATEMENT_HEAD_LENGTH + STATEMENT_TAIL_LENGTH);\n  return `${head}...${tail} (+ ${removed} characters)`;\n};\n\nconst shouldDropSpan = (span: ReadableSpan) => {\n  const attributes = getAttributes(span);\n  const drop = attributes[DROP_ATTRIBUTE_KEY];\n  return drop === true || drop === \"true\";\n};\n\nconst sanitizeAttributes = (span: Span | ReadableSpan, piiAttributes?: Set<string>) => {\n  const attributes = getAttributes(span);\n  let redactions = 0;\n  let transformed = 0;\n\n  const piiKeys = piiAttributes ?? PII_ATTRIBUTE_KEYS;\n  for (const [key, value] of Object.entries(attributes)) {\n    if (value === undefined) {\n      continue;\n    }\n\n    if (piiKeys.has(key)) {\n      setAttribute(span, `${key}_hash`, hashAttributeValue(value));\n      setAttribute(span, key, REDACTED_VALUE);\n      redactions += 1;\n      continue;\n    }\n\n    if (key === \"db.connection_string\" && typeof value === \"string\") {\n      setAttribute(span, \"db.connection_string_redacted\", redactConnectionString(value));\n      setAttribute(span, key, REDACTED_VALUE);\n      redactions += 1;\n      continue;\n    }\n\n    if (key === \"db.statement\" && typeof value === \"string\") {\n      const shortened = shortenStatement(value);\n      if (shortened !== value) {\n        setAttribute(span, key, shortened);\n        transformed += 1;\n      }\n      continue;\n    }\n\n    if (key === \"http.url\" && typeof value === \"string\") {\n      const sanitized = stripUrlQuery(value);\n      if (sanitized !== value) {\n        setAttribute(span, key, sanitized);\n        transformed += 1;\n      }\n    }\n  }\n\n  const statusCode = attributes[\"http.status_code\"];\n  if (typeof statusCode === \"number\") {\n    setAttribute(span, \"http.status_category\", `${Math.floor(statusCode / 100)}xx`);\n    transformed += 1;\n  }\n\n  if (redactions > 0 || transformed > 0) {\n    setAttribute(span, \"telemetry.redactions\", redactions);\n    setAttribute(span, \"telemetry.transformations\", transformed);\n  }\n};\n\n/**\n * A SpanProcessor that applies redaction, attribute normalization, and optional\n * dropping before delegating to another processor (typically a BatchSpanProcessor).\n *\n * Behavior:\n * - Redacts `user.email`, `note.id`, and `profile.id` while adding `<key>_hash`.\n * - Redacts `db.connection_string` and stores a sanitized copy in\n *   `db.connection_string_redacted`.\n * - Shortens `db.statement` when it exceeds the configured threshold.\n * - Strips query strings from `http.url`.\n * - Adds `http.status_category` when `http.status_code` is present.\n * - Adds `telemetry.redactions` and `telemetry.transformations` counters.\n * - Drops spans when `telemetry.drop` is `true` or `\"true\"`.\n *\n * @param delegate - The SpanProcessor to delegate to after sanitization\n * @param piiAttributes - Optional set of span attribute keys whose values will be redacted.\n *   If provided, this overrides the default {@link PII_ATTRIBUTE_KEYS} (`user.email`, `note.id`, `profile.id`).\n *   For each matching key, the original value is replaced with `[redacted]` and a hash\n *   is stored in a `<key>_hash` attribute.\n */\nexport class CustomSpanProcessor implements SpanProcessor {\n  constructor(\n    private readonly delegate: SpanProcessor,\n    private readonly piiAttributes?: Set<string>,\n  ) {}\n\n  onStart(span: Span, parentContext: Context): void {\n    sanitizeAttributes(span, this.piiAttributes);\n    this.delegate.onStart(span, parentContext);\n  }\n\n  onEnd(span: ReadableSpan): void {\n    sanitizeAttributes(span, this.piiAttributes);\n    if (shouldDropSpan(span)) {\n      return;\n    }\n    this.delegate.onEnd(span);\n  }\n\n  shutdown(): Promise<void> {\n    return this.delegate.shutdown();\n  }\n\n  forceFlush(): Promise<void> {\n    return this.delegate.forceFlush();\n  }\n}\n\n/**\n * Convenience factory for wrapping a delegate SpanProcessor with the\n * @elto/telemetry custom sanitation behavior.\n */\nexport const createCustomSpanProcessor = (delegate: SpanProcessor, piiConfig?: PIIConfig) =>\n  new CustomSpanProcessor(delegate, piiConfig?.piiAttributeKeys);\n"],"mappings":"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","names":[]}