@cloudcare/cocos-sdk 0.1.0-alpha.1

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

@@ -0,0 +1,74 @@
+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;
+}
+/**
+ * Cocos SDK facade exposed through the platform entry point's `guanceSdk`
+ * singleton. Do not construct this class directly.
+ */
+export declare class FTCocosSDK {
+    private readonly transport;
+    private readonly autoTracking?;
+    /** Base SDK lifecycle and user-binding operations. */
+    readonly mobile: FTMobileAgent;
+    /** Real User Monitoring operations. */
+    readonly rum: FTRUM;
+    /** Logging operations. */
+    readonly logger: FTLogger;
+    /** Distributed-tracing operations. */
+    readonly trace: FTTrace;
+    /** Session Replay operations. */
+    readonly replay: FTSessionReplay;
+    private state;
+    private hybridAutoTracking;
+    private readonly ownership;
+    constructor(transport: FTNativeTransport, capture: FTCanvasCapture, autoTracking?: FTAutoTrackingController | undefined, pointerSource?: FTReplayPointerSource);
+    /**
+     * Initializes the native SDK and the configured modules for a standalone
+     * Cocos application.
+     *
+     * Call this once during application startup. Do not combine it with
+     * {@link attach}, which is reserved for Hybrid applications initialized by
+     * a native host.
+     *
+     * @param config - Base SDK settings and optional module configurations.
+     * @throws If the SDK is already started or attached.
+     */
+    start(config: FTCocosConfig): void;
+    /**
+     * Attaches Cocos instrumentation to an SDK instance initialized by the
+     * native host application.
+     *
+     * 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.
+     * @throws If standalone initialization has already started.
+     */
+    attach(config?: FTCocosHybridConfig): void;
+    /**
+     * Starts Cocos automatic tracking and canvas replay capture 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.
+     */
+    enterCocos(options?: FTCocosEnterOptions): void;
+    /**
+     * Stops Cocos automatic tracking and canvas replay capture in Hybrid mode.
+     * The native host SDK remains running.
+     */
+    leaveCocos(): void;
+    /**
+     * Stops a standalone SDK instance and releases its Cocos instrumentation.
+     *
+     * Hybrid applications should call {@link leaveCocos} instead because the
+     * native host owns SDK shutdown.
+     */
+    shutdown(): void;
+}
+//# sourceMappingURL=client.d.ts.map

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

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

package/dist/creator3/core/client.js

