autotel-backends 2.8.3 → 2.9.0

package/dist/google-cloud.d.ts

@@ -0,0 +1,97 @@
+import { AutotelConfig } from 'autotel';
+
+/**
+ * Google Cloud preset for autotel
+ *
+ * Sends traces (and optionally metrics) to Google Cloud Observability via the
+ * Telemetry (OTLP) API. Uses Application Default Credentials (ADC) for auth.
+ *
+ * @example Direct export to GCP (with google-auth-library)
+ * ```typescript
+ * import { init } from 'autotel';
+ * import { createGoogleCloudConfig } from 'autotel-backends/google-cloud';
+ *
+ * init(createGoogleCloudConfig({
+ *   projectId: process.env.GOOGLE_CLOUD_PROJECT!,
+ *   service: 'my-app',
+ * }));
+ * ```
+ *
+ * @example Via OpenTelemetry Collector (no auth in app)
+ * ```typescript
+ * init(createGoogleCloudConfig({
+ *   projectId: process.env.GOOGLE_CLOUD_PROJECT!,
+ *   service: 'my-app',
+ *   useCollector: true,
+ *   collectorEndpoint: 'http://localhost:4318',
+ * }));
+ * ```
+ */
+
+/**
+ * Configuration options for Google Cloud preset
+ */
+interface GoogleCloudPresetConfig {
+    /**
+     * Google Cloud project ID (required for direct export).
+     * Used for quota and resource attribution. Set GOOGLE_CLOUD_PROJECT or
+     * GOOGLE_APPLICATION_CREDENTIALS for ADC.
+     *
+     * @default process.env.GOOGLE_CLOUD_PROJECT
+     */
+    projectId: string;
+    /**
+     * Service name (required).
+     * Appears as service.name in Cloud Trace and Monitoring.
+     */
+    service: string;
+    /**
+     * Deployment environment (e.g., 'production', 'staging').
+     *
+     * @default process.env.NODE_ENV || 'development'
+     */
+    environment?: string;
+    /**
+     * Service version for deployment tracking.
+     *
+     * @default process.env.GCP_VERSION || process.env.VERSION
+     */
+    version?: string;
+    /**
+     * Use an OpenTelemetry Collector instead of exporting directly to GCP.
+     * When true, the app sends OTLP to collectorEndpoint; the Collector
+     * handles authentication to the Telemetry API. No google-auth-library needed.
+     *
+     * @default false
+     */
+    useCollector?: boolean;
+    /**
+     * Collector OTLP endpoint (when useCollector is true).
+     *
+     * @default 'http://localhost:4318'
+     */
+    collectorEndpoint?: string;
+    /**
+     * Telemetry API base URL (when useCollector is false).
+     * Only override for testing or special endpoints.
+     *
+     * @default 'https://telemetry.googleapis.com'
+     */
+    endpoint?: string;
+}
+/**
+ * Create an autotel configuration for Google Cloud Observability (Telemetry API).
+ *
+ * - With useCollector: false (default), exports directly to the Telemetry API
+ *   using Application Default Credentials. Requires optional peer dependency
+ *   google-auth-library for auth. Install: pnpm add google-auth-library
+ *
+ * - With useCollector: true, sends OTLP to a local Collector; the Collector
+ *   forwards to GCP with ADC. No google-auth-library needed in the app.
+ *
+ * @param config - Google Cloud preset options
+ * @returns AutotelConfig ready to pass to init()
+ */
+declare function createGoogleCloudConfig(config: GoogleCloudPresetConfig): AutotelConfig;
+
+export { type GoogleCloudPresetConfig, createGoogleCloudConfig };

package/dist/google-cloud.js

