@newtalaria/browser 0.1.5 → 0.1.7

package/dist/replay/capture_outcome.d.ts

@@ -0,0 +1,18 @@
+/** Durable tags on error events when an error-clip replay was attempted. */
+export declare const REPLAY_CAPTURE_TAG = "replay.capture";
+export declare const REPLAY_CAPTURE_REASON_TAG = "replay.capture_reason";
+export type ReplayCaptureStatus = 'ok' | 'failed' | 'skipped';
+export type ReplayCaptureReason = 'oversized_full_snapshot' | 'no_full_snapshot' | 'upload_failed' | 'not_sampled' | 'buffer_empty';
+export interface ReplayCaptureFailure {
+    reason: ReplayCaptureReason;
+    details?: Record<string, unknown>;
+}
+export interface ReplayCaptureOutcome {
+    status: ReplayCaptureStatus;
+    reason?: ReplayCaptureReason;
+    details?: Record<string, unknown>;
+}
+/** Merge replay capture tags into event tags (error-clip path only). */
+export declare function applyReplayCaptureTags(tags: Record<string, string>, outcome: ReplayCaptureOutcome | null): Record<string, string>;
+export declare function mergeReplayCaptureExtra(extra: Record<string, unknown> | undefined, outcome: ReplayCaptureOutcome | null): Record<string, unknown> | undefined;
+//# sourceMappingURL=capture_outcome.d.ts.map

package/dist/replay/capture_outcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture_outcome.d.ts","sourceRoot":"","sources":["../../src/replay/capture_outcome.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AACnD,eAAO,MAAM,yBAAyB,0BAA0B,CAAC;AAEjE,MAAM,MAAM,mBAAmB,GAAG,IAAI,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE9D,MAAM,MAAM,mBAAmB,GAC3B,yBAAyB,GACzB,kBAAkB,GAClB,eAAe,GACf,aAAa,GACb,cAAc,CAAC;AAEnB,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,wEAAwE;AACxE,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,OAAO,EAAE,oBAAoB,GAAG,IAAI,GACnC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQxB;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC1C,OAAO,EAAE,oBAAoB,GAAG,IAAI,GACnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAarC"}

package/dist/replay/hooks.d.ts

@@ -1,6 +1,39 @@
+import type { FailedRequestStatusCode } from '../types.js';
 export type Teardown = () => void;
+export interface NetworkMeta {
+    method: string;
+    url: string;
+    status?: number;
+    durationMs?: number;
+    ok?: boolean;
+}
+export interface NetworkHookOptions {
+    /** Still emit rrweb breadcrumbs for all requests. */
+    onNetwork?: (meta: NetworkMeta) => void;
+    /**
+     * Called when a completed request should become a Talaria event.
+     * Network transport errors (no status) are not promoted here — they rethrow as usual.
+     */
+    onFailedRequest?: (meta: NetworkMeta & {
+        status: number;
+    }) => void;
+    captureFailedRequests?: boolean;
+    failedRequestStatusCodes?: FailedRequestStatusCode[];
+    failedRequestIgnoreUrls?: string[];
+    /** SDK base URL — requests under this host + /events|/replays are never promoted. */
+    talariaBaseUrl?: string;
+}
 /** Mirror console output into rrweb as `talaria-console` custom events. */
 export declare function installConsoleHook(): Teardown;
-/** Capture fetch / XHR metadata only (no bodies, no auth headers). */
-export declare function installNetworkHook(): Teardown;
+export declare function statusMatches(status: number, codes: FailedRequestStatusCode[]): boolean;
+export declare function shouldPromoteFailedRequest(meta: NetworkMeta, opts: {
+    captureFailedRequests: boolean;
+    failedRequestStatusCodes: FailedRequestStatusCode[];
+    failedRequestIgnoreUrls: string[];
+    talariaBaseUrl?: string;
+}): meta is NetworkMeta & {
+    status: number;
+};
+/** Capture fetch / XHR metadata (no bodies, no auth headers); optionally promote failures. */
+export declare function installNetworkHook(options?: NetworkHookOptions): Teardown;
 //# sourceMappingURL=hooks.d.ts.map

