bitfab 0.33.3 → 0.33.4

package/dist/index.cjs

@@ -1014,7 +1014,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/version.generated.ts
-var __version__ = "0.33.3";
+var __version__ = "0.33.4";
 
 // src/constants.ts
 var DEFAULT_SERVICE_URL = "https://bitfab.ai";
@@ -4313,6 +4313,38 @@ var Bitfab = class {
           () => wrappedFn.apply(this, args)
         );
       }
+      const captureWhen = options.captureWhen === void 0 ? "always" : options.captureWhen;
+      const resolvedCaptureWhen = captureWhen === "always" || captureWhen === "nested" ? captureWhen : "always";
+      if (resolvedCaptureWhen !== captureWhen) {
+        let invalidValue;
+        try {
+          invalidValue = String(captureWhen);
+        } catch {
+          invalidValue = "<unprintable>";
+        }
+        warnOnce(
+          `invalid-capture-when:${traceFunctionKey}`,
+          `unknown captureWhen value "${invalidValue}"; defaulting to "always". Valid values: "always", "nested".`
+        );
+      }
+      if (resolvedCaptureWhen === "nested") {
+        let hasParent = false;
+        try {
+          hasParent = getSpanStack().length > 0;
+        } catch (setupError) {
+          if (getReplayContext()) {
+            throw setupError;
+          }
+          warnOnce(
+            `withSpan-setup:${traceFunctionKey}`,
+            `tracing setup failed for "${traceFunctionKey}"; running it untraced. The function still runs and returns normally; no span is recorded.`
+          );
+          return fn.apply(this, args);
+        }
+        if (!hasParent) {
+          return fn.apply(this, args);
+        }
+      }
       let newStack;
       let executeWithContext;
       let registeredTraceId;