@bitfab/sdk 0.13.8 → 0.14.0

package/dist/index.d.cts

@@ -342,9 +342,13 @@ declare class ReplayEnvironment {
 
 type MockStrategy = "none" | "all" | "marked";
 interface ReplayOptions {
-    /** Maximum number of traces to replay (1–100, default 5). */
+    /**
+     * 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.
+     */
     limit?: number;
-    /** Optional list of specific trace IDs to replay. */
+    /** Optional list of specific trace IDs to replay (max 100). */
     traceIds?: string[];
     /** Maximum number of items to process in parallel. Set to 1 for sequential. Default 10. */
     maxConcurrency?: number;
@@ -916,18 +920,12 @@ 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, traceIds)
+     * @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.
      * @returns ReplayResult with items, testRunId, and testRunUrl
      */
-    replay<TReturn>(traceFunctionKey: string, fn: (...args: any[]) => TReturn | Promise<TReturn>, options?: {
-        limit?: number;
-        traceIds?: string[];
-        maxConcurrency?: number;
-        codeChangeDescription?: string;
-        codeChangeFiles?: CodeChangeFile[];
-        mock?: "none" | "all" | "marked";
-        environment?: ReplayEnvironment;
-    }): Promise<ReplayResult<TReturn>>;
+    replay<TReturn>(traceFunctionKey: string, fn: (...args: any[]) => TReturn | Promise<TReturn>, options?: ReplayOptions): Promise<ReplayResult<TReturn>>;
 }
 /**
  * Represents a Bitfab function that can wrap user functions for tracing.
@@ -990,7 +988,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.13.8";
+declare const __version__ = "0.14.0";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.d.ts

@@ -342,9 +342,13 @@ declare class ReplayEnvironment {
 
 type MockStrategy = "none" | "all" | "marked";
 interface ReplayOptions {
-    /** Maximum number of traces to replay (1–100, default 5). */
+    /**
+     * 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.
+     */
     limit?: number;
-    /** Optional list of specific trace IDs to replay. */
+    /** Optional list of specific trace IDs to replay (max 100). */
     traceIds?: string[];
     /** Maximum number of items to process in parallel. Set to 1 for sequential. Default 10. */
     maxConcurrency?: number;
@@ -916,18 +920,12 @@ 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, traceIds)
+     * @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.
      * @returns ReplayResult with items, testRunId, and testRunUrl
      */
-    replay<TReturn>(traceFunctionKey: string, fn: (...args: any[]) => TReturn | Promise<TReturn>, options?: {
-        limit?: number;
-        traceIds?: string[];
-        maxConcurrency?: number;
-        codeChangeDescription?: string;
-        codeChangeFiles?: CodeChangeFile[];
-        mock?: "none" | "all" | "marked";
-        environment?: ReplayEnvironment;
-    }): Promise<ReplayResult<TReturn>>;
+    replay<TReturn>(traceFunctionKey: string, fn: (...args: any[]) => TReturn | Promise<TReturn>, options?: ReplayOptions): Promise<ReplayResult<TReturn>>;
 }
 /**
  * Represents a Bitfab function that can wrap user functions for tracing.
@@ -990,7 +988,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.13.8";
+declare const __version__ = "0.14.0";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.js

@@ -8,13 +8,13 @@ import {
   SUPPORTED_PROVIDERS,
   getCurrentSpan,
   getCurrentTrace
-} from "./chunk-4ANYHNQJ.js";
+} from "./chunk-RMQX546G.js";
 import {
   BitfabError,
   DEFAULT_SERVICE_URL,
   __version__,
   flushTraces
-} from "./chunk-VFGUZWAV.js";
+} from "./chunk-OW2EJK7T.js";
 export {
   Bitfab,
   BitfabClaudeAgentHandler,

package/dist/node.cjs

@@ -81,7 +81,7 @@ var __version__;
 var init_version_generated = __esm({
   "src/version.generated.ts"() {
     "use strict";
-    __version__ = "0.13.8";
+    __version__ = "0.14.0";
   }
 });
 
@@ -315,7 +315,10 @@ var init_http = __esm({
        * Blocking call — creates a test run and returns lightweight item references.
        */
       async startReplay(traceFunctionKey, limit, traceIds, codeChangeDescription, codeChangeFiles, includeDbBranchLease, experimentGroupId) {
-        const payload = { traceFunctionKey, limit };
+        const payload = { traceFunctionKey };
+        if (limit !== void 0) {
+          payload.limit = limit;
+        }
         if (traceIds) {
           payload.traceIds = traceIds;
         }
@@ -657,6 +660,21 @@ async function mapWithConcurrency(tasks, maxConcurrency) {
   return results;
 }
 async function replay(httpClient, serviceUrl, traceFunctionKey, fn, options) {
+  if (options?.traceIds !== void 0) {
+    if (options.traceIds.length === 0) {
+      throw new BitfabError("traceIds must contain at least one trace ID.");
+    }
+    if (options.traceIds.length > 100) {
+      throw new BitfabError(
+        `traceIds supports at most 100 trace IDs per replay (got ${options.traceIds.length}).`
+      );
+    }
+  }
+  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."
+    );
+  }
   await replayContextReady;
   const {
     testRunId,
@@ -664,7 +682,9 @@ async function replay(httpClient, serviceUrl, traceFunctionKey, fn, options) {
     items: serverItems
   } = await httpClient.startReplay(
     traceFunctionKey,
-    options?.limit ?? 5,
+    // limit is meaningless with explicit traceIds (the ID list determines
+    // the count), so it's omitted from the request entirely.
+    options?.traceIds ? void 0 : options?.limit ?? 5,
     options?.traceIds,
     options?.codeChangeDescription,
     options?.codeChangeFiles,
@@ -710,6 +730,7 @@ async function replay(httpClient, serviceUrl, traceFunctionKey, fn, options) {
 var init_replay = __esm({
   "src/replay.ts"() {
     "use strict";
+    init_errors();
     init_http();
     init_replayContext();
     init_serialize();
@@ -3188,7 +3209,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, traceIds)
+   * @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.
    * @returns ReplayResult with items, testRunId, and testRunUrl
    */
   async replay(traceFunctionKey, fn, options) {