package/dist/replay/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/replay/hooks.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC;AAiBlC,2EAA2E;AAC3E,wBAAgB,kBAAkB,IAAI,QAAQ,CA2B7C;AAsBD,sEAAsE;AACtE,wBAAgB,kBAAkB,IAAI,QAAQ,CAgF7C"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/replay/hooks.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAE3D,MAAM,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC;AAElC,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,EAAE,CAAC,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,qDAAqD;IACrD,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;IACxC;;;OAGG;IACH,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,GAAG;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACnE,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,wBAAwB,CAAC,EAAE,uBAAuB,EAAE,CAAC;IACrD,uBAAuB,CAAC,EAAE,MAAM,EAAE,CAAC;IACnC,qFAAqF;IACrF,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAiBD,2EAA2E;AAC3E,wBAAgB,kBAAkB,IAAI,QAAQ,CA2B7C;AAcD,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,uBAAuB,EAAE,GAC/B,OAAO,CAUT;AAED,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE;IACJ,qBAAqB,EAAE,OAAO,CAAC;IAC/B,wBAAwB,EAAE,uBAAuB,EAAE,CAAC;IACpD,uBAAuB,EAAE,MAAM,EAAE,CAAC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GACA,IAAI,IAAI,WAAW,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAoB1C;AAED,8FAA8F;AAC9F,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,kBAAuB,GAAG,QAAQ,CA+F7E"}

package/dist/replay/segment_buffer.d.ts

