@bitfab/sdk 0.36.7 → 0.36.8

package/dist/index.d.cts

@@ -77,6 +77,12 @@ declare class BitfabError extends Error {
      * cannot supply. Absent for network failures and non-HTTP errors.
      */
     readonly status?: number | undefined;
+    /**
+     * `Retry-After` in milliseconds, when the server sent one. A 429 or 503
+     * carries the server's own instruction about when to come back; retrying
+     * on our own schedule ignores it and keeps the pressure on.
+     */
+    readonly retryAfterMs?: number | undefined;
     constructor(message: string, url?: string | undefined, 
     /**
      * HTTP status the request failed with, when it failed with one. The
@@ -84,7 +90,13 @@ declare class BitfabError extends Error {
      * never a 4xx the server will reject again), which a formatted message
      * cannot supply. Absent for network failures and non-HTTP errors.
      */
-    status?: number | undefined);
+    status?: number | undefined, 
+    /**
+     * `Retry-After` in milliseconds, when the server sent one. A 429 or 503
+     * carries the server's own instruction about when to come back; retrying
+     * on our own schedule ignores it and keeps the pressure on.
+     */
+    retryAfterMs?: number | undefined);
 }
 
 /**
@@ -334,17 +346,20 @@ interface CapturedSpan {
     startedAt: string | null;
     endedAt: string | null;
 }
-/**
- * HTTP client for Bitfab API requests.
- *
- * Provides methods for different API endpoints with proper error handling,
- * timeouts, and authentication.
- */
+/** What a caller learns about one tracked trace once it takes it back. */
+interface DeliveryReport {
+    spanCount: number;
+    /** A closing carrier was submitted, so the expected set is final. */
+    closed: boolean;
+    /** Every carrier submitted under this trace came back accepted. */
+    delivered: boolean;
+}
 declare class HttpClient {
     private readonly apiKey;
     private readonly serviceUrl;
     private readonly timeout;
     private traceTransport;
+    private readonly traceDeliveries;
     private readonly deferredWork;
     private closed;
     private closing;
@@ -363,6 +378,39 @@ declare class HttpClient {
      * of each spinning up their own.
      */
     private getTraceTransport;
+    /**
+     * Post one encoded batch and decide what the server's answer means, so the
+     * transport never reads a response. Rejections and permanent statuses come
+     * back as a non-retryable {@link DeliveryError}; anything the server might
+     * still accept on a second try comes back retryable.
+     */
+    private deliverCarriers;
+    /**
+     * Start tracking delivery for `traceIds`. Nothing is recorded for a trace
+     * that was never tracked, so ordinary tracing costs no bookkeeping at all.
+     */
+    trackTraceDeliveries(traceIds: string[]): void;
+    /** Whether any tracked trace has had its closing carrier submitted. */
+    hasClosedDeliveries(traceIds: string[]): boolean;
+    /**
+     * Report what each tracked trace submitted and whether the server confirmed
+     * it, and stop tracking them. Every id passed is freed, so a caller cannot
+     * leak a record for a trace that never closed.
+     *
+     * `delivered` is only meaningful once a flush has settled: acks land before
+     * an export resolves, so a flush that reported success has already collected
+     * every ack it is going to collect.
+     */
+    takeTraceDeliveries(traceIds: string[]): Record<string, DeliveryReport>;
+    /** Build a carrier's meta and record what it adds to its trace's expected set. */
+    private recordedMeta;
+    private recordSubmittedCarrier;
+    /**
+     * Ingestion commits every carrier in a request before it answers, so a
+     * delivered ref is proof its row exists: the same fact the replay status
+     * endpoint would report, already in hand.
+     */
+    private recordDeliveredCarriers;
     /**
      * Track deferred span work so this client's own lifecycle waits for it, and
      * so the process-wide flush and exit hook do too.
@@ -2509,7 +2557,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.36.7";
+declare const __version__ = "0.36.8";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.d.ts

@@ -77,6 +77,12 @@ declare class BitfabError extends Error {
      * cannot supply. Absent for network failures and non-HTTP errors.
      */
     readonly status?: number | undefined;
+    /**
+     * `Retry-After` in milliseconds, when the server sent one. A 429 or 503
+     * carries the server's own instruction about when to come back; retrying
+     * on our own schedule ignores it and keeps the pressure on.
+     */
+    readonly retryAfterMs?: number | undefined;
     constructor(message: string, url?: string | undefined, 
     /**
      * HTTP status the request failed with, when it failed with one. The
@@ -84,7 +90,13 @@ declare class BitfabError extends Error {
      * never a 4xx the server will reject again), which a formatted message
      * cannot supply. Absent for network failures and non-HTTP errors.
      */
-    status?: number | undefined);
+    status?: number | undefined, 
+    /**
+     * `Retry-After` in milliseconds, when the server sent one. A 429 or 503
+     * carries the server's own instruction about when to come back; retrying
+     * on our own schedule ignores it and keeps the pressure on.
+     */
+    retryAfterMs?: number | undefined);
 }
 
 /**
@@ -334,17 +346,20 @@ interface CapturedSpan {
     startedAt: string | null;
     endedAt: string | null;
 }
-/**
- * HTTP client for Bitfab API requests.
- *
- * Provides methods for different API endpoints with proper error handling,
- * timeouts, and authentication.
- */
+/** What a caller learns about one tracked trace once it takes it back. */
+interface DeliveryReport {
+    spanCount: number;
+    /** A closing carrier was submitted, so the expected set is final. */
+    closed: boolean;
+    /** Every carrier submitted under this trace came back accepted. */
+    delivered: boolean;
+}
 declare class HttpClient {
     private readonly apiKey;
     private readonly serviceUrl;
     private readonly timeout;
     private traceTransport;
+    private readonly traceDeliveries;
     private readonly deferredWork;
     private closed;
     private closing;
@@ -363,6 +378,39 @@ declare class HttpClient {
      * of each spinning up their own.
      */
     private getTraceTransport;
+    /**
+     * Post one encoded batch and decide what the server's answer means, so the
+     * transport never reads a response. Rejections and permanent statuses come
+     * back as a non-retryable {@link DeliveryError}; anything the server might
+     * still accept on a second try comes back retryable.
+     */
+    private deliverCarriers;
+    /**
+     * Start tracking delivery for `traceIds`. Nothing is recorded for a trace
+     * that was never tracked, so ordinary tracing costs no bookkeeping at all.
+     */
+    trackTraceDeliveries(traceIds: string[]): void;
+    /** Whether any tracked trace has had its closing carrier submitted. */
+    hasClosedDeliveries(traceIds: string[]): boolean;
+    /**
+     * Report what each tracked trace submitted and whether the server confirmed
+     * it, and stop tracking them. Every id passed is freed, so a caller cannot
+     * leak a record for a trace that never closed.
+     *
+     * `delivered` is only meaningful once a flush has settled: acks land before
+     * an export resolves, so a flush that reported success has already collected
+     * every ack it is going to collect.
+     */
+    takeTraceDeliveries(traceIds: string[]): Record<string, DeliveryReport>;
+    /** Build a carrier's meta and record what it adds to its trace's expected set. */
+    private recordedMeta;
+    private recordSubmittedCarrier;
+    /**
+     * Ingestion commits every carrier in a request before it answers, so a
+     * delivered ref is proof its row exists: the same fact the replay status
+     * endpoint would report, already in hand.
+     */
+    private recordDeliveredCarriers;
     /**
      * Track deferred span work so this client's own lifecycle waits for it, and
      * so the process-wide flush and exit hook do too.
@@ -2509,7 +2557,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.36.7";
+declare const __version__ = "0.36.8";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.js

@@ -11,7 +11,7 @@ import {
   getCurrentReplayBranch,
   getCurrentSpan,
   getCurrentTrace
-} from "./chunk-EDOZ3DP3.js";
+} from "./chunk-B4HK3BPE.js";
 import {
   BITFAB_PROGRESS_PREFIX,
   BitfabError,
@@ -23,7 +23,7 @@ import {
   flushTraces,
   reportReplayProgress,
   serializeReplayResult
-} from "./chunk-CFECTUDU.js";
+} from "./chunk-QUX6N7ON.js";
 export {
   BITFAB_PROGRESS_PREFIX,
   Bitfab,