autotel-backends 2.12.28 → 2.12.30

package/dist/datadog.cjs

@@ -1,116 +1,138 @@
-'use strict';
-
-var module$1 = require('module');
-
-var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
-// src/datadog.ts
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let node_module = require("node:module");
+//#region src/datadog.ts
+/**
+* Datadog preset for autotel
+*
+* Provides a simplified configuration helper for Datadog integration
+* with best practices built-in.
+*
+* @example Direct cloud ingestion (serverless, edge)
+* ```typescript
+* import { init } from 'autotel';
+* import { createDatadogConfig } from 'autotel-backends/datadog';
+*
+* init(createDatadogConfig({
+*   apiKey: process.env.DATADOG_API_KEY!,
+*   service: 'my-lambda',
+*   enableLogs: true,
+* }));
+* ```
+*
+* @example Local Datadog Agent (long-running services, Kubernetes)
+* ```typescript
+* import { init } from 'autotel';
+* import { createDatadogConfig } from 'autotel-backends/datadog';
+*
+* init(createDatadogConfig({
+*   service: 'my-api',
+*   useAgent: true,  // No API key needed - Agent handles it
+* }));
+* ```
+*/
+/**
+* Create an autotel configuration optimized for Datadog.
+*
+* This preset handles:
+* - Proper OTLP endpoint configuration (Agent vs direct ingestion)
+*   - Direct: https://otlp.{site} → SDK appends /v1/traces, /v1/metrics, /v1/logs
+*   - Agent: http://localhost:4318 (default)
+* - Datadog API key authentication headers (direct ingestion only)
+* - Unified service tagging (service, env, version)
+* - Resource attribute best practices
+* - Optional log export configuration
+*
+* @param config - Datadog-specific configuration options
+* @returns AutotelConfig ready to pass to init()
+*
+* @example Simple cloud ingestion
+* ```typescript
+* init(createDatadogConfig({
+*   apiKey: process.env.DATADOG_API_KEY!,
+*   service: 'my-app',
+* }));
+* ```
+*
+* @example With logs and custom environment
+* ```typescript
+* init(createDatadogConfig({
+*   apiKey: process.env.DATADOG_API_KEY!,
+*   service: 'my-app',
+*   environment: 'production',
+*   version: '2.1.0',
+*   enableLogs: true,
+* }));
+* ```
+*
+* @example Using local Datadog Agent
+* ```typescript
+* init(createDatadogConfig({
+*   service: 'my-api',
+*   useAgent: true,
+*   agentHost: 'datadog-agent.default.svc.cluster.local', // Kubernetes
+* }));
+* ```
+*/
 function createDatadogConfig(config) {
-  const {
-    apiKey,
-    site = "datadoghq.com",
-    service,
-    environment,
-    version,
-    enableLogs = false,
-    useAgent = false,
-    agentHost = "localhost",
-    agentPort = 4318,
-    logRecordProcessors
-  } = config;
-  if (!useAgent && !apiKey) {
-    throw new Error(
-      "Datadog API key is required for direct cloud ingestion. Either provide apiKey or set useAgent: true to use local Datadog Agent."
-    );
-  }
-  const baseConfig = {
-    service,
-    environment,
-    version
-  };
-  if (useAgent) {
-    const agentEndpoint = `http://${agentHost}:${agentPort}`;
-    if (enableLogs) {
-      const logsEndpoint = `http://${agentHost}:${agentPort}/v1/logs`;
-      if (!process.env.OTEL_EXPORTER_OTLP_LOGS_ENDPOINT) {
-        process.env.OTEL_EXPORTER_OTLP_LOGS_ENDPOINT = logsEndpoint;
-      }
-      if (!process.env.OTEL_EXPORTER_OTLP_LOGS_PROTOCOL) {
-        process.env.OTEL_EXPORTER_OTLP_LOGS_PROTOCOL = "http/protobuf";
-      }
-      const resourceAttrs = [
-        `service.name=${service}`,
-        environment ? `deployment.environment=${environment}` : null,
-        version ? `service.version=${version}` : null
-      ].filter(Boolean).join(",");
-      if (!process.env.OTEL_RESOURCE_ATTRIBUTES) {
-        process.env.OTEL_RESOURCE_ATTRIBUTES = resourceAttrs;
-      }
-    }
-    return {
-      ...baseConfig,
-      endpoint: agentEndpoint
-      // No API key or headers needed - Agent handles authentication
-    };
-  }
-  const otlpEndpoint = `https://otlp.${site}`;
-  const authHeaders = `dd-api-key=${apiKey}`;
-  const cloudConfig = {
-    ...baseConfig,
-    endpoint: otlpEndpoint,
-    headers: authHeaders
-  };
-  if (enableLogs) {
-    const logsEndpoint = useAgent ? `http://${agentHost}:${agentPort}/v1/logs` : `https://otlp.${site}/v1/logs`;
-    if (!process.env.OTEL_EXPORTER_OTLP_LOGS_ENDPOINT) {
-      process.env.OTEL_EXPORTER_OTLP_LOGS_ENDPOINT = logsEndpoint;
-    }
-    if (!process.env.OTEL_EXPORTER_OTLP_LOGS_PROTOCOL) {
-      process.env.OTEL_EXPORTER_OTLP_LOGS_PROTOCOL = "http/protobuf";
-    }
-    if (!useAgent && apiKey && !process.env.OTEL_EXPORTER_OTLP_LOGS_HEADERS) {
-      process.env.OTEL_EXPORTER_OTLP_LOGS_HEADERS = `dd-api-key=${apiKey}`;
-    }
-    const resourceAttrs = [
-      `service.name=${service}`,
-      environment ? `deployment.environment=${environment}` : null,
-      version ? `service.version=${version}` : null
-    ].filter(Boolean).join(",");
-    if (!process.env.OTEL_RESOURCE_ATTRIBUTES) {
-      process.env.OTEL_RESOURCE_ATTRIBUTES = resourceAttrs;
-    }
-    if (logRecordProcessors) {
-      cloudConfig.logRecordProcessors = logRecordProcessors;
-    } else {
-      try {
-        const pkgRequire = module$1.createRequire(
-          typeof __filename === "string" ? __filename : (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('datadog.cjs', document.baseURI).href))
-        );
-        const { BatchLogRecordProcessor } = pkgRequire(
-          "@opentelemetry/sdk-logs"
-        );
-        const { OTLPLogExporter } = pkgRequire(
-          "@opentelemetry/exporter-logs-otlp-http"
-        );
-        cloudConfig.logRecordProcessors = [
-          new BatchLogRecordProcessor(
-            new OTLPLogExporter({
-              url: `${otlpEndpoint}/v1/logs`,
-              headers: {
-                "dd-api-key": apiKey
-              }
-            })
-          )
-        ];
-      } catch {
-        throw new Error(
-          "Log export requires @opentelemetry/sdk-logs and @opentelemetry/exporter-logs-otlp-http. Install them or set enableLogs: false."
-        );
-      }
-    }
-  }
-  return cloudConfig;
+	const { apiKey, site = "datadoghq.com", service, environment, version, enableLogs = false, useAgent = false, agentHost = "localhost", agentPort = 4318, logRecordProcessors } = config;
+	if (!useAgent && !apiKey) throw new Error("Datadog API key is required for direct cloud ingestion. Either provide apiKey or set useAgent: true to use local Datadog Agent.");
+	const baseConfig = {
+		service,
+		environment,
+		version
+	};
+	if (useAgent) {
+		const agentEndpoint = `http://${agentHost}:${agentPort}`;
+		if (enableLogs) {
+			const logsEndpoint = `http://${agentHost}:${agentPort}/v1/logs`;
+			if (!process.env.OTEL_EXPORTER_OTLP_LOGS_ENDPOINT) process.env.OTEL_EXPORTER_OTLP_LOGS_ENDPOINT = logsEndpoint;
+			if (!process.env.OTEL_EXPORTER_OTLP_LOGS_PROTOCOL) process.env.OTEL_EXPORTER_OTLP_LOGS_PROTOCOL = "http/protobuf";
+			const resourceAttrs = [
+				`service.name=${service}`,
+				environment ? `deployment.environment=${environment}` : null,
+				version ? `service.version=${version}` : null
+			].filter(Boolean).join(",");
+			if (!process.env.OTEL_RESOURCE_ATTRIBUTES) process.env.OTEL_RESOURCE_ATTRIBUTES = resourceAttrs;
+		}
+		return {
+			...baseConfig,
+			endpoint: agentEndpoint
+		};
+	}
+	const otlpEndpoint = `https://otlp.${site}`;
+	const authHeaders = `dd-api-key=${apiKey}`;
+	const cloudConfig = {
+		...baseConfig,
+		endpoint: otlpEndpoint,
+		headers: authHeaders
+	};
+	if (enableLogs) {
+		const logsEndpoint = useAgent ? `http://${agentHost}:${agentPort}/v1/logs` : `https://otlp.${site}/v1/logs`;
+		if (!process.env.OTEL_EXPORTER_OTLP_LOGS_ENDPOINT) process.env.OTEL_EXPORTER_OTLP_LOGS_ENDPOINT = logsEndpoint;
+		if (!process.env.OTEL_EXPORTER_OTLP_LOGS_PROTOCOL) process.env.OTEL_EXPORTER_OTLP_LOGS_PROTOCOL = "http/protobuf";
+		if (!useAgent && apiKey && !process.env.OTEL_EXPORTER_OTLP_LOGS_HEADERS) process.env.OTEL_EXPORTER_OTLP_LOGS_HEADERS = `dd-api-key=${apiKey}`;
+		const resourceAttrs = [
+			`service.name=${service}`,
+			environment ? `deployment.environment=${environment}` : null,
+			version ? `service.version=${version}` : null
+		].filter(Boolean).join(",");
+		if (!process.env.OTEL_RESOURCE_ATTRIBUTES) process.env.OTEL_RESOURCE_ATTRIBUTES = resourceAttrs;
+		if (logRecordProcessors) cloudConfig.logRecordProcessors = logRecordProcessors;
+		else try {
+			const pkgRequire = (0, node_module.createRequire)(typeof __filename === "string" ? __filename : require("url").pathToFileURL(__filename).href);
+			const { BatchLogRecordProcessor } = pkgRequire("@opentelemetry/sdk-logs");
+			const { OTLPLogExporter } = pkgRequire("@opentelemetry/exporter-logs-otlp-http");
+			cloudConfig.logRecordProcessors = [new BatchLogRecordProcessor(new OTLPLogExporter({
+				url: `${otlpEndpoint}/v1/logs`,
+				headers: { "dd-api-key": apiKey }
+			}))];
+		} catch {
+			throw new Error("Log export requires @opentelemetry/sdk-logs and @opentelemetry/exporter-logs-otlp-http. Install them or set enableLogs: false.");
+		}
+	}
+	return cloudConfig;
 }