@@ -8,13 +8,13 @@ export interface RrwebEvent {
  * Soft uncompressed take size before gzip fitting.
  * Keep in sync with ReplayLimits.maxUncompressedSegmentBytes intent.
  */
-export declare const SEGMENT_SIZE_BYTES = 400000;
+export declare const SEGMENT_SIZE_BYTES = 800000;
 /**
  * Server hard cap — keep in sync with ReplayLimits.maxCompressedSegmentBytes.
  * Restart Serverpod after changing this constant pair.
  */
 export declare const MAX_COMPRESSED_SEGMENT_BYTES: number;
-/** Pack under hard cap minus margin (never disagree with a live 512KiB server). */
+/** Pack under hard cap minus margin (never disagree with a live 1MiB server). */
 export declare const TARGET_COMPRESSED_SEGMENT_BYTES: number;
 /**
  * Absolute max segments per replay (session / long error mode).

package/dist/replay/segment_buffer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"segment_buffer.d.ts","sourceRoot":"","sources":["../../src/replay/segment_buffer.ts"],"names":[],"mappings":"AAEA,oDAAoD;AACpD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,SAAU,CAAC;AAC1C;;;GAGG;AACH,eAAO,MAAM,4BAA4B,QAAa,CAAC;AACvD,mFAAmF;AACnF,eAAO,MAAM,+BAA+B,QACF,CAAC;AAC3C;;;GAGG;AACH,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C;;GAEG;AACH,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,uEAAuE;AACvE,eAAO,MAAM,+BAA+B,QAAkB,CAAC;AAC/D,8DAA8D;AAC9D,eAAO,MAAM,yBAAyB,OAAQ,CAAC;AAC/C,+BAA+B;AAC/B,eAAO,MAAM,gBAAgB,OAAQ,CAAC;AACtC,oEAAoE;AACpE,eAAO,MAAM,cAAc,QAAS,CAAC;AACrC,6DAA6D;AAC7D,eAAO,MAAM,qBAAqB,UAAY,CAAC;AAC/C,2DAA2D;AAC3D,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAC5C;;;GAGG;AACH,eAAO,MAAM,sBAAsB,QAAgB,CAAC;AAEpD,mCAAmC;AACnC,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,2BAA2B;AAC3B,eAAO,MAAM,UAAU,IAAI,CAAC;AAE5B,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,YAAY,CAAK;IAEzB,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAK7B,eAAe,IAAI,OAAO;IAI1B;;;OAGG;IACH,kBAAkB,IAAI,OAAO;IAc7B;;;OAGG;IACH,QAAQ,CAAC,GAAG,SAAa,EAAE,QAAQ,SAAwB,GAAG,IAAI;IAiBlE,iBAAiB,IAAI,OAAO;IAI5B;;;;OAIG;IACH,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,EAAE;IAyBpD,OAAO,IAAI,UAAU,EAAE;IAOvB,6EAA6E;IAC7E,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI;IAMnC,KAAK,IAAI,IAAI;IAKb,SAAS,IAAI;QAAE,SAAS,EAAE,IAAI,CAAC;QAAC,OAAO,EAAE,IAAI,CAAA;KAAE,GAAG,IAAI;IAUtD,OAAO,CAAC,cAAc;CAGvB"}
+{"version":3,"file":"segment_buffer.d.ts","sourceRoot":"","sources":["../../src/replay/segment_buffer.ts"],"names":[],"mappings":"AAEA,oDAAoD;AACpD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,SAAU,CAAC;AAC1C;;;GAGG;AACH,eAAO,MAAM,4BAA4B,QAAc,CAAC;AACxD,iFAAiF;AACjF,eAAO,MAAM,+BAA+B,QACF,CAAC;AAC3C;;;GAGG;AACH,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C;;GAEG;AACH,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,uEAAuE;AACvE,eAAO,MAAM,+BAA+B,QAAkB,CAAC;AAC/D,8DAA8D;AAC9D,eAAO,MAAM,yBAAyB,OAAQ,CAAC;AAC/C,+BAA+B;AAC/B,eAAO,MAAM,gBAAgB,OAAQ,CAAC;AACtC,oEAAoE;AACpE,eAAO,MAAM,cAAc,QAAS,CAAC;AACrC,6DAA6D;AAC7D,eAAO,MAAM,qBAAqB,UAAY,CAAC;AAC/C,2DAA2D;AAC3D,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAC5C;;;GAGG;AACH,eAAO,MAAM,sBAAsB,QAAgB,CAAC;AAEpD,mCAAmC;AACnC,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,2BAA2B;AAC3B,eAAO,MAAM,UAAU,IAAI,CAAC;AAE5B,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,YAAY,CAAK;IAEzB,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAK7B,eAAe,IAAI,OAAO;IAI1B;;;OAGG;IACH,kBAAkB,IAAI,OAAO;IAc7B;;;OAGG;IACH,QAAQ,CAAC,GAAG,SAAa,EAAE,QAAQ,SAAwB,GAAG,IAAI;IAiBlE,iBAAiB,IAAI,OAAO;IAI5B;;;;OAIG;IACH,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,EAAE;IAyBpD,OAAO,IAAI,UAAU,EAAE;IAOvB,6EAA6E;IAC7E,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI;IAMnC,KAAK,IAAI,IAAI;IAKb,SAAS,IAAI;QAAE,SAAS,EAAE,IAAI,CAAC;QAAC,OAAO,EAAE,IAAI,CAAA;KAAE,GAAG,IAAI;IAUtD,OAAO,CAAC,cAAc;CAGvB"}

package/dist/talaria.browser.iife.js

@@ -123,9 +123,9 @@
   }
 
   // src/replay/segment_buffer.ts
-  var SEGMENT_SIZE_BYTES = 4e5;
-  var MAX_COMPRESSED_SEGMENT_BYTES = 512 * 1024;
-  var TARGET_COMPRESSED_SEGMENT_BYTES = MAX_COMPRESSED_SEGMENT_BYTES - 32 * 1024;
+  var SEGMENT_SIZE_BYTES = 8e5;
+  var MAX_COMPRESSED_SEGMENT_BYTES = 1024 * 1024;
+  var TARGET_COMPRESSED_SEGMENT_BYTES = MAX_COMPRESSED_SEGMENT_BYTES - 64 * 1024;
   var MAX_SEGMENTS_PER_REPLAY = 200;
   var MAX_SEGMENTS_ERROR_CLIP = 12;
   var MAX_ERROR_CLIP_COMPRESSED_BYTES = 2 * 1024 * 1024;
@@ -357,6 +357,33 @@
     return null;
   }
 
+  // src/replay/capture_outcome.ts
+  var REPLAY_CAPTURE_TAG = "replay.capture";
+  var REPLAY_CAPTURE_REASON_TAG = "replay.capture_reason";
+  function applyReplayCaptureTags(tags, outcome) {
+    if (!outcome) return tags;
+    const next = { ...tags };
+    next[REPLAY_CAPTURE_TAG] = outcome.status;
+    if (outcome.reason) {
+      next[REPLAY_CAPTURE_REASON_TAG] = outcome.reason;
+    }
+    return next;
+  }
+  function mergeReplayCaptureExtra(extra, outcome) {
+    if (!outcome || outcome.status === "ok") {
+      return extra;
+    }
+    return {
+      ...extra ?? {},
+      replayCapture: {
+        attempted: outcome.status === "failed",
+        status: outcome.status,
+        reason: outcome.reason,
+        ...outcome.details ?? {}
+      }
+    };
+  }
+
   // ../../node_modules/rrweb/dist/rrweb.js
   var __defProp = Object.defineProperty;
   var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
@@ -13216,11 +13243,52 @@
     } catch {
     }
   }
-  function installNetworkHook() {
+  function statusMatches(status, codes) {
+    for (const entry of codes) {
+      if (typeof entry === "number") {
+        if (status === entry) return true;
+      } else if (Array.isArray(entry) && entry.length >= 2) {
+        const [min, max] = entry;
+        if (status >= min && status <= max) return true;
+      }
+    }
+    return false;
+  }
+  function shouldPromoteFailedRequest(meta, opts) {
+    if (!opts.captureFailedRequests) return false;
+    if (typeof meta.status !== "number" || Number.isNaN(meta.status)) return false;
+    if (!statusMatches(meta.status, opts.failedRequestStatusCodes)) return false;
+    const url = meta.url || "";
+    const ignore = [...opts.failedRequestIgnoreUrls];
+    const base = (opts.talariaBaseUrl ?? "").replace(/\/+$/, "");
+    if (base) {
+      ignore.push(`${base}/events/`, `${base}/replays/`);
+    }
+    ignore.push("/events/ingest", "/events/ingestBatch", "/replays/");
+    const lower = url.toLowerCase();
+    for (const part of ignore) {
+      if (part && lower.includes(part.toLowerCase())) return false;
+    }
+    return true;
+  }
+  function installNetworkHook(options = {}) {
     const originalFetch = typeof fetch === "function" ? fetch.bind(globalThis) : null;
     const XHR = typeof XMLHttpRequest !== "undefined" ? XMLHttpRequest : null;
     const originalOpen = XHR?.prototype.open;
     const originalSend = XHR?.prototype.send;
+    const matchOpts = {
+      captureFailedRequests: options.captureFailedRequests ?? true,
+      failedRequestStatusCodes: options.failedRequestStatusCodes ?? [[500, 599]],
+      failedRequestIgnoreUrls: options.failedRequestIgnoreUrls ?? [],
+      talariaBaseUrl: options.talariaBaseUrl
+    };
+    const handleMeta = (meta) => {
+      emitNetwork(meta);
+      options.onNetwork?.(meta);
+      if (shouldPromoteFailedRequest(meta, matchOpts)) {
+        options.onFailedRequest?.(meta);
+      }
+    };
     if (originalFetch) {
       globalThis.fetch = async (input2, init) => {
         const started = Date.now();
@@ -13228,7 +13296,7 @@
         const url = typeof input2 === "string" ? input2 : input2 instanceof URL ? input2.toString() : input2.url;
         try {
           const response = await originalFetch(input2, init);
-          emitNetwork({
+          handleMeta({
             method,
             url,
             status: response.status,
@@ -13237,7 +13305,7 @@
           });
           return response;
         } catch (error) {
-          emitNetwork({
+          handleMeta({
             method,
             url,
             durationMs: Date.now() - started,
@@ -13256,7 +13324,7 @@
       XHR.prototype.send = function(body) {
         this.__talariaStarted = Date.now();
         const onDone = () => {
-          emitNetwork({
+          handleMeta({
             method: this.__talariaMethod ?? "GET",
             url: this.__talariaUrl ?? "",
             status: this.status,
@@ -13300,7 +13368,10 @@
       blockSelector: options.blockSelector ?? "",
       userId: options.userId,
       tags: options.tags,
-      disableDefaultIntegrations: options.disableDefaultIntegrations ?? false
+      disableDefaultIntegrations: options.disableDefaultIntegrations ?? false,
+      captureFailedRequests: options.captureFailedRequests ?? true,
+      failedRequestStatusCodes: options.failedRequestStatusCodes ?? [[500, 599]],
+      failedRequestIgnoreUrls: options.failedRequestIgnoreUrls ?? []
     };
   }
   function clamp01(n2) {
@@ -13357,6 +13428,8 @@
        * attach it to the error event after budget/timer finish resets buffer mode.
        */
       this.linkableReplayId = null;
+      /** Last error-clip paint/upload failure (cleared on successful segment 0). */
+      this.lastReplayCaptureFailure = null;
     }
     init(options) {
       if (this.options) {
@@ -13378,6 +13451,7 @@
       this.uploadStartedAtMs = null;
       this.errorClipDeadlineMs = null;
       this.linkableReplayId = null;
+      this.lastReplayCaptureFailure = null;
       this.buffer = new SegmentBuffer();
       this.uploadChain = Promise.resolve();
       this.sessionSampled = Math.random() < this.options.replaysSessionSampleRate;
@@ -13388,7 +13462,35 @@
         blockSelector: this.options.blockSelector,
         onEvent: (event) => this.onRrwebEvent(event)
       });
