@bitfab/sdk 0.33.1 → 0.33.3

package/dist/index.d.cts

@@ -794,15 +794,20 @@ interface ReplayOptions {
     /**
      * Description of the code change being tested in this replay. Stored on
      * the resulting experiment so the change can be reviewed alongside results.
+     * Supplying a description without `codeChangeFiles` preserves this text
+     * while the SDK automatically captures the files.
+     * Pass `null` when the replay should have no description; use
+     * `codeChangeFiles: null` to suppress automatic file capture.
      */
-    codeChangeDescription?: string;
+    codeChangeDescription?: string | null;
     /**
      * Files edited as part of this code change. Each entry holds the file path
      * and the full `before`/`after` contents. The agent reads each file before
      * and after editing and passes the two strings. Use `""` for newly created
-     * files (`before`) or deleted files (`after`).
+     * files (`before`) or deleted files (`after`). Omit this field to capture
+     * automatically, or pass `null` to suppress file capture for this replay.
      */
-    codeChangeFiles?: CodeChangeFile[];
+    codeChangeFiles?: CodeChangeFile[] | null;
     /**
      * Mock strategy for child spans during replay.
      * - "marked": only spans tagged with { mockOnReplay: true } in SpanOptions are mocked (default)
@@ -1963,7 +1968,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.33.1";
+declare const __version__ = "0.33.3";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.d.ts

@@ -794,15 +794,20 @@ interface ReplayOptions {
     /**
      * Description of the code change being tested in this replay. Stored on
      * the resulting experiment so the change can be reviewed alongside results.
+     * Supplying a description without `codeChangeFiles` preserves this text
+     * while the SDK automatically captures the files.
+     * Pass `null` when the replay should have no description; use
+     * `codeChangeFiles: null` to suppress automatic file capture.
      */
-    codeChangeDescription?: string;
+    codeChangeDescription?: string | null;
     /**
      * Files edited as part of this code change. Each entry holds the file path
      * and the full `before`/`after` contents. The agent reads each file before
      * and after editing and passes the two strings. Use `""` for newly created
-     * files (`before`) or deleted files (`after`).
+     * files (`before`) or deleted files (`after`). Omit this field to capture
+     * automatically, or pass `null` to suppress file capture for this replay.
      */
-    codeChangeFiles?: CodeChangeFile[];
+    codeChangeFiles?: CodeChangeFile[] | null;
     /**
      * Mock strategy for child spans during replay.
      * - "marked": only spans tagged with { mockOnReplay: true } in SpanOptions are mocked (default)
@@ -1963,7 +1968,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.33.1";
+declare const __version__ = "0.33.3";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.js

@@ -14,12 +14,12 @@ import {
   getCurrentReplayBranch,
   getCurrentSpan,
   getCurrentTrace
-} from "./chunk-7UHJ67MH.js";
+} from "./chunk-NIFTE3J4.js";
 import {
   BITFAB_PROGRESS_PREFIX,
   BitfabError,
   reportReplayProgress
-} from "./chunk-ADUWXWWI.js";
+} from "./chunk-HWQB73HK.js";
 export {
   BITFAB_PROGRESS_PREFIX,
   Bitfab,

package/dist/node.cjs

@@ -322,14 +322,25 @@ function runWithReplayContext(ctx, fn) {
   }
   return fn();
 }
-var replayContextStorage, replayContextReady;
+var replayContextStorage, REPLAY_CONTEXT_STORAGE_SYMBOL, replayContextReady;
 var init_replayContext = __esm({
   "src/replayContext.ts"() {
     "use strict";
     init_asyncStorage();
     replayContextStorage = null;
+    REPLAY_CONTEXT_STORAGE_SYMBOL = /* @__PURE__ */ Symbol.for("bitfab.replayContextStorage");
     replayContextReady = asyncStorageReady.then(() => {
-      replayContextStorage = createAsyncLocalStorage();
+      const shared = globalThis;
+      const existing = shared[REPLAY_CONTEXT_STORAGE_SYMBOL];
+      if (existing) {
+        replayContextStorage = existing;
+        return;
+      }
+      const created = createAsyncLocalStorage();
+      if (created) {
+        shared[REPLAY_CONTEXT_STORAGE_SYMBOL] = created;
+        replayContextStorage = created;
+      }
     });
   }
 });
@@ -610,9 +621,10 @@ function buildMockTree(rootNode) {
   }
   return { spans };
 }
