@powerlines/plugin-open-telemetry 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,17 @@
+import { AttributesFromHeaderFunc, AttributesFromHeaders, Configuration, FetchInstrumentationConfig, InstrumentationConfiguration, InstrumentationOptionOrName, OTLPExporterConfig, OpenTelemetryPluginContext, OpenTelemetryPluginOptions, OpenTelemetryPluginResolvedConfig, OpenTelemetryPluginUserConfig, PropagatorOrName, SampleOrName, SpanExporterOrName, SpanProcessorOrName } from "./types/plugin.mjs";
+import { OpenTelemetryEnv } from "./types/env.mjs";
+import { Plugin } from "powerlines";
+
+//#region src/index.d.ts
+declare module "powerlines" {
+  interface Config {
+    openTelemetry?: OpenTelemetryPluginOptions;
+  }
+}
+/**
+ * A Powerlines plugin to inject environment variables into the source code.
+ */
+declare const plugin: <TContext extends OpenTelemetryPluginContext = OpenTelemetryPluginContext>(options?: OpenTelemetryPluginOptions) => Plugin<TContext>[];
+//#endregion
+export { AttributesFromHeaderFunc, AttributesFromHeaders, Configuration, FetchInstrumentationConfig, InstrumentationConfiguration, InstrumentationOptionOrName, OTLPExporterConfig, OpenTelemetryEnv, OpenTelemetryPluginContext, OpenTelemetryPluginOptions, OpenTelemetryPluginResolvedConfig, OpenTelemetryPluginUserConfig, PropagatorOrName, SampleOrName, SpanExporterOrName, SpanProcessorOrName, plugin as default, plugin };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.tsx"],"mappings":";;;;;;YAiCY,MAAA;IACR,aAAA,GAAgB,0BAAA;EAAA;AAAA;;;;cAOP,MAAA,oBACM,0BAAA,GAA6B,0BAAA,EAE9C,OAAA,GAAS,0BAAA,KA2BJ,MAAA,CAAO,QAAA"}

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import{trace as e}from"./helpers/automd-generator.mjs";import{TraceBuiltin as t}from"./components/trace-builtin.mjs";import{createComponent as n}from"@alloy-js/core/jsx-runtime";import r from"defu";import{render as i}from"@powerlines/plugin-alloy/render";import a from"@powerlines/plugin-automd";import o from"@powerlines/plugin-env";const s=(s={})=>[o(s.env),{name:`open-telemetry`,async prepare(){return this.debug(`Preparing the OpenTelemetry runtime artifacts for the Powerlines project.`),i(this,n(t,{}))}},{name:`open-telemetry:automd-generator`,config(){return{automd:r(s.automd??{},{generators:{trace:e(this)}})}}},a(s.automd)];export{s as default,s as plugin};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { render } from \"@powerlines/plugin-alloy/render\";\nimport automd from \"@powerlines/plugin-automd\";\nimport env from \"@powerlines/plugin-env\";\nimport defu from \"defu\";\nimport { Plugin } from \"powerlines\";\nimport { TraceBuiltin } from \"./components/trace-builtin\";\nimport { trace } from \"./helpers/automd-generator\";\nimport type {\n  OpenTelemetryPluginContext,\n  OpenTelemetryPluginOptions\n} from \"./types/plugin\";\n\nexport type * from \"./types\";\n\ndeclare module \"powerlines\" {\n  interface Config {\n    openTelemetry?: OpenTelemetryPluginOptions;\n  }\n}\n\n/**\n * A Powerlines plugin to inject environment variables into the source code.\n */\nexport const plugin = <\n  TContext extends OpenTelemetryPluginContext = OpenTelemetryPluginContext\n>(\n  options: OpenTelemetryPluginOptions = {}\n) => {\n  return [\n    env(options.env),\n    {\n      name: \"open-telemetry\",\n      async prepare() {\n        this.debug(\n          `Preparing the OpenTelemetry runtime artifacts for the Powerlines project.`\n        );\n\n        return render(this, <TraceBuiltin />);\n      }\n    },\n    {\n      name: \"open-telemetry:automd-generator\",\n      config() {\n        return {\n          automd: defu(options.automd ?? {}, {\n            generators: {\n              trace: trace(this)\n            }\n          })\n        };\n      }\n    },\n    automd(options.automd)\n  ] as Plugin<TContext>[];\n};\n\nexport default plugin;\n"],"mappings":"8VA8BO,CAAA,EAAO,EAAQ,IAAA,CAAM,uBAE5B,MAAQ,SAAQ,CAEZ,OADF,KAAS,MAAC,4EAAO,CACf,EAAgB,KAAA,EAAA,EAA0B,EAAA,CAAA,CAAA,EAE9C,CAAA,wCAEE,QAAA,CACG,MAAA,CACH,OAAA,EAAA,EAAA,QAAA,EAAA,CAAA,CACK,WAAe,CACX,MAAQ,EAAA,KAAA,CAClB,CACQ,CAAC,CACL,EAEF,CAAC,EAAI,EAAY,OAAA,CAAA"}

package/dist/types/env.d.cts

