@bitfab/sdk 0.51.0 → 0.52.1

package/dist/{http-HLRWCSFF.js → http-B2AK43BN.js}

@@ -6,7 +6,7 @@ import {
   flushTraces,
   parseRetryAfterMs,
   serializePayloadBody
-} from "./chunk-RGC7IEOI.js";
+} from "./chunk-6DIR65JW.js";
 import "./chunk-H6LZRFMN.js";
 export {
   BitfabError,
@@ -17,4 +17,4 @@ export {
   parseRetryAfterMs,
   serializePayloadBody
 };
-//# sourceMappingURL=http-HLRWCSFF.js.map
+//# sourceMappingURL=http-B2AK43BN.js.map

package/dist/{http-AKFJONE7.js → http-RI4YCAS2.js}

@@ -6,7 +6,7 @@ import {
   flushTraces,
   parseRetryAfterMs,
   serializePayloadBody
-} from "./chunk-4CLJF2DZ.js";
+} from "./chunk-UQLT25PG.js";
 export {
   BitfabError,
   HttpClient,
@@ -16,4 +16,4 @@ export {
   parseRetryAfterMs,
   serializePayloadBody
 };
-//# sourceMappingURL=http-AKFJONE7.js.map
+//# sourceMappingURL=http-RI4YCAS2.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.51.0";
+    __version__ = "0.52.1";
     __packageName__ = "@bitfab/sdk";
   }
 });
@@ -534,6 +534,69 @@ var init_serializePayload = __esm({
   }
 });
 
