@atrim/instrument-node 0.5.0-14fdea7-20260108232035 → 0.5.0-14fdea7-20260109020503

package/target/dist/integrations/effect/index.cjs

@@ -0,0 +1,991 @@
+'use strict';
+
+var effect = require('effect');
+var Tracer = require('@effect/opentelemetry/Tracer');
+var Resource = require('@effect/opentelemetry/Resource');
+var Otlp = require('@effect/opentelemetry/Otlp');
+var platform = require('@effect/platform');
+var api = require('@opentelemetry/api');
+var semanticConventions = require('@opentelemetry/semantic-conventions');
+var FileSystem = require('@effect/platform/FileSystem');
+var HttpClient = require('@effect/platform/HttpClient');
+var HttpClientRequest = require('@effect/platform/HttpClientRequest');
+var yaml = require('yaml');
+var zod = require('zod');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var Tracer__namespace = /*#__PURE__*/_interopNamespace(Tracer);
+var Resource__namespace = /*#__PURE__*/_interopNamespace(Resource);
+var Otlp__namespace = /*#__PURE__*/_interopNamespace(Otlp);
+var HttpClient__namespace = /*#__PURE__*/_interopNamespace(HttpClient);
+var HttpClientRequest__namespace = /*#__PURE__*/_interopNamespace(HttpClientRequest);
+
+// src/integrations/effect/effect-tracer.ts
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+var PatternConfigSchema = zod.z.object({
+  pattern: zod.z.string(),
+  enabled: zod.z.boolean().optional(),
+  description: zod.z.string().optional()
+});
+var AutoIsolationConfigSchema = zod.z.object({
+  // Global enable/disable for auto-isolation
+  enabled: zod.z.boolean().default(false),
+  // Which operators to auto-isolate
+  operators: zod.z.object({
+    fiberset_run: zod.z.boolean().default(true),
+    effect_fork: zod.z.boolean().default(true),
+    effect_fork_daemon: zod.z.boolean().default(true),
+    effect_fork_in: zod.z.boolean().default(false)
+  }).default({}),
+  // Virtual parent tracking configuration
+  tracking: zod.z.object({
+    use_span_links: zod.z.boolean().default(true),
+    use_attributes: zod.z.boolean().default(true),
+    capture_logical_parent: zod.z.boolean().default(true)
+  }).default({}),
+  // Span categorization
+  attributes: zod.z.object({
+    category: zod.z.string().default("background_task"),
+    add_metadata: zod.z.boolean().default(true)
+  }).default({})
+});
+var SpanNamingRuleSchema = zod.z.object({
+  // Match criteria (all specified criteria must match)
+  match: zod.z.object({
+    // Regex pattern to match file path
+    file: zod.z.string().optional(),
+    // Regex pattern to match function name
+    function: zod.z.string().optional(),
+    // Regex pattern to match module name
+    module: zod.z.string().optional()
+  }),
+  // Span name template with variables:
+  // {fiber_id} - Fiber ID
+  // {function} - Function name
+  // {module} - Module name
+  // {file} - File path
+  // {line} - Line number
+  // {operator} - Effect operator (gen, all, forEach, etc.)
+  // {match:field:N} - Captured regex group from match
+  name: zod.z.string()
+});
+var AutoInstrumentationConfigSchema = zod.z.object({
+  // Enable/disable auto-instrumentation
+  enabled: zod.z.boolean().default(false),
+  // Tracing granularity
+  // - 'fiber': Trace at fiber creation (recommended, lower overhead)
+  // - 'operator': Trace each Effect operator (higher granularity, more overhead)
+  granularity: zod.z.enum(["fiber", "operator"]).default("fiber"),
+  // Smart span naming configuration
+  span_naming: zod.z.object({
+    // Default span name template when no rules match
+    default: zod.z.string().default("effect.fiber.{fiber_id}"),
+    // Infer span names from source code (requires stack trace parsing)
+    // Adds ~50-100μs overhead per fiber
+    infer_from_source: zod.z.boolean().default(true),
+    // Naming rules (first match wins)
+    rules: zod.z.array(SpanNamingRuleSchema).default([])
+  }).default({}),
+  // Pattern-based filtering
+  filter: zod.z.object({
+    // Only trace spans matching these patterns (empty = trace all)
+    include: zod.z.array(zod.z.string()).default([]),
+    // Never trace spans matching these patterns
+    exclude: zod.z.array(zod.z.string()).default([])
+  }).default({}),
+  // Performance controls
+  performance: zod.z.object({
+    // Sample rate (0.0 - 1.0)
+    sampling_rate: zod.z.number().min(0).max(1).default(1),
+    // Skip fibers shorter than this duration (e.g., "10ms", "100 millis")
+    min_duration: zod.z.string().default("0ms"),
+    // Maximum concurrent traced fibers (0 = unlimited)
+    max_concurrent: zod.z.number().default(0)
+  }).default({}),
+  // Automatic metadata extraction
+  metadata: zod.z.object({
+    // Extract Effect fiber information
+    fiber_info: zod.z.boolean().default(true),
+    // Extract source location (file:line)
+    source_location: zod.z.boolean().default(true),
+    // Extract parent fiber information
+    parent_fiber: zod.z.boolean().default(true)
+  }).default({})
+});
+var HttpFilteringConfigSchema = zod.z.object({
+  // Patterns to ignore for outgoing HTTP requests (string patterns only in YAML)
+  ignore_outgoing_urls: zod.z.array(zod.z.string()).optional(),
+  // Patterns to ignore for incoming HTTP requests (string patterns only in YAML)
+  ignore_incoming_paths: zod.z.array(zod.z.string()).optional(),
+  // Require parent span for outgoing requests (prevents root spans for HTTP calls)
+  require_parent_for_outgoing_spans: zod.z.boolean().optional(),
+  // Trace context propagation configuration
+  // Controls which cross-origin requests receive W3C Trace Context headers (traceparent, tracestate)
+  propagate_trace_context: zod.z.object({
+    // Strategy for trace propagation
+    // - "all": Propagate to all cross-origin requests (may cause CORS errors)
+    // - "none": Never propagate trace headers
+    // - "same-origin": Only propagate to same-origin requests (default, safe)
+    // - "patterns": Propagate based on include_urls patterns
+    strategy: zod.z.enum(["all", "none", "same-origin", "patterns"]).default("same-origin"),
+    // URL patterns to include when strategy is "patterns"
+    // Supports regex patterns (e.g., "^https://api\\.myapp\\.com")
+    include_urls: zod.z.array(zod.z.string()).optional()
+  }).optional()
+});
+var ExporterConfigSchema = zod.z.object({
+  // Exporter type: 'otlp' | 'console' | 'none'
+  // - 'otlp': Export to OTLP endpoint (production)
+  // - 'console': Log spans to console (development)
+  // - 'none': No export (disable tracing)
+  type: zod.z.enum(["otlp", "console", "none"]).default("otlp"),
+  // OTLP endpoint URL (for type: otlp)
+  // Defaults to OTEL_EXPORTER_OTLP_ENDPOINT env var or http://localhost:4318
+  endpoint: zod.z.string().optional(),
+  // Custom headers to send with OTLP requests (for type: otlp)
+  // Useful for authentication (x-api-key, Authorization, etc.)
+  headers: zod.z.record(zod.z.string()).optional(),
+  // Span processor type
+  // - 'batch': Batch spans for export (production, lower overhead)
+  // - 'simple': Export immediately (development, no batching delay)
+  processor: zod.z.enum(["batch", "simple"]).default("batch"),
+  // Batch processor settings (for processor: batch)
+  batch: zod.z.object({
+    // Max time to wait before exporting (milliseconds)
+    scheduled_delay_millis: zod.z.number().default(1e3),
+    // Max batch size
+    max_export_batch_size: zod.z.number().default(100)
+  }).optional()
+});
+var InstrumentationConfigSchema = zod.z.object({
+  version: zod.z.string(),
+  instrumentation: zod.z.object({
+    enabled: zod.z.boolean(),
+    description: zod.z.string().optional(),
+    logging: zod.z.enum(["on", "off", "minimal"]).optional().default("on"),
+    instrument_patterns: zod.z.array(PatternConfigSchema),
+    ignore_patterns: zod.z.array(PatternConfigSchema)
+  }),
+  effect: zod.z.object({
+    // Enable/disable Effect tracing entirely
+    // When false, EffectInstrumentationLive returns Layer.empty
+    enabled: zod.z.boolean().default(true),
+    // Exporter mode (legacy - use exporter.type instead):
+    // - "unified": Use global TracerProvider from Node SDK (recommended, enables filtering)
+    // - "standalone": Use Effect's own OTLP exporter (bypasses Node SDK filtering)
+    exporter: zod.z.enum(["unified", "standalone"]).default("unified"),
+    // Exporter configuration (for auto-instrumentation)
+    exporter_config: ExporterConfigSchema.optional(),
+    auto_extract_metadata: zod.z.boolean(),
+    auto_isolation: AutoIsolationConfigSchema.optional(),
+    // Auto-instrumentation: automatic tracing of all Effect fibers
+    auto_instrumentation: AutoInstrumentationConfigSchema.optional()
+  }).optional(),
+  http: HttpFilteringConfigSchema.optional()
+});
+var defaultConfig = {
+  version: "1.0",
+  instrumentation: {
+    enabled: true,
+    logging: "on",
+    description: "Default instrumentation configuration",
+    instrument_patterns: [
+      { pattern: "^app\\.", enabled: true, description: "Application operations" },
+      { pattern: "^http\\.server\\.", enabled: true, description: "HTTP server operations" },
+      { pattern: "^http\\.client\\.", enabled: true, description: "HTTP client operations" }
+    ],
+    ignore_patterns: [
+      { pattern: "^test\\.", description: "Test utilities" },
+      { pattern: "^internal\\.", description: "Internal operations" },
+      { pattern: "^health\\.", description: "Health checks" }
+    ]
+  },
+  effect: {
+    enabled: true,
+    exporter: "unified",
+    auto_extract_metadata: true
+  }
+};
+function parseAndValidateConfig(content) {
+  let parsed;
+  if (typeof content === "string") {
+    parsed = yaml.parse(content);
+  } else {
+    parsed = content;
+  }
+  return InstrumentationConfigSchema.parse(parsed);
+}
+(class extends effect.Data.TaggedError("ConfigError") {
+  get message() {
+    return this.reason;
+  }
+});
+var ConfigUrlError = class extends effect.Data.TaggedError("ConfigUrlError") {
+  get message() {
+    return this.reason;
+  }
+};
+var ConfigValidationError = class extends effect.Data.TaggedError("ConfigValidationError") {
+  get message() {
+    return this.reason;
+  }
+};
+var ConfigFileError = class extends effect.Data.TaggedError("ConfigFileError") {
+  get message() {
+    return this.reason;
+  }
+};
+(class extends effect.Data.TaggedError("ServiceDetectionError") {
+  get message() {
+    return this.reason;
+  }
+});
+(class extends effect.Data.TaggedError("InitializationError") {
+  get message() {
+    return this.reason;
+  }
+});
+(class extends effect.Data.TaggedError("ExportError") {
+  get message() {
+    return this.reason;
+  }
+});
+(class extends effect.Data.TaggedError("ShutdownError") {
+  get message() {
+    return this.reason;
+  }
+});
+var SECURITY_DEFAULTS = {
+  maxConfigSize: 1e6,
+  // 1MB
+  requestTimeout: 5e3
+  // 5 seconds
+};
+var ConfigLoader = class extends effect.Context.Tag("ConfigLoader")() {
+};
+var parseYamlContent = (content, uri) => effect.Effect.gen(function* () {
+  const parsed = yield* effect.Effect.try({
+    try: () => yaml.parse(content),
+    catch: (error) => new ConfigValidationError({
+      reason: uri ? `Failed to parse YAML from ${uri}` : "Failed to parse YAML",
+      cause: error
+    })
+  });
+  return yield* effect.Effect.try({
+    try: () => InstrumentationConfigSchema.parse(parsed),
+    catch: (error) => new ConfigValidationError({
+      reason: uri ? `Invalid configuration schema from ${uri}` : "Invalid configuration schema",
+      cause: error
+    })
+  });
+});
+var loadFromFileWithFs = (fs, path, uri) => effect.Effect.gen(function* () {
+  const content = yield* fs.readFileString(path).pipe(
+    effect.Effect.mapError(
+      (error) => new ConfigFileError({
+        reason: `Failed to read config file at ${uri}`,
+        cause: error
+      })
+    )
+  );
+  if (content.length > SECURITY_DEFAULTS.maxConfigSize) {
+    return yield* effect.Effect.fail(
+      new ConfigFileError({
+        reason: `Config file exceeds maximum size of ${SECURITY_DEFAULTS.maxConfigSize} bytes`
+      })
+    );
+  }
+  return yield* parseYamlContent(content, uri);
+});
+var loadFromHttpWithClient = (client, url) => effect.Effect.scoped(
+  effect.Effect.gen(function* () {
+    if (url.startsWith("http://")) {
+      return yield* effect.Effect.fail(
+        new ConfigUrlError({
+          reason: "Insecure protocol: only HTTPS URLs are allowed"
+        })
+      );
+    }
+    const request = HttpClientRequest__namespace.get(url).pipe(
+      HttpClientRequest__namespace.setHeaders({
+        Accept: "application/yaml, text/yaml, application/x-yaml"
+      })
+    );
+    const response = yield* client.execute(request).pipe(
+      effect.Effect.timeout(`${SECURITY_DEFAULTS.requestTimeout} millis`),
+      effect.Effect.mapError((error) => {
+        if (error._tag === "TimeoutException") {
+          return new ConfigUrlError({
+            reason: `Config fetch timeout after ${SECURITY_DEFAULTS.requestTimeout}ms from ${url}`
+          });
+        }
+        return new ConfigUrlError({
+          reason: `Failed to load config from URL: ${url}`,
+          cause: error
+        });
+      })
+    );
+    if (response.status >= 400) {
+      return yield* effect.Effect.fail(
+        new ConfigUrlError({
+          reason: `HTTP ${response.status} from ${url}`
+        })
+      );
+    }
+    const text = yield* response.text.pipe(
+      effect.Effect.mapError(
+        (error) => new ConfigUrlError({
+          reason: `Failed to read response body from ${url}`,
+          cause: error
+        })
+      )
+    );
+    if (text.length > SECURITY_DEFAULTS.maxConfigSize) {
+      return yield* effect.Effect.fail(
+        new ConfigUrlError({
+          reason: `Config exceeds maximum size of ${SECURITY_DEFAULTS.maxConfigSize} bytes`
+        })
+      );
+    }
+    return yield* parseYamlContent(text, url);
+  })
+);
+var makeConfigLoader = effect.Effect.gen(function* () {
+  const fs = yield* effect.Effect.serviceOption(FileSystem.FileSystem);
+  const http = yield* HttpClient__namespace.HttpClient;
+  const loadFromUriUncached = (uri) => effect.Effect.gen(function* () {
+    if (uri.startsWith("file://")) {
+      const path = uri.slice(7);
+      if (fs._tag === "None") {
+        return yield* effect.Effect.fail(
+          new ConfigFileError({
+            reason: "FileSystem not available (browser environment?)",
+            cause: { uri }
+          })
+        );
+      }
+      return yield* loadFromFileWithFs(fs.value, path, uri);
+    }
+    if (uri.startsWith("http://") || uri.startsWith("https://")) {
+      return yield* loadFromHttpWithClient(http, uri);
+    }
+    if (fs._tag === "Some") {
+      return yield* loadFromFileWithFs(fs.value, uri, uri);
+    } else {
+      return yield* loadFromHttpWithClient(http, uri);
+    }
+  });
+  const loadFromUriCached = yield* effect.Effect.cachedFunction(loadFromUriUncached);
+  return ConfigLoader.of({
+    loadFromUri: loadFromUriCached,
+    loadFromInline: (content) => effect.Effect.gen(function* () {
+      if (typeof content === "string") {
+        return yield* parseYamlContent(content);
+      }
+      return yield* effect.Effect.try({
+        try: () => InstrumentationConfigSchema.parse(content),
+        catch: (error) => new ConfigValidationError({
+          reason: "Invalid configuration schema",
+          cause: error
+        })
+      });
+    })
+  });
+});
+effect.Layer.effect(ConfigLoader, makeConfigLoader);
+var PatternMatcher = class {
+  constructor(config) {
+    __publicField(this, "ignorePatterns", []);
+    __publicField(this, "instrumentPatterns", []);
+    __publicField(this, "enabled", true);
+    this.enabled = config.instrumentation.enabled;
+    this.ignorePatterns = config.instrumentation.ignore_patterns.map((p) => this.compilePattern(p));
+    this.instrumentPatterns = config.instrumentation.instrument_patterns.filter((p) => p.enabled !== false).map((p) => this.compilePattern(p));
+  }
+  /**
+   * Compile a pattern configuration into a RegExp
+   */
+  compilePattern(pattern) {
+    try {
+      const compiled = {
+        regex: new RegExp(pattern.pattern),
+        enabled: pattern.enabled !== false
+      };
+      if (pattern.description !== void 0) {
+        compiled.description = pattern.description;
+      }
+      return compiled;
+    } catch (error) {
+      throw new Error(
+        `Failed to compile pattern "${pattern.pattern}": ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+  /**
+   * Check if a span should be instrumented
+   *
+   * Returns true if the span should be created, false otherwise.
+   *
+   * Logic:
+   * 1. If instrumentation disabled globally, return false
+   * 2. Check ignore patterns - if any match, return false
+   * 3. Check instrument patterns - if any match, return true
+   * 4. Default: return true (fail-open - create span if no patterns match)
+   */
+  shouldInstrument(spanName) {
+    if (!this.enabled) {
+      return false;
+    }
+    for (const pattern of this.ignorePatterns) {
+      if (pattern.regex.test(spanName)) {
+        return false;
+      }
+    }
+    for (const pattern of this.instrumentPatterns) {
+      if (pattern.enabled && pattern.regex.test(spanName)) {
+        return true;
+      }
+    }
+    return true;
+  }
+  /**
+   * Get statistics about pattern matching (for debugging/monitoring)
+   */
+  getStats() {
+    return {
+      enabled: this.enabled,
+      ignorePatternCount: this.ignorePatterns.length,
+      instrumentPatternCount: this.instrumentPatterns.filter((p) => p.enabled).length
+    };
+  }
+};
+function initializePatternMatcher(config) {
+  new PatternMatcher(config);
+}
+var Logger = class {
+  constructor() {
+    __publicField(this, "level", "on");
+    __publicField(this, "hasLoggedMinimal", false);
+  }
+  /**
+   * Set the logging level
+   */
+  setLevel(level) {
+    this.level = level;
+    this.hasLoggedMinimal = false;
+  }
+  /**
+   * Get the current logging level
+   */
+  getLevel() {
+    return this.level;
+  }
+  /**
+   * Log a minimal initialization message (only shown once in minimal mode)
+   */
+  minimal(message) {
+    if (this.level === "off") {
+      return;
+    }
+    if (this.level === "minimal" && !this.hasLoggedMinimal) {
+      console.log(message);
+      this.hasLoggedMinimal = true;
+      return;
+    }
+    if (this.level === "on") {
+      console.log(message);
+    }
+  }
+  /**
+   * Log an informational message
+   */
+  log(...args) {
+    if (this.level === "on") {
+      console.log(...args);
+    }
+  }
+  /**
+   * Log a warning message (shown in minimal mode)
+   */
+  warn(...args) {
+    if (this.level !== "off") {
+      console.warn(...args);
+    }
+  }
+  /**
+   * Log an error message (shown in minimal mode)
+   */
+  error(...args) {
+    if (this.level !== "off") {
+      console.error(...args);
+    }
+  }
+  /**
+   * Check if full logging is enabled
+   */
+  isEnabled() {
+    return this.level === "on";
+  }
+  /**
+   * Check if minimal logging is enabled
+   */
+  isMinimal() {
+    return this.level === "minimal";
+  }
+  /**
+   * Check if logging is completely disabled
+   */
+  isDisabled() {
+    return this.level === "off";
+  }
+};
+var logger = new Logger();
+async function loadFromFile(filePath) {
+  const { readFile } = await import('fs/promises');
+  const content = await readFile(filePath, "utf-8");
+  return parseAndValidateConfig(content);
+}
+async function loadFromUrl(url) {
+  const response = await fetch(url);
+  if (!response.ok) {
+    throw new Error(`Failed to fetch config from ${url}: ${response.statusText}`);
+  }
+  const content = await response.text();
+  return parseAndValidateConfig(content);
+}
+async function loadConfig(uri, _options) {
+  if (uri.startsWith("http://") || uri.startsWith("https://")) {
+    return loadFromUrl(uri);
+  }
+  if (uri.startsWith("file://")) {
+    const filePath = uri.slice(7);
+    return loadFromFile(filePath);
+  }
+  return loadFromFile(uri);
+}
+async function loadConfigFromInline(content) {
+  return parseAndValidateConfig(content);
+}
+async function loadConfigWithOptions(options = {}) {
+  if (options.config) {
+    return loadConfigFromInline(options.config);
+  }
+  const envConfigPath = process.env.ATRIM_INSTRUMENTATION_CONFIG;
+  if (envConfigPath) {
+    return loadConfig(envConfigPath);
+  }
+  if (options.configUrl) {
+    return loadConfig(options.configUrl);
+  }
+  if (options.configPath) {
+    return loadConfig(options.configPath);
+  }
+  const { existsSync } = await import('fs');
+  const { join } = await import('path');
+  const defaultPath = join(process.cwd(), "instrumentation.yaml");
+  if (existsSync(defaultPath)) {
+    return loadConfig(defaultPath);
+  }
+  return defaultConfig;
+}
+
+// src/integrations/effect/effect-tracer.ts
+var SDK_NAME = "@effect/opentelemetry";
+var ATTR_TELEMETRY_EXPORTER_MODE = "telemetry.exporter.mode";
+function createEffectInstrumentation(options = {}) {
+  return effect.Layer.unwrapEffect(
+    effect.Effect.gen(function* () {
+      const config = yield* effect.Effect.tryPromise({
+        try: () => loadConfigWithOptions(options),
+        catch: (error) => ({
+          _tag: "ConfigError",
+          message: error instanceof Error ? error.message : String(error)
+        })
+      });
+      const effectEnabled = process.env.OTEL_EFFECT_ENABLED !== "false" && (config.effect?.enabled ?? true);
+      if (!effectEnabled) {
+        logger.log("@atrim/instrumentation/effect: Effect tracing disabled via config");
+        return effect.Layer.empty;
+      }
+      yield* effect.Effect.sync(() => {
+        const loggingLevel = config.instrumentation.logging || "on";
+        logger.setLevel(loggingLevel);
+      });
+      yield* effect.Effect.sync(() => initializePatternMatcher(config));
+      const serviceName = options.serviceName || process.env.OTEL_SERVICE_NAME || "effect-service";
+      const serviceVersion = options.serviceVersion || process.env.npm_package_version || "1.0.0";
+      const exporterMode = options.exporterMode ?? config.effect?.exporter ?? "unified";
+      const resourceAttributes = {
+        "platform.component": "effect",
+        [semanticConventions.ATTR_TELEMETRY_SDK_LANGUAGE]: semanticConventions.TELEMETRY_SDK_LANGUAGE_VALUE_NODEJS,
+        [semanticConventions.ATTR_TELEMETRY_SDK_NAME]: SDK_NAME,
+        [ATTR_TELEMETRY_EXPORTER_MODE]: exporterMode
+      };
+      if (exporterMode === "standalone") {
+        const otlpEndpoint = options.otlpEndpoint || process.env.OTEL_EXPORTER_OTLP_ENDPOINT || "http://localhost:4318";
+        logger.log("Effect OpenTelemetry instrumentation (standalone)");
+        logger.log(`  Service: ${serviceName}`);
+        logger.log(`  Endpoint: ${otlpEndpoint}`);
+        logger.log("  WARNING: Standalone mode bypasses Node SDK filtering");
+        return Otlp__namespace.layer({
+          baseUrl: otlpEndpoint,
+          resource: {
+            serviceName,
+            serviceVersion,
+            attributes: resourceAttributes
+          },
+          // Bridge Effect context to OpenTelemetry global context
+          tracerContext: (f, span) => {
+            if (span._tag !== "Span") {
+              return f();
+            }
+            const spanContext = {
+              traceId: span.traceId,
+              spanId: span.spanId,
+              traceFlags: span.sampled ? api.TraceFlags.SAMPLED : api.TraceFlags.NONE
+            };
+            const otelSpan = api.trace.wrapSpanContext(spanContext);
+            return api.context.with(api.trace.setSpan(api.context.active(), otelSpan), f);
+          }
+        }).pipe(effect.Layer.provide(platform.FetchHttpClient.layer));
+      } else {
+        logger.log("Effect OpenTelemetry instrumentation (unified)");
+        logger.log(`  Service: ${serviceName}`);
+        logger.log("  Using global TracerProvider for span export");
+        return Tracer__namespace.layerGlobal.pipe(
+          effect.Layer.provide(
+            Resource__namespace.layer({
+              serviceName,
+              serviceVersion,
+              attributes: resourceAttributes
+            })
+          )
+        );
+      }
+    })
+  ).pipe(effect.Layer.orDie);
+}
+var EffectInstrumentationLive = effect.Effect.sync(() => {
+  const serviceName = process.env.OTEL_SERVICE_NAME || "effect-service";
+  const serviceVersion = process.env.npm_package_version || "1.0.0";
+  logger.minimal(`@atrim/instrumentation/effect: Effect tracing enabled (${serviceName})`);
+  logger.log("Effect OpenTelemetry tracer (unified)");
+  logger.log(`  Service: ${serviceName}`);
+  return Tracer__namespace.layerGlobal.pipe(
+    effect.Layer.provide(
+      Resource__namespace.layer({
+        serviceName,
+        serviceVersion,
+        attributes: {
+          "platform.component": "effect",
+          [semanticConventions.ATTR_TELEMETRY_SDK_LANGUAGE]: semanticConventions.TELEMETRY_SDK_LANGUAGE_VALUE_NODEJS,
+          [semanticConventions.ATTR_TELEMETRY_SDK_NAME]: SDK_NAME,
+          [ATTR_TELEMETRY_EXPORTER_MODE]: "unified"
+        }
+      })
+    )
+  );
+}).pipe(effect.Layer.unwrapEffect);
+function annotateUser(userId, email, username) {
+  const attributes = {
+    "user.id": userId
+  };
+  if (email) attributes["user.email"] = email;
+  if (username) attributes["user.name"] = username;
+  return effect.Effect.annotateCurrentSpan(attributes);
+}
+function annotateDataSize(bytes, items, compressionRatio) {
+  const attributes = {
+    "data.size.bytes": bytes,
+    "data.size.items": items
+  };
+  if (compressionRatio !== void 0) {
+    attributes["data.compression.ratio"] = compressionRatio;
+  }
+  return effect.Effect.annotateCurrentSpan(attributes);
+}
+function annotateBatch(totalItems, batchSize, successCount, failureCount) {
+  const attributes = {
+    "batch.size": batchSize,
+    "batch.total_items": totalItems,
+    "batch.count": Math.ceil(totalItems / batchSize)
+  };
+  if (successCount !== void 0) {
+    attributes["batch.success_count"] = successCount;
+  }
+  if (failureCount !== void 0) {
+    attributes["batch.failure_count"] = failureCount;
+  }
+  return effect.Effect.annotateCurrentSpan(attributes);
+}
+function annotateLLM(model, provider, tokens) {
+  const attributes = {
+    "llm.model": model,
+    "llm.provider": provider
+  };
+  if (tokens) {
+    if (tokens.prompt !== void 0) attributes["llm.tokens.prompt"] = tokens.prompt;
+    if (tokens.completion !== void 0) attributes["llm.tokens.completion"] = tokens.completion;
+    if (tokens.total !== void 0) attributes["llm.tokens.total"] = tokens.total;
+  }
+  return effect.Effect.annotateCurrentSpan(attributes);
+}
+function annotateQuery(query, duration, rowCount, database) {
+  const attributes = {
+    "db.statement": query.length > 1e3 ? query.substring(0, 1e3) + "..." : query
+  };
+  if (duration !== void 0) attributes["db.duration.ms"] = duration;
+  if (rowCount !== void 0) attributes["db.row_count"] = rowCount;
+  if (database) attributes["db.name"] = database;
+  return effect.Effect.annotateCurrentSpan(attributes);
+}
+function annotateHttpRequest(method, url, statusCode, contentLength) {
+  const attributes = {
+    "http.method": method,
+    "http.url": url
+  };
+  if (statusCode !== void 0) attributes["http.status_code"] = statusCode;
+  if (contentLength !== void 0) attributes["http.response.content_length"] = contentLength;
+  return effect.Effect.annotateCurrentSpan(attributes);
+}
+function annotateError(error, recoverable, errorType) {
+  const errorMessage = typeof error === "string" ? error : error.message;
+  const errorStack = typeof error === "string" ? void 0 : error.stack;
+  const attributes = {
+    "error.message": errorMessage,
+    "error.recoverable": recoverable
+  };
+  if (errorType) attributes["error.type"] = errorType;
+  if (errorStack) attributes["error.stack"] = errorStack;
+  return effect.Effect.annotateCurrentSpan(attributes);
+}
+function annotatePriority(priority, reason) {
+  const attributes = {
+    "operation.priority": priority
+  };
+  if (reason) attributes["operation.priority.reason"] = reason;
+  return effect.Effect.annotateCurrentSpan(attributes);
+}
+function annotateCache(hit, key, ttl) {
+  const attributes = {
+    "cache.hit": hit,
+    "cache.key": key
+  };
+  if (ttl !== void 0) attributes["cache.ttl.seconds"] = ttl;
+  return effect.Effect.annotateCurrentSpan(attributes);
+}
+function extractEffectMetadata() {
+  return effect.Effect.gen(function* () {
+    const metadata = {};
+    const currentFiber = effect.Fiber.getCurrentFiber();
+    if (effect.Option.isSome(currentFiber)) {
+      const fiber = currentFiber.value;
+      const fiberId = fiber.id();
+      metadata["effect.fiber.id"] = effect.FiberId.threadName(fiberId);
+      const status = yield* effect.Fiber.status(fiber);
+      if (status._tag) {
+        metadata["effect.fiber.status"] = status._tag;
+      }
+    }
+    const parentSpanResult = yield* effect.Effect.currentSpan.pipe(
+      effect.Effect.option
+      // Convert NoSuchElementException to Option
+    );
+    if (effect.Option.isSome(parentSpanResult)) {
+      const parentSpan = parentSpanResult.value;
+      metadata["effect.operation.nested"] = true;
+      metadata["effect.operation.root"] = false;
+      if (parentSpan.spanId) {
+        metadata["effect.parent.span.id"] = parentSpan.spanId;
+      }
+      if (parentSpan.name) {
+        metadata["effect.parent.span.name"] = parentSpan.name;
+      }
+      if (parentSpan.traceId) {
+        metadata["effect.parent.trace.id"] = parentSpan.traceId;
+      }
+    } else {
+      metadata["effect.operation.nested"] = false;
+      metadata["effect.operation.root"] = true;
+    }
+    return metadata;
+  });
+}
+function autoEnrichSpan() {
+  return effect.Effect.gen(function* () {
+    const metadata = yield* extractEffectMetadata();
+    yield* effect.Effect.annotateCurrentSpan(metadata);
+  });
+}
+function withAutoEnrichedSpan(spanName, options) {
+  return (self) => {
+    return effect.Effect.gen(function* () {
+      yield* autoEnrichSpan();
+      return yield* self;
+    }).pipe(effect.Effect.withSpan(spanName, options));
+  };
+}
+var createLogicalParentLink = (parentSpan, useSpanLinks) => {
+  if (!useSpanLinks) {
+    return [];
+  }
+  return [
+    {
+      _tag: "SpanLink",
+      span: parentSpan,
+      attributes: {
+        "link.type": "logical_parent",
+        "atrim.relationship": "spawned_by",
+        description: "Logical parent (isolated to prevent context leakage)"
+      }
+    }
+  ];
+};
+var createLogicalParentAttributes = (parentSpan, useAttributes, category, useSpanLinks, customAttributes) => {
+  if (!useAttributes) {
+    return customAttributes;
+  }
+  return {
+    // Logical parent tracking (works in ALL tools)
+    "atrim.logical_parent.span_id": parentSpan.spanId,
+    "atrim.logical_parent.trace_id": parentSpan.traceId,
+    "atrim.logical_parent.name": parentSpan._tag === "Span" ? parentSpan.name : "external",
+    // Categorization and metadata
+    "atrim.fiberset.isolated": true,
+    "atrim.span.category": category,
+    "atrim.has_logical_parent": true,
+    "atrim.isolation.method": useSpanLinks ? "hybrid" : "attributes_only",
+    // User-provided attributes
+    ...customAttributes
+  };
+};
+var runIsolated = (set, effect$1, name, options) => {
+  const {
+    createRoot = true,
+    captureLogicalParent = true,
+    useSpanLinks = true,
+    useAttributes = true,
+    propagateInterruption,
+    attributes = {},
+    category = "background_task"
+  } = options ?? {};
+  if (!createRoot && !captureLogicalParent) {
+    return effect.FiberSet.run(set, effect$1, { propagateInterruption });
+  }
+  return effect.Effect.gen(function* () {
+    const maybeParent = yield* effect.Effect.serviceOption(effect.Tracer.ParentSpan);
+    if (maybeParent._tag === "None" || !captureLogicalParent) {
+      const isolated2 = effect$1.pipe(
+        effect.Effect.withSpan(name, {
+          root: createRoot,
+          attributes: {
+            "atrim.fiberset.isolated": createRoot,
+            "atrim.span.category": category,
+            "atrim.has_logical_parent": false,
+            ...attributes
+          }
+        })
+      );
+      return yield* effect.FiberSet.run(set, isolated2, { propagateInterruption });
+    }
+    const parent = maybeParent.value;
+    const links = createLogicalParentLink(parent, useSpanLinks);
+    const spanAttributes = createLogicalParentAttributes(
+      parent,
+      useAttributes,
+      category,
+      useSpanLinks,
+      attributes
+    );
+    const isolated = effect$1.pipe(
+      effect.Effect.withSpan(name, {
+        root: createRoot,
+        links: links.length > 0 ? links : void 0,
+        attributes: spanAttributes
+      })
+    );
+    return yield* effect.FiberSet.run(set, isolated, { propagateInterruption });
+  });
+};
+var runWithSpan = (set, name, effect, options) => {
+  return runIsolated(set, effect, name, {
+    createRoot: true,
+    captureLogicalParent: true,
+    useSpanLinks: true,
+    useAttributes: true,
+    ...options
+  });
+};
+var annotateSpawnedTasks = (tasks) => {
+  return effect.Effect.annotateCurrentSpan({
+    "atrim.fiberset.spawned_count": tasks.length,
+    "atrim.fiberset.task_names": tasks.map((t) => t.name).join(","),
+    "atrim.has_background_tasks": true,
+    "atrim.spawned_tasks": JSON.stringify(
+      tasks.map((t) => ({
+        name: t.name,
+        ...t.spanId && { span_id: t.spanId },
+        ...t.category && { category: t.category }
+      }))
+    )
+  });
+};
+var FiberSet = {
+  // Re-export all original FiberSet functions
+  make: effect.FiberSet.make,
+  add: effect.FiberSet.add,
+  unsafeAdd: effect.FiberSet.unsafeAdd,
+  run: effect.FiberSet.run,
+  clear: effect.FiberSet.clear,
+  join: effect.FiberSet.join,
+  awaitEmpty: effect.FiberSet.awaitEmpty,
+  size: effect.FiberSet.size,
+  runtime: effect.FiberSet.runtime,
+  runtimePromise: effect.FiberSet.runtimePromise,
+  makeRuntime: effect.FiberSet.makeRuntime,
+  makeRuntimePromise: effect.FiberSet.makeRuntimePromise,
+  isFiberSet: effect.FiberSet.isFiberSet,
+  // Add our isolation helpers
+  runIsolated,
+  runWithSpan
+};
+
+exports.EffectInstrumentationLive = EffectInstrumentationLive;
+exports.FiberSet = FiberSet;
+exports.annotateBatch = annotateBatch;
+exports.annotateCache = annotateCache;
+exports.annotateDataSize = annotateDataSize;
+exports.annotateError = annotateError;
+exports.annotateHttpRequest = annotateHttpRequest;
+exports.annotateLLM = annotateLLM;
+exports.annotatePriority = annotatePriority;
+exports.annotateQuery = annotateQuery;
+exports.annotateSpawnedTasks = annotateSpawnedTasks;
+exports.annotateUser = annotateUser;
+exports.autoEnrichSpan = autoEnrichSpan;
+exports.createEffectInstrumentation = createEffectInstrumentation;
+exports.extractEffectMetadata = extractEffectMetadata;
+exports.runIsolated = runIsolated;
+exports.runWithSpan = runWithSpan;
+exports.withAutoEnrichedSpan = withAutoEnrichedSpan;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map