duron 0.3.0-beta.8 → 0.3.0

package/src/telemetry/local-span-exporter.ts

@@ -0,0 +1,148 @@
+import type { SpanKind as OTelSpanKind, SpanStatusCode as OTelSpanStatusCode } from '@opentelemetry/api'
+import { type ExportResult, ExportResultCode } from '@opentelemetry/core'
+import type { ReadableSpan, SpanExporter } from '@opentelemetry/sdk-trace-base'
+
+import type { Adapter, InsertSpanOptions } from '../adapters/adapter.js'
+
+/**
+ * Configuration options for the LocalSpanExporter.
+ */
+export interface LocalSpanExporterOptions {
+  /**
+   * The database adapter to use for storing spans.
+   * This is the same adapter used by the Duron Client.
+   */
+  adapter: Adapter
+}
+
+/**
+ * A custom OpenTelemetry SpanExporter that stores spans locally in the database.
+ *
+ * This exporter converts OpenTelemetry ReadableSpan objects into database records
+ * and inserts them via the Duron Adapter interface.
+ *
+ * It extracts `duron.job.id` and `duron.step.id` from span attributes to link
+ * spans to Duron jobs and steps.
+ *
+ * @example
+ * ```typescript
+ * import { LocalSpanExporter } from 'duron/telemetry'
+ * import { BatchSpanProcessor } from '@opentelemetry/sdk-trace-base'
+ *
+ * const exporter = new LocalSpanExporter({ adapter })
+ * const processor = new BatchSpanProcessor(exporter)
+ * ```
+ */
+export class LocalSpanExporter implements SpanExporter {
+  #adapter: Adapter
+  #shutdown = false
+
+  constructor(options: LocalSpanExporterOptions) {
+    this.#adapter = options.adapter
+  }
+
+  /**
+   * Export spans to the local database.
+   *
+   * Converts ReadableSpan objects to database records and inserts them.
+   * Follows OpenTelemetry exporter rules:
+   * - Does not throw exceptions
+   * - Does not modify received spans
+   * - Does not implement queuing/batching (handled by SpanProcessor)
+   */
+  export(spans: ReadableSpan[], resultCallback: (result: ExportResult) => void): void {
+    if (this.#shutdown) {
+      resultCallback({ code: ExportResultCode.FAILED, error: new Error('Exporter has been shutdown') })
+      return
+    }
+
+    this.#exportSpans(spans)
+      .then(() => {
+        resultCallback({ code: ExportResultCode.SUCCESS })
+      })
+      .catch((error) => {
+        resultCallback({ code: ExportResultCode.FAILED, error })
+      })
+  }
+
+  /**
+   * Shutdown the exporter.
+   * After shutdown, no more spans will be exported.
+   */
+  async shutdown(): Promise<void> {
+    this.#shutdown = true
+  }
+
+  /**
+   * Force flush any pending exports.
+   * Since we export synchronously to the database, this is a no-op.
+   */
+  async forceFlush(): Promise<void> {
+    // No-op: we don't buffer spans, they're exported immediately
+  }
+
+  /**
+   * Internal method to export spans to the database.
+   */
+  async #exportSpans(spans: ReadableSpan[]): Promise<void> {
+    if (spans.length === 0) {
+      return
+    }
+
+    const records = spans.map((span) => this.#readableSpanToRecord(span))
+    await this.#adapter.insertSpans(records)
+  }
+
+  /**
+   * Convert a ReadableSpan to an InsertSpanOptions record.
+   */
+  #readableSpanToRecord(span: ReadableSpan): InsertSpanOptions {
+    const spanContext = span.spanContext()
+
+    // Extract Duron-specific attributes
+    const jobId = span.attributes['duron.job.id'] as string | undefined
+    const stepId = span.attributes['duron.step.id'] as string | undefined
+
+    // Convert attributes to plain object, excluding only job.id and step.id
+    // (those are stored in separate columns)
+    const attributes: Record<string, any> = {}
+    for (const [key, value] of Object.entries(span.attributes)) {
+      if (key !== 'duron.job.id' && key !== 'duron.step.id') {
+        attributes[key] = value
+      }
+    }
+
+    // Convert events
+    const events = span.events.map((event) => ({
+      name: event.name,
+      timeUnixNano: this.#hrTimeToNanos(event.time).toString(),
+      attributes: event.attributes as Record<string, any> | undefined,
+    }))
+
+    // Get parent span ID from parentSpanContext if available
+    const parentSpanId = span.parentSpanContext?.spanId || null
+
+    return {
+      traceId: spanContext.traceId,
+      spanId: spanContext.spanId,
+      parentSpanId,
+      jobId: jobId || null,
+      stepId: stepId || null,
+      name: span.name,
+      kind: span.kind as OTelSpanKind,
+      startTimeUnixNano: this.#hrTimeToNanos(span.startTime),
+      endTimeUnixNano: span.endTime ? this.#hrTimeToNanos(span.endTime) : null,
+      statusCode: span.status.code as OTelSpanStatusCode,
+      statusMessage: span.status.message || null,
+      attributes,
+      events,
+    }
+  }
+
+  /**
+   * Convert HrTime [seconds, nanoseconds] to bigint nanoseconds.
+   */
+  #hrTimeToNanos(hrTime: [number, number]): bigint {
+    return BigInt(hrTime[0]) * BigInt(1_000_000_000) + BigInt(hrTime[1])
+  }
+}

