@bitfab/sdk 0.36.0 → 0.36.1

package/dist/index.d.cts

@@ -266,9 +266,11 @@ interface ReplayContext {
      * obtains `databaseUrl` for this item. Reported on the trace completion inside
      * `db_snapshot_usage` so the server can distinguish "branch was
      * provisioned and exposed" from "branch URL was actually consumed".
-     * Any future consumption path that hands the URL to customer code by
-     * other means (e.g. a process-isolated runner writing an env overlay)
-     * must also set this.
+     * Only an explicit `databaseUrl` read may set it. A path that hands the URL
+     * over by other means (e.g. a process-isolated runner writing an env
+     * overlay) must leave it alone: setting it there would make every such
+     * replay report `accessed` for free, and the flag would stop separating
+     * "branch was used" from "branch was offered".
      */
     dbSnapshotAccessed?: boolean;
 }
@@ -1393,10 +1395,20 @@ interface ReplayResult<T> {
  * exposed directly here so customer code never sees the word.
  */
 
-declare class ReplayBranch {
+declare class ReplayBranch implements Omit<DbBranchLease, "databaseUrl"> {
     #private;
+    /** The provider's own id for this branch, e.g. for correlating with its console. */
+    readonly neonBranchId: string;
+    /** Env var name the customer's app reads, e.g. `DATABASE_URL`. */
+    readonly envKey: string;
     /** When this branch's URL stops being valid. ISO-8601. */
     readonly expiresAt: string;
+    /**
+     * The instant this branch is pinned to: the source trace's wall clock, read
+     * just before the traced function ran. Compare it against the trace you meant
+     * to replay to confirm the branch is the right point in history.
+     */
+    readonly snapshotTimestamp?: string;
     /** Deep link to the branch in the provider console, if available. */
     readonly providerConsoleUrl?: string;
     /**
@@ -2336,7 +2348,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.36.0";
+declare const __version__ = "0.36.1";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.d.ts

@@ -266,9 +266,11 @@ interface ReplayContext {
      * obtains `databaseUrl` for this item. Reported on the trace completion inside
      * `db_snapshot_usage` so the server can distinguish "branch was
      * provisioned and exposed" from "branch URL was actually consumed".
-     * Any future consumption path that hands the URL to customer code by
-     * other means (e.g. a process-isolated runner writing an env overlay)
-     * must also set this.
+     * Only an explicit `databaseUrl` read may set it. A path that hands the URL
+     * over by other means (e.g. a process-isolated runner writing an env
+     * overlay) must leave it alone: setting it there would make every such
+     * replay report `accessed` for free, and the flag would stop separating
+     * "branch was used" from "branch was offered".
      */
     dbSnapshotAccessed?: boolean;
 }
@@ -1393,10 +1395,20 @@ interface ReplayResult<T> {
  * exposed directly here so customer code never sees the word.
  */
 
-declare class ReplayBranch {
+declare class ReplayBranch implements Omit<DbBranchLease, "databaseUrl"> {
     #private;
+    /** The provider's own id for this branch, e.g. for correlating with its console. */
+    readonly neonBranchId: string;
+    /** Env var name the customer's app reads, e.g. `DATABASE_URL`. */
+    readonly envKey: string;
     /** When this branch's URL stops being valid. ISO-8601. */
     readonly expiresAt: string;
+    /**
+     * The instant this branch is pinned to: the source trace's wall clock, read
+     * just before the traced function ran. Compare it against the trace you meant
+     * to replay to confirm the branch is the right point in history.
+     */
+    readonly snapshotTimestamp?: string;
     /** Deep link to the branch in the provider console, if available. */
     readonly providerConsoleUrl?: string;
     /**
@@ -2336,7 +2348,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.36.0";
+declare const __version__ = "0.36.1";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.js

@@ -11,7 +11,7 @@ import {
   getCurrentReplayBranch,
   getCurrentSpan,
   getCurrentTrace
-} from "./chunk-JECWMVJG.js";
+} from "./chunk-HD4DRDRE.js";
 import {
   BITFAB_PROGRESS_PREFIX,
   BitfabError,
@@ -20,7 +20,7 @@ import {
   __version__,
   flushTraces,
   reportReplayProgress
-} from "./chunk-4YTIVUYX.js";
+} from "./chunk-6ZBZBR5K.js";
 export {
   BITFAB_PROGRESS_PREFIX,
   Bitfab,

package/dist/node.cjs

@@ -88,7 +88,7 @@ var __version__;
 var init_version_generated = __esm({
   "src/version.generated.ts"() {
     "use strict";
-    __version__ = "0.36.0";
+    __version__ = "0.36.1";
   }
 });
 
@@ -4195,12 +4195,20 @@ var ReplayBranch = class {
     // context can ride along into a log line or a serialized payload.
     __privateAdd(this, _url);
     __privateAdd(this, _context);
-    this.expiresAt = lease.expiresAt;
-    this.providerConsoleUrl = lease.providerConsoleUrl;
-    this.readOnly = lease.readOnly;
-    this.region = lease.region;
-    this.traceId = traceId;
-    __privateSet(this, _url, lease.databaseUrl);
+    const { databaseUrl, ...exposed } = lease;
+    for (const [key, value] of Object.entries(exposed)) {
+      Object.defineProperty(this, key, {
+        value,
+        enumerable: true,
+        configurable: true
+      });
+    }
+    Object.defineProperty(this, "traceId", {
+      value: traceId,
+      enumerable: true,
+      configurable: true
+    });
+    __privateSet(this, _url, databaseUrl);
     __privateSet(this, _context, context);
   }
   /**
@@ -5540,6 +5548,7 @@ var Bitfab = class {
                   dbSnapshotUsage: {
                     neonBranchId: replayCtx.dbBranchLease.neonBranchId,
                     snapshotTimestamp: replayCtx.dbBranchLease.snapshotTimestamp,
+                    region: replayCtx.dbBranchLease.region,
                     originalTraceId: replayCtx.sourceBitfabTraceId,
                     accessed: replayCtx.dbSnapshotAccessed === true
                   }
@@ -5815,6 +5824,9 @@ var Bitfab = class {
         ...params.dbSnapshotUsage.snapshotTimestamp && {
           snapshot_timestamp: params.dbSnapshotUsage.snapshotTimestamp
         },
+        ...params.dbSnapshotUsage.region && {
+          region: params.dbSnapshotUsage.region
+        },
         ...params.dbSnapshotUsage.originalTraceId && {
           original_trace_id: params.dbSnapshotUsage.originalTraceId,
           // Deprecated wire alias, kept so this SDK still reports usage