@@ -0,0 +1,77 @@
+import { EnvInterface } from "@powerlines/plugin-env/types/env";
+
+//#region src/types/env.d.ts
+/**
+ * The base environment configuration used by Powerlines applications
+ *
+ * @remarks
+ * This interface is used to define the environment variables, configuration options, and runtime settings used by applications. It is used to provide type safety, autocompletion, and default values for the environment variables. The comments of each variable are used to provide documentation descriptions when running the \`powerlines docs\` command.
+ *
+ * @categoryDescription Platform
+ * The name of the platform the configuration parameter is intended for use in.
+ *
+ * @showCategories
+ */
+interface OpenTelemetryEnv extends EnvInterface {
+  /**
+   * The name of the service. If none if provided, the plugin will attempt to use the value of the {@link EnvInterface.APP_NAME} configuration option.
+   */
+  readonly OTEL_SERVICE_NAME?: string;
+  /**
+   * The OTLP traces endpoint URL.
+   *
+   * @defaultValue "http://localhost:4318/v1/traces"
+   */
+  readonly OTEL_EXPORTER_OTLP_TRACES_ENDPOINT: string;
+  /**
+   * The supported trace sampler to use.
+   *
+   * @defaultValue "always_on"
+   */
+  readonly OTEL_TRACES_SAMPLER: "always_on" | "always_off" | "traceidratio" | "parentbased_traceidratio";
+  /**
+   * The argument for the trace sampler. For example, if using the "traceidratio" sampler, this would be a number between 0 and 1 representing the sampling ratio.
+   *
+   * @defaultValue 1
+   */
+  readonly OTEL_TRACES_SAMPLER_ARG: number;
+  /**
+   * A comma-separated list of trace exporter types to use. Supported values include "http" and "console".
+   *
+   * @defaultValue "http"
+   */
+  readonly OTEL_EXPORTER_TYPES?: string;
+  /**
+   * A comma-separated list of trace propagator types to use. Supported values include "tracecontext" and "baggage".
+   *
+   * @defaultValue "tracecontext,baggage"
+   */
+  readonly OTEL_PROPAGATORS?: string;
+  /**
+   * A comma-separated list of trace instrumentations to use. Supported values include "http", "express", and "graphql".
+   *
+   * @defaultValue "http,express"
+   */
+  readonly OTEL_INSTRUMENTATIONS?: string;
+  /**
+   * The log level for OpenTelemetry SDK diagnostics. If not set, the {@link EnvInterface.LOG_LEVEL} variable will be used to determine the log level for diagnostics.
+   *
+   * @defaultValue "INFO"
+   */
+  readonly OTEL_LOG_LEVEL?: "ALL" | "VERBOSE" | "DEBUG" | "INFO" | "WARN" | "ERROR" | "NONE";
+  /**
+   * A boolean flag to disable the OpenTelemetry SDK. When set to "true", the plugin will not inject any OpenTelemetry code or configuration into the application.
+   *
+   * @defaultValue false
+   */
+  readonly OTEL_SDK_DISABLED: boolean;
+  /**
+   * The runtime that the application is running in.
+   *
+   * @defaultValue "nodejs"
+   */
+  RUNTIME: "nodejs" | "deno" | "workerd" | "browser";
+}
+//#endregion
+export { OpenTelemetryEnv };
+//# sourceMappingURL=env.d.cts.map

package/dist/types/env.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.cts","names":[],"sources":["../../src/types/env.ts"],"mappings":";;;;;AA+BA;;;;;;;;;UAAiB,gBAAA,SAAyB,YAAA;EA2C/B;;;EAAA,SAvCA,iBAAA;EA0ET;;;;;EAAA,SAnES,kCAAA;;;;;;WAOA,mBAAA;;;;;;WAWA,uBAAA;;;;;;WAOA,mBAAA;;;;;;WAOA,gBAAA;;;;;;WAOA,qBAAA;;;;;;WAOA,cAAA;;;;;;WAcA,iBAAA;;;;;;EAOT,OAAA;AAAA"}

package/dist/types/env.d.mts

