@amplitude/session-replay-browser 1.48.3 → 1.49.0

package/README.md

@@ -77,8 +77,21 @@ You can optionally pass a new device id as a second argument as well:
 sessionReplay.setSessionId(UNIX_TIMESTAMP, deviceId)
 ```
 
-### 6. Shutdown (optional)
-If at any point you would like to discontinue collection of session replays, for example in a part of your application where you would not like sessions to be collected, you can use the following method to stop collection and remove collection event listeners.
+### 6. Start and stop recording (optional)
+Use `stop()` to pause capture without tearing down the SDK (session id, config, and event listeners stay in place). Call `start()` to resume. Sampling, targeting, and opt-out still apply — `start()` will not record a session that is opted out, not sampled, or excluded by targeting.
+
+```typescript
+// Pause capture, for example on a sensitive screen
+sessionReplay.stop()
+
+// Resume capture
+sessionReplay.start()
+```
+
+`stop()` flushes any events already captured. Events while recording is stopped are not tagged with session replay properties.
+
+### 7. Shutdown (optional)
+If at any point you would like to discontinue collection of session replays, for example in a part of your application where you would not like sessions to be collected, you can use the following method to stop collection and remove collection event listeners. After `shutdown()`, call `init()` again to restart — `start()` alone is not enough because listeners have been removed.
 ```typescript
 sessionReplay.shutdown()
 ```

package/lib/cjs/index.d.ts

@@ -1,6 +1,6 @@
 export declare const init: (apiKey: string, options: import("./typings/session-replay").SessionReplayOptions) => import("@amplitude/analytics-core").AmplitudeReturn<void>, setSessionId: (sessionId: string | number, deviceId?: string | undefined) => import("@amplitude/analytics-core").AmplitudeReturn<void>, getSessionId: () => string | number | undefined, getSessionReplayProperties: () => {
     [key: string]: string | boolean | null;
-}, flush: (useRetry: boolean) => Promise<void>, shutdown: () => void, evaluateTargetingAndCapture: (targetingParams: import("./typings/session-replay").SessionReplayTargetingInput, isInit?: boolean | undefined, forceRestart?: boolean | undefined, forceTargetingReevaluation?: boolean | undefined) => Promise<void>;
+}, flush: (useRetry: boolean) => Promise<void>, start: () => import("@amplitude/analytics-core").AmplitudeReturn<void>, stop: () => void, shutdown: () => void, evaluateTargetingAndCapture: (targetingParams: import("./typings/session-replay").SessionReplayTargetingInput, isInit?: boolean | undefined, forceRestart?: boolean | undefined, forceTargetingReevaluation?: boolean | undefined) => Promise<void>;
 export { SessionReplayOptions, StoreType } from './typings/session-replay';
 export { SafeLoggerProvider } from './logger';
 export { AmplitudeSessionReplay } from './typings/session-replay';

package/lib/cjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,eAAO,MACL,IAAI,mJACJ,YAAY,4HACZ,YAAY,qCACZ,0BAA0B;;GAC1B,KAAK,wCACL,QAAQ,cACR,2BAA2B,wNACZ,CAAC;AAClB,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,8BAA8B,EAC9B,+BAA+B,GAChC,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,eAAO,MACL,IAAI,mJACJ,YAAY,4HACZ,YAAY,qCACZ,0BAA0B;;GAC1B,KAAK,wCACL,KAAK,mEACL,IAAI,cACJ,QAAQ,cACR,2BAA2B,wNACZ,CAAC;AAClB,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,8BAA8B,EAC9B,+BAA+B,GAChC,MAAM,gBAAgB,CAAC"}

package/lib/cjs/index.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SafeLoggerProvider = exports.evaluateTargetingAndCapture = exports.shutdown = exports.flush = exports.getSessionReplayProperties = exports.getSessionId = exports.setSessionId = exports.init = void 0;
+exports.SafeLoggerProvider = exports.evaluateTargetingAndCapture = exports.shutdown = exports.stop = exports.start = exports.flush = exports.getSessionReplayProperties = exports.getSessionId = exports.setSessionId = exports.init = void 0;
 var tslib_1 = require("tslib");
 var session_replay_factory_1 = tslib_1.__importDefault(require("./session-replay-factory"));
-exports.init = session_replay_factory_1.default.init, exports.setSessionId = session_replay_factory_1.default.setSessionId, exports.getSessionId = session_replay_factory_1.default.getSessionId, exports.getSessionReplayProperties = session_replay_factory_1.default.getSessionReplayProperties, exports.flush = session_replay_factory_1.default.flush, exports.shutdown = session_replay_factory_1.default.shutdown, exports.evaluateTargetingAndCapture = session_replay_factory_1.default.evaluateTargetingAndCapture;
+exports.init = session_replay_factory_1.default.init, exports.setSessionId = session_replay_factory_1.default.setSessionId, exports.getSessionId = session_replay_factory_1.default.getSessionId, exports.getSessionReplayProperties = session_replay_factory_1.default.getSessionReplayProperties, exports.flush = session_replay_factory_1.default.flush, exports.start = session_replay_factory_1.default.start, exports.stop = session_replay_factory_1.default.stop, exports.shutdown = session_replay_factory_1.default.shutdown, exports.evaluateTargetingAndCapture = session_replay_factory_1.default.evaluateTargetingAndCapture;
 var logger_1 = require("./logger");
 Object.defineProperty(exports, "SafeLoggerProvider", { enumerable: true, get: function () { return logger_1.SafeLoggerProvider; } });
 //# sourceMappingURL=index.js.map

package/lib/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;AAAA,4FAAqD;AAEnD,QAAA,IAAI,GAOF,gCAAa,OANf,QAAA,YAAY,GAMV,gCAAa,eALf,QAAA,YAAY,GAKV,gCAAa,eAJf,QAAA,0BAA0B,GAIxB,gCAAa,6BAHf,QAAA,KAAK,GAGH,gCAAa,QAFf,QAAA,QAAQ,GAEN,gCAAa,WADf,QAAA,2BAA2B,GACzB,gCAAa,6BAAC;AAElB,mCAA8C;AAArC,4GAAA,kBAAkB,OAAA","sourcesContent":["import sessionReplay from './session-replay-factory';\nexport const {\n  init,\n  setSessionId,\n  getSessionId,\n  getSessionReplayProperties,\n  flush,\n  shutdown,\n  evaluateTargetingAndCapture,\n} = sessionReplay;\nexport { SessionReplayOptions, StoreType } from './typings/session-replay';\nexport { SafeLoggerProvider } from './logger';\nexport { AmplitudeSessionReplay } from './typings/session-replay';\nexport {\n  SendEventsRequest,\n  FetchConfigRequest,\n  SessionReplaySendEventsHandler,\n  SessionReplayFetchConfigHandler,\n} from './config/types';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;AAAA,4FAAqD;AAEnD,QAAA,IAAI,GASF,gCAAa,OARf,QAAA,YAAY,GAQV,gCAAa,eAPf,QAAA,YAAY,GAOV,gCAAa,eANf,QAAA,0BAA0B,GAMxB,gCAAa,6BALf,QAAA,KAAK,GAKH,gCAAa,QAJf,QAAA,KAAK,GAIH,gCAAa,QAHf,QAAA,IAAI,GAGF,gCAAa,OAFf,QAAA,QAAQ,GAEN,gCAAa,WADf,QAAA,2BAA2B,GACzB,gCAAa,6BAAC;AAElB,mCAA8C;AAArC,4GAAA,kBAAkB,OAAA","sourcesContent":["import sessionReplay from './session-replay-factory';\nexport const {\n  init,\n  setSessionId,\n  getSessionId,\n  getSessionReplayProperties,\n  flush,\n  start,\n  stop,\n  shutdown,\n  evaluateTargetingAndCapture,\n} = sessionReplay;\nexport { SessionReplayOptions, StoreType } from './typings/session-replay';\nexport { SafeLoggerProvider } from './logger';\nexport { AmplitudeSessionReplay } from './typings/session-replay';\nexport {\n  SendEventsRequest,\n  FetchConfigRequest,\n  SessionReplaySendEventsHandler,\n  SessionReplayFetchConfigHandler,\n} from './config/types';\n"]}

package/lib/cjs/session-replay-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-replay-factory.d.ts","sourceRoot":"","sources":["../../src/session-replay-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,eAAO,MAAM,YAAY,kBAAmB,aAAa,WAAS,SAOjE,CAAC;;AA+BF,wBAAgC"}
+{"version":3,"file":"session-replay-factory.d.ts","sourceRoot":"","sources":["../../src/session-replay-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,eAAO,MAAM,YAAY,kBAAmB,aAAa,WAAS,SAOjE,CAAC;;AAiCF,wBAAgC"}

package/lib/cjs/session-replay-factory.js

@@ -22,6 +22,8 @@ var createInstance = function () {
         getSessionId: (0, analytics_core_1.debugWrapper)(sessionReplay.getSessionId.bind(sessionReplay), 'getSessionId', (0, exports.getLogConfig)(sessionReplay)),
         getSessionReplayProperties: (0, analytics_core_1.debugWrapper)(sessionReplay.getSessionReplayProperties.bind(sessionReplay), 'getSessionReplayProperties', (0, exports.getLogConfig)(sessionReplay)),
         flush: (0, analytics_core_1.debugWrapper)(sessionReplay.flush.bind(sessionReplay), 'flush', (0, exports.getLogConfig)(sessionReplay)),
+        start: (0, analytics_core_1.debugWrapper)(sessionReplay.start.bind(sessionReplay), 'start', (0, exports.getLogConfig)(sessionReplay)),
+        stop: (0, analytics_core_1.debugWrapper)(sessionReplay.stop.bind(sessionReplay), 'stop', (0, exports.getLogConfig)(sessionReplay)),
         shutdown: (0, analytics_core_1.debugWrapper)(sessionReplay.shutdown.bind(sessionReplay), 'shutdown', (0, exports.getLogConfig)(sessionReplay)),
     };
 };

package/lib/cjs/session-replay-factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-replay-factory.js","sourceRoot":"","sources":["../../src/session-replay-factory.ts"],"names":[],"mappings":";;;AAAA,4DAAoE;AACpE,sDAAyD;AACzD,mDAAiD;AAG1C,IAAM,YAAY,GAAG,UAAC,aAA4B,IAAK,OAAA;IACpD,IAAA,MAAM,GAAK,aAAa,OAAlB,CAAmB;IAC3B,IAAA,KAAuC,MAAM,IAAI,IAAA,+BAAgB,GAAE,EAAjD,MAAM,oBAAA,EAAE,QAAQ,cAAiC,CAAC;IAC1E,OAAO;QACL,MAAM,QAAA;QACN,QAAQ,UAAA;KACT,CAAC;AACJ,CAAC,EAP6D,CAO7D,CAAC;AAPW,QAAA,YAAY,gBAOvB;AAEF,IAAM,cAAc,GAAiC;IACnD,IAAM,aAAa,GAAG,IAAI,8BAAa,EAAE,CAAC;IAC1C,OAAO;QACL,IAAI,EAAE,IAAA,6BAAY,EAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,IAAA,oBAAY,EAAC,aAAa,CAAC,CAAC;QAC/F,2BAA2B,EAAE,IAAA,6BAAY,EACvC,aAAa,CAAC,2BAA2B,CAAC,IAAI,CAAC,aAAa,CAAC,EAC7D,4BAA4B,EAC5B,IAAA,oBAAY,EAAC,aAAa,CAAC,CAC5B;QACD,YAAY,EAAE,IAAA,6BAAY,EACxB,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,EAC9C,cAAc,EACd,IAAA,oBAAY,EAAC,aAAa,CAAC,CAC5B;QACD,YAAY,EAAE,IAAA,6BAAY,EACxB,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,EAC9C,cAAc,EACd,IAAA,oBAAY,EAAC,aAAa,CAAC,CAC5B;QACD,0BAA0B,EAAE,IAAA,6BAAY,EACtC,aAAa,CAAC,0BAA0B,CAAC,IAAI,CAAC,aAAa,CAAC,EAC5D,4BAA4B,EAC5B,IAAA,oBAAY,EAAC,aAAa,CAAC,CAC5B;QACD,KAAK,EAAE,IAAA,6BAAY,EAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,IAAA,oBAAY,EAAC,aAAa,CAAC,CAAC;QAClG,QAAQ,EAAE,IAAA,6BAAY,EAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,UAAU,EAAE,IAAA,oBAAY,EAAC,aAAa,CAAC,CAAC;KAC5G,CAAC;AACJ,CAAC,CAAC;AAEF,kBAAe,cAAc,EAAE,CAAC","sourcesContent":["import { debugWrapper, LogConfig } from '@amplitude/analytics-core';\nimport { getDefaultConfig } from './config/local-config';\nimport { SessionReplay } from './session-replay';\nimport { AmplitudeSessionReplay } from './typings/session-replay';\n\nexport const getLogConfig = (sessionReplay: SessionReplay) => (): LogConfig => {\n  const { config } = sessionReplay;\n  const { loggerProvider: logger, logLevel } = config || getDefaultConfig();\n  return {\n    logger,\n    logLevel,\n  };\n};\n\nconst createInstance: () => AmplitudeSessionReplay = () => {\n  const sessionReplay = new SessionReplay();\n  return {\n    init: debugWrapper(sessionReplay.init.bind(sessionReplay), 'init', getLogConfig(sessionReplay)),\n    evaluateTargetingAndCapture: debugWrapper(\n      sessionReplay.evaluateTargetingAndCapture.bind(sessionReplay),\n      'evaluateTargetingAndRecord',\n      getLogConfig(sessionReplay),\n    ),\n    setSessionId: debugWrapper(\n      sessionReplay.setSessionId.bind(sessionReplay),\n      'setSessionId',\n      getLogConfig(sessionReplay),\n    ),\n    getSessionId: debugWrapper(\n      sessionReplay.getSessionId.bind(sessionReplay),\n      'getSessionId',\n      getLogConfig(sessionReplay),\n    ),\n    getSessionReplayProperties: debugWrapper(\n      sessionReplay.getSessionReplayProperties.bind(sessionReplay),\n      'getSessionReplayProperties',\n      getLogConfig(sessionReplay),\n    ),\n    flush: debugWrapper(sessionReplay.flush.bind(sessionReplay), 'flush', getLogConfig(sessionReplay)),\n    shutdown: debugWrapper(sessionReplay.shutdown.bind(sessionReplay), 'shutdown', getLogConfig(sessionReplay)),\n  };\n};\n\nexport default createInstance();\n"]}
+{"version":3,"file":"session-replay-factory.js","sourceRoot":"","sources":["../../src/session-replay-factory.ts"],"names":[],"mappings":";;;AAAA,4DAAoE;AACpE,sDAAyD;AACzD,mDAAiD;AAG1C,IAAM,YAAY,GAAG,UAAC,aAA4B,IAAK,OAAA;IACpD,IAAA,MAAM,GAAK,aAAa,OAAlB,CAAmB;IAC3B,IAAA,KAAuC,MAAM,IAAI,IAAA,+BAAgB,GAAE,EAAjD,MAAM,oBAAA,EAAE,QAAQ,cAAiC,CAAC;IAC1E,OAAO;QACL,MAAM,QAAA;QACN,QAAQ,UAAA;KACT,CAAC;AACJ,CAAC,EAP6D,CAO7D,CAAC;AAPW,QAAA,YAAY,gBAOvB;AAEF,IAAM,cAAc,GAAiC;IACnD,IAAM,aAAa,GAAG,IAAI,8BAAa,EAAE,CAAC;IAC1C,OAAO;QACL,IAAI,EAAE,IAAA,6BAAY,EAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,IAAA,oBAAY,EAAC,aAAa,CAAC,CAAC;QAC/F,2BAA2B,EAAE,IAAA,6BAAY,EACvC,aAAa,CAAC,2BAA2B,CAAC,IAAI,CAAC,aAAa,CAAC,EAC7D,4BAA4B,EAC5B,IAAA,oBAAY,EAAC,aAAa,CAAC,CAC5B;QACD,YAAY,EAAE,IAAA,6BAAY,EACxB,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,EAC9C,cAAc,EACd,IAAA,oBAAY,EAAC,aAAa,CAAC,CAC5B;QACD,YAAY,EAAE,IAAA,6BAAY,EACxB,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,EAC9C,cAAc,EACd,IAAA,oBAAY,EAAC,aAAa,CAAC,CAC5B;QACD,0BAA0B,EAAE,IAAA,6BAAY,EACtC,aAAa,CAAC,0BAA0B,CAAC,IAAI,CAAC,aAAa,CAAC,EAC5D,4BAA4B,EAC5B,IAAA,oBAAY,EAAC,aAAa,CAAC,CAC5B;QACD,KAAK,EAAE,IAAA,6BAAY,EAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,IAAA,oBAAY,EAAC,aAAa,CAAC,CAAC;QAClG,KAAK,EAAE,IAAA,6BAAY,EAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,IAAA,oBAAY,EAAC,aAAa,CAAC,CAAC;QAClG,IAAI,EAAE,IAAA,6BAAY,EAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,IAAA,oBAAY,EAAC,aAAa,CAAC,CAAC;QAC/F,QAAQ,EAAE,IAAA,6BAAY,EAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,UAAU,EAAE,IAAA,oBAAY,EAAC,aAAa,CAAC,CAAC;KAC5G,CAAC;AACJ,CAAC,CAAC;AAEF,kBAAe,cAAc,EAAE,CAAC","sourcesContent":["import { debugWrapper, LogConfig } from '@amplitude/analytics-core';\nimport { getDefaultConfig } from './config/local-config';\nimport { SessionReplay } from './session-replay';\nimport { AmplitudeSessionReplay } from './typings/session-replay';\n\nexport const getLogConfig = (sessionReplay: SessionReplay) => (): LogConfig => {\n  const { config } = sessionReplay;\n  const { loggerProvider: logger, logLevel } = config || getDefaultConfig();\n  return {\n    logger,\n    logLevel,\n  };\n};\n\nconst createInstance: () => AmplitudeSessionReplay = () => {\n  const sessionReplay = new SessionReplay();\n  return {\n    init: debugWrapper(sessionReplay.init.bind(sessionReplay), 'init', getLogConfig(sessionReplay)),\n    evaluateTargetingAndCapture: debugWrapper(\n      sessionReplay.evaluateTargetingAndCapture.bind(sessionReplay),\n      'evaluateTargetingAndRecord',\n      getLogConfig(sessionReplay),\n    ),\n    setSessionId: debugWrapper(\n      sessionReplay.setSessionId.bind(sessionReplay),\n      'setSessionId',\n      getLogConfig(sessionReplay),\n    ),\n    getSessionId: debugWrapper(\n      sessionReplay.getSessionId.bind(sessionReplay),\n      'getSessionId',\n      getLogConfig(sessionReplay),\n    ),\n    getSessionReplayProperties: debugWrapper(\n      sessionReplay.getSessionReplayProperties.bind(sessionReplay),\n      'getSessionReplayProperties',\n      getLogConfig(sessionReplay),\n    ),\n    flush: debugWrapper(sessionReplay.flush.bind(sessionReplay), 'flush', getLogConfig(sessionReplay)),\n    start: debugWrapper(sessionReplay.start.bind(sessionReplay), 'start', getLogConfig(sessionReplay)),\n    stop: debugWrapper(sessionReplay.stop.bind(sessionReplay), 'stop', getLogConfig(sessionReplay)),\n    shutdown: debugWrapper(sessionReplay.shutdown.bind(sessionReplay), 'shutdown', getLogConfig(sessionReplay)),\n  };\n};\n\nexport default createInstance();\n"]}

package/lib/cjs/session-replay.d.ts

@@ -35,6 +35,24 @@ export declare class SessionReplay implements AmplitudeSessionReplay {
     private metadata;
     private recordFunction;
     private recordEventsInFlight;
+    /**
+     * When false, capture is paused by a customer `stop()` (or `shutdown()`) call.
+     * Focus/targeting/session-change paths still invoke `recordEvents()`, but
+     * `getShouldRecord()` will refuse to start rrweb until `start()` or a new `init()`.
+     */
+    private recordingEnabled;
+    /**
+     * Bumped by `stop()` / `shutdown()` so an in-flight `_recordEvents()` that already
+     * passed `getShouldRecord()` cannot start rrweb after capture was paused.
+     */
+    private recordingGeneration;
+    /**
+     * Set by customer `start()` so coordinated child iframes self-start instead of
+     * waiting for a parent signal that may never be resent. Kept until recording
+     * actually starts so a gated `start()` (targeting, sampling, remote capture)
+     * still self-starts when those gates later pass.
+     */
+    private startChildRecordingOnSetup;
     private pendingEmitEvents;
     /** Current page URL, kept in sync with SPA navigations for URL-based masking */
     private currentPageUrl;
@@ -94,6 +112,7 @@ export declare class SessionReplay implements AmplitudeSessionReplay {
     getRecordingPlugins(loggingConfig: LoggingConfig | undefined): Promise<(import("@amplitude/rrweb-types").RecordPlugin<import("./plugins/url-tracking-plugin").URLTrackingPluginOptions> | import("@amplitude/rrweb-types").RecordPlugin<unknown>)[] | undefined>;
     private getRecordFunction;
     recordEvents(shouldLogMetadata?: boolean): Promise<void>;
+    private shouldAbandonRecordStart;
     private _recordEvents;
     private buildRRWebRecordOptions;
     private _recordEventsInChildMode;
@@ -103,6 +122,9 @@ export declare class SessionReplay implements AmplitudeSessionReplay {
     stopRecordingEvents: () => void;
     getDeviceId(): string | undefined;
     getSessionId(): string | number | undefined;
+    start(): import("@amplitude/analytics-core").AmplitudeReturn<void>;
+    private _start;
+    stop(): void;
     flush(useRetry?: boolean): Promise<void | undefined>;
     shutdown(): void;
     private mapSDKType;

package/lib/cjs/session-replay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-replay.d.ts","sourceRoot":"","sources":["../../src/session-replay.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-replay.d.ts","sourceRoot":"","sources":["../../src/session-replay.ts"],"names":[],"mappings":"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"}

package/lib/cjs/session-replay.js

@@ -44,6 +44,24 @@ var SessionReplay = /** @class */ (function () {
         // Cache the dynamically imported record function
         this.recordFunction = null;
         this.recordEventsInFlight = false;
+        /**
+         * When false, capture is paused by a customer `stop()` (or `shutdown()`) call.
+         * Focus/targeting/session-change paths still invoke `recordEvents()`, but
+         * `getShouldRecord()` will refuse to start rrweb until `start()` or a new `init()`.
+         */
+        this.recordingEnabled = true;
+        /**
+         * Bumped by `stop()` / `shutdown()` so an in-flight `_recordEvents()` that already
+         * passed `getShouldRecord()` cannot start rrweb after capture was paused.
+         */
+        this.recordingGeneration = 0;
+        /**
+         * Set by customer `start()` so coordinated child iframes self-start instead of
+         * waiting for a parent signal that may never be resent. Kept until recording
+         * actually starts so a gated `start()` (targeting, sampling, remote capture)
+         * still self-starts when those gates later pass.
+         */
+        this.startChildRecordingOnSetup = false;
         this.pendingEmitEvents = [];
         /** Current page URL, kept in sync with SPA navigations for URL-based masking */
         this.currentPageUrl = '';
@@ -80,6 +98,9 @@ var SessionReplay = /** @class */ (function () {
         };
         this.focusListener = function () {
             var _a;
+            if (!_this.recordingEnabled) {
+                return;
+            }
             if (_this.recordCancelCallback && _this.recordFunction) {
                 // Recording is already active. The on-focus full snapshot is tunable: when
                 // `captureFullSnapshotOnFocus` is false we skip it entirely so high focus-churn pages
@@ -335,6 +356,9 @@ var SessionReplay = /** @class */ (function () {
                         // Re-init should always tear down any previous URL-change subscription, even when the
                         // next config has no targeting config and we don't subscribe again.
                         (_a = this.urlChangeCleanup) === null || _a === void 0 ? void 0 : _a.call(this);
+                        // A new init always allows capture again. `stop()` only pauses the current instance.
+                        this.recordingEnabled = true;
+                        this.startChildRecordingOnSetup = false;
                         this.loggerProvider = new logger_1.SafeLoggerProvider(options.loggerProvider || new analytics_core_1.Logger());
                         Object.prototype.hasOwnProperty.call(options, 'logLevel') &&
                             this.loggerProvider.enable(options.logLevel);
@@ -696,6 +720,10 @@ var SessionReplay = /** @class */ (function () {
             this.loggerProvider.warn("Session is not being recorded due to lack of config, please call sessionReplay.init.");
             return false;
         }
+        if (!this.recordingEnabled) {
+            this.loggerProvider.log("Session ".concat(this.identifiers.sessionId, " not being captured because recording was stopped."));
+            return false;
+        }
         if (!this.config.captureEnabled) {
             this.loggerProvider.log("Session ".concat(this.identifiers.sessionId, " not being captured due to capture being disabled for project or because the remote config could not be fetched."));
             return false;
@@ -888,15 +916,17 @@ var SessionReplay = /** @class */ (function () {
             });
         });
     };
+    SessionReplay.prototype.shouldAbandonRecordStart = function (generation) {
+        return !this.recordingEnabled || generation !== this.recordingGeneration;
+    };
     SessionReplay.prototype._recordEvents = function (shouldLogMetadata) {
         var _a, _b, _c, _d, _e, _f, _g, _h;
         if (shouldLogMetadata === void 0) { shouldLogMetadata = true; }
         return tslib_1.__awaiter(this, void 0, void 0, function () {
-            var config, shouldRecord, sessionId, recordFunction, networkLoggingConfig, trackUrl, ignoredUrls, interactionConfig, loggingConfig, hooks, ugcFilterRules, crossOriginIframesEnabled, coordinateChildren, childMode, _j, _k, _l, error_5;
-            var _m;
+            var config, shouldRecord, sessionId, generation, recordFunction, networkLoggingConfig, trackUrl, ignoredUrls, interactionConfig, loggingConfig, hooks, ugcFilterRules, crossOriginIframesEnabled, coordinateChildren, childMode, plugins, error_5;
             var _this = this;
-            return tslib_1.__generator(this, function (_o) {
-                switch (_o.label) {
+            return tslib_1.__generator(this, function (_j) {
+                switch (_j.label) {
                     case 0:
                         config = this.config;
                         shouldRecord = this.getShouldRecord();
@@ -905,16 +935,20 @@ var SessionReplay = /** @class */ (function () {
                             return [2 /*return*/];
                         }
                         this.stopRecordingEvents();
+                        generation = this.recordingGeneration;
                         return [4 /*yield*/, this.getRecordFunction()];
                     case 1:
-                        recordFunction = _o.sent();
+                        recordFunction = _j.sent();
                         // May be undefined if cannot import rrweb-record
-                        if (!recordFunction) {
+                        if (!recordFunction || this.shouldAbandonRecordStart(generation)) {
                             return [2 /*return*/];
                         }
                         return [4 /*yield*/, this.initializeNetworkObservers()];
                     case 2:
-                        _o.sent();
+                        _j.sent();
+                        if (this.shouldAbandonRecordStart(generation)) {
+                            return [2 /*return*/];
+                        }
                         networkLoggingConfig = (_b = config.loggingConfig) === null || _b === void 0 ? void 0 : _b.network;
                         trackUrl = (0, helpers_1.getServerUrl)(config.serverZone, config.trackServerUrl);
                         ignoredUrls = [constants_1.SESSION_REPLAY_SERVER_URL, constants_1.SESSION_REPLAY_EU_URL, constants_1.SESSION_REPLAY_STAGING_URL, trackUrl];
@@ -940,9 +974,9 @@ var SessionReplay = /** @class */ (function () {
                             : {};
                         ugcFilterRules = (interactionConfig === null || interactionConfig === void 0 ? void 0 : interactionConfig.enabled) && interactionConfig.ugcFilterRules ? interactionConfig.ugcFilterRules : [];
                         this.loggerProvider.log("Session Replay capture beginning for ".concat(sessionId, "."));
-                        _o.label = 3;
+                        _j.label = 3;
                     case 3:
-                        _o.trys.push([3, 5, , 6]);
+                        _j.trys.push([3, 5, , 6]);
                         crossOriginIframesEnabled = !!((_g = config.crossOriginIframes) === null || _g === void 0 ? void 0 : _g.enabled);
                         coordinateChildren = ((_h = config.crossOriginIframes) === null || _h === void 0 ? void 0 : _h.coordinateChildren) !== false;
                         childMode = crossOriginIframesEnabled && (0, cross_origin_iframes_1.isInIframe)();
@@ -950,7 +984,12 @@ var SessionReplay = /** @class */ (function () {
                             // Child mode: don't self-start; wait for a start signal from the parent.
                             // (The previous listener, if any, was already removed by stopRecordingEvents above.)
                             this.crossOriginParentSignalCleanup = (0, cross_origin_iframes_1.listenForParentSignals)({
-                                onStart: function () { return _this._recordEventsInChildMode(recordFunction, sessionId, config, hooks); },
+                                onStart: function () {
+                                    if (!_this.recordingEnabled) {
+                                        return;
+                                    }
+                                    _this._recordEventsInChildMode(recordFunction, sessionId, config, hooks);
+                                },
                                 onStop: function () {
                                     try {
                                         // Only cancel the rrweb recording — do NOT call stopRecordingEvents() here,
@@ -965,34 +1004,43 @@ var SessionReplay = /** @class */ (function () {
                                     }
                                 },
                             });
+                            // Customer start() must not wait for a parent signal: the parent may already
+                            // be recording and will not send another start. Init still waits.
+                            if (this.startChildRecordingOnSetup) {
+                                this.startChildRecordingOnSetup = false;
+                                this._recordEventsInChildMode(recordFunction, sessionId, config, hooks);
+                            }
                             return [2 /*return*/];
                         }
-                        _j = this;
-                        _k = recordFunction;
-                        _l = [tslib_1.__assign({}, this.buildRRWebRecordOptions(config, hooks, function (event) {
-                                if (_this.shouldOptOut()) {
-                                    _this.loggerProvider.log("Opting session ".concat(sessionId, " out of recording due to optOut config."));
-                                    _this.stopRecordingEvents();
-                                    _this.sendEvents();
-                                    return;
-                                }
-                                if (event.type === rrweb_types_1.EventType.Meta) {
-                                    event.data.href = (0, helpers_1.getPageUrl)(event.data.href, ugcFilterRules);
-                                }
-                                if (_this.eventCompressor) {
-                                    // Schedule processing during idle time if the browser supports requestIdleCallback
-                                    _this.eventCompressor.enqueueEvent(event, sessionId);
-                                }
-                                else {
-                                    // eventCompressor is not yet ready (concurrent call racing _init()).
-                                    // Buffer the event so it can be flushed once the compressor is initialized.
-                                    _this.pendingEmitEvents.push({ event: event, sessionId: sessionId });
-                                }
-                            }, 'Error while capturing replay: '))];
-                        _m = {};
+                        this.startChildRecordingOnSetup = false;
                         return [4 /*yield*/, this.getRecordingPlugins(loggingConfig)];
                     case 4:
-                        _j.recordCancelCallback = _k.apply(void 0, [tslib_1.__assign.apply(void 0, _l.concat([(_m.plugins = _o.sent(), _m.recordCrossOriginIframes = crossOriginIframesEnabled, _m)]))]);
+                        plugins = _j.sent();
+                        if (this.shouldAbandonRecordStart(generation)) {
+                            return [2 /*return*/];
+                        }
+                        this.recordCancelCallback = recordFunction(tslib_1.__assign(tslib_1.__assign({}, this.buildRRWebRecordOptions(config, hooks, function (event) {
+                            if (_this.shouldOptOut() || !_this.recordingEnabled) {
+                                _this.loggerProvider.log(_this.shouldOptOut()
+                                    ? "Opting session ".concat(sessionId, " out of recording due to optOut config.")
+                                    : "Session Replay capture stopping for ".concat(sessionId, "."));
+                                _this.stopRecordingEvents();
+                                _this.sendEvents();
+                                return;
+                            }
+                            if (event.type === rrweb_types_1.EventType.Meta) {
+                                event.data.href = (0, helpers_1.getPageUrl)(event.data.href, ugcFilterRules);
+                            }
+                            if (_this.eventCompressor) {
+                                // Schedule processing during idle time if the browser supports requestIdleCallback
+                                _this.eventCompressor.enqueueEvent(event, sessionId);
+                            }
+                            else {
+                                // eventCompressor is not yet ready (concurrent call racing _init()).
+                                // Buffer the event so it can be flushed once the compressor is initialized.
+                                _this.pendingEmitEvents.push({ event: event, sessionId: sessionId });
+                            }
+                        }, 'Error while capturing replay: ')), { plugins: plugins, recordCrossOriginIframes: crossOriginIframesEnabled }));
                         if (crossOriginIframesEnabled && !childMode && coordinateChildren) {
                             if (!this.crossOriginIframeCoordinator) {
                                 this.crossOriginIframeCoordinator = new cross_origin_iframes_1.CrossOriginIframeCoordinator();
@@ -1005,7 +1053,7 @@ var SessionReplay = /** @class */ (function () {
                         }
                         return [3 /*break*/, 6];
                     case 5:
-                        error_5 = _o.sent();
+                        error_5 = _j.sent();
                         this.loggerProvider.warn('Failed to initialize session replay:', error_5);
                         return [3 /*break*/, 6];
                     case 6: return [2 /*return*/];
@@ -1075,6 +1123,31 @@ var SessionReplay = /** @class */ (function () {
         var _a;
         return (_a = this.identifiers) === null || _a === void 0 ? void 0 : _a.sessionId;
     };
+    SessionReplay.prototype.start = function () {
+        return (0, analytics_core_1.returnWrapper)(this._start());
+    };
+    SessionReplay.prototype._start = function () {
+        return tslib_1.__awaiter(this, void 0, void 0, function () {
+            return tslib_1.__generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        this.recordingEnabled = true;
+                        this.startChildRecordingOnSetup = true;
+                        return [4 /*yield*/, this.recordEvents()];
+                    case 1:
+                        _a.sent();
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    SessionReplay.prototype.stop = function () {
+        this.recordingEnabled = false;
+        this.startChildRecordingOnSetup = false;
+        this.recordingGeneration++;
+        this.stopRecordingEvents();
+        this.sendEvents();
+    };
     SessionReplay.prototype.flush = function (useRetry) {
         var _a;
         if (useRetry === void 0) { useRetry = false; }
@@ -1091,6 +1164,9 @@ var SessionReplay = /** @class */ (function () {
     };
     SessionReplay.prototype.shutdown = function () {
         var _a, _b;
+        this.recordingEnabled = false;
+        this.startChildRecordingOnSetup = false;
+        this.recordingGeneration++;
         (_a = this.urlChangeCleanup) === null || _a === void 0 ? void 0 : _a.call(this);
         (_b = this.crossOriginParentSignalCleanup) === null || _b === void 0 ? void 0 : _b.call(this);
         this.crossOriginParentSignalCleanup = null;