@@ -0,0 +1,114 @@
+import { createRequire } from 'module';
+
+// src/google-cloud.ts
+var DEFAULT_ENDPOINT = "https://telemetry.googleapis.com";
+function createGoogleCloudConfig(config) {
+  const {
+    projectId,
+    service,
+    environment,
+    version,
+    useCollector = false,
+    collectorEndpoint = "http://localhost:4318",
+    endpoint = DEFAULT_ENDPOINT
+  } = config;
+  if (!projectId) {
+    throw new Error(
+      "Google Cloud projectId is required. Set it or use process.env.GOOGLE_CLOUD_PROJECT."
+    );
+  }
+  const baseConfig = {
+    service,
+    environment,
+    version
+  };
+  if (useCollector) {
+    return {
+      ...baseConfig,
+      endpoint: collectorEndpoint,
+      // x-goog-user-project for quota when Collector forwards to GCP
+      headers: { "x-goog-user-project": projectId }
+    };
+  }
+  try {
+    const userRequire = createRequire(process.cwd() + "/package.json");
+    const { GoogleAuth } = userRequire("google-auth-library");
+    const { OTLPTraceExporter } = userRequire(
+      "@opentelemetry/exporter-trace-otlp-http"
+    );
+    const tracesUrl = `${endpoint}/v1/traces`;
+    const auth = new GoogleAuth({
+      scopes: ["https://www.googleapis.com/auth/cloud-platform"]
+    });
+    const gcpTraceExporter = createGcpAuthTraceExporter(
+      tracesUrl,
+      projectId,
+      auth,
+      OTLPTraceExporter
+    );
+    return {
+      ...baseConfig,
+      // Structurally compatible with SpanExporter from @opentelemetry/sdk-trace-base
+      spanExporters: [
+        gcpTraceExporter
+      ]
+    };
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    if (message.includes("google-auth-library") || message.includes("Cannot find module")) {
+      throw new Error(
+        "Direct export to Google Cloud requires google-auth-library. Install it: pnpm add google-auth-library. Or use useCollector: true and run an OpenTelemetry Collector with GCP auth.",
+        { cause: error }
+      );
+    }
+    throw error;
+  }
+}
+function createGcpAuthTraceExporter(url, projectId, auth, OTLPTraceExporterCtor) {
+  return new GcpAuthSpanExporter(url, projectId, auth, OTLPTraceExporterCtor);
+}
+var GcpAuthSpanExporter = class {
+  constructor(url, projectId, auth, OTLPTraceExporterCtor) {
+    this.url = url;
+    this.projectId = projectId;
+    this.auth = auth;
+    this.OTLPTraceExporterCtor = OTLPTraceExporterCtor;
+  }
+  async export(spans, resultCallback) {
+    try {
+      const client = await this.auth.getClient();
+      const tokenResponse = await client.getAccessToken();
+      const token = tokenResponse.token;
+      if (!token) {
+        resultCallback({
+          code: 1,
+          error: new Error("No access token from ADC")
+        });
+        return;
+      }
+      const exporter = new this.OTLPTraceExporterCtor({
+        url: this.url,
+        headers: {
+          Authorization: `Bearer ${token}`,
+          "x-goog-user-project": this.projectId
+        }
+      });
+      exporter.export(spans, resultCallback);
+    } catch (error) {
+      resultCallback({
+        code: 1,
+        error: error instanceof Error ? error : new Error(String(error))
+      });
+    }
+  }
+  forceFlush() {
+    return Promise.resolve();
+  }
+  shutdown() {
+    return Promise.resolve();
+  }
+};
+
+export { createGoogleCloudConfig };
+//# sourceMappingURL=google-cloud.js.map
+//# sourceMappingURL=google-cloud.js.map

package/dist/google-cloud.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/google-cloud.ts"],"names":[],"mappings":"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","file":"google-cloud.js","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"]}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export { HoneycombPresetConfig, createHoneycombConfig } from './honeycomb.js';
 export { DatadogPresetConfig, DatadogSite, createDatadogConfig } from './datadog.js';
+export { GoogleCloudPresetConfig, createGoogleCloudConfig } from './google-cloud.js';
 import 'autotel';
 import '@opentelemetry/sdk-logs';

package/dist/index.js

@@ -140,7 +140,114 @@ function createDatadogConfig(config) {
   }
   return cloudConfig;
 }
+var DEFAULT_ENDPOINT = "https://telemetry.googleapis.com";
+function createGoogleCloudConfig(config) {
+  const {
+    projectId,
+    service,
+    environment,
+    version,
+    useCollector = false,
+    collectorEndpoint = "http://localhost:4318",
+    endpoint = DEFAULT_ENDPOINT
+  } = config;
+  if (!projectId) {
+    throw new Error(
+      "Google Cloud projectId is required. Set it or use process.env.GOOGLE_CLOUD_PROJECT."
+    );
+  }
+  const baseConfig = {
+    service,
+    environment,
+    version
+  };
+  if (useCollector) {
+    return {
+      ...baseConfig,
+      endpoint: collectorEndpoint,
+      // x-goog-user-project for quota when Collector forwards to GCP
+      headers: { "x-goog-user-project": projectId }
+    };
+  }
+  try {
+    const userRequire = createRequire(process.cwd() + "/package.json");
+    const { GoogleAuth } = userRequire("google-auth-library");
+    const { OTLPTraceExporter } = userRequire(
+      "@opentelemetry/exporter-trace-otlp-http"
+    );
+    const tracesUrl = `${endpoint}/v1/traces`;
+    const auth = new GoogleAuth({
+      scopes: ["https://www.googleapis.com/auth/cloud-platform"]
+    });
+    const gcpTraceExporter = createGcpAuthTraceExporter(
+      tracesUrl,
+      projectId,
+      auth,
+      OTLPTraceExporter
+    );
+    return {
+      ...baseConfig,
+      // Structurally compatible with SpanExporter from @opentelemetry/sdk-trace-base
+      spanExporters: [
+        gcpTraceExporter
+      ]
+    };
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    if (message.includes("google-auth-library") || message.includes("Cannot find module")) {
+      throw new Error(
+        "Direct export to Google Cloud requires google-auth-library. Install it: pnpm add google-auth-library. Or use useCollector: true and run an OpenTelemetry Collector with GCP auth.",
+        { cause: error }
+      );
+    }
+    throw error;
+  }
+}
+function createGcpAuthTraceExporter(url, projectId, auth, OTLPTraceExporterCtor) {
+  return new GcpAuthSpanExporter(url, projectId, auth, OTLPTraceExporterCtor);
+}
+var GcpAuthSpanExporter = class {
+  constructor(url, projectId, auth, OTLPTraceExporterCtor) {
+    this.url = url;
+    this.projectId = projectId;
+    this.auth = auth;
+    this.OTLPTraceExporterCtor = OTLPTraceExporterCtor;
+  }
+  async export(spans, resultCallback) {
+    try {
+      const client = await this.auth.getClient();
+      const tokenResponse = await client.getAccessToken();
+      const token = tokenResponse.token;
+      if (!token) {
+        resultCallback({
+          code: 1,
+          error: new Error("No access token from ADC")
+        });
+        return;
+      }
+      const exporter = new this.OTLPTraceExporterCtor({
+        url: this.url,
+        headers: {
+          Authorization: `Bearer ${token}`,
+          "x-goog-user-project": this.projectId
+        }
+      });
+      exporter.export(spans, resultCallback);
+    } catch (error) {
+      resultCallback({
+        code: 1,
+        error: error instanceof Error ? error : new Error(String(error))
+      });
+    }
+  }
+  forceFlush() {
+    return Promise.resolve();
+  }
+  shutdown() {
+    return Promise.resolve();
+  }
+};
 
