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

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

@@ -0,0 +1,82 @@
+import type { FTAttributes, FTCocosConfig, FTCocosHybridConfig } from '@cloudcare/cocos-sdk/plugin-api';
+/** Visual treatment applied to a Session Replay node. */
+export type FTReplayPrivacyMode = 'mask' | 'hide' | 'unmask';
+/** Whether Session Replay records touch positions. */
+export type FTReplayTouchPrivacy = 'show' | 'hide';
+/** Image quality preset used by Cocos Session Replay. */
+export type FTReplayQuality = 'low' | 'medium' | 'high';
+/** Image traffic controls for Cocos Session Replay. */
+export interface FTReplayImagePolicy {
+    /** Compression, size, and traffic preset. @defaultValue `'medium'` */
+    quality?: FTReplayQuality;
+    /** Maximum encoded bytes for a normal image resource. */
+    maxFrameBytes?: number;
+    /** Maximum encoded image bytes retained in a rolling 60-second window. */
+    maxBytesPerMinute?: number;
+    /** Paces captures to the image budget and adapts quality and size as it fills. @defaultValue `true` */
+    adaptiveCapture?: boolean;
+}
+/** Session Replay configuration for standalone Cocos applications. */
+export interface FTSessionReplayConfig {
+    /** Replay sampling rate from `0` to `1`. */
+    sampleRate?: number;
+    /** Additional replay sampling rate from `0` to `1` for sessions that contain errors. */
+    sessionOnErrorSampleRate?: number;
+    /** Canvas capture rate in frames per second. Accepts integers from `1` to `5`. @defaultValue `1` */
+    captureFps?: number;
+    /** Maximum width or height of a captured frame. Accepts `1` to `2048`. @defaultValue `720` */
+    maxImageDimension?: number;
+    /** Image compression and rolling traffic-budget controls. */
+    imagePolicy?: FTReplayImagePolicy;
+    /** Whether captured replays include touch positions. @defaultValue `'hide'` */
+    touchPrivacy?: FTReplayTouchPrivacy;
+}
+/** Cocos-side Session Replay settings when the native host owns SDK initialization. */
+export interface FTHybridSessionReplayConfig {
+    /** Canvas capture rate in frames per second. Accepts integers from `1` to `5`. @defaultValue `1` */
+    captureFps?: number;
+    /** Maximum width or height of a captured frame. Accepts `1` to `2048`. @defaultValue `720` */
+    maxImageDimension?: number;
+    /** Image compression and rolling traffic-budget controls. */
+    imagePolicy?: FTReplayImagePolicy;
+    /** Whether captured replays include touch positions. @defaultValue `'hide'` */
+    touchPrivacy?: FTReplayTouchPrivacy;
+}
+/** Internal native RUM context used by Session Replay encoding. */
+export interface FTRUMContext {
+    applicationId: string;
+    sessionId: string;
+    viewId: string;
+    globalContext?: FTAttributes;
+}
+/** Internal privacy rectangle projected into a captured frame. */
+export interface FTPrivacyRegion {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    mode: Exclude<FTReplayPrivacyMode, 'unmask'>;
+}
+/** Internal in-memory representation of a captured Cocos frame. */
+export interface FTCapturedFrame {
+    rgba: Uint8Array;
+    width: number;
+    height: number;
+    timestamp: number;
+    privacyRegions?: FTPrivacyRegion[];
+}
+/** Internal persisted representation of a captured Cocos frame. */
+export interface FTStoredFrame {
+    path: string;
+    width: number;
+    height: number;
+    timestamp: number;
+    fingerprint: string;
+}
+export interface FTCocosReplayConfig extends FTCocosConfig {
+    replay?: FTSessionReplayConfig;
+}
+export interface FTCocosHybridReplayConfig extends FTCocosHybridConfig {
+    replay?: FTHybridSessionReplayConfig;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/session-replay/core/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAExG,yDAAyD;AACzD,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE7D,sDAAsD;AACtD,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,MAAM,CAAC;AAEnD,yDAAyD;AACzD,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAExD,uDAAuD;AACvD,MAAM,WAAW,mBAAmB;IAClC,sEAAsE;IACtE,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uGAAuG;IACvG,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,sEAAsE;AACtE,MAAM,WAAW,qBAAqB;IACpC,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wFAAwF;IACxF,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,oGAAoG;IACpG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8FAA8F;IAC9F,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6DAA6D;IAC7D,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,+EAA+E;IAC/E,YAAY,CAAC,EAAE,oBAAoB,CAAC;CACrC;AAED,uFAAuF;AACvF,MAAM,WAAW,2BAA2B;IAC1C,oGAAoG;IACpG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8FAA8F;IAC9F,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6DAA6D;IAC7D,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,+EAA+E;IAC/E,YAAY,CAAC,EAAE,oBAAoB,CAAC;CACrC;AAED,mEAAmE;AACnE,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,YAAY,CAAC;CAC9B;AAED,kEAAkE;AAClE,MAAM,WAAW,eAAe;IAC9B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAC;CAC9C;AAED,mEAAmE;AACnE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,eAAe,EAAE,CAAC;CACpC;AAED,mEAAmE;AACnE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IAAG,MAAM,CAAC,EAAE,qBAAqB,CAAC;CAAE;AAC9F,MAAM,WAAW,yBAA0B,SAAQ,mBAAmB;IAAG,MAAM,CAAC,EAAE,2BAA2B,CAAC;CAAE"}

package/dist/creator3/core/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/session-replay/core/types.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,13 @@
+import type { FTHybridSessionReplayConfig, FTReplayQuality } from './types.js';
+export declare function samplingRate(value: number | undefined, name: string): number | undefined;
+export declare function captureFps(value: number | undefined): number;
+export interface FTResolvedReplayImagePolicy {
+    quality: FTReplayQuality;
+    compressionQuality: number;
+    maxImageDimension: number;
+    maxFrameBytes: number;
+    maxBytesPerMinute: number;
+    adaptiveCapture: boolean;
+}
+export declare function replayImagePolicy(config: FTHybridSessionReplayConfig): FTResolvedReplayImagePolicy;
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../../src/session-replay/core/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMxF;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAM5D;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,eAAe,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,OAAO,CAAC;CAC1B;AAuBD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,2BAA2B,GAAG,2BAA2B,CA2BlG"}

package/dist/creator3/core/validation.js

@@ -0,0 +1,70 @@
+export function samplingRate(value, name) {
+    if (value === undefined)
+        return undefined;
+    if (!Number.isFinite(value) || value < 0 || value > 1) {
+        throw new RangeError(`${name} must be between 0 and 1`);
+    }
+    return value;
+}
+export function captureFps(value) {
+    const fps = value === undefined ? 1 : value;
+    if (!Number.isInteger(fps) || fps < 1 || fps > 5) {
+        throw new RangeError('captureFps must be an integer between 1 and 5');
+    }
+    return fps;
+}
+const REPLAY_IMAGE_PRESETS = {
+    low: {
+        compressionQuality: 0.35,
+        maxImageDimension: 480,
+        maxFrameBytes: 20 * 1024,
+        maxBytesPerMinute: Math.round(0.6 * 1024 * 1024),
+    },
+    medium: {
+        compressionQuality: 0.45,
+        maxImageDimension: 720,
+        maxFrameBytes: 40 * 1024,
+        maxBytesPerMinute: Math.round(1.5 * 1024 * 1024),
+    },
+    high: {
+        compressionQuality: 0.6,
+        maxImageDimension: 960,
+        maxFrameBytes: 80 * 1024,
+        maxBytesPerMinute: 4 * 1024 * 1024,
+    },
+};
+export function replayImagePolicy(config) {
+    var _a, _b, _c, _d, _e;
+    const policy = config.imagePolicy || {};
+    const quality = (_a = policy.quality) !== null && _a !== void 0 ? _a : 'medium';
+    if (!(quality in REPLAY_IMAGE_PRESETS)) {
+        throw new TypeError("imagePolicy.quality must be 'low', 'medium', or 'high'");
+    }
+    if (policy.adaptiveCapture !== undefined && typeof policy.adaptiveCapture !== 'boolean') {
+        throw new TypeError('imagePolicy.adaptiveCapture must be a boolean');
+    }
+    const preset = REPLAY_IMAGE_PRESETS[quality];
+    const maxImageDimension = (_b = config.maxImageDimension) !== null && _b !== void 0 ? _b : preset.maxImageDimension;
+    integerInRange(maxImageDimension, 1, 2048, 'maxImageDimension');
+    const maxFrameBytes = (_c = policy.maxFrameBytes) !== null && _c !== void 0 ? _c : preset.maxFrameBytes;
+    integerInRange(maxFrameBytes, 1024, 1024 * 1024, 'imagePolicy.maxFrameBytes');
+    const maxBytesPerMinute = (_d = policy.maxBytesPerMinute) !== null && _d !== void 0 ? _d : preset.maxBytesPerMinute;
+    integerInRange(maxBytesPerMinute, 16 * 1024, 64 * 1024 * 1024, 'imagePolicy.maxBytesPerMinute');
+    if (maxFrameBytes > maxBytesPerMinute) {
+        throw new RangeError('imagePolicy.maxFrameBytes must not exceed maxBytesPerMinute');
+    }
+    return {
+        quality,
+        compressionQuality: preset.compressionQuality,
+        maxImageDimension,
+        maxFrameBytes,
+        maxBytesPerMinute,
+        adaptiveCapture: (_e = policy.adaptiveCapture) !== null && _e !== void 0 ? _e : true,
+    };
+}
+function integerInRange(value, minimum, maximum, name) {
+    if (!Number.isInteger(value) || value < minimum || value > maximum) {
+        throw new RangeError(`${name} must be an integer between ${minimum} and ${maximum}`);
+    }
+}
+//# sourceMappingURL=validation.js.map

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

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

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

@@ -0,0 +1,2 @@
+export declare const FT_COCOS_REPLAY_VERSION = "0.1.0-alpha.6";
+//# sourceMappingURL=version.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../../../src/session-replay/core/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,kBAAkB,CAAC"}

package/dist/creator3/core/version.js

@@ -0,0 +1,2 @@
+export const FT_COCOS_REPLAY_VERSION = '0.1.0-alpha.6';
+//# sourceMappingURL=version.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../../../src/session-replay/core/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,uBAAuB,GAAG,eAAe,CAAC"}

package/dist/creator3/creator3/capture.d.ts

@@ -0,0 +1,17 @@
+import type { FTCanvasCapture } from '../core/replay.js';
+import type { FTCapturedFrame, FTReplayPrivacyMode, FTStoredFrame } from '../core/types.js';
+export declare class FTCreator3CanvasCapture implements FTCanvasCapture {
+    private camera;
+    private privacy;
+    setCamera(camera: unknown): void;
+    setPrivacy(node: unknown, mode: FTReplayPrivacyMode): void;
+    getViewportSize(): {
+        width: number;
+        height: number;
+    } | undefined;
+    capture(maxImageDimension: number): Promise<FTCapturedFrame | undefined>;
+    persist(frame: FTCapturedFrame, fingerprint?: string): Promise<FTStoredFrame>;
+    disposeStoredFrame(frame: FTStoredFrame): Promise<void>;
+    private collectPrivacyRegions;
+}
+//# sourceMappingURL=capture.d.ts.map

package/dist/creator3/creator3/capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../../../../src/session-replay/creator3/capture.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAmB,mBAAmB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAO7G,qBAAa,uBAAwB,YAAW,eAAe;IAC7D,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,OAAO,CAA2C;IAE1D,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAIhC,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,mBAAmB,GAAG,IAAI;IAK1D,eAAe,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS;IAK1D,OAAO,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAqCxE,OAAO,CAAC,KAAK,EAAE,eAAe,EAAE,WAAW,SAA+B,GAAG,OAAO,CAAC,aAAa,CAAC;IAIzG,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD,OAAO,CAAC,qBAAqB;CA6B9B"}

package/dist/creator3/creator3/capture.js

@@ -0,0 +1,112 @@
+import { Camera, Director, EditBox, RenderTexture, UITransform, Vec3, director, native, sys, view } from 'cc';
+import { frameFingerprint } from '../core/replay.js';
+import { persistReplayFrame, disposeReplayFrame } from '../core/replay-file.js';
+import { projectPrivacyBounds } from '../core/replay-privacy.js';
+import { collectReplayPrivacyNodes } from '../core/replay-privacy-nodes.js';
+import { waitForRenderTextureReadback } from './replay-render-cycle.js';
+export class FTCreator3CanvasCapture {
+    constructor() {
+        this.privacy = new Map();
+    }
+    setCamera(camera) {
+        this.camera = camera;
+    }
+    setPrivacy(node, mode) {
+        if (mode === 'unmask')
+            this.privacy.delete(node);
+        else
+            this.privacy.set(node, mode);
+    }
+    getViewportSize() {
+        var _a;
+        const visible = ((_a = view.getVisibleSizeInPixel) === null || _a === void 0 ? void 0 : _a.call(view)) || view.getVisibleSize();
+        return visible ? { width: visible.width, height: visible.height } : undefined;
+    }
+    async capture(maxImageDimension) {
+        var _a, _b;
+        const camera = this.camera || ((_a = director.getScene()) === null || _a === void 0 ? void 0 : _a.getComponentInChildren(Camera));
+        if (!camera)
+            return undefined;
+        const visible = this.getViewportSize();
+        if (!visible)
+            return undefined;
+        const scale = Math.min(1, maxImageDimension / Math.max(visible.width, visible.height));
+        const width = Math.max(1, Math.round(visible.width * scale));
+        const height = Math.max(1, Math.round(visible.height * scale));
+        const texture = new RenderTexture();
+        texture.reset({ width, height });
+        const previous = camera.targetTexture;
+        let pixels;
+        let privacyRegions = [];
+        try {
+            camera.targetTexture = texture;
+            await waitForRenderTextureReadback(completeDrawCycle);
+            pixels = texture.readPixels(0, 0, width, height);
+            // worldToScreen uses the active render target dimensions. Keep the
+            // capture target attached so projection and pixels share one viewport.
+            if (pixels)
+                privacyRegions = this.collectPrivacyRegions(camera, width, height);
+        }
+        finally {
+            camera.targetTexture = previous;
+            texture.destroy();
+        }
+        if (!pixels)
+            return undefined;
+        // Metal returns top-down pixels on iOS. OpenGL/Vulkan-backed native
+        // targets use a bottom-left origin and need row reversal for PNG output.
+        if (sys.os !== ((_b = sys.OS) === null || _b === void 0 ? void 0 : _b.IOS))
+            flipRows(pixels, width, height);
+        return {
+            rgba: pixels,
+            width,
+            height,
+            timestamp: Date.now(),
+            privacyRegions,
+        };
+    }
+    async persist(frame, fingerprint = frameFingerprint(frame.rgba)) {
+        return persistReplayFrame(frame, fingerprint, native.fileUtils.getWritablePath());
+    }
+    disposeStoredFrame(frame) {
+        return disposeReplayFrame(frame);
+    }
+    collectPrivacyRegions(camera, width, height) {
+        const scene = director.getScene();
+        const nodes = collectReplayPrivacyNodes(this.privacy, (scene === null || scene === void 0 ? void 0 : scene.getComponentsInChildren('ReplayPrivacy')) || [], (scene === null || scene === void 0 ? void 0 : scene.getComponentsInChildren(EditBox)) || []);
+        const regions = [];
+        nodes.forEach((mode, node) => {
+            var _a, _b, _c, _d;
+            const bounds = (_c = (_b = (_a = node === null || node === void 0 ? void 0 : node.getComponent) === null || _a === void 0 ? void 0 : _a.call(node, UITransform)) === null || _b === void 0 ? void 0 : _b.getBoundingBoxToWorld) === null || _c === void 0 ? void 0 : _c.call(_b);
+            if (!bounds)
+                return;
+            const worldZ = ((_d = node.worldPosition) === null || _d === void 0 ? void 0 : _d.z) || 0;
+            const projected = projectPrivacyBounds(bounds, width, height, width, height, (x, y) => { var _a; return (_a = camera.worldToScreen) === null || _a === void 0 ? void 0 : _a.call(camera, new Vec3(x, y, worldZ)); });
+            if (!projected)
+                throw new Error('Unable to project Replay privacy bounds');
+            regions.push({ ...projected, mode: mode === 'hide' ? 'hide' : 'mask' });
+        });
+        return regions;
+    }
+}
+async function completeDrawCycle() {
+    // capture() may run after the current frame's render graph has already been
+    // prepared. Waiting only for EVENT_AFTER_DRAW can then read the newly bound
+    // RenderTexture before the camera has rendered into it, producing a black
+    // FullSnapshot at a Native -> Cocos boundary. Start at the next draw boundary
+    // so the target texture is guaranteed to participate in a complete frame.
+    await new Promise((resolve) => director.once(Director.EVENT_BEFORE_DRAW, resolve));
+    await new Promise((resolve) => director.once(Director.EVENT_AFTER_DRAW, resolve));
+}
+function flipRows(bytes, width, height) {
+    const rowSize = width * 4;
+    const swap = new Uint8Array(rowSize);
+    for (let top = 0, bottom = height - 1; top < bottom; top += 1, bottom -= 1) {
+        const topOffset = top * rowSize;
+        const bottomOffset = bottom * rowSize;
+        swap.set(bytes.subarray(topOffset, topOffset + rowSize));
+        bytes.copyWithin(topOffset, bottomOffset, bottomOffset + rowSize);
+        bytes.set(swap, bottomOffset);
+    }
+}
+//# sourceMappingURL=capture.js.map

package/dist/creator3/creator3/capture.js.map

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

package/dist/creator3/creator3/index.d.ts

@@ -0,0 +1,8 @@
+import type { FTCocosSDK } from '@cloudcare/cocos-sdk/plugin-api';
+import { type FTCocosReplaySDK } from '../core/client.js';
+/** Adds Session Replay to the matching Creator SDK before start or attach. */
+export declare function withSessionReplay(sdk: FTCocosSDK): FTCocosReplaySDK;
+export type { FTCocosReplaySDK } from '../core/client.js';
+export type { FTCocosReplayConfig, FTCocosHybridReplayConfig, FTSessionReplayConfig, FTHybridSessionReplayConfig, FTReplayImagePolicy, FTReplayPrivacyMode, FTReplayQuality, FTReplayTouchPrivacy } from '../core/types.js';
+export { FT_COCOS_REPLAY_VERSION } from '../core/version.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/creator3/creator3/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/session-replay/creator3/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAwB,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAKhF,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,UAAU,GAAG,gBAAgB,CAMnE;AAED,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,YAAY,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,qBAAqB,EACjF,2BAA2B,EAAE,mBAAmB,EAAE,mBAAmB,EACrE,eAAe,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/creator3/creator3/index.js

@@ -0,0 +1,14 @@
+import { composeSessionReplay } from '../core/client.js';
+import { FTCreator3CanvasCapture } from './capture.js';
+import { FTCreator3ReplayTransport } from './transport.js';
+import { FTCreator3PointerSource } from './pointer.js';
+/** Adds Session Replay to the matching Creator SDK before start or attach. */
+export function withSessionReplay(sdk) {
+    return composeSessionReplay(sdk, 'creator3', () => ({
+        transport: new FTCreator3ReplayTransport(),
+        capture: new FTCreator3CanvasCapture(),
+        pointers: new FTCreator3PointerSource(),
+    }));
+}
+export { FT_COCOS_REPLAY_VERSION } from '../core/version.js';
+//# sourceMappingURL=index.js.map

package/dist/creator3/creator3/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/session-replay/creator3/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAyB,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEvD,8EAA8E;AAC9E,MAAM,UAAU,iBAAiB,CAAC,GAAe;IAC/C,OAAO,oBAAoB,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;QAClD,SAAS,EAAE,IAAI,yBAAyB,EAAE;QAC1C,OAAO,EAAE,IAAI,uBAAuB,EAAE;QACtC,QAAQ,EAAE,IAAI,uBAAuB,EAAE;KACxC,CAAC,CAAC,CAAC;AACN,CAAC;AAMD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/creator3/creator3/pointer.d.ts

@@ -0,0 +1,5 @@
+import type { FTReplayPointerEvent, FTReplayPointerSource } from '../core/replay.js';
+export declare class FTCreator3PointerSource implements FTReplayPointerSource {
+    onReplayPointer(callback: (event: FTReplayPointerEvent) => void): () => void;
+}
+//# sourceMappingURL=pointer.d.ts.map

package/dist/creator3/creator3/pointer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointer.d.ts","sourceRoot":"","sources":["../../../../../src/session-replay/creator3/pointer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAErF,qBAAa,uBAAwB,YAAW,qBAAqB;IACnE,eAAe,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,GAAG,MAAM,IAAI;CAY7E"}

package/dist/creator3/creator3/pointer.js

@@ -0,0 +1,29 @@
+import { Input, input, view } from 'cc';
+export class FTCreator3PointerSource {
+    onReplayPointer(callback) {
+        const onStart = (event) => callback(replayPointer(event, 'down'));
+        const onEnd = (event) => callback(replayPointer(event, 'up'));
+        input.on(Input.EventType.TOUCH_START, onStart);
+        input.on(Input.EventType.TOUCH_END, onEnd);
+        input.on(Input.EventType.TOUCH_CANCEL, onEnd);
+        return () => {
+            input.off(Input.EventType.TOUCH_START, onStart);
+            input.off(Input.EventType.TOUCH_END, onEnd);
+            input.off(Input.EventType.TOUCH_CANCEL, onEnd);
+        };
+    }
+}
+function replayPointer(event, eventType) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+    const location = ((_a = event.getUILocation) === null || _a === void 0 ? void 0 : _a.call(event)) || ((_b = event.getLocation) === null || _b === void 0 ? void 0 : _b.call(event)) || { x: 0, y: 0 };
+    const size = ((_c = view.getVisibleSize) === null || _c === void 0 ? void 0 : _c.call(view)) || { width: 1, height: 1 };
+    const origin = ((_d = view.getVisibleOrigin) === null || _d === void 0 ? void 0 : _d.call(view)) || { x: 0, y: 0 };
+    return {
+        eventType,
+        pointerId: (_j = (_f = (_e = event.getID) === null || _e === void 0 ? void 0 : _e.call(event)) !== null && _f !== void 0 ? _f : (_h = (_g = event.touch) === null || _g === void 0 ? void 0 : _g.getID) === null || _h === void 0 ? void 0 : _h.call(_g)) !== null && _j !== void 0 ? _j : 0,
+        normalizedX: size.width > 0 ? (location.x - origin.x) / size.width : 0,
+        normalizedY: size.height > 0 ? 1 - ((location.y - origin.y) / size.height) : 0,
+        timestamp: Date.now(),
+    };
+}
+//# sourceMappingURL=pointer.js.map

