raffel 0.1.2

package/dist/tracing/exporters.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Span Exporters
+ *
+ * Export spans to various backends: Console, Jaeger, Zipkin.
+ */
+import type { SpanExporter } from './types.js';
+/**
+ * Console exporter - prints spans to console (useful for development)
+ */
+export declare function createConsoleExporter(): SpanExporter;
+/**
+ * Jaeger Thrift over HTTP exporter options
+ */
+export interface JaegerExporterOptions {
+    /** Jaeger collector endpoint (default: http://localhost:14268/api/traces) */
+    endpoint?: string;
+    /** Service name */
+    serviceName: string;
+    /** Request timeout in ms (default: 5000) */
+    timeout?: number;
+}
+/**
+ * Jaeger exporter - sends spans to Jaeger collector
+ *
+ * Uses Jaeger's Thrift HTTP format
+ */
+export declare function createJaegerExporter(options: JaegerExporterOptions): SpanExporter;
+/**
+ * Zipkin exporter options
+ */
+export interface ZipkinExporterOptions {
+    /** Zipkin collector endpoint (default: http://localhost:9411/api/v2/spans) */
+    endpoint?: string;
+    /** Service name */
+    serviceName: string;
+    /** Request timeout in ms (default: 5000) */
+    timeout?: number;
+}
+/**
+ * Zipkin exporter - sends spans to Zipkin collector
+ */
+export declare function createZipkinExporter(options: ZipkinExporterOptions): SpanExporter;
+/**
+ * No-op exporter - discards all spans (for testing/disabled tracing)
+ */
+export declare function createNoopExporter(): SpanExporter;
+//# sourceMappingURL=exporters.d.ts.map

package/dist/tracing/exporters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exporters.d.ts","sourceRoot":"","sources":["../../src/tracing/exporters.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAY,MAAM,YAAY,CAAA;AAExD;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,YAAY,CA6BpD;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAA;IAEnB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,YAAY,CA8EjF;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAA;IAEnB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,YAAY,CAmDjF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CASjD"}

package/dist/tracing/exporters.js