@@ -0,0 +1,77 @@
+import { EnvInterface } from "@powerlines/plugin-env/types/env";
+
+//#region src/types/env.d.ts
+/**
+ * The base environment configuration used by Powerlines applications
+ *
+ * @remarks
+ * This interface is used to define the environment variables, configuration options, and runtime settings used by applications. It is used to provide type safety, autocompletion, and default values for the environment variables. The comments of each variable are used to provide documentation descriptions when running the \`powerlines docs\` command.
+ *
+ * @categoryDescription Platform
+ * The name of the platform the configuration parameter is intended for use in.
+ *
+ * @showCategories
+ */
+interface OpenTelemetryEnv extends EnvInterface {
+  /**
+   * The name of the service. If none if provided, the plugin will attempt to use the value of the {@link EnvInterface.APP_NAME} configuration option.
+   */
+  readonly OTEL_SERVICE_NAME?: string;
+  /**
+   * The OTLP traces endpoint URL.
+   *
+   * @defaultValue "http://localhost:4318/v1/traces"
+   */
+  readonly OTEL_EXPORTER_OTLP_TRACES_ENDPOINT: string;
+  /**
+   * The supported trace sampler to use.
+   *
+   * @defaultValue "always_on"
+   */
+  readonly OTEL_TRACES_SAMPLER: "always_on" | "always_off" | "traceidratio" | "parentbased_traceidratio";
+  /**
+   * The argument for the trace sampler. For example, if using the "traceidratio" sampler, this would be a number between 0 and 1 representing the sampling ratio.
+   *
+   * @defaultValue 1
+   */
+  readonly OTEL_TRACES_SAMPLER_ARG: number;
+  /**
+   * A comma-separated list of trace exporter types to use. Supported values include "http" and "console".
+   *
+   * @defaultValue "http"
+   */
+  readonly OTEL_EXPORTER_TYPES?: string;
+  /**
+   * A comma-separated list of trace propagator types to use. Supported values include "tracecontext" and "baggage".
+   *
+   * @defaultValue "tracecontext,baggage"
+   */
+  readonly OTEL_PROPAGATORS?: string;
+  /**
+   * A comma-separated list of trace instrumentations to use. Supported values include "http", "express", and "graphql".
+   *
+   * @defaultValue "http,express"
+   */
+  readonly OTEL_INSTRUMENTATIONS?: string;
+  /**
+   * The log level for OpenTelemetry SDK diagnostics. If not set, the {@link EnvInterface.LOG_LEVEL} variable will be used to determine the log level for diagnostics.
+   *
+   * @defaultValue "INFO"
+   */
+  readonly OTEL_LOG_LEVEL?: "ALL" | "VERBOSE" | "DEBUG" | "INFO" | "WARN" | "ERROR" | "NONE";
+  /**
+   * A boolean flag to disable the OpenTelemetry SDK. When set to "true", the plugin will not inject any OpenTelemetry code or configuration into the application.
+   *
+   * @defaultValue false
+   */
+  readonly OTEL_SDK_DISABLED: boolean;
+  /**
+   * The runtime that the application is running in.
+   *
+   * @defaultValue "nodejs"
+   */
+  RUNTIME: "nodejs" | "deno" | "workerd" | "browser";
+}
+//#endregion
+export { OpenTelemetryEnv };
+//# sourceMappingURL=env.d.mts.map

package/dist/types/env.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.mts","names":[],"sources":["../../src/types/env.ts"],"mappings":";;;;;AA+BA;;;;;;;;;UAAiB,gBAAA,SAAyB,YAAA;EA2C/B;;;EAAA,SAvCA,iBAAA;EA0ET;;;;;EAAA,SAnES,kCAAA;;;;;;WAOA,mBAAA;;;;;;WAWA,uBAAA;;;;;;WAOA,mBAAA;;;;;;WAOA,gBAAA;;;;;;WAOA,qBAAA;;;;;;WAOA,cAAA;;;;;;WAcA,iBAAA;;;;;;EAOT,OAAA;AAAA"}

package/dist/types/env.mjs

@@ -0,0 +1,2 @@
+export{};
+//# sourceMappingURL=env.mjs.map

package/dist/types/env.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.mjs","names":[],"sources":["../../src/types/env.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { EnvInterface } from \"@powerlines/plugin-env/types/env\";\n\n/**\n * The base environment configuration used by Powerlines applications\n *\n * @remarks\n * This interface is used to define the environment variables, configuration options, and runtime settings used by applications. It is used to provide type safety, autocompletion, and default values for the environment variables. The comments of each variable are used to provide documentation descriptions when running the \\`powerlines docs\\` command.\n *\n * @categoryDescription Platform\n * The name of the platform the configuration parameter is intended for use in.\n *\n * @showCategories\n */\nexport interface OpenTelemetryEnv extends EnvInterface {\n  /**\n   * The name of the service. If none if provided, the plugin will attempt to use the value of the {@link EnvInterface.APP_NAME} configuration option.\n   */\n  readonly OTEL_SERVICE_NAME?: string;\n\n  /**\n   * The OTLP traces endpoint URL.\n   *\n   * @defaultValue \"http://localhost:4318/v1/traces\"\n   */\n  readonly OTEL_EXPORTER_OTLP_TRACES_ENDPOINT: string;\n\n  /**\n   * The supported trace sampler to use.\n   *\n   * @defaultValue \"always_on\"\n   */\n  readonly OTEL_TRACES_SAMPLER:\n    | \"always_on\"\n    | \"always_off\"\n    | \"traceidratio\"\n    | \"parentbased_traceidratio\";\n\n  /**\n   * The argument for the trace sampler. For example, if using the \"traceidratio\" sampler, this would be a number between 0 and 1 representing the sampling ratio.\n   *\n   * @defaultValue 1\n   */\n  readonly OTEL_TRACES_SAMPLER_ARG: number;\n\n  /**\n   * A comma-separated list of trace exporter types to use. Supported values include \"http\" and \"console\".\n   *\n   * @defaultValue \"http\"\n   */\n  readonly OTEL_EXPORTER_TYPES?: string;\n\n  /**\n   * A comma-separated list of trace propagator types to use. Supported values include \"tracecontext\" and \"baggage\".\n   *\n   * @defaultValue \"tracecontext,baggage\"\n   */\n  readonly OTEL_PROPAGATORS?: string;\n\n  /**\n   * A comma-separated list of trace instrumentations to use. Supported values include \"http\", \"express\", and \"graphql\".\n   *\n   * @defaultValue \"http,express\"\n   */\n  readonly OTEL_INSTRUMENTATIONS?: string;\n\n  /**\n   * The log level for OpenTelemetry SDK diagnostics. If not set, the {@link EnvInterface.LOG_LEVEL} variable will be used to determine the log level for diagnostics.\n   *\n   * @defaultValue \"INFO\"\n   */\n  readonly OTEL_LOG_LEVEL?:\n    | \"ALL\"\n    | \"VERBOSE\"\n    | \"DEBUG\"\n    | \"INFO\"\n    | \"WARN\"\n    | \"ERROR\"\n    | \"NONE\";\n\n  /**\n   * A boolean flag to disable the OpenTelemetry SDK. When set to \"true\", the plugin will not inject any OpenTelemetry code or configuration into the application.\n   *\n   * @defaultValue false\n   */\n  readonly OTEL_SDK_DISABLED: boolean;\n\n  /**\n   * The runtime that the application is running in.\n   *\n   * @defaultValue \"nodejs\"\n   */\n  RUNTIME: \"nodejs\" | \"deno\" | \"workerd\" | \"browser\";\n}\n"],"mappings":""}

