@cloudcare/cocos-sdk 0.1.0-alpha.5 → 0.1.0-alpha.7

package/README.md

@@ -7,7 +7,7 @@
 
 ## Introduction
 
-Guance Cloud Application Monitoring collects and analyzes RUM, Log, Trace, and Session Replay data from Cocos Creator applications. The SDK supports native Android and iOS builds for Cocos Creator 2.4 and 3.x.
+Guance Cloud Application Monitoring collects and analyzes RUM, Log, and Trace data from Cocos Creator applications. The SDK supports native Android and iOS builds for Cocos Creator 2.4 and 3.x.
 
 ## Supported Scope
 
@@ -18,6 +18,18 @@ Guance Cloud Application Monitoring collects and analyzes RUM, Log, Trace, and S
 
 Cocos Creator 3.0–3.6.2 is supported on a best-effort basis because the stable native build extension API starts at 3.6.3. Web, mini-game, and desktop targets are not currently supported.
 
+## Optional Session Replay
+
+Session Replay is distributed separately as `@cloudcare/cocos-session-replay`.
+Install both packages at the exact same version and run `npx guance-cocos install --replay`.
+Compose the SDK with `withSessionReplay` from the matching `/creator2` or `/creator3` entry
+before using Replay configuration. Camera selection moves to `sdk.setReplayCamera(camera)`.
+
+Base-only applications continue using this package and its normal initialization API.
+Run `npx guance-cocos install --no-replay` and rebuild to remove an existing SDK-managed
+Replay native integration. Existing scene component scripts and metadata are preserved.
+See the [Replay package guide](https://github.com/GuanceCloud/datakit-cocos/tree/main/packages/cocos-session-replay).
+
 ## iOS dependency manager
 
 CocoaPods remains the default. To use Swift Package Manager, add

package/bin/cli.cjs

@@ -3,6 +3,8 @@
 
 const fs = require('fs');
 const path = require('path');
+const { createRequire } = require('module');
+const { syncManagedDirectory } = require('./managed-assets.cjs');
 
 const packageRoot = path.resolve(__dirname, '..');
 const metadata = require(path.join(packageRoot, 'package.json'));
@@ -34,19 +36,45 @@ if (manager !== undefined && !['spm', 'cocoapods'].includes(manager)) {
 }
 const configFile = path.join(projectRoot, 'cocos-sdk.config.json');
 const config = readJson(configFile) || {};
-if (manager !== undefined) {
-  config.ios = { ...config.ios, dependencyManager: manager };
-  fs.writeFileSync(configFile, `${JSON.stringify(config, null, 2)}\n`);
+if (rawArguments.includes('--replay') && rawArguments.includes('--no-replay')) fail('Choose either --replay or --no-replay.');
+const replayEnabled = rawArguments.includes('--replay') ? true
+  : rawArguments.includes('--no-replay') ? false : config.replay?.enabled === true;
+let replayRoot;
+let replayDescriptor;
+if (replayEnabled) {
+  try {
+    const projectRequire = createRequire(path.join(projectRoot, 'package.json'));
+    replayRoot = path.dirname(projectRequire.resolve('@cloudcare/cocos-session-replay/package.json'));
+  } catch {
+    fail('Session Replay is not installed. Install @cloudcare/cocos-session-replay at the same version as @cloudcare/cocos-sdk, then rerun with --replay.');
+  }
+  const replayPackage = readJson(path.join(replayRoot, 'package.json'));
+  replayDescriptor = readJson(path.join(replayRoot, 'native-integration.json'));
+  if (replayPackage.version !== metadata.version || replayPackage.peerDependencies?.[metadata.name] !== metadata.version
+    || replayDescriptor?.schemaVersion !== 1 || replayDescriptor?.version !== metadata.version || replayDescriptor?.baseVersion !== metadata.version) {
+    fail('Replay package and native integration must exactly match the base SDK version.');
+  }
 }
-
-copyDirectory(extensionSource, destination);
-copyDirectory(path.join(packageRoot, 'native'), path.join(destination, 'native'));
+const sources = [{ root: extensionSource }, { root: path.join(packageRoot, 'native'), prefix: 'native/' }];
+if (replayRoot) sources.push({ root: path.join(replayRoot, 'native'), prefix: 'replay-native/' });
+const generated = {
+  'sdk-integration.json': JSON.stringify({ schemaVersion: 1, version: metadata.version, replay: replayEnabled }, null, 2) + '\n',
+};
+if (replayDescriptor) generated['replay-integration.json'] = JSON.stringify(replayDescriptor, null, 2) + '\n';
+syncManagedDirectory(destination, sources, generated);
 const componentDestination = path.join(projectRoot, 'assets', 'guance-cocos-sdk');
-copyDirectory(path.join(packageRoot, 'components', `creator${creatorMajor}`), componentDestination);
-
+if (replayRoot) syncManagedDirectory(componentDestination, [{ root: path.join(replayRoot, 'components', `creator${creatorMajor}`) }]);
+// Keep existing component scripts and .meta files when disabling Replay: scenes may reference them.
+if (manager !== undefined) config.ios = { ...config.ios, dependencyManager: manager };
+if (rawArguments.includes('--replay') || rawArguments.includes('--no-replay') || config.replay) {
+  config.replay = { ...config.replay, enabled: replayEnabled };
+}
+if (manager !== undefined || rawArguments.includes('--replay') || rawArguments.includes('--no-replay')) {
+  fs.writeFileSync(configFile, `${JSON.stringify(config, null, 2)}\n`);
+}
 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`
+  `Installed ${metadata.name} for Cocos Creator ${creatorMajor} at ${destination} (Replay: ${replayEnabled ? 'enabled' : 'disabled'})\n`
+  + (replayEnabled ? `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)) {
@@ -111,17 +139,6 @@ function readOption(argumentsList, name) {
   return inline ? inline.slice(prefix.length) : undefined;
 }
 
-function copyDirectory(source, destinationPath) {
-  if (!fs.existsSync(source)) fail(`Missing package asset: ${source}`);
-  fs.mkdirSync(destinationPath, { recursive: true });
-  for (const entry of fs.readdirSync(source, { withFileTypes: true })) {
-    const from = path.join(source, entry.name);
-    const to = path.join(destinationPath, entry.name);
-    if (entry.isDirectory()) copyDirectory(from, to);
-    else fs.copyFileSync(from, to);
-  }
-}
-
 function printHelp() {
   process.stdout.write([
     'Usage: npx @cloudcare/cocos-sdk install [options]',
@@ -129,6 +146,8 @@ function printHelp() {
     'Options:',
     '  --project <path>  Cocos project root (defaults to the current directory)',
     '  --creator <2|3>   Override automatic Cocos Creator version detection',
+    '  --replay         Include the separately installed Session Replay package',
+    '  --no-replay      Remove SDK-managed Replay native integration on rebuild',
     '  --ios-dependency-manager <spm|cocoapods>  Save the iOS dependency manager in cocos-sdk.config.json',
     '  -h, --help        Show this help',
     '',

package/bin/legacy-asset-hashes.json

@@ -0,0 +1,27 @@
+[
+  "058341971ed42ddfde76c28ce19fcc0bba5020fec1f7e1c613c7bda7d2df7677",
+  "11ee16e609096ccfe90b17f61d87ab65275a39df4bef6f8c29577e7395aa00f8",
+  "15338071a78f1505265cc8efbdc9628e9362f7a2c9fc00989d57461126f8f3f5",
+  "1a51af27d68cdf0bf3ce709c9cd60f9b8a2d7defd46d06896ce9a916e1dfc767",
+  "2caa0d3d542f5cca0b6b7f3aa2851c7e296b08fce286202a844b52920b1f6dc0",
+  "3189144de638b936e14d64ddbf9d4c95e95146ceecc357021473ca8adcc757d1",
+  "48ff77a12a7b9b59172f5470a642f23e4c61e9f7e10ee6d9d3f4f41377d696ac",
+  "4d2dcd924f1073b8a6fb94d342bee33a281f93c19302104be172e5de9981b3f0",
+  "51c71e12df61cfe7e75c3d97080e31a398fbea8719a3e964cec5dd332df1202c",
+  "5f33108f27f38836214f2c11badd7bb76ba9ec090f9d5b1490834a9257976939",
+  "85ad9622480d954c33a4f9442a391f6d3d9d617a2f1261e5ad769170c6e9cf12",
+  "86cf732195aad676898520192ac8aa878267877dc09f85fcf425279d8badc9b8",
+  "910792f383c25cd46ddc7d851080a687fa532a93d605fb709b7baff9bb2789cf",
+  "95bdc516c4e1b72833af3bec13b18e3c2ac6ae83de284c3f711e97765ed1b461",
+  "a748564f0bba03effbf4aa381308f60eedcb618cbd2a37e1c67cdbee596e9ceb",
+  "a8a57b5892e7a5063078d561fce790b44d900d2bb3869e43ed4c4de82f1f62ed",
+  "cd03df57f7861d19b0a8e0a97e8aff1fa08e5c26d4f43152743968245632535b",
+  "d26fb42c6bee416eaf29bc2ed8579edc7a28ca3d0e18433dcb8abea11fac9920",
+  "d2d171e4ef1777facdb6fe665105372ea2e6452028d4c32f5e2ccc74dacc8850",
+  "d538d9eebaf181687ebf8537fc6ce7c8fae59fa424daeb45c3f900a8e210ecfc",
+  "df8e3014e583d60922cd1b7f7f16964c433b260a7e1a7e6c285cb08ce2d9e7e4",
+  "e70ca2a537cec56f8424ff4d551c1e97af133938fc7ba863a3944859dcfd194d",
+  "f0211acbaaa312bd5a4478bba81fa98293c855692ceca69f141600ff991c5904",
+  "f09f9b35ddfb17a7c4e4439384afae93ded6ee0285e778ad013d320cfc880cab",
+  "fa88198c5434613ff5ab2d44dce6e7eb8b825085b5b498402810eb144cf81f96"
+]

package/bin/managed-assets.cjs

@@ -0,0 +1,67 @@
+'use strict';
+const fs = require('fs');
+const path = require('path');
+const { createHash } = require('crypto');
+const legacyHashes = new Set(require('./legacy-asset-hashes.json'));
+// Older combined installations predate the ownership manifest. Never leave a
+// locally modified obsolete Replay bridge compiling beside the new bridge.
+const legacyReplayNames = new Set(['FTCocosReplayImageJobs.java', 'FTCocosReplayImageJobs.h', 'FTCocosReplayImageJobs.m', 'FTReplayFileBridge.h', 'FTReplayFileWorker.h']);
+const manifestName = '.cocos-sdk-managed.json';
+const hash = bytes => createHash('sha256').update(bytes).digest('hex');
+
+function files(root) {
+  const result = [];
+  if (!fs.existsSync(root)) return result;
+  function visit(directory) {
+    for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
+      if (entry.name === manifestName || entry.name === '.DS_Store') continue;
+      const file = path.join(directory, entry.name);
+      if (entry.isSymbolicLink()) throw new Error(`[cocos-sdk] Refusing to copy symbolic link: ${file}`);
+      if (entry.isDirectory()) visit(file);
+      else result.push(path.relative(root, file).split(path.sep).join('/'));
+    }
+  }
+  visit(root);
+  return result;
+}
+
+/** Reconciles only files written by the SDK, preserving unrelated project assets. */
+function syncManagedDirectory(destination, sources, overrides = {}) {
+  const desired = new Map();
+  for (const { root, prefix = '' } of sources) {
+    if (!fs.existsSync(root)) throw new Error(`[cocos-sdk] Missing package assets: ${root}`);
+    for (const file of files(root)) desired.set(prefix + file, fs.readFileSync(path.join(root, file)));
+  }
+  for (const [file, content] of Object.entries(overrides)) desired.set(file, Buffer.from(content));
+  const manifest = path.join(destination, manifestName);
+  const previous = fs.existsSync(manifest) ? JSON.parse(fs.readFileSync(manifest, 'utf8')) : {};
+  const existing = files(destination);
+  const remove = [];
+  // Check every conflict before writing or deleting any managed file.
+  for (const file of existing) {
+    const digest = hash(fs.readFileSync(path.join(destination, file)));
+    const old = previous[file];
+    const next = desired.get(file);
+    const legacy = legacyHashes.has(digest);
+    if (!next && !old && !legacy && legacyReplayNames.has(path.basename(file))) {
+      throw new Error(`[cocos-sdk] Preserve or reconcile modified legacy Replay asset before reinstalling: ${path.join(destination, file)}`);
+    }
+    if ((old || next) && digest !== old && !legacy && (!next || digest !== hash(next))) {
+      throw new Error(`[cocos-sdk] Preserve or reconcile modified SDK asset before reinstalling: ${path.join(destination, file)}`);
+    }
+    if (!next && (old || legacy) && !file.endsWith('.meta')) remove.push(file);
+  }
+  fs.mkdirSync(destination, { recursive: true });
+  for (const file of remove) fs.unlinkSync(path.join(destination, file));
+  const nextManifest = {};
+  for (const [file, content] of desired) {
+    const target = path.resolve(destination, file);
+    if (!target.startsWith(path.resolve(destination) + path.sep)) throw new Error('Invalid SDK asset path');
+    fs.mkdirSync(path.dirname(target), { recursive: true });
+    if (!fs.existsSync(target) || hash(fs.readFileSync(target)) !== hash(content)) fs.writeFileSync(target, content);
+    nextManifest[file] = hash(content);
+  }
+  fs.writeFileSync(manifest, `${JSON.stringify(nextManifest, null, 2)}\n`);
+}
+
+module.exports = { syncManagedDirectory };

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

@@ -1,11 +1,55 @@
 import { FTLogger, FTMobileAgent, FTRUM, FTTrace } from './modules.js';
-import { FTSessionReplay, type FTCanvasCapture, type FTReplayPointerSource } from './replay.js';
 import type { FTNativeTransport } from './transport.js';
 import type { FTAutoTrackingConfig, FTCocosConfig, FTCocosEnterOptions, FTCocosHybridConfig } from './types.js';
 export interface FTAutoTrackingController {
     start(config: FTAutoTrackingConfig, viewName?: string): void;
     stop(): void;
 }
+export interface FTSDKLifecycle {
+    /**
+     * Validates or prepares the extension before standalone native SDK initialization.
+     * Throwing aborts startup before the base SDK is initialized.
+     */
+    beforeStart?(): void;
+    /**
+     * Starts the extension after the base SDK and configured modules initialize,
+     * but before Cocos automatic tracking starts. If this hook throws, the native
+     * SDK remains initialized; startup is not automatically rolled back.
+     */
+    afterStart?(): void;
+    /**
+     * Prepares the extension before the native Hybrid attachment call.
+     * The native host already owns SDK initialization at this point.
+     */
+    beforeAttach?(): void;
+    /**
+     * Undoes extension preparation if beforeAttach or the native attachment call
+     * fails. Must tolerate partial preparation; errors from this hook are ignored
+     * so the original attachment error can be rethrown.
+     */
+    rollbackAttach?(): void;
+    /**
+     * Starts extension activity when entering Cocos in Hybrid mode, before Cocos
+     * automatic tracking starts. A failure triggers the leave hook for cleanup.
+     */
+    enter?(): void;
+    /**
+     * Stops extension activity when leaving Cocos in Hybrid mode, after automatic
+     * tracking cleanup is attempted. Also runs if entering Cocos fails, so it must
+     * tolerate partial startup. The native host SDK must remain running.
+     */
+    leave?(): void;
+    /**
+     * Releases standalone extension resources after automatic tracking cleanup is
+     * attempted and before the base native SDK shuts down. Base SDK shutdown is
+     * still attempted if this hook throws. Not called for Hybrid applications.
+     */
+    shutdown?(): void;
+}
+export interface FTSDKExtension<T> {
+    value: T;
+    lifecycle: FTSDKLifecycle;
+}
 /**
  * Cocos SDK facade exposed through the platform entry point's SDK
  * singleton. Do not construct this class directly.
@@ -13,6 +57,7 @@ export interface FTAutoTrackingController {
 export declare class FTCocosSDK {
     private readonly transport;
     private readonly autoTracking?;
+    readonly engine: 'creator2' | 'creator3';
     /** Base SDK lifecycle and user-binding operations. */
     readonly mobile: FTMobileAgent;
     /** Real User Monitoring operations. */
@@ -21,12 +66,15 @@ export declare class FTCocosSDK {
     readonly logger: FTLogger;
     /** Distributed-tracing operations. */
     readonly trace: FTTrace;
-    /** Session Replay operations. */
-    readonly replay: FTSessionReplay;
+    readonly extensionProtocol = 1;
+    private extension;
+    private extensionId;
     private state;
     private hybridAutoTracking;
     private readonly ownership;
-    constructor(transport: FTNativeTransport, capture: FTCanvasCapture, autoTracking?: FTAutoTrackingController | undefined, pointerSource?: FTReplayPointerSource);
+    constructor(transport: FTNativeTransport, autoTracking?: FTAutoTrackingController | undefined, engine?: 'creator2' | 'creator3');
+    /** Attaches an optional package before SDK initialization. */
+    registerExtension<T>(id: string, version: string, engine: string, factory: () => FTSDKExtension<T>): T;
     /**
      * Initializes the native SDK and the configured modules for a standalone
      * Cocos application.
@@ -46,12 +94,12 @@ export declare class FTCocosSDK {
      * Call this once before the first {@link enterCocos}. This method does not
      * initialize or shut down the native SDK.
      *
-     * @param config - Cocos tracking and replay settings owned by the native host.
+     * @param config - Cocos tracking settings for the SDK owned by the native host.
      * @throws If standalone initialization has already started.
      */
     attach(config?: FTCocosHybridConfig): void;
     /**
-     * Starts Cocos automatic tracking and canvas replay capture in Hybrid mode.
+     * Starts Cocos automatic tracking and registered extensions in Hybrid mode.
      *
      * @param options - Options for the Cocos view being entered.
      * @throws If {@link attach} has not been called, or if `viewName` is omitted
@@ -59,7 +107,7 @@ export declare class FTCocosSDK {
      */
     enterCocos(options?: FTCocosEnterOptions): void;
     /**
-     * Stops Cocos automatic tracking and canvas replay capture in Hybrid mode.
+     * Stops Cocos automatic tracking and registered extensions in Hybrid mode.
      * The native host SDK remains running.
      */
     leaveCocos(): void;

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

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../../src/core/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAkB,OAAO,EAAE,MAAM,cAAc,CAAC;AACvF,OAAO,EACL,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC3B,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EACV,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,MAAM,EAAE,oBAAoB,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7D,IAAI,IAAI,IAAI,CAAC;CACd;AAID;;;GAGG;AACH,qBAAa,UAAU;IAiBnB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAE1B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;IAlBhC,sDAAsD;IACtD,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,uCAAuC;IACvC,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC;IACpB,0BAA0B;IAC1B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,sCAAsC;IACtC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IAEjC,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,kBAAkB,CAA4B;IACtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;gBAG/B,SAAS,EAAE,iBAAiB,EAC7C,OAAO,EAAE,eAAe,EACP,YAAY,CAAC,EAAE,wBAAwB,YAAA,EACxD,aAAa,CAAC,EAAE,qBAAqB;IASvC;;;;;;;;;;OAUG;IACH,KAAK,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAelC;;;;;;;;;OASG;IACH,MAAM,CAAC,MAAM,GAAE,mBAAwB,GAAG,IAAI;IAsB9C;;;;;;OAMG;IACH,UAAU,CAAC,OAAO,GAAE,mBAAwB,GAAG,IAAI;IA6BnD;;;OAGG;IACH,UAAU,IAAI,IAAI;IAWlB;;;;;OAKG;IACH,QAAQ,IAAI,IAAI;CAUjB"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../../src/core/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAkB,OAAO,EAAE,MAAM,cAAc,CAAC;AACvF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EACV,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,MAAM,EAAE,oBAAoB,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7D,IAAI,IAAI,IAAI,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,WAAW,CAAC,IAAI,IAAI,CAAC;IACrB;;;;OAIG;IACH,UAAU,CAAC,IAAI,IAAI,CAAC;IACpB;;;OAGG;IACH,YAAY,CAAC,IAAI,IAAI,CAAC;IACtB;;;;OAIG;IACH,cAAc,CAAC,IAAI,IAAI,CAAC;IACxB;;;OAGG;IACH,KAAK,CAAC,IAAI,IAAI,CAAC;IACf;;;;OAIG;IACH,KAAK,CAAC,IAAI,IAAI,CAAC;IACf;;;;OAIG;IACH,QAAQ,CAAC,IAAI,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,KAAK,EAAE,CAAC,CAAC;IACT,SAAS,EAAE,cAAc,CAAC;CAC3B;AAID;;;GAGG;AACH,qBAAa,UAAU;IAkBnB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU;IAnB1C,sDAAsD;IACtD,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,uCAAuC;IACvC,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC;IACpB,0BAA0B;IAC1B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,sCAAsC;IACtC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,iBAAiB,KAAK;IAC/B,OAAO,CAAC,SAAS,CAAsC;IACvD,OAAO,CAAC,WAAW,CAAqB;IAExC,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,kBAAkB,CAA4B;IACtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;gBAG/B,SAAS,EAAE,iBAAiB,EAC5B,YAAY,CAAC,EAAE,wBAAwB,YAAA,EAC/C,MAAM,GAAE,UAAU,GAAG,UAAuB;IAQvD,8DAA8D;IAC9D,iBAAiB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC;IAetG;;;;;;;;;;OAUG;IACH,KAAK,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAiBlC;;;;;;;;;OASG;IACH,MAAM,CAAC,MAAM,GAAE,mBAAwB,GAAG,IAAI;IAsB9C;;;;;;OAMG;IACH,UAAU,CAAC,OAAO,GAAE,mBAAwB,GAAG,IAAI;IA6BnD;;;OAGG;IACH,UAAU,IAAI,IAAI;IAclB;;;;;OAKG;IACH,QAAQ,IAAI,IAAI;CAcjB"}

package/dist/creator2/core/client.js

@@ -13,16 +13,18 @@ var __assign = (this && this.__assign) || function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FTCocosSDK = void 0;
 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 SDK
  * singleton. Do not construct this class directly.
  */
 var FTCocosSDK = /** @class */ (function () {
-    function FTCocosSDK(transport, capture, autoTracking, pointerSource) {
+    function FTCocosSDK(transport, autoTracking, engine) {
+        if (engine === void 0) { engine = 'creator3'; }
         this.transport = transport;
         this.autoTracking = autoTracking;
+        this.engine = engine;
+        this.extensionProtocol = 1;
         this.state = 'idle';
         this.hybridAutoTracking = {};
         this.ownership = new modules_js_1.FTSDKOwnership();
@@ -30,8 +32,24 @@ var FTCocosSDK = /** @class */ (function () {
         this.rum = new modules_js_1.FTRUM(transport, this.ownership);
         this.logger = new modules_js_1.FTLogger(transport, this.ownership);
         this.trace = new modules_js_1.FTTrace(transport, this.ownership);
-        this.replay = new replay_js_1.FTSessionReplay(transport, capture, pointerSource);
     }
+    /** Attaches an optional package before SDK initialization. */
+    FTCocosSDK.prototype.registerExtension = function (id, version, engine, factory) {
+        if (version !== version_js_1.FT_COCOS_SDK_VERSION || engine !== this.engine) {
+            throw new Error('SDK extension version or Creator engine does not match the base SDK');
+        }
+        if (this.extension) {
+            if (id !== this.extensionId)
+                throw new Error('A different SDK extension is already installed');
+            return this.extension.value;
+        }
+        if (this.state !== 'idle')
+            throw new Error('Install SDK extensions before start() or attach()');
+        var extension = factory();
+        this.extension = extension;
+        this.extensionId = id;
+        return extension.value;
+    };
     /**
      * Initializes the native SDK and the configured modules for a standalone
      * Cocos application.
@@ -44,10 +62,12 @@ var FTCocosSDK = /** @class */ (function () {
      * @throws If the SDK is already started or attached.
      */
     FTCocosSDK.prototype.start = function (config) {
-        var _a;
+        var _a, _b, _c, _d, _e, _f, _g;
+        rejectReplayConfig(config);
         if (this.state !== 'idle') {
             throw new Error('start() and attach() are mutually exclusive');
         }
+        (_c = (_a = this.extension) === null || _a === void 0 ? void 0 : (_b = _a.lifecycle).beforeStart) === null || _c === void 0 ? void 0 : _c.call(_b);
         this.mobile.start(config.sdk);
         // Base SDK installation already belongs to this Cocos runtime after the
         // first bridge call succeeds, even if a later optional module fails.
@@ -58,10 +78,9 @@ var FTCocosSDK = /** @class */ (function () {
             this.logger.start(config.logger);
         if (config.trace)
             this.trace.start(config.trace);
-        if (config.replay)
-            this.replay.start(config.replay);
+        (_f = (_d = this.extension) === null || _d === void 0 ? void 0 : (_e = _d.lifecycle).afterStart) === null || _f === void 0 ? void 0 : _f.call(_e);
         if (config.autoTrack)
-            (_a = this.autoTracking) === null || _a === void 0 ? void 0 : _a.start(config.autoTrack);
+            (_g = this.autoTracking) === null || _g === void 0 ? void 0 : _g.start(config.autoTrack);
     };
     /**
      * Attaches Cocos instrumentation to an SDK instance initialized by the
@@ -70,11 +89,13 @@ var FTCocosSDK = /** @class */ (function () {
      * Call this once before the first {@link enterCocos}. This method does not
      * initialize or shut down the native SDK.
      *
-     * @param config - Cocos tracking and replay settings owned by the native host.
+     * @param config - Cocos tracking settings for the SDK owned by the native host.
      * @throws If standalone initialization has already started.
      */
     FTCocosSDK.prototype.attach = function (config) {
+        var _a, _b, _c, _d, _e, _f;
         if (config === void 0) { config = {}; }
+        rejectReplayConfig(config);
         if (this.state === 'standalone') {
             throw new Error('start() and attach() are mutually exclusive');
         }
@@ -82,14 +103,16 @@ var FTCocosSDK = /** @class */ (function () {
             return;
         this.ownership.claimNativeHost();
         try {
-            this.replay.attachHybrid(config.replay);
+            (_c = (_a = this.extension) === null || _a === void 0 ? void 0 : (_b = _a.lifecycle).beforeAttach) === null || _c === void 0 ? void 0 : _c.call(_b);
             this.transport.invoke('hybrid.attach', {
-                requiresReplay: config.replay !== undefined,
                 sdkVersion: version_js_1.FT_COCOS_SDK_VERSION,
             });
         }
         catch (error) {
-            this.replay.detachHybrid();
+            try {
+                (_f = (_d = this.extension) === null || _d === void 0 ? void 0 : (_e = _d.lifecycle).rollbackAttach) === null || _f === void 0 ? void 0 : _f.call(_e);
+            }
+            catch ( /* Preserve attachment error. */_g) { /* Preserve attachment error. */ }
             this.ownership.releaseNativeHost();
             throw error;
         }
@@ -97,14 +120,14 @@ var FTCocosSDK = /** @class */ (function () {
         this.state = 'hybrid-attached';
     };
     /**
-     * Starts Cocos automatic tracking and canvas replay capture in Hybrid mode.
+     * Starts Cocos automatic tracking and registered extensions in Hybrid mode.
      *
      * @param options - Options for the Cocos view being entered.
      * @throws If {@link attach} has not been called, or if `viewName` is omitted
      * while automatic scene tracking is disabled.
      */
     FTCocosSDK.prototype.enterCocos = function (options) {
-        var _a, _b;
+        var _a, _b, _c, _d, _e, _f, _g, _h;
         if (options === void 0) { options = {}; }
         if (this.state === 'standalone') {
             throw new Error('enterCocos() is only available after attach()');
@@ -119,35 +142,42 @@ var FTCocosSDK = /** @class */ (function () {
             throw new TypeError('enterCocos.viewName is required when scene tracking is disabled');
         }
         try {
-            this.replay.enterHybrid();
-            (_a = this.autoTracking) === null || _a === void 0 ? void 0 : _a.start(this.hybridAutoTracking, viewName);
+            (_c = (_a = this.extension) === null || _a === void 0 ? void 0 : (_b = _a.lifecycle).enter) === null || _c === void 0 ? void 0 : _c.call(_b);
+            (_d = this.autoTracking) === null || _d === void 0 ? void 0 : _d.start(this.hybridAutoTracking, viewName);
             this.state = 'hybrid-entered';
         }
         catch (error) {
-            (_b = this.autoTracking) === null || _b === void 0 ? void 0 : _b.stop();
             try {
-                this.replay.leaveHybrid();
+                (_e = this.autoTracking) === null || _e === void 0 ? void 0 : _e.stop();
             }
-            catch (_c) {
+            catch ( /* Preserve the entry error. */_j) { /* Preserve the entry error. */ }
+            try {
+                (_h = (_f = this.extension) === null || _f === void 0 ? void 0 : (_g = _f.lifecycle).leave) === null || _h === void 0 ? void 0 : _h.call(_g);
+            }
+            catch (_k) {
                 // Preserve the error that prevented entering Cocos.
             }
             throw error;
         }
     };
     /**
-     * Stops Cocos automatic tracking and canvas replay capture in Hybrid mode.
+     * Stops Cocos automatic tracking and registered extensions in Hybrid mode.
      * The native host SDK remains running.
      */
     FTCocosSDK.prototype.leaveCocos = function () {
-        var _a;
+        var _a, _b, _c, _d;
         if (this.state === 'standalone') {
             throw new Error('leaveCocos() is only available after attach()');
         }
         if (this.state === 'idle' || this.state === 'hybrid-attached')
             return;
-        (_a = this.autoTracking) === null || _a === void 0 ? void 0 : _a.stop();
-        this.replay.leaveHybrid();
-        this.state = 'hybrid-attached';
+        try {
+            (_a = this.autoTracking) === null || _a === void 0 ? void 0 : _a.stop();
+        }
+        finally {
+            (_d = (_b = this.extension) === null || _b === void 0 ? void 0 : (_c = _b.lifecycle).leave) === null || _d === void 0 ? void 0 : _d.call(_c);
+            this.state = 'hybrid-attached';
+        }
     };
     /**
      * Stops a standalone SDK instance and releases its Cocos instrumentation.
@@ -156,16 +186,27 @@ var FTCocosSDK = /** @class */ (function () {
      * native host owns SDK shutdown.
      */
     FTCocosSDK.prototype.shutdown = function () {
-        var _a;
+        var _this = this;
         if (this.state === 'hybrid-attached' || this.state === 'hybrid-entered') {
             throw new Error('The native host owns the native SDK; call leaveCocos() instead of shutdown()');
         }
         if (this.state === 'idle')
             return;
-        (_a = this.autoTracking) === null || _a === void 0 ? void 0 : _a.stop();
-        this.replay.stop();
-        this.mobile.shutdown();
-        this.state = 'idle';
+        var failure;
+        var cleanup = function (operation) {
+            try {
+                operation();
+            }
+            catch (error) {
+                if (failure === undefined)
+                    failure = error;
+            }
+        };
+        cleanup(function () { var _a; return (_a = _this.autoTracking) === null || _a === void 0 ? void 0 : _a.stop(); });
+        cleanup(function () { var _a, _b, _c; return (_c = (_a = _this.extension) === null || _a === void 0 ? void 0 : (_b = _a.lifecycle).shutdown) === null || _c === void 0 ? void 0 : _c.call(_b); });
+        cleanup(function () { _this.mobile.shutdown(); _this.state = 'idle'; });
+        if (failure !== undefined)
+            throw failure;
     };
     return FTCocosSDK;
 }());
@@ -173,4 +214,9 @@ exports.FTCocosSDK = FTCocosSDK;
 function nonEmptyText(value) {
     return typeof value === 'string' && value.trim().length > 0 ? value : undefined;
 }
+function rejectReplayConfig(config) {
+    if ('replay' in config) {
+        throw new Error('Session Replay requires @cloudcare/cocos-session-replay. Install the package and use withSessionReplay() before passing replay configuration.');
+    }
+}
 //# sourceMappingURL=client.js.map

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/index.d.ts

@@ -1,3 +1,3 @@
-export type { FTAttributes, FTAutoTrackingConfig, FTCocosConfig, FTCocosEnterOptions, FTCocosHybridConfig, FTEnvironment, FTHybridSessionReplayConfig, FTLoggerConfig, FTLogLevel, FTPrimitive, FTReplayImagePolicy, FTReplayPrivacyMode, FTReplayQuality, FTReplayTouchPrivacy, FTResourceContent, FTResourceMetrics, FTRUMConfig, FTSDKConfig, FTSessionReplayConfig, FTTraceConfig, FTTraceType, FTUserData, FTValue, } from './types.js';
+export type { FTAttributes, FTAutoTrackingConfig, FTCocosConfig, FTCocosEnterOptions, FTCocosHybridConfig, FTEnvironment, FTLoggerConfig, FTLogLevel, FTPrimitive, FTResourceContent, FTResourceMetrics, FTRUMConfig, FTSDKConfig, FTTraceConfig, FTTraceType, FTUserData, FTValue, } from './types.js';
 export { FT_COCOS_SDK_VERSION } from './version.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,2BAA2B,EAC3B,cAAc,EACd,UAAU,EACV,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,qBAAqB,EACrB,aAAa,EACb,WAAW,EACX,UAAU,EACV,OAAO,GACR,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,aAAa,EACb,WAAW,EACX,UAAU,EACV,OAAO,GACR,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/index.ts"],"names":[],"mappings":";;;AA0BA,2CAAoD;AAA3C,kHAAA,oBAAoB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/index.ts"],"names":[],"mappings":";;;AAoBA,2CAAoD;AAA3C,kHAAA,oBAAoB,OAAA"}

package/dist/creator2/core/plugin-api.d.ts

@@ -0,0 +1,15 @@
+import type { FTCocosSDK as SDK } from './client.js';
+export type { FTSDKLifecycle, FTSDKExtension } from './client.js';
+export type { FTNativeTransport } from './transport.js';
+export type { FTAttributes, FTCocosConfig, FTCocosHybridConfig, FTCocosEnterOptions, FTValue } from './types.js';
+type Public<T> = {
+    [K in keyof T]: T[K];
+};
+/** Structural contract shared by the CommonJS and ES module engine builds. */
+export type FTCocosSDK = Omit<Public<SDK>, 'mobile' | 'rum' | 'logger' | 'trace'> & {
+    mobile: Public<SDK['mobile']>;
+    rum: Public<SDK['rum']>;
+    logger: Public<SDK['logger']>;
+    trace: Public<SDK['trace']>;
+};
+//# sourceMappingURL=plugin-api.d.ts.map

package/dist/creator2/core/plugin-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-api.d.ts","sourceRoot":"","sources":["../../../../../src/core/plugin-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,IAAI,GAAG,EAAE,MAAM,aAAa,CAAC;AACrD,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEjH,KAAK,MAAM,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC;AAE1C,8EAA8E;AAC9E,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC,GAAG;IAClF,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC9B,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;CAC7B,CAAC"}

package/dist/creator2/core/plugin-api.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=plugin-api.js.map

package/dist/creator2/core/plugin-api.js.map

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