@newtalaria/browser 0.1.5 → 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:
@@ -157,6 +169,26 @@ By default `inlineStylesheet` is `false`: linked stylesheets stay as `href`s and
 
 Set `inlineStylesheet: true` so same-origin stylesheet rules are embedded while the user is logged in. Cross-origin sheets without CORS still cannot be inlined (browser `cssRules` restriction).
 
+### Failed HTTP requests → events
+
+By default, completed `fetch` / XHR responses with status **500–599** are also sent as Talaria events (message like `HTTP 500: GET /api/...`). Replay still gets `talaria-network` breadcrumbs for all requests.
+
+```ts
+Talaria.init({
+  dsn: 'https://api.example.com',
+  apiKey: 'tal_live_…',
+  environment: 'production',
+  // Default true
+  captureFailedRequests: true,
+  // Default [[500, 599]]. CMS admin often wants 4xx too:
+  failedRequestStatusCodes: [[400, 599]],
+  // Extra URL substrings to skip (Talaria /events and /replays are always skipped)
+  failedRequestIgnoreUrls: ['/health'],
+});
+```
+
+Transport errors (network down, no status) are not promoted as HTTP events; uncaught exceptions from failed fetches still go through normal `error` / `unhandledrejection` handlers when the app rethrows.
+
 ## Public API
 
 | API | Description |

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;AAyEpC,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;IAiEvC,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":"AAAA,OAAO,KAAK,EACV,cAAc,EAEd,aAAa,EACb,kBAAkB,EACnB,MAAM,YAAY,CAAC;AA4CpB,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;AACpC,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,6BAA6B,CAAC;AA4ErC,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;IAC/C,8EAA8E;IAC9E,OAAO,CAAC,wBAAwB,CAAqC;IAErE,IAAI,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IA8FvC,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;IAoD5B,OAAO,CAAC,YAAY;YAwBN,OAAO;IA4HrB,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;;;;OAIG;IACH,OAAO,CAAC,yBAAyB;IAcjC;;;OAGG;YACW,iBAAiB;IAkC/B,OAAO,CAAC,uBAAuB;IAc/B,OAAO,CAAC,qBAAqB;IA6B7B,OAAO,CAAC,aAAa;YAKP,aAAa;YAkBb,qBAAqB;IAkKnC,OAAO,CAAC,kBAAkB;IAQ1B;;;;OAIG;YACW,iBAAiB;YA2DjB,cAAc;CAuB7B"}

package/dist/index.d.ts

@@ -32,6 +32,8 @@ export declare const Talaria: {
 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, SeverityLevel, TalariaInitOptions, } from './types.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,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;
@@ -13214,11 +13241,52 @@ function emitNetwork(meta) {
   } catch {
   }
 }
