@raccoon.ninja/otel-react 0.0.1

package/dist/native/index.cjs

@@ -0,0 +1,215 @@
+'use strict';
+
+var api = require('@opentelemetry/api');
+var sdkTraceBase = require('@opentelemetry/sdk-trace-base');
+var exporterTraceOtlpHttp = require('@opentelemetry/exporter-trace-otlp-http');
+var apiLogs = require('@opentelemetry/api-logs');
+var resources = require('@opentelemetry/resources');
+var semanticConventions = require('@opentelemetry/semantic-conventions');
+var sdkLogs = require('@opentelemetry/sdk-logs');
+var exporterLogsOtlpHttp = require('@opentelemetry/exporter-logs-otlp-http');
+var sdkMetrics = require('@opentelemetry/sdk-metrics');
+var exporterMetricsOtlpHttp = require('@opentelemetry/exporter-metrics-otlp-http');
+
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/core/options.ts
+var DEFAULT_ENDPOINT = "http://localhost:4318";
+var DEFAULT_EXPORT_TIMEOUT = 3e4;
+function resolveEndpoint(options) {
+  return options.endpoint ?? DEFAULT_ENDPOINT;
+}
+function resolveExportTimeout(options) {
+  return options.exportTimeout ?? DEFAULT_EXPORT_TIMEOUT;
+}
+function validateOptions(options) {
+  if (!options.serviceName || typeof options.serviceName !== "string") {
+    throw new Error(
+      "[@raccoon.ninja/otel-react] serviceName is required and must be a non-empty string."
+    );
+  }
+  if (options.serviceName.trim() !== options.serviceName) {
+    throw new Error(
+      "[@raccoon.ninja/otel-react] serviceName must not have leading or trailing whitespace."
+    );
+  }
+  if (options.endpoint !== void 0) {
+    if (typeof options.endpoint !== "string" || options.endpoint.trim() === "") {
+      throw new Error(
+        "[@raccoon.ninja/otel-react] endpoint must be a non-empty string when provided."
+      );
+    }
+  }
+  if (options.exportTimeout !== void 0) {
+    if (typeof options.exportTimeout !== "number" || options.exportTimeout <= 0) {
+      throw new Error(
+        "[@raccoon.ninja/otel-react] exportTimeout must be a positive number when provided."
+      );
+    }
+  }
+}
+var SDK_NAME = "@raccoon.ninja/otel-react";
+var SDK_VERSION = "0.0.1";
+function buildResource(options) {
+  const attributes = {
+    [semanticConventions.ATTR_SERVICE_NAME]: options.serviceName,
+    "telemetry.sdk.name": SDK_NAME,
+    "telemetry.sdk.version": SDK_VERSION,
+    "telemetry.sdk.language": "webjs"
+  };
+  if (options.serviceVersion) {
+    attributes[semanticConventions.ATTR_SERVICE_VERSION] = options.serviceVersion;
+  }
+  if (options.environment) {
+    attributes[semanticConventions.SEMRESATTRS_DEPLOYMENT_ENVIRONMENT] = options.environment;
+  }
+  if (typeof navigator !== "undefined") {
+    if (navigator.language) {
+      attributes["browser.language"] = navigator.language;
+    }
+    if (navigator.userAgent) {
+      attributes["browser.user_agent"] = navigator.userAgent;
+    }
+    if (navigator.platform) {
+      attributes["browser.platform"] = navigator.platform;
+    }
+  }
+  if (options.resourceAttributes) {
+    Object.assign(attributes, options.resourceAttributes);
+  }
+  return resources.resourceFromAttributes(attributes);
+}
+function createLoggerProvider(options, resource) {
+  const endpoint = resolveEndpoint(options);
+  const timeout = resolveExportTimeout(options);
+  const exporter = new exporterLogsOtlpHttp.OTLPLogExporter({
+    url: `${endpoint}/v1/logs`,
+    headers: options.headers,
+    timeoutMillis: timeout
+  });
+  const provider = new sdkLogs.LoggerProvider({ resource });
+  provider.addLogRecordProcessor(new sdkLogs.BatchLogRecordProcessor(exporter));
+  apiLogs.logs.setGlobalLoggerProvider(provider);
+  return provider;
+}
+var METRIC_EXPORT_INTERVAL_MS = 3e4;
+function createMeterProvider(options, resource) {
+  const endpoint = resolveEndpoint(options);
+  const timeout = resolveExportTimeout(options);
+  const exporter = new exporterMetricsOtlpHttp.OTLPMetricExporter({
+    url: `${endpoint}/v1/metrics`,
+    headers: options.headers,
+    timeoutMillis: timeout
+  });
+  const provider = new sdkMetrics.MeterProvider({
+    resource,
+    readers: [
+      new sdkMetrics.PeriodicExportingMetricReader({
+        exporter,
+        exportIntervalMillis: METRIC_EXPORT_INTERVAL_MS
+      })
+    ]
+  });
+  api.metrics.setGlobalMeterProvider(provider);
+  return provider;
+}
+
+// src/native/init.ts
+var initialized = false;
+async function initOtelNative(options) {
+  if (initialized) {
+    console.warn(
+      "[@raccoon.ninja/otel-react] initOtelNative() has already been called. Skipping."
+    );
+    return {
+      shutdown: async () => {
+      }
+    };
+  }
+  validateOptions(options);
+  const resource = buildResource(options);
+  const endpoint = resolveEndpoint(options);
+  const timeout = resolveExportTimeout(options);
+  const traceExporter = new exporterTraceOtlpHttp.OTLPTraceExporter({
+    url: `${endpoint}/v1/traces`,
+    headers: options.headers,
+    timeoutMillis: timeout
+  });
+  const tracerProvider = new sdkTraceBase.BasicTracerProvider({
+    resource,
+    spanProcessors: [new sdkTraceBase.BatchSpanProcessor(traceExporter)]
+  });
+  api.trace.setGlobalTracerProvider(tracerProvider);
+  const loggerProvider = createLoggerProvider(options, resource);
+  const meterProvider = createMeterProvider(options, resource);
+  let appStateSubscription = null;
+  try {
+    const { AppState } = __require("react-native");
+    appStateSubscription = AppState.addEventListener("change", (nextState) => {
+      if (nextState === "background" || nextState === "inactive") {
+        tracerProvider.forceFlush();
+        loggerProvider.forceFlush();
+        meterProvider.forceFlush();
+      }
+    });
+  } catch {
+  }
+  const logger = loggerProvider.getLogger("@raccoon.ninja/otel-react", "1.0.0");
+  logger.emit({
+    severityNumber: apiLogs.SeverityNumber.INFO,
+    severityText: "INFO",
+    body: `OpenTelemetry (RN) initialized for service "${options.serviceName}"`
+  });
+  initialized = true;
+  return {
+    shutdown: async () => {
+      appStateSubscription?.remove();
+      await Promise.all([
+        tracerProvider.forceFlush(),
+        loggerProvider.forceFlush(),
+        meterProvider.forceFlush()
+      ]);
+      await Promise.all([
+        tracerProvider.shutdown(),
+        loggerProvider.shutdown(),
+        meterProvider.shutdown()
+      ]);
+      initialized = false;
+    }
+  };
+}
+var TRACER_NAME = "@raccoon.ninja/otel-react/react-navigation";
+function withReactNavigation() {
+  return () => {
+    api.trace.getTracer(TRACER_NAME, "1.0.0");
+  };
+}
+function createNavigationTracker() {
+  const tracer = api.trace.getTracer(TRACER_NAME, "1.0.0");
+  let previousRouteName;
+  return (state) => {
+    if (!state) return;
+    const currentRoute = state.routes[state.index];
+    if (!currentRoute) return;
+    const currentRouteName = currentRoute.name;
+    if (previousRouteName && previousRouteName !== currentRouteName) {
+      const span = tracer.startSpan("navigation.route_change");
+      span.setAttribute("navigation.from", previousRouteName);
+      span.setAttribute("navigation.to", currentRouteName);
+      span.setStatus({ code: api.SpanStatusCode.OK });
+      span.end();
+    }
+    previousRouteName = currentRouteName;
+  };
+}
+
+exports.createNavigationTracker = createNavigationTracker;
+exports.initOtel = initOtelNative;
+exports.withReactNavigation = withReactNavigation;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/native/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/options.ts","../../src/core/resource.ts","../../src/providers/logger.ts","../../src/providers/meter.ts","../../src/native/init.ts","../../src/native/navigation.ts"],"names":["ATTR_SERVICE_NAME","ATTR_SERVICE_VERSION","SEMRESATTRS_DEPLOYMENT_ENVIRONMENT","resourceFromAttributes","OTLPLogExporter","LoggerProvider","BatchLogRecordProcessor","logs","OTLPMetricExporter","MeterProvider","PeriodicExportingMetricReader","metrics","OTLPTraceExporter","BasicTracerProvider","BatchSpanProcessor","trace","SeverityNumber","SpanStatusCode"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { WebTracerProvider } from '@opentelemetry/sdk-trace-web';\nimport type { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';\n\n/** Configuration for enabling/disabling specific auto-instrumentations. */\nexport interface InstrumentationConfig {\n  /** Auto-instrument fetch() calls. Default: true */\n  fetch?: boolean;\n  /** Auto-instrument XMLHttpRequest. Default: true */\n  xhr?: boolean;\n  /** Document load timing spans. Default: true */\n  documentLoad?: boolean;\n  /** Click/input interaction spans. Default: true */\n  userInteraction?: boolean;\n  /** LCP, CLS, INP, TTFB, FCP metrics. Default: true */\n  webVitals?: boolean;\n}\n\n/** Extension function type for opt-in instrumentations (e.g., withReactRouter). */\nexport type OtelExtension = (context: ExtensionContext) => void;\n\n/** Context provided to extension functions during initialization. */\nexport interface ExtensionContext {\n  tracerProvider: WebTracerProvider;\n}\n\n/** Configuration options for initOtel(). */\nexport interface OtelOptions {\n  /** Required. Sets the service.name resource attribute. */\n  serviceName: string;\n\n  /** OTLP HTTP endpoint. Default: 'http://localhost:4318' */\n  endpoint?: string;\n\n  /** Additional OTel resource attributes. */\n  resourceAttributes?: Record<string, string>;\n\n  /** Service version. Sets service.version resource attribute. */\n  serviceVersion?: string;\n\n  /** Deployment environment. Sets deployment.environment resource attribute. */\n  environment?: string;\n\n  /** Enable/disable specific auto-instrumentations. All enabled by default. */\n  instrumentations?: InstrumentationConfig;\n\n  /** Escape hatch: configure the TracerProvider before it's registered. */\n  configureTracing?: (provider: WebTracerProvider) => void;\n\n  /** Escape hatch: configure the OTLP exporter. */\n  configureExporter?: (exporter: OTLPTraceExporter) => void;\n\n  /** Custom headers sent with OTLP export requests (e.g., auth tokens). */\n  headers?: Record<string, string>;\n\n  /** Export timeout in milliseconds. Default: 30000 */\n  exportTimeout?: number;\n\n  /**\n   * URLs to exclude from fetch/XHR instrumentation.\n   * Supports string patterns or RegExp.\n   */\n  ignoreUrls?: Array<string | RegExp>;\n\n  /** Extension functions for opt-in instrumentations. */\n  extensions?: OtelExtension[];\n}\n\n/** Handle returned from initOtel() for lifecycle management. */\nexport interface OtelHandle {\n  /** Flush all pending telemetry and shut down providers. */\n  shutdown: () => Promise<void>;\n}\n\nconst DEFAULT_ENDPOINT = 'http://localhost:4318';\nconst DEFAULT_EXPORT_TIMEOUT = 30000;\n\nexport function resolveEndpoint(options: OtelOptions): string {\n  return options.endpoint ?? DEFAULT_ENDPOINT;\n}\n\nexport function resolveExportTimeout(options: OtelOptions): number {\n  return options.exportTimeout ?? DEFAULT_EXPORT_TIMEOUT;\n}\n\nexport function resolveInstrumentations(options: OtelOptions): Required<InstrumentationConfig> {\n  return {\n    fetch: options.instrumentations?.fetch ?? true,\n    xhr: options.instrumentations?.xhr ?? true,\n    documentLoad: options.instrumentations?.documentLoad ?? true,\n    userInteraction: options.instrumentations?.userInteraction ?? true,\n    webVitals: options.instrumentations?.webVitals ?? true,\n  };\n}\n\nexport function validateOptions(options: OtelOptions): void {\n  if (!options.serviceName || typeof options.serviceName !== 'string') {\n    throw new Error(\n      '[@raccoon.ninja/otel-react] serviceName is required and must be a non-empty string.',\n    );\n  }\n\n  if (options.serviceName.trim() !== options.serviceName) {\n    throw new Error(\n      '[@raccoon.ninja/otel-react] serviceName must not have leading or trailing whitespace.',\n    );\n  }\n\n  if (options.endpoint !== undefined) {\n    if (typeof options.endpoint !== 'string' || options.endpoint.trim() === '') {\n      throw new Error(\n        '[@raccoon.ninja/otel-react] endpoint must be a non-empty string when provided.',\n      );\n    }\n  }\n\n  if (options.exportTimeout !== undefined) {\n    if (typeof options.exportTimeout !== 'number' || options.exportTimeout <= 0) {\n      throw new Error(\n        '[@raccoon.ninja/otel-react] exportTimeout must be a positive number when provided.',\n      );\n    }\n  }\n}\n","import { resourceFromAttributes } from '@opentelemetry/resources';\nimport {\n  ATTR_SERVICE_NAME,\n  ATTR_SERVICE_VERSION,\n  SEMRESATTRS_DEPLOYMENT_ENVIRONMENT,\n} from '@opentelemetry/semantic-conventions';\nimport type { OtelOptions } from './options';\n\nconst SDK_NAME = '@raccoon.ninja/otel-react';\nconst SDK_VERSION = '0.0.1';\n\nexport function buildResource(options: OtelOptions) {\n  const attributes: Record<string, string> = {\n    [ATTR_SERVICE_NAME]: options.serviceName,\n    'telemetry.sdk.name': SDK_NAME,\n    'telemetry.sdk.version': SDK_VERSION,\n    'telemetry.sdk.language': 'webjs',\n  };\n\n  if (options.serviceVersion) {\n    attributes[ATTR_SERVICE_VERSION] = options.serviceVersion;\n  }\n\n  if (options.environment) {\n    attributes[SEMRESATTRS_DEPLOYMENT_ENVIRONMENT] = options.environment;\n  }\n\n  if (typeof navigator !== 'undefined') {\n    if (navigator.language) {\n      attributes['browser.language'] = navigator.language;\n    }\n    if (navigator.userAgent) {\n      attributes['browser.user_agent'] = navigator.userAgent;\n    }\n    if (navigator.platform) {\n      attributes['browser.platform'] = navigator.platform;\n    }\n  }\n\n  if (options.resourceAttributes) {\n    Object.assign(attributes, options.resourceAttributes);\n  }\n\n  return resourceFromAttributes(attributes);\n}\n","import { LoggerProvider, BatchLogRecordProcessor } from '@opentelemetry/sdk-logs';\nimport { OTLPLogExporter } from '@opentelemetry/exporter-logs-otlp-http';\nimport { logs } from '@opentelemetry/api-logs';\nimport type { Resource } from '@opentelemetry/resources';\nimport type { OtelOptions } from '../core/options';\nimport { resolveEndpoint, resolveExportTimeout } from '../core/options';\n\nexport function createLoggerProvider(options: OtelOptions, resource: Resource): LoggerProvider {\n  const endpoint = resolveEndpoint(options);\n  const timeout = resolveExportTimeout(options);\n\n  const exporter = new OTLPLogExporter({\n    url: `${endpoint}/v1/logs`,\n    headers: options.headers,\n    timeoutMillis: timeout,\n  });\n\n  const provider = new LoggerProvider({ resource });\n  provider.addLogRecordProcessor(new BatchLogRecordProcessor(exporter));\n\n  logs.setGlobalLoggerProvider(provider);\n\n  return provider;\n}\n","import { MeterProvider, PeriodicExportingMetricReader } from '@opentelemetry/sdk-metrics';\nimport { OTLPMetricExporter } from '@opentelemetry/exporter-metrics-otlp-http';\nimport { metrics } from '@opentelemetry/api';\nimport type { Resource } from '@opentelemetry/resources';\nimport type { OtelOptions } from '../core/options';\nimport { resolveEndpoint, resolveExportTimeout } from '../core/options';\n\nconst METRIC_EXPORT_INTERVAL_MS = 30_000;\n\nexport function createMeterProvider(options: OtelOptions, resource: Resource): MeterProvider {\n  const endpoint = resolveEndpoint(options);\n  const timeout = resolveExportTimeout(options);\n\n  const exporter = new OTLPMetricExporter({\n    url: `${endpoint}/v1/metrics`,\n    headers: options.headers,\n    timeoutMillis: timeout,\n  });\n\n  const provider = new MeterProvider({\n    resource,\n    readers: [\n      new PeriodicExportingMetricReader({\n        exporter,\n        exportIntervalMillis: METRIC_EXPORT_INTERVAL_MS,\n      }),\n    ],\n  });\n\n  metrics.setGlobalMeterProvider(provider);\n\n  return provider;\n}\n","import { trace } from '@opentelemetry/api';\nimport { BasicTracerProvider, BatchSpanProcessor } from '@opentelemetry/sdk-trace-base';\nimport { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';\nimport { SeverityNumber } from '@opentelemetry/api-logs';\nimport type { OtelOptions, OtelHandle } from '../core/options';\nimport {\n  validateOptions,\n  resolveEndpoint,\n  resolveExportTimeout,\n} from '../core/options';\nimport { buildResource } from '../core/resource';\nimport { createLoggerProvider } from '../providers/logger';\nimport { createMeterProvider } from '../providers/meter';\n\nlet initialized = false;\n\n/**\n * Initialize OpenTelemetry for React Native.\n *\n * Key differences from browser init:\n * - Uses BasicTracerProvider (sdk-trace-base) instead of WebTracerProvider\n * - Only fetch instrumentation enabled (no document-load, no user-interaction, no Web Vitals)\n * - XHR disabled by default to avoid duplicate spans (RN's fetch polyfills over XHR)\n * - Uses AppState for flush instead of visibilitychange\n */\nexport async function initOtelNative(options: OtelOptions): Promise<OtelHandle> {\n  if (initialized) {\n    console.warn(\n      '[@raccoon.ninja/otel-react] initOtelNative() has already been called. Skipping.',\n    );\n    return {\n      shutdown: async () => {\n        /* noop */\n      },\n    };\n  }\n\n  validateOptions(options);\n\n  const resource = buildResource(options);\n  const endpoint = resolveEndpoint(options);\n  const timeout = resolveExportTimeout(options);\n\n  const traceExporter = new OTLPTraceExporter({\n    url: `${endpoint}/v1/traces`,\n    headers: options.headers,\n    timeoutMillis: timeout,\n  });\n\n  const tracerProvider = new BasicTracerProvider({\n    resource,\n    spanProcessors: [new BatchSpanProcessor(traceExporter)],\n  });\n\n  // BasicTracerProvider doesn't have register(), use the API directly\n  trace.setGlobalTracerProvider(tracerProvider);\n\n  const loggerProvider = createLoggerProvider(options, resource);\n  const meterProvider = createMeterProvider(options, resource);\n\n  // Listen for AppState changes for flush (React Native)\n  let appStateSubscription: { remove: () => void } | null = null;\n  try {\n    // Dynamic import of AppState so this module doesn't crash in non-RN environments\n    // eslint-disable-next-line @typescript-eslint/no-require-imports\n    const { AppState } = require('react-native') as {\n      AppState: {\n        addEventListener: (\n          type: string,\n          handler: (state: string) => void,\n        ) => { remove: () => void };\n      };\n    };\n    appStateSubscription = AppState.addEventListener('change', (nextState: string) => {\n      if (nextState === 'background' || nextState === 'inactive') {\n        tracerProvider.forceFlush();\n        loggerProvider.forceFlush();\n        meterProvider.forceFlush();\n      }\n    });\n  } catch {\n    // AppState not available — skip\n  }\n\n  const logger = loggerProvider.getLogger('@raccoon.ninja/otel-react', '1.0.0');\n  logger.emit({\n    severityNumber: SeverityNumber.INFO,\n    severityText: 'INFO',\n    body: `OpenTelemetry (RN) initialized for service \"${options.serviceName}\"`,\n  });\n\n  initialized = true;\n\n  return {\n    shutdown: async () => {\n      appStateSubscription?.remove();\n      await Promise.all([\n        tracerProvider.forceFlush(),\n        loggerProvider.forceFlush(),\n        meterProvider.forceFlush(),\n      ]);\n      await Promise.all([\n        tracerProvider.shutdown(),\n        loggerProvider.shutdown(),\n        meterProvider.shutdown(),\n      ]);\n      initialized = false;\n    },\n  };\n}\n","import { trace, SpanStatusCode } from '@opentelemetry/api';\nimport type { OtelExtension } from '../core/options';\n\nconst TRACER_NAME = '@raccoon.ninja/otel-react/react-navigation';\n\n/**\n * Extension for React Navigation route-change tracing.\n *\n * This extension pre-registers the tracer scope. Actual navigation\n * tracking requires hooking into React Navigation's onStateChange\n * in the consuming app.\n *\n * @example\n * ```tsx\n * import { withReactNavigation, createNavigationTracker } from '@raccoon.ninja/otel-react/native';\n *\n * const otel = await initOtelNative({\n *   serviceName: 'my-rn-app',\n *   extensions: [withReactNavigation()],\n * });\n * ```\n */\nexport function withReactNavigation(): OtelExtension {\n  return () => {\n    trace.getTracer(TRACER_NAME, '1.0.0');\n  };\n}\n\n/**\n * Creates a navigation state change handler that records route changes as spans.\n *\n * @returns A function suitable for React Navigation's onStateChange prop.\n */\nexport function createNavigationTracker() {\n  const tracer = trace.getTracer(TRACER_NAME, '1.0.0');\n  let previousRouteName: string | undefined;\n\n  return (state: { routes: Array<{ name: string }>; index: number } | undefined) => {\n    if (!state) return;\n\n    const currentRoute = state.routes[state.index];\n    if (!currentRoute) return;\n\n    const currentRouteName = currentRoute.name;\n\n    if (previousRouteName && previousRouteName !== currentRouteName) {\n      const span = tracer.startSpan('navigation.route_change');\n      span.setAttribute('navigation.from', previousRouteName);\n      span.setAttribute('navigation.to', currentRouteName);\n      span.setStatus({ code: SpanStatusCode.OK });\n      span.end();\n    }\n\n    previousRouteName = currentRouteName;\n  };\n}\n"]}

