bitfab 0.33.4 → 0.33.5

package/dist/index.d.cts

@@ -752,8 +752,9 @@ type MockStrategy = "none" | "all" | "marked";
 /**
  * How the DB-snapshot branch each replay item runs against is sized and warmed.
  *
- * Passing this object at all is what turns database branching on, so `{}` means
- * "branch every item, with the mirror project's own defaults".
+ * Every field is optional, so this object is only worth passing when you want
+ * to override the mirror project's own sizing. To branch with those defaults,
+ * pass `dbBranch: true` instead of an empty object.
  */
 interface DbBranchOptions {
     /**
@@ -826,17 +827,17 @@ interface ReplayOptions {
     mockOverride?: MockOverride | MockOverride[];
     /**
      * Run each item against a database branch restored to the state its source
-     * trace saw. Passing this object at all turns branching on, so `{}` enables
-     * it with the mirror project's own sizing; the fields tune how each branch is
-     * sized and warmed. Inside `fn`, read the resolved branch with
-     * `getCurrentReplayBranch()`.
+     * trace saw. Pass `true` to branch with the mirror project's own sizing, or a
+     * {@link DbBranchOptions} object to tune how each branch is sized and warmed.
+     * `false` and omission leave branching off. Inside `fn`, read the resolved
+     * branch with `getCurrentReplayBranch()`.
      *
      * Items whose source trace carried no DB snapshot reference get no branch and
      * run against the live database. An item whose branch was requested but could
      * not be resolved fails instead of running, so a replay never silently
      * reports a result that did not use the historical data you asked for.
      */
-    dbBranch?: DbBranchOptions;
+    dbBranch?: DbBranchOptions | boolean;
     /** Group ID to associate this replay with an experiment group for live streaming in Studio. */
     experimentGroupId?: string;
     /**
@@ -1982,7 +1983,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.33.4";
+declare const __version__ = "0.33.5";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.d.ts

@@ -752,8 +752,9 @@ type MockStrategy = "none" | "all" | "marked";
 /**
  * How the DB-snapshot branch each replay item runs against is sized and warmed.
  *
- * Passing this object at all is what turns database branching on, so `{}` means
- * "branch every item, with the mirror project's own defaults".
+ * Every field is optional, so this object is only worth passing when you want
+ * to override the mirror project's own sizing. To branch with those defaults,
+ * pass `dbBranch: true` instead of an empty object.
  */
 interface DbBranchOptions {
     /**
@@ -826,17 +827,17 @@ interface ReplayOptions {
     mockOverride?: MockOverride | MockOverride[];
     /**
      * Run each item against a database branch restored to the state its source
-     * trace saw. Passing this object at all turns branching on, so `{}` enables
-     * it with the mirror project's own sizing; the fields tune how each branch is
-     * sized and warmed. Inside `fn`, read the resolved branch with
-     * `getCurrentReplayBranch()`.
+     * trace saw. Pass `true` to branch with the mirror project's own sizing, or a
+     * {@link DbBranchOptions} object to tune how each branch is sized and warmed.
+     * `false` and omission leave branching off. Inside `fn`, read the resolved
+     * branch with `getCurrentReplayBranch()`.
      *
      * Items whose source trace carried no DB snapshot reference get no branch and
      * run against the live database. An item whose branch was requested but could
      * not be resolved fails instead of running, so a replay never silently
      * reports a result that did not use the historical data you asked for.
      */
-    dbBranch?: DbBranchOptions;
+    dbBranch?: DbBranchOptions | boolean;
     /** Group ID to associate this replay with an experiment group for live streaming in Studio. */
     experimentGroupId?: string;
     /**
@@ -1982,7 +1983,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.33.4";
+declare const __version__ = "0.33.5";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.js

@@ -23,12 +23,12 @@ import {
   getCurrentReplayBranch,
   getCurrentSpan,
   getCurrentTrace
-} from "./chunk-OMW6EFXC.js";
+} from "./chunk-LRWH3H5T.js";
 import {
   BITFAB_PROGRESS_PREFIX,
   BitfabError,
   reportReplayProgress
-} from "./chunk-HWQB73HK.js";
+} from "./chunk-DPV6PBWE.js";
 export {
   BITFAB_PROGRESS_PREFIX,
   Bitfab,

package/dist/node.cjs

@@ -558,8 +558,11 @@ __export(replay_exports, {
   replay: () => replay,
   reportReplayProgress: () => reportReplayProgress
 });
+function dbBranchEnabled(dbBranch) {
+  return dbBranch !== void 0 && dbBranch !== false;
+}
 function resolveDbBranchSettings(dbBranch) {
-  if (!dbBranch) {
+  if (!dbBranch || dbBranch === true) {
     return void 0;
   }
   const { minCu, maxCu, warmupSql } = dbBranch;
@@ -828,7 +831,7 @@ async function replay(httpClient, serviceUrl, traceFunctionKey, fn, options, reg
     options?.name,
     codeChangeDescription,
     codeChangeFiles,
-    options?.dbBranch !== void 0,
+    dbBranchEnabled(options?.dbBranch),
     // includeDbBranchLease
     options?.experimentGroupId,
     options?.datasetId,
@@ -851,7 +854,7 @@ async function replay(httpClient, serviceUrl, traceFunctionKey, fn, options, reg
       mockStrategy,
       resolvedOverrides,
       replayedTraceIds[index],
-      options?.dbBranch !== void 0,
+      dbBranchEnabled(options?.dbBranch),
       resolveDbBranchSettings(options?.dbBranch),
       options?.adaptInputs
     )
@@ -1028,7 +1031,7 @@ registerAsyncLocalStorageClass(
 );
 
 // src/version.generated.ts
-var __version__ = "0.33.4";
+var __version__ = "0.33.5";
 
 // src/constants.ts
 var DEFAULT_SERVICE_URL = "https://bitfab.ai";