package/dist/creator3/creator3/pointer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointer.js","sourceRoot":"","sources":["../../../../../src/session-replay/creator3/pointer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAGxC,MAAM,OAAO,uBAAuB;IAClC,eAAe,CAAC,QAA+C;QAC7D,MAAM,OAAO,GAAG,CAAC,KAAU,EAAQ,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;QAC7E,MAAM,KAAK,GAAG,CAAC,KAAU,EAAQ,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;QACzE,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC/C,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAC3C,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;QAC9C,OAAO,GAAG,EAAE;YACV,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAChD,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YAC5C,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;QACjD,CAAC,CAAC;IACJ,CAAC;CACF;AAED,SAAS,aAAa,CAAC,KAAU,EAAE,SAAwB;;IACzD,MAAM,QAAQ,GAAG,CAAA,MAAA,KAAK,CAAC,aAAa,qDAAI,MAAI,MAAA,KAAK,CAAC,WAAW,qDAAI,CAAA,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IACpF,MAAM,IAAI,GAAG,CAAA,MAAA,IAAI,CAAC,cAAc,oDAAI,KAAI,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IAChE,MAAM,MAAM,GAAG,CAAA,MAAA,IAAI,CAAC,gBAAgB,oDAAI,KAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IAC3D,OAAO;QACL,SAAS;QACT,SAAS,EAAE,MAAA,MAAA,MAAA,KAAK,CAAC,KAAK,qDAAI,mCAAI,MAAA,MAAA,KAAK,CAAC,KAAK,0CAAE,KAAK,kDAAI,mCAAI,CAAC;QACzD,WAAW,EAAE,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACtE,WAAW,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9E,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC;AACJ,CAAC"}

