@brizz/sdk 0.1.0-alpha.6

package/dist/internal/trace/tracing.js

@@ -0,0 +1,97 @@
+import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';
+import { BatchSpanProcessor, SimpleSpanProcessor } from '@opentelemetry/sdk-trace-base';
+import { logger } from '../logger';
+import { MaskedBatchSpanProcessor, MaskedSimpleSpanProcessor } from './processors/span-masked';
+export class TracingModule {
+    static instance = null;
+    spanExporter = null;
+    spanProcessor = null;
+    static getInstance() {
+        if (!TracingModule.instance) {
+            throw new Error('Brizz must be initialized before accessing TracingModule');
+        }
+        return TracingModule.instance;
+    }
+    setup(config) {
+        logger.info('Setting up tracing module');
+        this.initSpanExporter(config);
+        this.initSpanProcessor(config);
+        TracingModule.instance = this;
+        logger.info('Tracing module setup completed');
+    }
+    initSpanExporter(config) {
+        if (this.spanExporter) {
+            logger.debug('Span exporter already initialized, skipping re-initialization');
+            return;
+        }
+        if (config.customSpanExporter) {
+            logger.debug('Using custom span exporter');
+            this.spanExporter = config.customSpanExporter;
+            logger.debug('Custom span exporter initialized successfully');
+            return;
+        }
+        const tracesUrl = config.baseUrl.replace(/\/$/, '') + '/v1/traces';
+        logger.debug('Initializing default OTLP span exporter', { url: tracesUrl });
+        this.spanExporter = new OTLPTraceExporter({
+            url: tracesUrl,
+            headers: config.headers,
+        });
+        logger.debug('OTLP span exporter initialized successfully');
+    }
+    initSpanProcessor(config) {
+        if (this.spanProcessor) {
+            logger.debug('Span processor already initialized, skipping re-initialization');
+            return;
+        }
+        if (!this.spanExporter) {
+            throw new Error('Span exporter must be initialized before processor');
+        }
+        logger.debug('Initializing span processor', {
+            disableBatch: config.disableBatch,
+            hasMasking: !!config.masking?.spanMasking,
+        });
+        if (config.masking?.spanMasking) {
+            this.spanProcessor = config.disableBatch
+                ? new MaskedSimpleSpanProcessor(this.spanExporter, config.masking.spanMasking)
+                : new MaskedBatchSpanProcessor(this.spanExporter, config.masking.spanMasking);
+        }
+        else {
+            this.spanProcessor = config.disableBatch
+                ? new SimpleSpanProcessor(this.spanExporter)
+                : new BatchSpanProcessor(this.spanExporter);
+        }
+        logger.debug('Span processor initialized successfully');
+    }
+    getSpanExporter() {
+        if (!this.spanExporter) {
+            throw new Error('Tracing module not initialized');
+        }
+        return this.spanExporter;
+    }
+    getSpanProcessor() {
+        if (!this.spanProcessor) {
+            throw new Error('Tracing module not initialized');
+        }
+        return this.spanProcessor;
+    }
+    async shutdown() {
+        logger.debug('Shutting down tracing module');
+        if (this.spanProcessor) {
+            await this.spanProcessor.shutdown();
+            this.spanProcessor = null;
+        }
+        if (this.spanExporter) {
+            await this.spanExporter.shutdown();
+            this.spanExporter = null;
+        }
+        TracingModule.instance = null;
+        logger.debug('Tracing module shutdown completed');
+    }
+}
+export function getSpanExporter() {
+    return TracingModule.getInstance().getSpanExporter();
+}
+export function getSpanProcessor() {
+    return TracingModule.getInstance().getSpanProcessor();
+}
+//# sourceMappingURL=tracing.js.map

package/dist/internal/trace/tracing.js.map

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

package/package.json

