@cloudcare/cocos-session-replay 0.1.0-alpha.6 → 0.1.0-alpha.8

package/dist/creator3/core/client.d.ts

@@ -15,11 +15,68 @@ export declare class FTCocosReplaySDK {
     readonly logger: FTCocosSDK['logger'];
     readonly trace: FTCocosSDK['trace'];
     constructor(base: FTCocosSDK, replay: FTSessionReplay, capture: FTReplayCapture, configure: (config: FTSessionReplayConfig | undefined) => void);
+    /**
+     * Initializes the base SDK and configured modules for a standalone Cocos app.
+     * Supplying `config.replay` also enables native Session Replay and starts
+     * canvas capture. Omitting it does not start Replay.
+     *
+     * Call once during application startup, after composing with withSessionReplay.
+     * Do not combine with {@link attach}, which requires a native host-owned SDK.
+     *
+     * @param config - Base SDK settings, optional modules, and Replay settings.
+     * @throws If the SDK is already started or attached, Replay settings are
+     * invalid, or the required native Replay integration is unavailable.
+     */
     start(config: FTCocosReplayConfig): void;
+    /**
+     * Attaches Cocos tracking to an SDK initialized by the native Hybrid host.
+     * Supplying `config.replay` prepares canvas capture for {@link enterCocos};
+     * capture does not start until that method is called. The native host owns
+     * native SDK and Replay initialization, including sampling settings.
+     *
+     * Call before the first {@link enterCocos}. Repeated calls after attachment
+     * have no effect and do not update the configuration.
+     *
+     * @param config - Optional Cocos automatic tracking and Hybrid Replay settings.
+     * @throws If standalone initialization has already started, Replay settings
+     * are invalid, or the required native Replay integration is unavailable.
+     */
     attach(config?: FTCocosHybridReplayConfig): void;
+    /**
+     * Selects the Cocos camera used for subsequent Session Replay captures.
+     * Update it when changing scenes if the selected camera belongs to the old
+     * scene. Selecting a camera does not start Replay capture.
+     *
+     * @param camera - A Camera component from the matching Creator engine in the
+     * active scene, or null/undefined to restore automatic camera selection.
+     */
     setReplayCamera(camera: unknown): void;
+    /**
+     * Starts Cocos automatic tracking and any Replay capture enabled by
+     * {@link attach} in Hybrid mode. Repeated calls while entered have no effect.
+     *
+     * @param options - Options for the Cocos view being entered. Supply `viewName`
+     * when automatic scene tracking is disabled.
+     * @throws If the SDK is not attached in Hybrid mode, the required view name
+     * is missing, or tracking or Replay startup fails.
+     */
     enterCocos(options?: FTCocosEnterOptions): void;
+    /**
+     * Stops Cocos automatic tracking and Hybrid Replay capture while keeping the
+     * native host SDK running. Call {@link enterCocos} to resume Cocos tracking.
+     * Has no effect before attachment or when Cocos has already been left.
+     *
+     * @throws If the SDK was started in standalone mode, or tracking or Replay
+     * cleanup fails.
+     */
     leaveCocos(): void;
+    /**
+     * Stops standalone Cocos tracking, Session Replay, and the base native SDK.
+     * Has no effect if the base SDK is idle. Hybrid applications must use
+     * {@link leaveCocos} because the native host owns SDK shutdown.
+     *
+     * @throws If the SDK is attached in Hybrid mode or shutdown cleanup fails.
+     */
     shutdown(): void;
 }
 export declare function composeSessionReplay(base: FTCocosSDK, engine: 'creator2' | 'creator3', create: () => {

package/dist/creator3/core/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../../src/session-replay/core/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC1G,OAAO,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAChG,OAAO,KAAK,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,qBAAqB,EAA+B,MAAM,YAAY,CAAC;AAIrI,MAAM,WAAW,eAAgB,SAAQ,eAAe;IAAG,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CAAE;AAE9F,mFAAmF;AACnF,qBAAa,gBAAgB;IAOzB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,QAAQ,CAAC,MAAM,EAAE,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAT5B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IACtC,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;gBAGjB,IAAI,EAAE,UAAU,EACxB,MAAM,EAAE,eAAe,EACf,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,CAAC,MAAM,EAAE,qBAAqB,GAAG,SAAS,KAAK,IAAI;IAQjF,KAAK,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAMxC,MAAM,CAAC,MAAM,GAAE,yBAA8B,GAAG,IAAI;IAMpD,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IACtC,UAAU,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,IAAI;IAC/C,UAAU,IAAI,IAAI;IAClB,QAAQ,IAAI,IAAI;CACjB;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,UAAU,GAAG,UAAU,EAC/B,MAAM,EAAE,MAAM;IAAE,SAAS,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,qBAAqB,CAAA;CAAE,GACxG,gBAAgB,CAkClB"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../../src/session-replay/core/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC1G,OAAO,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAChG,OAAO,KAAK,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,qBAAqB,EAA+B,MAAM,YAAY,CAAC;AAIrI,MAAM,WAAW,eAAgB,SAAQ,eAAe;IAAG,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CAAE;AAE9F,mFAAmF;AACnF,qBAAa,gBAAgB;IAOzB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,QAAQ,CAAC,MAAM,EAAE,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAT5B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IACtC,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;gBAGjB,IAAI,EAAE,UAAU,EACxB,MAAM,EAAE,eAAe,EACf,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,CAAC,MAAM,EAAE,qBAAqB,GAAG,SAAS,KAAK,IAAI;IAQjF;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAMxC;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,MAAM,GAAE,yBAA8B,GAAG,IAAI;IAMpD;;;;;;;OAOG;IACH,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAEtC;;;;;;;;OAQG;IACH,UAAU,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,IAAI;IAE/C;;;;;;;OAOG;IACH,UAAU,IAAI,IAAI;IAElB;;;;;;OAMG;IACH,QAAQ,IAAI,IAAI;CACjB;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,UAAU,GAAG,UAAU,EAC/B,MAAM,EAAE,MAAM;IAAE,SAAS,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,qBAAqB,CAAA;CAAE,GACxG,gBAAgB,CAiClB"}

package/dist/creator3/core/client.js

@@ -1,6 +1,6 @@
 import { FTSessionReplay } from './replay.js';
 import { FT_COCOS_REPLAY_VERSION } from './version.js';
-import { replayImagePolicy, captureFps, samplingRate } from './validation.js';
+import { replayImagePolicy, captureFps, validatedReplaySamplingConfig } from './validation.js';
 /** Typed Replay facade; the supplied base SDK continues to own lifecycle state. */
 export class FTCocosReplaySDK {
     constructor(base, replay, capture, configure) {
@@ -13,6 +13,18 @@ export class FTCocosReplaySDK {
         this.logger = base.logger;
         this.trace = base.trace;
     }
+    /**
+     * Initializes the base SDK and configured modules for a standalone Cocos app.
+     * Supplying `config.replay` also enables native Session Replay and starts
+     * canvas capture. Omitting it does not start Replay.
+     *
+     * Call once during application startup, after composing with withSessionReplay.
+     * Do not combine with {@link attach}, which requires a native host-owned SDK.
+     *
+     * @param config - Base SDK settings, optional modules, and Replay settings.
+     * @throws If the SDK is already started or attached, Replay settings are
+     * invalid, or the required native Replay integration is unavailable.
+     */
     start(config) {
         const { replay, ...base } = config;
         this.configure(replay);
@@ -23,6 +35,19 @@ export class FTCocosReplaySDK {
             this.configure(undefined);
         }
     }
+    /**
+     * Attaches Cocos tracking to an SDK initialized by the native Hybrid host.
+     * Supplying `config.replay` prepares canvas capture for {@link enterCocos};
+     * capture does not start until that method is called. The native host owns
+     * native SDK and Replay initialization, including sampling settings.
+     *
+     * Call before the first {@link enterCocos}. Repeated calls after attachment
+     * have no effect and do not update the configuration.
+     *
+     * @param config - Optional Cocos automatic tracking and Hybrid Replay settings.
+     * @throws If standalone initialization has already started, Replay settings
+     * are invalid, or the required native Replay integration is unavailable.
+     */
     attach(config = {}) {
         const { replay, ...base } = config;
         this.configure(replay);
@@ -33,9 +58,41 @@ export class FTCocosReplaySDK {
             this.configure(undefined);
         }
     }
+    /**
+     * Selects the Cocos camera used for subsequent Session Replay captures.
+     * Update it when changing scenes if the selected camera belongs to the old
+     * scene. Selecting a camera does not start Replay capture.
+     *
+     * @param camera - A Camera component from the matching Creator engine in the
+     * active scene, or null/undefined to restore automatic camera selection.
+     */
     setReplayCamera(camera) { this.capture.setCamera(camera); }
+    /**
+     * Starts Cocos automatic tracking and any Replay capture enabled by
+     * {@link attach} in Hybrid mode. Repeated calls while entered have no effect.
+     *
+     * @param options - Options for the Cocos view being entered. Supply `viewName`
+     * when automatic scene tracking is disabled.
+     * @throws If the SDK is not attached in Hybrid mode, the required view name
+     * is missing, or tracking or Replay startup fails.
+     */
     enterCocos(options) { this.base.enterCocos(options); }
+    /**
+     * Stops Cocos automatic tracking and Hybrid Replay capture while keeping the
+     * native host SDK running. Call {@link enterCocos} to resume Cocos tracking.
+     * Has no effect before attachment or when Cocos has already been left.
+     *
+     * @throws If the SDK was started in standalone mode, or tracking or Replay
+     * cleanup fails.
+     */
     leaveCocos() { this.base.leaveCocos(); }
+    /**
+     * Stops standalone Cocos tracking, Session Replay, and the base native SDK.
+     * Has no effect if the base SDK is idle. Hybrid applications must use
+     * {@link leaveCocos} because the native host owns SDK shutdown.
+     *
+     * @throws If the SDK is attached in Hybrid mode or shutdown cleanup fails.
+     */
     shutdown() { this.base.shutdown(); }
 }
 export function composeSessionReplay(base, engine, create) {
@@ -54,8 +111,7 @@ export function composeSessionReplay(base, engine, create) {
                     if (pending === undefined)
                         return;
                     validateConfig(pending);
-                    samplingRate(pending.sampleRate, 'replay.sampleRate');
-                    samplingRate(pending.sessionOnErrorSampleRate, 'replay.sessionOnErrorSampleRate');
+                    validatedReplaySamplingConfig(pending);
                     validateNativeReplay(transport, false);
                 },
                 afterStart: () => { if (pending !== undefined)

package/dist/creator3/core/client.js.map

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

package/dist/creator3/core/replay-diagnostics.d.ts

@@ -1,9 +1,7 @@
-export type FTReplaySkipReason = 'dedupe' | 'approx_static' | 'throttle' | 'budget' | 'busy' | 'error';
+export type FTReplaySkipReason = 'dedupe' | 'approx_static' | 'image_rejected' | 'busy' | 'error';
 export type FTReplayDiagnosticEvent = {
     type: 'capture_attempt';
     timestamp: number;
-    usedBytes: number;
-    maxBytesPerMinute: number;
 } | {
     type: 'capture_skipped';
     timestamp: number;
@@ -11,12 +9,12 @@ export type FTReplayDiagnosticEvent = {
 } | {
     type: 'image_saved';
     timestamp: number;
-    byteSize: number;
+    byteSize?: number;
     width: number;
     height: number;
     mimeType?: string;
     priority: boolean;
-    byteSizeSource: 'native' | 'frame_limit_estimate';
+    byteSizeSource: 'native' | 'unavailable';
 } | {
     type: 'segment_encoded';
     timestamp: number;

package/dist/creator3/core/replay-diagnostics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"replay-diagnostics.d.ts","sourceRoot":"","sources":["../../../../../src/session-replay/core/replay-diagnostics.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,eAAe,GACf,UAAU,GACV,QAAQ,GACR,MAAM,GACN,OAAO,CAAC;AAEZ,MAAM,MAAM,uBAAuB,GAC/B;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,GAC5F;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAA;CAAE,GAC1E;IACA,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,QAAQ,GAAG,sBAAsB,CAAC;CACnD,GACC;IACA,IAAI,EAAE,iBAAiB,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,OAAO,CAAC;CACnB,GACC;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAAA;CAAE,GAClF;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAmBlD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAiB1D"}
+{"version":3,"file":"replay-diagnostics.d.ts","sourceRoot":"","sources":["../../../../../src/session-replay/core/replay-diagnostics.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,eAAe,GACf,gBAAgB,GAChB,MAAM,GACN,OAAO,CAAC;AAEZ,MAAM,MAAM,uBAAuB,GAC/B;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAA;CAAE,GAC1E;IACA,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,QAAQ,GAAG,aAAa,CAAC;CAC1C,GACC;IACA,IAAI,EAAE,iBAAiB,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,OAAO,CAAC;CACnB,GACC;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAAA;CAAE,GAClF;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAmBlD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAiB1D"}

package/dist/creator3/core/replay-diagnostics.js.map

@@ -1 +1 @@
-{"version":3,"file":"replay-diagnostics.js","sourceRoot":"","sources":["../../../../../src/session-replay/core/replay-diagnostics.ts"],"names":[],"mappings":"AAsCA,gFAAgF;AAChF,MAAM,UAAU,oBAAoB,CAAC,KAA8B;IACjE,MAAM,QAAQ,GAAI,UAAuC,CAAC,sCAAsC,CAAC;IACjG,IAAI,OAAO,QAAQ,KAAK,UAAU;QAAE,OAAO;IAC3C,IAAI,CAAC;QACH,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC;IAAC,WAAM,CAAC;QACP,sEAAsE;IACxE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,IAAI,GAAG,IAAI;YAAE,KAAK,IAAI,CAAC,CAAC;aACvB,IAAI,IAAI,GAAG,KAAK;YAAE,KAAK,IAAI,CAAC,CAAC;aAC7B,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,IAAI,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YACtE,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YACxC,IAAI,GAAG,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,EAAE,CAAC;gBACnC,KAAK,IAAI,CAAC,CAAC;gBACX,KAAK,IAAI,CAAC,CAAC;YACb,CAAC;iBAAM,CAAC;gBACN,KAAK,IAAI,CAAC,CAAC;YACb,CAAC;QACH,CAAC;;YAAM,KAAK,IAAI,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"replay-diagnostics.js","sourceRoot":"","sources":["../../../../../src/session-replay/core/replay-diagnostics.ts"],"names":[],"mappings":"AAqCA,gFAAgF;AAChF,MAAM,UAAU,oBAAoB,CAAC,KAA8B;IACjE,MAAM,QAAQ,GAAI,UAAuC,CAAC,sCAAsC,CAAC;IACjG,IAAI,OAAO,QAAQ,KAAK,UAAU;QAAE,OAAO;IAC3C,IAAI,CAAC;QACH,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC;IAAC,WAAM,CAAC;QACP,sEAAsE;IACxE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,IAAI,GAAG,IAAI;YAAE,KAAK,IAAI,CAAC,CAAC;aACvB,IAAI,IAAI,GAAG,KAAK;YAAE,KAAK,IAAI,CAAC,CAAC;aAC7B,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,IAAI,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YACtE,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YACxC,IAAI,GAAG,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,EAAE,CAAC;gBACnC,KAAK,IAAI,CAAC,CAAC;gBACX,KAAK,IAAI,CAAC,CAAC;YACb,CAAC;iBAAM,CAAC;gBACN,KAAK,IAAI,CAAC,CAAC;YACb,CAAC;QACH,CAAC;;YAAM,KAAK,IAAI,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/creator3/core/replay-encoding.d.ts

@@ -2,11 +2,13 @@ import type { FTRUMContext } from './types.js';
 export interface FTReplayImageRecord {
     context: FTRUMContext;
     resourceId: string;
+    /** Logical display bounds, independent of the resource's encoded pixels. */
     width: number;
     height: number;
     mimeType?: `image/${string}`;
     timestamp: number;
     contextChanged: boolean;
+    viewportChanged?: boolean;
     pointerEvents?: FTReplayPointerRecord[];
 }
 export interface FTReplayPointerRecord {

package/dist/creator3/core/replay-encoding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"replay-encoding.d.ts","sourceRoot":"","sources":["../../../../../src/session-replay/core/replay-encoding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,YAAY,CAAC;IACtB,aAAa,EAAE,qBAAqB,EAAE,CAAC;CACxC;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,mBAAmB,GAAG;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,CAiCA;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,sBAAsB,GAAG;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,CAMA"}
+{"version":3,"file":"replay-encoding.d.ts","sourceRoot":"","sources":["../../../../../src/session-replay/core/replay-encoding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,YAAY,CAAC;IACtB,aAAa,EAAE,qBAAqB,EAAE,CAAC;CACxC;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,mBAAmB,GAAG;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,CAiCA;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,sBAAsB,GAAG;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,CAMA"}

package/dist/creator3/core/replay-encoding.js

@@ -16,8 +16,11 @@ export function encodeReplayImageRecord(input) {
         shapeStyle: null,
     };
     const records = [];
+    if (input.contextChanged || input.viewportChanged) {
+        records.push({ type: 4, data: { width: input.width, height: input.height }, timestamp: input.timestamp });
+    }
     if (input.contextChanged) {
-        records.push({ type: 4, data: { width: input.width, height: input.height }, timestamp: input.timestamp }, { type: 6, data: { has_focus: true }, timestamp: input.timestamp });
+        records.push({ type: 6, data: { has_focus: true }, timestamp: input.timestamp });
     }
     records.push({
         type: 10,

package/dist/creator3/core/replay-encoding.js.map

@@ -1 +1 @@
-{"version":3,"file":"replay-encoding.js","sourceRoot":"","sources":["../../../../../src/session-replay/core/replay-encoding.ts"],"names":[],"mappings":"AA0BA,MAAM,UAAU,uBAAuB,CAAC,KAA0B;;IAIhE,MAAM,SAAS,GAAG;QAChB,EAAE,EAAE,CAAC;QACL,IAAI,EAAE,OAAO;QACb,CAAC,EAAE,CAAC;QACJ,CAAC,EAAE,CAAC;QACJ,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,IAAI;QACZ,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,KAAK;QACd,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,UAAU,EAAE,IAAI;KACjB,CAAC;IACF,MAAM,OAAO,GAAc,EAAE,CAAC;IAC9B,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,CACV,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,EAC3F,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CACnE,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,IAAI,CAAC;QACX,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,EAAE,UAAU,EAAE,CAAC,SAAS,CAAC,EAAE;QACjC,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC,CAAC;IACH,OAAO,CAAC,IAAI,CAAC,GAAG,CAAA,MAAA,KAAK,CAAC,aAAa,0CAAE,GAAG,CAAC,aAAa,CAAC,KAAI,EAAE,CAAC,CAAC;IAC/D,OAAO;QACL,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC;QAC/C,WAAW,EAAE,OAAO,CAAC,MAAM;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,KAA6B;IAItE,MAAM,OAAO,GAAG,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACvD,OAAO;QACL,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC;QAC/C,WAAW,EAAE,OAAO,CAAC,MAAM;KAC5B,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,OAA8B;IACnD,OAAO;QACL,IAAI,EAAE,EAAE;QACR,IAAI,EAAE;YACJ,MAAM,EAAE,CAAC;YACT,gBAAgB,EAAE,OAAO,CAAC,SAAS;YACnC,WAAW,EAAE,OAAO;YACpB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,CAAC,EAAE,OAAO,CAAC,CAAC;YACZ,CAAC,EAAE,OAAO,CAAC,CAAC;SACb;QACD,SAAS,EAAE,OAAO,CAAC,SAAS;KAC7B,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,OAAqB,EAAE,OAAkB;IAC/D,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,OAAO;QACP,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"replay-encoding.js","sourceRoot":"","sources":["../../../../../src/session-replay/core/replay-encoding.ts"],"names":[],"mappings":"AA4BA,MAAM,UAAU,uBAAuB,CAAC,KAA0B;;IAIhE,MAAM,SAAS,GAAG;QAChB,EAAE,EAAE,CAAC;QACL,IAAI,EAAE,OAAO;QACb,CAAC,EAAE,CAAC;QACJ,CAAC,EAAE,CAAC;QACJ,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,IAAI;QACZ,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,KAAK;QACd,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,UAAU,EAAE,IAAI;KACjB,CAAC;IACF,MAAM,OAAO,GAAc,EAAE,CAAC;IAC9B,IAAI,KAAK,CAAC,cAAc,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;IAC5G,CAAC;IACD,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,CAAC,IAAI,CAAC;QACX,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,EAAE,UAAU,EAAE,CAAC,SAAS,CAAC,EAAE;QACjC,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC,CAAC;IACH,OAAO,CAAC,IAAI,CAAC,GAAG,CAAA,MAAA,KAAK,CAAC,aAAa,0CAAE,GAAG,CAAC,aAAa,CAAC,KAAI,EAAE,CAAC,CAAC;IAC/D,OAAO;QACL,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC;QAC/C,WAAW,EAAE,OAAO,CAAC,MAAM;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,KAA6B;IAItE,MAAM,OAAO,GAAG,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACvD,OAAO;QACL,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC;QAC/C,WAAW,EAAE,OAAO,CAAC,MAAM;KAC5B,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,OAA8B;IACnD,OAAO;QACL,IAAI,EAAE,EAAE;QACR,IAAI,EAAE;YACJ,MAAM,EAAE,CAAC;YACT,gBAAgB,EAAE,OAAO,CAAC,SAAS;YACnC,WAAW,EAAE,OAAO;YACpB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,CAAC,EAAE,OAAO,CAAC,CAAC;YACZ,CAAC,EAAE,OAAO,CAAC,CAAC;SACb;QACD,SAAS,EAAE,OAAO,CAAC,SAAS;KAC7B,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,OAAqB,EAAE,OAAkB;IAC/D,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,OAAO;QACP,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;AACL,CAAC"}

package/dist/creator3/core/replay.d.ts

@@ -8,6 +8,8 @@ export interface FTCanvasCapture {
     capture(maxImageDimension: number): Promise<FTCapturedFrame | undefined>;
     persist(frame: FTCapturedFrame, fingerprint: string): Promise<FTStoredFrame>;
     disposeStoredFrame(frame: FTStoredFrame): void | Promise<void>;
+    /** Cancel pending GPU capture and release reusable capture resources. */
+    dispose?(): void;
     setPrivacy(node: unknown, mode: 'mask' | 'hide' | 'unmask'): void;
 }
 export interface FTReplayPointerEvent {
@@ -47,13 +49,12 @@ export declare class FTSessionReplay {
     private captureGeneration;
     private config;
     private imagePolicy;
-    private budget;
     private lastFingerprint;
     private lastContextKey;
     private lastPrivacyKey;
     private lastFrameSample;
     private lastImageTimestamp;
-    private lastImageSize;
+    private lastDisplaySize;
     private lastViewportSize;
     private imagePolicyEnabled;
     private supportsSaveImageV2;

package/dist/creator3/core/replay.d.ts.map

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

package/dist/creator3/core/replay.js

@@ -1,7 +1,6 @@
 import { encodeReplayImageRecord, encodeReplayPointerRecords, } from './replay-encoding.js';
-import { FTReplayBudget } from './replay-budget.js';
 import { emitReplayDiagnostic, replayUtf8ByteLength } from './replay-diagnostics.js';
-import { captureFps, replayImagePolicy, samplingRate, } from './validation.js';
+import { captureFps, replayImagePolicy, validatedReplaySamplingConfig, } from './validation.js';
 const MAX_PENDING_POINTER_EVENTS = 512;
 // Approximate comparisons must not hide small animations indefinitely.
 const MAX_APPROXIMATE_STATIC_MS = 2000;
@@ -20,7 +19,6 @@ export class FTSessionReplay {
         this.captureGeneration = 0;
         this.config = { captureFps: 1 };
         this.imagePolicy = replayImagePolicy({});
-        this.budget = new FTReplayBudget(this.imagePolicy);
         this.imagePolicyEnabled = false;
         this.recordCounts = new Map();
         this.recordTouches = false;
@@ -39,11 +37,10 @@ export class FTSessionReplay {
         }
         if (this.mode === 'standalone')
             return;
-        samplingRate(config.sampleRate, 'replay.sampleRate');
-        samplingRate(config.sessionOnErrorSampleRate, 'replay.sessionOnErrorSampleRate');
-        this.configureCapture(config);
+        const payload = validatedReplaySamplingConfig(config);
+        this.configureCapture(payload);
         (_a = this.validateNative) === null || _a === void 0 ? void 0 : _a.call(this);
-        this.transport.invoke('replay.configure', config);
+        this.transport.invoke('replay.configure', payload);
         this.mode = 'standalone';
         this.startCapture();
     }
@@ -89,7 +86,6 @@ export class FTSessionReplay {
         }
         this.config = { captureFps: captureFps(config.captureFps) };
         this.imagePolicy = replayImagePolicy(config);
-        this.budget = new FTReplayBudget(this.imagePolicy);
         // Lossy image MIME must be validated against the deployed player before
         // becoming an implicit default. Supplying imagePolicy opts into V2 now.
         this.imagePolicyEnabled = config.imagePolicy !== undefined;
@@ -131,7 +127,7 @@ export class FTSessionReplay {
         this.busy = true;
         let stored;
         let context;
-        let pointerSize = this.lastImageSize;
+        let pointerSize = this.lastDisplaySize;
         try {
             context = this.readContext();
             if (!context)
@@ -143,33 +139,28 @@ export class FTSessionReplay {
                 && viewportSize !== undefined
                 && (viewportSize.width !== this.lastViewportSize.width
                     || viewportSize.height !== this.lastViewportSize.height);
-            const priorityKey = contextChanged
-                ? contextKey
-                : viewportChanged && viewportSize
-                    ? `${contextKey}:${viewportSize.width}x${viewportSize.height}`
-                    : undefined;
+            // Do not send coordinates for a new viewport before its image and
+            // metadata have been accepted. Keep pending touches for that capture.
+            if (contextChanged || viewportChanged)
+                pointerSize = undefined;
             const now = Date.now();
-            const decision = this.budget.decide(now, priorityKey);
             emitReplayDiagnostic({
                 type: 'capture_attempt',
                 timestamp: now,
-                usedBytes: decision.usedBytes,
-                maxBytesPerMinute: this.imagePolicy.maxBytesPerMinute,
             });
-            if (!decision.allowed) {
-                emitReplayDiagnostic({
-                    type: 'capture_skipped',
-                    timestamp: now,
-                    reason: decision.reason || 'budget',
-                });
-                return pointerSize ? this.writePendingPointers(context, pointerSize.width, pointerSize.height) : false;
-            }
-            const frame = await this.capture.capture(decision.maxImageDimension);
+            const frame = await this.capture.capture(this.imagePolicy.maxImageDimension);
             if (generation !== this.captureGeneration)
                 return false;
             if (!frame)
                 return false;
-            pointerSize = { width: frame.width, height: frame.height };
+            // Native encoding may shrink the resource to meet the per-image limit, but
+            // the replay canvas, image bounds and touch coordinates stay in one
+            // logical space based on the configured maximum size.
+            const displaySize = viewportSize
+                ? scaledReplayViewport(viewportSize, this.imagePolicy.maxImageDimension)
+                : this.lastDisplaySize
+                    ? this.lastDisplaySize
+                    : { width: frame.width, height: frame.height };
             applyPrivacyRegions(frame.rgba, frame.width, frame.height, frame.privacyRegions || []);
             const fingerprint = frameFingerprint(frame.rgba);
             const privacyKey = privacyRegionsKey(frame.privacyRegions || []);
@@ -191,27 +182,28 @@ export class FTSessionReplay {
                     timestamp: now,
                     reason: duplicate ? 'dedupe' : 'approx_static',
                 });
-                return this.writePendingPointers(context, frame.width, frame.height);
+                return pointerSize ? this.writePendingPointers(context, pointerSize.width, pointerSize.height) : false;
             }
             stored = await this.capture.persist(frame, fingerprint);
             if (generation !== this.captureGeneration)
                 return false;
-            const saved = await this.saveImage(stored, decision.compressionQuality, decision.maxFrameBytes);
+            const saved = await this.saveImage(stored, this.imagePolicy.compressionQuality, this.imagePolicy.maxFrameBytes);
             if (generation !== this.captureGeneration)
                 return false;
             if (!saved) {
-                emitReplayDiagnostic({ type: 'capture_skipped', timestamp: now, reason: 'budget' });
-                return this.writePendingPointers(context, frame.width, frame.height);
+                emitReplayDiagnostic({ type: 'capture_skipped', timestamp: now, reason: 'image_rejected' });
+                return pointerSize ? this.writePendingPointers(context, pointerSize.width, pointerSize.height) : false;
             }
-            const pendingPointers = this.scaledPendingPointers(saved.width, saved.height);
+            const pendingPointers = this.scaledPendingPointers(displaySize.width, displaySize.height);
             const encoded = encodeReplayImageRecord({
                 context,
                 resourceId: saved.resourceId,
-                width: saved.width,
-                height: saved.height,
+                width: displaySize.width,
+                height: displaySize.height,
                 ...(saved.mimeType ? { mimeType: saved.mimeType } : {}),
                 timestamp: stored.timestamp,
                 contextChanged,
+                viewportChanged,
                 pointerEvents: pendingPointers,
             });
             this.transport.invoke('replay.writeSegment', {
@@ -228,7 +220,6 @@ export class FTSessionReplay {
             });
             this.updateRecordCount(context.viewId, encoded.recordCount);
             this.pendingPointerEvents.splice(0, pendingPointers.length);
-            this.budget.record(now, saved.byteSize, priorityKey);
             emitReplayDiagnostic({
                 type: 'image_saved',
                 timestamp: now,
@@ -236,7 +227,7 @@ export class FTSessionReplay {
                 width: saved.width,
                 height: saved.height,
                 ...(saved.mimeType ? { mimeType: saved.mimeType } : {}),
-                priority: decision.priority,
+                priority: contextChanged || viewportChanged,
                 byteSizeSource: saved.byteSizeSource,
             });
             this.lastFingerprint = fingerprint;
@@ -244,7 +235,7 @@ export class FTSessionReplay {
             this.lastPrivacyKey = privacyKey;
             this.lastFrameSample = sample;
             this.lastImageTimestamp = now;
-            this.lastImageSize = { width: saved.width, height: saved.height };
+            this.lastDisplaySize = displaySize;
             this.lastViewportSize = viewportSize;
             return true;
         }
@@ -281,9 +272,8 @@ export class FTSessionReplay {
         this.lastPrivacyKey = undefined;
         this.lastFrameSample = undefined;
         this.lastImageTimestamp = undefined;
-        this.lastImageSize = undefined;
+        this.lastDisplaySize = undefined;
         this.lastViewportSize = undefined;
-        this.budget.reset();
         this.recordCounts.clear();
         this.pendingPointerEvents = [];
         if (this.recordTouches && this.pointerSource) {
@@ -302,7 +292,7 @@ export class FTSessionReplay {
         this.schedule(0, this.captureGeneration);
     }
     stopCapture() {
-        var _a;
+        var _a, _b, _c;
         const wasRunning = this.running;
         this.captureGeneration += 1;
         this.running = false;
@@ -312,6 +302,7 @@ export class FTSessionReplay {
         if (this.timer !== undefined)
             clearTimeout(this.timer);
         this.timer = undefined;
+        (_c = (_b = this.capture).dispose) === null || _c === void 0 ? void 0 : _c.call(_b);
         if (wasRunning)
             emitReplayDiagnostic({ type: 'replay_stopped', timestamp: Date.now() });
     }
@@ -321,6 +312,7 @@ export class FTSessionReplay {
         this.timer = setTimeout(async () => {
             if (!this.running || generation !== this.captureGeneration)
                 return;
+            const startedAt = Date.now();
             try {
                 await this.captureNow();
             }
@@ -329,7 +321,12 @@ export class FTSessionReplay {
             }
             finally {
                 if (this.running && generation === this.captureGeneration) {
-                    this.schedule(1000 / this.config.captureFps, generation);
+                    // Encoding and file cleanup are part of the frame interval. Keep one
+                    // frame in flight and skip missed slots instead of accumulating work.
+                    const interval = 1000 / this.config.captureFps;
+                    const elapsed = Math.max(0, Date.now() - startedAt);
+                    const slots = Math.max(1, Math.ceil(elapsed / interval));
+                    this.schedule(Math.max(0, slots * interval - elapsed), generation);
                 }
             }
         }, delay);
@@ -339,28 +336,37 @@ export class FTSessionReplay {
         return normalizeRumContext(value);
     }
     async saveImage(stored, compressionQuality, maxFrameBytes) {
-        if (this.imagePolicyEnabled && this.supportsSaveImageV2 !== false) {
-            try {
-                const value = await this.invokeSaveImage('replay.saveImageV2', {
-                    path: stored.path,
-                    width: stored.width,
-                    height: stored.height,
-                    quality: compressionQuality,
-                    maxFrameBytes,
-                });
-                if (value !== undefined) {
-                    this.supportsSaveImageV2 = true;
-                    if (isRejectedSaveImageV2(value))
-                        return undefined;
-                    return { ...normalizeSaveImageV2Result(value), byteSizeSource: 'native' };
+        if (this.imagePolicyEnabled) {
+            if (this.supportsSaveImageV2 !== false) {
+                try {
+                    const value = await this.invokeSaveImage('replay.saveImageV2', {
+                        path: stored.path,
+                        width: stored.width,
+                        height: stored.height,
+                        quality: compressionQuality,
+                        maxFrameBytes,
+                    });
+                    if (value !== undefined) {
+                        this.supportsSaveImageV2 = true;
+                        if (isRejectedSaveImageV2(value))
+                            return undefined;
+                        const result = normalizeSaveImageV2Result(value);
+                        if (result.byteSize > maxFrameBytes) {
+                            throw new RangeError('Native replay image exceeded imagePolicy.maxFrameBytes');
+                        }
+                        return { ...result, byteSizeSource: 'native' };
+                    }
+                    this.supportsSaveImageV2 = false;
+                }
+                catch (error) {
+                    if (!isUnknownBridgeMethod(error))
+                        throw error;
+                    this.supportsSaveImageV2 = false;
                 }
-                this.supportsSaveImageV2 = false;
-            }
-            catch (error) {
-                if (!isUnknownBridgeMethod(error))
-                    throw error;
-                this.supportsSaveImageV2 = false;
             }
+            // V1 cannot enforce encoded size. Never silently discard a caller's
+            // explicit image policy by falling back to unbounded image storage.
+            throw new Error('Replay imagePolicy requires replay.saveImageV2. Upgrade the native Replay SDK and rebuild the native project.');
         }
         const resourceId = await this.invokeSaveImage('replay.saveImage', {
             path: stored.path,
@@ -371,12 +377,10 @@ export class FTSessionReplay {
             return undefined;
         return {
             resourceId,
-            // V1 cannot report encoded size. A conservative frame-limit estimate
-            // still prevents configured captureFps from multiplying traffic freely.
-            byteSize: maxFrameBytes,
             width: stored.width,
             height: stored.height,
-            byteSizeSource: 'frame_limit_estimate',
+            // Legacy storage does not report actual bytes; do not invent traffic.
+            byteSizeSource: 'unavailable',
             ...(this.transport.platform === 'ios' ? { mimeType: 'image/png' } : {}),
         };
     }
@@ -421,6 +425,13 @@ export class FTSessionReplay {
         this.transport.invoke('replay.setRecordCount', { viewId, count });
     }
 }
+function scaledReplayViewport(size, maxDimension) {
+    const scale = Math.min(1, maxDimension / Math.max(size.width, size.height));
+    return {
+        width: Math.max(1, Math.round(size.width * scale)),
+        height: Math.max(1, Math.round(size.height * scale)),
+    };
+}
 function normalizeRumContext(value) {
     if (!value || typeof value !== 'object')
         return undefined;