@bitfab/sdk 0.64.12 → 0.64.14

package/dist/index.d.cts

@@ -668,6 +668,7 @@ declare class HttpClient {
     lookupFunction<T>(name: string): Promise<T>;
     getSimulationPlan(): Promise<SimulationPlanResponse>;
     getTraceSpan(traceId: string, lookup: SpanLookup): Promise<CapturedSpan | null>;
+    getSpan(spanId: string): Promise<CapturedSpan | null>;
     /**
      * GET a JSON endpoint on the service with the client's API key. Throws a
      * `BitfabError` carrying the status text for any non-2xx response.
@@ -3684,6 +3685,7 @@ declare class Bitfab {
      * as `"first"` or a zero-based index to select a different match.
      */
     getTraceSpan(traceId: string, lookup: SpanLookup): Promise<CapturedSpan | null>;
+    getSpan(spanId: string): Promise<CapturedSpan | null>;
     /**
      * Get a function wrapper for a specific trace function key.
      *
@@ -3996,7 +3998,7 @@ interface CommitRef {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.64.12";
+declare const __version__ = "0.64.14";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.d.ts

@@ -668,6 +668,7 @@ declare class HttpClient {
     lookupFunction<T>(name: string): Promise<T>;
     getSimulationPlan(): Promise<SimulationPlanResponse>;
     getTraceSpan(traceId: string, lookup: SpanLookup): Promise<CapturedSpan | null>;
+    getSpan(spanId: string): Promise<CapturedSpan | null>;
     /**
      * GET a JSON endpoint on the service with the client's API key. Throws a
      * `BitfabError` carrying the status text for any non-2xx response.
@@ -3684,6 +3685,7 @@ declare class Bitfab {
      * as `"first"` or a zero-based index to select a different match.
      */
     getTraceSpan(traceId: string, lookup: SpanLookup): Promise<CapturedSpan | null>;
+    getSpan(spanId: string): Promise<CapturedSpan | null>;
     /**
      * Get a function wrapper for a specific trace function key.
      *
@@ -3996,7 +3998,7 @@ interface CommitRef {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.64.12";
+declare const __version__ = "0.64.14";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.js

@@ -27,7 +27,7 @@ import {
   getCurrentTrace,
   reseedFromRegistry,
   seedFromRegistry
-} from "./chunk-5QG5ZNU6.js";
+} from "./chunk-F5ZFL5W6.js";
 import "./chunk-YWXQM6J3.js";
 import {
   BITFAB_PROGRESS_PREFIX,
@@ -36,7 +36,7 @@ import {
   ReplayError,
   reportReplayProgress,
   serializeReplayResult
-} from "./chunk-N5S3P2Y5.js";
+} from "./chunk-PXNFY22G.js";
 import {
   BitfabError,
   DEFAULT_SERVICE_URL,
@@ -44,7 +44,7 @@ import {
   MixedTracingError,
   __version__,
   flushTraces
-} from "./chunk-JAD7I5FM.js";
+} from "./chunk-A7NX4OKG.js";
 import "./chunk-MT36GJMW.js";
 export {
   AssertionCategoriesClient,

package/dist/node.cjs

@@ -88,7 +88,7 @@ var __version__, __packageName__;
 var init_version_generated = __esm({
   "src/version.generated.ts"() {
     "use strict";
-    __version__ = "0.64.12";
+    __version__ = "0.64.14";
     __packageName__ = "@bitfab/sdk";
   }
 });
@@ -2744,6 +2744,12 @@ var init_http = __esm({
         const response = await this.get(endpoint);
         return response.span;
       }
+      async getSpan(spanId) {
+        const response = await this.get(
+          `/api/sdk/spans/${encodeURIComponent(spanId)}`
+        );
+        return response.span;
+      }
       /**
        * GET a JSON endpoint on the service with the client's API key. Throws a
        * `BitfabError` carrying the status text for any non-2xx response.
@@ -4648,7 +4654,7 @@ async function processItem(httpClient, serverItem, fn, experimentId, mockStrateg
     dbBranchTimings: dbBranchTimings ?? null
   };
 }
-async function waitForReplayPersistence(httpClient, experimentId, replayedTraceIds) {
+async function waitForReplayPersistence(httpClient, experimentId, replayedTraceIds, replayLabels = {}, warn2 = console.warn) {
   const deferredSettled = await httpClient.settleDeferredWork(
     REPLAY_PERSISTENCE_TIMEOUT_MS
   );
@@ -4681,7 +4687,7 @@ async function waitForReplayPersistence(httpClient, experimentId, replayedTraceI
     return readBackTraceIds;
   }
   const deadline = Date.now() + REPLAY_PERSISTENCE_TIMEOUT_MS;
-  let missing = Object.keys(expectedSpanCounts).length;
+  let missing = Object.keys(expectedSpanCounts);
   while (true) {
     const status = await httpClient.getReplayStatus(
       experimentId,
@@ -4691,8 +4697,8 @@ async function waitForReplayPersistence(httpClient, experimentId, replayedTraceI
     Object.assign(readBackTraceIds, ready);
     missing = Object.keys(expectedSpanCounts).filter(
       (traceId) => ready[traceId] === void 0
-    ).length;
-    if (missing === 0) {
+    );
+    if (missing.length === 0) {
       return readBackTraceIds;
     }
     if (Date.now() >= deadline) {
@@ -4702,10 +4708,19 @@ async function waitForReplayPersistence(httpClient, experimentId, replayedTraceI
       Math.min(100, Math.max(0, deadline - Date.now()))
     );
   }
-  const cause = flushed ? "" : " Delivery was also not confirmed before the flush deadline, so the spans likely never reached the server.";
-  throw new BitfabError(
-    `Replay traces were not fully persisted before the delivery deadline (experiment ${experimentId}, missing ${missing} of ${Object.keys(expectedSpanCounts).length} trace(s)).${cause}`
-  );
+  for (const traceId of missing) {
+    warn2(
+      unconfirmedReplayWarning(
+        replayLabels[traceId] ?? traceId,
+        REPLAY_PERSISTENCE_TIMEOUT_MS / 1e3,
+        flushed
+      )
+    );
+  }
+  return readBackTraceIds;
+}
+function unconfirmedReplayWarning(label, seconds, flushed) {
+  return `[bitfab] replay ${label} could not confirm all spans reached Bitfab within ${seconds}s. The run continues; Bitfab will show this replay as capture incomplete.${flushed ? "" : " Some spans likely never left this process."}`;
 }
 function sleepForReplayPersistence(ms) {
   return new Promise((resolve) => {
@@ -5108,7 +5123,17 @@ async function runReplaySession(httpClient, fn, session, fullExperimentUrl, maxC
   }
   throwIfInterrupted(interrupted, resultItems, experimentId, fullExperimentUrl);
   const deliveredTraceIds = await preserveReplayFailure(
-    () => waitForReplayPersistence(httpClient, experimentId, replayedTraceIds),
+    () => waitForReplayPersistence(
+      httpClient,
+      experimentId,
+      replayedTraceIds,
+      Object.fromEntries(
+        workItems.map(({ serverItem, attempt }, index) => [
+          replayedTraceIds[index],
+          `${serverItem.originalTraceId ?? serverItem.sourceTraceId}#${attempt}`
+        ])
+      )
+    ),
     resultItems,
     experimentId,
     fullExperimentUrl
@@ -11472,6 +11497,12 @@ var Bitfab = class {
     }
     return this.httpClient.getTraceSpan(traceId, lookup);
   }
+  async getSpan(spanId) {
+    if (typeof spanId !== "string" || spanId.trim().length === 0) {
+      throw new BitfabError("spanId must be a non-empty string");
+    }
+    return this.httpClient.getSpan(spanId);
+  }
   /**
    * Get a function wrapper for a specific trace function key.
    *