@@ -0,0 +1,173 @@
+/**
+ * Span Exporters
+ *
+ * Export spans to various backends: Console, Jaeger, Zipkin.
+ */
+/**
+ * Console exporter - prints spans to console (useful for development)
+ */
+export function createConsoleExporter() {
+    return {
+        async export(spans) {
+            for (const span of spans) {
+                const duration = (span.duration / 1000).toFixed(2); // Convert to ms
+                const status = span.status.code === 'error' ? '❌' : '✓';
+                console.log(`[Trace] ${status} ${span.name} (${duration}ms) trace=${span.traceId.slice(0, 8)}... span=${span.spanId.slice(0, 8)}...`);
+                if (Object.keys(span.attributes).length > 0) {
+                    console.log('  Attributes:', span.attributes);
+                }
+                if (span.status.code === 'error' && span.status.message) {
+                    console.log('  Error:', span.status.message);
+                }
+                for (const log of span.logs) {
+                    console.log(`  Log: ${log.message}`, log.fields ?? '');
+                }
+            }
+        },
+        async shutdown() {
+            // No cleanup needed
+        },
+    };
+}
+/**
+ * Jaeger exporter - sends spans to Jaeger collector
+ *
+ * Uses Jaeger's Thrift HTTP format
+ */
+export function createJaegerExporter(options) {
+    const { endpoint = 'http://localhost:14268/api/traces', serviceName, timeout = 5000 } = options;
+    return {
+        async export(spans) {
+            if (spans.length === 0)
+                return;
+            // Convert to Jaeger format
+            const jaegerSpans = spans.map((span) => ({
+                traceIdHigh: span.traceId.slice(0, 16),
+                traceIdLow: span.traceId.slice(16),
+                spanId: span.spanId,
+                parentSpanId: span.parentSpanId,
+                operationName: span.name,
+                references: span.parentSpanId
+                    ? [
+                        {
+                            refType: 'CHILD_OF',
+                            traceIdHigh: span.traceId.slice(0, 16),
+                            traceIdLow: span.traceId.slice(16),
+                            spanId: span.parentSpanId,
+                        },
+                    ]
+                    : [],
+                flags: span.context.traceFlags,
+                startTime: Math.floor(span.startTime),
+                duration: Math.floor(span.duration),
+                tags: Object.entries(span.attributes).map(([key, value]) => ({
+                    key,
+                    vType: typeof value === 'string' ? 'STRING' : typeof value === 'boolean' ? 'BOOL' : 'LONG',
+                    vStr: typeof value === 'string' ? value : undefined,
+                    vBool: typeof value === 'boolean' ? value : undefined,
+                    vLong: typeof value === 'number' ? value : undefined,
+                })),
+                logs: span.logs.map((log) => ({
+                    timestamp: Math.floor(log.timestamp),
+                    fields: [
+                        { key: 'message', vType: 'STRING', vStr: log.message },
+                        ...Object.entries(log.fields ?? {}).map(([key, value]) => ({
+                            key,
+                            vType: 'STRING',
+                            vStr: String(value),
+                        })),
+                    ],
+                })),
+            }));
+            const batch = {
+                process: {
+                    serviceName,
+                    tags: [],
+                },
+                spans: jaegerSpans,
+            };
+            try {
+                const controller = new AbortController();
+                const timeoutId = setTimeout(() => controller.abort(), timeout);
+                await fetch(endpoint, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                    },
+                    body: JSON.stringify(batch),
+                    signal: controller.signal,
+                });
+                clearTimeout(timeoutId);
+            }
+            catch {
+                // Silently fail - tracing should not break the app
+            }
+        },
+        async shutdown() {
+            // No cleanup needed
+        },
+    };
+}
+/**
+ * Zipkin exporter - sends spans to Zipkin collector
+ */
+export function createZipkinExporter(options) {
+    const { endpoint = 'http://localhost:9411/api/v2/spans', serviceName, timeout = 5000 } = options;
+    return {
+        async export(spans) {
+            if (spans.length === 0)
+                return;
+            // Convert to Zipkin format
+            const zipkinSpans = spans.map((span) => ({
+                traceId: span.traceId,
+                id: span.spanId,
+                parentId: span.parentSpanId,
+                name: span.name,
+                kind: span.kind.toUpperCase(),
+                timestamp: Math.floor(span.startTime),
+                duration: Math.floor(span.duration),
+                localEndpoint: {
+                    serviceName,
+                },
+                tags: Object.fromEntries(Object.entries(span.attributes).map(([k, v]) => [k, String(v)])),
+                annotations: span.logs.map((log) => ({
+                    timestamp: Math.floor(log.timestamp),
+                    value: log.message,
+                })),
+            }));
+            try {
+                const controller = new AbortController();
+                const timeoutId = setTimeout(() => controller.abort(), timeout);
+                await fetch(endpoint, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                    },
+                    body: JSON.stringify(zipkinSpans),
+                    signal: controller.signal,
+                });
+                clearTimeout(timeoutId);
+            }
+            catch {
+                // Silently fail - tracing should not break the app
+            }
+        },
+        async shutdown() {
+            // No cleanup needed
+        },
+    };
+}
+/**
+ * No-op exporter - discards all spans (for testing/disabled tracing)
+ */
+export function createNoopExporter() {
+    return {
+        async export() {
+            // Discard
+        },
+        async shutdown() {
+            // Nothing to clean up
+        },
+    };
+}
+//# sourceMappingURL=exporters.js.map

package/dist/tracing/exporters.js.map

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