package/dist/telemetry/adapter.d.ts

@@ -1,107 +0,0 @@
-import type { Logger } from 'pino';
-import type { Adapter } from '../adapters/adapter.js';
-export interface TelemetryClient {
-    database: Adapter;
-}
-export interface Span {
-    id: string;
-    jobId: string;
-    stepId: string | null;
-    parentSpanId: string | null;
-}
-export interface StartJobSpanOptions {
-    jobId: string;
-    actionName: string;
-    groupKey: string;
-    input?: any;
-}
-export interface StartStepSpanOptions {
-    jobId: string;
-    stepId: string;
-    stepName: string;
-    parentSpan?: Span;
-    parentStepId: string | null;
-}
-export interface EndSpanOptions {
-    status: 'ok' | 'error' | 'cancelled';
-    error?: any;
-}
-export interface StartDatabaseSpanOptions {
-    operation: string;
-    query?: string;
-}
-export interface RecordMetricOptions {
-    jobId: string;
-    stepId?: string;
-    name: string;
-    value: number;
-    attributes?: Record<string, any>;
-}
-export interface AddSpanEventOptions {
-    span: Span;
-    name: string;
-    attributes?: Record<string, any>;
-}
-export interface AddSpanAttributeOptions {
-    span: Span;
-    key: string;
-    value: string | number | boolean;
-}
-export interface StartSpanOptions {
-    kind?: 'internal' | 'client' | 'server' | 'producer' | 'consumer';
-    attributes?: Record<string, string | number | boolean>;
-    parentSpan?: TracerSpan;
-}
-export interface TracerSpan {
-    setAttribute(key: string, value: string | number | boolean): void;
-    setAttributes(attributes: Record<string, string | number | boolean>): void;
-    addEvent(name: string, attributes?: Record<string, string | number | boolean>): void;
-    recordException(error: Error): void;
-    setStatusOk(): void;
-    setStatusError(message?: string): void;
-    end(): void;
-    isRecording(): boolean;
-}
-export interface Tracer {
-    readonly name: string;
-    startSpan(name: string, options?: StartSpanOptions): TracerSpan;
-}
-export interface ObserveContext {
-    recordMetric(name: string, value: number, attributes?: Record<string, any>): void;
-    addSpanAttribute(key: string, value: string | number | boolean): void;
-    addSpanEvent(name: string, attributes?: Record<string, any>): void;
-    getTracer(name: string): Tracer;
-}
-export declare abstract class TelemetryAdapter {
-    #private;
-    start(): Promise<boolean>;
-    stop(): Promise<boolean>;
-    setLogger(logger: Logger): void;
-    get logger(): Logger | null;
-    setClient(client: TelemetryClient): void;
-    protected get client(): TelemetryClient | null;
-    startJobSpan(options: StartJobSpanOptions): Promise<Span>;
-    endJobSpan(span: Span, options: EndSpanOptions): Promise<void>;
-    startStepSpan(options: StartStepSpanOptions): Promise<Span>;
-    endStepSpan(span: Span, options: EndSpanOptions): Promise<void>;
-    startDatabaseSpan(options: StartDatabaseSpanOptions): Promise<Span | null>;
-    endDatabaseSpan(span: Span | null, options: EndSpanOptions): Promise<void>;
-    recordMetric(options: RecordMetricOptions): Promise<void>;
-    addSpanEvent(options: AddSpanEventOptions): Promise<void>;
-    addSpanAttribute(options: AddSpanAttributeOptions): Promise<void>;
-    getTracer(name: string): Tracer;
-    createObserveContext(jobId: string, stepId: string | null, span: Span): ObserveContext;
-    protected abstract _start(): Promise<void>;
-    protected abstract _stop(): Promise<void>;
-    protected abstract _startJobSpan(options: StartJobSpanOptions): Promise<Span>;
-    protected abstract _endJobSpan(span: Span, options: EndSpanOptions): Promise<void>;
-    protected abstract _startStepSpan(options: StartStepSpanOptions): Promise<Span>;
-    protected abstract _endStepSpan(span: Span, options: EndSpanOptions): Promise<void>;
-    protected abstract _startDatabaseSpan(options: StartDatabaseSpanOptions): Promise<Span | null>;
-    protected abstract _endDatabaseSpan(span: Span, options: EndSpanOptions): Promise<void>;
-    protected abstract _recordMetric(options: RecordMetricOptions): Promise<void>;
-    protected abstract _addSpanEvent(options: AddSpanEventOptions): Promise<void>;
-    protected abstract _addSpanAttribute(options: AddSpanAttributeOptions): Promise<void>;
-    protected abstract _getTracer(name: string): Tracer;
-}
-//# sourceMappingURL=adapter.d.ts.map

