@diegotsi/flint-core 1.8.0 → 1.9.1

package/dist/index.d.ts

@@ -177,7 +177,7 @@ interface FlintConfig {
         environment?: () => EnvironmentInfo;
     };
     /** @internal Injected by framework packages to start replay without rrweb in core */
-    _replayRecorder?: (onEmit: (event: unknown) => void) => Promise<(() => void) | undefined>;
+    _replayRecorder?: (onEmit: (event: unknown, isCheckout?: boolean) => void) => Promise<(() => void) | undefined>;
 }
 interface CollectedMeta {
     environment: EnvironmentInfo;
@@ -289,6 +289,36 @@ declare const DATADOG_BLOCKED_HOSTS: string[];
  * session and returns a deep link to the Session Replay viewer.
  */
 declare function createDatadogReplayProvider(site: string): () => string | undefined;
+/**
+ * Emits a custom Datadog RUM action at the moment a bug is reported, so it
+ * shows up as a clickable marker on the Session Replay timeline — making the
+ * report moment easy to find in long sessions.
+ *
+ * No-op when Datadog RUM (`window.DD_RUM`) is not present on the page.
+ */
+declare function trackDatadogBugReported(meta: {
+    bugId: string;
+    severity?: string;
+    url?: string;
+    title?: string;
+}): void;
+
+/**
+ * Rolling buffer for rrweb replay events.
+ *
+ * rrweb playback requires the event stream to begin with a Meta + FullSnapshot
+ * ("checkout"). A naive time-window trim can strip that opening snapshot and
+ * leave the player with orphaned incremental mutations it can't render.
+ *
+ * When the recorder signals checkouts (via `isCheckout`), this buffer trims by
+ * *segment* instead of by time: it always retains the current checkout segment
+ * plus the previous one, so the buffer never starts mid-stream. Recorders that
+ * never signal a checkout fall back to the legacy time-window trim.
+ */
+interface ReplayBuffer {
+    push(event: unknown, isCheckout?: boolean): void;
+    getEvents(): unknown[];
+}
 
 interface FlintInstance {
     config: FlintConfig;
@@ -297,7 +327,7 @@ interface FlintInstance {
     formErrors: FormErrorCollector | null;
     frustration: FrustrationCollector | null;
     errorCapture: ErrorCaptureCollector | null;
-    replayEvents: unknown[];
+    replayBuffer: ReplayBuffer;
     stopReplay: (() => void) | null;
 }
 declare function init(config: FlintConfig): void;
@@ -346,4 +376,4 @@ interface ResolvedTheme {
 }
 declare function resolveTheme(theme: Theme): ResolvedTheme;
 
-export { type CollectedMeta, type ConsoleCollector, type ConsoleEntry, DATADOG_BLOCKED_HOSTS, type EnvironmentInfo, type ErrorBreadcrumbs, type ErrorCaptureCollector, type ErrorCaptureOptions, type ErrorEventPayload, Flint, type FlintConfig, type FlintState, type FlintUser, type FlintWidgetProps, type FormErrorCollector, type FormErrorEntry, type FrustrationCollector, type FrustrationEvent, type Locale, type NetworkCollector, type NetworkEntry, type ReportPayload, type ReportResult, type ResolvedTheme, type Severity, type Theme, type ThemeOverride, _setFormErrorCollector, collectEnvironment, createConsoleCollector, createDatadogReplayProvider, createErrorCaptureCollector, createFormErrorCollector, createFrustrationCollector, createNetworkCollector, getSnapshot, resolveTheme, submitReplay, submitReport, subscribe };
+export { type CollectedMeta, type ConsoleCollector, type ConsoleEntry, DATADOG_BLOCKED_HOSTS, type EnvironmentInfo, type ErrorBreadcrumbs, type ErrorCaptureCollector, type ErrorCaptureOptions, type ErrorEventPayload, Flint, type FlintConfig, type FlintState, type FlintUser, type FlintWidgetProps, type FormErrorCollector, type FormErrorEntry, type FrustrationCollector, type FrustrationEvent, type Locale, type NetworkCollector, type NetworkEntry, type ReportPayload, type ReportResult, type ResolvedTheme, type Severity, type Theme, type ThemeOverride, _setFormErrorCollector, collectEnvironment, createConsoleCollector, createDatadogReplayProvider, createErrorCaptureCollector, createFormErrorCollector, createFrustrationCollector, createNetworkCollector, getSnapshot, resolveTheme, submitReplay, submitReport, subscribe, trackDatadogBugReported };

package/dist/index.js

@@ -1,7 +1,8 @@
 import {
   DATADOG_BLOCKED_HOSTS,
-  createDatadogReplayProvider
-} from "./chunk-HVSD45YR.js";
+  createDatadogReplayProvider,
+  trackDatadogBugReported
+} from "./chunk-SO6WYKFF.js";
 
 // src/api.ts
 import { gzipSync } from "fflate";
@@ -1056,6 +1057,34 @@ function createNetworkCollector(extraBlockedHosts = []) {
   };
 }
 