-function installNetworkHook() {
+function statusMatches(status, codes) {
+  for (const entry of codes) {
+    if (typeof entry === "number") {
+      if (status === entry) return true;
+    } else if (Array.isArray(entry) && entry.length >= 2) {
+      const [min, max] = entry;
+      if (status >= min && status <= max) return true;
+    }
+  }
+  return false;
+}
+function shouldPromoteFailedRequest(meta, opts) {
+  if (!opts.captureFailedRequests) return false;
+  if (typeof meta.status !== "number" || Number.isNaN(meta.status)) return false;
+  if (!statusMatches(meta.status, opts.failedRequestStatusCodes)) return false;
+  const url = meta.url || "";
+  const ignore = [...opts.failedRequestIgnoreUrls];
+  const base = (opts.talariaBaseUrl ?? "").replace(/\/+$/, "");
+  if (base) {
+    ignore.push(`${base}/events/`, `${base}/replays/`);
+  }
+  ignore.push("/events/ingest", "/events/ingestBatch", "/replays/");
+  const lower = url.toLowerCase();
+  for (const part of ignore) {
+    if (part && lower.includes(part.toLowerCase())) return false;
+  }
+  return true;
+}
+function installNetworkHook(options = {}) {
   const originalFetch = typeof fetch === "function" ? fetch.bind(globalThis) : null;
   const XHR = typeof XMLHttpRequest !== "undefined" ? XMLHttpRequest : null;
   const originalOpen = XHR?.prototype.open;
   const originalSend = XHR?.prototype.send;
+  const matchOpts = {
+    captureFailedRequests: options.captureFailedRequests ?? true,
+    failedRequestStatusCodes: options.failedRequestStatusCodes ?? [[500, 599]],
+    failedRequestIgnoreUrls: options.failedRequestIgnoreUrls ?? [],
+    talariaBaseUrl: options.talariaBaseUrl
+  };
+  const handleMeta = (meta) => {
+    emitNetwork(meta);
+    options.onNetwork?.(meta);
+    if (shouldPromoteFailedRequest(meta, matchOpts)) {
+      options.onFailedRequest?.(meta);
+    }
+  };
   if (originalFetch) {
     globalThis.fetch = async (input2, init) => {
       const started = Date.now();
@@ -13226,7 +13294,7 @@ function installNetworkHook() {
       const url = typeof input2 === "string" ? input2 : input2 instanceof URL ? input2.toString() : input2.url;
       try {
         const response = await originalFetch(input2, init);
-        emitNetwork({
+        handleMeta({
           method,
           url,
           status: response.status,
@@ -13235,7 +13303,7 @@ function installNetworkHook() {
         });
         return response;
       } catch (error) {
-        emitNetwork({
+        handleMeta({
           method,
           url,
           durationMs: Date.now() - started,
@@ -13254,7 +13322,7 @@ function installNetworkHook() {
     XHR.prototype.send = function(body) {
       this.__talariaStarted = Date.now();
       const onDone = () => {
-        emitNetwork({
+        handleMeta({
           method: this.__talariaMethod ?? "GET",
           url: this.__talariaUrl ?? "",
           status: this.status,
@@ -13298,7 +13366,10 @@ function resolveOptions(options) {
     blockSelector: options.blockSelector ?? "",
     userId: options.userId,
     tags: options.tags,
-    disableDefaultIntegrations: options.disableDefaultIntegrations ?? false
+    disableDefaultIntegrations: options.disableDefaultIntegrations ?? false,
+    captureFailedRequests: options.captureFailedRequests ?? true,
+    failedRequestStatusCodes: options.failedRequestStatusCodes ?? [[500, 599]],
+    failedRequestIgnoreUrls: options.failedRequestIgnoreUrls ?? []
   };
 }
 function clamp01(n2) {
@@ -13355,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) {
@@ -13376,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;
@@ -13386,7 +13460,35 @@ var TalariaClient = class {
       blockSelector: this.options.blockSelector,
       onEvent: (event) => this.onRrwebEvent(event)
     });
-    this.teardowns.push(installConsoleHook(), installNetworkHook());
+    this.teardowns.push(
+      installConsoleHook(),
+      installNetworkHook({
+        captureFailedRequests: this.options.captureFailedRequests,
+        failedRequestStatusCodes: this.options.failedRequestStatusCodes,
+        failedRequestIgnoreUrls: this.options.failedRequestIgnoreUrls,
+        talariaBaseUrl: this.options.baseUrl,
+        onFailedRequest: (meta) => {
+          const status = meta.status;
+          const method = meta.method || "GET";
+          const url = meta.url || "(unknown url)";
+          void this.captureMessage(
+            `HTTP ${status}: ${method} ${url}`,
+            status >= 500 ? "error" : "warning",
+            {
+              tags: {
+                "http.status_code": String(status),
+                "http.method": method
+              },
+              extra: {
+                url,
+                durationMs: meta.durationMs,
+                ok: meta.ok
+              }
+            }
+          );
+        }
+      })
+    );
     if (!this.options.disableDefaultIntegrations) {
       this.installGlobalHandlers();
     }
@@ -13509,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;
@@ -13534,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();
       }
     }
@@ -13551,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,
@@ -13571,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,
@@ -13716,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();
     }
@@ -13726,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() {
@@ -13786,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;
@@ -13826,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({
@@ -13851,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(
@@ -13867,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);
@@ -13879,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;
@@ -13893,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);
@@ -13905,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);
     }
@@ -13962,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,