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

package/dist/creator2/creator2/transport.d.ts

@@ -0,0 +1,8 @@
+import { type FTNativeTransport } from '../core/transport.js';
+import type { FTValue } from '@cloudcare/cocos-sdk/plugin-api';
+export declare class FTCreator2ReplayTransport implements FTNativeTransport {
+    readonly platform: 'android' | 'ios' | 'unsupported';
+    invokeAsync<T = FTValue>(method: string, payload?: unknown): Promise<T | undefined>;
+    invoke<T = FTValue>(method: string, payload?: unknown): T | undefined;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/creator2/creator2/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../../../src/session-replay/creator2/transport.ts"],"names":[],"mappings":"AACA,OAAO,EAA0B,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACtF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAE/D,qBAAa,yBAA0B,YAAW,iBAAiB;IACjE,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,KAAK,GAAG,aAAa,CAA6B;IAEjF,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAInF,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,CAAC,GAAG,SAAS;CActE"}

package/dist/creator2/creator2/transport.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FTCreator2ReplayTransport = void 0;
+var replay_async_transport_js_1 = require("../core/replay-async-transport.js");
+var transport_js_1 = require("../core/transport.js");
+var FTCreator2ReplayTransport = /** @class */ (function () {
+    function FTCreator2ReplayTransport() {
+        this.platform = resolveCreator2Platform();
+    }
+    FTCreator2ReplayTransport.prototype.invokeAsync = function (method, payload) {
+        return (0, replay_async_transport_js_1.invokeReplayAsync)(this, method, payload);
+    };
+    FTCreator2ReplayTransport.prototype.invoke = function (method, payload) {
+        if (this.platform === 'unsupported')
+            return undefined;
+        var json = payload === undefined ? '{}' : JSON.stringify(payload);
+        var raw = this.platform === 'android'
+            ? jsb.reflection.callStaticMethod('com/ft/sdk/cocos/FTCocosReplayBridge', 'invoke', '(Ljava/lang/String;Ljava/lang/String;)Ljava/lang/String;', method, json)
+            : jsb.reflection.callStaticMethod('FTCocosReplayBridge', 'invoke:payload:', method, json);
+        return (0, transport_js_1.parseTransportResponse)(raw);
+    };
+    return FTCreator2ReplayTransport;
+}());
+exports.FTCreator2ReplayTransport = FTCreator2ReplayTransport;
+function resolveCreator2Platform() {
+    var _a, _b;
+    var isNative = (typeof CC_JSB !== 'undefined' && CC_JSB) || typeof jsb !== 'undefined';
+    if (!isNative)
+        return 'unsupported';
+    if ((typeof CC_ANDROID !== 'undefined' && CC_ANDROID)
+        || (typeof cc !== 'undefined' && ((_a = cc.sys) === null || _a === void 0 ? void 0 : _a.os) === cc.sys.OS_ANDROID))
+        return 'android';
+    if ((typeof CC_IOS !== 'undefined' && CC_IOS)
+        || (typeof cc !== 'undefined' && ((_b = cc.sys) === null || _b === void 0 ? void 0 : _b.os) === cc.sys.OS_IOS))
+        return 'ios';
+    return 'unsupported';
+}
+//# sourceMappingURL=transport.js.map

package/dist/creator2/creator2/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../../../src/session-replay/creator2/transport.ts"],"names":[],"mappings":";;;AAAA,+EAAsE;AACtE,qDAAsF;AAGtF;IAAA;QACW,aAAQ,GAAsC,uBAAuB,EAAE,CAAC;IAoBnF,CAAC;IAlBC,+CAAW,GAAX,UAAyB,MAAc,EAAE,OAAiB;QACxD,OAAO,IAAA,6CAAiB,EAAI,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IAED,0CAAM,GAAN,UAAoB,MAAc,EAAE,OAAiB;QACnD,IAAI,IAAI,CAAC,QAAQ,KAAK,aAAa;YAAE,OAAO,SAAS,CAAC;QACtD,IAAM,IAAI,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACpE,IAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,KAAK,SAAS;YACrC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAC7B,sCAAsC,EACtC,QAAQ,EACR,0DAA0D,EAC1D,MAAM,EACN,IAAI,CACL;YACH,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAAC,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QAC5F,OAAO,IAAA,qCAAsB,EAAI,GAAG,CAAC,CAAC;IACxC,CAAC;IACH,gCAAC;AAAD,CAAC,AArBD,IAqBC;AArBY,8DAAyB;AAuBtC,SAAS,uBAAuB;;IAC9B,IAAM,QAAQ,GAAG,CAAC,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,IAAI,OAAO,GAAG,KAAK,WAAW,CAAC;IACzF,IAAI,CAAC,QAAQ;QAAE,OAAO,aAAa,CAAC;IACpC,IACE,CAAC,OAAO,UAAU,KAAK,WAAW,IAAI,UAAU,CAAC;WAC9C,CAAC,OAAO,EAAE,KAAK,WAAW,IAAI,CAAA,MAAA,EAAE,CAAC,GAAG,0CAAE,EAAE,MAAK,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC;QAClE,OAAO,SAAS,CAAC;IACnB,IACE,CAAC,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC;WACtC,CAAC,OAAO,EAAE,KAAK,WAAW,IAAI,CAAA,MAAA,EAAE,CAAC,GAAG,0CAAE,EAAE,MAAK,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC;QAC9D,OAAO,KAAK,CAAC;IACf,OAAO,aAAa,CAAC;AACvB,CAAC"}

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

@@ -0,0 +1,30 @@
+import type { FTCocosSDK, FTNativeTransport, FTCocosEnterOptions } from '@cloudcare/cocos-sdk/plugin-api';
+import { FTSessionReplay, type FTCanvasCapture, type FTReplayPointerSource } from './replay.js';
+import type { FTCocosReplayConfig, FTCocosHybridReplayConfig, FTSessionReplayConfig } from './types.js';
+export interface FTReplayCapture extends FTCanvasCapture {
+    setCamera(camera: unknown): void;
+}
+/** Typed Replay facade; the supplied base SDK continues to own lifecycle state. */
+export declare class FTCocosReplaySDK {
+    private readonly base;
+    readonly replay: FTSessionReplay;
+    private readonly capture;
+    private readonly configure;
+    readonly mobile: FTCocosSDK['mobile'];
+    readonly rum: FTCocosSDK['rum'];
+    readonly logger: FTCocosSDK['logger'];
+    readonly trace: FTCocosSDK['trace'];
+    constructor(base: FTCocosSDK, replay: FTSessionReplay, capture: FTReplayCapture, configure: (config: FTSessionReplayConfig | undefined) => void);
+    start(config: FTCocosReplayConfig): void;
+    attach(config?: FTCocosHybridReplayConfig): void;
+    setReplayCamera(camera: unknown): void;
+    enterCocos(options?: FTCocosEnterOptions): void;
+    leaveCocos(): void;
+    shutdown(): void;
+}
+export declare function composeSessionReplay(base: FTCocosSDK, engine: 'creator2' | 'creator3', create: () => {
+    transport: FTNativeTransport;
+    capture: FTReplayCapture;
+    pointers: FTReplayPointerSource;
+}): FTCocosReplaySDK;
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +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"}

package/dist/creator3/core/client.js

@@ -0,0 +1,97 @@
+import { FTSessionReplay } from './replay.js';
+import { FT_COCOS_REPLAY_VERSION } from './version.js';
+import { replayImagePolicy, captureFps, samplingRate } from './validation.js';
+/** Typed Replay facade; the supplied base SDK continues to own lifecycle state. */
+export class FTCocosReplaySDK {
+    constructor(base, replay, capture, configure) {
+        this.base = base;
+        this.replay = replay;
+        this.capture = capture;
+        this.configure = configure;
+        this.mobile = base.mobile;
+        this.rum = base.rum;
+        this.logger = base.logger;
+        this.trace = base.trace;
+    }
+    start(config) {
+        const { replay, ...base } = config;
+        this.configure(replay);
+        try {
+            this.base.start(base);
+        }
+        finally {
+            this.configure(undefined);
+        }
+    }
+    attach(config = {}) {
+        const { replay, ...base } = config;
+        this.configure(replay);
+        try {
+            this.base.attach(base);
+        }
+        finally {
+            this.configure(undefined);
+        }
+    }
+    setReplayCamera(camera) { this.capture.setCamera(camera); }
+    enterCocos(options) { this.base.enterCocos(options); }
+    leaveCocos() { this.base.leaveCocos(); }
+    shutdown() { this.base.shutdown(); }
+}
+export function composeSessionReplay(base, engine, create) {
+    if (!base || base.extensionProtocol !== 1 || typeof base.registerExtension !== 'function') {
+        throw new Error('Upgrade @cloudcare/cocos-sdk to the matching Session Replay package version');
+    }
+    return base.registerExtension('session-replay', FT_COCOS_REPLAY_VERSION, engine, () => {
+        const { transport, capture, pointers } = create();
+        const replay = new FTSessionReplay(transport, capture, pointers, () => validateNativeReplay(transport, false));
+        let pending;
+        const facade = new FTCocosReplaySDK(base, replay, capture, config => { pending = config; });
+        return {
+            value: facade,
+            lifecycle: {
+                beforeStart: () => {
+                    if (pending === undefined)
+                        return;
+                    validateConfig(pending);
+                    samplingRate(pending.sampleRate, 'replay.sampleRate');
+                    samplingRate(pending.sessionOnErrorSampleRate, 'replay.sessionOnErrorSampleRate');
+                    validateNativeReplay(transport, false);
+                },
+                afterStart: () => { if (pending !== undefined)
+                    replay.start(pending); },
+                beforeAttach: () => {
+                    if (pending !== undefined) {
+                        validateConfig(pending);
+                        validateNativeReplay(transport, true);
+                    }
+                    replay.attachHybrid(pending);
+                },
+                rollbackAttach: () => replay.detachHybrid(),
+                enter: () => replay.enterHybrid(),
+                leave: () => replay.leaveHybrid(),
+                shutdown: () => replay.stop(),
+            },
+        };
+    });
+}
+function validateConfig(config) {
+    captureFps(config.captureFps);
+    replayImagePolicy(config);
+    if (config.touchPrivacy !== undefined && config.touchPrivacy !== 'hide' && config.touchPrivacy !== 'show') {
+        throw new TypeError("touchPrivacy must be either 'show' or 'hide'");
+    }
+}
+function validateNativeReplay(transport, hybrid) {
+    if (transport.platform === 'unsupported')
+        return;
+    try {
+        const result = transport.invoke('replay.capabilities', { hybrid });
+        if ((result === null || result === void 0 ? void 0 : result.protocol) !== 1)
+            throw new Error('Native Replay bridge protocol does not match');
+    }
+    catch (error) {
+        throw new Error(`Session Replay native integration is unavailable. Run the SDK installer with --replay and rebuild the native application. ${String(error)}`);
+    }
+}
+//# sourceMappingURL=client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../../../src/session-replay/core/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAoD,MAAM,aAAa,CAAC;AAEhG,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAI9E,mFAAmF;AACnF,MAAM,OAAO,gBAAgB;IAM3B,YACmB,IAAgB,EACxB,MAAuB,EACf,OAAwB,EACxB,SAA8D;QAH9D,SAAI,GAAJ,IAAI,CAAY;QACxB,WAAM,GAAN,MAAM,CAAiB;QACf,YAAO,GAAP,OAAO,CAAiB;QACxB,cAAS,GAAT,SAAS,CAAqD;QAE/E,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACpB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,MAA2B;QAC/B,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACnC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACvB,IAAI,CAAC;YAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAAC,CAAC;gBAAS,CAAC;YAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAAC,CAAC;IACvE,CAAC;IAED,MAAM,CAAC,SAAoC,EAAE;QAC3C,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACnC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACvB,IAAI,CAAC;YAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAAC,CAAC;gBAAS,CAAC;YAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAAC,CAAC;IACxE,CAAC;IAED,eAAe,CAAC,MAAe,IAAU,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC1E,UAAU,CAAC,OAA6B,IAAU,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAClF,UAAU,KAAW,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IAC9C,QAAQ,KAAW,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;CAC3C;AAED,MAAM,UAAU,oBAAoB,CAClC,IAAgB,EAChB,MAA+B,EAC/B,MAAyG;IAEzG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,iBAAiB,KAAK,CAAC,IAAI,OAAO,IAAI,CAAC,iBAAiB,KAAK,UAAU,EAAE,CAAC;QAC1F,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,IAAI,CAAC,iBAAiB,CAAC,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,EAAE,GAAG,EAAE;QACpF,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,CAAC;QAClD,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,oBAAoB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;QAC/G,IAAI,OAA0C,CAAC;QAC/C,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,GAAG,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5F,OAAO;YACL,KAAK,EAAE,MAAM;YACb,SAAS,EAAE;gBACT,WAAW,EAAE,GAAG,EAAE;oBAChB,IAAI,OAAO,KAAK,SAAS;wBAAE,OAAO;oBAClC,cAAc,CAAC,OAAO,CAAC,CAAC;oBACxB,YAAY,CAAC,OAAO,CAAC,UAAU,EAAE,mBAAmB,CAAC,CAAC;oBACtD,YAAY,CAAC,OAAO,CAAC,wBAAwB,EAAE,iCAAiC,CAAC,CAAC;oBAClF,oBAAoB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;gBACzC,CAAC;gBACD,UAAU,EAAE,GAAG,EAAE,GAAG,IAAI,OAAO,KAAK,SAAS;oBAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBACvE,YAAY,EAAE,GAAG,EAAE;oBACjB,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;wBAC1B,cAAc,CAAC,OAAO,CAAC,CAAC;wBACxB,oBAAoB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;oBACxC,CAAC;oBACD,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;gBAC/B,CAAC;gBACD,cAAc,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,YAAY,EAAE;gBAC3C,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE;gBACjC,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE;gBACjC,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE;aAC9B;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,cAAc,CAAC,MAAmC;IACzD,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC9B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS,IAAI,MAAM,CAAC,YAAY,KAAK,MAAM,IAAI,MAAM,CAAC,YAAY,KAAK,MAAM,EAAE,CAAC;QAC1G,MAAM,IAAI,SAAS,CAAC,8CAA8C,CAAC,CAAC;IACtE,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,SAA4B,EAAE,MAAe;IACzE,IAAI,SAAS,CAAC,QAAQ,KAAK,aAAa;QAAE,OAAO;IACjD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAuB,qBAAqB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACzF,IAAI,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,QAAQ,MAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAC9F,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,6HAA6H,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAChK,CAAC;AACH,CAAC"}

package/dist/creator3/core/replay-async-transport.d.ts

@@ -0,0 +1,4 @@
+import type { FTNativeTransport } from '@cloudcare/cocos-sdk/plugin-api';
+/** Polls a single native worker without keeping a synchronous bridge call open. */
+export declare function invokeReplayAsync<T>(transport: FTNativeTransport, method: string, payload?: unknown): Promise<T | undefined>;
+//# sourceMappingURL=replay-async-transport.d.ts.map

package/dist/creator3/core/replay-async-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay-async-transport.d.ts","sourceRoot":"","sources":["../../../../../src/session-replay/core/replay-async-transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAGzE,mFAAmF;AACnF,wBAAsB,iBAAiB,CAAC,CAAC,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CASlI"}

package/dist/creator3/core/replay-async-transport.js

@@ -0,0 +1,16 @@
+import { parseTransportResponse } from './transport.js';
+/** Polls a single native worker without keeping a synchronous bridge call open. */
+export async function invokeReplayAsync(transport, method, payload) {
+    const job = transport.invoke('replay.beginSaveImage', { method, arguments: payload });
+    if (!job)
+        throw new Error('Rebuild the native bridge to enable asynchronous Replay encoding');
+    for (;;) {
+        await new Promise((resolve) => setTimeout(resolve, 16));
+        const result = transport.invoke('replay.pollSaveImage', { job });
+        if (!result)
+            throw new Error('Replay encoding job is unavailable');
+        if (!result.pending)
+            return parseTransportResponse(result.response);
+    }
+}
+//# sourceMappingURL=replay-async-transport.js.map

package/dist/creator3/core/replay-async-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay-async-transport.js","sourceRoot":"","sources":["../../../../../src/session-replay/core/replay-async-transport.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAExD,mFAAmF;AACnF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAI,SAA4B,EAAE,MAAc,EAAE,OAAiB;IACxG,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,CAAS,uBAAuB,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;IAC9F,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;IAC9F,SAAS,CAAC;QACR,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAA0C,sBAAsB,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;QAC1G,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACnE,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO,sBAAsB,CAAI,MAAM,CAAC,QAAQ,CAAC,CAAC;IACzE,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,28 @@
+import type { FTResolvedReplayImagePolicy } from './validation.js';
+export declare const REPLAY_KEY_FRAME_BURST_BYTES: number;
+export interface FTReplayCaptureDecision {
+    allowed: boolean;
+    compressionQuality: number;
+    maxImageDimension: number;
+    maxFrameBytes: number;
+    usedBytes: number;
+    priority: boolean;
+    reason?: 'budget' | 'throttle';
+}
+/** Rolling image budget. Segment and pointer bytes intentionally remain outside this controller. */
+export declare class FTReplayBudget {
+    private readonly policy;
+    private entries;
+    private lastCaptureAttempt;
+    private burstKeys;
+    private pressure;
+    constructor(policy: FTResolvedReplayImagePolicy);
+    reset(): void;
+    decide(timestamp: number, priorityKey?: string): FTReplayCaptureDecision;
+    record(timestamp: number, byteSize: number, priorityKey?: string): void;
+    usedBytes(timestamp: number): number;
+    private prune;
+    private decision;
+    private updatePressure;
+}
+//# sourceMappingURL=replay-budget.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"replay-budget.d.ts","sourceRoot":"","sources":["../../../../../src/session-replay/core/replay-budget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAInE,eAAO,MAAM,4BAA4B,QAAa,CAAC;AAOvD,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;CAChC;AAED,oGAAoG;AACpG,qBAAa,cAAc;IAMb,OAAO,CAAC,QAAQ,CAAC,MAAM;IALnC,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,QAAQ,CAA4D;gBAE/C,MAAM,EAAE,2BAA2B;IAEhE,KAAK,IAAI,IAAI;IAOb,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,uBAAuB;IA6CxE,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAUvE,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAKpC,OAAO,CAAC,KAAK;IAKb,OAAO,CAAC,QAAQ;IA2BhB,OAAO,CAAC,cAAc;CA0BvB"}

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

@@ -0,0 +1,118 @@
+const WINDOW_MS = 60000;
+const THROTTLED_CAPTURE_INTERVAL_MS = 2000;
+export const REPLAY_KEY_FRAME_BURST_BYTES = 100 * 1024;
+/** Rolling image budget. Segment and pointer bytes intentionally remain outside this controller. */
+export class FTReplayBudget {
+    constructor(policy) {
+        this.policy = policy;
+        this.entries = [];
+        this.burstKeys = [];
+        this.pressure = 'normal';
+    }
+    reset() {
+        this.entries = [];
+        this.lastCaptureAttempt = undefined;
+        this.burstKeys = [];
+        this.pressure = 'normal';
+    }
+    decide(timestamp, priorityKey) {
+        const used = this.usedBytes(timestamp);
+        const ratio = used / this.policy.maxBytesPerMinute;
+        this.updatePressure(ratio);
+        const hasBurst = priorityKey !== undefined && !this.burstKeys.includes(priorityKey);
+        if (ratio >= 1 && !hasBurst)
+            return this.decision(false, 0, used, hasBurst, 'budget');
+        const lastImage = this.entries[this.entries.length - 1];
+        // Pace successful images from the start instead of spending most of the
+        // minute's budget in its first seconds. Reserve 10% for size variation and
+        // key frames; their existing burst allowance remains independent.
+        const sustainableInterval = lastImage
+            ? Math.min(lastImage.byteSize, this.policy.maxFrameBytes) * WINDOW_MS
+                / (this.policy.maxBytesPerMinute * 0.9)
+            : 0;
+        if (this.policy.adaptiveCapture
+            && lastImage
+            && timestamp - lastImage.timestamp < sustainableInterval
+            && !hasBurst)
+            return this.decision(false, 0, used, hasBurst, 'throttle');
+        if (this.policy.adaptiveCapture
+            && this.pressure !== 'normal'
+            && this.lastCaptureAttempt !== undefined
+            && timestamp - this.lastCaptureAttempt < THROTTLED_CAPTURE_INTERVAL_MS
+            && !hasBurst) {
+            return this.decision(false, 0, used, hasBurst, 'throttle');
+        }
+        this.lastCaptureAttempt = timestamp;
+        const normalRemaining = Math.max(0, this.policy.maxBytesPerMinute - used);
+        const available = normalRemaining + (hasBurst ? REPLAY_KEY_FRAME_BURST_BYTES : 0);
+        const frameLimit = hasBurst
+            ? Math.min(Math.max(this.policy.maxFrameBytes, REPLAY_KEY_FRAME_BURST_BYTES), available)
+            : Math.min(this.policy.maxFrameBytes, available);
+        return this.decision(frameLimit >= 1024, frameLimit, used, hasBurst, frameLimit >= 1024 ? undefined : 'budget');
+    }
+    record(timestamp, byteSize, priorityKey) {
+        if (!Number.isFinite(byteSize) || byteSize <= 0)
+            return;
+        this.prune(timestamp);
+        this.entries.push({ timestamp, byteSize: Math.round(byteSize) });
+        if (priorityKey && !this.burstKeys.includes(priorityKey)) {
+            this.burstKeys.push(priorityKey);
+            if (this.burstKeys.length > 64)
+                this.burstKeys.shift();
+        }
+    }
+    usedBytes(timestamp) {
+        this.prune(timestamp);
+        return this.entries.reduce((total, entry) => total + entry.byteSize, 0);
+    }
+    prune(timestamp) {
+        const cutoff = timestamp - WINDOW_MS;
+        while (this.entries.length > 0 && this.entries[0].timestamp <= cutoff)
+            this.entries.shift();
+    }
+    decision(allowed, maxFrameBytes, usedBytes, priority, reason) {
+        const degraded = this.policy.adaptiveCapture
+            && (this.pressure === 'degraded' || this.pressure === 'paused');
+        return {
+            allowed,
+            compressionQuality: degraded
+                ? Math.max(0.25, Math.round(this.policy.compressionQuality * 0.75 * 100) / 100)
+                : this.policy.compressionQuality,
+            maxImageDimension: degraded
+                ? Math.min(this.policy.maxImageDimension, Math.max(240, Math.floor(this.policy.maxImageDimension * 0.75)))
+                : this.policy.maxImageDimension,
+            maxFrameBytes: Math.max(0, Math.floor(maxFrameBytes)),
+            usedBytes,
+            priority,
+            ...(reason ? { reason } : {}),
+        };
+    }
+    updatePressure(ratio) {
+        if (!this.policy.adaptiveCapture) {
+            this.pressure = 'normal';
+            return;
+        }
+        if (ratio >= 1) {
+            this.pressure = 'paused';
+            return;
+        }
+        if (ratio >= 0.9) {
+            this.pressure = 'degraded';
+            return;
+        }
+        if (this.pressure === 'paused' || this.pressure === 'degraded') {
+            if (ratio >= 0.8) {
+                this.pressure = 'degraded';
+                return;
+            }
+        }
+        if (ratio >= 0.75) {
+            this.pressure = 'throttled';
+            return;
+        }
+        if (this.pressure === 'throttled' && ratio >= 0.65)
+            return;
+        this.pressure = 'normal';
+    }
+}
+//# sourceMappingURL=replay-budget.js.map

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

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

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

@@ -0,0 +1,36 @@
+export type FTReplaySkipReason = 'dedupe' | 'approx_static' | 'throttle' | 'budget' | 'busy' | 'error';
+export type FTReplayDiagnosticEvent = {
+    type: 'capture_attempt';
+    timestamp: number;
+    usedBytes: number;
+    maxBytesPerMinute: number;
+} | {
+    type: 'capture_skipped';
+    timestamp: number;
+    reason: FTReplaySkipReason;
+} | {
+    type: 'image_saved';
+    timestamp: number;
+    byteSize: number;
+    width: number;
+    height: number;
+    mimeType?: string;
+    priority: boolean;
+    byteSizeSource: 'native' | 'frame_limit_estimate';
+} | {
+    type: 'segment_encoded';
+    timestamp: number;
+    byteSize: number;
+    recordCount: number;
+    pointerRecordCount: number;
+    hasImage: boolean;
+} | {
+    type: 'pointer_received';
+    timestamp: number;
+    eventType: 'down' | 'up' | 'move';
+} | {
+    type: 'replay_stopped';
+    timestamp: number;
+};
+export declare function replayUtf8ByteLength(value: string): number;
+//# sourceMappingURL=replay-diagnostics.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,36 @@
+/** @internal Benchmark-only observer hook. Production builds leave it unset. */
+export function emitReplayDiagnostic(event) {
+    const observer = globalThis.__FT_COCOS_REPLAY_BENCHMARK_OBSERVER__;
+    if (typeof observer !== 'function')
+        return;
+    try {
+        observer(event);
+    }
+    catch (_a) {
+        // Diagnostics must never affect capture, storage, or upload behavior.
+    }
+}
+export function replayUtf8ByteLength(value) {
+    let bytes = 0;
+    for (let index = 0; index < value.length; index += 1) {
+        const code = value.charCodeAt(index);
+        if (code < 0x80)
+            bytes += 1;
+        else if (code < 0x800)
+            bytes += 2;
+        else if (code >= 0xd800 && code <= 0xdbff && index + 1 < value.length) {
+            const low = value.charCodeAt(index + 1);
+            if (low >= 0xdc00 && low <= 0xdfff) {
+                bytes += 4;
+                index += 1;
+            }
+            else {
+                bytes += 3;
+            }
+        }
+        else
+            bytes += 3;
+    }
+    return bytes;
+}
+//# sourceMappingURL=replay-diagnostics.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,31 @@
+import type { FTRUMContext } from './types.js';
+export interface FTReplayImageRecord {
+    context: FTRUMContext;
+    resourceId: string;
+    width: number;
+    height: number;
+    mimeType?: `image/${string}`;
+    timestamp: number;
+    contextChanged: boolean;
+    pointerEvents?: FTReplayPointerRecord[];
+}
+export interface FTReplayPointerRecord {
+    eventType: 'down' | 'up' | 'move';
+    pointerId: number;
+    x: number;
+    y: number;
+    timestamp: number;
+}
+export interface FTReplayPointerRecords {
+    context: FTRUMContext;
+    pointerEvents: FTReplayPointerRecord[];
+}
+export declare function encodeReplayImageRecord(input: FTReplayImageRecord): {
+    segment: string;
+    recordCount: number;
+};
+export declare function encodeReplayPointerRecords(input: FTReplayPointerRecords): {
+    segment: string;
+    recordCount: number;
+};
+//# sourceMappingURL=replay-encoding.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,62 @@
+export function encodeReplayImageRecord(input) {
+    var _a;
+    const wireframe = {
+        id: 1,
+        type: 'image',
+        x: 0,
+        y: 0,
+        width: input.width,
+        height: input.height,
+        base64: null,
+        border: null,
+        clip: null,
+        isEmpty: false,
+        ...(input.mimeType ? { mimeType: input.mimeType } : {}),
+        resourceId: input.resourceId,
+        shapeStyle: null,
+    };
+    const records = [];
+    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: 10,
+        data: { wireframes: [wireframe] },
+        timestamp: input.timestamp,
+    });
+    records.push(...((_a = input.pointerEvents) === null || _a === void 0 ? void 0 : _a.map(pointerRecord)) || []);
+    return {
+        segment: encodeEnvelope(input.context, records),
+        recordCount: records.length,
+    };
+}
+export function encodeReplayPointerRecords(input) {
+    const records = input.pointerEvents.map(pointerRecord);
+    return {
+        segment: encodeEnvelope(input.context, records),
+        recordCount: records.length,
+    };
+}
+function pointerRecord(pointer) {
+    return {
+        type: 11,
+        data: {
+            source: 9,
+            pointerEventType: pointer.eventType,
+            pointerType: 'touch',
+            pointerId: pointer.pointerId,
+            x: pointer.x,
+            y: pointer.y,
+        },
+        timestamp: pointer.timestamp,
+    };
+}
+function encodeEnvelope(context, records) {
+    return JSON.stringify({
+        records,
+        applicationID: context.applicationId,
+        sessionID: context.sessionId,
+        viewID: context.viewId,
+    });
+}
+//# sourceMappingURL=replay-encoding.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,5 @@
+import type { FTCapturedFrame, FTStoredFrame } from './types.js';
+/** Copies pixels into native-owned memory; all file operations run off the game thread. */
+export declare function persistReplayFrame(frame: FTCapturedFrame, fingerprint: string, writablePath: string): Promise<FTStoredFrame>;
+export declare function disposeReplayFrame(frame: FTStoredFrame): Promise<void>;
+//# sourceMappingURL=replay-file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"replay-file.d.ts","sourceRoot":"","sources":["../../../../../src/session-replay/core/replay-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAwBjE,2FAA2F;AAC3F,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,eAAe,EACtB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,aAAa,CAAC,CAKxB;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAG5E"}

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

