@newtalaria/browser 0.1.1 → 0.1.5

package/dist/replay/fit_segment.d.ts

@@ -0,0 +1,35 @@
+import { type RrwebEvent } from './segment_buffer.js';
+export type CompressEvents = (events: RrwebEvent[]) => Promise<Uint8Array>;
+/**
+ * Absolute error-clip wall: upload start + afterMs + flush slack.
+ * Callers must set this once; later errors must not recompute a later wall.
+ */
+export declare function computeErrorClipDeadlineMs(uploadStartedAtMs: number, afterMs: number, slackMs?: number): number;
+/** True when error-clip segment or compressed-byte budget is exhausted. */
+export declare function isErrorClipBudgetExhausted(opts: {
+    segmentIndex: number;
+    uploadedCompressedBytes: number;
+    maxSegments?: number;
+    maxBytes?: number;
+}): boolean;
+/**
+ * How to handle a segment rejected as oversized.
+ * Never re-queue an identical single-event payload (that loops forever).
+ */
+export declare function planOversizedRetry(events: RrwebEvent[]): {
+    action: 'drop';
+} | {
+    action: 'bisect';
+    left: RrwebEvent[];
+    right: RrwebEvent[];
+};
+/**
+ * Binary-search the largest prefix that gzips under the pack target.
+ * Remainder is returned for re-queue; null means every event was dropped.
+ */
+export declare function fitCompressedPrefix(events: RrwebEvent[], compress: CompressEvents, targetBytes?: number, hardCap?: number): Promise<{
+    events: RrwebEvent[];
+    gzip: Uint8Array;
+    remainder: RrwebEvent[];
+} | null>;
+//# sourceMappingURL=fit_segment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fit_segment.d.ts","sourceRoot":"","sources":["../../src/replay/fit_segment.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AAE3E;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,iBAAiB,EAAE,MAAM,EACzB,OAAO,EAAE,MAAM,EACf,OAAO,SAA4B,GAClC,MAAM,CAER;AAED,2EAA2E;AAC3E,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,uBAAuB,EAAE,MAAM,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAOV;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,UAAU,EAAE,GACnB;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,UAAU,EAAE,CAAC;IAAC,KAAK,EAAE,UAAU,EAAE,CAAA;CAAE,CAUpF;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,UAAU,EAAE,EACpB,QAAQ,EAAE,cAAc,EACxB,WAAW,SAAkC,EAC7C,OAAO,SAA+B,GACrC,OAAO,CAAC;IACT,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,UAAU,EAAE,CAAC;CACzB,GAAG,IAAI,CAAC,CAkCR"}

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

@@ -1 +1 @@
-{"version":3,"file":"privacy.d.ts","sourceRoot":"","sources":["../../src/replay/privacy.ts"],"names":[],"mappings":"AAEA,wEAAwE;AACxE,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAY7C;AAED,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAI3D"}
+{"version":3,"file":"privacy.d.ts","sourceRoot":"","sources":["../../src/replay/privacy.ts"],"names":[],"mappings":"AAEA,wEAAwE;AACxE,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAY7C;AAED,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAU3D"}

package/dist/replay/recorder.d.ts

@@ -1,11 +1,15 @@
 import type { RrwebEvent } from './segment_buffer.js';
 export interface RecorderOptions {
     maskAllInputs: boolean;
+    /** Embed accessible stylesheet rules into the snapshot. Default false at resolve time. */
+    inlineStylesheet: boolean;
     blockSelector?: string;
     onEvent: (event: RrwebEvent) => void;
 }
 export interface RecorderHandle {
     stop: () => void;
+    /** Force Meta + FullSnapshot so the next replay has a paint base. */
+    takeFullSnapshot: () => void;
 }
 export declare function startRecorder(options: RecorderOptions): RecorderHandle;
 //# sourceMappingURL=recorder.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../../src/replay/recorder.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAmBtE"}
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../../src/replay/recorder.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,OAAO,CAAC;IACvB,0FAA0F;IAC1F,gBAAgB,EAAE,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,qEAAqE;IACrE,gBAAgB,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CA0CtE"}

package/dist/replay/segment_buffer.d.ts