package/dist/tracing/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Distributed Tracing Module
+ *
+ * OpenTelemetry-compatible tracing with spans, sampling, and exporters.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   createTracer,
+ *   createConsoleExporter,
+ *   createJaegerExporter,
+ * } from 'raffel'
+ *
+ * const tracer = createTracer({
+ *   serviceName: 'my-service',
+ *   sampleRate: 1.0,
+ *   exporters: [createConsoleExporter()],
+ * })
+ *
+ * // Manual span creation
+ * const span = tracer.startSpan('operation')
+ * span.setAttribute('key', 'value')
+ * // ... do work ...
+ * span.finish()
+ *
+ * // Server integration
+ * const server = createServer({ port: 3000 })
+ *   .enableTracing({
+ *     serviceName: 'my-service',
+ *     sampleRate: 0.1,
+ *     exporters: [createJaegerExporter({ serviceName: 'my-service' })],
+ *   })
+ * ```
+ */
+export type { SpanKind, SpanStatusCode, SpanAttributes, SpanLogEntry, SpanStatus, SpanContext, TraceHeaders, SpanData, Span, SpanExporter, SamplingResult, Sampler, StartSpanOptions, Tracer, TracingConfig, } from './types.js';
+export { SAMPLING_STRATEGIES } from './types.js';
+export { createSpan, generateTraceId, generateSpanId } from './span.js';
+export { createAlwaysOnSampler, createAlwaysOffSampler, createProbabilitySampler, createRateLimitedSampler, createParentBasedSampler, createCompositeSampler, } from './sampler.js';
+export { createTracer } from './tracer.js';
+export { createConsoleExporter, createJaegerExporter, createZipkinExporter, createNoopExporter, } from './exporters.js';
+export type { JaegerExporterOptions, ZipkinExporterOptions } from './exporters.js';
+export { createTracingInterceptor, extractTraceHeaders, injectTraceHeaders, } from './interceptor.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tracing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tracing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAGH,YAAY,EACV,QAAQ,EACR,cAAc,EACd,cAAc,EACd,YAAY,EACZ,UAAU,EACV,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,IAAI,EACJ,YAAY,EACZ,cAAc,EACd,OAAO,EACP,gBAAgB,EAChB,MAAM,EACN,aAAa,GACd,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAGhD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAGvE,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,cAAc,CAAA;AAGrB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG1C,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,gBAAgB,CAAA;AACvB,YAAY,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAGlF,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,kBAAkB,CAAA"}

package/dist/tracing/index.js

@@ -0,0 +1,46 @@
+/**
+ * Distributed Tracing Module
+ *
+ * OpenTelemetry-compatible tracing with spans, sampling, and exporters.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   createTracer,
+ *   createConsoleExporter,
+ *   createJaegerExporter,
+ * } from 'raffel'
+ *
+ * const tracer = createTracer({
+ *   serviceName: 'my-service',
+ *   sampleRate: 1.0,
+ *   exporters: [createConsoleExporter()],
+ * })
+ *
+ * // Manual span creation
+ * const span = tracer.startSpan('operation')
+ * span.setAttribute('key', 'value')
+ * // ... do work ...
+ * span.finish()
+ *
+ * // Server integration
+ * const server = createServer({ port: 3000 })
+ *   .enableTracing({
+ *     serviceName: 'my-service',
+ *     sampleRate: 0.1,
+ *     exporters: [createJaegerExporter({ serviceName: 'my-service' })],
+ *   })
+ * ```
+ */
+export { SAMPLING_STRATEGIES } from './types.js';
+// Span
+export { createSpan, generateTraceId, generateSpanId } from './span.js';
+// Samplers
+export { createAlwaysOnSampler, createAlwaysOffSampler, createProbabilitySampler, createRateLimitedSampler, createParentBasedSampler, createCompositeSampler, } from './sampler.js';
+// Tracer
+export { createTracer } from './tracer.js';
+// Exporters
+export { createConsoleExporter, createJaegerExporter, createZipkinExporter, createNoopExporter, } from './exporters.js';
+// Interceptor
+export { createTracingInterceptor, extractTraceHeaders, injectTraceHeaders, } from './interceptor.js';
+//# sourceMappingURL=index.js.map

package/dist/tracing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tracing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAqBH,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAEhD,OAAO;AACP,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAEvE,WAAW;AACX,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,cAAc,CAAA;AAErB,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,YAAY;AACZ,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,gBAAgB,CAAA;AAGvB,cAAc;AACd,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,kBAAkB,CAAA"}

package/dist/tracing/interceptor.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Tracing Interceptor
+ *
+ * Automatically creates spans for incoming requests.
+ */
+import type { Interceptor } from '../types/index.js';
+import type { Tracer, TraceHeaders } from './types.js';
+/**
+ * Create an interceptor that automatically traces requests
+ */
+export declare function createTracingInterceptor(tracer: Tracer): Interceptor;
+/**
+ * Extract trace headers from incoming request
+ */
+export declare function extractTraceHeaders(headers: Record<string, string | string[] | undefined>): TraceHeaders;
+/**
+ * Inject trace headers for outgoing requests
+ */
+export declare function injectTraceHeaders(tracer: Tracer, headers: Record<string, string>): Record<string, string>;
+//# sourceMappingURL=interceptor.d.ts.map

package/dist/tracing/interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interceptor.d.ts","sourceRoot":"","sources":["../../src/tracing/interceptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAqB,MAAM,mBAAmB,CAAA;AACvE,OAAO,KAAK,EAAE,MAAM,EAAe,YAAY,EAAE,MAAM,YAAY,CAAA;AAEnE;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAwDpE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACrD,YAAY,CAYd;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAWxB"}

package/dist/tracing/interceptor.js

