wehub-resource-sync
88 lines
2.4 KiB
TypeScript
88 lines
2.4 KiB
TypeScript
/**
|
|
* @fileoverview Keepalive Manager
|
|
* @description Global singleton service for managing Service Worker keepalive.
|
|
*
|
|
* This module provides a unified interface for acquiring and releasing keepalive
|
|
* references. Multiple modules can acquire keepalive independently using tags,
|
|
* and the underlying keepalive mechanism will remain active as long as at least
|
|
* one reference is held.
|
|
*/
|
|
|
|
import {
|
|
createOffscreenKeepaliveController,
|
|
type KeepaliveController,
|
|
} from './record-replay-v3/engine/keepalive/offscreen-keepalive';
|
|
|
|
const LOG_PREFIX = '[KeepaliveManager]';
|
|
|
|
/**
|
|
* Singleton keepalive controller instance.
|
|
* Created lazily to avoid initialization issues during module loading.
|
|
*/
|
|
let controller: KeepaliveController | null = null;
|
|
|
|
/**
|
|
* Get or create the singleton keepalive controller.
|
|
*/
|
|
function getController(): KeepaliveController {
|
|
if (!controller) {
|
|
controller = createOffscreenKeepaliveController({ logger: console });
|
|
console.debug(`${LOG_PREFIX} Controller initialized`);
|
|
}
|
|
return controller;
|
|
}
|
|
|
|
/**
|
|
* Acquire a keepalive reference with a tag.
|
|
*
|
|
* @param tag - Identifier for the reference (e.g., 'native-host', 'rr-engine')
|
|
* @returns A release function to call when keepalive is no longer needed
|
|
*
|
|
* @example
|
|
* ```typescript
|
|
* const release = acquireKeepalive('native-host');
|
|
* // ... do work that needs SW to stay alive ...
|
|
* release(); // Release when done
|
|
* ```
|
|
*/
|
|
export function acquireKeepalive(tag: string): () => void {
|
|
try {
|
|
const release = getController().acquire(tag);
|
|
console.debug(`${LOG_PREFIX} Acquired keepalive for tag: ${tag}`);
|
|
return () => {
|
|
try {
|
|
release();
|
|
console.debug(`${LOG_PREFIX} Released keepalive for tag: ${tag}`);
|
|
} catch (error) {
|
|
console.warn(`${LOG_PREFIX} Failed to release keepalive for ${tag}:`, error);
|
|
}
|
|
};
|
|
} catch (error) {
|
|
console.warn(`${LOG_PREFIX} Failed to acquire keepalive for ${tag}:`, error);
|
|
return () => {};
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Check if keepalive is currently active (any references held).
|
|
*/
|
|
export function isKeepaliveActive(): boolean {
|
|
try {
|
|
return getController().isActive();
|
|
} catch {
|
|
return false;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Get the current keepalive reference count.
|
|
* Useful for debugging.
|
|
*/
|
|
export function getKeepaliveRefCount(): number {
|
|
try {
|
|
return getController().getRefCount();
|
|
} catch {
|
|
return 0;
|
|
}
|
|
}
|