@bitfab/sdk 0.28.5 → 0.28.7

package/dist/index.d.cts

@@ -735,7 +735,7 @@ declare const BITFAB_PROGRESS_PREFIX = "@@bitfab:progress ";
  * It writes one `@@bitfab:progress` line per trace to stderr, which the Bitfab
  * plugin polls to report live progress while the replay runs in the background,
  * so scripts never hand-format the wire protocol.
- * stdout is left untouched for the ReplayResult JSON. Outside Node (no
+ * stdout is left untouched for direct-run ReplayResult JSON. Outside Node (no
  * `process.stderr`, e.g. a browser) it is a no-op, and a write failure is
  * swallowed so progress can never crash a run.
  */
@@ -1014,6 +1014,15 @@ interface CurrentTrace {
      * Context entries are stored in rawData.contexts as [{key, value}, ...].
      */
     addContext(context: Record<string, unknown>): void;
+    /**
+     * Flag this trace to be dropped. When the trace completes, the server scrubs
+     * its payloads (trace, external trace, and all spans) and marks it `dropped`
+     * instead of `completed`, retaining only a skeleton audit record. Use this to
+     * discard runs you never want stored (e.g. health checks, or a run you know
+     * contains sensitive data). Takes effect at trace completion; a trace that is
+     * flagged but never completes is not scrubbed.
+     */
+    drop(): void;
 }
 /**
  * Get a handle to the current active span.
@@ -1603,7 +1612,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.28.5";
+declare const __version__ = "0.28.7";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.d.ts

@@ -735,7 +735,7 @@ declare const BITFAB_PROGRESS_PREFIX = "@@bitfab:progress ";
  * It writes one `@@bitfab:progress` line per trace to stderr, which the Bitfab
  * plugin polls to report live progress while the replay runs in the background,
  * so scripts never hand-format the wire protocol.
- * stdout is left untouched for the ReplayResult JSON. Outside Node (no
+ * stdout is left untouched for direct-run ReplayResult JSON. Outside Node (no
  * `process.stderr`, e.g. a browser) it is a no-op, and a write failure is
  * swallowed so progress can never crash a run.
  */
@@ -1014,6 +1014,15 @@ interface CurrentTrace {
      * Context entries are stored in rawData.contexts as [{key, value}, ...].
      */
     addContext(context: Record<string, unknown>): void;
+    /**
+     * Flag this trace to be dropped. When the trace completes, the server scrubs
+     * its payloads (trace, external trace, and all spans) and marks it `dropped`
+     * instead of `completed`, retaining only a skeleton audit record. Use this to
+     * discard runs you never want stored (e.g. health checks, or a run you know
+     * contains sensitive data). Takes effect at trace completion; a trace that is
+     * flagged but never completes is not scrubbed.
+     */
+    drop(): void;
 }
 /**
  * Get a handle to the current active span.
@@ -1603,7 +1612,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.28.5";
+declare const __version__ = "0.28.7";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.js

@@ -14,12 +14,12 @@ import {
   flushTraces,
   getCurrentSpan,
   getCurrentTrace
-} from "./chunk-7UU5L64L.js";
+} from "./chunk-TIMBGA3A.js";
 import {
   BITFAB_PROGRESS_PREFIX,
   BitfabError,
   reportReplayProgress
-} from "./chunk-SAGZ674W.js";
+} from "./chunk-5E4BUIYA.js";
 export {
   BITFAB_PROGRESS_PREFIX,
   Bitfab,

package/dist/node.cjs

@@ -622,11 +622,35 @@ async function replay(httpClient, serviceUrl, traceFunctionKey, fn, options) {
       }
     }
   }
-  return {
+  const replayResult = {
     items: resultItems,
     testRunId,
     testRunUrl: `${serviceUrl}${testRunUrl}`
   };
+  await writeReplayResultFile(replayResult);
+  return replayResult;
+}
+async function writeReplayResultFile(result) {
+  const resultPath = typeof process !== "undefined" ? process.env?.BITFAB_REPLAY_RESULT_PATH : void 0;
+  if (!resultPath) {
+    return;
+  }
+  try {
+    const [{ dirname }, { mkdir, writeFile }] = await Promise.all([
+      import("path"),
+      import("fs/promises")
+    ]);
+    await mkdir(dirname(resultPath), { recursive: true });
+    await writeFile(resultPath, `${JSON.stringify(result, null, 2)}
+`);
+  } catch (err) {
+    try {
+      console.warn(
+        `Bitfab: failed to write replay result to BITFAB_REPLAY_RESULT_PATH (${resultPath}): ${err instanceof Error ? err.message : String(err)}`
+      );
+    } catch {
+    }
+  }
 }
 var BITFAB_PROGRESS_PREFIX;
 var init_replay = __esm({
@@ -673,7 +697,7 @@ registerAsyncLocalStorageClass(
 );
 
 // src/version.generated.ts
-var __version__ = "0.28.5";
+var __version__ = "0.28.7";
 
 // src/constants.ts
 var DEFAULT_SERVICE_URL = "https://bitfab.ai";
@@ -3324,6 +3348,8 @@ var noOpTrace = {
   setMetadata() {
   },
   addContext() {
+  },
+  drop() {
   }
 };
 function getCurrentSpan() {
@@ -3400,6 +3426,12 @@ function getCurrentTrace() {
         traceState.contexts.push(context);
       } catch {
       }
+    },
+    drop() {
+      try {
+        getOrCreateTraceState().dropped = true;
+      } catch {
+      }
     }
   };
 }
@@ -3989,6 +4021,7 @@ var Bitfab = class {
                 testRunId: traceState?.testRunId,
                 inputSourceTraceId: traceState?.inputSourceTraceId,
                 dbSnapshotRef: traceState?.dbSnapshotRef,
+                dropped: traceState?.dropped,
                 // Built AFTER the wrapped fn finished, so `accessed` reflects
                 // whether customer code obtained the branch URL during this
                 // item. Omitted entirely when no lease was attached, so the
@@ -4234,6 +4267,7 @@ var Bitfab = class {
       traceFunctionKey: params.traceFunctionKey,
       externalTrace: rawTrace,
       completed: true,
+      ...params.dropped && { dropped: true },
       ...params.sessionId && { sessionId: params.sessionId },
       ...params.testRunId && { testRunId: params.testRunId }
     });