package/dist/types/index.d.cts

@@ -0,0 +1,3 @@
+import { AttributesFromHeaderFunc, AttributesFromHeaders, Configuration, FetchInstrumentationConfig, InstrumentationConfiguration, InstrumentationOptionOrName, OTLPExporterConfig, OpenTelemetryPluginContext, OpenTelemetryPluginOptions, OpenTelemetryPluginResolvedConfig, OpenTelemetryPluginUserConfig, PropagatorOrName, SampleOrName, SpanExporterOrName, SpanProcessorOrName } from "./plugin.cjs";
+import { OpenTelemetryEnv } from "./env.cjs";
+export { AttributesFromHeaderFunc, AttributesFromHeaders, Configuration, FetchInstrumentationConfig, InstrumentationConfiguration, InstrumentationOptionOrName, OTLPExporterConfig, OpenTelemetryEnv, OpenTelemetryPluginContext, OpenTelemetryPluginOptions, OpenTelemetryPluginResolvedConfig, OpenTelemetryPluginUserConfig, PropagatorOrName, SampleOrName, SpanExporterOrName, SpanProcessorOrName };

package/dist/types/index.d.mts

@@ -0,0 +1,3 @@
+import { AttributesFromHeaderFunc, AttributesFromHeaders, Configuration, FetchInstrumentationConfig, InstrumentationConfiguration, InstrumentationOptionOrName, OTLPExporterConfig, OpenTelemetryPluginContext, OpenTelemetryPluginOptions, OpenTelemetryPluginResolvedConfig, OpenTelemetryPluginUserConfig, PropagatorOrName, SampleOrName, SpanExporterOrName, SpanProcessorOrName } from "./plugin.mjs";
+import { OpenTelemetryEnv } from "./env.mjs";
+export { AttributesFromHeaderFunc, AttributesFromHeaders, Configuration, FetchInstrumentationConfig, InstrumentationConfiguration, InstrumentationOptionOrName, OTLPExporterConfig, OpenTelemetryEnv, OpenTelemetryPluginContext, OpenTelemetryPluginOptions, OpenTelemetryPluginResolvedConfig, OpenTelemetryPluginUserConfig, PropagatorOrName, SampleOrName, SpanExporterOrName, SpanProcessorOrName };

package/dist/types/index.mjs

@@ -0,0 +1 @@
+export{};

package/dist/types/plugin.d.cts