package/dist/native/index.d.mts

@@ -0,0 +1,100 @@
+import { WebTracerProvider } from '@opentelemetry/sdk-trace-web';
+import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';
+
+/** Configuration for enabling/disabling specific auto-instrumentations. */
+interface InstrumentationConfig {
+    /** Auto-instrument fetch() calls. Default: true */
+    fetch?: boolean;
+    /** Auto-instrument XMLHttpRequest. Default: true */
+    xhr?: boolean;
+    /** Document load timing spans. Default: true */
+    documentLoad?: boolean;
+    /** Click/input interaction spans. Default: true */
+    userInteraction?: boolean;
+    /** LCP, CLS, INP, TTFB, FCP metrics. Default: true */
+    webVitals?: boolean;
+}
+/** Extension function type for opt-in instrumentations (e.g., withReactRouter). */
+type OtelExtension = (context: ExtensionContext) => void;
+/** Context provided to extension functions during initialization. */
+interface ExtensionContext {
+    tracerProvider: WebTracerProvider;
+}
+/** Configuration options for initOtel(). */
+interface OtelOptions {
+    /** Required. Sets the service.name resource attribute. */
+    serviceName: string;
+    /** OTLP HTTP endpoint. Default: 'http://localhost:4318' */
+    endpoint?: string;
+    /** Additional OTel resource attributes. */
+    resourceAttributes?: Record<string, string>;
+    /** Service version. Sets service.version resource attribute. */
+    serviceVersion?: string;
+    /** Deployment environment. Sets deployment.environment resource attribute. */
+    environment?: string;
+    /** Enable/disable specific auto-instrumentations. All enabled by default. */
+    instrumentations?: InstrumentationConfig;
+    /** Escape hatch: configure the TracerProvider before it's registered. */
+    configureTracing?: (provider: WebTracerProvider) => void;
+    /** Escape hatch: configure the OTLP exporter. */
+    configureExporter?: (exporter: OTLPTraceExporter) => void;
+    /** Custom headers sent with OTLP export requests (e.g., auth tokens). */
+    headers?: Record<string, string>;
+    /** Export timeout in milliseconds. Default: 30000 */
+    exportTimeout?: number;
+    /**
+     * URLs to exclude from fetch/XHR instrumentation.
+     * Supports string patterns or RegExp.
+     */
+    ignoreUrls?: Array<string | RegExp>;
+    /** Extension functions for opt-in instrumentations. */
+    extensions?: OtelExtension[];
+}
+/** Handle returned from initOtel() for lifecycle management. */
+interface OtelHandle {
+    /** Flush all pending telemetry and shut down providers. */
+    shutdown: () => Promise<void>;
+}
+
+/**
+ * Initialize OpenTelemetry for React Native.
+ *
+ * Key differences from browser init:
+ * - Uses BasicTracerProvider (sdk-trace-base) instead of WebTracerProvider
+ * - Only fetch instrumentation enabled (no document-load, no user-interaction, no Web Vitals)
+ * - XHR disabled by default to avoid duplicate spans (RN's fetch polyfills over XHR)
+ * - Uses AppState for flush instead of visibilitychange
+ */
+declare function initOtelNative(options: OtelOptions): Promise<OtelHandle>;
+
+/**
+ * Extension for React Navigation route-change tracing.
+ *
+ * This extension pre-registers the tracer scope. Actual navigation
+ * tracking requires hooking into React Navigation's onStateChange
+ * in the consuming app.
+ *
+ * @example
+ * ```tsx
+ * import { withReactNavigation, createNavigationTracker } from '@raccoon.ninja/otel-react/native';
+ *
+ * const otel = await initOtelNative({
+ *   serviceName: 'my-rn-app',
+ *   extensions: [withReactNavigation()],
+ * });
+ * ```
+ */
+declare function withReactNavigation(): OtelExtension;
+/**
+ * Creates a navigation state change handler that records route changes as spans.
+ *
+ * @returns A function suitable for React Navigation's onStateChange prop.
+ */
+declare function createNavigationTracker(): (state: {
+    routes: Array<{
+        name: string;
+    }>;
+    index: number;
+} | undefined) => void;
+
+export { type OtelExtension, type OtelHandle, type OtelOptions, createNavigationTracker, initOtelNative as initOtel, withReactNavigation };

