bitfab 0.13.8 → 0.14.0

package/dist/index.cjs

@@ -44,7 +44,7 @@ var __version__;
 var init_version_generated = __esm({
   "src/version.generated.ts"() {
     "use strict";
-    __version__ = "0.13.8";
+    __version__ = "0.14.0";
   }
 });
 
@@ -278,7 +278,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;
         }
@@ -659,6 +662,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,
@@ -666,7 +684,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,
@@ -712,6 +732,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();
@@ -3183,7 +3204,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) {