@newtalaria/browser 0.1.6 → 0.1.7

package/README.md

@@ -96,12 +96,24 @@ You pay for **uploaded + retained** bytes, not for local buffering. Prefer error
 | --- | --- |
 | Session sample hit | `replays/start` immediately; segments upload every ~5s or ~100KB until unload or **5 min** max |
 | Session sample miss | Record into a ~60s ring buffer; nothing uploaded until an error sample hits |
-| Error sample + `replaysErrorAfterMs > 0` | Upload buffer (≤480KiB gzip pack target / 512KiB server cap) + trailing window, hard caps **12 segments** or **2MiB** compressed, attach `replayId` only if segments landed, `finish`, return to buffer mode |
+| Error sample + `replaysErrorAfterMs > 0` | Upload buffer (≤~960KiB gzip pack target / **1MiB** server cap) + trailing window, hard caps **12 segments** or **2MiB** compressed, attach `replayId` only if segments landed, `finish`, return to buffer mode |
 | Error sample + `replaysErrorAfterMs = 0` | Upload buffer then continue like session mode until **5 min** / unload / size caps |
 | Server limit (replay segments / total size / duration) | Stop uploading that replay; no retries |
-| Oversized single rrweb event | Dropped with a console warning (cannot fit under segment cap) |
+| Oversized FullSnapshot on segment 0 | **Abort** the clip (no blank orphan upload); error event gets `replay.capture=failed` + reason |
+| Oversized single non-FS rrweb event | Dropped with a console warning (cannot fit under segment cap) |
 | `pagehide` / `close` | Flush pending segments with `fetch` `keepalive`, then `replays/finish`; `close` fully resets so `init()` works again (React Strict Mode) |
 
+### Replay capture outcome tags
+
+When an **error/fatal** event attempts an on-error clip (`replaysSessionSampleRate` miss), the SDK may attach:
+
+| Tag | Values |
+| --- | --- |
+| `replay.capture` | `ok` \| `failed` \| `skipped` |
+| `replay.capture_reason` | `oversized_full_snapshot` \| `no_full_snapshot` \| `upload_failed` \| `not_sampled` \| `buffer_empty` |
+
+Failed captures do **not** set `replayId` (avoids linking a blank player). Details are also under `extra.replayCapture`.
+
 ## Serverpod URL pattern
 
 Talaria uses **Serverpod RPC**, not REST resource URLs:

package/dist/client.d.ts

@@ -1,6 +1,8 @@
 import type { CaptureContext, SeverityLevel, TalariaInitOptions } from './types.js';
 export { computeErrorClipDeadlineMs, fitCompressedPrefix, isErrorClipBudgetExhausted, planOversizedRetry, } from './replay/fit_segment.js';
 export { MAX_SEGMENTS_ERROR_CLIP, MAX_ERROR_CLIP_COMPRESSED_BYTES, TARGET_COMPRESSED_SEGMENT_BYTES, MAX_COMPRESSED_SEGMENT_BYTES, } from './replay/segment_buffer.js';
