@cloudcare/cocos-sdk 0.1.0-alpha.2 → 0.1.0-alpha.4

package/README.md

@@ -24,7 +24,7 @@ Cocos Creator 3.0–3.6.2 is supported on a best-effort basis because the stable
 
 ## Documentation
 
-[Documentation Center](https://docs.guance.com/real-user-monitoring/cocos/app-access/)
+For installation, configuration, and usage, see the [official documentation](https://docs.guance.com/real-user-monitoring/cocos/app-access/).
 
 ## License
 

package/bin/cli.cjs

@@ -31,9 +31,12 @@ const extensionSource = path.join(packageRoot, 'extensions', `creator${creatorMa
 
 copyDirectory(extensionSource, destination);
 copyDirectory(path.join(packageRoot, 'native'), path.join(destination, 'native'));
+const componentDestination = path.join(projectRoot, 'assets', 'guance-cocos-sdk');
+copyDirectory(path.join(packageRoot, 'components', `creator${creatorMajor}`), componentDestination);
 
 process.stdout.write(
   `Installed ${metadata.name} for Cocos Creator ${creatorMajor} at ${destination}\n`
+  + `Installed ReplayPrivacy at ${componentDestination}. Add it through Session Replay/ReplayPrivacy in the component menu.\n`
   + 'Re-open Cocos Creator, enable the guance-cocos-sdk extension, and rebuild the native project.\n',
 );
 if (fs.existsSync(legacyDestination)) {

package/components/creator2/ReplayPrivacy.ts

@@ -0,0 +1,23 @@
+const { ccclass, property, menu, disallowMultiple } = cc._decorator;
+
+export enum ReplayPrivacyMode {
+  Mask = 0,
+  Hide = 1,
+}
+
+/** Attach to a node or prefab to protect its bounds in Session Replay. */
+@ccclass('ReplayPrivacy')
+@menu('Session Replay/ReplayPrivacy')
+@disallowMultiple
+export default class ReplayPrivacy extends cc.Component {
+  @property({
+    type: cc.Enum(ReplayPrivacyMode),
+    tooltip: 'Mask fills the Replay region gray; Hide fills it black. The live scene is unchanged.',
+  })
+  mode: ReplayPrivacyMode = ReplayPrivacyMode.Mask;
+
+  /** Read by the SDK during capture; independent of SDK initialization order. */
+  get replayPrivacyMode(): 'mask' | 'hide' {
+    return this.mode === ReplayPrivacyMode.Hide ? 'hide' : 'mask';
+  }
+}

package/components/creator3/ReplayPrivacy.ts

@@ -0,0 +1,25 @@
+import { _decorator, Component, Enum } from 'cc';
+
+const { ccclass, property, menu, disallowMultiple } = _decorator;
+
+export enum ReplayPrivacyMode {
+  Mask = 0,
+  Hide = 1,
+}
+
+/** Attach to a node or prefab to protect its bounds in Session Replay. */
+@ccclass('ReplayPrivacy')
+@menu('Session Replay/ReplayPrivacy')
+@disallowMultiple
+export default class ReplayPrivacy extends Component {
+  @property({
+    type: Enum(ReplayPrivacyMode),
+    tooltip: 'Mask fills the Replay region gray; Hide fills it black. The live scene is unchanged.',
+  })
+  mode: ReplayPrivacyMode = ReplayPrivacyMode.Mask;
+
+  /** Read by the SDK during capture; independent of SDK initialization order. */
+  get replayPrivacyMode(): 'mask' | 'hide' {
+    return this.mode === ReplayPrivacyMode.Hide ? 'hide' : 'mask';
+  }
+}

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

@@ -7,7 +7,7 @@ export interface FTAutoTrackingController {
     stop(): void;
 }
 /**
- * Cocos SDK facade exposed through the platform entry point's `guanceSdk`
+ * Cocos SDK facade exposed through the platform entry point's SDK
  * singleton. Do not construct this class directly.
  */
 export declare class FTCocosSDK {

package/dist/creator2/core/client.js

@@ -16,7 +16,7 @@ var modules_js_1 = require("./modules.js");
 var replay_js_1 = require("./replay.js");
 var version_js_1 = require("./version.js");
 /**
- * Cocos SDK facade exposed through the platform entry point's `guanceSdk`
+ * Cocos SDK facade exposed through the platform entry point's SDK
  * singleton. Do not construct this class directly.
  */
 var FTCocosSDK = /** @class */ (function () {
@@ -46,7 +46,7 @@ var FTCocosSDK = /** @class */ (function () {
     FTCocosSDK.prototype.start = function (config) {
         var _a;
         if (this.state !== 'idle') {
-            throw new Error('guanceSdk.start() and guanceSdk.attach() are mutually exclusive');
+            throw new Error('start() and attach() are mutually exclusive');
         }
         this.mobile.start(config.sdk);
         // Base SDK installation already belongs to this Cocos runtime after the
@@ -76,7 +76,7 @@ var FTCocosSDK = /** @class */ (function () {
     FTCocosSDK.prototype.attach = function (config) {
         if (config === void 0) { config = {}; }
         if (this.state === 'standalone') {
-            throw new Error('guanceSdk.start() and guanceSdk.attach() are mutually exclusive');
+            throw new Error('start() and attach() are mutually exclusive');
         }
         if (this.state === 'hybrid-attached' || this.state === 'hybrid-entered')
             return;
@@ -107,10 +107,10 @@ var FTCocosSDK = /** @class */ (function () {
         var _a, _b;
         if (options === void 0) { options = {}; }
         if (this.state === 'standalone') {
-            throw new Error('guanceSdk.enterCocos() is only available after guanceSdk.attach()');
+            throw new Error('enterCocos() is only available after attach()');
         }
         if (this.state === 'idle') {
-            throw new Error('Call guanceSdk.attach() before guanceSdk.enterCocos()');
+            throw new Error('Call attach() before enterCocos()');
         }
         if (this.state === 'hybrid-entered')
             return;
@@ -141,7 +141,7 @@ var FTCocosSDK = /** @class */ (function () {
     FTCocosSDK.prototype.leaveCocos = function () {
         var _a;
         if (this.state === 'standalone') {
-            throw new Error('guanceSdk.leaveCocos() is only available after guanceSdk.attach()');
+            throw new Error('leaveCocos() is only available after attach()');
         }
         if (this.state === 'idle' || this.state === 'hybrid-attached')
             return;

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

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

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

@@ -0,0 +1,4 @@
+import type { FTNativeTransport } from './transport.js';
+/** 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/creator2/core/replay-async-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay-async-transport.d.ts","sourceRoot":"","sources":["../../../../../src/core/replay-async-transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGxD,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/creator2/core/replay-async-transport.js

@@ -0,0 +1,67 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.invokeReplayAsync = invokeReplayAsync;
+var transport_js_1 = require("./transport.js");
+/** Polls a single native worker without keeping a synchronous bridge call open. */
+function invokeReplayAsync(transport, method, payload) {
+    return __awaiter(this, void 0, void 0, function () {
+        var job, result;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    job = transport.invoke('replay.beginSaveImage', { method: method, arguments: payload });
+                    if (!job)
+                        throw new Error('Rebuild the native bridge to enable asynchronous Replay encoding');
+                    _a.label = 1;
+                case 1: return [4 /*yield*/, new Promise(function (resolve) { return setTimeout(resolve, 16); })];
+                case 2:
+                    _a.sent();
+                    result = transport.invoke('replay.pollSaveImage', { job: job });
+                    if (!result)
+                        throw new Error('Replay encoding job is unavailable');
+                    if (!result.pending)
+                        return [2 /*return*/, (0, transport_js_1.parseTransportResponse)(result.response)];
+                    _a.label = 3;
+                case 3: return [3 /*break*/, 1];
+                case 4: return [2 /*return*/];
+            }
+        });
+    });
+}
+//# sourceMappingURL=replay-async-transport.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"replay-async-transport.js","sourceRoot":"","sources":["../../../../../src/core/replay-async-transport.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,8CASC;AAZD,+CAAwD;AAExD,mFAAmF;AACnF,SAAsB,iBAAiB,CAAI,SAA4B,EAAE,MAAc,EAAE,OAAiB;;;;;;oBAClG,GAAG,GAAG,SAAS,CAAC,MAAM,CAAS,uBAAuB,EAAE,EAAE,MAAM,QAAA,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;oBAC9F,IAAI,CAAC,GAAG;wBAAE,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;;wBAE5F,qBAAM,IAAI,OAAO,CAAO,UAAC,OAAO,IAAK,OAAA,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,EAAvB,CAAuB,CAAC,EAAA;;oBAA7D,SAA6D,CAAC;oBACxD,MAAM,GAAG,SAAS,CAAC,MAAM,CAA0C,sBAAsB,EAAE,EAAE,GAAG,KAAA,EAAE,CAAC,CAAC;oBAC1G,IAAI,CAAC,MAAM;wBAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;oBACnE,IAAI,CAAC,MAAM,CAAC,OAAO;wBAAE,sBAAO,IAAA,qCAAsB,EAAI,MAAM,CAAC,QAAQ,CAAC,EAAC;;;;;;;CAE1E"}

package/dist/creator2/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/creator2/core/replay-file.d.ts.map

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

@@ -0,0 +1,101 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.persistReplayFrame = persistReplayFrame;
+exports.disposeReplayFrame = disposeReplayFrame;
+var sequence = 0;
+function bridge() {
+    var value = globalThis.__ftCocosReplayFile;
+    if (!value)
+        throw new Error('Rebuild the native project with the Cocos SDK extension to enable asynchronous Replay storage');
+    return value;
+}
+function waitForFile(expected) {
+    return __awaiter(this, void 0, void 0, function () {
+        var status_1;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, new Promise(function (resolve) { return setTimeout(resolve, 16); })];
+                case 1:
+                    _a.sent();
+                    status_1 = bridge().poll();
+                    if (status_1 === expected)
+                        return [2 /*return*/];
+                    if (status_1 !== 'pending')
+                        throw new Error("Replay file operation failed: ".concat(status_1));
+                    _a.label = 2;
+                case 2: return [3 /*break*/, 0];
+                case 3: return [2 /*return*/];
+            }
+        });
+    });
+}
+/** Copies pixels into native-owned memory; all file operations run off the game thread. */
+function persistReplayFrame(frame, fingerprint, writablePath) {
+    return __awaiter(this, void 0, void 0, function () {
+        var path;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    path = "".concat(writablePath, "cocos-sdk-replay-").concat(Date.now(), "-").concat(++sequence, "-").concat(fingerprint, ".rgba");
+                    if (!bridge().write(frame.rgba, path))
+                        throw new Error('Replay file writer is busy');
+                    return [4 /*yield*/, waitForFile('written')];
+                case 1:
+                    _a.sent();
+                    return [2 /*return*/, { path: path, width: frame.width, height: frame.height, timestamp: frame.timestamp, fingerprint: fingerprint }];
+            }
+        });
+    });
+}
+function disposeReplayFrame(frame) {
+    return __awaiter(this, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    if (!bridge().remove(frame.path))
+                        throw new Error('Replay file writer is busy or the frame has expired');
+                    return [4 /*yield*/, waitForFile('removed')];
+                case 1:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    });
+}
+//# sourceMappingURL=replay-file.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"replay-file.js","sourceRoot":"","sources":["../../../../../src/core/replay-file.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,gDASC;AAED,gDAGC;AA/BD,IAAI,QAAQ,GAAG,CAAC,CAAC;AACjB,SAAS,MAAM;IACb,IAAM,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,SAAe,WAAW,CAAC,QAA+B;;;;;wBAEtD,qBAAM,IAAI,OAAO,CAAO,UAAC,OAAO,IAAK,OAAA,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,EAAvB,CAAuB,CAAC,EAAA;;oBAA7D,SAA6D,CAAC;oBACxD,WAAS,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC;oBAC/B,IAAI,QAAM,KAAK,QAAQ;wBAAE,sBAAO;oBAChC,IAAI,QAAM,KAAK,SAAS;wBAAE,MAAM,IAAI,KAAK,CAAC,wCAAiC,QAAM,CAAE,CAAC,CAAC;;;;;;;CAExF;AAED,2FAA2F;AAC3F,SAAsB,kBAAkB,CACtC,KAAsB,EACtB,WAAmB,EACnB,YAAoB;;;;;;oBAEd,IAAI,GAAG,UAAG,YAAY,8BAAoB,IAAI,CAAC,GAAG,EAAE,cAAI,EAAE,QAAQ,cAAI,WAAW,UAAO,CAAC;oBAC/F,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC;wBAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;oBACrF,qBAAM,WAAW,CAAC,SAAS,CAAC,EAAA;;oBAA5B,SAA4B,CAAC;oBAC7B,sBAAO,EAAE,IAAI,MAAA,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,WAAW,aAAA,EAAE,EAAC;;;;CACpG;AAED,SAAsB,kBAAkB,CAAC,KAAoB;;;;;oBAC3D,IAAI,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;wBAAE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;oBACzG,qBAAM,WAAW,CAAC,SAAS,CAAC,EAAA;;oBAA5B,SAA4B,CAAC;;;;;CAC9B"}

package/dist/creator2/core/replay-privacy-nodes.d.ts

@@ -0,0 +1,14 @@
+import type { FTReplayPrivacyMode } from './types.js';
+/** Shape of the ReplayPrivacy editor script installed in the project's assets. */
+interface ReplayPrivacyComponent {
+    node: unknown;
+    enabledInHierarchy: boolean;
+    isValid: boolean;
+    readonly replayPrivacyMode: 'mask' | 'hide';
+}
+/** Resolve rules afresh for each capture, including newly instantiated prefabs. */
+export declare function collectReplayPrivacyNodes(overrides: ReadonlyMap<unknown, FTReplayPrivacyMode>, components: ReplayPrivacyComponent[], editBoxes: {
+    node: unknown;
+}[]): Map<unknown, FTReplayPrivacyMode>;
+export {};
+//# sourceMappingURL=replay-privacy-nodes.d.ts.map

package/dist/creator2/core/replay-privacy-nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay-privacy-nodes.d.ts","sourceRoot":"","sources":["../../../../../src/core/replay-privacy-nodes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,kFAAkF;AAClF,UAAU,sBAAsB;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,kBAAkB,EAAE,OAAO,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7C;AAED,mFAAmF;AACnF,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,WAAW,CAAC,OAAO,EAAE,mBAAmB,CAAC,EACpD,UAAU,EAAE,sBAAsB,EAAE,EACpC,SAAS,EAAE;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,EAAE,GAC7B,GAAG,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAUnC"}

package/dist/creator2/core/replay-privacy-nodes.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectReplayPrivacyNodes = collectReplayPrivacyNodes;
+/** Resolve rules afresh for each capture, including newly instantiated prefabs. */
+function collectReplayPrivacyNodes(overrides, components, editBoxes) {
+    var nodes = new Map(overrides);
+    components.forEach(function (component) {
+        if (!component.isValid || !component.enabledInHierarchy || nodes.has(component.node))
+            return;
+        nodes.set(component.node, component.replayPrivacyMode === 'hide' ? 'hide' : 'mask');
+    });
+    editBoxes.forEach(function (editBox) {
+        if (!nodes.has(editBox.node))
+            nodes.set(editBox.node, 'mask');
+    });
+    return nodes;
+}
+//# sourceMappingURL=replay-privacy-nodes.js.map

package/dist/creator2/core/replay-privacy-nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay-privacy-nodes.js","sourceRoot":"","sources":["../../../../../src/core/replay-privacy-nodes.ts"],"names":[],"mappings":";;AAWA,8DAcC;AAfD,mFAAmF;AACnF,SAAgB,yBAAyB,CACvC,SAAoD,EACpD,UAAoC,EACpC,SAA8B;IAE9B,IAAM,KAAK,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;IACjC,UAAU,CAAC,OAAO,CAAC,UAAC,SAAS;QAC3B,IAAI,CAAC,SAAS,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,kBAAkB,IAAI,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC;YAAE,OAAO;QAC7F,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,iBAAiB,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;IACH,SAAS,CAAC,OAAO,CAAC,UAAC,OAAO;QACxB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC;YAAE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC"}

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

@@ -7,7 +7,7 @@ export interface FTCanvasCapture {
     } | undefined;
     capture(maxImageDimension: number): Promise<FTCapturedFrame | undefined>;
     persist(frame: FTCapturedFrame, fingerprint: string): Promise<FTStoredFrame>;
-    disposeStoredFrame(frame: FTStoredFrame): void;
+    disposeStoredFrame(frame: FTStoredFrame): void | Promise<void>;
     setPrivacy(node: unknown, mode: 'mask' | 'hide' | 'unmask'): void;
 }
 export interface FTReplayPointerEvent {
@@ -73,8 +73,9 @@ export declare class FTSessionReplay {
      * 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.
+     * `unmask` clears an earlier code override, restoring any ReplayPrivacy
+     * component rule or default input masking. Code overrides take priority over
+     * a component on the same node. 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.
@@ -85,6 +86,7 @@ export declare class FTSessionReplay {
     private schedule;
     private readContext;
     private saveImage;
+    private invokeSaveImage;
     private writePendingPointers;
     private scaledPendingPointers;
     private updateRecordCount;

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

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

package/dist/creator2/core/replay.js

@@ -86,7 +86,7 @@ var FTSessionReplay = /** @class */ (function () {
     FTSessionReplay.prototype.start = function (config) {
         if (config === void 0) { config = {}; }
         if (this.mode === 'hybrid') {
-            throw new Error('Hybrid Replay is managed by guanceSdk.enterCocos() and leaveCocos()');
+            throw new Error('Hybrid Replay is managed by enterCocos() and leaveCocos()');
         }
         if (this.mode === 'standalone')
             return;
@@ -119,7 +119,7 @@ var FTSessionReplay = /** @class */ (function () {
     /** @internal */
     FTSessionReplay.prototype.enterHybrid = function () {
         if (this.mode !== 'hybrid') {
-            throw new Error('Call guanceSdk.attach() before entering Hybrid Replay');
+            throw new Error('Call attach() before entering Hybrid Replay');
         }
         if (!this.hybridReplayEnabled || this.running)
             return;
@@ -148,7 +148,7 @@ var FTSessionReplay = /** @class */ (function () {
     /** Stops standalone Cocos canvas capture and native Session Replay. */
     FTSessionReplay.prototype.stop = function () {
         if (this.mode === 'hybrid') {
-            throw new Error('Hybrid Replay is managed by guanceSdk.enterCocos() and leaveCocos()');
+            throw new Error('Hybrid Replay is managed by enterCocos() and leaveCocos()');
         }
         if (this.mode === 'idle')
             return;
@@ -160,8 +160,9 @@ var FTSessionReplay = /** @class */ (function () {
      * 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.
+     * `unmask` clears an earlier code override, restoring any ReplayPrivacy
+     * component rule or default input masking. Code overrides take priority over
+     * a component on the same node. 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.
@@ -186,7 +187,7 @@ var FTSessionReplay = /** @class */ (function () {
                         pointerSize = this.lastImageSize;
                         _c.label = 1;
                     case 1:
-                        _c.trys.push([1, 4, 5, 6]);
+                        _c.trys.push([1, 5, 6, 11]);
                         context = this.readContext();
                         if (!context)
                             return [2 /*return*/, false];
@@ -250,7 +251,11 @@ var FTSessionReplay = /** @class */ (function () {
                         stored = _c.sent();
                         if (generation !== this.captureGeneration)
                             return [2 /*return*/, false];
-                        saved = this.saveImage(stored, decision.compressionQuality, decision.maxFrameBytes);
+                        return [4 /*yield*/, this.saveImage(stored, decision.compressionQuality, decision.maxFrameBytes)];
+                    case 4:
+                        saved = _c.sent();
+                        if (generation !== this.captureGeneration)
+                            return [2 /*return*/, false];
                         if (!saved) {
                             (0, replay_diagnostics_js_1.emitReplayDiagnostic)({ type: 'capture_skipped', timestamp: now, reason: 'budget' });
                             return [2 /*return*/, this.writePendingPointers(context, frame.width, frame.height)];
@@ -280,8 +285,10 @@ var FTSessionReplay = /** @class */ (function () {
                         this.lastImageSize = { width: saved.width, height: saved.height };
                         this.lastViewportSize = viewportSize;
                         return [2 /*return*/, true];
-                    case 4:
+                    case 5:
                         error_1 = _c.sent();
+                        if (generation !== this.captureGeneration)
+                            return [2 /*return*/, false];
                         (0, replay_diagnostics_js_1.emitReplayDiagnostic)({ type: 'capture_skipped', timestamp: Date.now(), reason: 'error' });
                         console.error('[cocos-sdk] Session Replay frame dropped:', error_1);
                         if (context && pointerSize) {
@@ -293,12 +300,19 @@ var FTSessionReplay = /** @class */ (function () {
                             }
                         }
                         return [2 /*return*/, false];
-                    case 5:
-                        if (stored)
-                            this.capture.disposeStoredFrame(stored);
+                    case 6:
+                        _c.trys.push([6, , 9, 10]);
+                        if (!stored) return [3 /*break*/, 8];
+                        return [4 /*yield*/, this.capture.disposeStoredFrame(stored)];
+                    case 7:
+                        _c.sent();
+                        _c.label = 8;
+                    case 8: return [3 /*break*/, 10];
+                    case 9:
                         this.busy = false;
                         return [7 /*endfinally*/];
-                    case 6: return [2 /*return*/];
+                    case 10: return [7 /*endfinally*/];
+                    case 11: return [2 /*return*/];
                 }
             });
         });
@@ -382,40 +396,59 @@ var FTSessionReplay = /** @class */ (function () {
         return normalizeRumContext(value);
     };
     FTSessionReplay.prototype.saveImage = function (stored, compressionQuality, maxFrameBytes) {
-        if (this.imagePolicyEnabled && this.supportsSaveImageV2 !== false) {
-            try {
-                var value = this.transport.invoke('replay.saveImageV2', {
-                    path: stored.path,
-                    width: stored.width,
-                    height: stored.height,
-                    quality: compressionQuality,
-                    maxFrameBytes: maxFrameBytes,
-                });
-                if (value !== undefined) {
-                    this.supportsSaveImageV2 = true;
-                    if (isRejectedSaveImageV2(value))
-                        return undefined;
-                    return __assign(__assign({}, normalizeSaveImageV2Result(value)), { byteSizeSource: 'native' });
+        return __awaiter(this, void 0, void 0, function () {
+            var value, error_3, resourceId;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (!(this.imagePolicyEnabled && this.supportsSaveImageV2 !== false)) return [3 /*break*/, 4];
+                        _a.label = 1;
+                    case 1:
+                        _a.trys.push([1, 3, , 4]);
+                        return [4 /*yield*/, this.invokeSaveImage('replay.saveImageV2', {
+                                path: stored.path,
+                                width: stored.width,
+                                height: stored.height,
+                                quality: compressionQuality,
+                                maxFrameBytes: maxFrameBytes,
+                            })];
+                    case 2:
+                        value = _a.sent();
+                        if (value !== undefined) {
+                            this.supportsSaveImageV2 = true;
+                            if (isRejectedSaveImageV2(value))
+                                return [2 /*return*/, undefined];
+                            return [2 /*return*/, __assign(__assign({}, normalizeSaveImageV2Result(value)), { byteSizeSource: 'native' })];
+                        }
+                        this.supportsSaveImageV2 = false;
+                        return [3 /*break*/, 4];
+                    case 3:
+                        error_3 = _a.sent();
+                        if (!isUnknownBridgeMethod(error_3))
+                            throw error_3;
+                        this.supportsSaveImageV2 = false;
+                        return [3 /*break*/, 4];
+                    case 4: return [4 /*yield*/, this.invokeSaveImage('replay.saveImage', {
+                            path: stored.path,
+                            width: stored.width,
+                            height: stored.height,
+                        })];
+                    case 5:
+                        resourceId = _a.sent();
+                        if (!resourceId)
+                            return [2 /*return*/, undefined];
+                        return [2 /*return*/, __assign({ resourceId: 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' }, (this.transport.platform === 'ios' ? { mimeType: 'image/png' } : {}))];
                 }
-                this.supportsSaveImageV2 = false;
-            }
-            catch (error) {
-                if (!isUnknownBridgeMethod(error))
-                    throw error;
-                this.supportsSaveImageV2 = false;
-            }
-        }
-        var resourceId = this.transport.invoke('replay.saveImage', {
-            path: stored.path,
-            width: stored.width,
-            height: stored.height,
+            });
         });
-        if (!resourceId)
-            return undefined;
-        return __assign({ resourceId: 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' }, (this.transport.platform === 'ios' ? { mimeType: 'image/png' } : {}));
+    };
+    FTSessionReplay.prototype.invokeSaveImage = function (method, payload) {
+        return this.transport.invokeAsync
+            ? this.transport.invokeAsync(method, payload)
+            : Promise.resolve(this.transport.invoke(method, payload));
     };
     FTSessionReplay.prototype.writePendingPointers = function (context, width, height) {
         var pointerEvents = this.scaledPendingPointers(width, height);