-      this.teardowns.push(installConsoleHook(), installNetworkHook());
+      this.teardowns.push(
+        installConsoleHook(),
+        installNetworkHook({
+          captureFailedRequests: this.options.captureFailedRequests,
+          failedRequestStatusCodes: this.options.failedRequestStatusCodes,
+          failedRequestIgnoreUrls: this.options.failedRequestIgnoreUrls,
+          talariaBaseUrl: this.options.baseUrl,
+          onFailedRequest: (meta) => {
+            const status = meta.status;
+            const method = meta.method || "GET";
+            const url = meta.url || "(unknown url)";
+            void this.captureMessage(
+              `HTTP ${status}: ${method} ${url}`,
+              status >= 500 ? "error" : "warning",
+              {
+                tags: {
+                  "http.status_code": String(status),
+                  "http.method": method
+                },
+                extra: {
+                  url,
+                  durationMs: meta.durationMs,
+                  ok: meta.ok
+                }
+              }
+            );
+          }
+        })
+      );
       if (!this.options.disableDefaultIntegrations) {
         this.installGlobalHandlers();
       }
@@ -13511,6 +13613,7 @@
       this.uploadChain = Promise.resolve();
       this.closed = false;
       this.linkableReplayId = null;
+      this.lastReplayCaptureFailure = null;
     }
     onRrwebEvent(event) {
       if (this.closed || !this.options) return;
@@ -13536,15 +13639,22 @@
         throw new Error("@newtalaria/browser: call Talaria.init() first");
       }
       const isErrorLike = args.level === "error" || args.level === "fatal";
