@bitfab/sdk 0.54.5 → 0.54.7

package/dist/{http-36EP65LE.js → http-I5VDJLSJ.js}

@@ -6,7 +6,7 @@ import {
   flushTraces,
   parseRetryAfterMs,
   serializePayloadBody
-} from "./chunk-3STIE5QL.js";
+} from "./chunk-OIIMVPTH.js";
 export {
   BitfabError,
   HttpClient,
@@ -16,4 +16,4 @@ export {
   parseRetryAfterMs,
   serializePayloadBody
 };
-//# sourceMappingURL=http-36EP65LE.js.map
+//# sourceMappingURL=http-I5VDJLSJ.js.map

package/dist/{http-JQ4RXRWH.js → http-RGNLMMZQ.js}

@@ -6,7 +6,7 @@ import {
   flushTraces,
   parseRetryAfterMs,
   serializePayloadBody
-} from "./chunk-PIF5HH3Z.js";
+} from "./chunk-JF56DBPP.js";
 import "./chunk-VCRFFCLY.js";
 export {
   BitfabError,
@@ -17,4 +17,4 @@ export {
   parseRetryAfterMs,
   serializePayloadBody
 };
-//# sourceMappingURL=http-JQ4RXRWH.js.map
+//# sourceMappingURL=http-RGNLMMZQ.js.map

package/dist/index.cjs

@@ -42,7 +42,7 @@ var __version__, __packageName__;
 var init_version_generated = __esm({
   "src/version.generated.ts"() {
     "use strict";
-    __version__ = "0.54.5";
+    __version__ = "0.54.7";
     __packageName__ = "@bitfab/sdk";
   }
 });
@@ -2313,6 +2313,15 @@ var init_http = __esm({
       resolveApiKey() {
         return typeof this.apiKey === "function" ? this.apiKey() : this.apiKey;
       }
+      /** @internal Whether this client currently has credentials for trace delivery. */
+      hasApiKey() {
+        try {
+          const apiKey = this.resolveApiKey();
+          return apiKey !== void 0 && apiKey.trim() !== "";
+        } catch {
+          return false;
+        }
+      }
       /**
        * This client's span transport, built on first use.
        *
@@ -4490,6 +4499,7 @@ var BitfabClaudeAgentHandler = class {
     });
     this.traceFunctionKey = config.traceFunctionKey;
     this.getActiveSpanContext = config.getActiveSpanContext ?? null;
+    this.shouldRecord = config.shouldRecord ?? (() => this.httpClient.hasApiKey());
     this.preToolUseHook = this.preToolUseHook.bind(this);
     this.postToolUseHook = this.postToolUseHook.bind(this);
     this.postToolUseFailureHook = this.postToolUseFailureHook.bind(this);
@@ -4594,6 +4604,9 @@ var BitfabClaudeAgentHandler = class {
     this.httpClient.traceCompletion.end(spanInfo.traceId, spanInfo.spanId);
   }
   sendSpan(spanInfo) {
+    if (!this.shouldRecord()) {
+      return;
+    }
     const spanData = {
       name: spanInfo.name,
       type: spanInfo.type
@@ -4637,6 +4650,9 @@ var BitfabClaudeAgentHandler = class {
     }
   }
   sendTraceCompletion(endedAt, metadata) {
+    if (!this.shouldRecord()) {
+      return;
+    }
     if (this.traceId === null) {
       return;
     }
@@ -6178,6 +6194,7 @@ var BitfabLangGraphCallbackHandler = class {
     });
     this.traceFunctionKey = config.traceFunctionKey;
     this.getActiveSpanContext = config.getActiveSpanContext ?? null;
+    this.shouldRecord = config.shouldRecord ?? (() => this.httpClient.hasApiKey());
     this.captureTools = config.captureTools ?? true;
   }
   /**
@@ -6286,6 +6303,9 @@ var BitfabLangGraphCallbackHandler = class {
     this.httpClient.traceCompletion.end(spanInfo.traceId, spanInfo.spanId);
   }
   sendSpan(spanInfo) {
+    if (!this.shouldRecord()) {
+      return;
+    }
     const spanData = {
       name: spanInfo.name,
       type: spanInfo.type
@@ -6329,6 +6349,9 @@ var BitfabLangGraphCallbackHandler = class {
     }
   }
   sendTraceCompletion(rootSpan, activeContext) {
+    if (!this.shouldRecord()) {
+      return;
+    }
     const completed = activeContext === null;
     const traceData = {
       id: rootSpan.traceId,
@@ -6349,6 +6372,9 @@ var BitfabLangGraphCallbackHandler = class {
     }
   }
   sendTraceStart(rootSpan) {
+    if (!this.shouldRecord()) {
+      return;
+    }
     const traceData = {
       id: rootSpan.traceId,
       type: "sdk-function",
@@ -7000,12 +7026,6 @@ var TracesClient = class {
   constructor(httpClient) {
     this.httpClient = httpClient;
   }
-  /**
-   * Search traces by exact caller metadata.
-   *
-   * Keys and values are matched case-insensitively. Up to 10 supplied pairs
-   * must match. Use `nextCursor` from the result to fetch another page.
-   */
   async search(params) {
     return this.httpClient.request(SEARCH_PATH, params);
   }
@@ -7063,6 +7083,7 @@ var BitfabOpenAITracingProcessor = class {
       timeout: config.timeout ?? 1e4
     });
     this.getActiveSpanContext = config.getActiveSpanContext ?? null;
+    this.shouldRecord = config.shouldRecord ?? (() => this.httpClient.hasApiKey());
   }
   getCanonicalTraceId(sourceTraceId) {
     const existing = this.canonicalTraceIds[sourceTraceId];
@@ -7183,6 +7204,9 @@ var BitfabOpenAITracingProcessor = class {
    * the OpenAI trace into an outer withSpan trace.
    */
   sendTrace(trace, options = {}) {
+    if (!this.shouldRecord()) {
+      return;
+    }
     try {
       const traceData = trace.toJSON();
       if (options.sourceTraceId) {
@@ -7297,6 +7321,9 @@ var BitfabOpenAITracingProcessor = class {
    * and parent_id are rewritten to link the span into the withSpan tree.
    */
   sendSpan(span) {
+    if (!this.shouldRecord()) {
+      return;
+    }
     const errors = [];
     const [serializedSpan, exportErrors] = this.exportSpan(span);
     errors.push(...exportErrors);
@@ -8394,6 +8421,11 @@ var Bitfab = class {
     }
     return this.resolveApiKey() !== void 0;
   }
+  prepareFrameworkIntegration() {
+    if (this.captureConfigured && this.strict) {
+      this.resolveApiKey();
+    }
+  }
   get captureEnabled() {
     return this.isCaptureEnabled();
   }
@@ -8451,14 +8483,16 @@ var Bitfab = class {
           resultStr = String(executionResult.result);
         }
       }
-      this.httpClient.sendInternalTrace(functionVersion.id, {
-        result: resultStr,
-        source: "typescript-sdk",
-        ...Object.keys(inputs).length > 0 && { inputs },
-        ...executionResult.rawCollector != null && {
-          rawCollector: executionResult.rawCollector
-        }
-      });
+      if (this.shouldRecord()) {
+        this.httpClient.sendInternalTrace(functionVersion.id, {
+          result: resultStr,
+          source: "typescript-sdk",
+          ...Object.keys(inputs).length > 0 && { inputs },
+          ...executionResult.rawCollector != null && {
+            rawCollector: executionResult.rawCollector
+          }
+        });
+      }
       return executionResult.result;
     } catch (error) {
       if (error instanceof BitfabError) {
@@ -8488,11 +8522,10 @@ var Bitfab = class {
    * @returns A BitfabOpenAITracingProcessor instance configured for this client
    */
   getOpenAiTracingProcessor() {
+    this.prepareFrameworkIntegration();
     return new BitfabOpenAITracingProcessor({
-      // Resolved at getter-call time (framework handlers are set up after env
-      // loads); the withSpan path stays lazy via the constructor HttpClient thunk.
-      apiKey: this.resolveApiKey(),
       serviceUrl: this.serviceUrl,
+      shouldRecord: () => this.shouldRecord(),
       getActiveSpanContext: () => {
         const stack = getSpanStack();
         return stack[stack.length - 1] ?? null;
@@ -8550,10 +8583,11 @@ var Bitfab = class {
    * @returns A BitfabLangGraphCallbackHandler configured for this client
    */
   getLangGraphCallbackHandler(traceFunctionKey) {
+    this.prepareFrameworkIntegration();
     return new BitfabLangGraphCallbackHandler({
-      apiKey: this.resolveApiKey(),
       traceFunctionKey,
       serviceUrl: this.serviceUrl,
+      shouldRecord: () => this.shouldRecord(),
       getActiveSpanContext: () => {
         const stack = getSpanStack();
         return stack[stack.length - 1] ?? null;
@@ -8592,10 +8626,11 @@ var Bitfab = class {
    * @experimental This API may change before it is stable.
    */
   getLangGraphIntegration(traceFunctionKey, options) {
+    this.prepareFrameworkIntegration();
     const callbackHandler = new BitfabLangGraphCallbackHandler({
-      apiKey: this.resolveApiKey(),
       traceFunctionKey,
       serviceUrl: this.serviceUrl,
+      shouldRecord: () => this.shouldRecord(),
       getActiveSpanContext: () => {
         const stack = getSpanStack();
         return stack[stack.length - 1] ?? null;
@@ -8634,10 +8669,11 @@ var Bitfab = class {
    * @returns A BitfabClaudeAgentHandler configured for this client
    */
   getClaudeAgentHandler(traceFunctionKey) {
+    this.prepareFrameworkIntegration();
     return new BitfabClaudeAgentHandler({
-      apiKey: this.resolveApiKey(),
       traceFunctionKey,
       serviceUrl: this.serviceUrl,
+      shouldRecord: () => this.shouldRecord(),
       getActiveSpanContext: () => {
         const stack = getSpanStack();
         return stack[stack.length - 1] ?? null;