package/dist/native/index.d.ts

@@ -0,0 +1,100 @@
+import { WebTracerProvider } from '@opentelemetry/sdk-trace-web';
+import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';
+
+/** Configuration for enabling/disabling specific auto-instrumentations. */
+interface InstrumentationConfig {
+    /** Auto-instrument fetch() calls. Default: true */
+    fetch?: boolean;
+    /** Auto-instrument XMLHttpRequest. Default: true */
+    xhr?: boolean;
+    /** Document load timing spans. Default: true */
+    documentLoad?: boolean;
+    /** Click/input interaction spans. Default: true */
+    userInteraction?: boolean;
+    /** LCP, CLS, INP, TTFB, FCP metrics. Default: true */
+    webVitals?: boolean;
+}
+/** Extension function type for opt-in instrumentations (e.g., withReactRouter). */
+type OtelExtension = (context: ExtensionContext) => void;
+/** Context provided to extension functions during initialization. */
+interface ExtensionContext {
+    tracerProvider: WebTracerProvider;
+}
+/** Configuration options for initOtel(). */
+interface OtelOptions {
+    /** Required. Sets the service.name resource attribute. */
+    serviceName: string;
+    /** OTLP HTTP endpoint. Default: 'http://localhost:4318' */
+    endpoint?: string;
+    /** Additional OTel resource attributes. */
+    resourceAttributes?: Record<string, string>;
+    /** Service version. Sets service.version resource attribute. */
+    serviceVersion?: string;
+    /** Deployment environment. Sets deployment.environment resource attribute. */
+    environment?: string;
+    /** Enable/disable specific auto-instrumentations. All enabled by default. */
+    instrumentations?: InstrumentationConfig;
+    /** Escape hatch: configure the TracerProvider before it's registered. */
+    configureTracing?: (provider: WebTracerProvider) => void;
+    /** Escape hatch: configure the OTLP exporter. */
+    configureExporter?: (exporter: OTLPTraceExporter) => void;
+    /** Custom headers sent with OTLP export requests (e.g., auth tokens). */
+    headers?: Record<string, string>;
+    /** Export timeout in milliseconds. Default: 30000 */
+    exportTimeout?: number;
+    /**
+     * URLs to exclude from fetch/XHR instrumentation.
+     * Supports string patterns or RegExp.
+     */
+    ignoreUrls?: Array<string | RegExp>;
+    /** Extension functions for opt-in instrumentations. */
+    extensions?: OtelExtension[];
+}
+/** Handle returned from initOtel() for lifecycle management. */
+interface OtelHandle {
+    /** Flush all pending telemetry and shut down providers. */
+    shutdown: () => Promise<void>;
+}
+
+/**
+ * Initialize OpenTelemetry for React Native.
+ *
+ * Key differences from browser init:
+ * - Uses BasicTracerProvider (sdk-trace-base) instead of WebTracerProvider
+ * - Only fetch instrumentation enabled (no document-load, no user-interaction, no Web Vitals)
+ * - XHR disabled by default to avoid duplicate spans (RN's fetch polyfills over XHR)
+ * - Uses AppState for flush instead of visibilitychange
+ */
+declare function initOtelNative(options: OtelOptions): Promise<OtelHandle>;
+
+/**
+ * Extension for React Navigation route-change tracing.
+ *
+ * This extension pre-registers the tracer scope. Actual navigation
+ * tracking requires hooking into React Navigation's onStateChange
+ * in the consuming app.
+ *
+ * @example
+ * ```tsx
+ * import { withReactNavigation, createNavigationTracker } from '@raccoon.ninja/otel-react/native';
+ *
+ * const otel = await initOtelNative({
+ *   serviceName: 'my-rn-app',
+ *   extensions: [withReactNavigation()],
+ * });
+ * ```
+ */
+declare function withReactNavigation(): OtelExtension;
+/**
+ * Creates a navigation state change handler that records route changes as spans.
+ *
+ * @returns A function suitable for React Navigation's onStateChange prop.
+ */
+declare function createNavigationTracker(): (state: {
+    routes: Array<{
+        name: string;
+    }>;
+    index: number;
+} | undefined) => void;
+
+export { type OtelExtension, type OtelHandle, type OtelOptions, createNavigationTracker, initOtelNative as initOtel, withReactNavigation };

