@bitfab/sdk 0.16.0 → 0.16.2

package/dist/index.d.cts

@@ -343,9 +343,9 @@ declare class ReplayEnvironment {
 type MockStrategy = "none" | "all" | "marked";
 interface ReplayOptions {
     /**
-     * Maximum number of traces to replay (1–100, default 5). Mutually
-     * exclusive with `traceIds` — an explicit ID list already determines how
-     * many traces replay, so passing both throws.
+     * Maximum number of traces to replay (1-100, default 5). Ignored when
+     * `traceIds` is passed (with a warning): an explicit ID list already
+     * determines how many traces replay.
      */
     limit?: number;
     /** Optional list of specific trace IDs to replay (max 100). */
@@ -812,6 +812,22 @@ declare class Bitfab {
      * @returns A BitfabLangGraphCallbackHandler configured for this client
      */
     getLangGraphCallbackHandler(traceFunctionKey: string): BitfabLangGraphCallbackHandler;
+    /**
+     * Get a LangChain callback handler for tracing.
+     *
+     * Alias of {@link getLangGraphCallbackHandler}: LangChain chains and
+     * LangGraph graphs share the same callback system, so one handler serves
+     * both.
+     *
+     * ```typescript
+     * const handler = client.getLangChainCallbackHandler("my-chain");
+     * const result = await chain.invoke(input, { callbacks: [handler] });
+     * ```
+     *
+     * @param traceFunctionKey - Groups traces under this key in Bitfab
+     * @returns A BitfabLangGraphCallbackHandler configured for this client
+     */
+    getLangChainCallbackHandler(traceFunctionKey: string): BitfabLangGraphCallbackHandler;
     /**
      * Get a Claude Agent SDK handler for tracing.
      *
@@ -959,9 +975,9 @@ declare class Bitfab {
      *
      * @param traceFunctionKey - The trace function key to replay
      * @param fn - The function to replay (must be the return value of `withSpan`)
-     * @param options - Optional replay options. `limit` and `traceIds` are
-     *   mutually exclusive — an explicit ID list already determines how many
-     *   traces replay, so passing both throws a BitfabError.
+     * @param options - Optional replay options. When `traceIds` is passed,
+     *   `limit` is ignored (with a warning): an explicit ID list already
+     *   determines how many traces replay.
      * @returns ReplayResult with items, testRunId, and testRunUrl
      */
     replay<TReturn>(traceFunctionKey: string, fn: (...args: any[]) => TReturn | Promise<TReturn>, options?: ReplayOptions): Promise<ReplayResult<TReturn>>;
@@ -1027,7 +1043,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.16.0";
+declare const __version__ = "0.16.2";
 
 /**
  * Constants for the Bitfab SDK.
@@ -1037,4 +1053,4 @@ declare const __version__ = "0.16.0";
  */
 declare const DEFAULT_SERVICE_URL = "https://bitfab.ai";
 
-export { type ActiveSpanContext, type AdaptContext, type AdaptInputsFn, type AllowedEnvVars, type BamlExecutionResult, Bitfab, BitfabClaudeAgentHandler, type BitfabConfig, BitfabError, BitfabFunction, BitfabLangGraphCallbackHandler, BitfabOpenAITracingProcessor, type CodeChangeFile, type CurrentSpan, type CurrentTrace, DEFAULT_SERVICE_URL, type DbSnapshotConfig, type DbSnapshotProvider, type DbSnapshotRef, type DetachedTrace, type MockStrategy, type ProviderDefinition, ReplayEnvironment, type ReplayEnvironmentSnapshot, type ReplayItem, type ReplayOptions, type ReplayResult, SUPPORTED_PROVIDERS, type SpanOptions, type SpanType, type TokenUsage, type TraceResponse, type TracingProcessor, type WrapBAMLOptions, type WrappedBamlFn, __version__, flushTraces, getCurrentSpan, getCurrentTrace };
+export { type ActiveSpanContext, type AdaptContext, type AdaptInputsFn, type AllowedEnvVars, type BamlExecutionResult, Bitfab, BitfabClaudeAgentHandler, type BitfabConfig, BitfabError, BitfabFunction, BitfabLangGraphCallbackHandler as BitfabLangChainCallbackHandler, BitfabLangGraphCallbackHandler, BitfabOpenAITracingProcessor, type CodeChangeFile, type CurrentSpan, type CurrentTrace, DEFAULT_SERVICE_URL, type DbSnapshotConfig, type DbSnapshotProvider, type DbSnapshotRef, type DetachedTrace, type MockStrategy, type ProviderDefinition, ReplayEnvironment, type ReplayEnvironmentSnapshot, type ReplayItem, type ReplayOptions, type ReplayResult, SUPPORTED_PROVIDERS, type SpanOptions, type SpanType, type TokenUsage, type TraceResponse, type TracingProcessor, type WrapBAMLOptions, type WrappedBamlFn, __version__, flushTraces, getCurrentSpan, getCurrentTrace };

package/dist/index.d.ts

@@ -343,9 +343,9 @@ declare class ReplayEnvironment {
 type MockStrategy = "none" | "all" | "marked";
 interface ReplayOptions {
     /**
-     * Maximum number of traces to replay (1–100, default 5). Mutually
-     * exclusive with `traceIds` — an explicit ID list already determines how
-     * many traces replay, so passing both throws.
+     * Maximum number of traces to replay (1-100, default 5). Ignored when
+     * `traceIds` is passed (with a warning): an explicit ID list already
+     * determines how many traces replay.
      */
     limit?: number;
     /** Optional list of specific trace IDs to replay (max 100). */
@@ -812,6 +812,22 @@ declare class Bitfab {
      * @returns A BitfabLangGraphCallbackHandler configured for this client
      */
     getLangGraphCallbackHandler(traceFunctionKey: string): BitfabLangGraphCallbackHandler;
+    /**
+     * Get a LangChain callback handler for tracing.
+     *
+     * Alias of {@link getLangGraphCallbackHandler}: LangChain chains and
+     * LangGraph graphs share the same callback system, so one handler serves
+     * both.
+     *
+     * ```typescript
+     * const handler = client.getLangChainCallbackHandler("my-chain");
+     * const result = await chain.invoke(input, { callbacks: [handler] });
+     * ```
+     *
+     * @param traceFunctionKey - Groups traces under this key in Bitfab
+     * @returns A BitfabLangGraphCallbackHandler configured for this client
+     */
+    getLangChainCallbackHandler(traceFunctionKey: string): BitfabLangGraphCallbackHandler;
     /**
      * Get a Claude Agent SDK handler for tracing.
      *
@@ -959,9 +975,9 @@ declare class Bitfab {
      *
      * @param traceFunctionKey - The trace function key to replay
      * @param fn - The function to replay (must be the return value of `withSpan`)
-     * @param options - Optional replay options. `limit` and `traceIds` are
-     *   mutually exclusive — an explicit ID list already determines how many
-     *   traces replay, so passing both throws a BitfabError.
+     * @param options - Optional replay options. When `traceIds` is passed,
+     *   `limit` is ignored (with a warning): an explicit ID list already
+     *   determines how many traces replay.
      * @returns ReplayResult with items, testRunId, and testRunUrl
      */
     replay<TReturn>(traceFunctionKey: string, fn: (...args: any[]) => TReturn | Promise<TReturn>, options?: ReplayOptions): Promise<ReplayResult<TReturn>>;
@@ -1027,7 +1043,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.16.0";
+declare const __version__ = "0.16.2";
 
 /**
  * Constants for the Bitfab SDK.
@@ -1037,4 +1053,4 @@ declare const __version__ = "0.16.0";
  */
 declare const DEFAULT_SERVICE_URL = "https://bitfab.ai";
 
-export { type ActiveSpanContext, type AdaptContext, type AdaptInputsFn, type AllowedEnvVars, type BamlExecutionResult, Bitfab, BitfabClaudeAgentHandler, type BitfabConfig, BitfabError, BitfabFunction, BitfabLangGraphCallbackHandler, BitfabOpenAITracingProcessor, type CodeChangeFile, type CurrentSpan, type CurrentTrace, DEFAULT_SERVICE_URL, type DbSnapshotConfig, type DbSnapshotProvider, type DbSnapshotRef, type DetachedTrace, type MockStrategy, type ProviderDefinition, ReplayEnvironment, type ReplayEnvironmentSnapshot, type ReplayItem, type ReplayOptions, type ReplayResult, SUPPORTED_PROVIDERS, type SpanOptions, type SpanType, type TokenUsage, type TraceResponse, type TracingProcessor, type WrapBAMLOptions, type WrappedBamlFn, __version__, flushTraces, getCurrentSpan, getCurrentTrace };
+export { type ActiveSpanContext, type AdaptContext, type AdaptInputsFn, type AllowedEnvVars, type BamlExecutionResult, Bitfab, BitfabClaudeAgentHandler, type BitfabConfig, BitfabError, BitfabFunction, BitfabLangGraphCallbackHandler as BitfabLangChainCallbackHandler, BitfabLangGraphCallbackHandler, BitfabOpenAITracingProcessor, type CodeChangeFile, type CurrentSpan, type CurrentTrace, DEFAULT_SERVICE_URL, type DbSnapshotConfig, type DbSnapshotProvider, type DbSnapshotRef, type DetachedTrace, type MockStrategy, type ProviderDefinition, ReplayEnvironment, type ReplayEnvironmentSnapshot, type ReplayItem, type ReplayOptions, type ReplayResult, SUPPORTED_PROVIDERS, type SpanOptions, type SpanType, type TokenUsage, type TraceResponse, type TracingProcessor, type WrapBAMLOptions, type WrappedBamlFn, __version__, flushTraces, getCurrentSpan, getCurrentTrace };

package/dist/index.js

@@ -11,7 +11,7 @@ import {
   flushTraces,
   getCurrentSpan,
   getCurrentTrace
-} from "./chunk-53G5GR7B.js";
+} from "./chunk-4WJPQT2X.js";
 import {
   BitfabError
 } from "./chunk-QT7HWOKU.js";
@@ -20,6 +20,7 @@ export {
   BitfabClaudeAgentHandler,
   BitfabError,
   BitfabFunction,
+  BitfabLangGraphCallbackHandler as BitfabLangChainCallbackHandler,
   BitfabLangGraphCallbackHandler,
   BitfabOpenAITracingProcessor,
   DEFAULT_SERVICE_URL,

package/dist/node.cjs

@@ -324,9 +324,12 @@ async function replay(httpClient, serviceUrl, traceFunctionKey, fn, options) {
     }
   }
   if (options?.limit !== void 0 && options?.traceIds !== void 0) {
-    throw new BitfabError(
-      "Pass either limit or traceIds, not both: an explicit trace ID list already determines how many traces replay."
-    );
+    try {
+      console.warn(
+        "Bitfab: limit is ignored when traceIds is passed: the explicit trace ID list already determines how many traces replay."
+      );
+    } catch {
+    }
   }
   await replayContextReady;
   const {
@@ -423,6 +426,7 @@ __export(node_exports, {
   BitfabClaudeAgentHandler: () => BitfabClaudeAgentHandler,
   BitfabError: () => BitfabError,
   BitfabFunction: () => BitfabFunction,
+  BitfabLangChainCallbackHandler: () => BitfabLangGraphCallbackHandler,
   BitfabLangGraphCallbackHandler: () => BitfabLangGraphCallbackHandler,
   BitfabOpenAITracingProcessor: () => BitfabOpenAITracingProcessor,
   DEFAULT_SERVICE_URL: () => DEFAULT_SERVICE_URL,
@@ -443,7 +447,7 @@ registerAsyncLocalStorageClass(
 );
 
 // src/version.generated.ts
-var __version__ = "0.16.0";
+var __version__ = "0.16.2";
 
 // src/constants.ts
 var DEFAULT_SERVICE_URL = "https://bitfab.ai";
@@ -2730,6 +2734,24 @@ var Bitfab = class {
       }
     });
   }
+  /**
+   * Get a LangChain callback handler for tracing.
+   *
+   * Alias of {@link getLangGraphCallbackHandler}: LangChain chains and
+   * LangGraph graphs share the same callback system, so one handler serves
+   * both.
+   *
+   * ```typescript
+   * const handler = client.getLangChainCallbackHandler("my-chain");
+   * const result = await chain.invoke(input, { callbacks: [handler] });
+   * ```
+   *
+   * @param traceFunctionKey - Groups traces under this key in Bitfab
+   * @returns A BitfabLangGraphCallbackHandler configured for this client
+   */
+  getLangChainCallbackHandler(traceFunctionKey) {
+    return this.getLangGraphCallbackHandler(traceFunctionKey);
+  }
   /**
    * Get a Claude Agent SDK handler for tracing.
    *
@@ -3233,9 +3255,9 @@ var Bitfab = class {
    *
    * @param traceFunctionKey - The trace function key to replay
    * @param fn - The function to replay (must be the return value of `withSpan`)
-   * @param options - Optional replay options. `limit` and `traceIds` are
-   *   mutually exclusive — an explicit ID list already determines how many
-   *   traces replay, so passing both throws a BitfabError.
+   * @param options - Optional replay options. When `traceIds` is passed,
+   *   `limit` is ignored (with a warning): an explicit ID list already
+   *   determines how many traces replay.
    * @returns ReplayResult with items, testRunId, and testRunUrl
    */
   async replay(traceFunctionKey, fn, options) {
@@ -3313,6 +3335,7 @@ assertAsyncStorageRegistered();
   BitfabClaudeAgentHandler,
   BitfabError,
   BitfabFunction,
+  BitfabLangChainCallbackHandler,
   BitfabLangGraphCallbackHandler,
   BitfabOpenAITracingProcessor,
   DEFAULT_SERVICE_URL,