@newtalaria/browser 0.1.9 → 0.1.10

package/README.md

@@ -99,7 +99,7 @@ You pay for **uploaded + retained** bytes, not for local buffering. Prefer error
 | 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 FullSnapshot on segment 0 | **Abort** the clip (no blank orphan upload); error event gets `replay.capture=failed` + reason |
+| Oversized FullSnapshot on segment 0 | **Abort** the clip (no blank orphan upload); error event gets `replay.capture=failed` + reason. Meta+FullSnapshot are taken/fitted **atomically** so a soft estimated take window cannot orphan the snapshot. |
 | 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) |
 

package/dist/client.d.ts

@@ -1,5 +1,5 @@
 import type { CaptureContext, SeverityLevel, TalariaInitOptions } from './types.js';
-export { computeErrorClipDeadlineMs, fitCompressedPrefix, isErrorClipBudgetExhausted, planOversizedRetry, } from './replay/fit_segment.js';
+export { computeErrorClipDeadlineMs, fitCompressedPrefix, isErrorClipBudgetExhausted, paintBaseEventCount, 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';
@@ -89,8 +89,9 @@ 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 — except FullSnapshot on segment 0
-     * (abort the clip instead of uploading a blank orphan stream).
+     *
+     * Segment 0 keeps Meta+FullSnapshot (paint base) atomic through take + fit so
+     * a soft estimated-byte window cannot orphan the FullSnapshot.
      */
     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":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -204,15 +204,44 @@ var SegmentBuffer = class {
   shouldFlushBySize() {
     return this.pendingBytes >= SEGMENT_SIZE_BYTES;
   }
+  /**
+   * How many leading events form the rrweb paint base (Meta+FullSnapshot or
+   * FullSnapshot alone). Returns 0 if the buffer does not start with a paint base.
+   */
+  paintBaseLength() {
+    if (this.events.length === 0) return 0;
+    if (this.events[0].type === RRWEB_META && this.events[1]?.type === RRWEB_FULL_SNAPSHOT) {
+      return 2;
+    }
+    if (this.events[0].type === RRWEB_FULL_SNAPSHOT) {
+      return 1;
+    }
+    return 0;
+  }
   /**
    * Take a prefix of events whose estimated JSON size is ~maxBytes.
    * Always returns at least one event when the buffer is non-empty (caller
    * must handle a single oversized event).
+   *
+   * When `keepPaintBaseTogether` is true (segment 0), Meta immediately followed
+   * by FullSnapshot is taken as one unit even if estimated size exceeds
+   * maxBytes — gzip fitting / hard caps decide whether it can ship.
    */
-  takeByEstimatedBytes(maxBytes) {
+  takeByEstimatedBytes(maxBytes, opts) {
     if (this.events.length === 0) return [];
     const batch = [];
     let batchBytes = 0;
+    if (opts?.keepPaintBaseTogether) {
+      const paintLen = this.paintBaseLength();
+      if (paintLen > 0) {
+        for (let i = 0; i < paintLen; i++) {
+          const ev = this.events.shift();
+          batch.push(ev);
+          batchBytes += estimateJsonBytes(ev);
+        }
+        this.recomputeBytes();
+      }
+    }
     while (this.events.length > 0) {
       const next = this.events[0];
       const nextBytes = estimateJsonBytes(next);
@@ -337,8 +366,53 @@ function planOversizedRetry(events) {
     right: events.slice(mid)
   };
 }
-async function fitCompressedPrefix(events, compress, targetBytes = TARGET_COMPRESSED_SEGMENT_BYTES, hardCap = MAX_COMPRESSED_SEGMENT_BYTES) {
+function paintBaseEventCount(events) {
+  if (events.length === 0) return 0;
+  if (events[0].type === RRWEB_META && events[1]?.type === RRWEB_FULL_SNAPSHOT) {
+    return 2;
+  }
+  if (events[0].type === RRWEB_FULL_SNAPSHOT) {
+    return 1;
+  }
+  return 0;
+}
+async function fitCompressedPrefix(events, compress, targetBytes = TARGET_COMPRESSED_SEGMENT_BYTES, hardCap = MAX_COMPRESSED_SEGMENT_BYTES, opts) {
   if (events.length === 0) return null;
+  const atomicMin = opts?.atomicMinCount ?? 0;
+  if (atomicMin > 0) {
+    if (events.length < atomicMin) return null;
+    const paint = events.slice(0, atomicMin);
+    const paintGzip = await compress(paint);
+    if (paintGzip.length > hardCap) {
+      return null;
+    }
+    let lo = atomicMin;
+    let hi = events.length;
+    let best = {
+      events: paint,
+      gzip: paintGzip
+    };
+    while (lo <= hi) {
+      const mid = Math.floor((lo + hi) / 2);
+      if (mid < atomicMin) {
+        lo = atomicMin;
+        continue;
+      }
+      const prefix = events.slice(0, mid);
+      const gzip = await compress(prefix);
+      if (gzip.length <= targetBytes && gzip.length <= hardCap) {
+        best = { events: prefix, gzip };
+        lo = mid + 1;
+      } else {
+        hi = mid - 1;
+      }
+    }
+    return {
+      events: best.events,
+      gzip: best.gzip,
+      remainder: events.slice(best.events.length)
+    };
+  }
   let remaining = events;
   while (remaining.length > 0) {
     let lo = 1;
@@ -400,7 +474,7 @@ function paintBaseSizeDetails(events, opts) {
   const full = events.find((e) => e.type === RRWEB_FULL_SNAPSHOT);
   const details = {
     segmentEventTypes: events.map((e) => e.type),
-    maxUncompressedSegmentBytes: SEGMENT_SIZE_BYTES,
+    softTakeEstimatedBytes: SEGMENT_SIZE_BYTES,
     targetCompressedSegmentBytes: TARGET_COMPRESSED_SEGMENT_BYTES,
     maxCompressedSegmentBytes: MAX_COMPRESSED_SEGMENT_BYTES
   };
@@ -14053,20 +14127,9 @@ var TalariaClient = class {
       }
       const { events, gzip } = fitted;
       if (this.segmentIndex === 0 && !events.some((e) => e.type === RRWEB_FULL_SNAPSHOT)) {
-        const leftoverFs = this.buffer.peekFullSnapshot();
-        let compressedBytes;
-        if (leftoverFs) {
-          try {
-            compressedBytes = (await compressReplayEvents([leftoverFs])).length;
-          } catch {
-          }
-        }
         await this.abortUnusableClip(
           "no_full_snapshot",
-          paintBaseSizeDetails(
-            leftoverFs ? [...events, leftoverFs] : events,
-            { fullSnapshotCompressedBytes: compressedBytes }
-          )
+          paintBaseSizeDetails(events)
         );
         return;
       }
@@ -14111,6 +14174,14 @@ var TalariaClient = class {
           break;
         }
         if (isOversizedSegmentError(error)) {
+          if (this.segmentIndex === 0 && paintBaseEventCount(events) > 0) {
+            await this.abortUnusableClip("oversized_full_snapshot", {
+              source: "server_reject_paint_base",
+              ...paintBaseSizeDetails(events),
+              rejectedCompressedBytes: gzip.length
+            });
+            return;
+          }
           const plan = planOversizedRetry(events);
           if (plan.action === "drop") {
             const droppedType = events[0]?.type;
@@ -14118,7 +14189,7 @@ var TalariaClient = class {
               "@newtalaria/browser: dropping rrweb event rejected as oversized",
               { type: droppedType }
             );
-            if (this.segmentIndex === 0 && droppedType === RRWEB_FULL_SNAPSHOT) {
+            if (droppedType === RRWEB_FULL_SNAPSHOT) {
               await this.abortUnusableClip(
                 "oversized_full_snapshot",
                 {
@@ -14156,68 +14227,60 @@ var TalariaClient = class {
   }
   /**
    * Pull the largest event prefix that gzips under the target compressed size.
-   * Drops a single event that can never fit — except FullSnapshot on segment 0
-   * (abort the clip instead of uploading a blank orphan stream).
+   *
+   * Segment 0 keeps Meta+FullSnapshot (paint base) atomic through take + fit so
+   * a soft estimated-byte window cannot orphan the FullSnapshot.
    */
   async takeFittedSegment() {
-    const chunk = this.buffer.takeByEstimatedBytes(SEGMENT_SIZE_BYTES);
+    const isPaintBaseSegment = this.segmentIndex === 0;
+    const chunk = this.buffer.takeByEstimatedBytes(SEGMENT_SIZE_BYTES, {
+      keepPaintBaseTogether: isPaintBaseSegment
+    });
     if (chunk.length === 0) return null;
+    const atomicMin = isPaintBaseSegment ? paintBaseEventCount(chunk) : 0;
     const fitted = await fitCompressedPrefix(
       chunk,
       compressReplayEvents,
       TARGET_COMPRESSED_SEGMENT_BYTES,
-      MAX_COMPRESSED_SEGMENT_BYTES
+      MAX_COMPRESSED_SEGMENT_BYTES,
+      atomicMin > 0 ? { atomicMinCount: atomicMin } : void 0
     );
     if (!fitted) {
-      const dropped = chunk[0];
-      console.warn(
-        "@newtalaria/browser: dropping rrweb event that exceeds max segment size",
-        { type: dropped?.type }
-      );
-      if (this.segmentIndex === 0 && dropped?.type === RRWEB_FULL_SNAPSHOT) {
+      if (isPaintBaseSegment && atomicMin > 0) {
+        const paint = chunk.slice(0, atomicMin);
         let compressedBytes;
-        try {
-          compressedBytes = (await compressReplayEvents([dropped])).length;
-        } catch {
+        const full = paint.find((e) => e.type === RRWEB_FULL_SNAPSHOT);
+        if (full) {
+          try {
+            compressedBytes = (await compressReplayEvents([full])).length;
+          } catch {
+          }
+        }
+        if (chunk.length > atomicMin) {
+          this.buffer.prepend(chunk.slice(atomicMin));
         }
         return {
           events: [],
           gzip: new Uint8Array(),
           abortReason: "oversized_full_snapshot",
           abortDetails: {
-            source: "fit_compressed_prefix",
-            ...paintBaseSizeDetails(chunk, {
+            source: "paint_base_exceeds_hard_cap",
+            ...paintBaseSizeDetails(paint, {
               fullSnapshotCompressedBytes: compressedBytes
             })
           }
         };
       }
+      const dropped = chunk[0];
+      console.warn(
+        "@newtalaria/browser: dropping rrweb event that exceeds max segment size",
+        { type: dropped?.type }
+      );
       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)) {
-      const full = chunk.find((e) => e.type === RRWEB_FULL_SNAPSHOT);
-      let compressedBytes;
-      if (full) {
-        try {
-          compressedBytes = (await compressReplayEvents([full])).length;
-        } catch {
-        }
-      }
-      return {
-        events: [],
-        gzip: new Uint8Array(),
-        abortReason: "oversized_full_snapshot",
-        abortDetails: {
-          source: "fit_dropped_full_snapshot",
-          ...paintBaseSizeDetails(chunk, {
-            fullSnapshotCompressedBytes: compressedBytes
-          })
-        }
-      };
-    }
     if (fitted.remainder.length > 0) {
       this.buffer.prepend(fitted.remainder);
     }