@traccia2/sdk 0.0.1

package/dist/tracer/span.js

@@ -0,0 +1,118 @@
+"use strict";
+/**
+ * Span implementation with lifecycle management.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Span = void 0;
+const types_1 = require("../types");
+const span_context_1 = require("./span-context");
+const runtime_config_1 = require("../config/runtime-config");
+/**
+ * Span implementation representing a unit of work.
+ */
+class Span {
+    constructor(name, _tracer, context, parentSpanId, attributes) {
+        this.events = [];
+        this.status = types_1.SpanStatus.UNSET;
+        this.ended = false;
+        this.name = name;
+        this.context = context;
+        this.parentSpanId = parentSpanId;
+        this.attributes = attributes ? { ...attributes } : {};
+        this.startTimeNs = performance.now() * 1000000;
+        // Apply runtime metadata to tracestate
+        this.enrichTraceState();
+    }
+    /**
+     * Get the duration in nanoseconds.
+     */
+    get durationNs() {
+        if (this.endTimeNs === undefined) {
+            return undefined;
+        }
+        return this.endTimeNs - this.startTimeNs;
+    }
+    /**
+     * Set an attribute on the span.
+     */
+    setAttribute(key, value) {
+        if (this.ended) {
+            return;
+        }
+        this.attributes[key] = value;
+    }
+    /**
+     * Add an event to the span.
+     */
+    addEvent(name, attributes) {
+        if (this.ended) {
+            return;
+        }
+        this.events.push({
+            name,
+            timestamp: performance.now() * 1000000,
+            attributes: attributes ? { ...attributes } : {},
+        });
+    }
+    /**
+     * Record an exception on the span.
+     */
+    recordException(error, attributes) {
+        if (this.ended) {
+            return;
+        }
+        this.status = types_1.SpanStatus.ERROR;
+        this.statusDescription = error.message;
+        this.addEvent('exception', {
+            ...attributes,
+            'exception.type': error.name,
+            'exception.message': error.message,
+            'exception.stacktrace': error.stack,
+        });
+    }
+    /**
+     * End the span.
+     */
+    end() {
+        if (this.ended) {
+            return;
+        }
+        this.ended = true;
+        this.endTimeNs = performance.now() * 1000000;
+    }
+    /**
+     * Check if the span is still recording.
+     */
+    isRecording() {
+        return !this.ended;
+    }
+    /**
+     * Enrich the trace state with runtime metadata.
+     */
+    enrichTraceState() {
+        try {
+            const config = (0, runtime_config_1.getConfig)();
+            let traceState = this.context.traceState || '';
+            const metadata = {};
+            if (config.tenantId) {
+                metadata['tenant'] = config.tenantId;
+            }
+            if (config.projectId) {
+                metadata['project'] = config.projectId;
+            }
+            if (config.debug) {
+                metadata['dbg'] = '1';
+            }
+            if (Object.keys(metadata).length > 0) {
+                const pairs = Object.entries(metadata).map(([k, v]) => `${k}=${v}`);
+                traceState = pairs.join(',');
+                this.context = new span_context_1.SpanContext(this.context.traceId, this.context.spanId, this.context.traceFlags, traceState);
+            }
+        }
+        catch {
+            // Silently fail on trace state enrichment
+        }
+    }
+}
+exports.Span = Span;
+//# sourceMappingURL=span.js.map

package/dist/tracer/span.js.map

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

package/dist/tracer/tracer.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Tracer implementation for creating and managing spans.
+ */
+import { ITracer, ISpan, ISpanContext } from '../types';
+import { TracerProvider } from './provider';
+/**
+ * Tracer for creating and managing spans.
+ */
+export declare class Tracer implements ITracer {
+    private provider;
+    constructor(provider: TracerProvider, _instrumentationScope: string);
+    /**
+     * Start a new span.
+     */
+    startSpan(name: string, options?: {
+        attributes?: Record<string, unknown>;
+        parent?: ISpan | null;
+        parentContext?: ISpanContext | null;
+    }): ISpan;
+    /**
+     * Start an active span and run a function within it.
+     */
+    startActiveSpan<T = unknown>(name: string, fn: (span: ISpan) => Promise<T> | T, options?: {
+        attributes?: Record<string, unknown>;
+        parent?: ISpan | null;
+    }): Promise<T>;
+}
+//# sourceMappingURL=tracer.d.ts.map