@@ -0,0 +1,139 @@
+import { Attributes, ContextManager, TextMapGetter, TextMapPropagator } from "@opentelemetry/api";
+import { Instrumentation } from "@opentelemetry/instrumentation";
+import { ResourceDetector } from "@opentelemetry/resources";
+import { LogRecordProcessor } from "@opentelemetry/sdk-logs";
+import { MetricReader, ViewOptions } from "@opentelemetry/sdk-metrics";
+import { IdGenerator, Sampler, SpanExporter, SpanLimits, SpanProcessor } from "@opentelemetry/sdk-trace-base";
+import { AlloyPluginContext, AlloyPluginOptions, AlloyPluginResolvedConfig, AlloyPluginUserConfig } from "@powerlines/plugin-alloy/types";
+import { AutoMDPluginOptions } from "@powerlines/plugin-automd/types/plugin";
+import { BabelPluginContext, BabelPluginResolvedConfig, BabelPluginUserConfig } from "@powerlines/plugin-babel/types";
+import { EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig } from "@powerlines/plugin-env";
+
+//#region src/types/plugin.d.ts
+/**
+ * Configuration for the OTLP trace exporters.
+ */
+interface OTLPExporterConfig {
+  headers?: Record<string, unknown>;
+  url?: string;
+}
+type PropagatorOrName = TextMapPropagator | "auto" | "none" | "tracecontext" | "baggage";
+type SampleOrName = Sampler | "auto" | "always_off" | "always_on" | "parentbased_always_off" | "parentbased_always_on" | "parentbased_traceidratio" | "traceidratio";
+type SpanProcessorOrName = SpanProcessor | "auto";
+type SpanExporterOrName = SpanExporter | "auto";
+type InstrumentationOptionOrName = Instrumentation | "fetch" | "auto";
+interface FetchInstrumentationConfig {
+  /** URL matchers (string prefix or regex) to ignore from tracing. */
+  ignoreUrls?: Array<string | RegExp>;
+  /** URL matchers for which the tracing context should be propagated. */
+  propagateContextUrls?: Array<string | RegExp>;
+  /** URL matchers to exclude from context propagation. */
+  dontPropagateContextUrls?: Array<string | RegExp>;
+  /** Template string for the "resource.name" attribute. Use `{attr}` expressions. */
+  resourceNameTemplate?: string;
+}
+interface InstrumentationConfiguration {
+  fetch?: FetchInstrumentationConfig;
+}
+type AttributesFromHeaderFunc = <Carrier = unknown>(headers: Carrier, getter: TextMapGetter<Carrier>) => Attributes | undefined;
+type AttributesFromHeaders = Record<string, string> | AttributesFromHeaderFunc;
+/**
+ * OpenTelemetry SDK configuration. Mirrors the `@vercel/otel` `Configuration`
+ * interface, allowing the same options to be passed to `registerOTel`.
+ */
+interface Configuration {
+  /**
+   * The name of your service, used as the app name in many OpenTelemetry
+   * backends. Can be overridden by the `OTEL_SERVICE_NAME` environment variable.
+   */
+  serviceName?: string;
+  /**
+   * Additional resource attributes to apply to all spans. By default the
+   * plugin configures standard OpenTelemetry resource attributes such as
+   * `deployment.environment.name`, `cloud.region`, `process.runtime.name`,
+   * `vcs.ref.head.name`, `vcs.ref.head.revision`, `vcs.repository.name`,
+   * and `deployment.id`.
+   */
+  attributes?: Attributes;
+  /**
+   * Compute root span attributes based on request headers.
+   * A map with keys as attribute names and values as header names, or a
+   * function that takes an opaque headers object and returns attributes.
+   */
+  attributesFromHeaders?: AttributesFromHeaders;
+  /** Custom resource detectors. Defaults to `[envDetector]`. */
+  resourceDetectors?: ResourceDetector[];
+  /** Whether to auto-detect resources via detectors. Defaults to `true`. */
+  autoDetectResources?: boolean;
+  /**
+   * Set of instrumentations to enable.
+   * Defaults to `["auto"]` which enables the built-in fetch instrumentation.
+   */
+  instrumentations?: InstrumentationOptionOrName[];
+  /**
+   * Customize configuration for predefined instrumentations
+   * (e.g. `fetch`).
+   */
+  instrumentationConfig?: InstrumentationConfiguration;
+  /** Custom context manager. Defaults to `AsyncLocalStorageContextManager`. */
+  contextManager?: ContextManager;
+  /** Custom ID generator. Defaults to `RandomIdGenerator`. */
+  idGenerator?: IdGenerator;
+  /**
+   * Propagators for extending inbound and outbound contexts.
+   * Defaults to W3C Trace Context + Baggage propagators.
+   * Can also be configured via `OTEL_PROPAGATORS` env var.
+   */
+  propagators?: PropagatorOrName[];
+  /**
+   * Sampler to decide which requests to trace.
+   * Defaults to `"always_on"` (all requests).
+   * Can also be configured via `OTEL_TRACES_SAMPLER` env var.
+   */
+  traceSampler?: SampleOrName;
+  /**
+   * Span processors to use. Defaults to `"auto"` which auto-configures the
+   * best export mechanism for the environment.
+   */
+  spanProcessors?: SpanProcessorOrName[];
+  /**
+   * Custom trace exporter. Defaults to `"auto"` which selects the best
+   * exporter for the environment (OTLP HTTP if `OTEL_EXPORTER_OTLP_ENDPOINT`
+   * is set, etc.).
+   */
+  traceExporter?: SpanExporterOrName;
+  /** Optional span limits configuration. */
+  spanLimits?: SpanLimits;
+  /** Log record processors to enable log recording. */
+  logRecordProcessors?: LogRecordProcessor[];
+  /** Metric readers for metrics collection. */
+  metricReaders?: MetricReader[];
+  /** Metric views for SDK-level metric filtering/aggregation. */
+  views?: ViewOptions[];
+}
+interface OpenTelemetryPluginOptions extends Configuration {
+  /**
+   * AutoMD configuration options to allow injecting OpenTelemetry documentation
+   * into a markdown file such as a README.md.
+   */
+  automd?: AutoMDPluginOptions;
+  /**
+   * Alloy configuration options to use when generating OpenTelemetry runtime
+   * code into the source tree.
+   */
+  alloy?: AlloyPluginOptions;
+  /**
+   * Env plugin options to use for configuring environment variable loading and injection, which can be used to configure the OpenTelemetry SDK via environment variables.
+   */
+  env?: EnvPluginOptions;
+}
+type OpenTelemetryPluginUserConfig = BabelPluginUserConfig & AlloyPluginUserConfig & EnvPluginUserConfig & {
+  openTelemetry: OpenTelemetryPluginOptions;
+};
+type OpenTelemetryPluginResolvedConfig = BabelPluginResolvedConfig & AlloyPluginResolvedConfig & EnvPluginResolvedConfig & {
+  openTelemetry: OpenTelemetryPluginOptions;
+};
+interface OpenTelemetryPluginContext<TResolvedConfig extends OpenTelemetryPluginResolvedConfig = OpenTelemetryPluginResolvedConfig> extends BabelPluginContext<TResolvedConfig>, AlloyPluginContext<TResolvedConfig>, EnvPluginContext<TResolvedConfig> {}
+//#endregion
+export { AttributesFromHeaderFunc, AttributesFromHeaders, Configuration, FetchInstrumentationConfig, InstrumentationConfiguration, InstrumentationOptionOrName, OTLPExporterConfig, OpenTelemetryPluginContext, OpenTelemetryPluginOptions, OpenTelemetryPluginResolvedConfig, OpenTelemetryPluginUserConfig, PropagatorOrName, SampleOrName, SpanExporterOrName, SpanProcessorOrName };
+//# sourceMappingURL=plugin.d.cts.map