package/dist/creator3/creator3/replay-render-cycle.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Waits until a newly attached native RenderTexture is safe to read back.
+ *
+ * Creator 3 can submit the first draw while the target attachment is still
+ * being applied by the native renderer. Keeping the target attached for a
+ * second complete draw prevents an empty first Session Replay snapshot.
+ */
+export declare function waitForRenderTextureReadback(drawCycle: () => Promise<void>): Promise<void>;
+//# sourceMappingURL=replay-render-cycle.d.ts.map

package/dist/creator3/creator3/replay-render-cycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay-render-cycle.d.ts","sourceRoot":"","sources":["../../../../../src/session-replay/creator3/replay-render-cycle.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAsB,4BAA4B,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhG"}

package/dist/creator3/creator3/replay-render-cycle.js

@@ -0,0 +1,12 @@
+/**
+ * Waits until a newly attached native RenderTexture is safe to read back.
+ *
+ * Creator 3 can submit the first draw while the target attachment is still
+ * being applied by the native renderer. Keeping the target attached for a
+ * second complete draw prevents an empty first Session Replay snapshot.
+ */
+export async function waitForRenderTextureReadback(drawCycle) {
+    await drawCycle();
+    await drawCycle();
+}
+//# sourceMappingURL=replay-render-cycle.js.map