+export { REPLAY_CAPTURE_TAG, REPLAY_CAPTURE_REASON_TAG, applyReplayCaptureTags, mergeReplayCaptureExtra, } from './replay/capture_outcome.js';
+export type { ReplayCaptureOutcome, ReplayCaptureReason, ReplayCaptureStatus, } from './replay/capture_outcome.js';
 export declare class TalariaClient {
     private options;
     private transport;
@@ -30,6 +32,8 @@ export declare class TalariaClient {
      * attach it to the error event after budget/timer finish resets buffer mode.
      */
     private linkableReplayId;
+    /** Last error-clip paint/upload failure (cleared on successful segment 0). */
+    private lastReplayCaptureFailure;
     init(options: TalariaInitOptions): void;
     getReplayId(): string | null;
     captureException(error: unknown, context?: CaptureContext): Promise<void>;
@@ -69,8 +73,14 @@ export declare class TalariaClient {
     /**
      * Ensure segment 0 begins at Meta+FullSnapshot. Orphan increments alone
      * produce a blank rrweb player.
+     * @returns false when no FullSnapshot is available.
      */
     private prepareBufferForNewReplay;
+    /**
+     * Stop an error clip that cannot paint (missing/oversized FullSnapshot).
+     * Does not set linkableReplayId — the error event should not open a blank player.
+     */
+    private abortUnusableClip;
     private stopUploadingAfterLimit;
     private installGlobalHandlers;
     private enqueueUpload;
@@ -79,7 +89,8 @@ export declare class TalariaClient {
     private maxSegmentsAllowed;
     /**
      * 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).
      */
     private takeFittedSegment;
     private finishOnServer;

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAEd,aAAa,EACb,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAoCpB,OAAO,EACL,0BAA0B,EAC1B,mBAAmB,EACnB,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,uBAAuB,EACvB,+BAA+B,EAC/B,+BAA+B,EAC/B,4BAA4B,GAC7B,MAAM,4BAA4B,CAAC;AA4EpC,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,MAAM,CAAuB;IACrC,yEAAyE;IACzE,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,uBAAuB,CAAK;IACpC,0EAA0E;IAC1E,OAAO,CAAC,iBAAiB,CAAuB;IAChD,4EAA4E;IAC5E,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,gBAAgB,CAA8C;IACtE,OAAO,CAAC,WAAW,CAAoC;IACvD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAkB;IACnC;;;OAGG;IACH,OAAO,CAAC,gBAAgB,CAAuB;IAE/C,IAAI,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IA6FvC,WAAW,IAAI,MAAM,GAAG,IAAI;IAKtB,gBAAgB,CACpB,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;IAcV,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,aAAsB,EAC7B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;IASV,KAAK,CAAC,IAAI,CAAC,EAAE;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,GAAG,OAAO,CAAC,IAAI,CAAC;IA0CjB;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmD5B,OAAO,CAAC,YAAY;YAwBN,OAAO;IA+ErB,OAAO,CAAC,iBAAiB;IAkBzB,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,uBAAuB;IAK/B,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,uBAAuB;IAiB/B,OAAO,CAAC,qBAAqB;YAOf,qBAAqB;IAsBnC;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAmB5B,OAAO,CAAC,mBAAmB;IAO3B,8EAA8E;YAChE,YAAY;YAgBZ,eAAe;IAW7B,oFAAoF;IACpF,OAAO,CAAC,iBAAiB;IAiBzB,+EAA+E;IAC/E,OAAO,CAAC,oBAAoB;IAI5B;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IAYjC,OAAO,CAAC,uBAAuB;IAc/B,OAAO,CAAC,qBAAqB;IA6B7B,OAAO,CAAC,aAAa;YAKP,aAAa;YAkBb,qBAAqB;IA8HnC,OAAO,CAAC,kBAAkB;IAQ1B;;;OAGG;YACW,iBAAiB;YA2BjB,cAAc;CAuB7B"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -33,5 +33,7 @@ export { TalariaClient } from './client.js';
 export { computeErrorClipDeadlineMs, fitCompressedPrefix, isErrorClipBudgetExhausted, planOversizedRetry, } from './replay/fit_segment.js';
 export { MAX_SEGMENTS_ERROR_CLIP, MAX_ERROR_CLIP_COMPRESSED_BYTES, TARGET_COMPRESSED_SEGMENT_BYTES, MAX_COMPRESSED_SEGMENT_BYTES, } from './replay/segment_buffer.js';
 export type { CaptureContext, Environment, FailedRequestStatusCode, SeverityLevel, TalariaInitOptions, } from './types.js';
+export { REPLAY_CAPTURE_TAG, REPLAY_CAPTURE_REASON_TAG, } from './replay/capture_outcome.js';
+export type { ReplayCaptureOutcome, ReplayCaptureReason, ReplayCaptureStatus, } from './replay/capture_outcome.js';
 export default Talaria;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAIpB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,OAAO;kBACJ,kBAAkB,GAAG,IAAI;4BAIf,OAAO,YAAY,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;4BAK9D,MAAM,UACP,aAAa,YACX,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;mBAID,MAAM,GAAG,IAAI;aAInB,OAAO,CAAC,IAAI,CAAC;aAIb,OAAO,CAAC,IAAI,CAAC;CAGvB,CAAC;AAEF,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EACL,0BAA0B,EAC1B,mBAAmB,EACnB,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,uBAAuB,EACvB,+BAA+B,EAC/B,+BAA+B,EAC/B,4BAA4B,GAC7B,MAAM,4BAA4B,CAAC;AAEpC,YAAY,EACV,cAAc,EACd,WAAW,EACX,uBAAuB,EACvB,aAAa,EACb,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,eAAe,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAIpB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,OAAO;kBACJ,kBAAkB,GAAG,IAAI;4BAIf,OAAO,YAAY,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;4BAK9D,MAAM,UACP,aAAa,YACX,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;mBAID,MAAM,GAAG,IAAI;aAInB,OAAO,CAAC,IAAI,CAAC;aAIb,OAAO,CAAC,IAAI,CAAC;CAGvB,CAAC;AAEF,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EACL,0BAA0B,EAC1B,mBAAmB,EACnB,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,uBAAuB,EACvB,+BAA+B,EAC/B,+BAA+B,EAC/B,4BAA4B,GAC7B,MAAM,4BAA4B,CAAC;AAEpC,YAAY,EACV,cAAc,EACd,WAAW,EACX,uBAAuB,EACvB,aAAa,EACb,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,6BAA6B,CAAC;AAErC,eAAe,OAAO,CAAC"}

package/dist/index.js

@@ -121,9 +121,9 @@ function estimateJsonBytes(value) {
 }
 
 // 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;
@@ -355,6 +355,33 @@ async function fitCompressedPrefix(events, compress, targetBytes = TARGET_COMPRE
   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;
@@ -13399,6 +13426,8 @@ var TalariaClient = class {
      * 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) {
@@ -13420,6 +13449,7 @@ var TalariaClient = class {
     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;
@@ -13581,6 +13611,7 @@ var TalariaClient = class {
     this.uploadChain = Promise.resolve();
     this.closed = false;
     this.linkableReplayId = null;
+    this.lastReplayCaptureFailure = null;
   }
   onRrwebEvent(event) {
     if (this.closed || !this.options) return;
@@ -13606,15 +13637,22 @@ var TalariaClient = class {
       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();
       }
     }
@@ -13623,15 +13661,49 @@ var TalariaClient = class {
         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,
@@ -13643,7 +13715,7 @@ var TalariaClient = class {
         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,
@@ -13788,9 +13860,10 @@ var TalariaClient = class {
   /**
    * 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();
     }
@@ -13798,6 +13871,40 @@ var TalariaClient = class {
       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() {
@@ -13858,7 +13965,10 @@ var TalariaClient = class {
   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;
@@ -13898,7 +14008,17 @@ var TalariaClient = class {
       }
       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({
@@ -13923,6 +14043,9 @@ var TalariaClient = class {
         });
         this.segmentIndex = index2 + 1;
         this.uploadedCompressedBytes += gzip.length;
+        if (index2 === 0) {
+          this.lastReplayCaptureFailure = null;
+        }
       } catch (error) {
         if (isTerminalReplayLimitError(error)) {
           console.warn(
@@ -13939,10 +14062,17 @@ var TalariaClient = class {
         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);
@@ -13951,6 +14081,11 @@ var TalariaClient = class {
         }
         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;
@@ -13965,7 +14100,8 @@ var TalariaClient = class {
   }
   /**
    * 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);
@@ -13977,12 +14113,32 @@ var TalariaClient = class {
       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);
     }
@@ -14034,6 +14190,8 @@ export {
   MAX_COMPRESSED_SEGMENT_BYTES,
   MAX_ERROR_CLIP_COMPRESSED_BYTES,
   MAX_SEGMENTS_ERROR_CLIP,
+  REPLAY_CAPTURE_REASON_TAG,
+  REPLAY_CAPTURE_TAG,
   TARGET_COMPRESSED_SEGMENT_BYTES,
   Talaria,
   TalariaClient,