package/dist/types/plugin.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.cts","names":[],"sources":["../../src/types/plugin.ts"],"mappings":";;;;;;;;;;;;;;AA2DA;UAAiB,kBAAA;EACf,OAAA,GAAU,MAAA;EACV,GAAA;AAAA;AAAA,KAKU,gBAAA,GACR,iBAAA;AAAA,KAMQ,YAAA,GACR,OAAA;AAAA,KASQ,mBAAA,GAAsB,aAAA;AAAA,KAEtB,kBAAA,GAAqB,YAAA;AAAA,KAErB,2BAAA,GAA8B,eAAA;AAAA,UAIzB,0BAAA;;EAEf,UAAA,GAAa,KAAA,UAAe,MAAA;EA1BT;EA4BnB,oBAAA,GAAuB,KAAA,UAAe,MAAA;EAtBhB;EAwBtB,wBAAA,GAA2B,KAAA,UAAe,MAAA;EAvBxC;EAyBF,oBAAA;AAAA;AAAA,UAGe,4BAAA;EACf,KAAA,GAAQ,0BAAA;AAAA;AAAA,KAKE,wBAAA,uBACV,OAAA,EAAS,OAAA,EACT,MAAA,EAAQ,aAAA,CAAc,OAAA,MACnB,UAAA;AAAA,KAEO,qBAAA,GACR,MAAA,mBACA,wBAAA;;;;;UAQa,aAAA;EApCsB;;;;EAyCrC,WAAA;EArCyC;;;;;;;EA8CzC,UAAA,GAAa,UAAA;EAxCmB;;;;;EA+ChC,qBAAA,GAAwB,qBAAA;EAjDD;EAoDvB,iBAAA,GAAoB,gBAAA;EAlDpB;EAqDA,mBAAA;EArD0C;;;;EA2D1C,gBAAA,GAAmB,2BAAA;EAtDwB;;;;EA4D3C,qBAAA,GAAwB,4BAAA;EAtDU;EAyDlC,cAAA,GAAiB,cAAA;EAxDR;EA2DT,WAAA,GAAc,WAAA;EA1DN;;;;;EAiER,WAAA,GAAc,gBAAA;EAlEd;;;;;EAyEA,YAAA,GAAe,YAAA;EAvEF;AAEf;;;EA2EE,cAAA,GAAiB,mBAAA;EAzES;AAQ5B;;;;EAwEE,aAAA,GAAgB,kBAAA;EAhDI;EAmDpB,UAAA,GAAa,UAAA;EApCW;EAuCxB,mBAAA,GAAsB,kBAAA;EAjCR;EAoCd,aAAA,GAAgB,YAAA;EAtBD;EAyBf,KAAA,GAAQ,WAAA;AAAA;AAAA,UAKO,0BAAA,SAAmC,aAAA;EAX5B;;;;EAgBtB,MAAA,GAAS,mBAAA;EAzFT;;;;EA+FA,KAAA,GAAQ,kBAAA;EA5ER;;;EAiFA,GAAA,GAAM,gBAAA;AAAA;AAAA,KAGI,6BAAA,GAAgC,qBAAA,GAC1C,qBAAA,GACA,mBAAA;EACE,aAAA,EAAe,0BAAA;AAAA;AAAA,KAGP,iCAAA,GAAoC,yBAAA,GAC9C,yBAAA,GACA,uBAAA;EACE,aAAA,EAAe,0BAAA;AAAA;AAAA,UAGF,0BAAA,yBACS,iCAAA,GACtB,iCAAA,UAGA,kBAAA,CAAmB,eAAA,GACnB,kBAAA,CAAmB,eAAA,GACnB,gBAAA,CAAiB,eAAA"}

package/dist/types/plugin.d.mts

