@newtalaria/browser 0.1.6 → 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/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;
@@ -13401,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) {
@@ -13422,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;
@@ -13583,6 +13613,7 @@
       this.uploadChain = Promise.resolve();
       this.closed = false;
       this.linkableReplayId = null;
+      this.lastReplayCaptureFailure = null;
     }
     onRrwebEvent(event) {
       if (this.closed || !this.options) return;
@@ -13608,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();
         }
       }
@@ -13625,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,
@@ -13645,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,
@@ -13790,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();
       }
@@ -13800,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() {
@@ -13860,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;
@@ -13900,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({
@@ -13925,6 +14045,9 @@
           });
           this.segmentIndex = index2 + 1;
           this.uploadedCompressedBytes += gzip.length;
+          if (index2 === 0) {
+            this.lastReplayCaptureFailure = null;
+          }
         } catch (error) {
           if (isTerminalReplayLimitError(error)) {
             console.warn(
@@ -13941,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);
@@ -13953,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;
@@ -13967,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);
@@ -13979,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);
       }