@truewatchtech/cocos-sdk 0.1.0-alpha.3

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

@@ -0,0 +1 @@
+{"version":3,"file":"replay-pixels.js","sourceRoot":"","sources":["../../../../../src/core/replay-pixels.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,MAAM,UAAU,YAAY,CAAC,KAAiB,EAAE,KAAa,EAAE,MAAc;IAC3E,MAAM,OAAO,GAAG,KAAK,GAAG,CAAC,CAAC;IAC1B,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;IACrC,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,EAAE,GAAG,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC;QAC3E,MAAM,SAAS,GAAG,GAAG,GAAG,OAAO,CAAC;QAChC,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,CAAC;QACtC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC;QACzD,KAAK,CAAC,UAAU,CAAC,SAAS,EAAE,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,CAAC;QAClE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAChC,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,15 @@
+import type { FTPrivacyRegion } from './types.js';
+interface FTPoint {
+    x: number;
+    y: number;
+}
+interface FTRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/** Projects a world-space node rectangle into a top-left-origin Replay frame. */
+export declare function projectPrivacyBounds(bounds: FTRect, frameWidth: number, frameHeight: number, screenWidth: number, screenHeight: number, project: (x: number, y: number) => FTPoint | undefined): Omit<FTPrivacyRegion, 'mode'> | undefined;
+export {};
+//# sourceMappingURL=replay-privacy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"replay-privacy.d.ts","sourceRoot":"","sources":["../../../../../src/core/replay-privacy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,UAAU,OAAO;IACf,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,UAAU,MAAM;IACd,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,iFAAiF;AACjF,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,GACrD,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,GAAG,SAAS,CA6B3C"}

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

@@ -0,0 +1,33 @@
+/** Projects a world-space node rectangle into a top-left-origin Replay frame. */
+export function projectPrivacyBounds(bounds, frameWidth, frameHeight, screenWidth, screenHeight, project) {
+    if ([frameWidth, frameHeight, screenWidth, screenHeight].some((size) => !Number.isFinite(size) || size <= 0)) {
+        return undefined;
+    }
+    const points = [
+        project(bounds.x, bounds.y),
+        project(bounds.x + bounds.width, bounds.y),
+        project(bounds.x, bounds.y + bounds.height),
+        project(bounds.x + bounds.width, bounds.y + bounds.height),
+    ];
+    if (points.some((point) => !point || !Number.isFinite(point.x) || !Number.isFinite(point.y))) {
+        return undefined;
+    }
+    const projected = points;
+    const minimumX = Math.min(...projected.map((point) => point.x));
+    const maximumX = Math.max(...projected.map((point) => point.x));
+    const minimumY = Math.min(...projected.map((point) => point.y));
+    const maximumY = Math.max(...projected.map((point) => point.y));
+    // A native projection can reject its input without throwing and return a
+    // zero vector. Do not treat its zero-area result as a valid privacy mask.
+    if (maximumX <= minimumX || maximumY <= minimumY)
+        return undefined;
+    const scaleX = frameWidth / screenWidth;
+    const scaleY = frameHeight / screenHeight;
+    return {
+        x: minimumX * scaleX,
+        y: (screenHeight - maximumY) * scaleY,
+        width: (maximumX - minimumX) * scaleX,
+        height: (maximumY - minimumY) * scaleY,
+    };
+}
+//# sourceMappingURL=replay-privacy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"replay-privacy.js","sourceRoot":"","sources":["../../../../../src/core/replay-privacy.ts"],"names":[],"mappings":"AAcA,iFAAiF;AACjF,MAAM,UAAU,oBAAoB,CAClC,MAAc,EACd,UAAkB,EAClB,WAAmB,EACnB,WAAmB,EACnB,YAAoB,EACpB,OAAsD;IAEtD,IAAI,CAAC,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC;QAC7G,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,MAAM,GAAG;QACb,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QAC3B,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;QAC1C,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;QAC3C,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;KAC3D,CAAC;IACF,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7F,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,SAAS,GAAG,MAAmB,CAAC;IACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAChE,yEAAyE;IACzE,0EAA0E;IAC1E,IAAI,QAAQ,IAAI,QAAQ,IAAI,QAAQ,IAAI,QAAQ;QAAE,OAAO,SAAS,CAAC;IACnE,MAAM,MAAM,GAAG,UAAU,GAAG,WAAW,CAAC;IACxC,MAAM,MAAM,GAAG,WAAW,GAAG,YAAY,CAAC;IAC1C,OAAO;QACL,CAAC,EAAE,QAAQ,GAAG,MAAM;QACpB,CAAC,EAAE,CAAC,YAAY,GAAG,QAAQ,CAAC,GAAG,MAAM;QACrC,KAAK,EAAE,CAAC,QAAQ,GAAG,QAAQ,CAAC,GAAG,MAAM;QACrC,MAAM,EAAE,CAAC,QAAQ,GAAG,QAAQ,CAAC,GAAG,MAAM;KACvC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,97 @@
+import type { FTNativeTransport } from './transport.js';
+import type { FTCapturedFrame, FTPrivacyRegion, FTSessionReplayConfig, FTStoredFrame } from './types.js';
+export interface FTCanvasCapture {
+    getViewportSize?(): {
+        width: number;
+        height: number;
+    } | undefined;
+    capture(maxImageDimension: number): Promise<FTCapturedFrame | undefined>;
+    persist(frame: FTCapturedFrame, fingerprint: string): Promise<FTStoredFrame>;
+    disposeStoredFrame(frame: FTStoredFrame): void;
+    setPrivacy(node: unknown, mode: 'mask' | 'hide' | 'unmask'): void;
+}
+export interface FTReplayPointerEvent {
+    eventType: 'down' | 'up' | 'move';
+    pointerId: number;
+    normalizedX: number;
+    normalizedY: number;
+    timestamp: number;
+}
+export interface FTReplayPointerSource {
+    onReplayPointer(callback: (event: FTReplayPointerEvent) => void): () => void;
+}
+export interface FTReplaySaveImageV2Result {
+    resourceId: string;
+    byteSize: number;
+    width: number;
+    height: number;
+    mimeType?: `image/${string}`;
+}
+export interface FTReplayFrameSample {
+    width: number;
+    height: number;
+    luminance: Uint8Array;
+}
+/** Cocos canvas Session Replay controls. */
+export declare class FTSessionReplay {
+    private readonly transport;
+    private readonly capture;
+    private readonly pointerSource?;
+    private timer;
+    private busy;
+    private running;
+    private mode;
+    private hybridReplayEnabled;
+    private captureGeneration;
+    private config;
+    private imagePolicy;
+    private budget;
+    private lastFingerprint;
+    private lastContextKey;
+    private lastPrivacyKey;
+    private lastFrameSample;
+    private lastImageSize;
+    private lastViewportSize;
+    private imagePolicyEnabled;
+    private supportsSaveImageV2;
+    private recordCounts;
+    private recordTouches;
+    private pendingPointerEvents;
+    private stopPointerTracking;
+    constructor(transport: FTNativeTransport, capture: FTCanvasCapture, pointerSource?: FTReplayPointerSource | undefined);
+    /**
+     * Enables native Session Replay and starts Cocos canvas capture for a
+     * standalone application.
+     *
+     * @param config - Replay sampling, capture, and touch-privacy settings.
+     */
+    start(config?: FTSessionReplayConfig): void;
+    private configureCapture;
+    /** Stops standalone Cocos canvas capture and native Session Replay. */
+    stop(): void;
+    /**
+     * Changes the Session Replay privacy treatment for a Cocos node.
+     *
+     * `mask` obscures the node, `hide` removes the region from the replay, and
+     * `unmask` clears an earlier override. The node must belong to the active
+     * Cocos scene.
+     *
+     * @param node - Cocos node whose rendered bounds receive the privacy rule.
+     * @param mode - Privacy treatment to apply.
+     */
+    setPrivacy(node: unknown, mode: 'mask' | 'hide' | 'unmask'): void;
+    private startCapture;
+    private stopCapture;
+    private schedule;
+    private readContext;
+    private saveImage;
+    private writePendingPointers;
+    private scaledPendingPointers;
+    private updateRecordCount;
+}
+export declare function normalizeSaveImageV2Result(value: unknown): FTReplaySaveImageV2Result;
+export declare function sampleReplayFrame(rgba: Uint8Array, width: number, height: number, maximumSamples?: number): FTReplayFrameSample;
+export declare function replayFramesLookSimilar(previous: FTReplayFrameSample | undefined, current: FTReplayFrameSample): boolean;
+export declare function frameFingerprint(bytes: Uint8Array): string;
+export declare function applyPrivacyRegions(rgba: Uint8Array, width: number, height: number, regions: FTPrivacyRegion[]): void;
+//# sourceMappingURL=replay.d.ts.map

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

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