@@ -0,0 +1,139 @@
+import { EnvPluginContext, EnvPluginOptions, EnvPluginResolvedConfig, EnvPluginUserConfig } from "@powerlines/plugin-env";
+import { Attributes, ContextManager, TextMapGetter, TextMapPropagator } from "@opentelemetry/api";
+import { Instrumentation } from "@opentelemetry/instrumentation";
+import { ResourceDetector } from "@opentelemetry/resources";
+import { LogRecordProcessor } from "@opentelemetry/sdk-logs";
+import { MetricReader, ViewOptions } from "@opentelemetry/sdk-metrics";
+import { IdGenerator, Sampler, SpanExporter, SpanLimits, SpanProcessor } from "@opentelemetry/sdk-trace-base";
+import { AlloyPluginContext, AlloyPluginOptions, AlloyPluginResolvedConfig, AlloyPluginUserConfig } from "@powerlines/plugin-alloy/types";
+import { AutoMDPluginOptions } from "@powerlines/plugin-automd/types/plugin";
+import { BabelPluginContext, BabelPluginResolvedConfig, BabelPluginUserConfig } from "@powerlines/plugin-babel/types";
+
+//#region src/types/plugin.d.ts
+/**
+ * Configuration for the OTLP trace exporters.
+ */
+interface OTLPExporterConfig {
+  headers?: Record<string, unknown>;
+  url?: string;
+}
+type PropagatorOrName = TextMapPropagator | "auto" | "none" | "tracecontext" | "baggage";
+type SampleOrName = Sampler | "auto" | "always_off" | "always_on" | "parentbased_always_off" | "parentbased_always_on" | "parentbased_traceidratio" | "traceidratio";
+type SpanProcessorOrName = SpanProcessor | "auto";
+type SpanExporterOrName = SpanExporter | "auto";
+type InstrumentationOptionOrName = Instrumentation | "fetch" | "auto";
+interface FetchInstrumentationConfig {
+  /** URL matchers (string prefix or regex) to ignore from tracing. */
+  ignoreUrls?: Array<string | RegExp>;
+  /** URL matchers for which the tracing context should be propagated. */
+  propagateContextUrls?: Array<string | RegExp>;
+  /** URL matchers to exclude from context propagation. */
+  dontPropagateContextUrls?: Array<string | RegExp>;
+  /** Template string for the "resource.name" attribute. Use `{attr}` expressions. */
+  resourceNameTemplate?: string;
+}
+interface InstrumentationConfiguration {
+  fetch?: FetchInstrumentationConfig;
+}
+type AttributesFromHeaderFunc = <Carrier = unknown>(headers: Carrier, getter: TextMapGetter<Carrier>) => Attributes | undefined;
+type AttributesFromHeaders = Record<string, string> | AttributesFromHeaderFunc;
+/**
+ * OpenTelemetry SDK configuration. Mirrors the `@vercel/otel` `Configuration`
+ * interface, allowing the same options to be passed to `registerOTel`.
+ */
+interface Configuration {
+  /**
+   * The name of your service, used as the app name in many OpenTelemetry
+   * backends. Can be overridden by the `OTEL_SERVICE_NAME` environment variable.
+   */
+  serviceName?: string;
+  /**
+   * Additional resource attributes to apply to all spans. By default the
+   * plugin configures standard OpenTelemetry resource attributes such as
+   * `deployment.environment.name`, `cloud.region`, `process.runtime.name`,
+   * `vcs.ref.head.name`, `vcs.ref.head.revision`, `vcs.repository.name`,
+   * and `deployment.id`.
+   */
+  attributes?: Attributes;
+  /**
+   * Compute root span attributes based on request headers.
+   * A map with keys as attribute names and values as header names, or a
+   * function that takes an opaque headers object and returns attributes.
+   */
+  attributesFromHeaders?: AttributesFromHeaders;
+  /** Custom resource detectors. Defaults to `[envDetector]`. */
+  resourceDetectors?: ResourceDetector[];
+  /** Whether to auto-detect resources via detectors. Defaults to `true`. */
+  autoDetectResources?: boolean;
+  /**
+   * Set of instrumentations to enable.
+   * Defaults to `["auto"]` which enables the built-in fetch instrumentation.
+   */
+  instrumentations?: InstrumentationOptionOrName[];
+  /**
+   * Customize configuration for predefined instrumentations
+   * (e.g. `fetch`).
+   */
+  instrumentationConfig?: InstrumentationConfiguration;
+  /** Custom context manager. Defaults to `AsyncLocalStorageContextManager`. */
+  contextManager?: ContextManager;
+  /** Custom ID generator. Defaults to `RandomIdGenerator`. */
+  idGenerator?: IdGenerator;
+  /**
+   * Propagators for extending inbound and outbound contexts.
+   * Defaults to W3C Trace Context + Baggage propagators.
+   * Can also be configured via `OTEL_PROPAGATORS` env var.
+   */
+  propagators?: PropagatorOrName[];
+  /**
+   * Sampler to decide which requests to trace.
+   * Defaults to `"always_on"` (all requests).
+   * Can also be configured via `OTEL_TRACES_SAMPLER` env var.
+   */
+  traceSampler?: SampleOrName;
+  /**
+   * Span processors to use. Defaults to `"auto"` which auto-configures the
+   * best export mechanism for the environment.
+   */
+  spanProcessors?: SpanProcessorOrName[];
+  /**
+   * Custom trace exporter. Defaults to `"auto"` which selects the best
+   * exporter for the environment (OTLP HTTP if `OTEL_EXPORTER_OTLP_ENDPOINT`
+   * is set, etc.).
+   */
+  traceExporter?: SpanExporterOrName;
+  /** Optional span limits configuration. */
+  spanLimits?: SpanLimits;
+  /** Log record processors to enable log recording. */
+  logRecordProcessors?: LogRecordProcessor[];
+  /** Metric readers for metrics collection. */
+  metricReaders?: MetricReader[];
+  /** Metric views for SDK-level metric filtering/aggregation. */
+  views?: ViewOptions[];
+}
+interface OpenTelemetryPluginOptions extends Configuration {
+  /**
+   * AutoMD configuration options to allow injecting OpenTelemetry documentation
+   * into a markdown file such as a README.md.
+   */
+  automd?: AutoMDPluginOptions;
+  /**
+   * Alloy configuration options to use when generating OpenTelemetry runtime
+   * code into the source tree.
+   */
+  alloy?: AlloyPluginOptions;
+  /**
+   * Env plugin options to use for configuring environment variable loading and injection, which can be used to configure the OpenTelemetry SDK via environment variables.
+   */
+  env?: EnvPluginOptions;
+}
+type OpenTelemetryPluginUserConfig = BabelPluginUserConfig & AlloyPluginUserConfig & EnvPluginUserConfig & {
+  openTelemetry: OpenTelemetryPluginOptions;
+};
+type OpenTelemetryPluginResolvedConfig = BabelPluginResolvedConfig & AlloyPluginResolvedConfig & EnvPluginResolvedConfig & {
+  openTelemetry: OpenTelemetryPluginOptions;
+};
+interface OpenTelemetryPluginContext<TResolvedConfig extends OpenTelemetryPluginResolvedConfig = OpenTelemetryPluginResolvedConfig> extends BabelPluginContext<TResolvedConfig>, AlloyPluginContext<TResolvedConfig>, EnvPluginContext<TResolvedConfig> {}
+//#endregion
+export { AttributesFromHeaderFunc, AttributesFromHeaders, Configuration, FetchInstrumentationConfig, InstrumentationConfiguration, InstrumentationOptionOrName, OTLPExporterConfig, OpenTelemetryPluginContext, OpenTelemetryPluginOptions, OpenTelemetryPluginResolvedConfig, OpenTelemetryPluginUserConfig, PropagatorOrName, SampleOrName, SpanExporterOrName, SpanProcessorOrName };
+//# sourceMappingURL=plugin.d.mts.map

