@blaxel/core 0.2.18-dev.142 → 0.2.18-dev.145

package/dist/telemetry/telemetry.d.ts

@@ -20,7 +20,7 @@ export interface BlaxelSpan {
     /** Record an error on the span */
     recordException(error: Error): void;
     /** Set the status of the span */
-    setStatus(status: 'ok' | 'error', message?: string): void;
+    setStatus(status: "ok" | "error", message?: string): void;
     /** End the span */
     end(): void;
     /** Get the span context (for passing to child spans) */
@@ -34,22 +34,15 @@ export interface BlaxelTelemetryProvider {
     startSpan(name: string, options?: BlaxelSpanOptions): BlaxelSpan;
     /** Flush the telemetry provider */
     flush(): Promise<void>;
+    /** Extract context from headers for manual context propagation */
+    extractContextFromHeaders?(headers: Record<string, string | string[]>): unknown;
 }
 /**
- * Registry for managing the global telemetry provider
+ * Registry for telemetry providers
  */
 declare class TelemetryRegistry {
-    private static instance;
     private provider;
-    private constructor();
-    static getInstance(): TelemetryRegistry;
-    /**
-     * Register a telemetry provider implementation
-     */
     registerProvider(provider: BlaxelTelemetryProvider): void;
-    /**
-     * Get the current telemetry provider
-     */
     getProvider(): BlaxelTelemetryProvider;
 }
 export declare const telemetryRegistry: TelemetryRegistry;
@@ -58,5 +51,18 @@ export declare const telemetryRegistry: TelemetryRegistry;
  */
 export declare function startSpan(name: string, options?: BlaxelSpanOptions): BlaxelSpan;
 export declare function withSpan<T>(name: string, fn: () => Promise<T>, options?: BlaxelSpanOptions): Promise<T>;
+/**
+ * Extract context from headers - useful for manual context propagation
+ * when you have traceparent headers but no active span
+ */
+export declare function extractContextFromHeaders(headers: Record<string, string | string[]>): unknown;
+/**
+ * Create a span with extracted context from headers
+ * This is useful when you need to manually establish trace context
+ */
+export declare function startSpanWithHeaders(name: string, headers: Record<string, string | string[]>, options?: Omit<BlaxelSpanOptions, "parentContext">): BlaxelSpan;
+/**
+ * Flush the telemetry provider
+ */
 export declare function flush(): Promise<void>;
 export {};

package/dist/telemetry/telemetry.js

@@ -4,6 +4,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.telemetryRegistry = void 0;
 exports.startSpan = startSpan;
 exports.withSpan = withSpan;
+exports.extractContextFromHeaders = extractContextFromHeaders;
+exports.startSpanWithHeaders = startSpanWithHeaders;
 exports.flush = flush;
 /**
  * No-operation implementation of Span
@@ -14,7 +16,9 @@ class NoopSpan {
     recordException() { }
     setStatus() { }
     end() { }
-    getContext() { return null; }
+    getContext() {
+        return null;
+    }
 }
 /**
  * No-operation implementation of TelemetryProvider
@@ -23,38 +27,25 @@ class NoopTelemetryProvider {
     startSpan() {
         return new NoopSpan();
     }
-    flush() {
-        return Promise.resolve();
+    async flush() { }
+    extractContextFromHeaders() {
+        return null;
     }
 }
 /**
- * Registry for managing the global telemetry provider
+ * Registry for telemetry providers
  */
 class TelemetryRegistry {
-    static instance;
     provider = new NoopTelemetryProvider();
-    constructor() { }
-    static getInstance() {
-        if (!TelemetryRegistry.instance) {
-            TelemetryRegistry.instance = new TelemetryRegistry();
-        }
-        return TelemetryRegistry.instance;
-    }
-    /**
-     * Register a telemetry provider implementation
-     */
     registerProvider(provider) {
         this.provider = provider;
     }
-    /**
-     * Get the current telemetry provider
-     */
     getProvider() {
         return this.provider;
     }
 }
-// Export singleton instance
-exports.telemetryRegistry = TelemetryRegistry.getInstance();
+// Global instance
+exports.telemetryRegistry = new TelemetryRegistry();
 // Convenience functions that delegate to the provider
 /**
  * Create a span with the registered provider
@@ -75,6 +66,31 @@ async function withSpan(name, fn, options) {
         throw error;
     }
 }
+/**
+ * Extract context from headers - useful for manual context propagation
+ * when you have traceparent headers but no active span
+ */
+function extractContextFromHeaders(headers) {
+    const provider = exports.telemetryRegistry.getProvider();
+    if (provider.extractContextFromHeaders) {
+        return provider.extractContextFromHeaders(headers);
+    }
+    return null;
+}
+/**
+ * Create a span with extracted context from headers
+ * This is useful when you need to manually establish trace context
+ */
+function startSpanWithHeaders(name, headers, options) {
+    const extractedContext = extractContextFromHeaders(headers);
+    return startSpan(name, {
+        ...options,
+        parentContext: extractedContext || undefined,
+    });
+}
+/**
+ * Flush the telemetry provider
+ */
 async function flush() {
-    await exports.telemetryRegistry.getProvider().flush();
+    return exports.telemetryRegistry.getProvider().flush();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blaxel/core",
-  "version": "0.2.18-dev.142",
+  "version": "0.2.18-dev.145",
   "description": "Blaxel Core SDK for TypeScript",
   "license": "MIT",
   "author": "Blaxel, INC (https://blaxel.ai)",