package/dist/telemetry/adapter.d.ts.map

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

package/dist/telemetry/adapter.js

@@ -1,134 +0,0 @@
-export class TelemetryAdapter {
-    #logger = null;
-    #client = null;
-    #started = false;
-    #stopped = false;
-    #starting = null;
-    #stopping = null;
-    async start() {
-        try {
-            if (this.#stopping || this.#stopped) {
-                return false;
-            }
-            if (this.#started) {
-                return true;
-            }
-            if (this.#starting) {
-                return this.#starting;
-            }
-            this.#starting = (async () => {
-                await this._start();
-                this.#started = true;
-                this.#starting = null;
-                return true;
-            })();
-            return this.#starting;
-        }
-        catch (error) {
-            this.#logger?.error(error, 'Error in TelemetryAdapter.start()');
-            throw error;
-        }
-    }
-    async stop() {
-        try {
-            if (this.#stopped) {
-                return true;
-            }
-            if (this.#stopping) {
-                return this.#stopping;
-            }
-            this.#stopping = (async () => {
-                await this._stop();
-                this.#stopped = true;
-                this.#stopping = null;
-                return true;
-            })();
-            return this.#stopping;
-        }
-        catch (error) {
-            this.#logger?.error(error, 'Error in TelemetryAdapter.stop()');
-            throw error;
-        }
-    }
-    setLogger(logger) {
-        this.#logger = logger;
-    }
-    get logger() {
-        return this.#logger;
-    }
-    setClient(client) {
-        this.#client = client;
-    }
-    get client() {
-        return this.#client;
-    }
-    async startJobSpan(options) {
-        await this.start();
-        return this._startJobSpan(options);
-    }
-    async endJobSpan(span, options) {
-        await this.start();
-        return this._endJobSpan(span, options);
-    }
-    async startStepSpan(options) {
-        await this.start();
-        return this._startStepSpan(options);
-    }
-    async endStepSpan(span, options) {
-        await this.start();
-        return this._endStepSpan(span, options);
-    }
-    async startDatabaseSpan(options) {
-        await this.start();
-        return this._startDatabaseSpan(options);
-    }
-    async endDatabaseSpan(span, options) {
-        if (!span)
-            return;
-        await this.start();
-        return this._endDatabaseSpan(span, options);
-    }
-    async recordMetric(options) {
-        await this.start();
-        return this._recordMetric(options);
-    }
-    async addSpanEvent(options) {
-        await this.start();
-        return this._addSpanEvent(options);
-    }
-    async addSpanAttribute(options) {
-        await this.start();
-        return this._addSpanAttribute(options);
-    }
-    getTracer(name) {
-        return this._getTracer(name);
-    }
-    createObserveContext(jobId, stepId, span) {
-        return {
-            recordMetric: (name, value, attributes) => {
-                this.recordMetric({
-                    jobId,
-                    stepId: stepId ?? undefined,
-                    name,
-                    value,
-                    attributes,
-                }).catch((err) => {
-                    this.#logger?.error(err, 'Error recording metric');
-                });
-            },
-            addSpanAttribute: (key, value) => {
-                this.addSpanAttribute({ span, key, value }).catch((err) => {
-                    this.#logger?.error(err, 'Error adding span attribute');
-                });
-            },
-            addSpanEvent: (name, attributes) => {
-                this.addSpanEvent({ span, name, attributes }).catch((err) => {
-                    this.#logger?.error(err, 'Error adding span event');
-                });
-            },
-            getTracer: (name) => {
-                return this.getTracer(name);
-            },
-        };
-    }
-}