package/dist/types/plugin.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.mts","names":[],"sources":["../../src/types/plugin.ts"],"mappings":";;;;;;;;;;;;;;AA2DA;UAAiB,kBAAA;EACf,OAAA,GAAU,MAAA;EACV,GAAA;AAAA;AAAA,KAKU,gBAAA,GACR,iBAAA;AAAA,KAMQ,YAAA,GACR,OAAA;AAAA,KASQ,mBAAA,GAAsB,aAAA;AAAA,KAEtB,kBAAA,GAAqB,YAAA;AAAA,KAErB,2BAAA,GAA8B,eAAA;AAAA,UAIzB,0BAAA;;EAEf,UAAA,GAAa,KAAA,UAAe,MAAA;EA1BT;EA4BnB,oBAAA,GAAuB,KAAA,UAAe,MAAA;EAtBhB;EAwBtB,wBAAA,GAA2B,KAAA,UAAe,MAAA;EAvBxC;EAyBF,oBAAA;AAAA;AAAA,UAGe,4BAAA;EACf,KAAA,GAAQ,0BAAA;AAAA;AAAA,KAKE,wBAAA,uBACV,OAAA,EAAS,OAAA,EACT,MAAA,EAAQ,aAAA,CAAc,OAAA,MACnB,UAAA;AAAA,KAEO,qBAAA,GACR,MAAA,mBACA,wBAAA;;;;;UAQa,aAAA;EApCsB;;;;EAyCrC,WAAA;EArCyC;;;;;;;EA8CzC,UAAA,GAAa,UAAA;EAxCmB;;;;;EA+ChC,qBAAA,GAAwB,qBAAA;EAjDD;EAoDvB,iBAAA,GAAoB,gBAAA;EAlDpB;EAqDA,mBAAA;EArD0C;;;;EA2D1C,gBAAA,GAAmB,2BAAA;EAtDwB;;;;EA4D3C,qBAAA,GAAwB,4BAAA;EAtDU;EAyDlC,cAAA,GAAiB,cAAA;EAxDR;EA2DT,WAAA,GAAc,WAAA;EA1DN;;;;;EAiER,WAAA,GAAc,gBAAA;EAlEd;;;;;EAyEA,YAAA,GAAe,YAAA;EAvEF;AAEf;;;EA2EE,cAAA,GAAiB,mBAAA;EAzES;AAQ5B;;;;EAwEE,aAAA,GAAgB,kBAAA;EAhDI;EAmDpB,UAAA,GAAa,UAAA;EApCW;EAuCxB,mBAAA,GAAsB,kBAAA;EAjCR;EAoCd,aAAA,GAAgB,YAAA;EAtBD;EAyBf,KAAA,GAAQ,WAAA;AAAA;AAAA,UAKO,0BAAA,SAAmC,aAAA;EAX5B;;;;EAgBtB,MAAA,GAAS,mBAAA;EAzFT;;;;EA+FA,KAAA,GAAQ,kBAAA;EA5ER;;;EAiFA,GAAA,GAAM,gBAAA;AAAA;AAAA,KAGI,6BAAA,GAAgC,qBAAA,GAC1C,qBAAA,GACA,mBAAA;EACE,aAAA,EAAe,0BAAA;AAAA;AAAA,KAGP,iCAAA,GAAoC,yBAAA,GAC9C,yBAAA,GACA,uBAAA;EACE,aAAA,EAAe,0BAAA;AAAA;AAAA,UAGF,0BAAA,yBACS,iCAAA,GACtB,iCAAA,UAGA,kBAAA,CAAmB,eAAA,GACnB,kBAAA,CAAmB,eAAA,GACnB,gBAAA,CAAiB,eAAA"}

package/dist/types/plugin.mjs

@@ -0,0 +1 @@
+export{};