-export { createDatadogConfig, createHoneycombConfig };
+export { createDatadogConfig, createGoogleCloudConfig, createHoneycombConfig };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/honeycomb.ts","../src/datadog.ts"],"names":[],"mappings":"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","file":"index.js","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","/**\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/**\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   * Requires peer dependencies: @opentelemetry/sdk-logs, @opentelemetry/exporter-logs-otlp-http\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        // Lazy-load to preserve optional peer dependencies\n        // Use createRequire to resolve from user's project directory\n        const userRequire = createRequire(process.cwd() + '/package.json');\n\n        const { BatchLogRecordProcessor } = userRequire(\n          '@opentelemetry/sdk-logs',\n        );\n        const { OTLPLogExporter } = userRequire(\n          '@opentelemetry/exporter-logs-otlp-http',\n        );\n\n        cloudConfig.logRecordProcessors = [\n          new BatchLogRecordProcessor(\n            new OTLPLogExporter({\n              // Logs use /v1/logs path (SDK appends this to endpoint)\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 peer dependencies: @opentelemetry/sdk-logs and @opentelemetry/exporter-logs-otlp-http. ' +\n            'Install them with: npm install @opentelemetry/sdk-logs @opentelemetry/exporter-logs-otlp-http',\n        );\n      }\n    }\n  }\n\n  return cloudConfig;\n}\n"]}
+{"version":3,"sources":["../src/honeycomb.ts","../src/datadog.ts","../src/google-cloud.ts"],"names":["createRequire"],"mappings":";;;AA4IO,SAAS,sBACd,MAAA,EACe;AACf,EAAA,MAAM;AAAA,IACJ,MAAA;AAAA,IACA,OAAA;AAAA,IACA,OAAA;AAAA,IACA,WAAA;AAAA,IACA,OAAA;AAAA,IACA,QAAA,GAAW,sBAAA;AAAA,IACX;AAAA,GACF,GAAI,MAAA;AAGJ,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KACF;AAAA,EACF;AAGA,EAAA,MAAM,OAAA,GAAkC;AAAA,IACtC,kBAAA,EAAoB;AAAA,GACtB;AAGA,EAAA,IAAI,OAAA,EAAS;AACX,IAAA,OAAA,CAAQ,qBAAqB,CAAA,GAAI,OAAA;AAAA,EACnC;AAGA,EAAA,IAAI,eAAe,MAAA,EAAW;AAC5B,IAAA,OAAA,CAAQ,wBAAwB,CAAA,GAAI,MAAA,CAAO,UAAU,CAAA;AAAA,EACvD;AAEA,EAAA,OAAO;AAAA,IACL,OAAA;AAAA,IACA,WAAA;AAAA,IACA,OAAA;AAAA,IACA,QAAA,EAAU,MAAA;AAAA;AAAA,IACV,QAAA;AAAA,IACA;AAAA,GACF;AACF;ACSO,SAAS,oBACd,MAAA,EACe;AACf,EAAA,MAAM;AAAA,IACJ,MAAA;AAAA,IACA,IAAA,GAAO,eAAA;AAAA,IACP,OAAA;AAAA,IACA,WAAA;AAAA,IACA,OAAA;AAAA,IACA,UAAA,GAAa,KAAA;AAAA,IACb,QAAA,GAAW,KAAA;AAAA,IACX,SAAA,GAAY,WAAA;AAAA,IACZ,SAAA,GAAY,IAAA;AAAA,IACZ;AAAA,GACF,GAAI,MAAA;AAGJ,EAAA,IAAI,CAAC,QAAA,IAAY,CAAC,MAAA,EAAQ;AACxB,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KAEF;AAAA,EACF;AAEA,EAAA,MAAM,UAAA,GAA4B;AAAA,IAChC,OAAA;AAAA,IACA,WAAA;AAAA,IACA;AAAA,GACF;AAGA,EAAA,IAAI,QAAA,EAAU;AACZ,IAAA,MAAM,aAAA,GAAgB,CAAA,OAAA,EAAU,SAAS,CAAA,CAAA,EAAI,SAAS,CAAA,CAAA;AAGtD,IAAA,IAAI,UAAA,EAAY;AACd,MAAA,MAAM,YAAA,GAAe,CAAA,OAAA,EAAU,SAAS,CAAA,CAAA,EAAI,SAAS,CAAA,QAAA,CAAA;AAErD,MAAA,IAAI,CAAC,OAAA,CAAQ,GAAA,CAAI,gCAAA,EAAkC;AACjD,QAAA,OAAA,CAAQ,IAAI,gCAAA,GAAmC,YAAA;AAAA,MACjD;AAEA,MAAA,IAAI,CAAC,OAAA,CAAQ,GAAA,CAAI,gCAAA,EAAkC;AACjD,QAAA,OAAA,CAAQ,IAAI,gCAAA,GAAmC,eAAA;AAAA,MACjD;AAIA,MAAA,MAAM,aAAA,GAAgB;AAAA,QACpB,gBAAgB,OAAO,CAAA,CAAA;AAAA,QACvB,WAAA,GAAc,CAAA,uBAAA,EAA0B,WAAW,CAAA,CAAA,GAAK,IAAA;AAAA,QACxD,OAAA,GAAU,CAAA,gBAAA,EAAmB,OAAO,CAAA,CAAA,GAAK;AAAA,OAC3C,CACG,MAAA,CAAO,OAAO,CAAA,CACd,KAAK,GAAG,CAAA;AAEX,MAAA,IAAI,CAAC,OAAA,CAAQ,GAAA,CAAI,wBAAA,EAA0B;AACzC,QAAA,OAAA,CAAQ,IAAI,wBAAA,GAA2B,aAAA;AAAA,MACzC;AAAA,IACF;AAEA,IAAA,OAAO;AAAA,MACL,GAAG,UAAA;AAAA,MACH,QAAA,EAAU;AAAA;AAAA,KAEZ;AAAA,EACF;AAIA,EAAA,MAAM,YAAA,GAAe,gBAAgB,IAAI,CAAA,CAAA;AACzC,EAAA,MAAM,WAAA,GAAc,cAAc,MAAM,CAAA,CAAA;AAExC,EAAA,MAAM,WAAA,GAA6B;AAAA,IACjC,GAAG,UAAA;AAAA,IACH,QAAA,EAAU,YAAA;AAAA,IACV,OAAA,EAAS;AAAA,GACX;AAGA,EAAA,IAAI,UAAA,EAAY;AAGd,IAAA,MAAM,YAAA,GAAe,WACjB,CAAA,OAAA,EAAU,SAAS,IAAI,SAAS,CAAA,QAAA,CAAA,GAChC,gBAAgB,IAAI,CAAA,QAAA,CAAA;AAGxB,IAAA,IAAI,CAAC,OAAA,CAAQ,GAAA,CAAI,gCAAA,EAAkC;AACjD,MAAA,OAAA,CAAQ,IAAI,gCAAA,GAAmC,YAAA;AAAA,IACjD;AAEA,IAAA,IAAI,CAAC,OAAA,CAAQ,GAAA,CAAI,gCAAA,EAAkC;AACjD,MAAA,OAAA,CAAQ,IAAI,gCAAA,GAAmC,eAAA;AAAA,IACjD;AAGA,IAAA,IAAI,CAAC,QAAA,IAAY,MAAA,IAAU,CAAC,OAAA,CAAQ,IAAI,+BAAA,EAAiC;AACvE,MAAA,OAAA,CAAQ,GAAA,CAAI,+BAAA,GAAkC,CAAA,WAAA,EAAc,MAAM,CAAA,CAAA;AAAA,IACpE;AAGA,IAAA,MAAM,aAAA,GAAgB;AAAA,MACpB,gBAAgB,OAAO,CAAA,CAAA;AAAA,MACvB,WAAA,GAAc,CAAA,uBAAA,EAA0B,WAAW,CAAA,CAAA,GAAK,IAAA;AAAA,MACxD,OAAA,GAAU,CAAA,gBAAA,EAAmB,OAAO,CAAA,CAAA,GAAK;AAAA,KAC3C,CACG,MAAA,CAAO,OAAO,CAAA,CACd,KAAK,GAAG,CAAA;AAEX,IAAA,IAAI,CAAC,OAAA,CAAQ,GAAA,CAAI,wBAAA,EAA0B;AACzC,MAAA,OAAA,CAAQ,IAAI,wBAAA,GAA2B,aAAA;AAAA,IACzC;AAEA,IAAA,IAAI,mBAAA,EAAqB;AAEvB,MAAA,WAAA,CAAY,mBAAA,GAAsB,mBAAA;AAAA,IACpC,CAAA,MAAO;AAEL,MAAA,IAAI;AAGF,QAAA,MAAM,WAAA,GAAc,aAAA,CAAc,OAAA,CAAQ,GAAA,KAAQ,eAAe,CAAA;AAEjE,QAAA,MAAM,EAAE,yBAAwB,GAAI,WAAA;AAAA,UAClC;AAAA,SACF;AACA,QAAA,MAAM,EAAE,iBAAgB,GAAI,WAAA;AAAA,UAC1B;AAAA,SACF;AAEA,QAAA,WAAA,CAAY,mBAAA,GAAsB;AAAA,UAChC,IAAI,uBAAA;AAAA,YACF,IAAI,eAAA,CAAgB;AAAA;AAAA,cAElB,GAAA,EAAK,GAAG,YAAY,CAAA,QAAA,CAAA;AAAA,cACpB,OAAA,EAAS;AAAA,gBACP,YAAA,EAAc;AAAA;AAChB,aACD;AAAA;AACH,SACF;AAAA,MACF,CAAA,CAAA,MAAQ;AACN,QAAA,MAAM,IAAI,KAAA;AAAA,UACR;AAAA,SAEF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,EAAA,OAAO,WAAA;AACT;AC9SA,IAAM,gBAAA,GAAmB,kCAAA;AAyElB,SAAS,wBACd,MAAA,EACe;AACf,EAAA,MAAM;AAAA,IACJ,SAAA;AAAA,IACA,OAAA;AAAA,IACA,WAAA;AAAA,IACA,OAAA;AAAA,IACA,YAAA,GAAe,KAAA;AAAA,IACf,iBAAA,GAAoB,uBAAA;AAAA,IACpB,QAAA,GAAW;AAAA,GACb,GAAI,MAAA;AAEJ,EAAA,IAAI,CAAC,SAAA,EAAW;AACd,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KACF;AAAA,EACF;AAEA,EAAA,MAAM,UAAA,GAA4B;AAAA,IAChC,OAAA;AAAA,IACA,WAAA;AAAA,IACA;AAAA,GACF;AAEA,EAAA,IAAI,YAAA,EAAc;AAChB,IAAA,OAAO;AAAA,MACL,GAAG,UAAA;AAAA,MACH,QAAA,EAAU,iBAAA;AAAA;AAAA,MAEV,OAAA,EAAS,EAAE,qBAAA,EAAuB,SAAA;AAAU,KAC9C;AAAA,EACF;AAGA,EAAA,IAAI;AACF,IAAA,MAAM,WAAA,GAAcA,aAAAA,CAAc,OAAA,CAAQ,GAAA,KAAQ,eAAe,CAAA;AACjE,IAAA,MAAM,EAAE,UAAA,EAAW,GAAI,WAAA,CAAY,qBAAqB,CAAA;AACxD,IAAA,MAAM,EAAE,mBAAkB,GAAI,WAAA;AAAA,MAC5B;AAAA,KACF;AAEA,IAAA,MAAM,SAAA,GAAY,GAAG,QAAQ,CAAA,UAAA,CAAA;AAC7B,IAAA,MAAM,IAAA,GAAO,IAAI,UAAA,CAAW;AAAA,MAC1B,MAAA,EAAQ,CAAC,gDAAgD;AAAA,KAC1D,CAAA;AAED,IAAA,MAAM,gBAAA,GAAmB,0BAAA;AAAA,MACvB,SAAA;AAAA,MACA,SAAA;AAAA,MACA,IAAA;AAAA,MACA;AAAA,KACF;AAEA,IAAA,OAAO;AAAA,MACL,GAAG,UAAA;AAAA;AAAA,MAEH,aAAA,EAAe;AAAA,QACb;AAAA;AACF,KACF;AAAA,EACF,SAAS,KAAA,EAAO;AACd,IAAA,MAAM,UAAU,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,OAAA,GAAU,OAAO,KAAK,CAAA;AACrE,IAAA,IACE,QAAQ,QAAA,CAAS,qBAAqB,KACtC,OAAA,CAAQ,QAAA,CAAS,oBAAoB,CAAA,EACrC;AACA,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,mLAAA;AAAA,QAGA,EAAE,OAAO,KAAA;AAAM,OACjB;AAAA,IACF;AACA,IAAA,MAAM,KAAA;AAAA,EACR;AACF;AAYA,SAAS,0BAAA,CACP,GAAA,EACA,SAAA,EACA,IAAA,EACA,qBAAA,EACkB;AAClB,EAAA,OAAO,IAAI,mBAAA,CAAoB,GAAA,EAAK,SAAA,EAAW,MAAM,qBAAqB,CAAA;AAC5E;AAEA,IAAM,sBAAN,MAAsD;AAAA,EACpD,WAAA,CACmB,GAAA,EACA,SAAA,EACA,IAAA,EACA,qBAAA,EACjB;AAJiB,IAAA,IAAA,CAAA,GAAA,GAAA,GAAA;AACA,IAAA,IAAA,CAAA,SAAA,GAAA,SAAA;AACA,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AACA,IAAA,IAAA,CAAA,qBAAA,GAAA,qBAAA;AAAA,EAChB;AAAA,EAEH,MAAM,MAAA,CACJ,KAAA,EACA,cAAA,EACe;AACf,IAAA,IAAI;AACF,MAAA,MAAM,MAAA,GAAS,MAAM,IAAA,CAAK,IAAA,CAAK,SAAA,EAAU;AACzC,MAAA,MAAM,aAAA,GAAgB,MAAM,MAAA,CAAO,cAAA,EAAe;AAClD,MAAA,MAAM,QAAQ,aAAA,CAAc,KAAA;AAC5B,MAAA,IAAI,CAAC,KAAA,EAAO;AACV,QAAA,cAAA,CAAe;AAAA,UACb,IAAA,EAAM,CAAA;AAAA,UACN,KAAA,EAAO,IAAI,KAAA,CAAM,0BAA0B;AAAA,SAC5C,CAAA;AACD,QAAA;AAAA,MACF;AACA,MAAA,MAAM,QAAA,GAAW,IAAI,IAAA,CAAK,qBAAA,CAAsB;AAAA,QAC9C,KAAK,IAAA,CAAK,GAAA;AAAA,QACV,OAAA,EAAS;AAAA,UACP,aAAA,EAAe,UAAU,KAAK,CAAA,CAAA;AAAA,UAC9B,uBAAuB,IAAA,CAAK;AAAA;AAC9B,OACD,CAAA;AACD,MAAA,QAAA,CAAS,MAAA,CAAO,OAAO,cAAc,CAAA;AAAA,IACvC,SAAS,KAAA,EAAO;AACd,MAAA,cAAA,CAAe;AAAA,QACb,IAAA,EAAM,CAAA;AAAA,QACN,KAAA,EAAO,iBAAiB,KAAA,GAAQ,KAAA,GAAQ,IAAI,KAAA,CAAM,MAAA,CAAO,KAAK,CAAC;AAAA,OAChE,CAAA;AAAA,IACH;AAAA,EACF;AAAA,EAEA,UAAA,GAA4B;AAC1B,IAAA,OAAO,QAAQ,OAAA,EAAQ;AAAA,EACzB;AAAA,EAEA,QAAA,GAA0B;AACxB,IAAA,OAAO,QAAQ,OAAA,EAAQ;AAAA,EACzB;AACF,CAAA","file":"index.js","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","/**\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/**\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   * Requires peer dependencies: @opentelemetry/sdk-logs, @opentelemetry/exporter-logs-otlp-http\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        // Lazy-load to preserve optional peer dependencies\n        // Use createRequire to resolve from user's project directory\n        const userRequire = createRequire(process.cwd() + '/package.json');\n\n        const { BatchLogRecordProcessor } = userRequire(\n          '@opentelemetry/sdk-logs',\n        );\n        const { OTLPLogExporter } = userRequire(\n          '@opentelemetry/exporter-logs-otlp-http',\n        );\n\n        cloudConfig.logRecordProcessors = [\n          new BatchLogRecordProcessor(\n            new OTLPLogExporter({\n              // Logs use /v1/logs path (SDK appends this to endpoint)\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 peer dependencies: @opentelemetry/sdk-logs and @opentelemetry/exporter-logs-otlp-http. ' +\n            'Install them with: npm install @opentelemetry/sdk-logs @opentelemetry/exporter-logs-otlp-http',\n        );\n      }\n    }\n  }\n\n  return cloudConfig;\n}\n","/**\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"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autotel-backends",
-  "version": "2.8.3",
+  "version": "2.9.0",
   "description": "Vendor backend configurations for Autotel (Honeycomb, Datadog, etc.)",
   "type": "module",
   "main": "./dist/index.js",
@@ -18,6 +18,10 @@
     "./datadog": {
       "types": "./dist/datadog.d.ts",
       "import": "./dist/datadog.js"
+    },
+    "./google-cloud": {
+      "types": "./dist/google-cloud.d.ts",
+      "import": "./dist/google-cloud.js"
     }
   },
   "files": [
@@ -32,6 +36,8 @@
     "backend",
     "honeycomb",
     "datadog",
+    "google-cloud",
+    "gcp",
     "configuration",
     "observability",
     "tracing",
@@ -41,26 +47,42 @@
   "author": "Jag Reehal <jag@jagreehal.com> (https://jagreehal.com)",
   "license": "MIT",
   "dependencies": {
-    "autotel": "2.18.0"
+    "autotel": "2.19.0"
   },
   "peerDependencies": {
     "@opentelemetry/exporter-logs-otlp-http": ">=0.211.0",
-    "@opentelemetry/sdk-logs": ">=0.211.0"
+    "@opentelemetry/exporter-metrics-otlp-http": ">=0.211.0",
+    "@opentelemetry/exporter-trace-otlp-http": ">=0.211.0",
+    "@opentelemetry/sdk-logs": ">=0.211.0",
+    "@opentelemetry/sdk-metrics": ">=2.5.0",
+    "google-auth-library": ">=10.5.0"
   },
   "peerDependenciesMeta": {
     "@opentelemetry/exporter-logs-otlp-http": {
       "optional": true
     },
+    "@opentelemetry/exporter-metrics-otlp-http": {
+      "optional": true
+    },
+    "@opentelemetry/exporter-trace-otlp-http": {
+      "optional": true
+    },
     "@opentelemetry/sdk-logs": {
       "optional": true
+    },
+    "@opentelemetry/sdk-metrics": {
+      "optional": true
+    },
+    "google-auth-library": {
+      "optional": true
     }
   },
   "devDependencies": {
-    "@types/node": "^25.1.0",
-    "@typescript-eslint/eslint-plugin": "^8.54.0",
-    "@typescript-eslint/parser": "^8.54.0",
+    "@types/node": "^25.2.3",
+    "@typescript-eslint/eslint-plugin": "^8.55.0",
+    "@typescript-eslint/parser": "^8.55.0",
     "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-unicorn": "^62.0.0",
+    "eslint-plugin-unicorn": "^63.0.0",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
     "vitest": "^4.0.18"

package/src/google-cloud.test.ts

@@ -0,0 +1,56 @@
+import { describe, expect, it } from 'vitest';
+import { createGoogleCloudConfig } from './google-cloud';
+
+describe('createGoogleCloudConfig()', () => {
+  describe('validation', () => {
+    it('should throw if projectId is missing', () => {
+      expect(() => {
+        createGoogleCloudConfig({
+          // @ts-expect-error - testing missing projectId
+          projectId: '',
+          service: 'test-service',
+        });
+      }).toThrow('projectId is required');
+    });
+  });
+
+  describe('useCollector mode', () => {
+    it('should return endpoint and headers when useCollector is true', () => {
+      const config = createGoogleCloudConfig({
+        projectId: 'my-project',
+        service: 'my-service',
+        useCollector: true,
+      });
+
+      expect(config).toMatchObject({
+        service: 'my-service',
+        endpoint: 'http://localhost:4318',
+        headers: { 'x-goog-user-project': 'my-project' },
+      });
+    });
+
+    it('should use custom collectorEndpoint when provided', () => {
+      const config = createGoogleCloudConfig({
+        projectId: 'my-project',
+        service: 'my-service',
+        useCollector: true,
+        collectorEndpoint: 'http://collector:4318',
+      });
+
+      expect(config.endpoint).toBe('http://collector:4318');
+    });
+
+    it('should pass through environment and version', () => {
+      const config = createGoogleCloudConfig({
+        projectId: 'my-project',
+        service: 'my-service',
+        useCollector: true,
+        environment: 'production',
+        version: '1.2.3',
+      });
+
+      expect(config.environment).toBe('production');
+      expect(config.version).toBe('1.2.3');
+    });
+  });
+});

package/src/google-cloud.ts

@@ -0,0 +1,259 @@
+/**
+ * Google Cloud preset for autotel
+ *
+ * Sends traces (and optionally metrics) to Google Cloud Observability via the
+ * Telemetry (OTLP) API. Uses Application Default Credentials (ADC) for auth.
+ *
+ * @example Direct export to GCP (with google-auth-library)
+ * ```typescript
+ * import { init } from 'autotel';
+ * import { createGoogleCloudConfig } from 'autotel-backends/google-cloud';
+ *
+ * init(createGoogleCloudConfig({
+ *   projectId: process.env.GOOGLE_CLOUD_PROJECT!,
+ *   service: 'my-app',
+ * }));
+ * ```
+ *
+ * @example Via OpenTelemetry Collector (no auth in app)
+ * ```typescript
+ * init(createGoogleCloudConfig({
+ *   projectId: process.env.GOOGLE_CLOUD_PROJECT!,
+ *   service: 'my-app',
+ *   useCollector: true,
+ *   collectorEndpoint: 'http://localhost:4318',
+ * }));
+ * ```
+ */
+
+import { createRequire } from 'node:module';
+import type { AutotelConfig } from 'autotel';
+
+/** Minimal SpanExporter-compatible interface (avoids @opentelemetry/sdk-trace-base peer at build time). */
+interface SpanExporterLike {
+  export(
+    spans: unknown[],
+    resultCallback: (result: { code: number; error?: Error }) => void,
+  ): void | Promise<void>;
+  forceFlush?(): Promise<void>;
+  shutdown?(): Promise<void>;
+}
+
+/** Default Telemetry API base URL (OTLP). */
+const DEFAULT_ENDPOINT = 'https://telemetry.googleapis.com';
+
+/**
+ * Configuration options for Google Cloud preset
+ */
+export interface GoogleCloudPresetConfig {
+  /**
+   * Google Cloud project ID (required for direct export).
+   * Used for quota and resource attribution. Set GOOGLE_CLOUD_PROJECT or
+   * GOOGLE_APPLICATION_CREDENTIALS for ADC.
+   *
+   * @default process.env.GOOGLE_CLOUD_PROJECT
+   */
+  projectId: string;
+
+  /**
+   * Service name (required).
+   * Appears as service.name in Cloud Trace and Monitoring.
+   */
+  service: string;
+
+  /**
+   * Deployment environment (e.g., 'production', 'staging').
+   *
+   * @default process.env.NODE_ENV || 'development'
+   */
+  environment?: string;
+
+  /**
+   * Service version for deployment tracking.
+   *
+   * @default process.env.GCP_VERSION || process.env.VERSION
+   */
+  version?: string;
+
+  /**
+   * Use an OpenTelemetry Collector instead of exporting directly to GCP.
+   * When true, the app sends OTLP to collectorEndpoint; the Collector
+   * handles authentication to the Telemetry API. No google-auth-library needed.
+   *
+   * @default false
+   */
+  useCollector?: boolean;
+
+  /**
+   * Collector OTLP endpoint (when useCollector is true).
+   *
+   * @default 'http://localhost:4318'
+   */
+  collectorEndpoint?: string;
+
+  /**
+   * Telemetry API base URL (when useCollector is false).
+   * Only override for testing or special endpoints.
+   *
+   * @default 'https://telemetry.googleapis.com'
+   */
+  endpoint?: string;
+}
+
+/**
+ * Create an autotel configuration for Google Cloud Observability (Telemetry API).
+ *
+ * - With useCollector: false (default), exports directly to the Telemetry API
+ *   using Application Default Credentials. Requires optional peer dependency
+ *   google-auth-library for auth. Install: pnpm add google-auth-library
+ *
+ * - With useCollector: true, sends OTLP to a local Collector; the Collector
+ *   forwards to GCP with ADC. No google-auth-library needed in the app.
+ *
+ * @param config - Google Cloud preset options
+ * @returns AutotelConfig ready to pass to init()
+ */
+export function createGoogleCloudConfig(
+  config: GoogleCloudPresetConfig,
+): AutotelConfig {
+  const {
+    projectId,
+    service,
+    environment,
+    version,
+    useCollector = false,
+    collectorEndpoint = 'http://localhost:4318',
+    endpoint = DEFAULT_ENDPOINT,
+  } = config;
+
+  if (!projectId) {
+    throw new Error(
+      'Google Cloud projectId is required. Set it or use process.env.GOOGLE_CLOUD_PROJECT.',
+    );
+  }
+
+  const baseConfig: AutotelConfig = {
+    service,
+    environment,
+    version,
+  };
+
+  if (useCollector) {
+    return {
+      ...baseConfig,
+      endpoint: collectorEndpoint,
+      // x-goog-user-project for quota when Collector forwards to GCP
+      headers: { 'x-goog-user-project': projectId },
+    };
+  }
+
+  // Direct export: need ADC via google-auth-library
+  try {
+    const userRequire = createRequire(process.cwd() + '/package.json');
+    const { GoogleAuth } = userRequire('google-auth-library');
+    const { OTLPTraceExporter } = userRequire(
+      '@opentelemetry/exporter-trace-otlp-http',
+    );
+
+    const tracesUrl = `${endpoint}/v1/traces`;
+    const auth = new GoogleAuth({
+      scopes: ['https://www.googleapis.com/auth/cloud-platform'],
+    });
+
+    const gcpTraceExporter = createGcpAuthTraceExporter(
+      tracesUrl,
+      projectId,
+      auth,
+      OTLPTraceExporter,
+    );
+
+    return {
+      ...baseConfig,
+      // Structurally compatible with SpanExporter from @opentelemetry/sdk-trace-base
+      spanExporters: [
+        gcpTraceExporter as NonNullable<AutotelConfig['spanExporters']>[number],
+      ],
+    };
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    if (
+      message.includes('google-auth-library') ||
+      message.includes('Cannot find module')
+    ) {
+      throw new Error(
+        'Direct export to Google Cloud requires google-auth-library. ' +
+          'Install it: pnpm add google-auth-library. ' +
+          'Or use useCollector: true and run an OpenTelemetry Collector with GCP auth.',
+        { cause: error },
+      );
+    }
+    throw error;
+  }
+}
+
+/** Minimal auth client: getClient() returns a client with getAccessToken(). */
+interface GoogleAuthLike {
+  getClient(): Promise<{ getAccessToken(): Promise<{ token: string | null }> }>;
+}
+
+type OTLPTraceExporterCtor = new (config: {
+  url: string;
+  headers?: Record<string, string>;
+}) => SpanExporterLike;
+
+function createGcpAuthTraceExporter(
+  url: string,
+  projectId: string,
+  auth: GoogleAuthLike,
+  OTLPTraceExporterCtor: OTLPTraceExporterCtor,
+): SpanExporterLike {
+  return new GcpAuthSpanExporter(url, projectId, auth, OTLPTraceExporterCtor);
+}
+
+class GcpAuthSpanExporter implements SpanExporterLike {
+  constructor(
+    private readonly url: string,
+    private readonly projectId: string,
+    private readonly auth: GoogleAuthLike,
+    private readonly OTLPTraceExporterCtor: OTLPTraceExporterCtor,
+  ) {}
+
+  async export(
+    spans: unknown[],
+    resultCallback: (result: { code: number; error?: Error }) => void,
+  ): Promise<void> {
+    try {
+      const client = await this.auth.getClient();
+      const tokenResponse = await client.getAccessToken();
+      const token = tokenResponse.token;
+      if (!token) {
+        resultCallback({
+          code: 1,
+          error: new Error('No access token from ADC'),
+        });
+        return;
+      }
+      const exporter = new this.OTLPTraceExporterCtor({
+        url: this.url,
+        headers: {
+          Authorization: `Bearer ${token}`,
+          'x-goog-user-project': this.projectId,
+        },
+      });
+      exporter.export(spans, resultCallback);
+    } catch (error) {
+      resultCallback({
+        code: 1,
+        error: error instanceof Error ? error : new Error(String(error)),
+      });
+    }
+  }
+
+  forceFlush(): Promise<void> {
+    return Promise.resolve();
+  }
+
+  shutdown(): Promise<void> {
+    return Promise.resolve();
+  }
+}

package/src/index.ts

@@ -34,3 +34,8 @@ export {
   type DatadogPresetConfig,
   type DatadogSite,
 } from './datadog';
+
+export {
+  createGoogleCloudConfig,
+  type GoogleCloudPresetConfig,
+} from './google-cloud';