@newtalaria/browser 0.1.4 → 0.1.6

package/README.md

@@ -35,6 +35,9 @@ Talaria.init({
   // until the 5-minute max duration (Sentry-like, more expensive).
   replaysErrorAfterMs: 15_000,
   maskAllInputs: true, // default
+  // Embed same-origin CSS into the snapshot (needed for auth-gated UIs like CMS).
+  // Default false — player re-fetches public stylesheet hrefs instead.
+  // inlineStylesheet: true,
 });
 
 try {
@@ -52,6 +55,27 @@ await Talaria.close();
 
 `Talaria.init` also installs `window.onerror` / `unhandledrejection` handlers unless you pass `disableDefaultIntegrations: true`.
 
+Optional init `tags` are merged into every captured event (per-call tags win on key conflict).
+
+## Script tag (IIFE)
+
+For hosts without a bundler (e.g. Silverstripe `Requirements`):
+
+```html
+<script src="/path/to/talaria.browser.iife.js"></script>
+<script>
+  Talaria.init({
+    dsn: 'https://api.example.com',
+    apiKey: 'tal_live_…',
+    environment: 'production',
+    replaysSessionSampleRate: 0,
+    replaysOnErrorSampleRate: 0,
+  });
+</script>
+```
+
+Build output: `dist/talaria.browser.iife.js` (also produced by `npm run build` / `npm run build:iife`).
+
 ## Recommended sampling (cost)
 
 You pay for **uploaded + retained** bytes, not for local buffering. Prefer error clips in production; keep full-session sampling low.
@@ -127,6 +151,32 @@ Custom rrweb events:
 
 Privacy defaults: `maskAllInputs: true`, password fields masked, `[data-talaria-mask]` blocked.
 
+### Auth-gated CSS (CMS / admin)
+
+By default `inlineStylesheet` is `false`: linked stylesheets stay as `href`s and are re-fetched when you watch the replay. That works for **public** CSS, but fails for login-protected admin CSS (player has no session cookies).
+
+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.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;AAuEpC,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;IAgEvC,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;IA4ErB,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;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;AA4EpC,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;IA6FvC,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"}

package/dist/iife.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=iife.d.ts.map

package/dist/iife.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iife.d.ts","sourceRoot":"","sources":["../src/iife.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -32,6 +32,6 @@ 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 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;AAEpB,eAAe,OAAO,CAAC"}

package/dist/index.js

@@ -13142,7 +13142,7 @@ function startRecorder(options) {
     blockSelector: defaultBlockSelector(options.blockSelector),
     recordCanvas: false,
     collectFonts: false,
-    inlineStylesheet: false,
+    inlineStylesheet: options.inlineStylesheet,
     // Shrink DOM snapshots on heavy sites (docs / marketing).
     slimDOMOptions: "all",
     sampling: {
@@ -13214,11 +13214,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 +13267,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 +13276,7 @@ function installNetworkHook() {
         });
         return response;
       } catch (error) {
-        emitNetwork({
+        handleMeta({
           method,
           url,
           durationMs: Date.now() - started,
@@ -13254,7 +13295,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,
@@ -13294,9 +13335,14 @@ function resolveOptions(options) {
     replaysOnErrorSampleRate: clamp01(options.replaysOnErrorSampleRate ?? 1),
     replaysErrorAfterMs: normalizeErrorAfterMs(options.replaysErrorAfterMs),
     maskAllInputs: options.maskAllInputs ?? true,
+    inlineStylesheet: options.inlineStylesheet ?? false,
     blockSelector: options.blockSelector ?? "",
     userId: options.userId,
-    disableDefaultIntegrations: options.disableDefaultIntegrations ?? false
+    tags: options.tags,
+    disableDefaultIntegrations: options.disableDefaultIntegrations ?? false,
+    captureFailedRequests: options.captureFailedRequests ?? true,
+    failedRequestStatusCodes: options.failedRequestStatusCodes ?? [[500, 599]],
+    failedRequestIgnoreUrls: options.failedRequestIgnoreUrls ?? []
   };
 }
 function clamp01(n2) {
@@ -13380,10 +13426,39 @@ var TalariaClient = class {
     this.uploadEnabled = this.sessionSampled;
     this.recorder = startRecorder({
       maskAllInputs: this.options.maskAllInputs,
+      inlineStylesheet: this.options.inlineStylesheet,
       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();
     }
@@ -13551,7 +13626,10 @@ var TalariaClient = class {
         throw error;
       }
     }
-    const tags = { ...args.context?.tags ?? {} };
+    const tags = {
+      ...this.options.tags ?? {},
+      ...args.context?.tags ?? {}
+    };
     const extra = args.context?.extra;
     const replayId = this.uploadEnabled && this.segmentIndex > 0 ? this.replayId : this.linkableReplayId;
     try {