@sentry/replay 10.65.0 → 10.67.0

package/build/npm/esm/index.js

@@ -8290,12 +8290,24 @@ class Replay {
   /**
    * Currently, this needs to be manually called (e.g. for tests). Sentry SDK
    * does not support a teardown
+   *
+   * @param options.flush - Whether to flush the pending replay segment when stopping.
+   * When recording in `session` mode, `stop()` flushes the buffered-but-unsent segment by
+   * default (`flush: true`), matching the previous behavior. Pass `flush: false` to stop
+   * recording without sending that pending segment — useful when a user withdraws consent
+   * and no further data should leave the browser.
+   *
+   * Note: `flush: false` only prevents the *pending* (final) segment from being sent. It does
+   * **not** retract segments that were already sent earlier during `session` recording.
    */
-  stop() {
+  stop(options) {
     if (!this._replay) {
       return Promise.resolve();
     }
-    return this._replay.stop({ forceFlush: this._replay.recordingMode === "session", reason: "manual" });
+    return this._replay.stop({
+      forceFlush: options?.flush ?? this._replay.recordingMode === "session",
+      reason: "manual"
+    });
   }
   /**
    * If not in "session" recording mode, flush event buffer which will create a new replay.