@scalebun/react-native 1.0.2 → 1.0.3

package/src/features/replay/public/api.ts

@@ -1,364 +1,364 @@
-/**
- * Session Replay SDK — Public API Facade
- *
- * This is the main entry point for SDK consumers.
- * All methods are no-throw — errors are logged and silently handled.
- *
- * Usage (standalone):
- *   import { ReplaySdk } from '@scalebun/replay-sdk';
- *   ReplaySdk.init({ apiKey: '...', endpoint: '...' });
- *
- * Usage (via scalebun-sdk):
- *   // Called internally by bootstrap.ts:
- *   ReplaySdk.init(config, { debugTransport: transport });
- */
-
-import type {
-    ReplayConfig,
-    ReplayUser,
-    ReplayBreadcrumb,
-    ReplayPrivacyOptions,
-    ReplayLinkResult,
-    ReplaySyncCallback,
-} from './types';
-import { CapturingMode, ScreenshotQuality } from './enums';
-import { validateConfig } from '../core/config/validator';
-import { sessionOrchestrator } from '../replay/session/sessionOrchestrator';
-import { breadcrumbCollector } from '../replay/breadcrumbs/breadcrumbCollector';
-import { bridgeAdapter } from '../bridge/adapters/bridgeAdapter';
-import { batchManager } from '../pipeline/batching/batchManager';
-import { installConsoleIntegration, uninstallConsoleIntegration, setConsoleEnabled } from '../integrations/logs/consoleIntegration';
-import { setNetworkEnabled } from '../integrations/network/networkAdapter';
-import { setVerbose, logger } from '../core/logger/logger';
-import { safeCall, safeCallAsync, fireAndForget } from '../core/errors/safeCall';
-import { isDevOrEmulator } from '../core/env/environmentDetector';
-
-// Transport layer
-import type { ReplayTransport } from '../transport/ReplayTransport';
-import type { DebugTransportLike } from '../transport/DesktopReplayTransport';
-import { DesktopReplayTransport } from '../transport/DesktopReplayTransport';
-import { BackendReplayTransport } from '../transport/BackendReplayTransport';
-import { CompositeReplayTransport } from '../transport/CompositeReplayTransport';
-
-// ─── State ──────────────────────────────────────────────────────────────────
-
-let _initialized = false;
-let _config: ReplayConfig | null = null;
-let _transport: ReplayTransport | null = null;
-
-// ─── Init Options ───────────────────────────────────────────────────────────
-
-export interface ReplaySdkInitOptions {
-    /** External debug transport from scalebun-sdk for desktop streaming */
-    debugTransport?: DebugTransportLike;
-}
-
-// ─── Public API ─────────────────────────────────────────────────────────────
-
-export const ReplaySdk = {
-    // ─── Initialization ─────────────────────────────────────────────────
-
-    /**
-     * Initialize the Session Replay SDK.
-     *
-     * Must be called before any other SDK method.
-     * Safe to call multiple times — re-initializes with new config.
-     *
-     * @param partialConfig - SDK configuration (merged with defaults)
-     * @param opts - Optional init options (e.g. external debugTransport)
-     */
-    async init(partialConfig: Partial<ReplayConfig>, opts?: ReplaySdkInitOptions): Promise<void> {
-        return safeCallAsync('ReplaySdk.init', async () => {
-            const { config, warnings } = validateConfig(partialConfig);
-            _config = config;
-
-            // Apply verbose logging
-            setVerbose(config.verboseLogging);
-
-            // Log validation warnings
-            for (const w of warnings) {
-                logger.warn(`Config: ${w}`);
-            }
-
-            if (!config.enabled) {
-                logger.info('SDK disabled via config');
-                return;
-            }
-
-            // ── Build transport layer ───────────────────────────────────
-            const transports: ReplayTransport[] = [];
-
-            // Desktop transport (always, if debugTransport provided)
-            if (opts?.debugTransport) {
-                transports.push(new DesktopReplayTransport(opts.debugTransport));
-                logger.info('Desktop replay transport enabled');
-            }
-
-            // Backend transport (flag-controlled + env check)
-            if (config.sendToBackend && config.endpoint && config.apiKey) {
-                const shouldSkip = isDevOrEmulator() && !config.forceBackendInDev;
-                if (!shouldSkip) {
-                    transports.push(new BackendReplayTransport({
-                        endpoint: config.endpoint,
-                        apiKey: config.apiKey,
-                        batchSize: config.uploadBatchSize,
-                    }));
-                    logger.info('Backend replay transport enabled');
-                } else {
-                    logger.info('Backend replay transport skipped (dev/emulator mode)');
-                }
-            }
-
-            // Build composite transport
-            if (transports.length > 0) {
-                _transport = new CompositeReplayTransport(transports);
-            }
-
-            // ── Install integrations ────────────────────────────────────
-            if (config.sdkLogsEnabled) {
-                installConsoleIntegration();
-            }
-            setNetworkEnabled(config.networkLogsEnabled);
-
-            // Configure batch manager
-            batchManager.configure(config.uploadBatchSize);
-
-            // Initialize native module + session orchestrator
-            // Native module may not be available (e.g. no native build yet).
-            // That's fine — transport + JS integrations still work.
-            try {
-                const success = await sessionOrchestrator.initialize(config);
-                if (success) {
-                    logger.info('SDK initialized with native module');
-                } else {
-                    logger.warn('Native module not available — transport-only mode');
-                }
-            } catch (nativeErr: any) {
-                logger.warn('Native module init failed (non-fatal):', nativeErr?.message);
-            }
-
-            _initialized = true;
-            logger.info('SDK initialized successfully');
-        }, undefined);
-    },
-
-    // ─── Transport Access ───────────────────────────────────────────────
-
-    /** @internal Get the active transport (for integration with SessionManager) */
-    _getTransport(): ReplayTransport | null {
-        return _transport;
-    },
-
-    // ─── Session Lifecycle ──────────────────────────────────────────────
-
-    /** Start a new replay session */
-    async start(): Promise<void> {
-        return safeCallAsync('ReplaySdk.start', async () => {
-            if (!_initialized) { logger.warn('SDK not initialized'); return; }
-            await sessionOrchestrator.start();
-        }, undefined);
-    },
-
-    /** Stop the current replay session and finalize */
-    async stop(): Promise<void> {
-        return safeCallAsync('ReplaySdk.stop', async () => {
-            if (!_initialized) return;
-            await sessionOrchestrator.stop();
-        }, undefined);
-    },
-
-    /** Pause the current session (e.g. when app backgrounds) */
-    async pause(): Promise<void> {
-        return safeCallAsync('ReplaySdk.pause', async () => {
-            if (!_initialized) return;
-            await sessionOrchestrator.pause();
-        }, undefined);
-    },
-
-    /** Resume a paused session */
-    async resume(): Promise<void> {
-        return safeCallAsync('ReplaySdk.resume', async () => {
-            if (!_initialized) return;
-            await sessionOrchestrator.resume();
-        }, undefined);
-    },
-
-    // ─── Capture ────────────────────────────────────────────────────────
-
-    /** Manually trigger a frame capture */
-    async captureManualFrame(): Promise<void> {
-        return safeCallAsync('ReplaySdk.captureManualFrame', async () => {
-            if (!_initialized) return;
-            await sessionOrchestrator.captureManualFrame();
-        }, undefined);
-    },
-
-    // ─── Configuration ──────────────────────────────────────────────────
-
-    /** Enable or disable the SDK at runtime */
-    async setEnabled(enabled: boolean): Promise<void> {
-        return safeCallAsync('ReplaySdk.setEnabled', async () => {
-            if (!_initialized) return;
-            await sessionOrchestrator.setEnabled(enabled);
-        }, undefined);
-    },
-
-    /** Change the capture mode at runtime */
-    async setCapturingMode(mode: CapturingMode): Promise<void> {
-        return safeCallAsync('ReplaySdk.setCapturingMode', async () => {
-            if (!_initialized) return;
-            await sessionOrchestrator.setCapturingMode(mode);
-        }, undefined);
-    },
-
-    /** Change screenshot quality at runtime */
-    async setScreenshotQuality(quality: ScreenshotQuality): Promise<void> {
-        return safeCallAsync('ReplaySdk.setScreenshotQuality', async () => {
-            if (!_initialized) return;
-            await bridgeAdapter.setScreenshotQuality(quality);
-        }, undefined);
-    },
-
-    /** Change capture interval (frequency mode) */
-    async setScreenshotCaptureInterval(intervalMs: number): Promise<void> {
-        return safeCallAsync('ReplaySdk.setScreenshotCaptureInterval', async () => {
-            if (!_initialized) return;
-            await bridgeAdapter.setScreenshotCaptureInterval(intervalMs);
-        }, undefined);
-    },
-
-    /** Enable/disable user step tracking */
-    async setUserStepsEnabled(enabled: boolean): Promise<void> {
-        return safeCallAsync('ReplaySdk.setUserStepsEnabled', async () => {
-            if (!_initialized) return;
-            await bridgeAdapter.setEnabled(enabled);
-        }, undefined);
-    },
-
-    /** Enable/disable network log capture */
-    setNetworkLogsEnabled(enabled: boolean): void {
-        safeCall('ReplaySdk.setNetworkLogsEnabled', () => {
-            setNetworkEnabled(enabled);
-        }, undefined);
-    },
-
-    /** Enable/disable SDK log capture */
-    setSdkLogsEnabled(enabled: boolean): void {
-        safeCall('ReplaySdk.setSdkLogsEnabled', () => {
-            setConsoleEnabled(enabled);
-        }, undefined);
-    },
-
-    // ─── Screen Tracking ────────────────────────────────────────────────
-
-    /** Set the current screen name for replay context */
-    async setCurrentScreen(screenName: string): Promise<void> {
-        return safeCallAsync('ReplaySdk.setCurrentScreen', async () => {
-            if (!_initialized) return;
-            await sessionOrchestrator.setCurrentScreen(screenName);
-        }, undefined);
-    },
-
-    // ─── User Identity ──────────────────────────────────────────────────
-
-    /** Set user identity for the current session */
-    async setUser(user: ReplayUser): Promise<void> {
-        return safeCallAsync('ReplaySdk.setUser', async () => {
-            if (!_initialized) return;
-            await sessionOrchestrator.setUser(user);
-        }, undefined);
-    },
-
-    /** Clear user identity */
-    async clearUser(): Promise<void> {
-        return safeCallAsync('ReplaySdk.clearUser', async () => {
-            if (!_initialized) return;
-            await sessionOrchestrator.clearUser();
-        }, undefined);
-    },
-
-    // ─── Privacy ────────────────────────────────────────────────────────
-
-    /** Update privacy options at runtime */
-    async setPrivacyOptions(options: Partial<ReplayPrivacyOptions>): Promise<void> {
-        return safeCallAsync('ReplaySdk.setPrivacyOptions', async () => {
-            if (!_initialized || !_config) return;
-            _config.privacy = { ..._config.privacy, ...options };
-            await bridgeAdapter.setPrivacyOptions(_config.privacy);
-        }, undefined);
-    },
-
-    // ─── Breadcrumbs ────────────────────────────────────────────────────
-
-    /** Add a custom breadcrumb to the session timeline */
-    async addBreadcrumb(breadcrumb: ReplayBreadcrumb): Promise<void> {
-        return safeCallAsync('ReplaySdk.addBreadcrumb', async () => {
-            await breadcrumbCollector.addBreadcrumb(breadcrumb);
-        }, undefined);
-    },
-
-    // ─── Sync / Upload ──────────────────────────────────────────────────
-
-    /** Set a callback invoked before each upload batch. Return false to cancel. */
-    setSyncCallback(callback: ReplaySyncCallback | null): void {
-        safeCall('ReplaySdk.setSyncCallback', () => {
-            sessionOrchestrator.setSyncCallback(callback);
-        }, undefined);
-    },
-
-    /** Force-flush pending data for upload */
-    async flush(): Promise<void> {
-        return safeCallAsync('ReplaySdk.flush', async () => {
-            if (!_initialized) return;
-            await bridgeAdapter.flushUpload();
-        }, undefined);
-    },
-
-    // ─── Query ──────────────────────────────────────────────────────────
-
-    /** Get a link to the current session replay (if available) */
-    async getSessionReplayLink(): Promise<ReplayLinkResult | null> {
-        return safeCallAsync('ReplaySdk.getSessionReplayLink', async () => {
-            if (!_initialized) return null;
-            const result = await bridgeAdapter.getSessionReplayLink();
-            if (!result) return null;
-            return {
-                url: result.url,
-                sessionId: result.sessionId,
-                uploaded: result.uploaded,
-            };
-        }, null);
-    },
-
-    /** Get whether the SDK is currently recording */
-    get isRecording(): boolean {
-        return safeCall('ReplaySdk.isRecording', () => sessionOrchestrator.isRecording, false);
-    },
-
-    /** Get the current session ID */
-    get sessionId(): string | null {
-        return safeCall('ReplaySdk.sessionId', () => sessionOrchestrator.sessionId, null);
-    },
-
-    // ─── Cleanup ────────────────────────────────────────────────────────
-
-    /** Destroy the SDK and release all resources */
-    async destroy(): Promise<void> {
-        return safeCallAsync('ReplaySdk.destroy', async () => {
-            uninstallConsoleIntegration();
-            batchManager.reset();
-            breadcrumbCollector.clear();
-            await sessionOrchestrator.destroy();
-
-            // Destroy transport
-            if (_transport) {
-                _transport.destroy();
-                _transport = null;
-            }
-
-            _initialized = false;
-            _config = null;
-            logger.info('SDK destroyed');
-        }, undefined);
-    },
-};
+/**
+ * Session Replay SDK — Public API Facade
+ *
+ * This is the main entry point for SDK consumers.
+ * All methods are no-throw — errors are logged and silently handled.
+ *
+ * Usage (standalone):
+ *   import { ReplaySdk } from '@scalebun/replay-sdk';
+ *   ReplaySdk.init({ apiKey: '...', endpoint: '...' });
+ *
+ * Usage (via scalebun-sdk):
+ *   // Called internally by bootstrap.ts:
+ *   ReplaySdk.init(config, { debugTransport: transport });
+ */
+
+import type {
+    ReplayConfig,
+    ReplayUser,
+    ReplayBreadcrumb,
+    ReplayPrivacyOptions,
+    ReplayLinkResult,
+    ReplaySyncCallback,
+} from './types';
+import { CapturingMode, ScreenshotQuality } from './enums';
+import { validateConfig } from '../core/config/validator';
+import { sessionOrchestrator } from '../replay/session/sessionOrchestrator';
+import { breadcrumbCollector } from '../replay/breadcrumbs/breadcrumbCollector';
+import { bridgeAdapter } from '../bridge/adapters/bridgeAdapter';
+import { batchManager } from '../pipeline/batching/batchManager';
+import { installConsoleIntegration, uninstallConsoleIntegration, setConsoleEnabled } from '../integrations/logs/consoleIntegration';
+import { setNetworkEnabled } from '../integrations/network/networkAdapter';
+import { setVerbose, logger } from '../core/logger/logger';
+import { safeCall, safeCallAsync, fireAndForget } from '../core/errors/safeCall';
+import { isDevOrEmulator } from '../core/env/environmentDetector';
+
+// Transport layer
+import type { ReplayTransport } from '../transport/ReplayTransport';
+import type { DebugTransportLike } from '../transport/DesktopReplayTransport';
+import { DesktopReplayTransport } from '../transport/DesktopReplayTransport';
+import { BackendReplayTransport } from '../transport/BackendReplayTransport';
+import { CompositeReplayTransport } from '../transport/CompositeReplayTransport';
+
+// ─── State ──────────────────────────────────────────────────────────────────
+
+let _initialized = false;
+let _config: ReplayConfig | null = null;
+let _transport: ReplayTransport | null = null;
+
+// ─── Init Options ───────────────────────────────────────────────────────────
+
+export interface ReplaySdkInitOptions {
+    /** External debug transport from scalebun-sdk for desktop streaming */
+    debugTransport?: DebugTransportLike;
+}
+
+// ─── Public API ─────────────────────────────────────────────────────────────
+
+export const ReplaySdk = {
+    // ─── Initialization ─────────────────────────────────────────────────
+
+    /**
+     * Initialize the Session Replay SDK.
+     *
+     * Must be called before any other SDK method.
+     * Safe to call multiple times — re-initializes with new config.
+     *
+     * @param partialConfig - SDK configuration (merged with defaults)
+     * @param opts - Optional init options (e.g. external debugTransport)
+     */
+    async init(partialConfig: Partial<ReplayConfig>, opts?: ReplaySdkInitOptions): Promise<void> {
+        return safeCallAsync('ReplaySdk.init', async () => {
+            const { config, warnings } = validateConfig(partialConfig);
+            _config = config;
+
+            // Apply verbose logging
+            setVerbose(config.verboseLogging);
+
+            // Log validation warnings
+            for (const w of warnings) {
+                logger.warn(`Config: ${w}`);
+            }
+
+            if (!config.enabled) {
+                logger.info('SDK disabled via config');
+                return;
+            }
+
+            // ── Build transport layer ───────────────────────────────────
+            const transports: ReplayTransport[] = [];
+
+            // Desktop transport (always, if debugTransport provided)
+            if (opts?.debugTransport) {
+                transports.push(new DesktopReplayTransport(opts.debugTransport));
+                logger.info('Desktop replay transport enabled');
+            }
+
+            // Backend transport (flag-controlled + env check)
+            if (config.sendToBackend && config.endpoint && config.apiKey) {
+                const shouldSkip = isDevOrEmulator() && !config.forceBackendInDev;
+                if (!shouldSkip) {
+                    transports.push(new BackendReplayTransport({
+                        endpoint: config.endpoint,
+                        apiKey: config.apiKey,
+                        batchSize: config.uploadBatchSize,
+                    }));
+                    logger.info('Backend replay transport enabled');
+                } else {
+                    logger.info('Backend replay transport skipped (dev/emulator mode)');
+                }
+            }
+
+            // Build composite transport
+            if (transports.length > 0) {
+                _transport = new CompositeReplayTransport(transports);
+            }
+
+            // ── Install integrations ────────────────────────────────────
+            if (config.sdkLogsEnabled) {
+                installConsoleIntegration();
+            }
+            setNetworkEnabled(config.networkLogsEnabled);
+
+            // Configure batch manager
+            batchManager.configure(config.uploadBatchSize);
+
+            // Initialize native module + session orchestrator
+            // Native module may not be available (e.g. no native build yet).
+            // That's fine — transport + JS integrations still work.
+            try {
+                const success = await sessionOrchestrator.initialize(config);
+                if (success) {
+                    logger.info('SDK initialized with native module');
+                } else {
+                    logger.warn('Native module not available — transport-only mode');
+                }
+            } catch (nativeErr: any) {
+                logger.warn('Native module init failed (non-fatal):', nativeErr?.message);
+            }
+
+            _initialized = true;
+            logger.info('SDK initialized successfully');
+        }, undefined);
+    },
+
+    // ─── Transport Access ───────────────────────────────────────────────
+
+    /** @internal Get the active transport (for integration with SessionManager) */
+    _getTransport(): ReplayTransport | null {
+        return _transport;
+    },
+
+    // ─── Session Lifecycle ──────────────────────────────────────────────
+
+    /** Start a new replay session */
+    async start(): Promise<void> {
+        return safeCallAsync('ReplaySdk.start', async () => {
+            if (!_initialized) { logger.warn('SDK not initialized'); return; }
+            await sessionOrchestrator.start();
+        }, undefined);
+    },
+
+    /** Stop the current replay session and finalize */
+    async stop(): Promise<void> {
+        return safeCallAsync('ReplaySdk.stop', async () => {
+            if (!_initialized) return;
+            await sessionOrchestrator.stop();
+        }, undefined);
+    },
+
+    /** Pause the current session (e.g. when app backgrounds) */
+    async pause(): Promise<void> {
+        return safeCallAsync('ReplaySdk.pause', async () => {
+            if (!_initialized) return;
+            await sessionOrchestrator.pause();
+        }, undefined);
+    },
+
+    /** Resume a paused session */
+    async resume(): Promise<void> {
+        return safeCallAsync('ReplaySdk.resume', async () => {
+            if (!_initialized) return;
+            await sessionOrchestrator.resume();
+        }, undefined);
+    },
+
+    // ─── Capture ────────────────────────────────────────────────────────
+
+    /** Manually trigger a frame capture */
+    async captureManualFrame(): Promise<void> {
+        return safeCallAsync('ReplaySdk.captureManualFrame', async () => {
+            if (!_initialized) return;
+            await sessionOrchestrator.captureManualFrame();
+        }, undefined);
+    },
+
+    // ─── Configuration ──────────────────────────────────────────────────
+
+    /** Enable or disable the SDK at runtime */
+    async setEnabled(enabled: boolean): Promise<void> {
+        return safeCallAsync('ReplaySdk.setEnabled', async () => {
+            if (!_initialized) return;
+            await sessionOrchestrator.setEnabled(enabled);
+        }, undefined);
+    },
+
+    /** Change the capture mode at runtime */
+    async setCapturingMode(mode: CapturingMode): Promise<void> {
+        return safeCallAsync('ReplaySdk.setCapturingMode', async () => {
+            if (!_initialized) return;
+            await sessionOrchestrator.setCapturingMode(mode);
+        }, undefined);
+    },
+
+    /** Change screenshot quality at runtime */
+    async setScreenshotQuality(quality: ScreenshotQuality): Promise<void> {
+        return safeCallAsync('ReplaySdk.setScreenshotQuality', async () => {
+            if (!_initialized) return;
+            await bridgeAdapter.setScreenshotQuality(quality);
+        }, undefined);
+    },
+
+    /** Change capture interval (frequency mode) */
+    async setScreenshotCaptureInterval(intervalMs: number): Promise<void> {
+        return safeCallAsync('ReplaySdk.setScreenshotCaptureInterval', async () => {
+            if (!_initialized) return;
+            await bridgeAdapter.setScreenshotCaptureInterval(intervalMs);
+        }, undefined);
+    },
+
+    /** Enable/disable user step tracking */
+    async setUserStepsEnabled(enabled: boolean): Promise<void> {
+        return safeCallAsync('ReplaySdk.setUserStepsEnabled', async () => {
+            if (!_initialized) return;
+            await bridgeAdapter.setEnabled(enabled);
+        }, undefined);
+    },
+
+    /** Enable/disable network log capture */
+    setNetworkLogsEnabled(enabled: boolean): void {
+        safeCall('ReplaySdk.setNetworkLogsEnabled', () => {
+            setNetworkEnabled(enabled);
+        }, undefined);
+    },
+
+    /** Enable/disable SDK log capture */
+    setSdkLogsEnabled(enabled: boolean): void {
+        safeCall('ReplaySdk.setSdkLogsEnabled', () => {
+            setConsoleEnabled(enabled);
+        }, undefined);
+    },
+
+    // ─── Screen Tracking ────────────────────────────────────────────────
+
+    /** Set the current screen name for replay context */
+    async setCurrentScreen(screenName: string): Promise<void> {
+        return safeCallAsync('ReplaySdk.setCurrentScreen', async () => {
+            if (!_initialized) return;
+            await sessionOrchestrator.setCurrentScreen(screenName);
+        }, undefined);
+    },
+
+    // ─── User Identity ──────────────────────────────────────────────────
+
+    /** Set user identity for the current session */
+    async setUser(user: ReplayUser): Promise<void> {
+        return safeCallAsync('ReplaySdk.setUser', async () => {
+            if (!_initialized) return;
+            await sessionOrchestrator.setUser(user);
+        }, undefined);
+    },
+
+    /** Clear user identity */
+    async clearUser(): Promise<void> {
+        return safeCallAsync('ReplaySdk.clearUser', async () => {
+            if (!_initialized) return;
+            await sessionOrchestrator.clearUser();
+        }, undefined);
+    },
+
+    // ─── Privacy ────────────────────────────────────────────────────────
+
+    /** Update privacy options at runtime */
+    async setPrivacyOptions(options: Partial<ReplayPrivacyOptions>): Promise<void> {
+        return safeCallAsync('ReplaySdk.setPrivacyOptions', async () => {
+            if (!_initialized || !_config) return;
+            _config.privacy = { ..._config.privacy, ...options };
+            await bridgeAdapter.setPrivacyOptions(_config.privacy);
+        }, undefined);
+    },
+
+    // ─── Breadcrumbs ────────────────────────────────────────────────────
+
+    /** Add a custom breadcrumb to the session timeline */
+    async addBreadcrumb(breadcrumb: ReplayBreadcrumb): Promise<void> {
+        return safeCallAsync('ReplaySdk.addBreadcrumb', async () => {
+            await breadcrumbCollector.addBreadcrumb(breadcrumb);
+        }, undefined);
+    },
+
+    // ─── Sync / Upload ──────────────────────────────────────────────────
+
+    /** Set a callback invoked before each upload batch. Return false to cancel. */
+    setSyncCallback(callback: ReplaySyncCallback | null): void {
+        safeCall('ReplaySdk.setSyncCallback', () => {
+            sessionOrchestrator.setSyncCallback(callback);
+        }, undefined);
+    },
+
+    /** Force-flush pending data for upload */
+    async flush(): Promise<void> {
+        return safeCallAsync('ReplaySdk.flush', async () => {
+            if (!_initialized) return;
+            await bridgeAdapter.flushUpload();
+        }, undefined);
+    },
+
+    // ─── Query ──────────────────────────────────────────────────────────
+
+    /** Get a link to the current session replay (if available) */
+    async getSessionReplayLink(): Promise<ReplayLinkResult | null> {
+        return safeCallAsync('ReplaySdk.getSessionReplayLink', async () => {
+            if (!_initialized) return null;
+            const result = await bridgeAdapter.getSessionReplayLink();
+            if (!result) return null;
+            return {
+                url: result.url,
+                sessionId: result.sessionId,
+                uploaded: result.uploaded,
+            };
+        }, null);
+    },
+
+    /** Get whether the SDK is currently recording */
+    get isRecording(): boolean {
+        return safeCall('ReplaySdk.isRecording', () => sessionOrchestrator.isRecording, false);
+    },
+
+    /** Get the current session ID */
+    get sessionId(): string | null {
+        return safeCall('ReplaySdk.sessionId', () => sessionOrchestrator.sessionId, null);
+    },
+
+    // ─── Cleanup ────────────────────────────────────────────────────────
+
+    /** Destroy the SDK and release all resources */
+    async destroy(): Promise<void> {
+        return safeCallAsync('ReplaySdk.destroy', async () => {
+            uninstallConsoleIntegration();
+            batchManager.reset();
+            breadcrumbCollector.clear();
+            await sessionOrchestrator.destroy();
+
+            // Destroy transport
+            if (_transport) {
+                _transport.destroy();
+                _transport = null;
+            }
+
+            _initialized = false;
+            _config = null;
+            logger.info('SDK destroyed');
+        }, undefined);
+    },
+};