package/dist/native/index.mjs

@@ -0,0 +1,211 @@
+import { trace, SpanStatusCode, metrics } from '@opentelemetry/api';
+import { BasicTracerProvider, BatchSpanProcessor } from '@opentelemetry/sdk-trace-base';
+import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';
+import { SeverityNumber, logs } from '@opentelemetry/api-logs';
+import { resourceFromAttributes } from '@opentelemetry/resources';
+import { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION, SEMRESATTRS_DEPLOYMENT_ENVIRONMENT } from '@opentelemetry/semantic-conventions';
+import { LoggerProvider, BatchLogRecordProcessor } from '@opentelemetry/sdk-logs';
+import { OTLPLogExporter } from '@opentelemetry/exporter-logs-otlp-http';
+import { MeterProvider, PeriodicExportingMetricReader } from '@opentelemetry/sdk-metrics';
+import { OTLPMetricExporter } from '@opentelemetry/exporter-metrics-otlp-http';
+
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/core/options.ts
+var DEFAULT_ENDPOINT = "http://localhost:4318";
+var DEFAULT_EXPORT_TIMEOUT = 3e4;
+function resolveEndpoint(options) {
+  return options.endpoint ?? DEFAULT_ENDPOINT;
+}
+function resolveExportTimeout(options) {
+  return options.exportTimeout ?? DEFAULT_EXPORT_TIMEOUT;
+}
+function validateOptions(options) {
+  if (!options.serviceName || typeof options.serviceName !== "string") {
+    throw new Error(
+      "[@raccoon.ninja/otel-react] serviceName is required and must be a non-empty string."
+    );
+  }
+  if (options.serviceName.trim() !== options.serviceName) {
+    throw new Error(
+      "[@raccoon.ninja/otel-react] serviceName must not have leading or trailing whitespace."
+    );
+  }
+  if (options.endpoint !== void 0) {
+    if (typeof options.endpoint !== "string" || options.endpoint.trim() === "") {
+      throw new Error(
+        "[@raccoon.ninja/otel-react] endpoint must be a non-empty string when provided."
+      );
+    }
+  }
+  if (options.exportTimeout !== void 0) {
+    if (typeof options.exportTimeout !== "number" || options.exportTimeout <= 0) {
+      throw new Error(
+        "[@raccoon.ninja/otel-react] exportTimeout must be a positive number when provided."
+      );
+    }
+  }
+}
+var SDK_NAME = "@raccoon.ninja/otel-react";
+var SDK_VERSION = "0.0.1";
+function buildResource(options) {
+  const attributes = {
+    [ATTR_SERVICE_NAME]: options.serviceName,
+    "telemetry.sdk.name": SDK_NAME,
+    "telemetry.sdk.version": SDK_VERSION,
+    "telemetry.sdk.language": "webjs"
+  };
+  if (options.serviceVersion) {
+    attributes[ATTR_SERVICE_VERSION] = options.serviceVersion;
+  }
+  if (options.environment) {
+    attributes[SEMRESATTRS_DEPLOYMENT_ENVIRONMENT] = options.environment;
+  }
+  if (typeof navigator !== "undefined") {
+    if (navigator.language) {
+      attributes["browser.language"] = navigator.language;
+    }
+    if (navigator.userAgent) {
+      attributes["browser.user_agent"] = navigator.userAgent;
+    }
+    if (navigator.platform) {
+      attributes["browser.platform"] = navigator.platform;
+    }
+  }
+  if (options.resourceAttributes) {
+    Object.assign(attributes, options.resourceAttributes);
+  }
+  return resourceFromAttributes(attributes);
+}
+function createLoggerProvider(options, resource) {
+  const endpoint = resolveEndpoint(options);
+  const timeout = resolveExportTimeout(options);
+  const exporter = new OTLPLogExporter({
+    url: `${endpoint}/v1/logs`,
+    headers: options.headers,
+    timeoutMillis: timeout
+  });
+  const provider = new LoggerProvider({ resource });
+  provider.addLogRecordProcessor(new BatchLogRecordProcessor(exporter));
+  logs.setGlobalLoggerProvider(provider);
+  return provider;
+}
+var METRIC_EXPORT_INTERVAL_MS = 3e4;
+function createMeterProvider(options, resource) {
+  const endpoint = resolveEndpoint(options);
+  const timeout = resolveExportTimeout(options);
+  const exporter = new OTLPMetricExporter({
+    url: `${endpoint}/v1/metrics`,
+    headers: options.headers,
+    timeoutMillis: timeout
+  });
+  const provider = new MeterProvider({
+    resource,
+    readers: [
+      new PeriodicExportingMetricReader({
+        exporter,
+        exportIntervalMillis: METRIC_EXPORT_INTERVAL_MS
+      })
+    ]
+  });
+  metrics.setGlobalMeterProvider(provider);
+  return provider;
+}
+
+// src/native/init.ts
+var initialized = false;
+async function initOtelNative(options) {
+  if (initialized) {
+    console.warn(
+      "[@raccoon.ninja/otel-react] initOtelNative() has already been called. Skipping."
+    );
+    return {
+      shutdown: async () => {
+      }
+    };
+  }
+  validateOptions(options);
+  const resource = buildResource(options);
+  const endpoint = resolveEndpoint(options);
+  const timeout = resolveExportTimeout(options);
+  const traceExporter = new OTLPTraceExporter({
+    url: `${endpoint}/v1/traces`,
+    headers: options.headers,
+    timeoutMillis: timeout
+  });
+  const tracerProvider = new BasicTracerProvider({
+    resource,
+    spanProcessors: [new BatchSpanProcessor(traceExporter)]
+  });
+  trace.setGlobalTracerProvider(tracerProvider);
+  const loggerProvider = createLoggerProvider(options, resource);
+  const meterProvider = createMeterProvider(options, resource);
+  let appStateSubscription = null;
+  try {
+    const { AppState } = __require("react-native");
+    appStateSubscription = AppState.addEventListener("change", (nextState) => {
+      if (nextState === "background" || nextState === "inactive") {
+        tracerProvider.forceFlush();
+        loggerProvider.forceFlush();
+        meterProvider.forceFlush();
+      }
+    });
+  } catch {
+  }
+  const logger = loggerProvider.getLogger("@raccoon.ninja/otel-react", "1.0.0");
+  logger.emit({
+    severityNumber: SeverityNumber.INFO,
+    severityText: "INFO",
+    body: `OpenTelemetry (RN) initialized for service "${options.serviceName}"`
+  });
+  initialized = true;
+  return {
+    shutdown: async () => {
+      appStateSubscription?.remove();
+      await Promise.all([
+        tracerProvider.forceFlush(),
+        loggerProvider.forceFlush(),
+        meterProvider.forceFlush()
+      ]);
+      await Promise.all([
+        tracerProvider.shutdown(),
+        loggerProvider.shutdown(),
+        meterProvider.shutdown()
+      ]);
+      initialized = false;
+    }
+  };
+}
+var TRACER_NAME = "@raccoon.ninja/otel-react/react-navigation";
+function withReactNavigation() {
+  return () => {
+    trace.getTracer(TRACER_NAME, "1.0.0");
+  };
+}
+function createNavigationTracker() {
+  const tracer = trace.getTracer(TRACER_NAME, "1.0.0");
+  let previousRouteName;
+  return (state) => {
+    if (!state) return;
+    const currentRoute = state.routes[state.index];
+    if (!currentRoute) return;
+    const currentRouteName = currentRoute.name;
+    if (previousRouteName && previousRouteName !== currentRouteName) {
+      const span = tracer.startSpan("navigation.route_change");
+      span.setAttribute("navigation.from", previousRouteName);
+      span.setAttribute("navigation.to", currentRouteName);
+      span.setStatus({ code: SpanStatusCode.OK });
+      span.end();
+    }
+    previousRouteName = currentRouteName;
+  };
+}
+
+export { createNavigationTracker, initOtelNative as initOtel, withReactNavigation };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map