+// src/traceMetadata.ts
+function recordCallerTraceMetadata(traceId, metadata) {
+  if (typeof traceId !== "string" || traceId === "") {
+    return;
+  }
+  if (typeof metadata !== "object" || metadata === null) {
+    return;
+  }
+  if (Object.keys(metadata).length === 0) {
+    return;
+  }
+  callerMetadata.set(traceId, { ...callerMetadata.get(traceId), ...metadata });
+}
+function callerTraceMetadata(traceId) {
+  const recorded = callerMetadata.get(traceId);
+  return recorded ? { ...recorded } : void 0;
+}
+function forgetTraceMetadata(traceId) {
+  callerMetadata.delete(traceId);
+  derivedMetadata.delete(traceId);
+}
+function mergeCallerMetadataIntoTracePayload(payload) {
+  const externalTrace = payload.externalTrace;
+  if (typeof externalTrace !== "object" || externalTrace === null) {
+    return payload;
+  }
+  const external = externalTrace;
+  const traceId = typeof payload.id === "string" && payload.id !== "" ? payload.id : external.id;
+  if (typeof traceId !== "string" || traceId === "") {
+    return payload;
+  }
+  const caller = callerMetadata.get(traceId);
+  if (!caller) {
+    return payload;
+  }
+  const derived = derivedMetadata.get(traceId) ?? {};
+  const exported = external.metadata;
+  if (typeof exported === "object" && exported !== null) {
+    Object.assign(derived, exported);
+  }
+  derivedMetadata.set(traceId, derived);
+  const shadowed = Object.keys(derived).filter((key) => key in caller && caller[key] !== derived[key]).sort();
+  if (shadowed.length > 0) {
+    warnOnce(
+      `trace-metadata-shadowed:${shadowed.join(",")}`,
+      `trace metadata key(s) ${shadowed.join(", ")} were set both by the caller and by an integration's own trace export; the caller's value is the one kept on the trace.`
+    );
+  }
+  return {
+    ...payload,
+    externalTrace: { ...external, metadata: { ...derived, ...caller } }
+  };
+}
+var callerMetadata, derivedMetadata;
+var init_traceMetadata = __esm({
+  "src/traceMetadata.ts"() {
+    "use strict";
+    init_warnOnce();
+    callerMetadata = /* @__PURE__ */ new Map();
+    derivedMetadata = /* @__PURE__ */ new Map();
+  }
+});
+
 // src/transportTypes.ts
 var DeliveryError;
 var init_transportTypes = __esm({
@@ -1352,6 +1415,7 @@ var init_http = __esm({
     init_errors();
     init_replayContext();
     init_serializePayload();
+    init_traceMetadata();
     init_transport();
     init_transportTypes();
     init_unrefTimer();
@@ -1815,7 +1879,8 @@ var init_http = __esm({
        * {@link HttpClient.sendExternalSpan}; replay confirms persistence with the
        * server-authoritative barrier in `replay.ts`, not by awaiting this call.
        */
-      sendExternalTrace(payload) {
+      sendExternalTrace(rawPayload) {
+        const payload = mergeCallerMetadataIntoTracePayload(rawPayload);
         this.getTraceTransport()?.submit(
           "external_trace",
           {
@@ -3316,7 +3381,8 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/assertions.ts
-function expectationsPath(traceId, suffix = "") {
+var ASSERTIONS_PATH = "/api/sdk/traces/assertions";
+function traceAssertionsPath(traceId, suffix = "") {
   return `/api/sdk/traces/${encodeURIComponent(traceId)}/assertions${suffix}`;
 }
 var TracesClient = class {
@@ -3324,18 +3390,29 @@ var TracesClient = class {
     this.httpClient = httpClient;
   }
   async getAssertions(traceId) {
-    return this.httpClient.get(expectationsPath(traceId));
+    return this.httpClient.get(
+      traceAssertionsPath(traceId)
+    );
   }
   async saveAssertions(params) {
-    const response = await this.httpClient.request(expectationsPath(params.traceId), {
-      assertions: params.assertions,
+    return this.saveAssertionsAll({
+      updates: [{ traceId: params.traceId, assertions: params.assertions }],
+      source: params.source
+    });
+  }
+  async saveAssertionsAll(params) {
+    if (params.updates.length === 0) {
+      return [];
+    }
+    const response = await this.httpClient.request(ASSERTIONS_PATH, {
+      updates: params.updates,
       source: params.source ?? "agent"
     });
     return response.assertions;
   }
   async archiveAssertions(params) {
     const response = await this.httpClient.request(
-      expectationsPath(params.traceId, "/archive"),
+      traceAssertionsPath(params.traceId, "/archive"),
       { assertionIds: params.assertionIds }
     );
     return response.archived;
@@ -5688,6 +5765,7 @@ function runWithSeedContext(ctx, fn) {
 
 // src/client.ts
 init_serialize();
+init_traceMetadata();
 
 // src/tracing.ts
 init_constants();
@@ -6368,8 +6446,7 @@ function getCurrentTrace() {
         if (typeof metadata !== "object" || metadata === null) {
           return;
         }
-        const traceState = getOrCreateTraceState();
-        traceState.metadata = { ...traceState.metadata, ...metadata };
+        recordCallerTraceMetadata(traceId, metadata);
       } catch {
       }
     },
@@ -7362,7 +7439,7 @@ var Bitfab = class {
                 endedAt,
                 sessionId: traceState?.sessionId,
                 name: traceState?.name,
-                metadata: traceState?.metadata,
+                metadata: callerTraceMetadata(traceId),
                 contexts: traceState?.contexts ?? [],
                 testRunId: traceState?.testRunId,
                 inputSourceTraceId: traceState?.inputSourceTraceId,
@@ -7386,6 +7463,7 @@ var Bitfab = class {
                 }
               });
               activeTraceStates.delete(traceId);
+              forgetTraceMetadata(traceId);
             }
           } catch {
           }
@@ -7578,6 +7656,7 @@ var Bitfab = class {
       } catch (setupError) {
         if (registeredTraceId) {
           activeTraceStates.delete(registeredTraceId);
+          forgetTraceMetadata(registeredTraceId);
         }
         if (setupError instanceof MixedTracingError) {
           throw setupError;
@@ -7938,14 +8017,16 @@ var Bitfab = class {
     }
     const traceId = randomUuid();
     const startedAt = nowIsoTimestamp();
+    if (options.metadata !== void 0) {
+      recordCallerTraceMetadata(traceId, options.metadata);
+    }
     activeTraceStates.set(traceId, {
       traceId,
       startedAt,
       contexts: [],
       ingestionType: "seeded",
       ...options.sessionId !== void 0 && { sessionId: options.sessionId },
-      ...options.name !== void 0 && { name: options.name },
-      ...options.metadata !== void 0 && { metadata: options.metadata }
+      ...options.name !== void 0 && { name: options.name }
     });
     try {
       this.sendWrapperSpan({
@@ -7968,12 +8049,13 @@ var Bitfab = class {
         endedAt: startedAt,
         sessionId: options.sessionId,
         name: options.name,
-        metadata: options.metadata,
+        metadata: callerTraceMetadata(traceId),
         contexts: [],
         ingestionType: "seeded"
       });
     } finally {
       activeTraceStates.delete(traceId);
+      forgetTraceMetadata(traceId);
     }
     return traceId;
   }
@@ -7998,14 +8080,16 @@ var Bitfab = class {
     }
     await seedContextReady;
     const traceId = randomUuid();
+    if (options?.metadata !== void 0) {
+      recordCallerTraceMetadata(traceId, options.metadata);
+    }
     activeTraceStates.set(traceId, {
       traceId,
       startedAt: nowIsoTimestamp(),
       contexts: [],
       ingestionType: "seeded",
       ...options?.sessionId !== void 0 && { sessionId: options.sessionId },
-      ...options?.name !== void 0 && { name: options.name },
-      ...options?.metadata !== void 0 && { metadata: options.metadata }
+      ...options?.name !== void 0 && { name: options.name }
     });
     const args = options?.args ?? [];
     let unrecorded = true;
@@ -8017,6 +8101,7 @@ var Bitfab = class {
         await flushTraces2(3e4);
       } finally {
         unrecorded = activeTraceStates.delete(traceId);
+        forgetTraceMetadata(traceId);
       }
     }
     if (unrecorded) {