@bitfab/sdk 0.13.5 → 0.13.7

package/dist/index.d.cts

@@ -151,14 +151,8 @@ declare class BitfabClaudeAgentHandler {
  * `DbSnapshotRef` that pins the DB state at trace open by wall-clock
  * timestamp. The Bitfab service uses that timestamp at replay time to
  * materialize an ephemeral branch from `customer-main`.
- *
- * v0 is timestamp-only. LSN-based pinning is intentionally not exposed
- * yet — the customer-LSN to replica-LSN mapping isn't built, so the
- * mapping primitive would have no resolver to consume it. The
- * `DbSnapshotRef.ref` field is reserved for that future use.
  */
-/** Providers the SDK accepts for `dbSnapshot.provider`. Server-side resolver dispatches on this. */
-declare const SUPPORTED_PROVIDERS: readonly ["neon", "ardent", "dolt", "gfs", "mongodb-atlas", "dynamodb", "snowflake", "bigquery"];
+declare const SUPPORTED_PROVIDERS: readonly ["neon"];
 type DbSnapshotProvider = (typeof SUPPORTED_PROVIDERS)[number];
 interface DbSnapshotConfig {
     /** Discriminator for the server-side resolver. */
@@ -168,18 +162,11 @@ interface DbSnapshotRef {
     provider: DbSnapshotProvider;
     /**
      * The wall-clock ISO timestamp the SDK observed immediately before
-     * invoking the wrapped function. This is the moment used as the
-     * "snapshot pin" by the timestamp-based resolver path. The name encodes
-     * its provenance: SDK-observed, wall clock (not monotonic), captured
-     * before user code began executing — distinct from server-side or
-     * DB-side timestamps recorded elsewhere on the trace.
+     * invoking the wrapped function. The name encodes its provenance:
+     * SDK-observed, wall clock (not monotonic), captured before user code
+     * began executing.
      */
     sdkWallClockBeforeFn: string;
-    /**
-     * Reserved for future provider-specific opaque payload (e.g. customer
-     * LSN once a source-to-replica mapping exists). Unused in v0.
-     */
-    ref?: Record<string, unknown>;
 }
 
 /**
@@ -317,7 +304,6 @@ interface ReplayEnvironmentSnapshot {
     providerConsoleUrl?: string;
     readOnly?: boolean;
     traceId: string;
-    precision: "timestamp" | "lsn";
 }
 declare class ReplayEnvironment {
     /**
@@ -337,12 +323,6 @@ declare class ReplayEnvironment {
     get readOnly(): boolean | undefined;
     /** The historical trace ID that produced the input for this replay item. */
     get traceId(): string;
-    /**
-     * How the resolver pinned this branch.
-     * - "timestamp": snapshot at SDK wall clock; bounded by replication lag.
-     * - "lsn": customer LSN mapped to a replica snapshot (future).
-     */
-    get precision(): "timestamp" | "lsn";
     /** True when read inside a replay item that has a resolved branch. */
     get active(): boolean;
     /** Non-throwing variant for callers that handle the inactive case. */
@@ -394,6 +374,8 @@ interface ReplayOptions {
      * environment to pick up the per-trace branch URL.
      */
     environment?: ReplayEnvironment;
+    /** Group ID to associate this replay with an experiment group for live streaming in Studio. */
+    experimentGroupId?: string;
 }
 interface ReplayItem<T> {
     /** Trace ID of the new trace created during replay. */
@@ -1008,7 +990,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.13.5";
+declare const __version__ = "0.13.7";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.d.ts

@@ -151,14 +151,8 @@ declare class BitfabClaudeAgentHandler {
  * `DbSnapshotRef` that pins the DB state at trace open by wall-clock
  * timestamp. The Bitfab service uses that timestamp at replay time to
  * materialize an ephemeral branch from `customer-main`.
- *
- * v0 is timestamp-only. LSN-based pinning is intentionally not exposed
- * yet — the customer-LSN to replica-LSN mapping isn't built, so the
- * mapping primitive would have no resolver to consume it. The
- * `DbSnapshotRef.ref` field is reserved for that future use.
  */
-/** Providers the SDK accepts for `dbSnapshot.provider`. Server-side resolver dispatches on this. */
-declare const SUPPORTED_PROVIDERS: readonly ["neon", "ardent", "dolt", "gfs", "mongodb-atlas", "dynamodb", "snowflake", "bigquery"];
+declare const SUPPORTED_PROVIDERS: readonly ["neon"];
 type DbSnapshotProvider = (typeof SUPPORTED_PROVIDERS)[number];
 interface DbSnapshotConfig {
     /** Discriminator for the server-side resolver. */
@@ -168,18 +162,11 @@ interface DbSnapshotRef {
     provider: DbSnapshotProvider;
     /**
      * The wall-clock ISO timestamp the SDK observed immediately before
-     * invoking the wrapped function. This is the moment used as the
-     * "snapshot pin" by the timestamp-based resolver path. The name encodes
-     * its provenance: SDK-observed, wall clock (not monotonic), captured
-     * before user code began executing — distinct from server-side or
-     * DB-side timestamps recorded elsewhere on the trace.
+     * invoking the wrapped function. The name encodes its provenance:
+     * SDK-observed, wall clock (not monotonic), captured before user code
+     * began executing.
      */
     sdkWallClockBeforeFn: string;
-    /**
-     * Reserved for future provider-specific opaque payload (e.g. customer
-     * LSN once a source-to-replica mapping exists). Unused in v0.
-     */
-    ref?: Record<string, unknown>;
 }
 
 /**
@@ -317,7 +304,6 @@ interface ReplayEnvironmentSnapshot {
     providerConsoleUrl?: string;
     readOnly?: boolean;
     traceId: string;
-    precision: "timestamp" | "lsn";
 }
 declare class ReplayEnvironment {
     /**
@@ -337,12 +323,6 @@ declare class ReplayEnvironment {
     get readOnly(): boolean | undefined;
     /** The historical trace ID that produced the input for this replay item. */
     get traceId(): string;
-    /**
-     * How the resolver pinned this branch.
-     * - "timestamp": snapshot at SDK wall clock; bounded by replication lag.
-     * - "lsn": customer LSN mapped to a replica snapshot (future).
-     */
-    get precision(): "timestamp" | "lsn";
     /** True when read inside a replay item that has a resolved branch. */
     get active(): boolean;
     /** Non-throwing variant for callers that handle the inactive case. */
@@ -394,6 +374,8 @@ interface ReplayOptions {
      * environment to pick up the per-trace branch URL.
      */
     environment?: ReplayEnvironment;
+    /** Group ID to associate this replay with an experiment group for live streaming in Studio. */
+    experimentGroupId?: string;
 }
 interface ReplayItem<T> {
     /** Trace ID of the new trace created during replay. */
@@ -1008,7 +990,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.13.5";
+declare const __version__ = "0.13.7";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.js

@@ -8,13 +8,13 @@ import {
   SUPPORTED_PROVIDERS,
   getCurrentSpan,
   getCurrentTrace
-} from "./chunk-4IHJJRMU.js";
+} from "./chunk-LUZVIGER.js";
 import {
   BitfabError,
   DEFAULT_SERVICE_URL,
   __version__,
   flushTraces
-} from "./chunk-BVFST7Q3.js";
+} from "./chunk-EGRWBJYR.js";
 export {
   Bitfab,
   BitfabClaudeAgentHandler,

package/dist/node.cjs

@@ -81,7 +81,7 @@ var __version__;
 var init_version_generated = __esm({
   "src/version.generated.ts"() {
     "use strict";
-    __version__ = "0.13.5";
+    __version__ = "0.13.7";
   }
 });
 
@@ -312,7 +312,7 @@ var init_http = __esm({
        * Start a replay session by fetching historical traces.
        * Blocking call — creates a test run and returns lightweight item references.
        */
-      async startReplay(traceFunctionKey, limit, traceIds, codeChangeDescription, codeChangeFiles, includeDbBranchLease) {
+      async startReplay(traceFunctionKey, limit, traceIds, codeChangeDescription, codeChangeFiles, includeDbBranchLease, experimentGroupId) {
         const payload = { traceFunctionKey, limit };
         if (traceIds) {
           payload.traceIds = traceIds;
@@ -326,6 +326,9 @@ var init_http = __esm({
         if (includeDbBranchLease) {
           payload.includeDbBranchLease = true;
         }
+        if (experimentGroupId !== void 0) {
+          payload.experimentGroupId = experimentGroupId;
+        }
         const timeout = includeDbBranchLease ? 18e4 : 3e4;
         return this.request("/api/sdk/replay/start", payload, {
           timeout
@@ -427,11 +430,11 @@ var init_http = __esm({
           { timeout: 9e4 }
         );
       }
-      /** Release a previously-resolved DB branch lease. Idempotent server-side. */
-      async releaseDbBranchLease(leaseId) {
+      /** Release a previously-resolved DB branch by deleting its Neon branch. Idempotent server-side. */
+      async releaseDbBranchLease(neonBranchId) {
         await this.request(
           "/api/sdk/replay/releaseDbBranchLease",
-          { leaseId },
+          { neonBranchId },
           { timeout: 3e4 }
         );
       }
@@ -612,11 +615,11 @@ async function processItem(httpClient, serverItem, fn, testRunId, mockStrategy,
   } finally {
     if (lease) {
       try {
-        await httpClient.releaseDbBranchLease(lease.leaseId);
+        await httpClient.releaseDbBranchLease(lease.neonBranchId);
       } catch (e) {
         try {
           console.warn(
-            `Bitfab: failed to release DB branch lease ${lease.leaseId} (TTL janitor will catch it): ${e instanceof Error ? e.message : String(e)}`
+            `Bitfab: failed to release DB branch ${lease.neonBranchId} (TTL janitor will catch it): ${e instanceof Error ? e.message : String(e)}`
           );
         } catch {
         }
@@ -663,8 +666,9 @@ async function replay(httpClient, serviceUrl, traceFunctionKey, fn, options) {
     options?.traceIds,
     options?.codeChangeDescription,
     options?.codeChangeFiles,
-    options?.environment !== void 0
+    options?.environment !== void 0,
     // includeDbBranchLease
+    options?.experimentGroupId
   );
   const mockStrategy = options?.mock ?? "none";
   const maxConcurrency = options?.maxConcurrency ?? 10;
@@ -1508,16 +1512,7 @@ init_constants();
 
 // src/dbSnapshot.ts
 init_errors();
-var SUPPORTED_PROVIDERS = [
-  "neon",
-  "ardent",
-  "dolt",
-  "gfs",
-  "mongodb-atlas",
-  "dynamodb",
-  "snowflake",
-  "bigquery"
-];
+var SUPPORTED_PROVIDERS = ["neon"];
 function validateDbSnapshotConfig(config) {
   if (!SUPPORTED_PROVIDERS.includes(config.provider)) {
     throw new BitfabError(
@@ -2044,14 +2039,6 @@ var ReplayEnvironment = class {
   get traceId() {
     return this.require().traceId;
   }
-  /**
-   * How the resolver pinned this branch.
-   * - "timestamp": snapshot at SDK wall clock; bounded by replication lag.
-   * - "lsn": customer LSN mapped to a replica snapshot (future).
-   */
-  get precision() {
-    return this.require().precision;
-  }
   /** True when read inside a replay item that has a resolved branch. */
   get active() {
     return this.read() !== null;
@@ -2075,8 +2062,7 @@ var ReplayEnvironment = class {
       expiresAt: lease.expiresAt,
       providerConsoleUrl: lease.providerConsoleUrl,
       readOnly: lease.readOnly,
-      traceId,
-      precision: lease.precision
+      traceId
     };
   }
   require() {
@@ -2928,7 +2914,6 @@ var Bitfab = class {
         try {
           const endedAt = (/* @__PURE__ */ new Date()).toISOString();
           const replayCtx = getReplayContext();
-          const dbSnapshotRefForSpan = isRootSpan ? activeTraceStates.get(traceId)?.dbSnapshotRef : void 0;
           const spanPromise = self.sendWrapperSpan({
             ...baseSpanParams,
             ...params,
@@ -2938,9 +2923,6 @@ var Bitfab = class {
             ...replayCtx?.testRunId && { testRunId: replayCtx.testRunId },
             ...replayCtx?.inputSourceSpanId && {
               inputSourceSpanId: replayCtx.inputSourceSpanId
-            },
-            ...dbSnapshotRefForSpan && {
-              dbSnapshotRef: dbSnapshotRefForSpan
             }
           });
           if (isRootSpan) {
@@ -3168,10 +3150,7 @@ var Bitfab = class {
         ...params.contexts && params.contexts.length > 0 && {
           contexts: params.contexts
         },
-        ...params.prompt !== void 0 && { prompt: params.prompt },
-        ...params.dbSnapshotRef && {
-          db_snapshot_ref: params.dbSnapshotRef
-        }
+        ...params.prompt !== void 0 && { prompt: params.prompt }
       }
     };
     if (params.parentSpanId) {