-async function processItem(httpClient, serverItem, fn, testRunId, mockStrategy, resolvedOverrides, replayedTraceId, includeDbBranchLease, adaptInputs) {
-  const lease = includeDbBranchLease ? serverItem.dbBranchLease : void 0;
-  const leaseError = includeDbBranchLease ? serverItem.dbBranchLeaseError : void 0;
+async function processItem(httpClient, serverItem, fn, testRunId, mockStrategy, resolvedOverrides, replayedTraceId, includeDbBranchLease, dbBranchSettings, adaptInputs) {
+  let lease = includeDbBranchLease ? serverItem.dbBranchLease : void 0;
+  let leaseError = includeDbBranchLease ? serverItem.dbBranchLeaseError : void 0;
+  let dbSnapshotRef = serverItem.dbSnapshotRef;
   let inputs = [];
   let originalOutput;
   let result;
@@ -621,6 +633,16 @@ async function processItem(httpClient, serverItem, fn, testRunId, mockStrategy,
   const originalTraceId = serverItem.originalTraceId ?? serverItem.sourceTraceId;
   const originalSpanId = serverItem.originalSpanId ?? serverItem.sourceSpanId;
   try {
+    if (includeDbBranchLease && !lease && !leaseError) {
+      const resolved = await httpClient.resolveDbBranchLease(
+        testRunId,
+        originalTraceId,
+        dbBranchSettings
+      );
+      lease = resolved.lease ?? void 0;
+      leaseError = resolved.leaseError ?? void 0;
+      dbSnapshotRef = resolved.dbSnapshotRef ?? dbSnapshotRef;
+    }
     if (leaseError) {
       throw new BitfabError(
         `Replay requested a database branch for trace ${originalTraceId} but it could not be resolved (${leaseError.code}): ${leaseError.message}. The function was not run, because replaying it against the live database would produce a result that looks valid but did not use the historical data you asked for.`
@@ -732,7 +754,7 @@ async function processItem(httpClient, serverItem, fn, testRunId, mockStrategy,
     // Null here (and on older servers) means "replay tokens not known".
     tokens: null,
     model: serverItem.model ?? null,
-    dbSnapshotRef: serverItem.dbSnapshotRef ?? null
+    dbSnapshotRef: dbSnapshotRef ?? null
   };
 }
 async function mapWithConcurrency(tasks, maxConcurrency, onSettled) {
@@ -775,11 +797,13 @@ async function replay(httpClient, serviceUrl, traceFunctionKey, fn, options, reg
   await replayContextReady;
   let codeChangeDescription = options?.codeChangeDescription;
   let codeChangeFiles = options?.codeChangeFiles;
-  if (codeChangeDescription === void 0 && codeChangeFiles === void 0) {
+  if (codeChangeFiles === void 0) {
     const captured = await resolveAutoCodeChange(options?.name);
     if (captured) {
-      codeChangeDescription = captured.description;
       codeChangeFiles = captured.files;
+      if (codeChangeDescription === void 0) {
+        codeChangeDescription = captured.description;
+      }
     }
   }
   const {
@@ -819,6 +843,7 @@ async function replay(httpClient, serviceUrl, traceFunctionKey, fn, options, reg
       resolvedOverrides,
       replayedTraceIds[index],
       options?.dbBranch !== void 0,
+      resolveDbBranchSettings(options?.dbBranch),
       options?.adaptInputs
     )
   );
@@ -994,7 +1019,7 @@ registerAsyncLocalStorageClass(
 );
 
 // src/version.generated.ts
-var __version__ = "0.33.1";
+var __version__ = "0.33.3";
 
 // src/constants.ts
 var DEFAULT_SERVICE_URL = "https://bitfab.ai";
@@ -1012,6 +1037,7 @@ function unrefTimer(timer) {
 
 // src/http.ts
 init_warnOnce();
+var REPLAY_DB_BRANCH_REQUEST_TIMEOUT_MS = 3e5;
 function serializePayloadBody(payload) {
   try {
     return { body: JSON.stringify(payload), dropped: [] };
@@ -1372,6 +1398,7 @@ var HttpClient = class {
     }
     if (includeDbBranchLease) {
       payload.includeDbBranchLease = true;
+      payload.lazyDbBranchLease = true;
     }
     if (experimentGroupId !== void 0) {
       payload.experimentGroupId = experimentGroupId;
@@ -1385,7 +1412,7 @@ var HttpClient = class {
     if (dbBranchSettings !== void 0) {
       payload.dbBranchSettings = dbBranchSettings;
     }
-    const timeout = includeDbBranchLease ? 3e5 : 3e4;
+    const timeout = includeDbBranchLease ? REPLAY_DB_BRANCH_REQUEST_TIMEOUT_MS : 3e4;
     return this.request("/api/sdk/replay/start", payload, {
       timeout
     });
@@ -1484,11 +1511,11 @@ var HttpClient = class {
    * snapshot + preview branch and polls operations to readiness, which
    * can take seconds.
    */
-  async resolveDbBranchLease(testRunId, traceId, dbSnapshotRef) {
+  async resolveDbBranchLease(testRunId, traceId, dbBranchSettings) {
     return this.request(
       "/api/sdk/replay/resolveDbBranchLease",
-      { testRunId, traceId, dbSnapshotRef },
-      { timeout: 9e4 }
+      { testRunId, traceId, dbBranchSettings },
+      { timeout: REPLAY_DB_BRANCH_REQUEST_TIMEOUT_MS }
     );
   }
   /** Release a previously-resolved DB branch by deleting its Neon branch. Idempotent server-side. */
@@ -3485,8 +3512,22 @@ init_warnOnce();
 var activeTraceStates = /* @__PURE__ */ new Map();
 var pendingSpanPromises = /* @__PURE__ */ new Map();
 var asyncLocalStorage = null;
+var SPAN_CONTEXT_STORAGE_SYMBOL = /* @__PURE__ */ Symbol.for("bitfab.spanContextStorage");
 var initializeAsyncContext = () => {
-  asyncLocalStorage ?? (asyncLocalStorage = createAsyncLocalStorage());
+  if (asyncLocalStorage) {
+    return;
+  }
+  const shared = globalThis;
+  const existing = shared[SPAN_CONTEXT_STORAGE_SYMBOL];
+  if (existing) {
+    asyncLocalStorage = existing;
+    return;
+  }
+  const created = createAsyncLocalStorage();
+  if (created) {
+    shared[SPAN_CONTEXT_STORAGE_SYMBOL] = created;
+    asyncLocalStorage = created;
+  }
 };
 var asyncLocalStorageReady = asyncStorageReady.then(() => {
   initializeAsyncContext();