@@ -4,26 +4,76 @@ export interface RrwebEvent {
     data: unknown;
     timestamp: number;
 }
-/** Flush when uncompressed JSON is roughly this large. */
-export declare const SEGMENT_SIZE_BYTES = 100000;
+/**
+ * Soft uncompressed take size before gzip fitting.
+ * Keep in sync with ReplayLimits.maxUncompressedSegmentBytes intent.
+ */
+export declare const SEGMENT_SIZE_BYTES = 400000;
+/**
+ * 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). */
+export declare const TARGET_COMPRESSED_SEGMENT_BYTES: number;
+/**
+ * Absolute max segments per replay (session / long error mode).
+ * Keep in sync with ReplayLimits.maxSegmentsPerReplay.
+ */
+export declare const MAX_SEGMENTS_PER_REPLAY = 200;
+/**
+ * Error-clip mode: hard segment budget so one heavy page cannot spam ingest.
+ */
+export declare const MAX_SEGMENTS_ERROR_CLIP = 12;
+/** Error-clip mode: hard compressed-byte budget for the whole clip. */
+export declare const MAX_ERROR_CLIP_COMPRESSED_BYTES: number;
+/** Slack added to the error-clip wall for in-flight flush. */
+export declare const ERROR_CLIP_FLUSH_SLACK_MS = 5000;
 /** Periodic flush interval. */
 export declare const SEGMENT_FLUSH_MS = 5000;
 /** Keep ~60s of events while buffering (error-only sample path). */
 export declare const RING_BUFFER_MS = 60000;
-/** After an error-sample hit, keep uploading for this long, then finish. */
+/** Cap ring buffer size so one error flush stays bounded. */
+export declare const RING_BUFFER_MAX_BYTES = 1500000;
+/** Default post-error upload window (cheap error clip). */
 export declare const ERROR_REPLAY_AFTER_MS = 15000;
+/**
+ * Hard cap for continuous upload (session sample or error-continue mode).
+ * Keep in sync with ReplayLimits.defaultMaxDurationMs on the server.
+ */
+export declare const MAX_REPLAY_DURATION_MS: number;
+/** rrweb EventType.FullSnapshot */
+export declare const RRWEB_FULL_SNAPSHOT = 2;
+/** rrweb EventType.Meta */
+export declare const RRWEB_META = 4;
 export declare class SegmentBuffer {
     private events;
     private pendingBytes;
     get length(): number;
     get estimatedBytes(): number;
     push(event: RrwebEvent): void;
-    /** Drop events older than the ring window (buffer-only mode). */
-    trimRing(now?: number): void;
+    hasFullSnapshot(): boolean;
+    /**
+     * Drop leading events until Meta+FullSnapshot (or FullSnapshot alone).
+     * Returns false if no FullSnapshot is present (replay would paint blank).
+     */
+    trimToFullSnapshot(): boolean;
+    /**
+     * Drop events older than the ring window and/or over the byte cap
+     * (buffer-only mode). Prefer keeping the newest events.
+     */
+    trimRing(now?: number, maxBytes?: number): void;
     shouldFlushBySize(): boolean;
+    /**
+     * 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).
+     */
+    takeByEstimatedBytes(maxBytes: number): RrwebEvent[];
     takeAll(): RrwebEvent[];
-    /** Re-queue events at the front (failed upload retry). */
+    /** Re-queue events at the front (failed upload retry / bisect remainder). */
     prepend(events: RrwebEvent[]): void;
+    clear(): void;
     peekTimes(): {
         startedAt: Date;
         endedAt: Date;

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,0DAA0D;AAC1D,eAAO,MAAM,kBAAkB,SAAU,CAAC;AAC1C,+BAA+B;AAC/B,eAAO,MAAM,gBAAgB,OAAQ,CAAC;AACtC,oEAAoE;AACpE,eAAO,MAAM,cAAc,QAAS,CAAC;AACrC,4EAA4E;AAC5E,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAE5C,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,iEAAiE;IACjE,QAAQ,CAAC,GAAG,SAAa,GAAG,IAAI;IAYhC,iBAAiB,IAAI,OAAO;IAI5B,OAAO,IAAI,UAAU,EAAE;IAOvB,0DAA0D;IAC1D,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI;IAMnC,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,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"}