@@ -0,0 +1,158 @@
+import { FTLogger, FTMobileAgent, FTRUM, FTSDKOwnership, FTTrace } from './modules.js';
+import { FTSessionReplay, } from './replay.js';
+import { FT_COCOS_SDK_VERSION } from './version.js';
+/**
+ * Cocos SDK facade exposed through the platform entry point's `guanceSdk`
+ * singleton. Do not construct this class directly.
+ */
+export class FTCocosSDK {
+    constructor(transport, capture, autoTracking, pointerSource) {
+        this.transport = transport;
+        this.autoTracking = autoTracking;
+        this.state = 'idle';
+        this.hybridAutoTracking = {};
+        this.ownership = new FTSDKOwnership();
+        this.mobile = new FTMobileAgent(transport, this.ownership);
+        this.rum = new FTRUM(transport, this.ownership);
+        this.logger = new FTLogger(transport, this.ownership);
+        this.trace = new FTTrace(transport, this.ownership);
+        this.replay = new FTSessionReplay(transport, capture, pointerSource);
+    }
+    /**
+     * Initializes the native SDK and the configured modules for a standalone
+     * Cocos application.
+     *
+     * Call this once during application startup. Do not combine it with
+     * {@link attach}, which is reserved for Hybrid applications initialized by
+     * a native host.
+     *
+     * @param config - Base SDK settings and optional module configurations.
+     * @throws If the SDK is already started or attached.
+     */
+    start(config) {
+        var _a;
+        if (this.state !== 'idle') {
+            throw new Error('guanceSdk.start() and guanceSdk.attach() are mutually exclusive');
+        }
+        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.
+        this.state = 'standalone';
+        if (config.rum)
+            this.rum.start(config.rum);
+        if (config.logger)
+            this.logger.start(config.logger);
+        if (config.trace)
+            this.trace.start(config.trace);
+        if (config.replay)
+            this.replay.start(config.replay);
+        if (config.autoTrack)
+            (_a = this.autoTracking) === null || _a === void 0 ? void 0 : _a.start(config.autoTrack);
+    }
+    /**
+     * Attaches Cocos instrumentation to an SDK instance initialized by the
+     * native host application.
+     *
+     * 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.
+     * @throws If standalone initialization has already started.
+     */
+    attach(config = {}) {
+        if (this.state === 'standalone') {
+            throw new Error('guanceSdk.start() and guanceSdk.attach() are mutually exclusive');
+        }
+        if (this.state === 'hybrid-attached' || this.state === 'hybrid-entered')
+            return;
+        this.ownership.claimNativeHost();
+        try {
+            this.replay.attachHybrid(config.replay);
+            this.transport.invoke('hybrid.attach', {
+                requiresReplay: config.replay !== undefined,
+                sdkVersion: FT_COCOS_SDK_VERSION,
+            });
+        }
+        catch (error) {
+            this.replay.detachHybrid();
+            this.ownership.releaseNativeHost();
+            throw error;
+        }
+        this.hybridAutoTracking = { ...(config.autoTrack || {}) };
+        this.state = 'hybrid-attached';
+    }
+    /**
+     * Starts Cocos automatic tracking and canvas replay capture 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.
+     */
+    enterCocos(options = {}) {
+        var _a, _b;
+        if (this.state === 'standalone') {
+            throw new Error('guanceSdk.enterCocos() is only available after guanceSdk.attach()');
+        }
+        if (this.state === 'idle') {
+            throw new Error('Call guanceSdk.attach() before guanceSdk.enterCocos()');
+        }
+        if (this.state === 'hybrid-entered')
+            return;
+        const viewName = nonEmptyText(options.viewName);
+        if (!this.hybridAutoTracking.scenes && !viewName) {
+            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);
+            this.state = 'hybrid-entered';
+        }
+        catch (error) {
+            (_b = this.autoTracking) === null || _b === void 0 ? void 0 : _b.stop();
+            try {
+                this.replay.leaveHybrid();
+            }
+            catch (_c) {
+                // Preserve the error that prevented entering Cocos.
+            }
+            throw error;
+        }
+    }
+    /**
+     * Stops Cocos automatic tracking and canvas replay capture in Hybrid mode.
+     * The native host SDK remains running.
+     */
+    leaveCocos() {
+        var _a;
+        if (this.state === 'standalone') {
+            throw new Error('guanceSdk.leaveCocos() is only available after guanceSdk.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';
+    }
+    /**
+     * Stops a standalone SDK instance and releases its Cocos instrumentation.
+     *
+     * Hybrid applications should call {@link leaveCocos} instead because the
+     * native host owns SDK shutdown.
+     */
+    shutdown() {
+        var _a;
+        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';
+    }
+}
+function nonEmptyText(value) {
+    return typeof value === 'string' && value.trim().length > 0 ? value : undefined;
+}
+//# sourceMappingURL=client.js.map

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

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

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

@@ -0,0 +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 { FT_COCOS_SDK_VERSION } from './version.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/creator3/core/index.js

@@ -0,0 +1,2 @@
+export { FT_COCOS_SDK_VERSION } from './version.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/index.ts"],"names":[],"mappings":"AA0BA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC"}

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

@@ -0,0 +1,159 @@
+import type { FTNativeTransport } from './transport.js';
+import type { FTAttributes, FTLogLevel, FTLoggerConfig, FTResourceContent, FTResourceMetrics, FTRUMConfig, FTSDKConfig, FTTraceConfig, FTUserData } from './types.js';
+export declare class FTSDKOwnership {
+    private mode;
+    claimStandalone(): void;
+    claimNativeHost(): void;
+    releaseNativeHost(): void;
+    releaseStandalone(): void;
+    assertNativeHostDoesNotOwnSDK(): void;
+}
+/** Base SDK lifecycle and user identity operations. */
+export declare class FTMobileAgent {
+    private readonly transport;
+    private readonly ownership;
+    constructor(transport: FTNativeTransport, ownership?: FTSDKOwnership);
+    /**
+     * Initializes the native SDK connection.
+     *
+     * Supply either `datakitUrl`, or both `datawayUrl` and `clientToken`.
+     *
+     * @param config - Base SDK connection and service settings.
+     */
+    start(config: FTSDKConfig): void;
+    /**
+     * Binds a user identity to data collected after this call.
+     *
+     * @param user - A user ID or a structured user record.
+     */
+    bindUser(user: FTUserData | string): void;
+    /** Removes the currently bound user identity. */
+    unbindUser(): void;
+    /** Shuts down a standalone native SDK instance. */
+    shutdown(): void;
+}
+/** Manual Real User Monitoring operations. */
+export declare class FTRUM {
+    private readonly transport;
+    private readonly ownership;
+    constructor(transport: FTNativeTransport, ownership?: FTSDKOwnership);
+    /**
+     * Enables RUM with the supplied native and Cocos settings.
+     *
+     * @param config - RUM application IDs, sampling, and native tracking options.
+     */
+    start(config: FTRUMConfig): void;
+    /**
+     * Starts a RUM view.
+     *
+     * @param name - Application-defined view name.
+     * @param attributes - Optional attributes attached to the view.
+     */
+    startView(name: string, attributes?: FTAttributes): void;
+    /**
+     * Stops the currently active RUM view.
+     *
+     * @param attributes - Optional attributes attached when the view stops.
+     */
+    stopView(attributes?: FTAttributes): void;
+    /**
+     * Records a completed RUM action.
+     *
+     * @param name - Application-defined action name.
+     * @param type - Action category. @defaultValue `'click'`
+     * @param attributes - Optional attributes attached to the action.
+     */
+    addAction(name: string, type?: string, attributes?: FTAttributes): void;
+    /**
+     * Starts a RUM action whose completion is detected by the native SDK.
+     *
+     * @param name - Application-defined action name.
+     * @param type - Action category. @defaultValue `'click'`
+     * @param attributes - Optional attributes attached to the action.
+     */
+    startAction(name: string, type?: string, attributes?: FTAttributes): void;
+    /**
+     * Records an application error.
+     *
+     * @param message - Human-readable error message.
+     * @param stack - Error stack or diagnostic details.
+     * @param type - Application-defined error category. @defaultValue `'cocos_error'`
+     * @param state - Application state when the error occurred. @defaultValue `'run'`
+     * @param attributes - Optional attributes attached to the error.
+     */
+    addError(message: string, stack: string, type?: string, state?: 'run' | 'startup' | 'unknown', attributes?: FTAttributes): void;
+    /**
+     * Records a long task.
+     *
+     * @param stack - Stack or diagnostic details for the task.
+     * @param durationNs - Task duration in nanoseconds.
+     * @param attributes - Optional attributes attached to the task.
+     */
+    addLongTask(stack: string, durationNs: number, attributes?: FTAttributes): void;
+    /**
+     * Starts tracking a resource using an application-defined correlation key.
+     *
+     * @param key - Key reused by subsequent calls for this resource.
+     * @param attributes - Optional attributes attached to the resource.
+     */
+    startResource(key: string, attributes?: FTAttributes): void;
+    /**
+     * Stops timing a resource previously started with {@link startResource}.
+     *
+     * @param key - Key passed to {@link startResource}.
+     * @param attributes - Optional attributes attached when timing stops.
+     */
+    stopResource(key: string, attributes?: FTAttributes): void;
+    /**
+     * Adds request, response, and optional timing details to a tracked resource.
+     *
+     * @param key - Key passed to {@link startResource} and {@link stopResource}.
+     * @param content - Request and response details safe to collect.
+     * @param metrics - Optional network timing metrics.
+     */
+    addResource(key: string, content: FTResourceContent, metrics?: FTResourceMetrics): void;
+}
+/** Manual logging operations. */
+export declare class FTLogger {
+    private readonly transport;
+    private readonly ownership;
+    constructor(transport: FTNativeTransport, ownership?: FTSDKOwnership);
+    /**
+     * Enables the native logger.
+     *
+     * @param config - Logger sampling, filtering, and cache settings.
+     */
+    start(config: FTLoggerConfig): void;
+    /**
+     * Writes a custom log entry.
+     *
+     * @param content - Log message.
+     * @param level - Log severity. @defaultValue `'info'`
+     * @param attributes - Optional attributes attached to the log.
+     */
+    log(content: string, level?: FTLogLevel, attributes?: FTAttributes): void;
+}
+/** Distributed-tracing operations. */
+export declare class FTTrace {
+    private readonly transport;
+    private readonly ownership;
+    constructor(transport: FTNativeTransport, ownership?: FTSDKOwnership);
+    /**
+     * Enables distributed tracing.
+     *
+     * @param config - Trace sampling and propagation settings.
+     */
+    start(config: FTTraceConfig): void;
+    /**
+     * Returns propagation headers for an outgoing request.
+     *
+     * Pass the same `resourceKey` used for manual RUM resource tracking to link
+     * the request with its trace.
+     *
+     * @param url - Absolute outgoing request URL.
+     * @param resourceKey - Optional key used for manual RUM resource tracking.
+     * @returns Headers to merge into the outgoing request.
+     */
+    getHeaders(url: string, resourceKey?: string): Record<string, string>;
+}
+//# sourceMappingURL=modules.d.ts.map

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

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