@@ -0,0 +1,31 @@
+let sequence = 0;
+function bridge() {
+    const value = globalThis.__ftCocosReplayFile;
+    if (!value)
+        throw new Error('Rebuild the native project with the Cocos SDK extension to enable asynchronous Replay storage');
+    return value;
+}
+async function waitForFile(expected) {
+    for (;;) {
+        await new Promise((resolve) => setTimeout(resolve, 16));
+        const status = bridge().poll();
+        if (status === expected)
+            return;
+        if (status !== 'pending')
+            throw new Error(`Replay file operation failed: ${status}`);
+    }
+}
+/** Copies pixels into native-owned memory; all file operations run off the game thread. */
+export async function persistReplayFrame(frame, fingerprint, writablePath) {
+    const path = `${writablePath}cocos-sdk-replay-${Date.now()}-${++sequence}-${fingerprint}.rgba`;
+    if (!bridge().write(frame.rgba, path))
+        throw new Error('Replay file writer is busy');
+    await waitForFile('written');
+    return { path, width: frame.width, height: frame.height, timestamp: frame.timestamp, fingerprint };
+}
+export async function disposeReplayFrame(frame) {
+    if (!bridge().remove(frame.path))
+        throw new Error('Replay file writer is busy or the frame has expired');
+    await waitForFile('removed');
+}
+//# sourceMappingURL=replay-file.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"replay-file.js","sourceRoot":"","sources":["../../../../../src/session-replay/core/replay-file.ts"],"names":[],"mappings":"AAQA,IAAI,QAAQ,GAAG,CAAC,CAAC;AACjB,SAAS,MAAM;IACb,MAAM,KAAK,GAAI,UAAsE,CAAC,mBAAmB,CAAC;IAC1G,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,+FAA+F,CAAC,CAAC;IAC7H,OAAO,KAAK,CAAC;AACf,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,QAA+B;IACxD,SAAS,CAAC;QACR,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC;QAC/B,IAAI,MAAM,KAAK,QAAQ;YAAE,OAAO;QAChC,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,MAAM,EAAE,CAAC,CAAC;IACvF,CAAC;AACH,CAAC;AAED,2FAA2F;AAC3F,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAsB,EACtB,WAAmB,EACnB,YAAoB;IAEpB,MAAM,IAAI,GAAG,GAAG,YAAY,oBAAoB,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,IAAI,WAAW,OAAO,CAAC;IAC/F,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IACrF,MAAM,WAAW,CAAC,SAAS,CAAC,CAAC;IAC7B,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,WAAW,EAAE,CAAC;AACrG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,KAAoB;IAC3D,IAAI,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzG,MAAM,WAAW,CAAC,SAAS,CAAC,CAAC;AAC/B,CAAC"}

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

@@ -0,0 +1,3 @@
+/** Converts tightly packed RGBA pixels from bottom-left to top-left row order. */
+export declare function flipRgbaRows(bytes: Uint8Array, width: number, height: number): void;
+//# sourceMappingURL=replay-pixels.d.ts.map