package/dist/tracer/tracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracer.d.ts","sourceRoot":"","sources":["../../src/tracer/tracer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAIxD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C;;GAEG;AACH,qBAAa,MAAO,YAAW,OAAO;IACpC,OAAO,CAAC,QAAQ,CAAiB;gBAErB,QAAQ,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM;IAInE;;OAEG;IACH,SAAS,CACP,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,MAAM,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;QACtB,aAAa,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;KACrC,GACA,KAAK;IAyCR;;OAEG;IACG,eAAe,CAAC,CAAC,GAAG,OAAO,EAC/B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EACnC,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,MAAM,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;KACvB,GACA,OAAO,CAAC,CAAC,CAAC;CAiBd"}

package/dist/tracer/tracer.js

@@ -0,0 +1,75 @@
+"use strict";
+/**
+ * Tracer implementation for creating and managing spans.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Tracer = void 0;
+const span_1 = require("./span");
+const span_context_1 = require("./span-context");
+const context_1 = require("../context/context");
+const runtime_config_1 = require("../config/runtime-config");
+/**
+ * Tracer for creating and managing spans.
+ */
+class Tracer {
+    constructor(provider, _instrumentationScope) {
+        this.provider = provider;
+    }
+    /**
+     * Start a new span.
+     */
+    startSpan(name, options) {
+        const parentSpan = options?.parent ?? (0, context_1.getCurrentSpan)();
+        const effectiveContext = options?.parentContext || parentSpan?.context;
+        let traceId;
+        let parentSpanId;
+        let traceFlags;
+        if (parentSpan) {
+            traceId = parentSpan.context.traceId;
+            parentSpanId = parentSpan.context.spanId;
+            traceFlags = parentSpan.context.traceFlags;
+        }
+        else if (effectiveContext && new span_context_1.SpanContext(effectiveContext.traceId, effectiveContext.spanId).isValid()) {
+            traceId = effectiveContext.traceId;
+            parentSpanId = effectiveContext.spanId;
+            traceFlags = effectiveContext.traceFlags;
+        }
+        else {
+            traceId = this.provider.generateTraceId();
+            parentSpanId = undefined;
+            const sampler = this.provider.getSampler();
+            const sampled = sampler ? sampler.shouldSample().sampled : true;
+            traceFlags = sampled ? 1 : 0;
+            // Debug override: force sampling for new root traces
+            const config = (0, runtime_config_1.getConfig)();
+            if (config.debug) {
+                traceFlags = 1;
+            }
+        }
+        const spanContext = new span_context_1.SpanContext(traceId, this.provider.generateSpanId(), traceFlags, effectiveContext?.traceState);
+        return new span_1.Span(name, this, spanContext, parentSpanId, options?.attributes);
+    }
+    /**
+     * Start an active span and run a function within it.
+     */
+    async startActiveSpan(name, fn, options) {
+        const span = this.startSpan(name, options);
+        try {
+            const result = await (0, context_1.runWithSpanAsync)(span, async () => {
+                return await Promise.resolve(fn(span));
+            });
+            return result;
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                span.recordException(error);
+            }
+            throw error;
+        }
+        finally {
+            span.end();
+        }
+    }
+}
+exports.Tracer = Tracer;
+//# sourceMappingURL=tracer.js.map