-
+//#endregion
 exports.createDatadogConfig = createDatadogConfig;
-//# sourceMappingURL=datadog.cjs.map
+
 //# sourceMappingURL=datadog.cjs.map

package/dist/datadog.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/datadog.ts"],"names":["createRequire"],"mappings":";;;;;;AAmMO,SAAS,oBACd,MAAA,EACe;AACf,EAAA,MAAM;AAAA,IACJ,MAAA;AAAA,IACA,IAAA,GAAO,eAAA;AAAA,IACP,OAAA;AAAA,IACA,WAAA;AAAA,IACA,OAAA;AAAA,IACA,UAAA,GAAa,KAAA;AAAA,IACb,QAAA,GAAW,KAAA;AAAA,IACX,SAAA,GAAY,WAAA;AAAA,IACZ,SAAA,GAAY,IAAA;AAAA,IACZ;AAAA,GACF,GAAI,MAAA;AAGJ,EAAA,IAAI,CAAC,QAAA,IAAY,CAAC,MAAA,EAAQ;AACxB,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KAEF;AAAA,EACF;AAEA,EAAA,MAAM,UAAA,GAA4B;AAAA,IAChC,OAAA;AAAA,IACA,WAAA;AAAA,IACA;AAAA,GACF;AAGA,EAAA,IAAI,QAAA,EAAU;AACZ,IAAA,MAAM,aAAA,GAAgB,CAAA,OAAA,EAAU,SAAS,CAAA,CAAA,EAAI,SAAS,CAAA,CAAA;AAGtD,IAAA,IAAI,UAAA,EAAY;AACd,MAAA,MAAM,YAAA,GAAe,CAAA,OAAA,EAAU,SAAS,CAAA,CAAA,EAAI,SAAS,CAAA,QAAA,CAAA;AAErD,MAAA,IAAI,CAAC,OAAA,CAAQ,GAAA,CAAI,gCAAA,EAAkC;AACjD,QAAA,OAAA,CAAQ,IAAI,gCAAA,GAAmC,YAAA;AAAA,MACjD;AAEA,MAAA,IAAI,CAAC,OAAA,CAAQ,GAAA,CAAI,gCAAA,EAAkC;AACjD,QAAA,OAAA,CAAQ,IAAI,gCAAA,GAAmC,eAAA;AAAA,MACjD;AAIA,MAAA,MAAM,aAAA,GAAgB;AAAA,QACpB,gBAAgB,OAAO,CAAA,CAAA;AAAA,QACvB,WAAA,GAAc,CAAA,uBAAA,EAA0B,WAAW,CAAA,CAAA,GAAK,IAAA;AAAA,QACxD,OAAA,GAAU,CAAA,gBAAA,EAAmB,OAAO,CAAA,CAAA,GAAK;AAAA,OAC3C,CACG,MAAA,CAAO,OAAO,CAAA,CACd,KAAK,GAAG,CAAA;AAEX,MAAA,IAAI,CAAC,OAAA,CAAQ,GAAA,CAAI,wBAAA,EAA0B;AACzC,QAAA,OAAA,CAAQ,IAAI,wBAAA,GAA2B,aAAA;AAAA,MACzC;AAAA,IACF;AAEA,IAAA,OAAO;AAAA,MACL,GAAG,UAAA;AAAA,MACH,QAAA,EAAU;AAAA;AAAA,KAEZ;AAAA,EACF;AAIA,EAAA,MAAM,YAAA,GAAe,gBAAgB,IAAI,CAAA,CAAA;AACzC,EAAA,MAAM,WAAA,GAAc,cAAc,MAAM,CAAA,CAAA;AAExC,EAAA,MAAM,WAAA,GAA6B;AAAA,IACjC,GAAG,UAAA;AAAA,IACH,QAAA,EAAU,YAAA;AAAA,IACV,OAAA,EAAS;AAAA,GACX;AAGA,EAAA,IAAI,UAAA,EAAY;AAGd,IAAA,MAAM,YAAA,GAAe,WACjB,CAAA,OAAA,EAAU,SAAS,IAAI,SAAS,CAAA,QAAA,CAAA,GAChC,gBAAgB,IAAI,CAAA,QAAA,CAAA;AAGxB,IAAA,IAAI,CAAC,OAAA,CAAQ,GAAA,CAAI,gCAAA,EAAkC;AACjD,MAAA,OAAA,CAAQ,IAAI,gCAAA,GAAmC,YAAA;AAAA,IACjD;AAEA,IAAA,IAAI,CAAC,OAAA,CAAQ,GAAA,CAAI,gCAAA,EAAkC;AACjD,MAAA,OAAA,CAAQ,IAAI,gCAAA,GAAmC,eAAA;AAAA,IACjD;AAGA,IAAA,IAAI,CAAC,QAAA,IAAY,MAAA,IAAU,CAAC,OAAA,CAAQ,IAAI,+BAAA,EAAiC;AACvE,MAAA,OAAA,CAAQ,GAAA,CAAI,+BAAA,GAAkC,CAAA,WAAA,EAAc,MAAM,CAAA,CAAA;AAAA,IACpE;AAGA,IAAA,MAAM,aAAA,GAAgB;AAAA,MACpB,gBAAgB,OAAO,CAAA,CAAA;AAAA,MACvB,WAAA,GAAc,CAAA,uBAAA,EAA0B,WAAW,CAAA,CAAA,GAAK,IAAA;AAAA,MACxD,OAAA,GAAU,CAAA,gBAAA,EAAmB,OAAO,CAAA,CAAA,GAAK;AAAA,KAC3C,CACG,MAAA,CAAO,OAAO,CAAA,CACd,KAAK,GAAG,CAAA;AAEX,IAAA,IAAI,CAAC,OAAA,CAAQ,GAAA,CAAI,wBAAA,EAA0B;AACzC,MAAA,OAAA,CAAQ,IAAI,wBAAA,GAA2B,aAAA;AAAA,IACzC;AAEA,IAAA,IAAI,mBAAA,EAAqB;AAEvB,MAAA,WAAA,CAAY,mBAAA,GAAsB,mBAAA;AAAA,IACpC,CAAA,MAAO;AAEL,MAAA,IAAI;AACF,QAAA,MAAM,UAAA,GAAaA,sBAAA;AAAA,UACjB,OAAO,UAAA,KAAe,QAAA,GAAW,UAAA,GAAa;AAAY,SAC5D;AACA,QAAA,MAAM,EAAE,yBAAwB,GAAI,UAAA;AAAA,UAClC;AAAA,SACF;AACA,QAAA,MAAM,EAAE,iBAAgB,GAAI,UAAA;AAAA,UAC1B;AAAA,SACF;AAEA,QAAA,WAAA,CAAY,mBAAA,GAAsB;AAAA,UAChC,IAAI,uBAAA;AAAA,YACF,IAAI,eAAA,CAAgB;AAAA,cAClB,GAAA,EAAK,GAAG,YAAY,CAAA,QAAA,CAAA;AAAA,cACpB,OAAA,EAAS;AAAA,gBACP,YAAA,EAAc;AAAA;AAChB,aACD;AAAA;AACH,SACF;AAAA,MACF,CAAA,CAAA,MAAQ;AACN,QAAA,MAAM,IAAI,KAAA;AAAA,UACR;AAAA,SAEF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,EAAA,OAAO,WAAA;AACT","file":"datadog.cjs","sourcesContent":["/**\n * Datadog preset for autotel\n *\n * Provides a simplified configuration helper for Datadog integration\n * with best practices built-in.\n *\n * @example Direct cloud ingestion (serverless, edge)\n * ```typescript\n * import { init } from 'autotel';\n * import { createDatadogConfig } from 'autotel-backends/datadog';\n *\n * init(createDatadogConfig({\n *   apiKey: process.env.DATADOG_API_KEY!,\n *   service: 'my-lambda',\n *   enableLogs: true,\n * }));\n * ```\n *\n * @example Local Datadog Agent (long-running services, Kubernetes)\n * ```typescript\n * import { init } from 'autotel';\n * import { createDatadogConfig } from 'autotel-backends/datadog';\n *\n * init(createDatadogConfig({\n *   service: 'my-api',\n *   useAgent: true,  // No API key needed - Agent handles it\n * }));\n * ```\n */\n\nimport { createRequire } from 'node:module';\nimport type { AutotelConfig } from 'autotel';\nimport type { LogRecordProcessor } from '@opentelemetry/sdk-logs';\n\n// `__filename` exists under CJS (including esbuild's CJS output wrapper) but\n// not pure ESM. `typeof` is safe against an undeclared identifier and lets\n// the conditional pick the working URL in either format.\ndeclare const __filename: string | undefined;\n\n/**\n * Datadog site regions\n */\nexport type DatadogSite =\n  | 'datadoghq.com' // US1 (default)\n  | 'datadoghq.eu' // EU\n  | 'us3.datadoghq.com' // US3\n  | 'us5.datadoghq.com' // US5\n  | 'ap1.datadoghq.com' // AP1\n  | 'ddog-gov.com'; // US1-FED\n\n/**\n * Configuration options for Datadog preset\n */\nexport interface DatadogPresetConfig {\n  /**\n   * Datadog API key (required for direct cloud ingestion).\n   * Not needed if using local Datadog Agent (useAgent: true).\n   *\n   * Get your API key from:\n   * https://app.datadoghq.com/organization-settings/api-keys\n   */\n  apiKey?: string;\n\n  /**\n   * Datadog site/region.\n   * Determines which Datadog intake endpoint to use.\n   *\n   * @default 'datadoghq.com' (US1)\n   */\n  site?: DatadogSite;\n\n  /**\n   * Service name (required).\n   * Appears in Datadog APM, Service Catalog, and all telemetry.\n   */\n  service: string;\n\n  /**\n   * Deployment environment (e.g., 'production', 'staging', 'development').\n   * Used for environment filtering in Datadog.\n   *\n   * @default process.env.DD_ENV || process.env.NODE_ENV || 'development'\n   */\n  environment?: string;\n\n  /**\n   * Service version for deployment tracking.\n   * Enables Deployment Tracking in Datadog APM.\n   *\n   * @default process.env.DD_VERSION || auto-detected from package.json\n   */\n  version?: string;\n\n  /**\n   * Enable log export to Datadog via OTLP.\n   *\n   * When enabled, this:\n   * 1. Sets up OTel Logs SDK with OTLP exporter (for direct OTel logs API usage)\n   * 2. Auto-configures OTEL_EXPORTER_OTLP_LOGS_* env vars for pino-opentelemetry-transport\n   *\n   * For Pino users: Just add pino-opentelemetry-transport to your logger config:\n   * ```typescript\n   * const logger = pino({\n   *   transport: {\n   *     targets: [\n   *       { target: 'pino-pretty' },\n   *       { target: 'pino-opentelemetry-transport' }, // Auto-configured!\n   *     ],\n   *   },\n   * });\n   * ```\n   *\n   * @default false\n   */\n  enableLogs?: boolean;\n\n  /**\n   * Use local Datadog Agent instead of direct cloud ingestion.\n   *\n   * Benefits:\n   * - Lower egress costs (Agent aggregates locally)\n   * - Advanced features: trace-log correlation, multi-line logs, data scrubbing\n   * - 500+ integrations for enrichment\n   * - Infrastructure metrics collection\n   *\n   * Requires: Datadog Agent 7.35+ with OTLP enabled\n   *\n   * @default false\n   */\n  useAgent?: boolean;\n\n  /**\n   * Datadog Agent hostname (when useAgent: true).\n   *\n   * @default 'localhost'\n   */\n  agentHost?: string;\n\n  /**\n   * Datadog Agent OTLP port (when useAgent: true).\n   *\n   * @default 4318 (OTLP HTTP)\n   */\n  agentPort?: number;\n\n  /**\n   * Custom log record processors (advanced).\n   * Overrides the default log processor if enableLogs is true.\n   */\n  logRecordProcessors?: LogRecordProcessor[];\n}\n\n/**\n * Create an autotel configuration optimized for Datadog.\n *\n * This preset handles:\n * - Proper OTLP endpoint configuration (Agent vs direct ingestion)\n *   - Direct: https://otlp.{site} → SDK appends /v1/traces, /v1/metrics, /v1/logs\n *   - Agent: http://localhost:4318 (default)\n * - Datadog API key authentication headers (direct ingestion only)\n * - Unified service tagging (service, env, version)\n * - Resource attribute best practices\n * - Optional log export configuration\n *\n * @param config - Datadog-specific configuration options\n * @returns AutotelConfig ready to pass to init()\n *\n * @example Simple cloud ingestion\n * ```typescript\n * init(createDatadogConfig({\n *   apiKey: process.env.DATADOG_API_KEY!,\n *   service: 'my-app',\n * }));\n * ```\n *\n * @example With logs and custom environment\n * ```typescript\n * init(createDatadogConfig({\n *   apiKey: process.env.DATADOG_API_KEY!,\n *   service: 'my-app',\n *   environment: 'production',\n *   version: '2.1.0',\n *   enableLogs: true,\n * }));\n * ```\n *\n * @example Using local Datadog Agent\n * ```typescript\n * init(createDatadogConfig({\n *   service: 'my-api',\n *   useAgent: true,\n *   agentHost: 'datadog-agent.default.svc.cluster.local', // Kubernetes\n * }));\n * ```\n */\nexport function createDatadogConfig(\n  config: DatadogPresetConfig,\n): AutotelConfig {\n  const {\n    apiKey,\n    site = 'datadoghq.com',\n    service,\n    environment,\n    version,\n    enableLogs = false,\n    useAgent = false,\n    agentHost = 'localhost',\n    agentPort = 4318,\n    logRecordProcessors,\n  } = config;\n\n  // Validation: API key required for direct ingestion\n  if (!useAgent && !apiKey) {\n    throw new Error(\n      'Datadog API key is required for direct cloud ingestion. ' +\n        'Either provide apiKey or set useAgent: true to use local Datadog Agent.',\n    );\n  }\n\n  const baseConfig: AutotelConfig = {\n    service,\n    environment,\n    version,\n  };\n\n  // Local Datadog Agent configuration\n  if (useAgent) {\n    const agentEndpoint = `http://${agentHost}:${agentPort}`;\n\n    // Auto-configure env vars for pino-opentelemetry-transport in agent mode\n    if (enableLogs) {\n      const logsEndpoint = `http://${agentHost}:${agentPort}/v1/logs`;\n\n      if (!process.env.OTEL_EXPORTER_OTLP_LOGS_ENDPOINT) {\n        process.env.OTEL_EXPORTER_OTLP_LOGS_ENDPOINT = logsEndpoint;\n      }\n\n      if (!process.env.OTEL_EXPORTER_OTLP_LOGS_PROTOCOL) {\n        process.env.OTEL_EXPORTER_OTLP_LOGS_PROTOCOL = 'http/protobuf';\n      }\n\n      // No API key header needed for agent mode - Agent handles authentication\n\n      const resourceAttrs = [\n        `service.name=${service}`,\n        environment ? `deployment.environment=${environment}` : null,\n        version ? `service.version=${version}` : null,\n      ]\n        .filter(Boolean)\n        .join(',');\n\n      if (!process.env.OTEL_RESOURCE_ATTRIBUTES) {\n        process.env.OTEL_RESOURCE_ATTRIBUTES = resourceAttrs;\n      }\n    }\n\n    return {\n      ...baseConfig,\n      endpoint: agentEndpoint,\n      // No API key or headers needed - Agent handles authentication\n    };\n  }\n\n  // Direct cloud ingestion configuration\n  // Datadog OTLP endpoint: base URL without path (SDK appends /v1/traces, /v1/metrics, /v1/logs)\n  const otlpEndpoint = `https://otlp.${site}`;\n  const authHeaders = `dd-api-key=${apiKey}`;\n\n  const cloudConfig: AutotelConfig = {\n    ...baseConfig,\n    endpoint: otlpEndpoint,\n    headers: authHeaders,\n  };\n\n  // Add log export if enabled\n  if (enableLogs) {\n    // Auto-configure env vars for pino-opentelemetry-transport and other OTel log transports\n    // These are read by pino-opentelemetry-transport, otlp-logger, and similar libraries\n    const logsEndpoint = useAgent\n      ? `http://${agentHost}:${agentPort}/v1/logs`\n      : `https://otlp.${site}/v1/logs`;\n\n    // Only set if not already configured (allow user override)\n    if (!process.env.OTEL_EXPORTER_OTLP_LOGS_ENDPOINT) {\n      process.env.OTEL_EXPORTER_OTLP_LOGS_ENDPOINT = logsEndpoint;\n    }\n\n    if (!process.env.OTEL_EXPORTER_OTLP_LOGS_PROTOCOL) {\n      process.env.OTEL_EXPORTER_OTLP_LOGS_PROTOCOL = 'http/protobuf';\n    }\n\n    // Only set API key header for direct cloud ingestion (not agent mode)\n    if (!useAgent && apiKey && !process.env.OTEL_EXPORTER_OTLP_LOGS_HEADERS) {\n      process.env.OTEL_EXPORTER_OTLP_LOGS_HEADERS = `dd-api-key=${apiKey}`;\n    }\n\n    // Set resource attributes for service identification\n    const resourceAttrs = [\n      `service.name=${service}`,\n      environment ? `deployment.environment=${environment}` : null,\n      version ? `service.version=${version}` : null,\n    ]\n      .filter(Boolean)\n      .join(',');\n\n    if (!process.env.OTEL_RESOURCE_ATTRIBUTES) {\n      process.env.OTEL_RESOURCE_ATTRIBUTES = resourceAttrs;\n    }\n\n    if (logRecordProcessors) {\n      // Use custom processors if provided\n      cloudConfig.logRecordProcessors = logRecordProcessors;\n    } else {\n      // Create default OTLP log exporter\n      try {\n        const pkgRequire = createRequire(\n          typeof __filename === 'string' ? __filename : import.meta.url,\n        );\n        const { BatchLogRecordProcessor } = pkgRequire(\n          '@opentelemetry/sdk-logs',\n        );\n        const { OTLPLogExporter } = pkgRequire(\n          '@opentelemetry/exporter-logs-otlp-http',\n        );\n\n        cloudConfig.logRecordProcessors = [\n          new BatchLogRecordProcessor(\n            new OTLPLogExporter({\n              url: `${otlpEndpoint}/v1/logs`,\n              headers: {\n                'dd-api-key': apiKey,\n              },\n            }),\n          ),\n        ];\n      } catch {\n        throw new Error(\n          'Log export requires @opentelemetry/sdk-logs and @opentelemetry/exporter-logs-otlp-http. ' +\n            'Install them or set enableLogs: false.',\n        );\n      }\n    }\n  }\n\n  return cloudConfig;\n}\n"]}
+{"version":3,"file":"datadog.cjs","names":[],"sources":["../src/datadog.ts"],"sourcesContent":["/**\n * Datadog preset for autotel\n *\n * Provides a simplified configuration helper for Datadog integration\n * with best practices built-in.\n *\n * @example Direct cloud ingestion (serverless, edge)\n * ```typescript\n * import { init } from 'autotel';\n * import { createDatadogConfig } from 'autotel-backends/datadog';\n *\n * init(createDatadogConfig({\n *   apiKey: process.env.DATADOG_API_KEY!,\n *   service: 'my-lambda',\n *   enableLogs: true,\n * }));\n * ```\n *\n * @example Local Datadog Agent (long-running services, Kubernetes)\n * ```typescript\n * import { init } from 'autotel';\n * import { createDatadogConfig } from 'autotel-backends/datadog';\n *\n * init(createDatadogConfig({\n *   service: 'my-api',\n *   useAgent: true,  // No API key needed - Agent handles it\n * }));\n * ```\n */\n\nimport { createRequire } from 'node:module';\nimport type { AutotelConfig } from 'autotel';\nimport type { LogRecordProcessor } from '@opentelemetry/sdk-logs';\n\n// `__filename` exists under CJS (including esbuild's CJS output wrapper) but\n// not pure ESM. `typeof` is safe against an undeclared identifier and lets\n// the conditional pick the working URL in either format.\ndeclare const __filename: string | undefined;\n\n/**\n * Datadog site regions\n */\nexport type DatadogSite =\n  | 'datadoghq.com' // US1 (default)\n  | 'datadoghq.eu' // EU\n  | 'us3.datadoghq.com' // US3\n  | 'us5.datadoghq.com' // US5\n  | 'ap1.datadoghq.com' // AP1\n  | 'ddog-gov.com'; // US1-FED\n\n/**\n * Configuration options for Datadog preset\n */\nexport interface DatadogPresetConfig {\n  /**\n   * Datadog API key (required for direct cloud ingestion).\n   * Not needed if using local Datadog Agent (useAgent: true).\n   *\n   * Get your API key from:\n   * https://app.datadoghq.com/organization-settings/api-keys\n   */\n  apiKey?: string;\n\n  /**\n   * Datadog site/region.\n   * Determines which Datadog intake endpoint to use.\n   *\n   * @default 'datadoghq.com' (US1)\n   */\n  site?: DatadogSite;\n\n  /**\n   * Service name (required).\n   * Appears in Datadog APM, Service Catalog, and all telemetry.\n   */\n  service: string;\n\n  /**\n   * Deployment environment (e.g., 'production', 'staging', 'development').\n   * Used for environment filtering in Datadog.\n   *\n   * @default process.env.DD_ENV || process.env.NODE_ENV || 'development'\n   */\n  environment?: string;\n\n  /**\n   * Service version for deployment tracking.\n   * Enables Deployment Tracking in Datadog APM.\n   *\n   * @default process.env.DD_VERSION || auto-detected from package.json\n   */\n  version?: string;\n\n  /**\n   * Enable log export to Datadog via OTLP.\n   *\n   * When enabled, this:\n   * 1. Sets up OTel Logs SDK with OTLP exporter (for direct OTel logs API usage)\n   * 2. Auto-configures OTEL_EXPORTER_OTLP_LOGS_* env vars for pino-opentelemetry-transport\n   *\n   * For Pino users: Just add pino-opentelemetry-transport to your logger config:\n   * ```typescript\n   * const logger = pino({\n   *   transport: {\n   *     targets: [\n   *       { target: 'pino-pretty' },\n   *       { target: 'pino-opentelemetry-transport' }, // Auto-configured!\n   *     ],\n   *   },\n   * });\n   * ```\n   *\n   * @default false\n   */\n  enableLogs?: boolean;\n\n  /**\n   * Use local Datadog Agent instead of direct cloud ingestion.\n   *\n   * Benefits:\n   * - Lower egress costs (Agent aggregates locally)\n   * - Advanced features: trace-log correlation, multi-line logs, data scrubbing\n   * - 500+ integrations for enrichment\n   * - Infrastructure metrics collection\n   *\n   * Requires: Datadog Agent 7.35+ with OTLP enabled\n   *\n   * @default false\n   */\n  useAgent?: boolean;\n\n  /**\n   * Datadog Agent hostname (when useAgent: true).\n   *\n   * @default 'localhost'\n   */\n  agentHost?: string;\n\n  /**\n   * Datadog Agent OTLP port (when useAgent: true).\n   *\n   * @default 4318 (OTLP HTTP)\n   */\n  agentPort?: number;\n\n  /**\n   * Custom log record processors (advanced).\n   * Overrides the default log processor if enableLogs is true.\n   */\n  logRecordProcessors?: LogRecordProcessor[];\n}\n\n/**\n * Create an autotel configuration optimized for Datadog.\n *\n * This preset handles:\n * - Proper OTLP endpoint configuration (Agent vs direct ingestion)\n *   - Direct: https://otlp.{site} → SDK appends /v1/traces, /v1/metrics, /v1/logs\n *   - Agent: http://localhost:4318 (default)\n * - Datadog API key authentication headers (direct ingestion only)\n * - Unified service tagging (service, env, version)\n * - Resource attribute best practices\n * - Optional log export configuration\n *\n * @param config - Datadog-specific configuration options\n * @returns AutotelConfig ready to pass to init()\n *\n * @example Simple cloud ingestion\n * ```typescript\n * init(createDatadogConfig({\n *   apiKey: process.env.DATADOG_API_KEY!,\n *   service: 'my-app',\n * }));\n * ```\n *\n * @example With logs and custom environment\n * ```typescript\n * init(createDatadogConfig({\n *   apiKey: process.env.DATADOG_API_KEY!,\n *   service: 'my-app',\n *   environment: 'production',\n *   version: '2.1.0',\n *   enableLogs: true,\n * }));\n * ```\n *\n * @example Using local Datadog Agent\n * ```typescript\n * init(createDatadogConfig({\n *   service: 'my-api',\n *   useAgent: true,\n *   agentHost: 'datadog-agent.default.svc.cluster.local', // Kubernetes\n * }));\n * ```\n */\nexport function createDatadogConfig(\n  config: DatadogPresetConfig,\n): AutotelConfig {\n  const {\n    apiKey,\n    site = 'datadoghq.com',\n    service,\n    environment,\n    version,\n    enableLogs = false,\n    useAgent = false,\n    agentHost = 'localhost',\n    agentPort = 4318,\n    logRecordProcessors,\n  } = config;\n\n  // Validation: API key required for direct ingestion\n  if (!useAgent && !apiKey) {\n    throw new Error(\n      'Datadog API key is required for direct cloud ingestion. ' +\n        'Either provide apiKey or set useAgent: true to use local Datadog Agent.',\n    );\n  }\n\n  const baseConfig: AutotelConfig = {\n    service,\n    environment,\n    version,\n  };\n\n  // Local Datadog Agent configuration\n  if (useAgent) {\n    const agentEndpoint = `http://${agentHost}:${agentPort}`;\n\n    // Auto-configure env vars for pino-opentelemetry-transport in agent mode\n    if (enableLogs) {\n      const logsEndpoint = `http://${agentHost}:${agentPort}/v1/logs`;\n\n      if (!process.env.OTEL_EXPORTER_OTLP_LOGS_ENDPOINT) {\n        process.env.OTEL_EXPORTER_OTLP_LOGS_ENDPOINT = logsEndpoint;\n      }\n\n      if (!process.env.OTEL_EXPORTER_OTLP_LOGS_PROTOCOL) {\n        process.env.OTEL_EXPORTER_OTLP_LOGS_PROTOCOL = 'http/protobuf';\n      }\n\n      // No API key header needed for agent mode - Agent handles authentication\n\n      const resourceAttrs = [\n        `service.name=${service}`,\n        environment ? `deployment.environment=${environment}` : null,\n        version ? `service.version=${version}` : null,\n      ]\n        .filter(Boolean)\n        .join(',');\n\n      if (!process.env.OTEL_RESOURCE_ATTRIBUTES) {\n        process.env.OTEL_RESOURCE_ATTRIBUTES = resourceAttrs;\n      }\n    }\n\n    return {\n      ...baseConfig,\n      endpoint: agentEndpoint,\n      // No API key or headers needed - Agent handles authentication\n    };\n  }\n\n  // Direct cloud ingestion configuration\n  // Datadog OTLP endpoint: base URL without path (SDK appends /v1/traces, /v1/metrics, /v1/logs)\n  const otlpEndpoint = `https://otlp.${site}`;\n  const authHeaders = `dd-api-key=${apiKey}`;\n\n  const cloudConfig: AutotelConfig = {\n    ...baseConfig,\n    endpoint: otlpEndpoint,\n    headers: authHeaders,\n  };\n\n  // Add log export if enabled\n  if (enableLogs) {\n    // Auto-configure env vars for pino-opentelemetry-transport and other OTel log transports\n    // These are read by pino-opentelemetry-transport, otlp-logger, and similar libraries\n    const logsEndpoint = useAgent\n      ? `http://${agentHost}:${agentPort}/v1/logs`\n      : `https://otlp.${site}/v1/logs`;\n\n    // Only set if not already configured (allow user override)\n    if (!process.env.OTEL_EXPORTER_OTLP_LOGS_ENDPOINT) {\n      process.env.OTEL_EXPORTER_OTLP_LOGS_ENDPOINT = logsEndpoint;\n    }\n\n    if (!process.env.OTEL_EXPORTER_OTLP_LOGS_PROTOCOL) {\n      process.env.OTEL_EXPORTER_OTLP_LOGS_PROTOCOL = 'http/protobuf';\n    }\n\n    // Only set API key header for direct cloud ingestion (not agent mode)\n    if (!useAgent && apiKey && !process.env.OTEL_EXPORTER_OTLP_LOGS_HEADERS) {\n      process.env.OTEL_EXPORTER_OTLP_LOGS_HEADERS = `dd-api-key=${apiKey}`;\n    }\n\n    // Set resource attributes for service identification\n    const resourceAttrs = [\n      `service.name=${service}`,\n      environment ? `deployment.environment=${environment}` : null,\n      version ? `service.version=${version}` : null,\n    ]\n      .filter(Boolean)\n      .join(',');\n\n    if (!process.env.OTEL_RESOURCE_ATTRIBUTES) {\n      process.env.OTEL_RESOURCE_ATTRIBUTES = resourceAttrs;\n    }\n\n    if (logRecordProcessors) {\n      // Use custom processors if provided\n      cloudConfig.logRecordProcessors = logRecordProcessors;\n    } else {\n      // Create default OTLP log exporter\n      try {\n        const pkgRequire = createRequire(\n          typeof __filename === 'string' ? __filename : import.meta.url,\n        );\n        const { BatchLogRecordProcessor } = pkgRequire(\n          '@opentelemetry/sdk-logs',\n        );\n        const { OTLPLogExporter } = pkgRequire(\n          '@opentelemetry/exporter-logs-otlp-http',\n        );\n\n        cloudConfig.logRecordProcessors = [\n          new BatchLogRecordProcessor(\n            new OTLPLogExporter({\n              url: `${otlpEndpoint}/v1/logs`,\n              headers: {\n                'dd-api-key': apiKey,\n              },\n            }),\n          ),\n        ];\n      } catch {\n        throw new Error(\n          'Log export requires @opentelemetry/sdk-logs and @opentelemetry/exporter-logs-otlp-http. ' +\n            'Install them or set enableLogs: false.',\n        );\n      }\n    }\n  }\n\n  return cloudConfig;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmMA,SAAgB,oBACd,QACe;CACf,MAAM,EACJ,QACA,OAAO,iBACP,SACA,aACA,SACA,aAAa,OACb,WAAW,OACX,YAAY,aACZ,YAAY,MACZ,wBACE;CAGJ,IAAI,CAAC,YAAY,CAAC,QAChB,MAAM,IAAI,MACR,iIAEF;CAGF,MAAM,aAA4B;EAChC;EACA;EACA;CACF;CAGA,IAAI,UAAU;EACZ,MAAM,gBAAgB,UAAU,UAAU,GAAG;EAG7C,IAAI,YAAY;GACd,MAAM,eAAe,UAAU,UAAU,GAAG,UAAU;GAEtD,IAAI,CAAC,QAAQ,IAAI,kCACf,QAAQ,IAAI,mCAAmC;GAGjD,IAAI,CAAC,QAAQ,IAAI,kCACf,QAAQ,IAAI,mCAAmC;GAKjD,MAAM,gBAAgB;IACpB,gBAAgB;IAChB,cAAc,0BAA0B,gBAAgB;IACxD,UAAU,mBAAmB,YAAY;GAC3C,CAAC,CACE,OAAO,OAAO,CAAC,CACf,KAAK,GAAG;GAEX,IAAI,CAAC,QAAQ,IAAI,0BACf,QAAQ,IAAI,2BAA2B;EAE3C;EAEA,OAAO;GACL,GAAG;GACH,UAAU;EAEZ;CACF;CAIA,MAAM,eAAe,gBAAgB;CACrC,MAAM,cAAc,cAAc;CAElC,MAAM,cAA6B;EACjC,GAAG;EACH,UAAU;EACV,SAAS;CACX;CAGA,IAAI,YAAY;EAGd,MAAM,eAAe,WACjB,UAAU,UAAU,GAAG,UAAU,YACjC,gBAAgB,KAAK;EAGzB,IAAI,CAAC,QAAQ,IAAI,kCACf,QAAQ,IAAI,mCAAmC;EAGjD,IAAI,CAAC,QAAQ,IAAI,kCACf,QAAQ,IAAI,mCAAmC;EAIjD,IAAI,CAAC,YAAY,UAAU,CAAC,QAAQ,IAAI,iCACtC,QAAQ,IAAI,kCAAkC,cAAc;EAI9D,MAAM,gBAAgB;GACpB,gBAAgB;GAChB,cAAc,0BAA0B,gBAAgB;GACxD,UAAU,mBAAmB,YAAY;EAC3C,CAAC,CACE,OAAO,OAAO,CAAC,CACf,KAAK,GAAG;EAEX,IAAI,CAAC,QAAQ,IAAI,0BACf,QAAQ,IAAI,2BAA2B;EAGzC,IAAI,qBAEF,YAAY,sBAAsB;OAGlC,IAAI;GACF,MAAM,cAAA,GAAA,YAAA,cAAA,CACJ,OAAO,eAAe,WAAW,aAAA,QAAA,KAAA,CAAA,CAAA,cAAA,UAAA,CAAA,CAAA,IACnC;GACA,MAAM,EAAE,4BAA4B,WAClC,yBACF;GACA,MAAM,EAAE,oBAAoB,WAC1B,wCACF;GAEA,YAAY,sBAAsB,CAChC,IAAI,wBACF,IAAI,gBAAgB;IAClB,KAAK,GAAG,aAAa;IACrB,SAAS,EACP,cAAc,OAChB;GACF,CAAC,CACH,CACF;EACF,QAAQ;GACN,MAAM,IAAI,MACR,gIAEF;EACF;CAEJ;CAEA,OAAO;AACT"}

package/dist/datadog.d.cts

@@ -1,36 +1,7 @@
-import { AutotelConfig } from 'autotel';
-import { LogRecordProcessor } from '@opentelemetry/sdk-logs';
-
-/**
- * Datadog preset for autotel
- *
- * Provides a simplified configuration helper for Datadog integration
- * with best practices built-in.
- *
- * @example Direct cloud ingestion (serverless, edge)
- * ```typescript
- * import { init } from 'autotel';
- * import { createDatadogConfig } from 'autotel-backends/datadog';
- *
- * init(createDatadogConfig({
- *   apiKey: process.env.DATADOG_API_KEY!,
- *   service: 'my-lambda',
- *   enableLogs: true,
- * }));
- * ```
- *
- * @example Local Datadog Agent (long-running services, Kubernetes)
- * ```typescript
- * import { init } from 'autotel';
- * import { createDatadogConfig } from 'autotel-backends/datadog';
- *
- * init(createDatadogConfig({
- *   service: 'my-api',
- *   useAgent: true,  // No API key needed - Agent handles it
- * }));
- * ```
- */
+import { AutotelConfig } from "autotel";
+import { LogRecordProcessor } from "@opentelemetry/sdk-logs";
 
+//#region src/datadog.d.ts
 /**
  * Datadog site regions
  */
@@ -39,93 +10,93 @@ type DatadogSite = 'datadoghq.com' | 'datadoghq.eu' | 'us3.datadoghq.com' | 'us5
  * Configuration options for Datadog preset
  */
 interface DatadogPresetConfig {
-    /**
-     * Datadog API key (required for direct cloud ingestion).
-     * Not needed if using local Datadog Agent (useAgent: true).
-     *
-     * Get your API key from:
-     * https://app.datadoghq.com/organization-settings/api-keys
-     */
-    apiKey?: string;
-    /**
-     * Datadog site/region.
-     * Determines which Datadog intake endpoint to use.
-     *
-     * @default 'datadoghq.com' (US1)
-     */
-    site?: DatadogSite;
-    /**
-     * Service name (required).
-     * Appears in Datadog APM, Service Catalog, and all telemetry.
-     */
-    service: string;
-    /**
-     * Deployment environment (e.g., 'production', 'staging', 'development').
-     * Used for environment filtering in Datadog.
-     *
-     * @default process.env.DD_ENV || process.env.NODE_ENV || 'development'
-     */
-    environment?: string;
-    /**
-     * Service version for deployment tracking.
-     * Enables Deployment Tracking in Datadog APM.
-     *
-     * @default process.env.DD_VERSION || auto-detected from package.json
-     */
-    version?: string;
-    /**
-     * Enable log export to Datadog via OTLP.
-     *
-     * When enabled, this:
-     * 1. Sets up OTel Logs SDK with OTLP exporter (for direct OTel logs API usage)
-     * 2. Auto-configures OTEL_EXPORTER_OTLP_LOGS_* env vars for pino-opentelemetry-transport
-     *
-     * For Pino users: Just add pino-opentelemetry-transport to your logger config:
-     * ```typescript
-     * const logger = pino({
-     *   transport: {
-     *     targets: [
-     *       { target: 'pino-pretty' },
-     *       { target: 'pino-opentelemetry-transport' }, // Auto-configured!
-     *     ],
-     *   },
-     * });
-     * ```
-     *
-     * @default false
-     */
-    enableLogs?: boolean;
-    /**
-     * Use local Datadog Agent instead of direct cloud ingestion.
-     *
-     * Benefits:
-     * - Lower egress costs (Agent aggregates locally)
-     * - Advanced features: trace-log correlation, multi-line logs, data scrubbing
-     * - 500+ integrations for enrichment
-     * - Infrastructure metrics collection
-     *
-     * Requires: Datadog Agent 7.35+ with OTLP enabled
-     *
-     * @default false
-     */
-    useAgent?: boolean;
-    /**
-     * Datadog Agent hostname (when useAgent: true).
-     *
-     * @default 'localhost'
-     */
-    agentHost?: string;
-    /**
-     * Datadog Agent OTLP port (when useAgent: true).
-     *
-     * @default 4318 (OTLP HTTP)
-     */
-    agentPort?: number;
-    /**
-     * Custom log record processors (advanced).
-     * Overrides the default log processor if enableLogs is true.
-     */
-    logRecordProcessors?: LogRecordProcessor[];
+  /**
+   * Datadog API key (required for direct cloud ingestion).
+   * Not needed if using local Datadog Agent (useAgent: true).
+   *
+   * Get your API key from:
+   * https://app.datadoghq.com/organization-settings/api-keys
+   */
+  apiKey?: string;
+  /**
+   * Datadog site/region.
+   * Determines which Datadog intake endpoint to use.
+   *
+   * @default 'datadoghq.com' (US1)
+   */
+  site?: DatadogSite;
+  /**
+   * Service name (required).
+   * Appears in Datadog APM, Service Catalog, and all telemetry.
+   */
+  service: string;
+  /**
+   * Deployment environment (e.g., 'production', 'staging', 'development').
+   * Used for environment filtering in Datadog.
+   *
+   * @default process.env.DD_ENV || process.env.NODE_ENV || 'development'
+   */
+  environment?: string;
+  /**
+   * Service version for deployment tracking.
+   * Enables Deployment Tracking in Datadog APM.
+   *
+   * @default process.env.DD_VERSION || auto-detected from package.json
+   */
+  version?: string;
+  /**
+   * Enable log export to Datadog via OTLP.
+   *
+   * When enabled, this:
+   * 1. Sets up OTel Logs SDK with OTLP exporter (for direct OTel logs API usage)
+   * 2. Auto-configures OTEL_EXPORTER_OTLP_LOGS_* env vars for pino-opentelemetry-transport
+   *
+   * For Pino users: Just add pino-opentelemetry-transport to your logger config:
+   * ```typescript
+   * const logger = pino({
+   *   transport: {
+   *     targets: [
+   *       { target: 'pino-pretty' },
+   *       { target: 'pino-opentelemetry-transport' }, // Auto-configured!
+   *     ],
+   *   },
+   * });
+   * ```
+   *
+   * @default false
+   */
+  enableLogs?: boolean;
+  /**
+   * Use local Datadog Agent instead of direct cloud ingestion.
+   *
+   * Benefits:
+   * - Lower egress costs (Agent aggregates locally)
+   * - Advanced features: trace-log correlation, multi-line logs, data scrubbing
+   * - 500+ integrations for enrichment
+   * - Infrastructure metrics collection
+   *
+   * Requires: Datadog Agent 7.35+ with OTLP enabled
+   *
+   * @default false
+   */
+  useAgent?: boolean;
+  /**
+   * Datadog Agent hostname (when useAgent: true).
+   *
+   * @default 'localhost'
+   */
+  agentHost?: string;
+  /**
+   * Datadog Agent OTLP port (when useAgent: true).
+   *
+   * @default 4318 (OTLP HTTP)
+   */
+  agentPort?: number;
+  /**
+   * Custom log record processors (advanced).
+   * Overrides the default log processor if enableLogs is true.
+   */
+  logRecordProcessors?: LogRecordProcessor[];
 }
 /**
  * Create an autotel configuration optimized for Datadog.
@@ -171,5 +142,6 @@ interface DatadogPresetConfig {
  * ```
  */
 declare function createDatadogConfig(config: DatadogPresetConfig): AutotelConfig;
-
-export { type DatadogPresetConfig, type DatadogSite, createDatadogConfig };
+//#endregion
+export { DatadogPresetConfig, DatadogSite, createDatadogConfig };
+//# sourceMappingURL=datadog.d.cts.map

package/dist/datadog.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datadog.d.cts","names":[],"sources":["../src/datadog.ts"],"mappings":";;;;;;;KA0CY,WAAA;AA2JI;;;AAAA,UAhJC,mBAAA;;;;;;;;EAQf,MAAA;;;;;;;EAQA,IAAA,GAAO,WAAA;;;;;EAMP,OAAA;;;;;;;EAQA,WAAA;;;;;;;EAQA,OAAA;;;;;;;;;;;;;;;;;;;;;;EAuBA,UAAA;;;;;;;;;;;;;;EAeA,QAAA;;;;;;EAOA,SAAA;;;;;;EAOA,SAAA;;;;;EAMA,mBAAA,GAAsB,kBAAkB;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8C1B,mBAAA,CACd,MAAA,EAAQ,mBAAA,GACP,aAAa"}