@@ -0,0 +1,90 @@
+/**
+ * Tracing Interceptor
+ *
+ * Automatically creates spans for incoming requests.
+ */
+/**
+ * Create an interceptor that automatically traces requests
+ */
+export function createTracingInterceptor(tracer) {
+    return async (envelope, ctx, next) => {
+        const procedure = envelope.procedure ?? 'unknown';
+        // Extract parent context from envelope metadata (if propagated)
+        let parentContext;
+        const metadata = envelope.metadata;
+        if (metadata?.traceparent) {
+            parentContext = tracer.extractContext({
+                traceparent: metadata.traceparent,
+                tracestate: metadata.tracestate,
+            });
+        }
+        // Start span with parent context
+        const span = tracer.startSpan(`${procedure}`, {
+            kind: 'server',
+            parent: parentContext,
+            attributes: {
+                'rpc.method': procedure,
+                'rpc.system': 'raffel',
+            },
+        });
+        // Set as active span
+        const previousSpan = tracer.getActiveSpan();
+        tracer.setActiveSpan(span);
+        // Attach span context to ctx for downstream use
+        const _ctxWithSpan = {
+            ...ctx,
+            span,
+            spanContext: span.context,
+        };
+        try {
+            const result = await next();
+            span.setStatus('ok');
+            span.finish();
+            return result;
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                span.recordError(error);
+            }
+            else {
+                span.setStatus('error', String(error));
+            }
+            span.finish();
+            throw error;
+        }
+        finally {
+            // Restore previous active span
+            tracer.setActiveSpan(previousSpan);
+        }
+    };
+}
+/**
+ * Extract trace headers from incoming request
+ */
+export function extractTraceHeaders(headers) {
+    const traceparent = Array.isArray(headers.traceparent)
+        ? headers.traceparent[0]
+        : headers.traceparent;
+    const tracestate = Array.isArray(headers.tracestate)
+        ? headers.tracestate[0]
+        : headers.tracestate;
+    return {
+        traceparent,
+        tracestate,
+    };
+}
+/**
+ * Inject trace headers for outgoing requests
+ */
+export function injectTraceHeaders(tracer, headers) {
+    const activeSpan = tracer.getActiveSpan();
+    if (!activeSpan)
+        return headers;
+    const traceHeaders = tracer.injectContext(activeSpan.context);
+    return {
+        ...headers,
+        ...(traceHeaders.traceparent && { traceparent: traceHeaders.traceparent }),
+        ...(traceHeaders.tracestate && { tracestate: traceHeaders.tracestate }),
+    };
+}
+//# sourceMappingURL=interceptor.js.map

package/dist/tracing/interceptor.js.map

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

package/dist/tracing/sampler.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Span Samplers
+ *
+ * Implementations for different sampling strategies.
+ */
+import type { Sampler } from './types.js';
+/**
+ * Always sample all spans
+ */
+export declare function createAlwaysOnSampler(): Sampler;
+/**
+ * Never sample any spans
+ */
+export declare function createAlwaysOffSampler(): Sampler;
+/**
+ * Sample based on probability (0.0 to 1.0)
+ */
+export declare function createProbabilitySampler(ratio: number): Sampler;
+/**
+ * Rate-limited sampler (max spans per second)
+ */
+export declare function createRateLimitedSampler(maxPerSecond: number): Sampler;
+/**
+ * Parent-based sampler (respects parent's sampling decision)
+ * Falls back to provided sampler for root spans
+ */
+export declare function createParentBasedSampler(rootSampler: Sampler): Sampler;
+/**
+ * Composite sampler that combines probability + rate limiting
+ */
+export declare function createCompositeSampler(probabilityRatio: number, maxPerSecond: number): Sampler;
+//# sourceMappingURL=sampler.d.ts.map

package/dist/tracing/sampler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sampler.d.ts","sourceRoot":"","sources":["../../src/tracing/sampler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAyC,MAAM,YAAY,CAAA;AAEhF;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAM/C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAMhD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAkB/D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAuBtE;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,OAAO,GAAG,OAAO,CAqBtE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,gBAAgB,EAAE,MAAM,EACxB,YAAY,EAAE,MAAM,GACnB,OAAO,CA+BT"}

package/dist/tracing/sampler.js

