autotel-backends 2.12.43 → 2.13.1

package/README.md

@@ -136,6 +136,81 @@ init(
 
 [View full Datadog configuration options →](./src/datadog.ts)
 
+### 🔥 Logfire
+
+[Pydantic Logfire](https://pydantic.dev/logfire) keeps `gen_ai.*` semantic-convention attributes and W3C trace IDs intact on the read path, so GenAI traces come back the shape you emitted them.
+
+```typescript
+import { createLogfireConfig } from 'autotel-backends/logfire';
+
+init(
+  createLogfireConfig({
+    writeToken: process.env.LOGFIRE_WRITE_TOKEN!,
+    service: 'my-app',
+    region: 'eu', // or 'us' — required
+  }),
+);
+```
+
+**Features**:
+
+- Forces OTLP/HTTP **protobuf** — Logfire rejects gRPC and silently drops a JSON body, so either default loses your traces without an error
+- `region` is required, because both ingest and the query API are region-specific and a mismatch returns a bare 401 that names neither cause. Override `endpoint` for self-hosted.
+- Sends the write token bare, as Logfire's ingest expects (its query API wants `Bearer <read-token>` instead — different credential, different format)
+
+[View full Logfire configuration options →](./src/logfire.ts)
+
+### 🦔 PostHog
+
+[PostHog](https://posthog.com) ingests OTLP traces, logs and metrics, so product analytics and distributed traces can share a destination. (For product _events_, see `autotel-subscribers/posthog` — a separate path.)
+
+```typescript
+import { createPostHogConfig } from 'autotel-backends/posthog';
+
+init(
+  createPostHogConfig({
+    projectToken: process.env.POSTHOG_PROJECT_TOKEN!,
+    service: 'my-app',
+    region: 'eu', // or 'us'
+  }),
+);
+```
+
+**Features**:
+
+- OTLP/HTTP **protobuf** — PostHog's docs steer away from the JSON exporter, and a JSON body is dropped rather than rejected
+- Handles the `/i` path prefix its OTLP receiver lives under, so signals land on `/i/v1/traces`, `/i/v1/logs` and `/i/v1/metrics`
+- US and EU cloud regions, plus a self-hosted `host` override
+- Bearer auth with the `phc_…` project token
+
+[View full PostHog configuration options →](./src/posthog.ts)
+
+### 🪢 Langfuse
+
+[Langfuse](https://langfuse.com) ingests plain OTLP, so autotel's GenAI spans land without a Langfuse SDK in your app.
+
+```typescript
+import { createLangfuseConfig } from 'autotel-backends/langfuse';
+
+init(
+  createLangfuseConfig({
+    publicKey: process.env.LANGFUSE_PUBLIC_KEY!,
+    secretKey: process.env.LANGFUSE_SECRET_KEY!,
+    service: 'my-app',
+    region: 'eu', // or 'us'
+  }),
+);
+```
+
+**Features**:
+
+- OTLP/HTTP only — Langfuse does not support gRPC
+- EU and US cloud regions, plus a self-hosted `baseUrl` override
+- Basic auth built from your public/secret key pair
+- Opts into v4 ingestion, which keeps traces queryable promptly
+
+[View full Langfuse configuration options →](./src/langfuse.ts)
+
 ## Why Use Backend Configs?
 
 ### Without backend configs (manual):

package/dist/datadog.cjs

@@ -134,5 +134,3 @@ function createDatadogConfig(config) {
 }
 //#endregion
 exports.createDatadogConfig = createDatadogConfig;
-
-//# sourceMappingURL=datadog.cjs.map

package/dist/datadog.d.cts

@@ -142,5 +142,4 @@ interface DatadogPresetConfig {
  */
 declare function createDatadogConfig(config: DatadogPresetConfig): AutotelConfig;
 //#endregion
-export { DatadogPresetConfig, DatadogSite, createDatadogConfig };
-//# sourceMappingURL=datadog.d.cts.map
+export { DatadogPresetConfig, DatadogSite, createDatadogConfig };

package/dist/datadog.d.ts

@@ -142,5 +142,4 @@ interface DatadogPresetConfig {
  */
 declare function createDatadogConfig(config: DatadogPresetConfig): AutotelConfig;
 //#endregion
-export { DatadogPresetConfig, DatadogSite, createDatadogConfig };
-//# sourceMappingURL=datadog.d.ts.map
+export { DatadogPresetConfig, DatadogSite, createDatadogConfig };

package/dist/datadog.js

@@ -133,5 +133,3 @@ function createDatadogConfig(config) {
 }
 //#endregion
 export { createDatadogConfig };
-
-//# sourceMappingURL=datadog.js.map

package/dist/google-cloud.cjs

@@ -118,5 +118,3 @@ var GcpAuthSpanExporter = class {
 };
 //#endregion
 exports.createGoogleCloudConfig = createGoogleCloudConfig;
-
-//# sourceMappingURL=google-cloud.cjs.map

package/dist/google-cloud.d.cts

@@ -66,5 +66,4 @@ interface GoogleCloudPresetConfig {
  */
 declare function createGoogleCloudConfig(config: GoogleCloudPresetConfig): AutotelConfig;
 //#endregion
-export { GoogleCloudPresetConfig, createGoogleCloudConfig };
-//# sourceMappingURL=google-cloud.d.cts.map
+export { GoogleCloudPresetConfig, createGoogleCloudConfig };

package/dist/google-cloud.d.ts

@@ -66,5 +66,4 @@ interface GoogleCloudPresetConfig {
  */
 declare function createGoogleCloudConfig(config: GoogleCloudPresetConfig): AutotelConfig;
 //#endregion
-export { GoogleCloudPresetConfig, createGoogleCloudConfig };
-//# sourceMappingURL=google-cloud.d.ts.map
+export { GoogleCloudPresetConfig, createGoogleCloudConfig };

package/dist/google-cloud.js

@@ -117,5 +117,3 @@ var GcpAuthSpanExporter = class {
 };
 //#endregion
 export { createGoogleCloudConfig };
-
-//# sourceMappingURL=google-cloud.js.map

package/dist/grafana.cjs

@@ -77,5 +77,3 @@ function createGrafanaConfig(config) {
 }
 //#endregion
 exports.createGrafanaConfig = createGrafanaConfig;
-
-//# sourceMappingURL=grafana.cjs.map

package/dist/grafana.d.cts

@@ -60,5 +60,4 @@ interface GrafanaPresetConfig {
  */
 declare function createGrafanaConfig(config: GrafanaPresetConfig): AutotelConfig;
 //#endregion
-export { GrafanaPresetConfig, createGrafanaConfig };
-//# sourceMappingURL=grafana.d.cts.map
+export { GrafanaPresetConfig, createGrafanaConfig };

package/dist/grafana.d.ts

@@ -60,5 +60,4 @@ interface GrafanaPresetConfig {
  */
 declare function createGrafanaConfig(config: GrafanaPresetConfig): AutotelConfig;
 //#endregion
-export { GrafanaPresetConfig, createGrafanaConfig };
-//# sourceMappingURL=grafana.d.ts.map
+export { GrafanaPresetConfig, createGrafanaConfig };

package/dist/grafana.js

@@ -76,5 +76,3 @@ function createGrafanaConfig(config) {
 }
 //#endregion
 export { createGrafanaConfig };
-
-//# sourceMappingURL=grafana.js.map

package/dist/honeycomb.cjs

@@ -60,5 +60,3 @@ function createHoneycombConfig(config) {
 }
 //#endregion
 exports.createHoneycombConfig = createHoneycombConfig;
-
-//# sourceMappingURL=honeycomb.cjs.map

package/dist/honeycomb.d.cts

@@ -103,5 +103,4 @@ interface HoneycombPresetConfig {
  */
 declare function createHoneycombConfig(config: HoneycombPresetConfig): AutotelConfig;
 //#endregion
-export { HoneycombPresetConfig, createHoneycombConfig };
-//# sourceMappingURL=honeycomb.d.cts.map
+export { HoneycombPresetConfig, createHoneycombConfig };

package/dist/honeycomb.d.ts

@@ -103,5 +103,4 @@ interface HoneycombPresetConfig {
  */
 declare function createHoneycombConfig(config: HoneycombPresetConfig): AutotelConfig;
 //#endregion
-export { HoneycombPresetConfig, createHoneycombConfig };
-//# sourceMappingURL=honeycomb.d.ts.map
+export { HoneycombPresetConfig, createHoneycombConfig };

package/dist/honeycomb.js

@@ -59,5 +59,3 @@ function createHoneycombConfig(config) {
 }
 //#endregion
 export { createHoneycombConfig };
-
-//# sourceMappingURL=honeycomb.js.map

package/dist/index.cjs

@@ -3,7 +3,13 @@ const require_honeycomb = require("./honeycomb.cjs");
 const require_datadog = require("./datadog.cjs");
 const require_google_cloud = require("./google-cloud.cjs");
 const require_grafana = require("./grafana.cjs");
+const require_logfire = require("./logfire.cjs");
+const require_posthog = require("./posthog.cjs");
+const require_langfuse = require("./langfuse.cjs");
 exports.createDatadogConfig = require_datadog.createDatadogConfig;
 exports.createGoogleCloudConfig = require_google_cloud.createGoogleCloudConfig;
 exports.createGrafanaConfig = require_grafana.createGrafanaConfig;
 exports.createHoneycombConfig = require_honeycomb.createHoneycombConfig;
+exports.createLangfuseConfig = require_langfuse.createLangfuseConfig;
+exports.createLogfireConfig = require_logfire.createLogfireConfig;
+exports.createPostHogConfig = require_posthog.createPostHogConfig;

package/dist/index.d.cts

@@ -2,4 +2,7 @@ import { DatadogPresetConfig, DatadogSite, createDatadogConfig } from "./datadog
 import { GoogleCloudPresetConfig, createGoogleCloudConfig } from "./google-cloud.cjs";
 import { GrafanaPresetConfig, createGrafanaConfig } from "./grafana.cjs";
 import { HoneycombPresetConfig, createHoneycombConfig } from "./honeycomb.cjs";
-export { type DatadogPresetConfig, type DatadogSite, type GoogleCloudPresetConfig, type GrafanaPresetConfig, type HoneycombPresetConfig, createDatadogConfig, createGoogleCloudConfig, createGrafanaConfig, createHoneycombConfig };
+import { LogfirePresetConfig, LogfireRegion, createLogfireConfig } from "./logfire.cjs";
+import { PostHogPresetConfig, PostHogRegion, createPostHogConfig } from "./posthog.cjs";
+import { LangfusePresetConfig, LangfuseRegion, createLangfuseConfig } from "./langfuse.cjs";
+export { type DatadogPresetConfig, type DatadogSite, type GoogleCloudPresetConfig, type GrafanaPresetConfig, type HoneycombPresetConfig, type LangfusePresetConfig, type LangfuseRegion, type LogfirePresetConfig, type LogfireRegion, type PostHogPresetConfig, type PostHogRegion, createDatadogConfig, createGoogleCloudConfig, createGrafanaConfig, createHoneycombConfig, createLangfuseConfig, createLogfireConfig, createPostHogConfig };

package/dist/index.d.ts

@@ -2,4 +2,7 @@ import { DatadogPresetConfig, DatadogSite, createDatadogConfig } from "./datadog
 import { GoogleCloudPresetConfig, createGoogleCloudConfig } from "./google-cloud.js";
 import { GrafanaPresetConfig, createGrafanaConfig } from "./grafana.js";
 import { HoneycombPresetConfig, createHoneycombConfig } from "./honeycomb.js";
-export { type DatadogPresetConfig, type DatadogSite, type GoogleCloudPresetConfig, type GrafanaPresetConfig, type HoneycombPresetConfig, createDatadogConfig, createGoogleCloudConfig, createGrafanaConfig, createHoneycombConfig };
+import { LogfirePresetConfig, LogfireRegion, createLogfireConfig } from "./logfire.js";
+import { PostHogPresetConfig, PostHogRegion, createPostHogConfig } from "./posthog.js";
+import { LangfusePresetConfig, LangfuseRegion, createLangfuseConfig } from "./langfuse.js";
+export { type DatadogPresetConfig, type DatadogSite, type GoogleCloudPresetConfig, type GrafanaPresetConfig, type HoneycombPresetConfig, type LangfusePresetConfig, type LangfuseRegion, type LogfirePresetConfig, type LogfireRegion, type PostHogPresetConfig, type PostHogRegion, createDatadogConfig, createGoogleCloudConfig, createGrafanaConfig, createHoneycombConfig, createLangfuseConfig, createLogfireConfig, createPostHogConfig };

package/dist/index.js

@@ -2,4 +2,7 @@ import { createHoneycombConfig } from "./honeycomb.js";
 import { createDatadogConfig } from "./datadog.js";
 import { createGoogleCloudConfig } from "./google-cloud.js";
 import { createGrafanaConfig } from "./grafana.js";
-export { createDatadogConfig, createGoogleCloudConfig, createGrafanaConfig, createHoneycombConfig };
+import { createLogfireConfig } from "./logfire.js";
+import { createPostHogConfig } from "./posthog.js";
+import { createLangfuseConfig } from "./langfuse.js";
+export { createDatadogConfig, createGoogleCloudConfig, createGrafanaConfig, createHoneycombConfig, createLangfuseConfig, createLogfireConfig, createPostHogConfig };

package/dist/langfuse.cjs

@@ -0,0 +1,43 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/langfuse.ts
+/** Langfuse Cloud regions and their base URLs. */
+const REGION_BASE_URLS = {
+	eu: "https://cloud.langfuse.com",
+	us: "https://us.cloud.langfuse.com"
+};
+/** OTLP receiver path, appended to whichever base URL is in play. */
+const OTEL_PATH = "/api/public/otel";
+/**
+* Create an autotel configuration for Langfuse.
+*
+* This preset handles:
+* - OTLP/HTTP protocol — Langfuse does not support gRPC
+* - The regional (or self-hosted) OTLP receiver URL
+* - Basic auth over the public/secret key pair
+* - Opting into v4 ingestion, which keeps traces queryable promptly
+*
+* @param config - Langfuse-specific configuration options
+* @returns AutotelConfig ready to pass to init()
+*/
+function createLangfuseConfig(config) {
+	const { publicKey, secretKey, service, region = "eu", environment, version, baseUrl } = config;
+	if (!publicKey) throw new Error("Langfuse public key is required. Find it under Settings → API Keys.");
+	if (!secretKey) throw new Error("Langfuse secret key is required. Find it under Settings → API Keys.");
+	const regionBaseUrl = REGION_BASE_URLS[region];
+	if (!regionBaseUrl) throw new Error(`Unknown Langfuse region "${region}". Supported regions: ${Object.keys(REGION_BASE_URLS).join(", ")}.`);
+	const root = (baseUrl ?? regionBaseUrl).replace(/\/+$/, "");
+	const credentials = Buffer.from(`${publicKey}:${secretKey}`).toString("base64");
+	return {
+		service,
+		environment,
+		version,
+		protocol: "http",
+		endpoint: `${root}${OTEL_PATH}`,
+		headers: {
+			Authorization: `Basic ${credentials}`,
+			"x-langfuse-ingestion-version": "4"
+		}
+	};
+}
+//#endregion
+exports.createLangfuseConfig = createLangfuseConfig;

package/dist/langfuse.d.cts

@@ -0,0 +1,68 @@
+import { AutotelConfig } from "autotel";
+//#region src/langfuse.d.ts
+/** Langfuse Cloud regions and their base URLs. */
+declare const REGION_BASE_URLS: {
+  readonly eu: "https://cloud.langfuse.com";
+  readonly us: "https://us.cloud.langfuse.com";
+};
+type LangfuseRegion = keyof typeof REGION_BASE_URLS;
+/**
+ * Configuration options for the Langfuse preset
+ */
+interface LangfusePresetConfig {
+  /**
+   * Langfuse public key, `pk-lf-...` (required).
+   * Found under Settings → API Keys.
+   */
+  publicKey: string;
+  /**
+   * Langfuse secret key, `sk-lf-...` (required).
+   * Found under Settings → API Keys.
+   */
+  secretKey: string;
+  /**
+   * Service name (required).
+   * Appears as service.name on every span.
+   */
+  service: string;
+  /**
+   * Langfuse Cloud region the project lives in.
+   *
+   * @default 'eu'
+   */
+  region?: LangfuseRegion;
+  /**
+   * Deployment environment (e.g., 'production', 'staging', 'development').
+   *
+   * @default process.env.NODE_ENV || 'development'
+   */
+  environment?: string;
+  /**
+   * Service version for deployment tracking.
+   *
+   * @default process.env.VERSION || auto-detected from package.json
+   */
+  version?: string;
+  /**
+   * Base URL of a self-hosted Langfuse instance, without the OTLP path.
+   * Takes precedence over `region`.
+   *
+   * @default the base URL for the selected region
+   */
+  baseUrl?: string;
+}
+/**
+ * Create an autotel configuration for Langfuse.
+ *
+ * This preset handles:
+ * - OTLP/HTTP protocol — Langfuse does not support gRPC
+ * - The regional (or self-hosted) OTLP receiver URL
+ * - Basic auth over the public/secret key pair
+ * - Opting into v4 ingestion, which keeps traces queryable promptly
+ *
+ * @param config - Langfuse-specific configuration options
+ * @returns AutotelConfig ready to pass to init()
+ */
+declare function createLangfuseConfig(config: LangfusePresetConfig): AutotelConfig;
+//#endregion
+export { LangfusePresetConfig, LangfuseRegion, createLangfuseConfig };

package/dist/langfuse.d.ts

@@ -0,0 +1,68 @@
+import { AutotelConfig } from "autotel";
+//#region src/langfuse.d.ts
+/** Langfuse Cloud regions and their base URLs. */
+declare const REGION_BASE_URLS: {
+  readonly eu: "https://cloud.langfuse.com";
+  readonly us: "https://us.cloud.langfuse.com";
+};
+type LangfuseRegion = keyof typeof REGION_BASE_URLS;
+/**
+ * Configuration options for the Langfuse preset
+ */
+interface LangfusePresetConfig {
+  /**
+   * Langfuse public key, `pk-lf-...` (required).
+   * Found under Settings → API Keys.
+   */
+  publicKey: string;
+  /**
+   * Langfuse secret key, `sk-lf-...` (required).
+   * Found under Settings → API Keys.
+   */
+  secretKey: string;
+  /**
+   * Service name (required).
+   * Appears as service.name on every span.
+   */
+  service: string;
+  /**
+   * Langfuse Cloud region the project lives in.
+   *
+   * @default 'eu'
+   */
+  region?: LangfuseRegion;
+  /**
+   * Deployment environment (e.g., 'production', 'staging', 'development').
+   *
+   * @default process.env.NODE_ENV || 'development'
+   */
+  environment?: string;
+  /**
+   * Service version for deployment tracking.
+   *
+   * @default process.env.VERSION || auto-detected from package.json
+   */
+  version?: string;
+  /**
+   * Base URL of a self-hosted Langfuse instance, without the OTLP path.
+   * Takes precedence over `region`.
+   *
+   * @default the base URL for the selected region
+   */
+  baseUrl?: string;
+}
+/**
+ * Create an autotel configuration for Langfuse.
+ *
+ * This preset handles:
+ * - OTLP/HTTP protocol — Langfuse does not support gRPC
+ * - The regional (or self-hosted) OTLP receiver URL
+ * - Basic auth over the public/secret key pair
+ * - Opting into v4 ingestion, which keeps traces queryable promptly
+ *
+ * @param config - Langfuse-specific configuration options
+ * @returns AutotelConfig ready to pass to init()
+ */
+declare function createLangfuseConfig(config: LangfusePresetConfig): AutotelConfig;
+//#endregion
+export { LangfusePresetConfig, LangfuseRegion, createLangfuseConfig };

package/dist/langfuse.js

@@ -0,0 +1,42 @@
+//#region src/langfuse.ts
+/** Langfuse Cloud regions and their base URLs. */
+const REGION_BASE_URLS = {
+	eu: "https://cloud.langfuse.com",
+	us: "https://us.cloud.langfuse.com"
+};
+/** OTLP receiver path, appended to whichever base URL is in play. */
+const OTEL_PATH = "/api/public/otel";
+/**
+* Create an autotel configuration for Langfuse.
+*
+* This preset handles:
+* - OTLP/HTTP protocol — Langfuse does not support gRPC
+* - The regional (or self-hosted) OTLP receiver URL
+* - Basic auth over the public/secret key pair
+* - Opting into v4 ingestion, which keeps traces queryable promptly
+*
+* @param config - Langfuse-specific configuration options
+* @returns AutotelConfig ready to pass to init()
+*/
+function createLangfuseConfig(config) {
+	const { publicKey, secretKey, service, region = "eu", environment, version, baseUrl } = config;
+	if (!publicKey) throw new Error("Langfuse public key is required. Find it under Settings → API Keys.");
+	if (!secretKey) throw new Error("Langfuse secret key is required. Find it under Settings → API Keys.");
+	const regionBaseUrl = REGION_BASE_URLS[region];
+	if (!regionBaseUrl) throw new Error(`Unknown Langfuse region "${region}". Supported regions: ${Object.keys(REGION_BASE_URLS).join(", ")}.`);
+	const root = (baseUrl ?? regionBaseUrl).replace(/\/+$/, "");
+	const credentials = Buffer.from(`${publicKey}:${secretKey}`).toString("base64");
+	return {
+		service,
+		environment,
+		version,
+		protocol: "http",
+		endpoint: `${root}${OTEL_PATH}`,
+		headers: {
+			Authorization: `Basic ${credentials}`,
+			"x-langfuse-ingestion-version": "4"
+		}
+	};
+}
+//#endregion
+export { createLangfuseConfig };

package/dist/logfire.cjs

@@ -0,0 +1,43 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/logfire.ts
+/**
+* Region ingest endpoints.
+*
+* Verified against the live API: the shared `logfire-api.pydantic.dev` host
+* returns 401 for ingest. Logfire's own SDK resolves the region host from the
+* token client-side rather than relying on server-side routing, so the region
+* has to be named — which is why it is required below rather than defaulted.
+* Guessing it wrong produces a bare 401 that names neither cause.
+*/
+const REGION_ENDPOINTS = {
+	us: "https://logfire-us.pydantic.dev",
+	eu: "https://logfire-eu.pydantic.dev"
+};
+/**
+* Create an autotel configuration for Pydantic Logfire.
+*
+* This preset handles:
+* - OTLP/HTTP **protobuf** — Logfire accepts neither gRPC nor a JSON body, and
+*   an SDK defaulting to either fails silently
+* - The regional ingest endpoint
+* - The bare-token `Authorization` header Logfire's ingest expects
+*
+* @param config - Logfire-specific configuration options
+* @returns AutotelConfig ready to pass to init()
+*/
+function createLogfireConfig(config) {
+	const { writeToken, service, region, environment, version } = config;
+	if (!writeToken) throw new Error("Logfire write token is required. Create one under Project Settings → Write Tokens.");
+	const regionEndpoint = REGION_ENDPOINTS[region];
+	if (!regionEndpoint) throw new Error(`Unknown Logfire region "${region}". Supported regions: ${Object.keys(REGION_ENDPOINTS).join(", ")}.`);
+	return {
+		service,
+		environment,
+		version,
+		protocol: "http/protobuf",
+		endpoint: config.endpoint ?? regionEndpoint,
+		headers: { Authorization: writeToken }
+	};
+}
+//#endregion
+exports.createLogfireConfig = createLogfireConfig;

package/dist/logfire.d.cts

@@ -0,0 +1,76 @@
+import { AutotelConfig } from "autotel";
+//#region src/logfire.d.ts
+/**
+ * Region ingest endpoints.
+ *
+ * Verified against the live API: the shared `logfire-api.pydantic.dev` host
+ * returns 401 for ingest. Logfire's own SDK resolves the region host from the
+ * token client-side rather than relying on server-side routing, so the region
+ * has to be named — which is why it is required below rather than defaulted.
+ * Guessing it wrong produces a bare 401 that names neither cause.
+ */
+declare const REGION_ENDPOINTS: {
+  readonly us: "https://logfire-us.pydantic.dev";
+  readonly eu: "https://logfire-eu.pydantic.dev";
+};
+type LogfireRegion = keyof typeof REGION_ENDPOINTS;
+/**
+ * Configuration options for the Logfire preset
+ */
+interface LogfirePresetConfig {
+  /**
+   * Logfire **write** token (required).
+   *
+   * Create one under Project Settings → Write Tokens. Note this is a different
+   * credential from the read-scope token the query API needs — a write token is
+   * rejected for reads, and vice versa.
+   */
+  writeToken: string;
+  /**
+   * Service name (required).
+   * Appears as service.name on every span.
+   */
+  service: string;
+  /**
+   * Data region the project lives in (required).
+   *
+   * Both ingest and the query API are region-specific, and a mismatch returns
+   * a bare 401, so this is explicit rather than guessed. Ignored when
+   * `endpoint` is set for a self-hosted instance.
+   */
+  region: LogfireRegion;
+  /**
+   * Deployment environment (e.g., 'production', 'staging', 'development').
+   *
+   * @default process.env.NODE_ENV || 'development'
+   */
+  environment?: string;
+  /**
+   * Service version for deployment tracking.
+   *
+   * @default process.env.VERSION || auto-detected from package.json
+   */
+  version?: string;
+  /**
+   * Full OTLP endpoint override, for self-hosted Logfire.
+   * Takes precedence over `region`.
+   *
+   * @default the named region's endpoint
+   */
+  endpoint?: string;
+}
+/**
+ * Create an autotel configuration for Pydantic Logfire.
+ *
+ * This preset handles:
+ * - OTLP/HTTP **protobuf** — Logfire accepts neither gRPC nor a JSON body, and
+ *   an SDK defaulting to either fails silently
+ * - The regional ingest endpoint
+ * - The bare-token `Authorization` header Logfire's ingest expects
+ *
+ * @param config - Logfire-specific configuration options
+ * @returns AutotelConfig ready to pass to init()
+ */
+declare function createLogfireConfig(config: LogfirePresetConfig): AutotelConfig;
+//#endregion
+export { LogfirePresetConfig, LogfireRegion, createLogfireConfig };

package/dist/logfire.d.ts

@@ -0,0 +1,76 @@
+import { AutotelConfig } from "autotel";
+//#region src/logfire.d.ts
+/**
+ * Region ingest endpoints.
+ *
+ * Verified against the live API: the shared `logfire-api.pydantic.dev` host
+ * returns 401 for ingest. Logfire's own SDK resolves the region host from the
+ * token client-side rather than relying on server-side routing, so the region
+ * has to be named — which is why it is required below rather than defaulted.
+ * Guessing it wrong produces a bare 401 that names neither cause.
+ */
+declare const REGION_ENDPOINTS: {
+  readonly us: "https://logfire-us.pydantic.dev";
+  readonly eu: "https://logfire-eu.pydantic.dev";
+};
+type LogfireRegion = keyof typeof REGION_ENDPOINTS;
+/**
+ * Configuration options for the Logfire preset
+ */
+interface LogfirePresetConfig {
+  /**
+   * Logfire **write** token (required).
+   *
+   * Create one under Project Settings → Write Tokens. Note this is a different
+   * credential from the read-scope token the query API needs — a write token is
+   * rejected for reads, and vice versa.
+   */
+  writeToken: string;
+  /**
+   * Service name (required).
+   * Appears as service.name on every span.
+   */
+  service: string;
+  /**
+   * Data region the project lives in (required).
+   *
+   * Both ingest and the query API are region-specific, and a mismatch returns
+   * a bare 401, so this is explicit rather than guessed. Ignored when
+   * `endpoint` is set for a self-hosted instance.
+   */
+  region: LogfireRegion;
+  /**
+   * Deployment environment (e.g., 'production', 'staging', 'development').
+   *
+   * @default process.env.NODE_ENV || 'development'
+   */
+  environment?: string;
+  /**
+   * Service version for deployment tracking.
+   *
+   * @default process.env.VERSION || auto-detected from package.json
+   */
+  version?: string;
+  /**
+   * Full OTLP endpoint override, for self-hosted Logfire.
+   * Takes precedence over `region`.
+   *
+   * @default the named region's endpoint
+   */
+  endpoint?: string;
+}
+/**
+ * Create an autotel configuration for Pydantic Logfire.
+ *
+ * This preset handles:
+ * - OTLP/HTTP **protobuf** — Logfire accepts neither gRPC nor a JSON body, and
+ *   an SDK defaulting to either fails silently
+ * - The regional ingest endpoint
+ * - The bare-token `Authorization` header Logfire's ingest expects
+ *
+ * @param config - Logfire-specific configuration options
+ * @returns AutotelConfig ready to pass to init()
+ */
+declare function createLogfireConfig(config: LogfirePresetConfig): AutotelConfig;
+//#endregion
+export { LogfirePresetConfig, LogfireRegion, createLogfireConfig };

package/dist/logfire.js

@@ -0,0 +1,42 @@
+//#region src/logfire.ts
+/**
+* Region ingest endpoints.
+*
+* Verified against the live API: the shared `logfire-api.pydantic.dev` host
+* returns 401 for ingest. Logfire's own SDK resolves the region host from the
+* token client-side rather than relying on server-side routing, so the region
+* has to be named — which is why it is required below rather than defaulted.
+* Guessing it wrong produces a bare 401 that names neither cause.
+*/
+const REGION_ENDPOINTS = {
+	us: "https://logfire-us.pydantic.dev",
+	eu: "https://logfire-eu.pydantic.dev"
+};
+/**
+* Create an autotel configuration for Pydantic Logfire.
+*
+* This preset handles:
+* - OTLP/HTTP **protobuf** — Logfire accepts neither gRPC nor a JSON body, and
+*   an SDK defaulting to either fails silently
+* - The regional ingest endpoint
+* - The bare-token `Authorization` header Logfire's ingest expects
+*
+* @param config - Logfire-specific configuration options
+* @returns AutotelConfig ready to pass to init()
+*/
+function createLogfireConfig(config) {
+	const { writeToken, service, region, environment, version } = config;
+	if (!writeToken) throw new Error("Logfire write token is required. Create one under Project Settings → Write Tokens.");
+	const regionEndpoint = REGION_ENDPOINTS[region];
+	if (!regionEndpoint) throw new Error(`Unknown Logfire region "${region}". Supported regions: ${Object.keys(REGION_ENDPOINTS).join(", ")}.`);
+	return {
+		service,
+		environment,
+		version,
+		protocol: "http/protobuf",
+		endpoint: config.endpoint ?? regionEndpoint,
+		headers: { Authorization: writeToken }
+	};
+}
+//#endregion
+export { createLogfireConfig };

package/dist/posthog.cjs

@@ -0,0 +1,42 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/posthog.ts
+/** PostHog Cloud regions and their ingest hosts. */
+const REGION_HOSTS = {
+	us: "https://us.i.posthog.com",
+	eu: "https://eu.i.posthog.com"
+};
+/**
+* PostHog serves OTLP under `/i`, not at the host root. autotel appends
+* `/v1/<signal>`, so stopping the endpoint at `/i` yields `/i/v1/traces`,
+* `/i/v1/logs` and `/i/v1/metrics` — the three documented paths.
+*/
+const OTLP_PATH_PREFIX = "/i";
+/**
+* Create an autotel configuration for PostHog.
+*
+* This preset handles:
+* - OTLP/HTTP **protobuf** — PostHog's own docs steer away from the JSON
+*   exporter, and a JSON body is dropped rather than rejected
+* - The `/i` path prefix its OTLP receiver lives under
+* - Bearer auth with the project token
+*
+* @param config - PostHog-specific configuration options
+* @returns AutotelConfig ready to pass to init()
+*/
+function createPostHogConfig(config) {
+	const { projectToken, service, region = "us", environment, version } = config;
+	if (!projectToken) throw new Error("PostHog project token is required. Find it under Project Settings.");
+	const regionHost = REGION_HOSTS[region];
+	if (!regionHost) throw new Error(`Unknown PostHog region "${region}". Supported regions: ${Object.keys(REGION_HOSTS).join(", ")}.`);
+	const root = (config.host ?? regionHost).replace(/\/+$/, "");
+	return {
+		service,
+		environment,
+		version,
+		protocol: "http/protobuf",
+		endpoint: root.endsWith(OTLP_PATH_PREFIX) ? root : `${root}${OTLP_PATH_PREFIX}`,
+		headers: { Authorization: `Bearer ${projectToken}` }
+	};
+}
+//#endregion
+exports.createPostHogConfig = createPostHogConfig;

package/dist/posthog.d.cts

@@ -0,0 +1,63 @@
+import { AutotelConfig } from "autotel";
+//#region src/posthog.d.ts
+/** PostHog Cloud regions and their ingest hosts. */
+declare const REGION_HOSTS: {
+  readonly us: "https://us.i.posthog.com";
+  readonly eu: "https://eu.i.posthog.com";
+};
+type PostHogRegion = keyof typeof REGION_HOSTS;
+/**
+ * Configuration options for the PostHog preset
+ */
+interface PostHogPresetConfig {
+  /**
+   * PostHog project API key, `phc_...` (required).
+   * Found under Project Settings.
+   */
+  projectToken: string;
+  /**
+   * Service name (required).
+   * Appears as service.name on every span.
+   */
+  service: string;
+  /**
+   * PostHog Cloud region.
+   *
+   * @default 'us'
+   */
+  region?: PostHogRegion;
+  /**
+   * Deployment environment (e.g., 'production', 'staging', 'development').
+   *
+   * @default process.env.NODE_ENV || 'development'
+   */
+  environment?: string;
+  /**
+   * Service version for deployment tracking.
+   *
+   * @default process.env.VERSION || auto-detected from package.json
+   */
+  version?: string;
+  /**
+   * Host of a self-hosted PostHog instance, without the OTLP path.
+   * Takes precedence over `region`.
+   *
+   * @default the host for the selected region
+   */
+  host?: string;
+}
+/**
+ * Create an autotel configuration for PostHog.
+ *
+ * This preset handles:
+ * - OTLP/HTTP **protobuf** — PostHog's own docs steer away from the JSON
+ *   exporter, and a JSON body is dropped rather than rejected
+ * - The `/i` path prefix its OTLP receiver lives under
+ * - Bearer auth with the project token
+ *
+ * @param config - PostHog-specific configuration options
+ * @returns AutotelConfig ready to pass to init()
+ */
+declare function createPostHogConfig(config: PostHogPresetConfig): AutotelConfig;
+//#endregion
+export { PostHogPresetConfig, PostHogRegion, createPostHogConfig };

package/dist/posthog.d.ts

@@ -0,0 +1,63 @@
+import { AutotelConfig } from "autotel";
+//#region src/posthog.d.ts
+/** PostHog Cloud regions and their ingest hosts. */
+declare const REGION_HOSTS: {
+  readonly us: "https://us.i.posthog.com";
+  readonly eu: "https://eu.i.posthog.com";
+};
+type PostHogRegion = keyof typeof REGION_HOSTS;
+/**
+ * Configuration options for the PostHog preset
+ */
+interface PostHogPresetConfig {
+  /**
+   * PostHog project API key, `phc_...` (required).
+   * Found under Project Settings.
+   */
+  projectToken: string;
+  /**
+   * Service name (required).
+   * Appears as service.name on every span.
+   */
+  service: string;
+  /**
+   * PostHog Cloud region.
+   *
+   * @default 'us'
+   */
+  region?: PostHogRegion;
+  /**
+   * Deployment environment (e.g., 'production', 'staging', 'development').
+   *
+   * @default process.env.NODE_ENV || 'development'
+   */
+  environment?: string;
+  /**
+   * Service version for deployment tracking.
+   *
+   * @default process.env.VERSION || auto-detected from package.json
+   */
+  version?: string;
+  /**
+   * Host of a self-hosted PostHog instance, without the OTLP path.
+   * Takes precedence over `region`.
+   *
+   * @default the host for the selected region
+   */
+  host?: string;
+}
+/**
+ * Create an autotel configuration for PostHog.
+ *
+ * This preset handles:
+ * - OTLP/HTTP **protobuf** — PostHog's own docs steer away from the JSON
+ *   exporter, and a JSON body is dropped rather than rejected
+ * - The `/i` path prefix its OTLP receiver lives under
+ * - Bearer auth with the project token
+ *
+ * @param config - PostHog-specific configuration options
+ * @returns AutotelConfig ready to pass to init()
+ */
+declare function createPostHogConfig(config: PostHogPresetConfig): AutotelConfig;
+//#endregion
+export { PostHogPresetConfig, PostHogRegion, createPostHogConfig };

package/dist/posthog.js

@@ -0,0 +1,41 @@
+//#region src/posthog.ts
+/** PostHog Cloud regions and their ingest hosts. */
+const REGION_HOSTS = {
+	us: "https://us.i.posthog.com",
+	eu: "https://eu.i.posthog.com"
+};
+/**
+* PostHog serves OTLP under `/i`, not at the host root. autotel appends
+* `/v1/<signal>`, so stopping the endpoint at `/i` yields `/i/v1/traces`,
+* `/i/v1/logs` and `/i/v1/metrics` — the three documented paths.
+*/
+const OTLP_PATH_PREFIX = "/i";
+/**
+* Create an autotel configuration for PostHog.
+*
+* This preset handles:
+* - OTLP/HTTP **protobuf** — PostHog's own docs steer away from the JSON
+*   exporter, and a JSON body is dropped rather than rejected
+* - The `/i` path prefix its OTLP receiver lives under
+* - Bearer auth with the project token
+*
+* @param config - PostHog-specific configuration options
+* @returns AutotelConfig ready to pass to init()
+*/
+function createPostHogConfig(config) {
+	const { projectToken, service, region = "us", environment, version } = config;
+	if (!projectToken) throw new Error("PostHog project token is required. Find it under Project Settings.");
+	const regionHost = REGION_HOSTS[region];
+	if (!regionHost) throw new Error(`Unknown PostHog region "${region}". Supported regions: ${Object.keys(REGION_HOSTS).join(", ")}.`);
+	const root = (config.host ?? regionHost).replace(/\/+$/, "");
+	return {
+		service,
+		environment,
+		version,
+		protocol: "http/protobuf",
+		endpoint: root.endsWith(OTLP_PATH_PREFIX) ? root : `${root}${OTLP_PATH_PREFIX}`,
+		headers: { Authorization: `Bearer ${projectToken}` }
+	};
+}
+//#endregion
+export { createPostHogConfig };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autotel-backends",
-  "version": "2.12.43",
+  "version": "2.13.1",
   "description": "Vendor backend configurations for Autotel (Honeycomb, Datadog, etc.)",
   "type": "module",
   "main": "./dist/index.js",
@@ -31,6 +31,21 @@
       "types": "./dist/grafana.d.ts",
       "import": "./dist/grafana.js",
       "require": "./dist/grafana.cjs"
+    },
+    "./logfire": {
+      "types": "./dist/logfire.d.ts",
+      "import": "./dist/logfire.js",
+      "require": "./dist/logfire.cjs"
+    },
+    "./langfuse": {
+      "types": "./dist/langfuse.d.ts",
+      "import": "./dist/langfuse.js",
+      "require": "./dist/langfuse.cjs"
+    },
+    "./posthog": {
+      "types": "./dist/posthog.d.ts",
+      "import": "./dist/posthog.js",
+      "require": "./dist/posthog.cjs"
     }
   },
   "files": [
@@ -55,15 +70,15 @@
   "author": "Jag Reehal <jag@jagreehal.com> (https://jagreehal.com)",
   "license": "Apache-2.0",
   "dependencies": {
-    "@opentelemetry/exporter-logs-otlp-http": ">=0.220.0",
-    "@opentelemetry/sdk-logs": ">=0.220.0",
-    "autotel": "6.1.0"
+    "@opentelemetry/exporter-logs-otlp-http": ">=0.221.0",
+    "@opentelemetry/sdk-logs": ">=0.221.0",
+    "autotel": "6.2.1"
   },
   "peerDependencies": {
-    "@opentelemetry/exporter-metrics-otlp-http": ">=0.220.0",
-    "@opentelemetry/exporter-trace-otlp-http": ">=0.220.0",
-    "@opentelemetry/sdk-metrics": ">=2.9.0",
-    "google-auth-library": ">=10.9.0"
+    "@opentelemetry/exporter-metrics-otlp-http": ">=0.221.0",
+    "@opentelemetry/exporter-trace-otlp-http": ">=0.221.0",
+    "@opentelemetry/sdk-metrics": ">=2.10.0",
+    "google-auth-library": ">=10.9.1"
   },
   "peerDependenciesMeta": {
     "@opentelemetry/exporter-metrics-otlp-http": {
@@ -80,12 +95,12 @@
     }
   },
   "devDependencies": {
-    "@types/node": "^26.1.1",
+    "@types/node": "^26.1.2",
     "@typescript-eslint/eslint-plugin": "^8.65.0",
     "@typescript-eslint/parser": "^8.65.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-unicorn": "^64.0.0",
-    "tsdown": "^0.22.12",
+    "tsdown": "^0.22.14",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10"
   },

package/dist/datadog.cjs.map

@@ -1 +0,0 @@
-{"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            exporter: 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,wBAAwB,EAC1B,UAAU,IAAI,gBAAgB;IAC5B,KAAK,GAAG,aAAa;IACrB,SAAS,EACP,cAAc,OAChB;GACF,CAAC,EACH,CAAC,CACH;EACF,QAAQ;GACN,MAAM,IAAI,MACR,gIAEF;EACF;CAEJ;CAEA,OAAO;AACT"}

package/dist/datadog.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"datadog.d.cts","names":[],"sources":["../src/datadog.ts"],"mappings":";;;;;;KA0CY;;;;UAWK;;;;;;;;EAQf;;;;;;;EAQA,OAAO;;;;;EAMP;;;;;;;EAQA;;;;;;;EAQA;;;;;;;;;;;;;;;;;;;;;;EAuBA;;;;;;;;;;;;;;EAeA;;;;;;EAOA;;;;;;EAOA;;;;;EAMA,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8CR,oBACd,QAAQ,sBACP"}

package/dist/datadog.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"datadog.d.ts","names":[],"sources":["../src/datadog.ts"],"mappings":";;;;;;KA0CY;;;;UAWK;;;;;;;;EAQf;;;;;;;EAQA,OAAO;;;;;EAMP;;;;;;;EAQA;;;;;;;EAQA;;;;;;;;;;;;;;;;;;;;;;EAuBA;;;;;;;;;;;;;;EAeA;;;;;;EAOA;;;;;;EAOA;;;;;EAMA,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8CR,oBACd,QAAQ,sBACP"}

package/dist/datadog.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"datadog.js","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            exporter: 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,aAAa,cACjB,OAAO,eAAe,WAAW,aAAa,OAAO,KAAK,GAC5D;GACA,MAAM,EAAE,4BAA4B,WAClC,yBACF;GACA,MAAM,EAAE,oBAAoB,WAC1B,wCACF;GAEA,YAAY,sBAAsB,CAChC,IAAI,wBAAwB,EAC1B,UAAU,IAAI,gBAAgB;IAC5B,KAAK,GAAG,aAAa;IACrB,SAAS,EACP,cAAc,OAChB;GACF,CAAC,EACH,CAAC,CACH;EACF,QAAQ;GACN,MAAM,IAAI,MACR,gIAEF;EACF;CAEJ;CAEA,OAAO;AACT"}

package/dist/google-cloud.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"google-cloud.cjs","names":[],"sources":["../src/google-cloud.ts"],"sourcesContent":["/**\n * Google Cloud preset for autotel\n *\n * Sends traces (and optionally metrics) to Google Cloud Observability via the\n * Telemetry (OTLP) API. Uses Application Default Credentials (ADC) for auth.\n *\n * @example Direct export to GCP (with google-auth-library)\n * ```typescript\n * import { init } from 'autotel';\n * import { createGoogleCloudConfig } from 'autotel-backends/google-cloud';\n *\n * init(createGoogleCloudConfig({\n *   projectId: process.env.GOOGLE_CLOUD_PROJECT!,\n *   service: 'my-app',\n * }));\n * ```\n *\n * @example Via OpenTelemetry Collector (no auth in app)\n * ```typescript\n * init(createGoogleCloudConfig({\n *   projectId: process.env.GOOGLE_CLOUD_PROJECT!,\n *   service: 'my-app',\n *   useCollector: true,\n *   collectorEndpoint: 'http://localhost:4318',\n * }));\n * ```\n */\n\nimport { createRequire } from 'node:module';\nimport type { AutotelConfig } from 'autotel';\n\n/** Minimal SpanExporter-compatible interface (avoids @opentelemetry/sdk-trace-base peer at build time). */\ninterface SpanExporterLike {\n  export(\n    spans: unknown[],\n    resultCallback: (result: { code: number; error?: Error }) => void,\n  ): void | Promise<void>;\n  forceFlush?(): Promise<void>;\n  shutdown?(): Promise<void>;\n}\n\n/** Default Telemetry API base URL (OTLP). */\nconst DEFAULT_ENDPOINT = 'https://telemetry.googleapis.com';\n\n/**\n * Configuration options for Google Cloud preset\n */\nexport interface GoogleCloudPresetConfig {\n  /**\n   * Google Cloud project ID (required for direct export).\n   * Used for quota and resource attribution. Set GOOGLE_CLOUD_PROJECT or\n   * GOOGLE_APPLICATION_CREDENTIALS for ADC.\n   *\n   * @default process.env.GOOGLE_CLOUD_PROJECT\n   */\n  projectId: string;\n\n  /**\n   * Service name (required).\n   * Appears as service.name in Cloud Trace and Monitoring.\n   */\n  service: string;\n\n  /**\n   * Deployment environment (e.g., 'production', 'staging').\n   *\n   * @default process.env.NODE_ENV || 'development'\n   */\n  environment?: string;\n\n  /**\n   * Service version for deployment tracking.\n   *\n   * @default process.env.GCP_VERSION || process.env.VERSION\n   */\n  version?: string;\n\n  /**\n   * Use an OpenTelemetry Collector instead of exporting directly to GCP.\n   * When true, the app sends OTLP to collectorEndpoint; the Collector\n   * handles authentication to the Telemetry API. No google-auth-library needed.\n   *\n   * @default false\n   */\n  useCollector?: boolean;\n\n  /**\n   * Collector OTLP endpoint (when useCollector is true).\n   *\n   * @default 'http://localhost:4318'\n   */\n  collectorEndpoint?: string;\n\n  /**\n   * Telemetry API base URL (when useCollector is false).\n   * Only override for testing or special endpoints.\n   *\n   * @default 'https://telemetry.googleapis.com'\n   */\n  endpoint?: string;\n}\n\n/**\n * Create an autotel configuration for Google Cloud Observability (Telemetry API).\n *\n * - With useCollector: false (default), exports directly to the Telemetry API\n *   using Application Default Credentials. Requires optional peer dependency\n *   google-auth-library for auth. Install: pnpm add google-auth-library\n *\n * - With useCollector: true, sends OTLP to a local Collector; the Collector\n *   forwards to GCP with ADC. No google-auth-library needed in the app.\n *\n * @param config - Google Cloud preset options\n * @returns AutotelConfig ready to pass to init()\n */\nexport function createGoogleCloudConfig(\n  config: GoogleCloudPresetConfig,\n): AutotelConfig {\n  const {\n    projectId,\n    service,\n    environment,\n    version,\n    useCollector = false,\n    collectorEndpoint = 'http://localhost:4318',\n    endpoint = DEFAULT_ENDPOINT,\n  } = config;\n\n  if (!projectId) {\n    throw new Error(\n      'Google Cloud projectId is required. Set it or use process.env.GOOGLE_CLOUD_PROJECT.',\n    );\n  }\n\n  const baseConfig: AutotelConfig = {\n    service,\n    environment,\n    version,\n  };\n\n  if (useCollector) {\n    return {\n      ...baseConfig,\n      endpoint: collectorEndpoint,\n      // x-goog-user-project for quota when Collector forwards to GCP\n      headers: { 'x-goog-user-project': projectId },\n    };\n  }\n\n  // Direct export: need ADC via google-auth-library\n  try {\n    const userRequire = createRequire(process.cwd() + '/package.json');\n    const { GoogleAuth } = userRequire('google-auth-library');\n    const { OTLPTraceExporter } = userRequire(\n      '@opentelemetry/exporter-trace-otlp-http',\n    );\n\n    const tracesUrl = `${endpoint}/v1/traces`;\n    const auth = new GoogleAuth({\n      scopes: ['https://www.googleapis.com/auth/cloud-platform'],\n    });\n\n    const gcpTraceExporter = createGcpAuthTraceExporter(\n      tracesUrl,\n      projectId,\n      auth,\n      OTLPTraceExporter,\n    );\n\n    return {\n      ...baseConfig,\n      // Structurally compatible with SpanExporter from @opentelemetry/sdk-trace-base\n      spanExporters: [\n        gcpTraceExporter as NonNullable<AutotelConfig['spanExporters']>[number],\n      ],\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    if (\n      message.includes('google-auth-library') ||\n      message.includes('Cannot find module')\n    ) {\n      throw new Error(\n        'Direct export to Google Cloud requires google-auth-library. ' +\n          'Install it: pnpm add google-auth-library. ' +\n          'Or use useCollector: true and run an OpenTelemetry Collector with GCP auth.',\n        { cause: error },\n      );\n    }\n    throw error;\n  }\n}\n\n/** Minimal auth client: getClient() returns a client with getAccessToken(). */\ninterface GoogleAuthLike {\n  getClient(): Promise<{ getAccessToken(): Promise<{ token: string | null }> }>;\n}\n\ntype OTLPTraceExporterCtor = new (config: {\n  url: string;\n  headers?: Record<string, string>;\n}) => SpanExporterLike;\n\nfunction createGcpAuthTraceExporter(\n  url: string,\n  projectId: string,\n  auth: GoogleAuthLike,\n  OTLPTraceExporterCtor: OTLPTraceExporterCtor,\n): SpanExporterLike {\n  return new GcpAuthSpanExporter(url, projectId, auth, OTLPTraceExporterCtor);\n}\n\nclass GcpAuthSpanExporter implements SpanExporterLike {\n  constructor(\n    private readonly url: string,\n    private readonly projectId: string,\n    private readonly auth: GoogleAuthLike,\n    private readonly OTLPTraceExporterCtor: OTLPTraceExporterCtor,\n  ) {}\n\n  async export(\n    spans: unknown[],\n    resultCallback: (result: { code: number; error?: Error }) => void,\n  ): Promise<void> {\n    try {\n      const client = await this.auth.getClient();\n      const tokenResponse = await client.getAccessToken();\n      const token = tokenResponse.token;\n      if (!token) {\n        resultCallback({\n          code: 1,\n          error: new Error('No access token from ADC'),\n        });\n        return;\n      }\n      const exporter = new this.OTLPTraceExporterCtor({\n        url: this.url,\n        headers: {\n          Authorization: `Bearer ${token}`,\n          'x-goog-user-project': this.projectId,\n        },\n      });\n      exporter.export(spans, resultCallback);\n    } catch (error) {\n      resultCallback({\n        code: 1,\n        error: error instanceof Error ? error : new Error(String(error)),\n      });\n    }\n  }\n\n  forceFlush(): Promise<void> {\n    return Promise.resolve();\n  }\n\n  shutdown(): Promise<void> {\n    return Promise.resolve();\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0CA,MAAM,mBAAmB;;;;;;;;;;;;;;AAyEzB,SAAgB,wBACd,QACe;CACf,MAAM,EACJ,WACA,SACA,aACA,SACA,eAAe,OACf,oBAAoB,yBACpB,WAAW,qBACT;CAEJ,IAAI,CAAC,WACH,MAAM,IAAI,MACR,qFACF;CAGF,MAAM,aAA4B;EAChC;EACA;EACA;CACF;CAEA,IAAI,cACF,OAAO;EACL,GAAG;EACH,UAAU;EAEV,SAAS,EAAE,uBAAuB,UAAU;CAC9C;CAIF,IAAI;EACF,MAAM,eAAA,GAAA,YAAA,cAAA,CAA4B,QAAQ,IAAI,IAAI,eAAe;EACjE,MAAM,EAAE,eAAe,YAAY,qBAAqB;EACxD,MAAM,EAAE,sBAAsB,YAC5B,yCACF;EAOA,MAAM,mBAAmB,2BACvB,GANmB,SAAS,aAO5B,WACA,IAPe,WAAW,EAC1B,QAAQ,CAAC,gDAAgD,EAC3D,CAKK,GACH,iBACF;EAEA,OAAO;GACL,GAAG;GAEH,eAAe,CACb,gBACF;EACF;CACF,SAAS,OAAO;EACd,MAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;EACrE,IACE,QAAQ,SAAS,qBAAqB,KACtC,QAAQ,SAAS,oBAAoB,GAErC,MAAM,IAAI,MACR,qLAGA,EAAE,OAAO,MAAM,CACjB;EAEF,MAAM;CACR;AACF;AAYA,SAAS,2BACP,KACA,WACA,MACA,uBACkB;CAClB,OAAO,IAAI,oBAAoB,KAAK,WAAW,MAAM,qBAAqB;AAC5E;AAEA,IAAM,sBAAN,MAAsD;CAEjC;CACA;CACA;CACA;CAJnB,YACE,KACA,WACA,MACA,uBACA;EAJiB,KAAA,MAAA;EACA,KAAA,YAAA;EACA,KAAA,OAAA;EACA,KAAA,wBAAA;CAChB;CAEH,MAAM,OACJ,OACA,gBACe;EACf,IAAI;GAGF,MAAM,SAAQ,OADc,MADP,KAAK,KAAK,UAAU,EAAA,CACN,eAAe,EAAA,CACtB;GAC5B,IAAI,CAAC,OAAO;IACV,eAAe;KACb,MAAM;KACN,uBAAO,IAAI,MAAM,0BAA0B;IAC7C,CAAC;IACD;GACF;GAQA,IAPqB,KAAK,sBAAsB;IAC9C,KAAK,KAAK;IACV,SAAS;KACP,eAAe,UAAU;KACzB,uBAAuB,KAAK;IAC9B;GACF,CACO,CAAC,CAAC,OAAO,OAAO,cAAc;EACvC,SAAS,OAAO;GACd,eAAe;IACb,MAAM;IACN,OAAO,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;GACjE,CAAC;EACH;CACF;CAEA,aAA4B;EAC1B,OAAO,QAAQ,QAAQ;CACzB;CAEA,WAA0B;EACxB,OAAO,QAAQ,QAAQ;CACzB;AACF"}

package/dist/google-cloud.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"google-cloud.d.cts","names":[],"sources":["../src/google-cloud.ts"],"mappings":";;;;;UA+CiB;;;;;;;;EAQf;;;;;EAMA;;;;;;EAOA;;;;;;EAOA;;;;;;;;EASA;;;;;;EAOA;;;;;;;EAQA;;;;;;;;;;;;;;;iBAgBc,wBACd,QAAQ,0BACP"}

package/dist/google-cloud.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"google-cloud.d.ts","names":[],"sources":["../src/google-cloud.ts"],"mappings":";;;;;UA+CiB;;;;;;;;EAQf;;;;;EAMA;;;;;;EAOA;;;;;;EAOA;;;;;;;;EASA;;;;;;EAOA;;;;;;;EAQA;;;;;;;;;;;;;;;iBAgBc,wBACd,QAAQ,0BACP"}

package/dist/google-cloud.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"google-cloud.js","names":[],"sources":["../src/google-cloud.ts"],"sourcesContent":["/**\n * Google Cloud preset for autotel\n *\n * Sends traces (and optionally metrics) to Google Cloud Observability via the\n * Telemetry (OTLP) API. Uses Application Default Credentials (ADC) for auth.\n *\n * @example Direct export to GCP (with google-auth-library)\n * ```typescript\n * import { init } from 'autotel';\n * import { createGoogleCloudConfig } from 'autotel-backends/google-cloud';\n *\n * init(createGoogleCloudConfig({\n *   projectId: process.env.GOOGLE_CLOUD_PROJECT!,\n *   service: 'my-app',\n * }));\n * ```\n *\n * @example Via OpenTelemetry Collector (no auth in app)\n * ```typescript\n * init(createGoogleCloudConfig({\n *   projectId: process.env.GOOGLE_CLOUD_PROJECT!,\n *   service: 'my-app',\n *   useCollector: true,\n *   collectorEndpoint: 'http://localhost:4318',\n * }));\n * ```\n */\n\nimport { createRequire } from 'node:module';\nimport type { AutotelConfig } from 'autotel';\n\n/** Minimal SpanExporter-compatible interface (avoids @opentelemetry/sdk-trace-base peer at build time). */\ninterface SpanExporterLike {\n  export(\n    spans: unknown[],\n    resultCallback: (result: { code: number; error?: Error }) => void,\n  ): void | Promise<void>;\n  forceFlush?(): Promise<void>;\n  shutdown?(): Promise<void>;\n}\n\n/** Default Telemetry API base URL (OTLP). */\nconst DEFAULT_ENDPOINT = 'https://telemetry.googleapis.com';\n\n/**\n * Configuration options for Google Cloud preset\n */\nexport interface GoogleCloudPresetConfig {\n  /**\n   * Google Cloud project ID (required for direct export).\n   * Used for quota and resource attribution. Set GOOGLE_CLOUD_PROJECT or\n   * GOOGLE_APPLICATION_CREDENTIALS for ADC.\n   *\n   * @default process.env.GOOGLE_CLOUD_PROJECT\n   */\n  projectId: string;\n\n  /**\n   * Service name (required).\n   * Appears as service.name in Cloud Trace and Monitoring.\n   */\n  service: string;\n\n  /**\n   * Deployment environment (e.g., 'production', 'staging').\n   *\n   * @default process.env.NODE_ENV || 'development'\n   */\n  environment?: string;\n\n  /**\n   * Service version for deployment tracking.\n   *\n   * @default process.env.GCP_VERSION || process.env.VERSION\n   */\n  version?: string;\n\n  /**\n   * Use an OpenTelemetry Collector instead of exporting directly to GCP.\n   * When true, the app sends OTLP to collectorEndpoint; the Collector\n   * handles authentication to the Telemetry API. No google-auth-library needed.\n   *\n   * @default false\n   */\n  useCollector?: boolean;\n\n  /**\n   * Collector OTLP endpoint (when useCollector is true).\n   *\n   * @default 'http://localhost:4318'\n   */\n  collectorEndpoint?: string;\n\n  /**\n   * Telemetry API base URL (when useCollector is false).\n   * Only override for testing or special endpoints.\n   *\n   * @default 'https://telemetry.googleapis.com'\n   */\n  endpoint?: string;\n}\n\n/**\n * Create an autotel configuration for Google Cloud Observability (Telemetry API).\n *\n * - With useCollector: false (default), exports directly to the Telemetry API\n *   using Application Default Credentials. Requires optional peer dependency\n *   google-auth-library for auth. Install: pnpm add google-auth-library\n *\n * - With useCollector: true, sends OTLP to a local Collector; the Collector\n *   forwards to GCP with ADC. No google-auth-library needed in the app.\n *\n * @param config - Google Cloud preset options\n * @returns AutotelConfig ready to pass to init()\n */\nexport function createGoogleCloudConfig(\n  config: GoogleCloudPresetConfig,\n): AutotelConfig {\n  const {\n    projectId,\n    service,\n    environment,\n    version,\n    useCollector = false,\n    collectorEndpoint = 'http://localhost:4318',\n    endpoint = DEFAULT_ENDPOINT,\n  } = config;\n\n  if (!projectId) {\n    throw new Error(\n      'Google Cloud projectId is required. Set it or use process.env.GOOGLE_CLOUD_PROJECT.',\n    );\n  }\n\n  const baseConfig: AutotelConfig = {\n    service,\n    environment,\n    version,\n  };\n\n  if (useCollector) {\n    return {\n      ...baseConfig,\n      endpoint: collectorEndpoint,\n      // x-goog-user-project for quota when Collector forwards to GCP\n      headers: { 'x-goog-user-project': projectId },\n    };\n  }\n\n  // Direct export: need ADC via google-auth-library\n  try {\n    const userRequire = createRequire(process.cwd() + '/package.json');\n    const { GoogleAuth } = userRequire('google-auth-library');\n    const { OTLPTraceExporter } = userRequire(\n      '@opentelemetry/exporter-trace-otlp-http',\n    );\n\n    const tracesUrl = `${endpoint}/v1/traces`;\n    const auth = new GoogleAuth({\n      scopes: ['https://www.googleapis.com/auth/cloud-platform'],\n    });\n\n    const gcpTraceExporter = createGcpAuthTraceExporter(\n      tracesUrl,\n      projectId,\n      auth,\n      OTLPTraceExporter,\n    );\n\n    return {\n      ...baseConfig,\n      // Structurally compatible with SpanExporter from @opentelemetry/sdk-trace-base\n      spanExporters: [\n        gcpTraceExporter as NonNullable<AutotelConfig['spanExporters']>[number],\n      ],\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    if (\n      message.includes('google-auth-library') ||\n      message.includes('Cannot find module')\n    ) {\n      throw new Error(\n        'Direct export to Google Cloud requires google-auth-library. ' +\n          'Install it: pnpm add google-auth-library. ' +\n          'Or use useCollector: true and run an OpenTelemetry Collector with GCP auth.',\n        { cause: error },\n      );\n    }\n    throw error;\n  }\n}\n\n/** Minimal auth client: getClient() returns a client with getAccessToken(). */\ninterface GoogleAuthLike {\n  getClient(): Promise<{ getAccessToken(): Promise<{ token: string | null }> }>;\n}\n\ntype OTLPTraceExporterCtor = new (config: {\n  url: string;\n  headers?: Record<string, string>;\n}) => SpanExporterLike;\n\nfunction createGcpAuthTraceExporter(\n  url: string,\n  projectId: string,\n  auth: GoogleAuthLike,\n  OTLPTraceExporterCtor: OTLPTraceExporterCtor,\n): SpanExporterLike {\n  return new GcpAuthSpanExporter(url, projectId, auth, OTLPTraceExporterCtor);\n}\n\nclass GcpAuthSpanExporter implements SpanExporterLike {\n  constructor(\n    private readonly url: string,\n    private readonly projectId: string,\n    private readonly auth: GoogleAuthLike,\n    private readonly OTLPTraceExporterCtor: OTLPTraceExporterCtor,\n  ) {}\n\n  async export(\n    spans: unknown[],\n    resultCallback: (result: { code: number; error?: Error }) => void,\n  ): Promise<void> {\n    try {\n      const client = await this.auth.getClient();\n      const tokenResponse = await client.getAccessToken();\n      const token = tokenResponse.token;\n      if (!token) {\n        resultCallback({\n          code: 1,\n          error: new Error('No access token from ADC'),\n        });\n        return;\n      }\n      const exporter = new this.OTLPTraceExporterCtor({\n        url: this.url,\n        headers: {\n          Authorization: `Bearer ${token}`,\n          'x-goog-user-project': this.projectId,\n        },\n      });\n      exporter.export(spans, resultCallback);\n    } catch (error) {\n      resultCallback({\n        code: 1,\n        error: error instanceof Error ? error : new Error(String(error)),\n      });\n    }\n  }\n\n  forceFlush(): Promise<void> {\n    return Promise.resolve();\n  }\n\n  shutdown(): Promise<void> {\n    return Promise.resolve();\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0CA,MAAM,mBAAmB;;;;;;;;;;;;;;AAyEzB,SAAgB,wBACd,QACe;CACf,MAAM,EACJ,WACA,SACA,aACA,SACA,eAAe,OACf,oBAAoB,yBACpB,WAAW,qBACT;CAEJ,IAAI,CAAC,WACH,MAAM,IAAI,MACR,qFACF;CAGF,MAAM,aAA4B;EAChC;EACA;EACA;CACF;CAEA,IAAI,cACF,OAAO;EACL,GAAG;EACH,UAAU;EAEV,SAAS,EAAE,uBAAuB,UAAU;CAC9C;CAIF,IAAI;EACF,MAAM,cAAc,cAAc,QAAQ,IAAI,IAAI,eAAe;EACjE,MAAM,EAAE,eAAe,YAAY,qBAAqB;EACxD,MAAM,EAAE,sBAAsB,YAC5B,yCACF;EAOA,MAAM,mBAAmB,2BACvB,GANmB,SAAS,aAO5B,WACA,IAPe,WAAW,EAC1B,QAAQ,CAAC,gDAAgD,EAC3D,CAKK,GACH,iBACF;EAEA,OAAO;GACL,GAAG;GAEH,eAAe,CACb,gBACF;EACF;CACF,SAAS,OAAO;EACd,MAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;EACrE,IACE,QAAQ,SAAS,qBAAqB,KACtC,QAAQ,SAAS,oBAAoB,GAErC,MAAM,IAAI,MACR,qLAGA,EAAE,OAAO,MAAM,CACjB;EAEF,MAAM;CACR;AACF;AAYA,SAAS,2BACP,KACA,WACA,MACA,uBACkB;CAClB,OAAO,IAAI,oBAAoB,KAAK,WAAW,MAAM,qBAAqB;AAC5E;AAEA,IAAM,sBAAN,MAAsD;CAEjC;CACA;CACA;CACA;CAJnB,YACE,KACA,WACA,MACA,uBACA;EAJiB,KAAA,MAAA;EACA,KAAA,YAAA;EACA,KAAA,OAAA;EACA,KAAA,wBAAA;CAChB;CAEH,MAAM,OACJ,OACA,gBACe;EACf,IAAI;GAGF,MAAM,SAAQ,OADc,MADP,KAAK,KAAK,UAAU,EAAA,CACN,eAAe,EAAA,CACtB;GAC5B,IAAI,CAAC,OAAO;IACV,eAAe;KACb,MAAM;KACN,uBAAO,IAAI,MAAM,0BAA0B;IAC7C,CAAC;IACD;GACF;GAQA,IAPqB,KAAK,sBAAsB;IAC9C,KAAK,KAAK;IACV,SAAS;KACP,eAAe,UAAU;KACzB,uBAAuB,KAAK;IAC9B;GACF,CACO,CAAC,CAAC,OAAO,OAAO,cAAc;EACvC,SAAS,OAAO;GACd,eAAe;IACb,MAAM;IACN,OAAO,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;GACjE,CAAC;EACH;CACF;CAEA,aAA4B;EAC1B,OAAO,QAAQ,QAAQ;CACzB;CAEA,WAA0B;EACxB,OAAO,QAAQ,QAAQ;CACzB;AACF"}

package/dist/grafana.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"grafana.cjs","names":[],"sources":["../src/grafana.ts"],"sourcesContent":["/**\n * Grafana Cloud preset for autotel\n *\n * Provides a simplified configuration helper for sending traces, metrics,\n * and logs to Grafana Cloud via the OTLP gateway.\n *\n * Get your endpoint and headers from:\n * Grafana Cloud Portal → your stack → Connections → OpenTelemetry → Configure\n *\n * @example\n * ```typescript\n * import { init } from 'autotel';\n * import { createGrafanaConfig } from 'autotel-backends/grafana';\n *\n * init(createGrafanaConfig({\n *   endpoint: process.env.OTEL_EXPORTER_OTLP_ENDPOINT!,\n *   headers: process.env.OTEL_EXPORTER_OTLP_HEADERS,\n *   service: 'my-app',\n *   enableLogs: true,\n * }));\n * ```\n */\n\nimport { createRequire } from 'node:module';\nimport type { AutotelConfig } from 'autotel';\nimport type { LogRecordProcessor } from '@opentelemetry/sdk-logs';\n\n// See packages/autotel/src/node-require.ts for why the __filename fallback\n// is necessary alongside import.meta.url.\ndeclare const __filename: string | undefined;\n\n/**\n * Configuration options for Grafana Cloud preset\n */\nexport interface GrafanaPresetConfig {\n  /**\n   * OTLP gateway endpoint (required).\n   * From Grafana Cloud: Stack → Connections → OpenTelemetry → Configure.\n   * Example: https://otlp-gateway-prod-gb-south-1.grafana.net/otlp\n   */\n  endpoint: string;\n\n  /**\n   * OTLP authentication headers.\n   * From the same Configure tile; usually Basic auth.\n   * Example: \"Authorization=Basic%20BASE64_INSTANCE_ID_AND_TOKEN\"\n   * or object: { Authorization: 'Basic ...' }\n   */\n  headers?: string | Record<string, string>;\n\n  /**\n   * Service name (required).\n   * Appears in Tempo, Mimir, and Loki as service_name.\n   */\n  service: string;\n\n  /**\n   * Deployment environment (e.g. 'production', 'staging').\n   *\n   * @default process.env.NODE_ENV || 'development'\n   */\n  environment?: string;\n\n  /**\n   * Service version for deployment tracking.\n   *\n   * @default process.env.OTEL_SERVICE_VERSION\n   */\n  version?: string;\n\n  /**\n   * Enable log export to Grafana Cloud (Loki) via OTLP.\n   * When true, configures logRecordProcessors so OTel Logs API records are exported.\n   *\n   * @default true\n   */\n  enableLogs?: boolean;\n\n  /**\n   * Custom log record processors (advanced).\n   * Overrides the default OTLP log processor when enableLogs is true.\n   */\n  logRecordProcessors?: LogRecordProcessor[];\n}\n\nfunction normalizeHeaders(\n  headers: string | Record<string, string> | undefined,\n): Record<string, string> | undefined {\n  if (!headers) return undefined;\n  if (typeof headers === 'object') return headers;\n  const out: Record<string, string> = {};\n  for (const pair of headers.split(',')) {\n    const [key, ...valueParts] = pair.split('=');\n    if (key && valueParts.length > 0) {\n      let value = valueParts.join('=').trim();\n      value = value.replaceAll('%20', ' ');\n      out[key.trim()] = value;\n    }\n  }\n  return Object.keys(out).length > 0 ? out : undefined;\n}\n\n/**\n * Create an autotel configuration for Grafana Cloud OTLP.\n *\n * Sends traces (Tempo), metrics (Mimir), and optionally logs (Loki) to the\n * Grafana Cloud OTLP gateway. Endpoint and headers come from the stack's\n * Connections → OpenTelemetry → Configure tile.\n *\n * @param config - Grafana Cloud configuration options\n * @returns AutotelConfig ready to pass to init()\n */\nexport function createGrafanaConfig(\n  config: GrafanaPresetConfig,\n): AutotelConfig {\n  const {\n    endpoint,\n    headers: headersInput,\n    service,\n    environment,\n    version,\n    enableLogs = true,\n    logRecordProcessors,\n  } = config;\n\n  if (!endpoint) {\n    throw new Error(\n      'Grafana Cloud endpoint is required. Get it from: Grafana Cloud → your stack → Connections → OpenTelemetry → Configure',\n    );\n  }\n\n  const headers = normalizeHeaders(headersInput);\n  const base = endpoint.replace(/\\/v1\\/(traces|metrics|logs)$/, '');\n  const logsUrl = `${base}${base.endsWith('/') ? '' : '/'}v1/logs`;\n\n  const result: AutotelConfig = {\n    service,\n    environment,\n    version,\n    endpoint,\n    headers,\n    metrics: true,\n  };\n\n  if (enableLogs) {\n    if (logRecordProcessors) {\n      result.logRecordProcessors = logRecordProcessors;\n    } else {\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        result.logRecordProcessors = [\n          new BatchLogRecordProcessor({\n            exporter: new OTLPLogExporter({\n              url: logsUrl,\n              headers,\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 result;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAqFA,SAAS,iBACP,SACoC;CACpC,IAAI,CAAC,SAAS,OAAO,KAAA;CACrB,IAAI,OAAO,YAAY,UAAU,OAAO;CACxC,MAAM,MAA8B,CAAC;CACrC,KAAK,MAAM,QAAQ,QAAQ,MAAM,GAAG,GAAG;EACrC,MAAM,CAAC,KAAK,GAAG,cAAc,KAAK,MAAM,GAAG;EAC3C,IAAI,OAAO,WAAW,SAAS,GAAG;GAChC,IAAI,QAAQ,WAAW,KAAK,GAAG,CAAC,CAAC,KAAK;GACtC,QAAQ,MAAM,WAAW,OAAO,GAAG;GACnC,IAAI,IAAI,KAAK,KAAK;EACpB;CACF;CACA,OAAO,OAAO,KAAK,GAAG,CAAC,CAAC,SAAS,IAAI,MAAM,KAAA;AAC7C;;;;;;;;;;;AAYA,SAAgB,oBACd,QACe;CACf,MAAM,EACJ,UACA,SAAS,cACT,SACA,aACA,SACA,aAAa,MACb,wBACE;CAEJ,IAAI,CAAC,UACH,MAAM,IAAI,MACR,uHACF;CAGF,MAAM,UAAU,iBAAiB,YAAY;CAC7C,MAAM,OAAO,SAAS,QAAQ,gCAAgC,EAAE;CAChE,MAAM,UAAU,GAAG,OAAO,KAAK,SAAS,GAAG,IAAI,KAAK,IAAI;CAExD,MAAM,SAAwB;EAC5B;EACA;EACA;EACA;EACA;EACA,SAAS;CACX;CAEA,IAAI,YACF,IAAI,qBACF,OAAO,sBAAsB;MAE7B,IAAI;EACF,MAAM,cAAA,GAAA,YAAA,cAAA,CACJ,OAAO,eAAe,WAAW,aAAA,QAAA,KAAA,CAAA,CAAA,cAAA,UAAA,CAAA,CAAA,IACnC;EACA,MAAM,EAAE,4BAA4B,WAClC,yBACF;EACA,MAAM,EAAE,oBAAoB,WAC1B,wCACF;EACA,OAAO,sBAAsB,CAC3B,IAAI,wBAAwB,EAC1B,UAAU,IAAI,gBAAgB;GAC5B,KAAK;GACL;EACF,CAAC,EACH,CAAC,CACH;CACF,QAAQ;EACN,MAAM,IAAI,MACR,gIAEF;CACF;CAIJ,OAAO;AACT"}

package/dist/grafana.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"grafana.d.cts","names":[],"sources":["../src/grafana.ts"],"mappings":";;;;;;UAkCiB;;;;;;EAMf;;;;;;;EAQA,mBAAmB;;;;;EAMnB;;;;;;EAOA;;;;;;EAOA;;;;;;;EAQA;;;;;EAMA,sBAAsB;;;;;;;;;;;;iBA8BR,oBACd,QAAQ,sBACP"}

package/dist/grafana.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"grafana.d.ts","names":[],"sources":["../src/grafana.ts"],"mappings":";;;;;;UAkCiB;;;;;;EAMf;;;;;;;EAQA,mBAAmB;;;;;EAMnB;;;;;;EAOA;;;;;;EAOA;;;;;;;EAQA;;;;;EAMA,sBAAsB;;;;;;;;;;;;iBA8BR,oBACd,QAAQ,sBACP"}

package/dist/grafana.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"grafana.js","names":[],"sources":["../src/grafana.ts"],"sourcesContent":["/**\n * Grafana Cloud preset for autotel\n *\n * Provides a simplified configuration helper for sending traces, metrics,\n * and logs to Grafana Cloud via the OTLP gateway.\n *\n * Get your endpoint and headers from:\n * Grafana Cloud Portal → your stack → Connections → OpenTelemetry → Configure\n *\n * @example\n * ```typescript\n * import { init } from 'autotel';\n * import { createGrafanaConfig } from 'autotel-backends/grafana';\n *\n * init(createGrafanaConfig({\n *   endpoint: process.env.OTEL_EXPORTER_OTLP_ENDPOINT!,\n *   headers: process.env.OTEL_EXPORTER_OTLP_HEADERS,\n *   service: 'my-app',\n *   enableLogs: true,\n * }));\n * ```\n */\n\nimport { createRequire } from 'node:module';\nimport type { AutotelConfig } from 'autotel';\nimport type { LogRecordProcessor } from '@opentelemetry/sdk-logs';\n\n// See packages/autotel/src/node-require.ts for why the __filename fallback\n// is necessary alongside import.meta.url.\ndeclare const __filename: string | undefined;\n\n/**\n * Configuration options for Grafana Cloud preset\n */\nexport interface GrafanaPresetConfig {\n  /**\n   * OTLP gateway endpoint (required).\n   * From Grafana Cloud: Stack → Connections → OpenTelemetry → Configure.\n   * Example: https://otlp-gateway-prod-gb-south-1.grafana.net/otlp\n   */\n  endpoint: string;\n\n  /**\n   * OTLP authentication headers.\n   * From the same Configure tile; usually Basic auth.\n   * Example: \"Authorization=Basic%20BASE64_INSTANCE_ID_AND_TOKEN\"\n   * or object: { Authorization: 'Basic ...' }\n   */\n  headers?: string | Record<string, string>;\n\n  /**\n   * Service name (required).\n   * Appears in Tempo, Mimir, and Loki as service_name.\n   */\n  service: string;\n\n  /**\n   * Deployment environment (e.g. 'production', 'staging').\n   *\n   * @default process.env.NODE_ENV || 'development'\n   */\n  environment?: string;\n\n  /**\n   * Service version for deployment tracking.\n   *\n   * @default process.env.OTEL_SERVICE_VERSION\n   */\n  version?: string;\n\n  /**\n   * Enable log export to Grafana Cloud (Loki) via OTLP.\n   * When true, configures logRecordProcessors so OTel Logs API records are exported.\n   *\n   * @default true\n   */\n  enableLogs?: boolean;\n\n  /**\n   * Custom log record processors (advanced).\n   * Overrides the default OTLP log processor when enableLogs is true.\n   */\n  logRecordProcessors?: LogRecordProcessor[];\n}\n\nfunction normalizeHeaders(\n  headers: string | Record<string, string> | undefined,\n): Record<string, string> | undefined {\n  if (!headers) return undefined;\n  if (typeof headers === 'object') return headers;\n  const out: Record<string, string> = {};\n  for (const pair of headers.split(',')) {\n    const [key, ...valueParts] = pair.split('=');\n    if (key && valueParts.length > 0) {\n      let value = valueParts.join('=').trim();\n      value = value.replaceAll('%20', ' ');\n      out[key.trim()] = value;\n    }\n  }\n  return Object.keys(out).length > 0 ? out : undefined;\n}\n\n/**\n * Create an autotel configuration for Grafana Cloud OTLP.\n *\n * Sends traces (Tempo), metrics (Mimir), and optionally logs (Loki) to the\n * Grafana Cloud OTLP gateway. Endpoint and headers come from the stack's\n * Connections → OpenTelemetry → Configure tile.\n *\n * @param config - Grafana Cloud configuration options\n * @returns AutotelConfig ready to pass to init()\n */\nexport function createGrafanaConfig(\n  config: GrafanaPresetConfig,\n): AutotelConfig {\n  const {\n    endpoint,\n    headers: headersInput,\n    service,\n    environment,\n    version,\n    enableLogs = true,\n    logRecordProcessors,\n  } = config;\n\n  if (!endpoint) {\n    throw new Error(\n      'Grafana Cloud endpoint is required. Get it from: Grafana Cloud → your stack → Connections → OpenTelemetry → Configure',\n    );\n  }\n\n  const headers = normalizeHeaders(headersInput);\n  const base = endpoint.replace(/\\/v1\\/(traces|metrics|logs)$/, '');\n  const logsUrl = `${base}${base.endsWith('/') ? '' : '/'}v1/logs`;\n\n  const result: AutotelConfig = {\n    service,\n    environment,\n    version,\n    endpoint,\n    headers,\n    metrics: true,\n  };\n\n  if (enableLogs) {\n    if (logRecordProcessors) {\n      result.logRecordProcessors = logRecordProcessors;\n    } else {\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        result.logRecordProcessors = [\n          new BatchLogRecordProcessor({\n            exporter: new OTLPLogExporter({\n              url: logsUrl,\n              headers,\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 result;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAqFA,SAAS,iBACP,SACoC;CACpC,IAAI,CAAC,SAAS,OAAO,KAAA;CACrB,IAAI,OAAO,YAAY,UAAU,OAAO;CACxC,MAAM,MAA8B,CAAC;CACrC,KAAK,MAAM,QAAQ,QAAQ,MAAM,GAAG,GAAG;EACrC,MAAM,CAAC,KAAK,GAAG,cAAc,KAAK,MAAM,GAAG;EAC3C,IAAI,OAAO,WAAW,SAAS,GAAG;GAChC,IAAI,QAAQ,WAAW,KAAK,GAAG,CAAC,CAAC,KAAK;GACtC,QAAQ,MAAM,WAAW,OAAO,GAAG;GACnC,IAAI,IAAI,KAAK,KAAK;EACpB;CACF;CACA,OAAO,OAAO,KAAK,GAAG,CAAC,CAAC,SAAS,IAAI,MAAM,KAAA;AAC7C;;;;;;;;;;;AAYA,SAAgB,oBACd,QACe;CACf,MAAM,EACJ,UACA,SAAS,cACT,SACA,aACA,SACA,aAAa,MACb,wBACE;CAEJ,IAAI,CAAC,UACH,MAAM,IAAI,MACR,uHACF;CAGF,MAAM,UAAU,iBAAiB,YAAY;CAC7C,MAAM,OAAO,SAAS,QAAQ,gCAAgC,EAAE;CAChE,MAAM,UAAU,GAAG,OAAO,KAAK,SAAS,GAAG,IAAI,KAAK,IAAI;CAExD,MAAM,SAAwB;EAC5B;EACA;EACA;EACA;EACA;EACA,SAAS;CACX;CAEA,IAAI,YACF,IAAI,qBACF,OAAO,sBAAsB;MAE7B,IAAI;EACF,MAAM,aAAa,cACjB,OAAO,eAAe,WAAW,aAAa,OAAO,KAAK,GAC5D;EACA,MAAM,EAAE,4BAA4B,WAClC,yBACF;EACA,MAAM,EAAE,oBAAoB,WAC1B,wCACF;EACA,OAAO,sBAAsB,CAC3B,IAAI,wBAAwB,EAC1B,UAAU,IAAI,gBAAgB;GAC5B,KAAK;GACL;EACF,CAAC,EACH,CAAC,CACH;CACF,QAAQ;EACN,MAAM,IAAI,MACR,gIAEF;CACF;CAIJ,OAAO;AACT"}

package/dist/honeycomb.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"honeycomb.cjs","names":[],"sources":["../src/honeycomb.ts"],"sourcesContent":["/**\n * Honeycomb preset for autotel\n *\n * Provides a simplified configuration helper for Honeycomb integration\n * with best practices built-in.\n *\n * @example Using Honeycomb with API key\n * ```typescript\n * import { init } from 'autotel';\n * import { createHoneycombConfig } from 'autotel-backends/honeycomb';\n *\n * init(createHoneycombConfig({\n *   apiKey: process.env.HONEYCOMB_API_KEY!,\n *   service: 'my-app',\n * }));\n * ```\n *\n * @example With custom dataset\n * ```typescript\n * import { init } from 'autotel';\n * import { createHoneycombConfig } from 'autotel-backends/honeycomb';\n *\n * init(createHoneycombConfig({\n *   apiKey: process.env.HONEYCOMB_API_KEY!,\n *   service: 'my-app',\n *   dataset: 'production',\n * }));\n * ```\n */\n\nimport type { AutotelConfig } from 'autotel';\n\n/**\n * Configuration options for Honeycomb preset\n */\nexport interface HoneycombPresetConfig {\n  /**\n   * Honeycomb API key (required).\n   *\n   * Get your API key from:\n   * https://ui.honeycomb.io/account\n   *\n   * For classic environments, use an environment-specific key.\n   * For newer environments, use a team-level API key.\n   */\n  apiKey: string;\n\n  /**\n   * Service name (required).\n   * Appears as service.name in Honeycomb traces and determines dataset routing.\n   */\n  service: string;\n\n  /**\n   * Dataset name (optional).\n   * For classic Honeycomb accounts that use datasets.\n   * Modern environments route based on service.name instead.\n   *\n   * @default service name\n   */\n  dataset?: string;\n\n  /**\n   * Deployment environment (e.g., 'production', 'staging', 'development').\n   * Used for environment filtering in Honeycomb.\n   *\n   * @default process.env.NODE_ENV || 'development'\n   */\n  environment?: string;\n\n  /**\n   * Service version for deployment tracking.\n   *\n   * @default process.env.VERSION || auto-detected from package.json\n   */\n  version?: string;\n\n  /**\n   * Honeycomb API endpoint.\n   * Use this to configure for different regions or on-premises installations.\n   *\n   * @default 'api.honeycomb.io:443'\n   */\n  endpoint?: string;\n\n  /**\n   * Sample rate for traces (1 = 100%, 10 = 10%, 100 = 1%).\n   * Honeycomb's head-based sampling rate.\n   *\n   * Note: Autotel uses tail-based sampling by default.\n   * This setting applies additional head-based sampling if specified.\n   *\n   * @default undefined (no head-based sampling, relies on tail sampling)\n   */\n  sampleRate?: number;\n}\n\n/**\n * Create an autotel configuration optimized for Honeycomb.\n *\n * This preset handles:\n * - gRPC protocol configuration (Honeycomb's preferred protocol)\n * - Proper endpoint and authentication headers\n * - Dataset routing (for classic accounts)\n * - Unified service tagging (service, env, version)\n *\n * Honeycomb uses gRPC by default for better performance and lower overhead.\n * This preset automatically configures the gRPC protocol.\n *\n * @param config - Honeycomb-specific configuration options\n * @returns AutotelConfig ready to pass to init()\n *\n * @example Simple configuration\n * ```typescript\n * init(createHoneycombConfig({\n *   apiKey: process.env.HONEYCOMB_API_KEY!,\n *   service: 'my-app',\n * }));\n * ```\n *\n * @example With custom dataset and environment\n * ```typescript\n * init(createHoneycombConfig({\n *   apiKey: process.env.HONEYCOMB_API_KEY!,\n *   service: 'my-app',\n *   dataset: 'production',\n *   environment: 'production',\n *   version: '2.1.0',\n * }));\n * ```\n *\n * @example With sample rate\n * ```typescript\n * init(createHoneycombConfig({\n *   apiKey: process.env.HONEYCOMB_API_KEY!,\n *   service: 'my-app',\n *   sampleRate: 10, // Sample 10% of traces (head-based sampling)\n * }));\n * ```\n */\nexport function createHoneycombConfig(\n  config: HoneycombPresetConfig,\n): AutotelConfig {\n  const {\n    apiKey,\n    service,\n    dataset,\n    environment,\n    version,\n    endpoint = 'api.honeycomb.io:443',\n    sampleRate,\n  } = config;\n\n  // Validation: API key is required\n  if (!apiKey) {\n    throw new Error(\n      'Honeycomb API key is required. Get your API key from: https://ui.honeycomb.io/account',\n    );\n  }\n\n  // Build headers\n  const headers: Record<string, string> = {\n    'x-honeycomb-team': apiKey,\n  };\n\n  // Add dataset header if specified (for classic Honeycomb accounts)\n  if (dataset) {\n    headers['x-honeycomb-dataset'] = dataset;\n  }\n\n  // Add sample rate header if specified\n  if (sampleRate !== undefined) {\n    headers['x-honeycomb-samplerate'] = String(sampleRate);\n  }\n\n  return {\n    service,\n    environment,\n    version,\n    protocol: 'grpc', // Honeycomb uses gRPC for better performance\n    endpoint,\n    headers,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4IA,SAAgB,sBACd,QACe;CACf,MAAM,EACJ,QACA,SACA,SACA,aACA,SACA,WAAW,wBACX,eACE;CAGJ,IAAI,CAAC,QACH,MAAM,IAAI,MACR,uFACF;CAIF,MAAM,UAAkC,EACtC,oBAAoB,OACtB;CAGA,IAAI,SACF,QAAQ,yBAAyB;CAInC,IAAI,eAAe,KAAA,GACjB,QAAQ,4BAA4B,OAAO,UAAU;CAGvD,OAAO;EACL;EACA;EACA;EACA,UAAU;EACV;EACA;CACF;AACF"}

package/dist/honeycomb.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"honeycomb.d.cts","names":[],"sources":["../src/honeycomb.ts"],"mappings":";;;;;UAmCiB;;;;;;;;;;EAUf;;;;;EAMA;;;;;;;;EASA;;;;;;;EAQA;;;;;;EAOA;;;;;;;EAQA;;;;;;;;;;EAWA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8Cc,sBACd,QAAQ,wBACP"}

package/dist/honeycomb.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"honeycomb.d.ts","names":[],"sources":["../src/honeycomb.ts"],"mappings":";;;;;UAmCiB;;;;;;;;;;EAUf;;;;;EAMA;;;;;;;;EASA;;;;;;;EAQA;;;;;;EAOA;;;;;;;EAQA;;;;;;;;;;EAWA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8Cc,sBACd,QAAQ,wBACP"}

package/dist/honeycomb.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"honeycomb.js","names":[],"sources":["../src/honeycomb.ts"],"sourcesContent":["/**\n * Honeycomb preset for autotel\n *\n * Provides a simplified configuration helper for Honeycomb integration\n * with best practices built-in.\n *\n * @example Using Honeycomb with API key\n * ```typescript\n * import { init } from 'autotel';\n * import { createHoneycombConfig } from 'autotel-backends/honeycomb';\n *\n * init(createHoneycombConfig({\n *   apiKey: process.env.HONEYCOMB_API_KEY!,\n *   service: 'my-app',\n * }));\n * ```\n *\n * @example With custom dataset\n * ```typescript\n * import { init } from 'autotel';\n * import { createHoneycombConfig } from 'autotel-backends/honeycomb';\n *\n * init(createHoneycombConfig({\n *   apiKey: process.env.HONEYCOMB_API_KEY!,\n *   service: 'my-app',\n *   dataset: 'production',\n * }));\n * ```\n */\n\nimport type { AutotelConfig } from 'autotel';\n\n/**\n * Configuration options for Honeycomb preset\n */\nexport interface HoneycombPresetConfig {\n  /**\n   * Honeycomb API key (required).\n   *\n   * Get your API key from:\n   * https://ui.honeycomb.io/account\n   *\n   * For classic environments, use an environment-specific key.\n   * For newer environments, use a team-level API key.\n   */\n  apiKey: string;\n\n  /**\n   * Service name (required).\n   * Appears as service.name in Honeycomb traces and determines dataset routing.\n   */\n  service: string;\n\n  /**\n   * Dataset name (optional).\n   * For classic Honeycomb accounts that use datasets.\n   * Modern environments route based on service.name instead.\n   *\n   * @default service name\n   */\n  dataset?: string;\n\n  /**\n   * Deployment environment (e.g., 'production', 'staging', 'development').\n   * Used for environment filtering in Honeycomb.\n   *\n   * @default process.env.NODE_ENV || 'development'\n   */\n  environment?: string;\n\n  /**\n   * Service version for deployment tracking.\n   *\n   * @default process.env.VERSION || auto-detected from package.json\n   */\n  version?: string;\n\n  /**\n   * Honeycomb API endpoint.\n   * Use this to configure for different regions or on-premises installations.\n   *\n   * @default 'api.honeycomb.io:443'\n   */\n  endpoint?: string;\n\n  /**\n   * Sample rate for traces (1 = 100%, 10 = 10%, 100 = 1%).\n   * Honeycomb's head-based sampling rate.\n   *\n   * Note: Autotel uses tail-based sampling by default.\n   * This setting applies additional head-based sampling if specified.\n   *\n   * @default undefined (no head-based sampling, relies on tail sampling)\n   */\n  sampleRate?: number;\n}\n\n/**\n * Create an autotel configuration optimized for Honeycomb.\n *\n * This preset handles:\n * - gRPC protocol configuration (Honeycomb's preferred protocol)\n * - Proper endpoint and authentication headers\n * - Dataset routing (for classic accounts)\n * - Unified service tagging (service, env, version)\n *\n * Honeycomb uses gRPC by default for better performance and lower overhead.\n * This preset automatically configures the gRPC protocol.\n *\n * @param config - Honeycomb-specific configuration options\n * @returns AutotelConfig ready to pass to init()\n *\n * @example Simple configuration\n * ```typescript\n * init(createHoneycombConfig({\n *   apiKey: process.env.HONEYCOMB_API_KEY!,\n *   service: 'my-app',\n * }));\n * ```\n *\n * @example With custom dataset and environment\n * ```typescript\n * init(createHoneycombConfig({\n *   apiKey: process.env.HONEYCOMB_API_KEY!,\n *   service: 'my-app',\n *   dataset: 'production',\n *   environment: 'production',\n *   version: '2.1.0',\n * }));\n * ```\n *\n * @example With sample rate\n * ```typescript\n * init(createHoneycombConfig({\n *   apiKey: process.env.HONEYCOMB_API_KEY!,\n *   service: 'my-app',\n *   sampleRate: 10, // Sample 10% of traces (head-based sampling)\n * }));\n * ```\n */\nexport function createHoneycombConfig(\n  config: HoneycombPresetConfig,\n): AutotelConfig {\n  const {\n    apiKey,\n    service,\n    dataset,\n    environment,\n    version,\n    endpoint = 'api.honeycomb.io:443',\n    sampleRate,\n  } = config;\n\n  // Validation: API key is required\n  if (!apiKey) {\n    throw new Error(\n      'Honeycomb API key is required. Get your API key from: https://ui.honeycomb.io/account',\n    );\n  }\n\n  // Build headers\n  const headers: Record<string, string> = {\n    'x-honeycomb-team': apiKey,\n  };\n\n  // Add dataset header if specified (for classic Honeycomb accounts)\n  if (dataset) {\n    headers['x-honeycomb-dataset'] = dataset;\n  }\n\n  // Add sample rate header if specified\n  if (sampleRate !== undefined) {\n    headers['x-honeycomb-samplerate'] = String(sampleRate);\n  }\n\n  return {\n    service,\n    environment,\n    version,\n    protocol: 'grpc', // Honeycomb uses gRPC for better performance\n    endpoint,\n    headers,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4IA,SAAgB,sBACd,QACe;CACf,MAAM,EACJ,QACA,SACA,SACA,aACA,SACA,WAAW,wBACX,eACE;CAGJ,IAAI,CAAC,QACH,MAAM,IAAI,MACR,uFACF;CAIF,MAAM,UAAkC,EACtC,oBAAoB,OACtB;CAGA,IAAI,SACF,QAAQ,yBAAyB;CAInC,IAAI,eAAe,KAAA,GACjB,QAAQ,4BAA4B,OAAO,UAAU;CAGvD,OAAO;EACL;EACA;EACA;EACA,UAAU;EACV;EACA;CACF;AACF"}