@truewatchtech/cocos-sdk 0.1.0-alpha.3

package/dist/creator3/core/modules.js

@@ -0,0 +1,293 @@
+import { requireText, samplingRate } from './validation.js';
+import { FT_COCOS_SDK_BRIDGE_INFO, FT_COCOS_SDK_BRIDGE_INFO_KEY, FT_COCOS_SDK_VERSION, FT_COCOS_SDK_VERSION_KEY, } from './version.js';
+export class FTSDKOwnership {
+    constructor() {
+        this.mode = 'unclaimed';
+    }
+    claimStandalone() {
+        if (this.mode === 'native-host') {
+            throw new Error('The native host owns SDK initialization in Hybrid mode');
+        }
+        this.mode = 'standalone';
+    }
+    claimNativeHost() {
+        if (this.mode === 'standalone') {
+            throw new Error('Standalone initialization and native-host attachment are mutually exclusive');
+        }
+        this.mode = 'native-host';
+    }
+    releaseNativeHost() {
+        if (this.mode === 'native-host')
+            this.mode = 'unclaimed';
+    }
+    releaseStandalone() {
+        if (this.mode === 'standalone')
+            this.mode = 'unclaimed';
+    }
+    assertNativeHostDoesNotOwnSDK() {
+        if (this.mode === 'native-host') {
+            throw new Error('The native host owns the native SDK in Hybrid mode');
+        }
+    }
+}
+function compact(value) {
+    const source = value;
+    const result = {};
+    Object.keys(value).forEach((key) => {
+        if (source[key] !== undefined)
+            result[key] = source[key];
+    });
+    return result;
+}
+function withBridgeInfo(attributes) {
+    return {
+        [FT_COCOS_SDK_BRIDGE_INFO_KEY]: FT_COCOS_SDK_BRIDGE_INFO,
+        ...(attributes || {}),
+    };
+}
+/** Base SDK lifecycle and user identity operations. */
+export class FTMobileAgent {
+    constructor(transport, ownership = new FTSDKOwnership()) {
+        this.transport = transport;
+        this.ownership = ownership;
+    }
+    /**
+     * Initializes the native SDK connection.
+     *
+     * Supply either `datakitUrl`, or both `datawayUrl` and `clientToken`.
+     *
+     * @param config - Base SDK connection and service settings.
+     */
+    start(config) {
+        if (!config.datakitUrl && !(config.datawayUrl && config.clientToken)) {
+            throw new TypeError('Configure datakitUrl or datawayUrl with clientToken');
+        }
+        this.ownership.claimStandalone();
+        this.transport.invoke('sdk.configure', compact({
+            ...config,
+            globalContext: {
+                ...(config.globalContext || {}),
+                [FT_COCOS_SDK_VERSION_KEY]: FT_COCOS_SDK_VERSION,
+            },
+        }));
+    }
+    /**
+     * Binds a user identity to data collected after this call.
+     *
+     * @param user - A user ID or a structured user record.
+     */
+    bindUser(user) {
+        this.transport.invoke('sdk.bindUser', typeof user === 'string' ? { userId: requireText(user, 'userId') } : user);
+    }
+    /** Removes the currently bound user identity. */
+    unbindUser() {
+        this.transport.invoke('sdk.unbindUser');
+    }
+    /** Shuts down a standalone native SDK instance. */
+    shutdown() {
+        this.ownership.assertNativeHostDoesNotOwnSDK();
+        this.transport.invoke('sdk.shutdown');
+        this.ownership.releaseStandalone();
+    }
+}
+/** Manual Real User Monitoring operations. */
+export class FTRUM {
+    constructor(transport, ownership = new FTSDKOwnership()) {
+        this.transport = transport;
+        this.ownership = ownership;
+    }
+    /**
+     * Enables RUM with the supplied native and Cocos settings.
+     *
+     * @param config - RUM application IDs, sampling, and native tracking options.
+     */
+    start(config) {
+        samplingRate(config.sampleRate, 'rum.sampleRate');
+        samplingRate(config.sessionOnErrorSampleRate, 'rum.sessionOnErrorSampleRate');
+        this.ownership.claimStandalone();
+        this.transport.invoke('rum.configure', compact(config));
+    }
+    /**
+     * Starts a RUM view.
+     *
+     * @param name - Application-defined view name.
+     * @param attributes - Optional attributes attached to the view.
+     */
+    startView(name, attributes) {
+        this.transport.invoke('rum.startView', {
+            name: requireText(name, 'view name'),
+            attributes: withBridgeInfo(attributes),
+        });
+    }
+    /**
+     * Stops the currently active RUM view.
+     *
+     * @param attributes - Optional attributes attached when the view stops.
+     */
+    stopView(attributes) {
+        this.transport.invoke('rum.stopView', { attributes: withBridgeInfo(attributes) });
+    }
+    /**
+     * 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, type = 'click', attributes) {
+        this.transport.invoke('rum.addAction', {
+            name: requireText(name, 'action name'),
+            type: requireText(type, 'action type'),
+            attributes: withBridgeInfo(attributes),
+        });
+    }
+    /**
+     * 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, type = 'click', attributes) {
+        this.transport.invoke('rum.startAction', {
+            name: requireText(name, 'action name'),
+            type: requireText(type, 'action type'),
+            attributes: withBridgeInfo(attributes),
+        });
+    }
+    /**
+     * 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, stack, type = 'cocos_error', state = 'run', attributes) {
+        this.transport.invoke('rum.addError', {
+            message,
+            stack,
+            type,
+            state,
+            attributes: withBridgeInfo(attributes),
+        });
+    }
+    /**
+     * 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, durationNs, attributes) {
+        this.transport.invoke('rum.addLongTask', {
+            stack,
+            durationNs,
+            attributes: withBridgeInfo(attributes),
+        });
+    }
+    /**
+     * 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, attributes) {
+        this.transport.invoke('rum.startResource', {
+            key: requireText(key, 'resource key'),
+            attributes: withBridgeInfo(attributes),
+        });
+    }
+    /**
+     * 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, attributes) {
+        this.transport.invoke('rum.stopResource', {
+            key: requireText(key, 'resource key'),
+            attributes: withBridgeInfo(attributes),
+        });
+    }
+    /**
+     * 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, content, metrics) {
+        this.transport.invoke('rum.addResource', {
+            key: requireText(key, 'resource key'),
+            content,
+            metrics,
+        });
+    }
+}
+/** Manual logging operations. */
+export class FTLogger {
+    constructor(transport, ownership = new FTSDKOwnership()) {
+        this.transport = transport;
+        this.ownership = ownership;
+    }
+    /**
+     * Enables the native logger.
+     *
+     * @param config - Logger sampling, filtering, and cache settings.
+     */
+    start(config) {
+        samplingRate(config.sampleRate, 'logger.sampleRate');
+        this.ownership.claimStandalone();
+        this.transport.invoke('logger.configure', compact(config));
+    }
+    /**
+     * 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, level = 'info', attributes) {
+        this.transport.invoke('logger.log', {
+            content,
+            level,
+            attributes: withBridgeInfo(attributes),
+        });
+    }
+}
+/** Distributed-tracing operations. */
+export class FTTrace {
+    constructor(transport, ownership = new FTSDKOwnership()) {
+        this.transport = transport;
+        this.ownership = ownership;
+    }
+    /**
+     * Enables distributed tracing.
+     *
+     * @param config - Trace sampling and propagation settings.
+     */
+    start(config) {
+        samplingRate(config.sampleRate, 'trace.sampleRate');
+        this.ownership.claimStandalone();
+        this.transport.invoke('trace.configure', compact(config));
+    }
+    /**
+     * 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, resourceKey) {
+        return this.transport.invoke('trace.getHeaders', {
+            url: requireText(url, 'url'),
+            resourceKey,
+        }) || {};
+    }
+}
+//# sourceMappingURL=modules.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"modules.js","sourceRoot":"","sources":["../../../../../src/core/modules.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EACL,wBAAwB,EACxB,4BAA4B,EAC5B,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,cAAc,CAAC;AAEtB,MAAM,OAAO,cAAc;IAA3B;QACU,SAAI,GAA+C,WAAW,CAAC;IA6BzE,CAAC;IA3BC,eAAe;QACb,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;IAED,eAAe;QACb,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;QACjG,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;IAED,iBAAiB;QACf,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa;YAAE,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC3D,CAAC;IAED,iBAAiB;QACf,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY;YAAE,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1D,CAAC;IAED,6BAA6B;QAC3B,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;CACF;AAED,SAAS,OAAO,CAAmB,KAAQ;IACzC,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;QACjC,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IACH,OAAO,MAAW,CAAC;AACrB,CAAC;AAED,SAAS,cAAc,CAAC,UAAyB;IAC/C,OAAO;QACL,CAAC,4BAA4B,CAAC,EAAE,wBAAwB;QACxD,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC;KACtB,CAAC;AACJ,CAAC;AAED,uDAAuD;AACvD,MAAM,OAAO,aAAa;IACxB,YACmB,SAA4B,EAC5B,YAAY,IAAI,cAAc,EAAE;QADhC,cAAS,GAAT,SAAS,CAAmB;QAC5B,cAAS,GAAT,SAAS,CAAuB;IAChD,CAAC;IAEJ;;;;;;OAMG;IACH,KAAK,CAAC,MAAmB;QACvB,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;YACrE,MAAM,IAAI,SAAS,CAAC,qDAAqD,CAAC,CAAC;QAC7E,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,CAAC;QACjC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,eAAe,EAAE,OAAO,CAAC;YAC7C,GAAG,MAAM;YACT,aAAa,EAAE;gBACb,GAAG,CAAC,MAAM,CAAC,aAAa,IAAI,EAAE,CAAC;gBAC/B,CAAC,wBAAwB,CAAC,EAAE,oBAAoB;aACjD;SACF,CAAC,CAAC,CAAC;IACN,CAAC;IAED;;;;OAIG;IACH,QAAQ,CAAC,IAAyB;QAChC,IAAI,CAAC,SAAS,CAAC,MAAM,CACnB,cAAc,EACd,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAC1E,CAAC;IACJ,CAAC;IAED,iDAAiD;IACjD,UAAU;QACR,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAC1C,CAAC;IAED,mDAAmD;IACnD,QAAQ;QACN,IAAI,CAAC,SAAS,CAAC,6BAA6B,EAAE,CAAC;QAC/C,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QACtC,IAAI,CAAC,SAAS,CAAC,iBAAiB,EAAE,CAAC;IACrC,CAAC;CACF;AAED,8CAA8C;AAC9C,MAAM,OAAO,KAAK;IAChB,YACmB,SAA4B,EAC5B,YAAY,IAAI,cAAc,EAAE;QADhC,cAAS,GAAT,SAAS,CAAmB;QAC5B,cAAS,GAAT,SAAS,CAAuB;IAChD,CAAC;IAEJ;;;;OAIG;IACH,KAAK,CAAC,MAAmB;QACvB,YAAY,CAAC,MAAM,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;QAClD,YAAY,CAAC,MAAM,CAAC,wBAAwB,EAAE,8BAA8B,CAAC,CAAC;QAC9E,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,CAAC;QACjC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,IAAY,EAAE,UAAyB;QAC/C,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,eAAe,EAAE;YACrC,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC;YACpC,UAAU,EAAE,cAAc,CAAC,UAAU,CAAC;SACvC,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,QAAQ,CAAC,UAAyB;QAChC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,UAAU,EAAE,cAAc,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IACpF,CAAC;IAED;;;;;;OAMG;IACH,SAAS,CAAC,IAAY,EAAE,IAAI,GAAG,OAAO,EAAE,UAAyB;QAC/D,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,eAAe,EAAE;YACrC,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE,aAAa,CAAC;YACtC,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE,aAAa,CAAC;YACtC,UAAU,EAAE,cAAc,CAAC,UAAU,CAAC;SACvC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,WAAW,CAAC,IAAY,EAAE,IAAI,GAAG,OAAO,EAAE,UAAyB;QACjE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,iBAAiB,EAAE;YACvC,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE,aAAa,CAAC;YACtC,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE,aAAa,CAAC;YACtC,UAAU,EAAE,cAAc,CAAC,UAAU,CAAC;SACvC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,QAAQ,CACN,OAAe,EACf,KAAa,EACb,IAAI,GAAG,aAAa,EACpB,QAAuC,KAAK,EAC5C,UAAyB;QAEzB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,cAAc,EAAE;YACpC,OAAO;YACP,KAAK;YACL,IAAI;YACJ,KAAK;YACL,UAAU,EAAE,cAAc,CAAC,UAAU,CAAC;SACvC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,WAAW,CAAC,KAAa,EAAE,UAAkB,EAAE,UAAyB;QACtE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,iBAAiB,EAAE;YACvC,KAAK;YACL,UAAU;YACV,UAAU,EAAE,cAAc,CAAC,UAAU,CAAC;SACvC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,aAAa,CAAC,GAAW,EAAE,UAAyB;QAClD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,mBAAmB,EAAE;YACzC,GAAG,EAAE,WAAW,CAAC,GAAG,EAAE,cAAc,CAAC;YACrC,UAAU,EAAE,cAAc,CAAC,UAAU,CAAC;SACvC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,GAAW,EAAE,UAAyB;QACjD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,kBAAkB,EAAE;YACxC,GAAG,EAAE,WAAW,CAAC,GAAG,EAAE,cAAc,CAAC;YACrC,UAAU,EAAE,cAAc,CAAC,UAAU,CAAC;SACvC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,WAAW,CACT,GAAW,EACX,OAA0B,EAC1B,OAA2B;QAE3B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,iBAAiB,EAAE;YACvC,GAAG,EAAE,WAAW,CAAC,GAAG,EAAE,cAAc,CAAC;YACrC,OAAO;YACP,OAAO;SACR,CAAC,CAAC;IACL,CAAC;CACF;AAED,iCAAiC;AACjC,MAAM,OAAO,QAAQ;IACnB,YACmB,SAA4B,EAC5B,YAAY,IAAI,cAAc,EAAE;QADhC,cAAS,GAAT,SAAS,CAAmB;QAC5B,cAAS,GAAT,SAAS,CAAuB;IAChD,CAAC;IAEJ;;;;OAIG;IACH,KAAK,CAAC,MAAsB;QAC1B,YAAY,CAAC,MAAM,CAAC,UAAU,EAAE,mBAAmB,CAAC,CAAC;QACrD,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,CAAC;QACjC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,kBAAkB,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;OAMG;IACH,GAAG,CAAC,OAAe,EAAE,QAAoB,MAAM,EAAE,UAAyB;QACxE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,YAAY,EAAE;YAClC,OAAO;YACP,KAAK;YACL,UAAU,EAAE,cAAc,CAAC,UAAU,CAAC;SACvC,CAAC,CAAC;IACL,CAAC;CACF;AAED,sCAAsC;AACtC,MAAM,OAAO,OAAO;IAClB,YACmB,SAA4B,EAC5B,YAAY,IAAI,cAAc,EAAE;QADhC,cAAS,GAAT,SAAS,CAAmB;QAC5B,cAAS,GAAT,SAAS,CAAuB;IAChD,CAAC;IAEJ;;;;OAIG;IACH,KAAK,CAAC,MAAqB;QACzB,YAAY,CAAC,MAAM,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;QACpD,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,CAAC;QACjC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,iBAAiB,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED;;;;;;;;;OASG;IACH,UAAU,CAAC,GAAW,EAAE,WAAoB;QAC1C,OACE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,kBAAkB,EAAE;YACxC,GAAG,EAAE,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC;YAC5B,WAAW;SACZ,CACF,IAAI,EAAE,CAAC;IACV,CAAC;CACF"}

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

@@ -0,0 +1,28 @@
+import type { FTResolvedReplayImagePolicy } from './validation.js';
+export declare const REPLAY_KEY_FRAME_BURST_BYTES: number;
+export interface FTReplayCaptureDecision {
+    allowed: boolean;
+    compressionQuality: number;
+    maxImageDimension: number;
+    maxFrameBytes: number;
+    usedBytes: number;
+    priority: boolean;
+    reason?: 'budget' | 'throttle';
+}
+/** Rolling image budget. Segment and pointer bytes intentionally remain outside this controller. */
+export declare class FTReplayBudget {
+    private readonly policy;
+    private entries;
+    private lastCaptureAttempt;
+    private burstKeys;
+    private pressure;
+    constructor(policy: FTResolvedReplayImagePolicy);
+    reset(): void;
+    decide(timestamp: number, priorityKey?: string): FTReplayCaptureDecision;
+    record(timestamp: number, byteSize: number, priorityKey?: string): void;
+    usedBytes(timestamp: number): number;
+    private prune;
+    private decision;
+    private updatePressure;
+}
+//# sourceMappingURL=replay-budget.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"replay-budget.d.ts","sourceRoot":"","sources":["../../../../../src/core/replay-budget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAInE,eAAO,MAAM,4BAA4B,QAAa,CAAC;AAOvD,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;CAChC;AAED,oGAAoG;AACpG,qBAAa,cAAc;IAMb,OAAO,CAAC,QAAQ,CAAC,MAAM;IALnC,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,QAAQ,CAA4D;gBAE/C,MAAM,EAAE,2BAA2B;IAEhE,KAAK,IAAI,IAAI;IAOb,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,uBAAuB;IA+BxE,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAUvE,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAKpC,OAAO,CAAC,KAAK;IAKb,OAAO,CAAC,QAAQ;IA2BhB,OAAO,CAAC,cAAc;CA0BvB"}

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

@@ -0,0 +1,105 @@
+const WINDOW_MS = 60000;
+const THROTTLED_CAPTURE_INTERVAL_MS = 2000;
+export const REPLAY_KEY_FRAME_BURST_BYTES = 100 * 1024;
+/** Rolling image budget. Segment and pointer bytes intentionally remain outside this controller. */
+export class FTReplayBudget {
+    constructor(policy) {
+        this.policy = policy;
+        this.entries = [];
+        this.burstKeys = [];
+        this.pressure = 'normal';
+    }
+    reset() {
+        this.entries = [];
+        this.lastCaptureAttempt = undefined;
+        this.burstKeys = [];
+        this.pressure = 'normal';
+    }
+    decide(timestamp, priorityKey) {
+        const used = this.usedBytes(timestamp);
+        const ratio = used / this.policy.maxBytesPerMinute;
+        this.updatePressure(ratio);
+        const hasBurst = priorityKey !== undefined && !this.burstKeys.includes(priorityKey);
+        if (ratio >= 1 && !hasBurst)
+            return this.decision(false, 0, used, hasBurst, 'budget');
+        if (this.policy.adaptiveCapture
+            && this.pressure !== 'normal'
+            && this.lastCaptureAttempt !== undefined
+            && timestamp - this.lastCaptureAttempt < THROTTLED_CAPTURE_INTERVAL_MS
+            && !hasBurst) {
+            return this.decision(false, 0, used, hasBurst, 'throttle');
+        }
+        this.lastCaptureAttempt = timestamp;
+        const normalRemaining = Math.max(0, this.policy.maxBytesPerMinute - used);
+        const available = normalRemaining + (hasBurst ? REPLAY_KEY_FRAME_BURST_BYTES : 0);
+        const frameLimit = hasBurst
+            ? Math.min(Math.max(this.policy.maxFrameBytes, REPLAY_KEY_FRAME_BURST_BYTES), available)
+            : Math.min(this.policy.maxFrameBytes, available);
+        return this.decision(frameLimit >= 1024, frameLimit, used, hasBurst, frameLimit >= 1024 ? undefined : 'budget');
+    }
+    record(timestamp, byteSize, priorityKey) {
+        if (!Number.isFinite(byteSize) || byteSize <= 0)
+            return;
+        this.prune(timestamp);
+        this.entries.push({ timestamp, byteSize: Math.round(byteSize) });
+        if (priorityKey && !this.burstKeys.includes(priorityKey)) {
+            this.burstKeys.push(priorityKey);
+            if (this.burstKeys.length > 64)
+                this.burstKeys.shift();
+        }
+    }
+    usedBytes(timestamp) {
+        this.prune(timestamp);
+        return this.entries.reduce((total, entry) => total + entry.byteSize, 0);
+    }
+    prune(timestamp) {
+        const cutoff = timestamp - WINDOW_MS;
+        while (this.entries.length > 0 && this.entries[0].timestamp <= cutoff)
+            this.entries.shift();
+    }
+    decision(allowed, maxFrameBytes, usedBytes, priority, reason) {
+        const degraded = this.policy.adaptiveCapture
+            && (this.pressure === 'degraded' || this.pressure === 'paused');
+        return {
+            allowed,
+            compressionQuality: degraded
+                ? Math.max(0.25, Math.round(this.policy.compressionQuality * 0.75 * 100) / 100)
+                : this.policy.compressionQuality,
+            maxImageDimension: degraded
+                ? Math.min(this.policy.maxImageDimension, Math.max(240, Math.floor(this.policy.maxImageDimension * 0.75)))
+                : this.policy.maxImageDimension,
+            maxFrameBytes: Math.max(0, Math.floor(maxFrameBytes)),
+            usedBytes,
+            priority,
+            ...(reason ? { reason } : {}),
+        };
+    }
+    updatePressure(ratio) {
+        if (!this.policy.adaptiveCapture) {
+            this.pressure = 'normal';
+            return;
+        }
+        if (ratio >= 1) {
+            this.pressure = 'paused';
+            return;
+        }
+        if (ratio >= 0.9) {
+            this.pressure = 'degraded';
+            return;
+        }
+        if (this.pressure === 'paused' || this.pressure === 'degraded') {
+            if (ratio >= 0.8) {
+                this.pressure = 'degraded';
+                return;
+            }
+        }
+        if (ratio >= 0.75) {
+            this.pressure = 'throttled';
+            return;
+        }
+        if (this.pressure === 'throttled' && ratio >= 0.65)
+            return;
+        this.pressure = 'normal';
+    }
+}
+//# sourceMappingURL=replay-budget.js.map

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

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

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

@@ -0,0 +1,36 @@
+export type FTReplaySkipReason = 'dedupe' | 'approx_static' | 'throttle' | 'budget' | 'busy' | 'error';
+export type FTReplayDiagnosticEvent = {
+    type: 'capture_attempt';
+    timestamp: number;
+    usedBytes: number;
+    maxBytesPerMinute: number;
+} | {
+    type: 'capture_skipped';
+    timestamp: number;
+    reason: FTReplaySkipReason;
+} | {
+    type: 'image_saved';
+    timestamp: number;
+    byteSize: number;
+    width: number;
+    height: number;
+    mimeType?: string;
+    priority: boolean;
+    byteSizeSource: 'native' | 'frame_limit_estimate';
+} | {
+    type: 'segment_encoded';
+    timestamp: number;
+    byteSize: number;
+    recordCount: number;
+    pointerRecordCount: number;
+    hasImage: boolean;
+} | {
+    type: 'pointer_received';
+    timestamp: number;
+    eventType: 'down' | 'up' | 'move';
+} | {
+    type: 'replay_stopped';
+    timestamp: number;
+};
+export declare function replayUtf8ByteLength(value: string): number;
+//# sourceMappingURL=replay-diagnostics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"replay-diagnostics.d.ts","sourceRoot":"","sources":["../../../../../src/core/replay-diagnostics.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,eAAe,GACf,UAAU,GACV,QAAQ,GACR,MAAM,GACN,OAAO,CAAC;AAEZ,MAAM,MAAM,uBAAuB,GAC/B;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,GAC5F;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAA;CAAE,GAC1E;IACA,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,QAAQ,GAAG,sBAAsB,CAAC;CACnD,GACC;IACA,IAAI,EAAE,iBAAiB,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,OAAO,CAAC;CACnB,GACC;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAAA;CAAE,GAClF;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAmBlD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAiB1D"}

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

@@ -0,0 +1,36 @@
+/** @internal Benchmark-only observer hook. Production builds leave it unset. */
+export function emitReplayDiagnostic(event) {
+    const observer = globalThis.__FT_COCOS_REPLAY_BENCHMARK_OBSERVER__;
+    if (typeof observer !== 'function')
+        return;
+    try {
+        observer(event);
+    }
+    catch (_a) {
+        // Diagnostics must never affect capture, storage, or upload behavior.
+    }
+}
+export function replayUtf8ByteLength(value) {
+    let bytes = 0;
+    for (let index = 0; index < value.length; index += 1) {
+        const code = value.charCodeAt(index);
+        if (code < 0x80)
+            bytes += 1;
+        else if (code < 0x800)
+            bytes += 2;
+        else if (code >= 0xd800 && code <= 0xdbff && index + 1 < value.length) {
+            const low = value.charCodeAt(index + 1);
+            if (low >= 0xdc00 && low <= 0xdfff) {
+                bytes += 4;
+                index += 1;
+            }
+            else {
+                bytes += 3;
+            }
+        }
+        else
+            bytes += 3;
+    }
+    return bytes;
+}
+//# sourceMappingURL=replay-diagnostics.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"replay-diagnostics.js","sourceRoot":"","sources":["../../../../../src/core/replay-diagnostics.ts"],"names":[],"mappings":"AAsCA,gFAAgF;AAChF,MAAM,UAAU,oBAAoB,CAAC,KAA8B;IACjE,MAAM,QAAQ,GAAI,UAAuC,CAAC,sCAAsC,CAAC;IACjG,IAAI,OAAO,QAAQ,KAAK,UAAU;QAAE,OAAO;IAC3C,IAAI,CAAC;QACH,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC;IAAC,WAAM,CAAC;QACP,sEAAsE;IACxE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,IAAI,GAAG,IAAI;YAAE,KAAK,IAAI,CAAC,CAAC;aACvB,IAAI,IAAI,GAAG,KAAK;YAAE,KAAK,IAAI,CAAC,CAAC;aAC7B,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,IAAI,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YACtE,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YACxC,IAAI,GAAG,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,EAAE,CAAC;gBACnC,KAAK,IAAI,CAAC,CAAC;gBACX,KAAK,IAAI,CAAC,CAAC;YACb,CAAC;iBAAM,CAAC;gBACN,KAAK,IAAI,CAAC,CAAC;YACb,CAAC;QACH,CAAC;;YAAM,KAAK,IAAI,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

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

@@ -0,0 +1,31 @@
+import type { FTRUMContext } from './types.js';
+export interface FTReplayImageRecord {
+    context: FTRUMContext;
+    resourceId: string;
+    width: number;
+    height: number;
+    mimeType?: `image/${string}`;
+    timestamp: number;
+    contextChanged: boolean;
+    pointerEvents?: FTReplayPointerRecord[];
+}
+export interface FTReplayPointerRecord {
+    eventType: 'down' | 'up' | 'move';
+    pointerId: number;
+    x: number;
+    y: number;
+    timestamp: number;
+}
+export interface FTReplayPointerRecords {
+    context: FTRUMContext;
+    pointerEvents: FTReplayPointerRecord[];
+}
+export declare function encodeReplayImageRecord(input: FTReplayImageRecord): {
+    segment: string;
+    recordCount: number;
+};
+export declare function encodeReplayPointerRecords(input: FTReplayPointerRecords): {
+    segment: string;
+    recordCount: number;
+};
+//# sourceMappingURL=replay-encoding.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"replay-encoding.d.ts","sourceRoot":"","sources":["../../../../../src/core/replay-encoding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,YAAY,CAAC;IACtB,aAAa,EAAE,qBAAqB,EAAE,CAAC;CACxC;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,mBAAmB,GAAG;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,CAiCA;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,sBAAsB,GAAG;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,CAMA"}

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

@@ -0,0 +1,62 @@
+export function encodeReplayImageRecord(input) {
+    var _a;
+    const wireframe = {
+        id: 1,
+        type: 'image',
+        x: 0,
+        y: 0,
+        width: input.width,
+        height: input.height,
+        base64: null,
+        border: null,
+        clip: null,
+        isEmpty: false,
+        ...(input.mimeType ? { mimeType: input.mimeType } : {}),
+        resourceId: input.resourceId,
+        shapeStyle: null,
+    };
+    const records = [];
+    if (input.contextChanged) {
+        records.push({ type: 4, data: { width: input.width, height: input.height }, timestamp: input.timestamp }, { type: 6, data: { has_focus: true }, timestamp: input.timestamp });
+    }
+    records.push({
+        type: 10,
+        data: { wireframes: [wireframe] },
+        timestamp: input.timestamp,
+    });
+    records.push(...((_a = input.pointerEvents) === null || _a === void 0 ? void 0 : _a.map(pointerRecord)) || []);
+    return {
+        segment: encodeEnvelope(input.context, records),
+        recordCount: records.length,
+    };
+}
+export function encodeReplayPointerRecords(input) {
+    const records = input.pointerEvents.map(pointerRecord);
+    return {
+        segment: encodeEnvelope(input.context, records),
+        recordCount: records.length,
+    };
+}
+function pointerRecord(pointer) {
+    return {
+        type: 11,
+        data: {
+            source: 9,
+            pointerEventType: pointer.eventType,
+            pointerType: 'touch',
+            pointerId: pointer.pointerId,
+            x: pointer.x,
+            y: pointer.y,
+        },
+        timestamp: pointer.timestamp,
+    };
+}
+function encodeEnvelope(context, records) {
+    return JSON.stringify({
+        records,
+        applicationID: context.applicationId,
+        sessionID: context.sessionId,
+        viewID: context.viewId,
+    });
+}
+//# sourceMappingURL=replay-encoding.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"replay-encoding.js","sourceRoot":"","sources":["../../../../../src/core/replay-encoding.ts"],"names":[],"mappings":"AA0BA,MAAM,UAAU,uBAAuB,CAAC,KAA0B;;IAIhE,MAAM,SAAS,GAAG;QAChB,EAAE,EAAE,CAAC;QACL,IAAI,EAAE,OAAO;QACb,CAAC,EAAE,CAAC;QACJ,CAAC,EAAE,CAAC;QACJ,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,IAAI;QACZ,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,KAAK;QACd,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,UAAU,EAAE,IAAI;KACjB,CAAC;IACF,MAAM,OAAO,GAAc,EAAE,CAAC;IAC9B,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,CACV,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,EAC3F,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CACnE,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,IAAI,CAAC;QACX,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,EAAE,UAAU,EAAE,CAAC,SAAS,CAAC,EAAE;QACjC,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC,CAAC;IACH,OAAO,CAAC,IAAI,CAAC,GAAG,CAAA,MAAA,KAAK,CAAC,aAAa,0CAAE,GAAG,CAAC,aAAa,CAAC,KAAI,EAAE,CAAC,CAAC;IAC/D,OAAO;QACL,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC;QAC/C,WAAW,EAAE,OAAO,CAAC,MAAM;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,KAA6B;IAItE,MAAM,OAAO,GAAG,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACvD,OAAO;QACL,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC;QAC/C,WAAW,EAAE,OAAO,CAAC,MAAM;KAC5B,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,OAA8B;IACnD,OAAO;QACL,IAAI,EAAE,EAAE;QACR,IAAI,EAAE;YACJ,MAAM,EAAE,CAAC;YACT,gBAAgB,EAAE,OAAO,CAAC,SAAS;YACnC,WAAW,EAAE,OAAO;YACpB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,CAAC,EAAE,OAAO,CAAC,CAAC;YACZ,CAAC,EAAE,OAAO,CAAC,CAAC;SACb;QACD,SAAS,EAAE,OAAO,CAAC,SAAS;KAC7B,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,OAAqB,EAAE,OAAkB;IAC/D,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,OAAO;QACP,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,3 @@
+/** Converts tightly packed RGBA pixels from bottom-left to top-left row order. */
+export declare function flipRgbaRows(bytes: Uint8Array, width: number, height: number): void;
+//# sourceMappingURL=replay-pixels.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"replay-pixels.d.ts","sourceRoot":"","sources":["../../../../../src/core/replay-pixels.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAUnF"}

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

@@ -0,0 +1,13 @@
+/** Converts tightly packed RGBA pixels from bottom-left to top-left row order. */
+export function flipRgbaRows(bytes, width, height) {
+    const rowSize = width * 4;
+    const swap = new Uint8Array(rowSize);
+    for (let top = 0, bottom = height - 1; top < bottom; top += 1, bottom -= 1) {
+        const topOffset = top * rowSize;
+        const bottomOffset = bottom * rowSize;
+        swap.set(bytes.subarray(topOffset, topOffset + rowSize));
+        bytes.copyWithin(topOffset, bottomOffset, bottomOffset + rowSize);
+        bytes.set(swap, bottomOffset);
+    }
+}
+//# sourceMappingURL=replay-pixels.js.map