package/dist/telemetry/local.d.ts

@@ -1,22 +0,0 @@
-import { type AddSpanAttributeOptions, type AddSpanEventOptions, type EndSpanOptions, type RecordMetricOptions, type Span, type StartDatabaseSpanOptions, type StartJobSpanOptions, type StartStepSpanOptions, TelemetryAdapter, type Tracer } from './adapter.js';
-export interface LocalTelemetryAdapterOptions {
-    flushDelayMs?: number;
-}
-export declare class LocalTelemetryAdapter extends TelemetryAdapter {
-    #private;
-    constructor(options?: LocalTelemetryAdapterOptions);
-    protected _start(): Promise<void>;
-    protected _stop(): Promise<void>;
-    protected _startJobSpan(options: StartJobSpanOptions): Promise<Span>;
-    protected _endJobSpan(span: Span, options: EndSpanOptions): Promise<void>;
-    protected _startStepSpan(options: StartStepSpanOptions): Promise<Span>;
-    protected _endStepSpan(span: Span, options: EndSpanOptions): Promise<void>;
-    protected _startDatabaseSpan(_options: StartDatabaseSpanOptions): Promise<Span | null>;
-    protected _endDatabaseSpan(_span: Span, _options: EndSpanOptions): Promise<void>;
-    protected _recordMetric(options: RecordMetricOptions): Promise<void>;
-    protected _addSpanEvent(options: AddSpanEventOptions): Promise<void>;
-    protected _addSpanAttribute(options: AddSpanAttributeOptions): Promise<void>;
-    protected _getTracer(name: string): Tracer;
-}
-export declare const localTelemetryAdapter: (options?: LocalTelemetryAdapterOptions) => LocalTelemetryAdapter;
-//# sourceMappingURL=local.d.ts.map

package/dist/telemetry/local.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../src/telemetry/local.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,IAAI,EACT,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EAExB,KAAK,oBAAoB,EACzB,gBAAgB,EAChB,KAAK,MAAM,EAEZ,MAAM,cAAc,CAAA;AAMrB,MAAM,WAAW,4BAA4B;IAM3C,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AA4BD,qBAAa,qBAAsB,SAAQ,gBAAgB;;gBAO7C,OAAO,CAAC,EAAE,4BAA4B;cAwFlC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;cAIvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;cAUtB,aAAa,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;cAyB1D,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;cAoB/D,cAAc,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;cA2B5D,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;cAqBhE,kBAAkB,CAAC,QAAQ,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;cAK5E,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;cAQtE,aAAa,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;cAW1D,aAAa,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;cAc1D,iBAAiB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBlF,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAqF3C;AA6BD,eAAO,MAAM,qBAAqB,GAAI,UAAU,4BAA4B,0BAAuC,CAAA"}

package/dist/telemetry/local.js