+      let errorClipOutcome = null;
+      let attemptedErrorClip = false;
       if (isErrorLike && !this.sessionSampled) {
         if (!this.uploadEnabled) {
           if (Math.random() < this.options.replaysOnErrorSampleRate) {
+            attemptedErrorClip = true;
+            this.lastReplayCaptureFailure = null;
             this.uploadEnabled = true;
             this.checkoutFullSnapshot();
             this.markUploadStarted();
             this.scheduleErrorClipEnd();
+          } else {
+            errorClipOutcome = { status: "skipped", reason: "not_sampled" };
           }
         } else {
+          attemptedErrorClip = true;
           this.scheduleErrorClipEnd();
         }
       }
@@ -13553,15 +13663,49 @@
           await this.flush({ reason: "capture", keepalive: args.keepalive });
         } catch (error) {
           console.warn("@newtalaria/browser: replay flush failed", error);
-          throw error;
+          this.lastReplayCaptureFailure = {
+            reason: "upload_failed",
+            details: {
+              message: error instanceof Error ? error.message : String(error)
+            }
+          };
+          if (!this.sessionSampled && this.segmentIndex === 0) {
+            await this.abortUnusableClip("upload_failed", {
+              message: error instanceof Error ? error.message : String(error)
+            });
+          }
         }
       }