+// src/replayBuffer.ts
+function createReplayBuffer(replayBufferMs, now = Date.now) {
+  const events = [];
+  let checkoutSeen = false;
+  let recentCheckoutIdx = 0;
+  return {
+    push(event, isCheckout) {
+      if (isCheckout) {
+        checkoutSeen = true;
+        if (events.length > 0) {
+          events.splice(0, recentCheckoutIdx);
+          recentCheckoutIdx = events.length;
+        }
+      }
+      events.push(event);
+      if (!checkoutSeen) {
+        const cutoff = now() - replayBufferMs;
+        while (events.length > 0 && events[0].timestamp < cutoff) {
+          events.shift();
+        }
+      }
+    },
+    getEvents() {
+      return [...events];
+    }
+  };
+}
+
 // src/store.ts
 var formErrorCollectorRef = null;
 function _setFormErrorCollector(collector) {
@@ -1171,7 +1200,7 @@ function init(config) {
   if (config.user) {
     flint.setUser(config.user);
   }
-  const replayEvents = [];
+  const replayBuffer = createReplayBuffer(replayBufferMs);
   let stopReplay = null;
   debugLog(config, "Collectors started", {
     console: !!consoleCol,
@@ -1187,16 +1216,12 @@ function init(config) {
     formErrors: formErrorsCol,
     frustration: frustrationCol,
     errorCapture: errorCaptureCol,
-    replayEvents,
+    replayBuffer,
     stopReplay: null
   };
   if (enableReplay && _replayRecorder) {
-    _replayRecorder((event) => {
-      replayEvents.push(event);
-      const cutoff = Date.now() - replayBufferMs;
-      while (replayEvents.length > 0 && replayEvents[0].timestamp < cutoff) {
-        replayEvents.shift();
-      }
+    _replayRecorder((event, isCheckout) => {
+      replayBuffer.push(event, isCheckout);
     }).then((stop) => {
       stopReplay = stop ?? null;
       if (instance) instance.stopReplay = stopReplay;
@@ -1237,7 +1262,7 @@ function init(config) {
       if (!instance || !remote?.integrations) return;
       const dd = remote.integrations.datadog;
       if (dd?.enabled && dd.site) {
-        import("./datadog-I3QKI6Q3.js").then(({ createDatadogReplayProvider: createDatadogReplayProvider2 }) => {
+        import("./datadog-FLEAFTUB.js").then(({ createDatadogReplayProvider: createDatadogReplayProvider2 }) => {
           if (!instance) return;
           instance.config = {
             ...instance.config,
@@ -1288,7 +1313,7 @@ function getMeta(extraMeta) {
   };
 }
 function getReplayEvents() {
-  return instance ? [...instance.replayEvents] : [];
+  return instance ? instance.replayBuffer.getEvents() : [];
 }
 function getConfig() {
   return instance?.config ?? null;
@@ -1366,6 +1391,7 @@ export {
   resolveTheme,
   submitReplay,
   submitReport,
-  subscribe
+  subscribe,
+  trackDatadogBugReported
 };
 //# sourceMappingURL=index.js.map