package/dist/tracer/tracer.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Core types and interfaces for the tracing SDK.
+ */
+/**
+ * Span status enumeration.
+ */
+export declare enum SpanStatus {
+    UNSET = 0,
+    OK = 1,
+    ERROR = 2
+}
+/**
+ * Span context carries trace and span identification across process boundaries.
+ */
+export interface ISpanContext {
+    traceId: string;
+    spanId: string;
+    traceFlags: number;
+    traceState?: string;
+}
+/**
+ * Span event for capturing events during span execution.
+ */
+export interface SpanEvent {
+    name: string;
+    timestamp: number;
+    attributes?: Record<string, unknown>;
+}
+/**
+ * Span interface for creating and ending spans.
+ */
+export interface ISpan {
+    context: ISpanContext;
+    name: string;
+    parentSpanId?: string;
+    attributes: Record<string, unknown>;
+    events: SpanEvent[];
+    status: SpanStatus;
+    statusDescription?: string;
+    startTimeNs: number;
+    endTimeNs?: number;
+    durationNs: number | undefined;
+    setAttribute(key: string, value: unknown): void;
+    addEvent(name: string, attributes?: Record<string, unknown>): void;
+    end(): void;
+    recordException(error: Error, attributes?: Record<string, unknown>): void;
+    isRecording(): boolean;
+}
+/**
+ * Tracer for creating and managing spans.
+ */
+export interface ITracer {
+    startSpan(name: string, options?: {
+        attributes?: Record<string, unknown>;
+        parent?: ISpan | null;
+        parentContext?: ISpanContext | null;
+    }): ISpan;
+    startActiveSpan<T = unknown>(name: string, fn: (span: ISpan) => Promise<T> | T, options?: {
+        attributes?: Record<string, unknown>;
+        parent?: ISpan | null;
+    }): Promise<T> | T;
+}
+/**
+ * Span processor for handling spans at various lifecycle points.
+ */
+export interface ISpanProcessor {
+    onStart?(span: ISpan): void;
+    onEnd(span: ISpan): void;
+    shutdown(): Promise<void> | void;
+    forceFlush(timeout?: number): Promise<void> | void;
+}
+/**
+ * Span exporter for sending spans to a backend.
+ */
+export interface ISpanExporter {
+    export(spans: ISpan[]): Promise<boolean> | boolean;
+    shutdown(): Promise<void> | void;
+}
+/**
+ * Resource attributes describing the service.
+ */
+export interface Resource {
+    [key: string]: string | number | boolean;
+}
+/**
+ * Tracer provider for managing tracers and processors.
+ */
+export interface ITracerProvider {
+    getTracer(name: string, version?: string): ITracer;
+    addSpanProcessor(processor: ISpanProcessor): void;
+    removeSpanProcessor(processor: ISpanProcessor): void;
+    forceFlush(timeout?: number): Promise<void>;
+    shutdown(): Promise<void>;
+}
+/**
+ * Configuration for the SDK initialization.
+ */
+export interface SDKConfig {
+    apiKey?: string;
+    endpoint?: string;
+    sampleRate?: number;
+    maxQueueSize?: number;
+    maxExportBatchSize?: number;
+    scheduleDelayMs?: number;
+    enableConsoleExporter?: boolean;
+    enableTokenCounting?: boolean;
+    enableCostTracking?: boolean;
+    enableSpanLogging?: boolean;
+    pricingOverride?: Record<string, Record<string, number>>;
+    sessionId?: string;
+    userId?: string;
+    tenantId?: string;
+    projectId?: string;
+    debug?: boolean;
+    attrTruncationLimit?: number;
+    loadEnv?: boolean;
+    autoInstrument?: boolean;
+    toolInclude?: string[];
+    maxToolSpans?: number;
+    maxSpanDepth?: number;
+    resource?: Resource;
+}
+/**
+ * Sampling result for span sampling decisions.
+ */
+export interface SamplingResult {
+    sampled: boolean;
+}
+/**
+ * Sampler interface for making sampling decisions.
+ */
+export interface ISampler {
+    shouldSample(): SamplingResult;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * Core types and interfaces for the tracing SDK.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpanStatus = void 0;
+/**
+ * Span status enumeration.
+ */
+var SpanStatus;
+(function (SpanStatus) {
+    SpanStatus[SpanStatus["UNSET"] = 0] = "UNSET";
+    SpanStatus[SpanStatus["OK"] = 1] = "OK";
+    SpanStatus[SpanStatus["ERROR"] = 2] = "ERROR";
+})(SpanStatus || (exports.SpanStatus = SpanStatus = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH;;GAEG;AACH,IAAY,UAIX;AAJD,WAAY,UAAU;IACpB,6CAAS,CAAA;IACT,uCAAM,CAAA;IACN,6CAAS,CAAA;AACX,CAAC,EAJW,UAAU,0BAAV,UAAU,QAIrB"}

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@traccia2/sdk",
+  "version": "0.0.1",
+  "description": "Tracing SDK for agent applications",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./auto": {
+      "import": "./dist/auto.js",
+      "require": "./dist/auto.js",
+      "types": "./dist/auto.d.ts"
+    },
+    "./tracer": {
+      "import": "./dist/tracer/index.js",
+      "require": "./dist/tracer/index.js",
+      "types": "./dist/tracer/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "LICENSE",
+    "README.md"
+  ],
+  "keywords": [
+    "tracing",
+    "observability",
+    "agent",
+    "instrumentation",
+    "opentelemetry"
+  ],
+  "author": "Traccia",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/traccia/sdk-ts"
+  },
+  "bugs": {
+    "url": "https://github.com/traccia/sdk-ts/issues"
+  },
+  "homepage": "https://github.com/traccia/sdk-ts#readme",
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "clean": "rm -rf dist",
+    "prebuild": "npm run clean",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:cov": "jest --coverage",
+    "prepublishOnly": "npm run build && npm run test",
+    "prepare": "npm run build"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.11",
+    "@types/node": "^20.10.6",
+    "@typescript-eslint/eslint-plugin": "^6.17.0",
+    "@typescript-eslint/parser": "^6.17.0",
+    "eslint": "^8.56.0",
+    "jest": "^29.7.0",
+    "prettier": "^3.1.1",
+    "ts-jest": "^29.1.1",
+    "typescript": "^5.3.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {}
+}