@@ -1,243 +0,0 @@
-import { TelemetryAdapter, } from './adapter.js';
-const DEFAULT_FLUSH_DELAY_MS = 1000;
-export class LocalTelemetryAdapter extends TelemetryAdapter {
-    #spanStartTimes = new Map();
-    #metricsQueue = [];
-    #flushTimer = null;
-    #flushPromise = null;
-    #flushDelayMs;
-    constructor(options) {
-        super();
-        this.#flushDelayMs = options?.flushDelayMs ?? DEFAULT_FLUSH_DELAY_MS;
-    }
-    get #database() {
-        const client = this.client;
-        if (!client) {
-            throw new Error('LocalTelemetryAdapter requires the Duron client to be set. This is done automatically by the Duron client.');
-        }
-        return client.database;
-    }
-    #queueMetric(options) {
-        this.#metricsQueue.push(options);
-        this.#scheduleFlush();
-    }
-    #scheduleFlush() {
-        if (this.#flushTimer) {
-            clearTimeout(this.#flushTimer);
-        }
-        this.#flushTimer = setTimeout(() => {
-            this.#flushTimer = null;
-            this.#flushPromise = this.#flushQueue().finally(() => {
-                this.#flushPromise = null;
-            });
-        }, this.#flushDelayMs);
-    }
-    async #flushQueue() {
-        if (this.#metricsQueue.length === 0) {
-            return;
-        }
-        const metrics = this.#metricsQueue.splice(0, this.#metricsQueue.length);
-        await this.#database.insertMetrics(metrics);
-    }
-    async #forceFlush() {
-        if (this.#flushTimer) {
-            clearTimeout(this.#flushTimer);
-            this.#flushTimer = null;
-        }
-        if (this.#flushPromise) {
-            await this.#flushPromise;
-        }
-        await this.#flushQueue();
-    }
-    async _start() {
-    }
-    async _stop() {
-        await this.#forceFlush();
-        this.#spanStartTimes.clear();
-    }
-    async _startJobSpan(options) {
-        const spanId = `job:${options.jobId}`;
-        this.#spanStartTimes.set(spanId, Date.now());
-        this.#queueMetric({
-            jobId: options.jobId,
-            name: 'duron.job.span.start',
-            value: Date.now(),
-            type: 'span_event',
-            attributes: {
-                actionName: options.actionName,
-                groupKey: options.groupKey,
-                spanId,
-            },
-        });
-        return {
-            id: spanId,
-            jobId: options.jobId,
-            stepId: null,
-            parentSpanId: null,
-        };
-    }
-    async _endJobSpan(span, options) {
-        const startTime = this.#spanStartTimes.get(span.id);
-        const duration = startTime ? Date.now() - startTime : 0;
-        this.#spanStartTimes.delete(span.id);
-        this.#queueMetric({
-            jobId: span.jobId,
-            name: 'duron.job.span.end',
-            value: duration,
-            type: 'span_event',
-            attributes: {
-                spanId: span.id,
-                status: options.status,
-                error: options.error?.message ?? null,
-                durationMs: duration,
-            },
-        });
-    }
-    async _startStepSpan(options) {
-        const spanId = `step:${options.stepId}`;
-        this.#spanStartTimes.set(spanId, Date.now());
-        this.#queueMetric({
-            jobId: options.jobId,
-            stepId: options.stepId,
-            name: 'duron.step.span.start',
-            value: Date.now(),
-            type: 'span_event',
-            attributes: {
-                stepName: options.stepName,
-                parentStepId: options.parentStepId,
-                parentSpanId: options.parentSpan?.id ?? null,
-                spanId,
-            },
-        });
-        return {
-            id: spanId,
-            jobId: options.jobId,
-            stepId: options.stepId,
-            parentSpanId: options.parentSpan?.id ?? null,
-        };
-    }
-    async _endStepSpan(span, options) {
-        const startTime = this.#spanStartTimes.get(span.id);
-        const duration = startTime ? Date.now() - startTime : 0;
-        this.#spanStartTimes.delete(span.id);
-        this.#queueMetric({
-            jobId: span.jobId,
-            stepId: span.stepId ?? undefined,
-            name: 'duron.step.span.end',
-            value: duration,
-            type: 'span_event',
-            attributes: {
-                spanId: span.id,
-                status: options.status,
-                error: options.error?.message ?? null,
-                durationMs: duration,
-            },
-        });
-    }
-    async _startDatabaseSpan(_options) {
-        return null;
-    }
-    async _endDatabaseSpan(_span, _options) {
-    }
-    async _recordMetric(options) {
-        this.#queueMetric({
-            jobId: options.jobId,
-            stepId: options.stepId,
-            name: options.name,
-            value: options.value,
-            type: 'metric',
-            attributes: options.attributes,
-        });
-    }
-    async _addSpanEvent(options) {
-        this.#queueMetric({
-            jobId: options.span.jobId,
-            stepId: options.span.stepId ?? undefined,
-            name: options.name,
-            value: Date.now(),
-            type: 'span_event',
-            attributes: {
-                spanId: options.span.id,
-                ...options.attributes,
-            },
-        });
-    }
-    async _addSpanAttribute(options) {
-        this.#queueMetric({
-            jobId: options.span.jobId,
-            stepId: options.span.stepId ?? undefined,
-            name: `attribute:${options.key}`,
-            value: typeof options.value === 'number' ? options.value : 0,
-            type: 'span_attribute',
-            attributes: {
-                spanId: options.span.id,
-                key: options.key,
-                value: String(options.value),
-            },
-        });
-    }
-    _getTracer(name) {
-        const adapter = this;
-        return {
-            name,
-            startSpan(spanName, options) {
-                const spanId = `tracer:${name}:${globalThis.crypto.randomUUID()}`;
-                const startTime = Date.now();
-                let ended = false;
-                const attributes = {
-                    ...options?.attributes,
-                };
-                const tracerSpan = {
-                    setAttribute(key, value) {
-                        if (!ended) {
-                            attributes[key] = value;
-                        }
-                    },
-                    setAttributes(attrs) {
-                        if (!ended) {
-                            Object.assign(attributes, attrs);
-                        }
-                    },
-                    addEvent(eventName, eventAttrs) {
-                        if (!ended) {
-                            adapter.logger?.debug({ spanId, event: eventName, attributes: eventAttrs }, 'Tracer span event');
-                        }
-                    },
-                    recordException(error) {
-                        if (!ended) {
-                            attributes['error.message'] = error.message;
-                            attributes['error.name'] = error.name;
-                            adapter.logger?.debug({ spanId, error: error.message }, 'Tracer span exception');
-                        }
-                    },
-                    setStatusOk() {
-                        if (!ended) {
-                            attributes['status'] = 'ok';
-                        }
-                    },
-                    setStatusError(message) {
-                        if (!ended) {
-                            attributes['status'] = 'error';
-                            if (message) {
-                                attributes['status.message'] = message;
-                            }
-                        }
-                    },
-                    end() {
-                        if (!ended) {
-                            ended = true;
-                            const duration = Date.now() - startTime;
-                            adapter.logger?.debug({ spanId, spanName, tracerName: name, durationMs: duration, attributes }, 'Tracer span ended');
-                        }
-                    },
-                    isRecording() {
-                        return !ended;
-                    },
-                };
-                adapter.logger?.debug({ spanId, spanName, tracerName: name }, 'Tracer span started');
-                return tracerSpan;
-            },
-        };
-    }
-}
-export const localTelemetryAdapter = (options) => new LocalTelemetryAdapter(options);

