@bitfab/sdk 0.64.12 → 0.64.14

package/dist/{http-UMVAAJ63.js → http-C44ETCJK.js}

@@ -7,7 +7,7 @@ import {
   flushTraces,
   parseRetryAfterMs,
   serializePayloadBody
-} from "./chunk-6D6TGYH4.js";
+} from "./chunk-GURR5AWG.js";
 export {
   BitfabError,
   HttpClient,
@@ -18,4 +18,4 @@ export {
   parseRetryAfterMs,
   serializePayloadBody
 };
-//# sourceMappingURL=http-UMVAAJ63.js.map
+//# sourceMappingURL=http-C44ETCJK.js.map

package/dist/{http-STSTJGRH.js → http-QX6O4EDS.js}

@@ -7,7 +7,7 @@ import {
   flushTraces,
   parseRetryAfterMs,
   serializePayloadBody
-} from "./chunk-JAD7I5FM.js";
+} from "./chunk-A7NX4OKG.js";
 import "./chunk-MT36GJMW.js";
 export {
   BitfabError,
@@ -19,4 +19,4 @@ export {
   parseRetryAfterMs,
   serializePayloadBody
 };
-//# sourceMappingURL=http-STSTJGRH.js.map
+//# sourceMappingURL=http-QX6O4EDS.js.map

package/dist/index.cjs

@@ -42,7 +42,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";
   }
 });
@@ -2737,6 +2737,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.
@@ -4641,7 +4647,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
   );
@@ -4674,7 +4680,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,
@@ -4684,8 +4690,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) {
@@ -4695,10 +4701,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) => {
@@ -5101,7 +5116,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
@@ -11458,6 +11483,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.
    *