@newtalaria/browser 0.1.0 → 0.1.1

package/README.md

@@ -29,7 +29,7 @@ Talaria.init({
   release: '1.0.0',
   // Continuous session upload (0–1). Default 0 = buffer only until an error.
   replaysSessionSampleRate: 0,
-  // On error, flush buffer + attach replayId (0–1). Default 1.
+  // On error, upload ~60s before + ~15s after (0–1). Default 1.
   replaysOnErrorSampleRate: 1,
   maskAllInputs: true, // default
 });
@@ -95,9 +95,10 @@ Segment payloads are a **gzip-compressed JSON array** of rrweb events.
 
 | Mode | Behavior |
 | --- | --- |
-| Session sample hit | `replays/start` immediately; segments upload every ~5s or ~100KB |
+| Session sample hit | `replays/start` immediately; segments upload every ~5s or ~100KB until unload |
 | Session sample miss | Record into a ~60s ring buffer; nothing uploaded until an error sample hits |
-| Error sample hit | Enable upload, flush buffer, send event with `replayId` |
+| Error sample hit | Upload the ring buffer + ~15s after the error, attach `replayId`, then `finish` and return to buffer-only mode |
+| Server limit (segments / size / duration) | Stop uploading that replay; no retries |
 | `pagehide` / `close` | Flush pending segments with `fetch` `keepalive`, then `replays/finish` |
 
 Custom rrweb events:

package/dist/client.d.ts

@@ -6,11 +6,14 @@ export declare class TalariaClient {
     private sessionId;
     private recorder;
     private buffer;
+    /** Continuous upload for the whole page session (session sample hit). */
+    private sessionSampled;
     private uploadEnabled;
     private startedOnServer;
     private finishedOnServer;
     private segmentIndex;
     private flushTimer;
+    private errorClipTimer;
     private uploadChain;
     private closed;
     private teardowns;
@@ -26,6 +29,13 @@ export declare class TalariaClient {
     close(): Promise<void>;
     private onRrwebEvent;
     private capture;
+    private scheduleErrorClipEnd;
+    private clearErrorClipTimer;
+    /** Flush trailing post-error window, finish replay, return to ring buffer. */
+    private endErrorClip;
+    /** After an error clip (or terminal limit), buffer locally until the next error. */
+    private resetToBufferMode;
+    private stopUploadingAfterLimit;
     private installGlobalHandlers;
     private enqueueUpload;
     private ensureStarted;

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;AA6DpB,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,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,WAAW,CAAoC;IACvD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAkB;IAEnC,IAAI,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IA0DvC,WAAW,IAAI,MAAM,GAAG,IAAI;IAItB,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;IAmBX,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAyB5B,OAAO,CAAC,YAAY;YAcN,OAAO;IA4DrB,OAAO,CAAC,qBAAqB;IA6B7B,OAAO,CAAC,aAAa;YAKP,aAAa;YAiBb,qBAAqB;YAqCrB,cAAc;CAkB7B"}
+{"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;AAyEpB,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,UAAU,CAA+C;IACjE,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,WAAW,CAAoC;IACvD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAkB;IAEnC,IAAI,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IA0DvC,WAAW,IAAI,MAAM,GAAG,IAAI;IAItB,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;IA8BX,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA0B5B,OAAO,CAAC,YAAY;YAcN,OAAO;IAkErB,OAAO,CAAC,oBAAoB;IAS5B,OAAO,CAAC,mBAAmB;IAO3B,8EAA8E;YAChE,YAAY;IAoB1B,oFAAoF;IACpF,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,uBAAuB;IAc/B,OAAO,CAAC,qBAAqB;IA6B7B,OAAO,CAAC,aAAa;YAKP,aAAa;YAiBb,qBAAqB;YAkDrB,cAAc;CAkB7B"}

package/dist/index.d.ts

@@ -9,6 +9,7 @@ import type { CaptureContext, SeverityLevel, TalariaInitOptions } from './types.
  *   dsn: 'http://localhost:8080',
  *   apiKey: 'tal_live_…',
  *   environment: 'development',
+ *   // Error clip: ~60s before + ~15s after (not full-session upload).
  *   replaysOnErrorSampleRate: 1,
  * });
  *

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;;;;;;;;;;;;;;;;;;;GAmBG;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,YAAY,EACV,cAAc,EACd,WAAW,EACX,aAAa,EACb,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,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;;;;;;;;;;;;;;;;;;;;GAoBG;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,YAAY,EACV,cAAc,EACd,WAAW,EACX,aAAa,EACb,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,eAAe,OAAO,CAAC"}

package/dist/index.js