package/dist/creator3/creator3/replay-render-cycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay-render-cycle.js","sourceRoot":"","sources":["../../../../../src/session-replay/creator3/replay-render-cycle.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,SAA8B;IAC/E,MAAM,SAAS,EAAE,CAAC;IAClB,MAAM,SAAS,EAAE,CAAC;AACpB,CAAC"}

package/dist/creator3/creator3/transport.d.ts

@@ -0,0 +1,9 @@
+import { type FTNativeTransport } from '../core/transport.js';
+import type { FTValue } from '@cloudcare/cocos-sdk/plugin-api';
+export declare class FTCreator3ReplayTransport implements FTNativeTransport {
+    readonly platform: 'android' | 'ios' | 'unsupported';
+    constructor();
+    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/creator3/creator3/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../../../src/session-replay/creator3/transport.ts"],"names":[],"mappings":"AAGA,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,CAAC;;IAYrD,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/creator3/creator3/transport.js

@@ -0,0 +1,28 @@
+import { invokeReplayAsync } from '../core/replay-async-transport.js';
+import { native, sys } from 'cc';
+import { NATIVE } from 'cc/env';
+import { parseTransportResponse } from '../core/transport.js';
+export class FTCreator3ReplayTransport {
+    constructor() {
+        this.platform = !NATIVE
+            ? 'unsupported'
+            : sys.os === sys.OS.ANDROID
+                ? 'android'
+                : sys.os === sys.OS.IOS
+                    ? 'ios'
+                    : 'unsupported';
+    }
+    invokeAsync(method, payload) {
+        return invokeReplayAsync(this, method, payload);
+    }
+    invoke(method, payload) {
+        if (this.platform === 'unsupported')
+            return undefined;
+        const json = payload === undefined ? '{}' : JSON.stringify(payload);
+        const raw = this.platform === 'android'
+            ? native.reflection.callStaticMethod('com/ft/sdk/cocos/FTCocosReplayBridge', 'invoke', '(Ljava/lang/String;Ljava/lang/String;)Ljava/lang/String;', method, json)
+            : native.reflection.callStaticMethod('FTCocosReplayBridge', 'invoke:payload:', method, json);
+        return parseTransportResponse(raw);
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/creator3/creator3/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../../../src/session-replay/creator3/transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,IAAI,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,sBAAsB,EAA0B,MAAM,sBAAsB,CAAC;AAGtF,MAAM,OAAO,yBAAyB;IAGpC;QACE,IAAI,CAAC,QAAQ,GAAG,CAAC,MAAM;YACrB,CAAC,CAAC,aAAa;YACf,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,OAAO;gBACzB,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,GAAG;oBACrB,CAAC,CAAC,KAAK;oBACP,CAAC,CAAC,aAAa,CAAC;IACxB,CAAC;IAED,WAAW,CAAc,MAAc,EAAE,OAAiB;QACxD,OAAO,iBAAiB,CAAI,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IAED,MAAM,CAAc,MAAc,EAAE,OAAiB;QACnD,IAAI,IAAI,CAAC,QAAQ,KAAK,aAAa;YAAE,OAAO,SAAS,CAAC;QACtD,MAAM,IAAI,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACpE,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,KAAK,SAAS;YACrC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAChC,sCAAsC,EACtC,QAAQ,EACR,0DAA0D,EAC1D,MAAM,EACN,IAAI,CACL;YACH,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QAC/F,OAAO,sBAAsB,CAAI,GAAG,CAAC,CAAC;IACxC,CAAC;CACF"}

package/dist/creator3/package.json

@@ -0,0 +1 @@
+{"type":"module"}