package/dist/telemetry/noop.d.ts

@@ -1,17 +0,0 @@
-import { type AddSpanAttributeOptions, type AddSpanEventOptions, type EndSpanOptions, type RecordMetricOptions, type Span, type StartDatabaseSpanOptions, type StartJobSpanOptions, type StartStepSpanOptions, TelemetryAdapter, type Tracer } from './adapter.js';
-export declare class NoopTelemetryAdapter extends TelemetryAdapter {
-    protected _start(): Promise<void>;
-    protected _stop(): Promise<void>;
-    protected _startJobSpan(options: StartJobSpanOptions): Promise<Span>;
-    protected _endJobSpan(_span: Span, _options: EndSpanOptions): Promise<void>;
-    protected _startStepSpan(options: StartStepSpanOptions): Promise<Span>;
-    protected _endStepSpan(_span: Span, _options: EndSpanOptions): Promise<void>;
-    protected _startDatabaseSpan(_options: StartDatabaseSpanOptions): Promise<Span | null>;
-    protected _endDatabaseSpan(_span: Span, _options: EndSpanOptions): Promise<void>;
-    protected _recordMetric(_options: RecordMetricOptions): Promise<void>;
-    protected _addSpanEvent(_options: AddSpanEventOptions): Promise<void>;
-    protected _addSpanAttribute(_options: AddSpanAttributeOptions): Promise<void>;
-    protected _getTracer(name: string): Tracer;
-}
-export declare const noopTelemetryAdapter: () => NoopTelemetryAdapter;
-//# sourceMappingURL=noop.d.ts.map