@@ -164,6 +164,7 @@ function estimateJsonBytes(value) {
 var SEGMENT_SIZE_BYTES = 1e5;
 var SEGMENT_FLUSH_MS = 5e3;
 var RING_BUFFER_MS = 6e4;
+var ERROR_REPLAY_AFTER_MS = 15e3;
 var SegmentBuffer = class {
   constructor() {
     this.events = [];
@@ -13145,6 +13146,10 @@ function levelToEventType(level) {
   if (level === "debug") return "debug";
   return "info";
 }
+function isTerminalReplayLimitError(error) {
+  const msg = error instanceof Error ? error.message : String(error);
+  return msg.includes("replay exceeds max segment count") || msg.includes("replay exceeds max total size") || msg.includes("replay exceeds max duration") || msg.includes("Replay has expired");
+}
 var TalariaClient = class {
   constructor() {
     this.options = null;
@@ -13153,11 +13158,14 @@ var TalariaClient = class {
     this.sessionId = null;
     this.recorder = null;
     this.buffer = new SegmentBuffer();
+    /** Continuous upload for the whole page session (session sample hit). */
+    this.sessionSampled = false;
     this.uploadEnabled = false;
     this.startedOnServer = false;
     this.finishedOnServer = false;
     this.segmentIndex = 0;
     this.flushTimer = null;
+    this.errorClipTimer = null;
     this.uploadChain = Promise.resolve();
     this.closed = false;
     this.teardowns = [];
@@ -13179,8 +13187,8 @@ var TalariaClient = class {
     this.startedOnServer = false;
     this.segmentIndex = 0;
     this.buffer = new SegmentBuffer();
-    const sessionSampled = Math.random() < this.options.replaysSessionSampleRate;
-    this.uploadEnabled = sessionSampled;
+    this.sessionSampled = Math.random() < this.options.replaysSessionSampleRate;
+    this.uploadEnabled = this.sessionSampled;
     this.recorder = startRecorder({
       maskAllInputs: this.options.maskAllInputs,
       blockSelector: this.options.blockSelector,
@@ -13239,16 +13247,26 @@ var TalariaClient = class {
       return;
     }
     await this.enqueueUpload(async () => {
+      if (!this.uploadEnabled || this.closed) return;
       await this.ensureStarted({ keepalive });
       await this.uploadPendingSegments({ keepalive });
-      if (opts?.finish) {
-        await this.finishOnServer({ keepalive, reason: opts.reason ?? "pagehide" });
+      if (opts?.finish && this.uploadEnabled) {
+        await this.finishOnServer({
+          keepalive,
+          reason: opts.reason ?? "pagehide"
+        });
+        if (!this.sessionSampled) {
+          this.resetToBufferMode();
+        } else {
+          this.uploadEnabled = false;
+        }
       }
     });
   }
   async close() {
     if (this.closed) return;
     this.closed = true;
+    this.clearErrorClipTimer();
     if (this.flushTimer) {
       clearInterval(this.flushTimer);
       this.flushTimer = null;
@@ -13281,9 +13299,14 @@ var TalariaClient = class {
       throw new Error("@newtalaria/browser: call Talaria.init() first");
     }
     const isErrorLike = args.level === "error" || args.level === "fatal";
-    if (isErrorLike && !this.uploadEnabled) {
-      if (Math.random() < this.options.replaysOnErrorSampleRate) {
-        this.uploadEnabled = true;
+    if (isErrorLike && !this.sessionSampled) {
+      if (!this.uploadEnabled) {
+        if (Math.random() < this.options.replaysOnErrorSampleRate) {
+          this.uploadEnabled = true;
+          this.scheduleErrorClipEnd();
+        }
+      } else {
+        this.scheduleErrorClipEnd();
       }
     }
     const attachReplay = this.uploadEnabled;
@@ -13321,6 +13344,55 @@ var TalariaClient = class {
       throw error;
     }
   }
+  scheduleErrorClipEnd() {
+    if (this.sessionSampled || this.closed) return;
+    this.clearErrorClipTimer();
+    this.errorClipTimer = setTimeout(() => {
+      this.errorClipTimer = null;
+      void this.endErrorClip();
+    }, ERROR_REPLAY_AFTER_MS);
+  }
+  clearErrorClipTimer() {
+    if (this.errorClipTimer) {
+      clearTimeout(this.errorClipTimer);
+      this.errorClipTimer = null;
+    }
+  }
+  /** Flush trailing post-error window, finish replay, return to ring buffer. */
+  async endErrorClip() {
+    if (this.closed || this.sessionSampled || !this.uploadEnabled || !this.options || !this.transport) {
+      return;
+    }
+    await this.enqueueUpload(async () => {
+      if (!this.uploadEnabled || this.sessionSampled) return;
+      await this.ensureStarted({ keepalive: false });
+      await this.uploadPendingSegments({ keepalive: false });
+      await this.finishOnServer({ keepalive: false, reason: "error_clip" });
+      this.resetToBufferMode();
+    });
+  }
+  /** After an error clip (or terminal limit), buffer locally until the next error. */
+  resetToBufferMode() {
+    this.clearErrorClipTimer();
+    this.uploadEnabled = false;
+    this.startedOnServer = false;
+    this.finishedOnServer = false;
+    this.segmentIndex = 0;
+    this.replayId = createId();
+    this.buffer.trimRing();
+  }
+  stopUploadingAfterLimit() {
+    this.clearErrorClipTimer();
+    this.uploadEnabled = false;
+    if (this.sessionSampled) {
+      if (this.flushTimer) {
+        clearInterval(this.flushTimer);
+        this.flushTimer = null;
+      }
+    } else {
+      this.resetToBufferMode();
+    }
+  }
   installGlobalHandlers() {
     if (typeof window === "undefined") return;
     const onError = (event) => {
@@ -13382,6 +13454,18 @@ var TalariaClient = class {
         });
         this.segmentIndex = index2 + 1;
       } catch (error) {
+        if (isTerminalReplayLimitError(error)) {
+          console.warn(
+            "@newtalaria/browser: replay upload stopped (server limit)",
+            error
+          );
+          await this.finishOnServer({
+            keepalive: opts.keepalive,
+            reason: "limit"
+          });
+          this.stopUploadingAfterLimit();
+          break;
+        }
         this.buffer.prepend(events);
         console.warn("@newtalaria/browser: replays/ingestSegment failed", error);
         break;