@bitfab/sdk 0.36.1 → 0.36.2

package/dist/index.d.cts

@@ -457,8 +457,11 @@ declare class HttpClient {
     /**
      * Fetch an external span by ID.
      * Blocking GET request.
+     * The replay view limits rawData to input/output serialization fields.
      */
-    getExternalSpan(spanId: string): Promise<ExternalSpanResponse>;
+    getExternalSpan(spanId: string, options?: {
+        view?: "full" | "replay";
+    }): Promise<ExternalSpanResponse>;
     /**
      * Fetch the span tree for a root span.
      * Blocking GET request.
@@ -466,9 +469,11 @@ declare class HttpClient {
      * Pass `includeOutputs: false` for a payload-free tree (structure +
      * `externalSpanId` only), so recorded outputs are fetched lazily per mocked
      * span instead of all up front. Omit it (default eager) for `mock: "all"`.
+     * Pass `includeRootOutput: false` when the root was already fetched.
      */
     getSpanTree(externalSpanId: string, options?: {
         includeOutputs?: boolean;
+        includeRootOutput?: boolean;
     }): Promise<SpanTreeResponse>;
     /**
      * Read which of a replay run's traces the server has fully persisted.
@@ -2348,7 +2353,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.36.1";
+declare const __version__ = "0.36.2";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.d.ts

@@ -457,8 +457,11 @@ declare class HttpClient {
     /**
      * Fetch an external span by ID.
      * Blocking GET request.
+     * The replay view limits rawData to input/output serialization fields.
      */
-    getExternalSpan(spanId: string): Promise<ExternalSpanResponse>;
+    getExternalSpan(spanId: string, options?: {
+        view?: "full" | "replay";
+    }): Promise<ExternalSpanResponse>;
     /**
      * Fetch the span tree for a root span.
      * Blocking GET request.
@@ -466,9 +469,11 @@ declare class HttpClient {
      * Pass `includeOutputs: false` for a payload-free tree (structure +
      * `externalSpanId` only), so recorded outputs are fetched lazily per mocked
      * span instead of all up front. Omit it (default eager) for `mock: "all"`.
+     * Pass `includeRootOutput: false` when the root was already fetched.
      */
     getSpanTree(externalSpanId: string, options?: {
         includeOutputs?: boolean;
+        includeRootOutput?: boolean;
     }): Promise<SpanTreeResponse>;
     /**
      * Read which of a replay run's traces the server has fully persisted.
@@ -2348,7 +2353,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.36.1";
+declare const __version__ = "0.36.2";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.js

@@ -11,7 +11,7 @@ import {
   getCurrentReplayBranch,
   getCurrentSpan,
   getCurrentTrace
-} from "./chunk-HD4DRDRE.js";
+} from "./chunk-XZKYSTWH.js";
 import {
   BITFAB_PROGRESS_PREFIX,
   BitfabError,
@@ -20,7 +20,7 @@ import {
   __version__,
   flushTraces,
   reportReplayProgress
-} from "./chunk-6ZBZBR5K.js";
+} from "./chunk-4IY5SZYR.js";
 export {
   BITFAB_PROGRESS_PREFIX,
   Bitfab,

package/dist/node.cjs

@@ -88,7 +88,7 @@ var __version__;
 var init_version_generated = __esm({
   "src/version.generated.ts"() {
     "use strict";
-    __version__ = "0.36.1";
+    __version__ = "0.36.2";
   }
 });
 
@@ -1528,9 +1528,11 @@ var init_http = __esm({
       /**
        * Fetch an external span by ID.
        * Blocking GET request.
+       * The replay view limits rawData to input/output serialization fields.
        */
-      async getExternalSpan(spanId) {
-        const url = `${this.serviceUrl}/api/sdk/externalSpans/${spanId}`;
+      async getExternalSpan(spanId, options) {
+        const query = options?.view === "replay" ? "?view=replay" : "";
+        const url = `${this.serviceUrl}/api/sdk/externalSpans/${spanId}${query}`;
         const controller = new AbortController();
         const timeoutId = setTimeout(() => controller.abort(), 3e4);
         try {
@@ -1568,9 +1570,18 @@ var init_http = __esm({
        * Pass `includeOutputs: false` for a payload-free tree (structure +
        * `externalSpanId` only), so recorded outputs are fetched lazily per mocked
        * span instead of all up front. Omit it (default eager) for `mock: "all"`.
+       * Pass `includeRootOutput: false` when the root was already fetched.
        */
       async getSpanTree(externalSpanId, options) {
-        const query = options?.includeOutputs === false ? "?includeOutputs=false" : "";
+        const searchParams = new URLSearchParams();
+        if (options?.includeOutputs === false) {
+          searchParams.set("includeOutputs", "false");
+        }
+        if (options?.includeRootOutput === false) {
+          searchParams.set("includeRootOutput", "false");
+        }
+        const encodedQuery = searchParams.toString();
+        const query = encodedQuery ? `?${encodedQuery}` : "";
         const url = `${this.serviceUrl}/api/sdk/replay/spanTree/${externalSpanId}${query}`;
         const controller = new AbortController();
         const timeoutId = setTimeout(() => controller.abort(), 3e4);
@@ -2153,7 +2164,9 @@ async function processItem(httpClient, serverItem, fn, testRunId, mockStrategy,
         `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.`
       );
     }
-    const span = await httpClient.getExternalSpan(originalSpanId);
+    const span = await httpClient.getExternalSpan(originalSpanId, {
+      view: "replay"
+    });
     const spanData = span.rawData?.span_data ?? {};
     inputs = deserializeInputs(spanData);
     originalOutput = deserializeOutput(spanData);
@@ -2173,7 +2186,8 @@ async function processItem(httpClient, serverItem, fn, testRunId, mockStrategy,
     if (needTree) {
       try {
         const treeResponse = await httpClient.getSpanTree(originalSpanId, {
-          includeOutputs
+          includeOutputs,
+          includeRootOutput: false
         });
         if (treeResponse.root) {
           mockTree = buildMockTree(treeResponse.root);
@@ -2195,7 +2209,7 @@ async function processItem(httpClient, serverItem, fn, testRunId, mockStrategy,
     const fetchSpanOutput = mockTree && !includeOutputs ? (externalSpanId) => {
       let pending = outputCache.get(externalSpanId);
       if (!pending) {
-        pending = httpClient.getExternalSpan(externalSpanId).then(
+        pending = httpClient.getExternalSpan(externalSpanId, { view: "replay" }).then(
           (s) => deserializeOutput(
             s.rawData?.span_data ?? {}
           )