@@ -0,0 +1,130 @@
+{
+  "name": "@brizz/sdk",
+  "version": "0.1.0-alpha.6",
+  "type": "module",
+  "description": "OpenTelemetry-based observability SDK for AI applications",
+  "keywords": [
+    "brizz",
+    "sdk",
+    "api",
+    "typescript",
+    "client",
+    "ai",
+    "observability",
+    "tracing",
+    "monitoring",
+    "llm",
+    "openai",
+    "anthropic",
+    "telemetry"
+  ],
+  "license": "MIT",
+  "author": {
+    "name": "Brizz",
+    "email": "support@brizz.com",
+    "url": "https://brizz.com"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@changesets/changelog-github": "^0.5.1",
+    "@changesets/cli": "^2.29.5",
+    "@eslint/js": "^9.0.0",
+    "@types/jest": "^29.5.0",
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "^9.0.0",
+    "eslint-config-prettier": "^9.0.0",
+    "eslint-plugin-import": "^2.0.0",
+    "eslint-plugin-promise": "^7.0.0",
+    "eslint-plugin-unicorn": "^56.0.0",
+    "jest": "^29.5.0",
+    "prettier": "^3.0.0",
+    "ts-jest": "^29.1.0",
+    "typescript": "^5.0.0"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "typescript": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/api-logs": "^0.203.0",
+    "@opentelemetry/auto-instrumentations-node": "^0.62.0",
+    "@opentelemetry/core": "^2.0.1",
+    "@opentelemetry/exporter-logs-otlp-http": "^0.203.0",
+    "@opentelemetry/exporter-metrics-otlp-http": "^0.203.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.203.0",
+    "@opentelemetry/instrumentation": "^0.203.0",
+    "@opentelemetry/resources": "^2.0.1",
+    "@opentelemetry/sdk-logs": "^0.203.0",
+    "@opentelemetry/sdk-metrics": "^2.0.1",
+    "@opentelemetry/sdk-node": "^0.203.0",
+    "@opentelemetry/sdk-trace-base": "^2.0.1",
+    "@opentelemetry/sdk-trace-node": "^2.0.1",
+    "@opentelemetry/semantic-conventions": "^1.36.0",
+    "@traceloop/ai-semantic-conventions": "^v0.14.0",
+    "@traceloop/instrumentation-anthropic": "^v0.14.6",
+    "@traceloop/instrumentation-bedrock": "^v0.14.6",
+    "@traceloop/instrumentation-chromadb": "^v0.14.6",
+    "@traceloop/instrumentation-cohere": "^v0.14.6",
+    "@traceloop/instrumentation-langchain": "^v0.14.6",
+    "@traceloop/instrumentation-llamaindex": "^v0.14.6",
+    "@traceloop/instrumentation-openai": "^v0.14.6",
+    "@traceloop/instrumentation-pinecone": "^v0.14.6",
+    "@traceloop/instrumentation-qdrant": "^v0.14.6",
+    "@traceloop/instrumentation-together": "^v0.14.6",
+    "@traceloop/instrumentation-vertexai": "^v0.14.6",
+    "tslib": "^2.6.0",
+    "winston": "^3.17.0"
+  },
+  "scripts": {
+    "build": "pnpm run clean && tsc -p tsconfig.build.json",
+    "build:watch": "tsc -p tsconfig.build.json --watch",
+    "dev": "pnpm run build:watch",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist coverage *.tsbuildinfo .cache",
+    "clean:all": "pnpm run clean && rm -rf node_modules pnpm-lock.yaml",
+    "quality": "pnpm run lint && pnpm run format && pnpm run type-check && pnpm run test",
+    "pack": "pnpm run build && pnpm pack",
+    "changeset": "changeset",
+    "changeset:version": "changeset version && pnpm install --lockfile-only",
+    "changeset:publish": "pnpm build && changeset publish",
+    "changeset:status": "changeset status --verbose",
+    "prerelease:enter": "changeset pre enter",
+    "prerelease:exit": "changeset pre exit"
+  }
+}