@@ -0,0 +1,111 @@
+/**
+ * Span Samplers
+ *
+ * Implementations for different sampling strategies.
+ */
+/**
+ * Always sample all spans
+ */
+export function createAlwaysOnSampler() {
+    return {
+        shouldSample() {
+            return { decision: 'record_and_sample' };
+        },
+    };
+}
+/**
+ * Never sample any spans
+ */
+export function createAlwaysOffSampler() {
+    return {
+        shouldSample() {
+            return { decision: 'drop' };
+        },
+    };
+}
+/**
+ * Sample based on probability (0.0 to 1.0)
+ */
+export function createProbabilitySampler(ratio) {
+    // Clamp ratio to valid range
+    const effectiveRatio = Math.max(0, Math.min(1, ratio));
+    return {
+        shouldSample() {
+            if (effectiveRatio === 0) {
+                return { decision: 'drop' };
+            }
+            if (effectiveRatio === 1) {
+                return { decision: 'record_and_sample' };
+            }
+            if (Math.random() < effectiveRatio) {
+                return { decision: 'record_and_sample' };
+            }
+            return { decision: 'drop' };
+        },
+    };
+}
+/**
+ * Rate-limited sampler (max spans per second)
+ */
+export function createRateLimitedSampler(maxPerSecond) {
+    let tokenBucket = maxPerSecond;
+    let lastRefill = Date.now();
+    function refillBucket() {
+        const now = Date.now();
+        const elapsed = (now - lastRefill) / 1000;
+        lastRefill = now;
+        tokenBucket = Math.min(maxPerSecond, tokenBucket + elapsed * maxPerSecond);
+    }
+    return {
+        shouldSample() {
+            refillBucket();
+            if (tokenBucket >= 1) {
+                tokenBucket -= 1;
+                return { decision: 'record_and_sample' };
+            }
+            return { decision: 'drop' };
+        },
+    };
+}
+/**
+ * Parent-based sampler (respects parent's sampling decision)
+ * Falls back to provided sampler for root spans
+ */
+export function createParentBasedSampler(rootSampler) {
+    return {
+        shouldSample(traceId, spanName, spanKind, parentContext) {
+            // If parent exists, follow its decision
+            if (parentContext) {
+                const isSampled = (parentContext.traceFlags & 1) === 1;
+                return {
+                    decision: isSampled ? 'record_and_sample' : 'drop',
+                    traceState: parentContext.traceState,
+                };
+            }
+            // Root span: use root sampler
+            return rootSampler.shouldSample(traceId, spanName, spanKind);
+        },
+    };
+}
+/**
+ * Composite sampler that combines probability + rate limiting
+ */
+export function createCompositeSampler(probabilityRatio, maxPerSecond) {
+    const probabilitySampler = createProbabilitySampler(probabilityRatio);
+    const rateLimiter = maxPerSecond > 0 ? createRateLimitedSampler(maxPerSecond) : null;
+    return {
+        shouldSample(traceId, spanName, spanKind, parentContext) {
+            // First check probability
+            const probResult = probabilitySampler.shouldSample(traceId, spanName, spanKind, parentContext);
+            if (probResult.decision !== 'record_and_sample') {
+                return probResult;
+            }
+            // Then check rate limit
+            if (rateLimiter) {
+                return rateLimiter.shouldSample(traceId, spanName, spanKind, parentContext);
+            }
+            return probResult;
+        },
+    };
+}
+//# sourceMappingURL=sampler.js.map

package/dist/tracing/sampler.js.map

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

package/dist/tracing/span.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Span Implementation
+ *
+ * In-flight span that tracks timing, attributes, and logs.
+ */
+import type { Span, SpanKind, SpanAttributes } from './types.js';
+export interface SpanOptions {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    name: string;
+    kind: SpanKind;
+    isRecording: boolean;
+    attributes?: SpanAttributes;
+}
+/**
+ * Create a new Span instance
+ */
+export declare function createSpan(options: SpanOptions): Span;
+/**
+ * Generate a random ID of specified length (hex string)
+ */
+export declare function generateId(length: number): string;
+/**
+ * Generate a 32-character trace ID
+ */
+export declare function generateTraceId(): string;
+/**
+ * Generate a 16-character span ID
+ */
+export declare function generateSpanId(): string;
+//# sourceMappingURL=span.d.ts.map

package/dist/tracing/span.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"span.d.ts","sourceRoot":"","sources":["../../src/tracing/span.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,IAAI,EAGJ,QAAQ,EAER,cAAc,EAEf,MAAM,YAAY,CAAA;AAEnB,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,QAAQ,CAAA;IACd,WAAW,EAAE,OAAO,CAAA;IACpB,UAAU,CAAC,EAAE,cAAc,CAAA;CAC5B;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CA4HrD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC"}