-      const tags = {
-        ...this.options.tags ?? {},
-        ...args.context?.tags ?? {}
-      };
-      const extra = args.context?.extra;
-      const replayId = this.uploadEnabled && this.segmentIndex > 0 ? this.replayId : this.linkableReplayId;
+      let replayId = this.uploadEnabled && this.segmentIndex > 0 ? this.replayId : this.linkableReplayId;
+      if (this.lastReplayCaptureFailure && this.segmentIndex === 0) {
+        replayId = null;
+      }
+      if (isErrorLike && !this.sessionSampled) {
+        if (replayId) {
+          errorClipOutcome = { status: "ok" };
+          this.lastReplayCaptureFailure = null;
+        } else if (errorClipOutcome?.status === "skipped") {
+        } else if (this.lastReplayCaptureFailure) {
+          errorClipOutcome = {
+            status: "failed",
+            reason: this.lastReplayCaptureFailure.reason,
+            details: this.lastReplayCaptureFailure.details
+          };
+        } else if (attemptedErrorClip) {
+          errorClipOutcome = { status: "failed", reason: "buffer_empty" };
+        }
+      }
+      const tags = applyReplayCaptureTags(
+        {
+          ...this.options.tags ?? {},
+          ...args.context?.tags ?? {}
+        },
+        errorClipOutcome
+      );
+      const extra = mergeReplayCaptureExtra(
+        args.context?.extra,
+        errorClipOutcome
+      );
       try {
         await ingestEvent(this.transport, {
           message: args.message,
@@ -13573,7 +13717,7 @@
           release: this.options.release,
           userId: args.context?.userId ?? this.options.userId,
           sessionId: this.sessionId ?? void 0,
-          replayId,
+          replayId: replayId ?? void 0,
           url: typeof location !== "undefined" ? location.href : void 0,
           tags: Object.keys(tags).length ? tags : void 0,
           extraJson: extra ? JSON.stringify(extra) : void 0,
@@ -13718,9 +13862,10 @@
     /**
      * Ensure segment 0 begins at Meta+FullSnapshot. Orphan increments alone
      * produce a blank rrweb player.
+     * @returns false when no FullSnapshot is available.
      */
     prepareBufferForNewReplay() {
-      if (this.segmentIndex !== 0) return;
+      if (this.segmentIndex !== 0) return true;
       if (!this.buffer.hasFullSnapshot()) {
         this.checkoutFullSnapshot();
       }
@@ -13728,6 +13873,40 @@
         console.warn(
           "@newtalaria/browser: replay has no FullSnapshot; player may show a blank screen"
         );
+        return false;
+      }
+      return true;
+    }
+    /**
+     * Stop an error clip that cannot paint (missing/oversized FullSnapshot).
+     * Does not set linkableReplayId — the error event should not open a blank player.
+     */
+    async abortUnusableClip(reason, details) {
+      this.lastReplayCaptureFailure = { reason, details };
+      console.warn("@newtalaria/browser: aborting unusable replay clip", {
+        reason,
+        ...details
+      });
+      this.buffer.clear();
+      this.linkableReplayId = null;
+      if (this.startedOnServer && !this.finishedOnServer && this.transport && this.replayId) {
+        try {
+          await finishReplay(this.transport, {
+            replayId: this.replayId,
+            reason: `capture_failed:${reason}`,
+            keepalive: false
+          });
+          this.finishedOnServer = true;
+        } catch (error) {
+          console.warn("@newtalaria/browser: replays/finish failed after abort", error);
+        }
+      }
+      if (!this.sessionSampled) {
+        this.resetToBufferMode();
+      } else {
+        this.uploadEnabled = false;
+        this.clearErrorClipTimer();
+        this.clearMaxDurationTimer();
       }
     }
     stopUploadingAfterLimit() {
@@ -13788,7 +13967,10 @@
     async uploadPendingSegments(opts) {
       if (!this.options || !this.transport || !this.replayId) return;
       if (!this.startedOnServer || this.finishedOnServer) return;
-      this.prepareBufferForNewReplay();
+      if (!this.prepareBufferForNewReplay()) {
+        await this.abortUnusableClip("no_full_snapshot");
+        return;
+      }
       while (this.buffer.length > 0) {
         if (this.isPastMaxDuration()) {
           break;
@@ -13828,7 +14010,17 @@
         }
         const fitted = await this.takeFittedSegment();
         if (!fitted) break;
+        if (fitted.abortReason) {
+          await this.abortUnusableClip(fitted.abortReason, fitted.abortDetails);
+          return;
+        }
         const { events, gzip } = fitted;
+        if (this.segmentIndex === 0 && !events.some((e) => e.type === RRWEB_FULL_SNAPSHOT)) {
+          await this.abortUnusableClip("no_full_snapshot", {
+            segmentEventTypes: events.map((e) => e.type)
+          });
+          return;
+        }
         if (this.isErrorClipMode() && this.uploadedCompressedBytes + gzip.length > MAX_ERROR_CLIP_COMPRESSED_BYTES && this.segmentIndex > 0) {
           this.buffer.clear();
           await this.finishOnServer({
@@ -13853,6 +14045,9 @@
           });
           this.segmentIndex = index2 + 1;
           this.uploadedCompressedBytes += gzip.length;
+          if (index2 === 0) {
+            this.lastReplayCaptureFailure = null;
+          }
         } catch (error) {
           if (isTerminalReplayLimitError(error)) {
             console.warn(
@@ -13869,10 +14064,17 @@
           if (isOversizedSegmentError(error)) {
             const plan = planOversizedRetry(events);
             if (plan.action === "drop") {
+              const droppedType = events[0]?.type;
               console.warn(
                 "@newtalaria/browser: dropping rrweb event rejected as oversized",
-                { type: events[0]?.type }
+                { type: droppedType }
               );
+              if (this.segmentIndex === 0 && droppedType === RRWEB_FULL_SNAPSHOT) {
+                await this.abortUnusableClip("oversized_full_snapshot", {
+                  source: "server_reject"
+                });
+                return;
+              }
               continue;
             }
             this.buffer.prepend(plan.right);
@@ -13881,6 +14083,11 @@
           }
           this.buffer.prepend(events);
           console.warn("@newtalaria/browser: replays/ingestSegment failed", error);
+          if (this.segmentIndex === 0) {
+            await this.abortUnusableClip("upload_failed", {
+              message: error instanceof Error ? error.message : String(error)
+            });
+          }
           break;
         }
         if (opts.keepalive) break;
@@ -13895,7 +14102,8 @@
     }
     /**
      * Pull the largest event prefix that gzips under the target compressed size.
-     * Drops a single event that can never fit.
+     * Drops a single event that can never fit — except FullSnapshot on segment 0
+     * (abort the clip instead of uploading a blank orphan stream).
      */
     async takeFittedSegment() {
       const chunk = this.buffer.takeByEstimatedBytes(SEGMENT_SIZE_BYTES);
@@ -13907,12 +14115,32 @@
         MAX_COMPRESSED_SEGMENT_BYTES
       );
       if (!fitted) {
+        const dropped = chunk[0];
         console.warn(
           "@newtalaria/browser: dropping rrweb event that exceeds max segment size",
-          { type: chunk[0]?.type }
+          { type: dropped?.type }
         );
+        if (this.segmentIndex === 0 && dropped?.type === RRWEB_FULL_SNAPSHOT) {
+          return {
+            events: [],
+            gzip: new Uint8Array(),
+            abortReason: "oversized_full_snapshot",
+            abortDetails: { source: "fit_compressed_prefix" }
+          };
+        }
+        if (chunk.length > 1) {
+          this.buffer.prepend(chunk.slice(1));
+        }
         return this.takeFittedSegment();
       }
+      if (this.segmentIndex === 0 && chunk.some((e) => e.type === RRWEB_FULL_SNAPSHOT) && !fitted.events.some((e) => e.type === RRWEB_FULL_SNAPSHOT)) {
+        return {
+          events: [],
+          gzip: new Uint8Array(),
+          abortReason: "oversized_full_snapshot",
+          abortDetails: { source: "fit_dropped_full_snapshot" }
+        };
+      }
       if (fitted.remainder.length > 0) {
         this.buffer.prepend(fitted.remainder);
       }