package/src/__tests__/exporter.test.ts

@@ -0,0 +1,62 @@
+/**
+ * Tests for exporters.
+ */
+
+import { HttpExporter } from '../exporter/http-exporter';
+import { ConsoleExporter } from '../exporter/console-exporter';
+import { TracerProvider } from '../tracer/provider';
+
+describe('HttpExporter', () => {
+  it('should create with options', () => {
+    const exporter = new HttpExporter({
+      endpoint: 'https://example.com/traces',
+      apiKey: 'test-key',
+    });
+
+    expect(exporter).toBeDefined();
+  });
+
+  it.skip('should serialize spans', async () => {
+    const exporter = new HttpExporter({
+      endpoint: 'http://localhost:9999', // Non-existent endpoint
+    });
+    const provider = new TracerProvider();
+    const tracer = provider.getTracer('test');
+    const span = tracer.startSpan('test-span', {
+      attributes: { key: 'value' },
+    });
+
+    span.end();
+
+    const result = await exporter.export([span]);
+    // Result depends on endpoint availability
+    expect(typeof result).toBe('boolean');
+  });
+
+  it('should handle shutdown', async () => {
+    const exporter = new HttpExporter();
+    await expect(exporter.shutdown()).resolves.toBeUndefined();
+  });
+});
+
+describe('ConsoleExporter', () => {
+  it('should export spans to console', async () => {
+    const exporter = new ConsoleExporter();
+    const provider = new TracerProvider();
+    const tracer = provider.getTracer('test');
+    const span = tracer.startSpan('test-span');
+
+    span.end();
+
+    const consoleSpy = jest.spyOn(console, 'log').mockImplementation();
+    await exporter.export([span]);
+
+    expect(consoleSpy).toHaveBeenCalled();
+    consoleSpy.mockRestore();
+  });
+
+  it('should handle shutdown', async () => {
+    const exporter = new ConsoleExporter();
+    await expect(exporter.shutdown()).resolves.toBeUndefined();
+  });
+});