@push.rocks/smartbrowser 4.1.0 → 4.3.0

package/dist_ts_web/classes.livebrowservideoreceiver.d.ts

@@ -0,0 +1,46 @@
+import type { ILiveBrowserState, ILiveVideoSource } from '@push.rocks/smartpuppeteer';
+import type { ILiveBrowserCanvasError } from './interfaces.livebrowsercanvas.js';
+import type { ILiveBrowserVideoClient, ILiveBrowserVideoStatistics } from './interfaces.livebrowservideo.js';
+interface IVideoReceiverOptions {
+    video: HTMLVideoElement;
+    client: ILiveBrowserVideoClient;
+    operationTimeoutMs: number;
+    onUnavailable(): void;
+    onPresented(sourceArg: ILiveVideoSource): void;
+    onError(errorArg: ILiveBrowserCanvasError): void;
+}
+/** One native receiver. Every replacement closes the previous host peer before opening another. */
+export declare class LiveBrowserVideoReceiver {
+    private readonly options;
+    private epoch;
+    private desiredKey?;
+    private controller?;
+    private peer?;
+    private frameCallback?;
+    private connectionTimer?;
+    private sampleTimer?;
+    private tail;
+    private remoteMayExist;
+    private statistics?;
+    private decodedBeforePeer;
+    private droppedBeforePeer;
+    constructor(options: IVideoReceiverOptions);
+    getStatistics(): ILiveBrowserVideoStatistics | undefined;
+    getCounters(): {
+        framesReceived: number;
+        framesDecoded: number;
+        framesSkipped: number;
+    };
+    update(stateArg: ILiveBrowserState): void;
+    /** Synchronously prevents old frames or input from surviving a transport/source change. */
+    interrupt(): void;
+    stop(): Promise<void>;
+    private enqueue;
+    private closeRemote;
+    private connect;
+    private waitForIce;
+    private fail;
+    private sample;
+    private operation;
+}
+export {};

package/dist_ts_web/classes.livebrowservideoreceiver.js

@@ -0,0 +1,243 @@
+const sourceKey = (sourceArg) => JSON.stringify([
+    sourceArg.tabId, sourceArg.generation, sourceArg.viewportRevision,
+    sourceArg.viewport.width, sourceArg.viewport.height, sourceArg.viewport.deviceScaleFactor,
+]);
+/** One native receiver. Every replacement closes the previous host peer before opening another. */
+export class LiveBrowserVideoReceiver {
+    constructor(options) {
+        this.options = options;
+        this.epoch = 0;
+        this.tail = Promise.resolve();
+        this.remoteMayExist = false;
+        this.decodedBeforePeer = 0;
+        this.droppedBeforePeer = 0;
+        const video = options.video;
+        video.autoplay = true;
+        video.muted = true;
+        video.playsInline = true;
+        video.style.objectFit = 'contain';
+    }
+    getStatistics() {
+        return this.statistics ? { ...this.statistics } : undefined;
+    }
+    getCounters() {
+        const decoded = this.decodedBeforePeer + (this.statistics?.framesDecoded ?? 0);
+        const dropped = this.droppedBeforePeer + (this.statistics?.framesDropped ?? 0);
+        return { framesReceived: decoded + dropped, framesDecoded: decoded, framesSkipped: dropped };
+    }
+    update(stateArg) {
+        const tab = stateArg.tabs.find((tabArg) => tabArg.id === stateArg.activeTabId);
+        const source = document.visibilityState !== 'hidden'
+            && stateArg.status === 'running' && tab?.status === 'open' && tab.streaming
+            ? { tabId: tab.id, generation: tab.generation, viewportRevision: stateArg.viewportRevision,
+                viewport: { ...stateArg.viewport } }
+            : undefined;
+        const key = source ? sourceKey(source) : undefined;
+        if (key === this.desiredKey)
+            return;
+        this.interrupt();
+        this.desiredKey = key;
+        const epoch = this.epoch;
+        const controller = new AbortController();
+        this.controller = controller;
+        this.enqueue(async () => {
+            await this.closeRemote();
+            if (!source || epoch !== this.epoch)
+                return;
+            try {
+                await this.connect(source, controller.signal, epoch);
+            }
+            catch (error) {
+                if (epoch !== this.epoch || controller.signal.aborted)
+                    return;
+                this.fail('video_negotiation_failed', error, epoch);
+            }
+        });
+    }
+    /** Synchronously prevents old frames or input from surviving a transport/source change. */
+    interrupt() {
+        this.epoch++;
+        this.desiredKey = undefined;
+        this.controller?.abort(new Error('Video source was superseded'));
+        this.controller = undefined;
+        this.options.onUnavailable();
+        if (this.frameCallback !== undefined)
+            this.options.video.cancelVideoFrameCallback(this.frameCallback);
+        this.frameCallback = undefined;
+        clearTimeout(this.connectionTimer);
+        clearTimeout(this.sampleTimer);
+        this.connectionTimer = undefined;
+        this.sampleTimer = undefined;
+        this.peer?.close();
+        this.peer = undefined;
+        this.options.video.pause();
+        this.options.video.srcObject = null;
+        this.decodedBeforePeer += this.statistics?.framesDecoded ?? 0;
+        this.droppedBeforePeer += this.statistics?.framesDropped ?? 0;
+        this.statistics = undefined;
+    }
+    async stop() {
+        this.interrupt();
+        await this.enqueue(() => this.closeRemote());
+    }
+    enqueue(operationArg) {
+        const operation = this.tail.then(operationArg, operationArg);
+        this.tail = operation.catch((error) => {
+            this.options.onError({ code: 'renderer_cleanup_failed', message: `Video peer cleanup failed: ${String(error)}`, cause: error });
+        });
+        return operation;
+    }
+    async closeRemote() {
+        if (!this.remoteMayExist)
+            return;
+        await this.operation((optionsArg) => this.options.client.closeVideoPeer(optionsArg));
+        this.remoteMayExist = false;
+    }
+    async connect(sourceArg, signalArg, epochArg) {
+        this.remoteMayExist = true;
+        const offer = await this.operation((optionsArg) => this.options.client.openVideoPeer(optionsArg), signalArg);
+        if (sourceKey(offer.source) !== sourceKey(sourceArg))
+            throw new Error('Video offer does not match the current browser source');
+        if (signalArg.aborted || epochArg !== this.epoch)
+            return;
+        const peer = new RTCPeerConnection({ iceServers: offer.iceServers, iceTransportPolicy: offer.iceTransportPolicy });
+        this.peer = peer;
+        this.statistics = { connectionState: 'new', framesDecoded: 0, framesDropped: 0, bytesReceived: 0, bitrate: 0 };
+        peer.addEventListener('connectionstatechange', () => {
+            if (epochArg !== this.epoch)
+                return;
+            if (this.statistics)
+                this.statistics.connectionState = peer.connectionState;
+            if (peer.connectionState === 'failed' || peer.connectionState === 'disconnected') {
+                this.fail('video_connection_failed', new Error(`Video connection ${peer.connectionState}`), epochArg);
+            }
+        });
+        let presented = false;
+        peer.addEventListener('track', (eventArg) => {
+            if (epochArg !== this.epoch || eventArg.track.kind !== 'video')
+                return;
+            if ('jitterBufferTarget' in eventArg.receiver)
+                eventArg.receiver.jitterBufferTarget = 0;
+            this.options.video.srcObject = new MediaStream([eventArg.track]);
+            this.frameCallback = this.options.video.requestVideoFrameCallback(() => {
+                this.frameCallback = undefined;
+                if (epochArg !== this.epoch)
+                    return;
+                clearTimeout(this.connectionTimer);
+                this.connectionTimer = undefined;
+                presented = true;
+                this.options.onPresented(sourceArg);
+            });
+            void this.options.video.play().catch((error) => this.fail('video_connection_failed', error, epochArg));
+        });
+        await this.operation(async ({ signal }) => {
+            await peer.setRemoteDescription(offer.description);
+            if (signal.aborted)
+                throw signal.reason;
+            await peer.setLocalDescription(await peer.createAnswer());
+            await this.waitForIce(peer, signal);
+        }, signalArg);
+        if (signalArg.aborted || epochArg !== this.epoch)
+            return;
+        const description = peer.localDescription;
+        if (!description?.sdp || description.type !== 'answer' || description.sdp.length > 48 * 1024) {
+            throw new Error('Invalid video answer');
+        }
+        await this.operation((optionsArg) => this.options.client.answerVideoPeer(offer.negotiationId, { type: 'answer', sdp: description.sdp }, optionsArg), signalArg);
+        if (signalArg.aborted || epochArg !== this.epoch)
+            return;
+        if (!presented)
+            this.connectionTimer = setTimeout(() => this.fail('video_connection_failed', new Error('No video frame received within 30 seconds'), epochArg), 30000);
+        void this.sample(peer, signalArg, epochArg);
+    }
+    waitForIce(peerArg, signalArg) {
+        return new Promise((resolve, reject) => {
+            const cleanup = () => {
+                peerArg.removeEventListener('icegatheringstatechange', check);
+                signalArg.removeEventListener('abort', abort);
+            };
+            const abort = () => { cleanup(); reject(signalArg.reason); };
+            const check = () => {
+                if (signalArg.aborted)
+                    abort();
+                else if (peerArg.iceGatheringState === 'complete') {
+                    cleanup();
+                    resolve();
+                }
+            };
+            peerArg.addEventListener('icegatheringstatechange', check);
+            signalArg.addEventListener('abort', abort, { once: true });
+            check();
+        });
+    }
+    fail(codeArg, errorArg, epochArg) {
+        if (epochArg !== this.epoch)
+            return;
+        this.interrupt();
+        void this.enqueue(() => this.closeRemote()).catch(() => undefined);
+        this.options.onError({ code: codeArg, message: String(errorArg), cause: errorArg });
+    }
+    async sample(peerArg, signalArg, epochArg, previousArg) {
+        let previous = previousArg;
+        try {
+            const [report, sender] = await this.operation(async (optionsArg) => Promise.all([
+                peerArg.getStats(), this.options.client.getVideoStatistics(optionsArg),
+            ]), signalArg);
+            if (epochArg !== this.epoch || !this.statistics)
+                return;
+            this.statistics.sender = sender;
+            report.forEach((entryArg) => {
+                if (entryArg.type === 'inbound-rtp' && entryArg.kind === 'video') {
+                    const interval = previous ? entryArg.timestamp - previous.timestamp : 0;
+                    this.statistics.framesDecoded = entryArg.framesDecoded ?? 0;
+                    this.statistics.framesDropped = entryArg.framesDropped ?? 0;
+                    this.statistics.bytesReceived = entryArg.bytesReceived ?? 0;
+                    this.statistics.framesPerSecond = entryArg.framesPerSecond;
+                    this.statistics.decoderImplementation = entryArg.decoderImplementation;
+                    this.statistics.powerEfficientDecoder = entryArg.powerEfficientDecoder;
+                    this.statistics.codec = report.get(entryArg.codecId)?.mimeType;
+                    this.statistics.bitrate = interval > 0 ? Math.max(0, (entryArg.bytesReceived - previous.bytes) * 8000 / interval) : 0;
+                    const emitted = entryArg.jitterBufferEmittedCount ?? 0;
+                    const delay = entryArg.jitterBufferDelay ?? 0;
+                    if (previous && emitted > previous.emitted)
+                        this.statistics.jitterBufferMs =
+                            (delay - previous.delay) * 1000 / (emitted - previous.emitted);
+                    previous = { timestamp: entryArg.timestamp, bytes: entryArg.bytesReceived ?? 0, delay, emitted };
+                }
+                if (entryArg.type === 'transport' && entryArg.selectedCandidatePairId) {
+                    const pair = report.get(entryArg.selectedCandidatePairId);
+                    this.statistics.roundTripMs = pair?.currentRoundTripTime === undefined ? undefined : pair.currentRoundTripTime * 1000;
+                    this.statistics.candidateType = report.get(pair?.remoteCandidateId)?.candidateType;
+                }
+            });
+        }
+        catch (error) {
+            if (epochArg !== this.epoch || signalArg.aborted)
+                return;
+            this.options.onError({ code: 'video_statistics_failed', message: `Could not read video statistics: ${String(error)}`, cause: error });
+        }
+        if (epochArg === this.epoch && !signalArg.aborted) {
+            this.sampleTimer = setTimeout(() => { void this.sample(peerArg, signalArg, epochArg, previous); }, 1000);
+        }
+    }
+    operation(operationArg, parentSignalArg) {
+        const controller = new AbortController();
+        const abort = () => controller.abort(parentSignalArg?.reason);
+        parentSignalArg?.addEventListener('abort', abort, { once: true });
+        if (parentSignalArg?.aborted)
+            abort();
+        const timer = setTimeout(() => controller.abort(new Error('Video operation timed out')), this.options.operationTimeoutMs);
+        return new Promise((resolve, reject) => {
+            const onAbort = () => reject(controller.signal.reason);
+            controller.signal.addEventListener('abort', onAbort, { once: true });
+            if (controller.signal.aborted)
+                onAbort();
+            else
+                Promise.resolve().then(() => operationArg({ signal: controller.signal })).then(resolve, reject);
+        }).finally(() => {
+            clearTimeout(timer);
+            parentSignalArg?.removeEventListener('abort', abort);
+        });
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5saXZlYnJvd3NlcnZpZGVvcmVjZWl2ZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90c193ZWIvY2xhc3Nlcy5saXZlYnJvd3NlcnZpZGVvcmVjZWl2ZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBYUEsTUFBTSxTQUFTLEdBQUcsQ0FBQyxTQUEyQixFQUFVLEVBQUUsQ0FBQyxJQUFJLENBQUMsU0FBUyxDQUFDO0lBQ3hFLFNBQVMsQ0FBQyxLQUFLLEVBQUUsU0FBUyxDQUFDLFVBQVUsRUFBRSxTQUFTLENBQUMsZ0JBQWdCO0lBQ2pFLFNBQVMsQ0FBQyxRQUFRLENBQUMsS0FBSyxFQUFFLFNBQVMsQ0FBQyxRQUFRLENBQUMsTUFBTSxFQUFFLFNBQVMsQ0FBQyxRQUFRLENBQUMsaUJBQWlCO0NBQzFGLENBQUMsQ0FBQztBQUVILG1HQUFtRztBQUNuRyxNQUFNLE9BQU8sd0JBQXdCO0lBY25DLFlBQTZCLE9BQThCO1FBQTlCLFlBQU8sR0FBUCxPQUFPLENBQXVCO1FBYm5ELFVBQUssR0FBRyxDQUFDLENBQUM7UUFPVixTQUFJLEdBQWtCLE9BQU8sQ0FBQyxPQUFPLEVBQUUsQ0FBQztRQUN4QyxtQkFBYyxHQUFHLEtBQUssQ0FBQztRQUV2QixzQkFBaUIsR0FBRyxDQUFDLENBQUM7UUFDdEIsc0JBQWlCLEdBQUcsQ0FBQyxDQUFDO1FBRzVCLE1BQU0sS0FBSyxHQUFHLE9BQU8sQ0FBQyxLQUFLLENBQUM7UUFDNUIsS0FBSyxDQUFDLFFBQVEsR0FBRyxJQUFJLENBQUM7UUFDdEIsS0FBSyxDQUFDLEtBQUssR0FBRyxJQUFJLENBQUM7UUFDbkIsS0FBSyxDQUFDLFdBQVcsR0FBRyxJQUFJLENBQUM7UUFDekIsS0FBSyxDQUFDLEtBQUssQ0FBQyxTQUFTLEdBQUcsU0FBUyxDQUFDO0lBQ3BDLENBQUM7SUFFTSxhQUFhO1FBQ2xCLE9BQU8sSUFBSSxDQUFDLFVBQVUsQ0FBQyxDQUFDLENBQUMsRUFBRSxHQUFHLElBQUksQ0FB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

package/dist_ts_web/classes.livebrowservideorenderer.d.ts

@@ -0,0 +1,6 @@
+import { LiveBrowserRenderer } from './classes.livebrowserrenderer.js';
+import type { ILiveBrowserVideoRendererOptions } from './interfaces.livebrowservideo.js';
+/** Native video presentation; shares input, viewport and lifecycle handling with the canvas renderer. */
+export declare class LiveBrowserVideoRenderer extends LiveBrowserRenderer {
+    constructor(optionsArg: ILiveBrowserVideoRendererOptions);
+}

package/dist_ts_web/classes.livebrowservideorenderer.js

@@ -0,0 +1,8 @@
+import { LiveBrowserRenderer } from './classes.livebrowserrenderer.js';
+/** Native video presentation; shares input, viewport and lifecycle handling with the canvas renderer. */
+export class LiveBrowserVideoRenderer extends LiveBrowserRenderer {
+    constructor(optionsArg) {
+        super(optionsArg);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5saXZlYnJvd3NlcnZpZGVvcmVuZGVyZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90c193ZWIvY2xhc3Nlcy5saXZlYnJvd3NlcnZpZGVvcmVuZGVyZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLG1CQUFtQixFQUFFLE1BQU0sa0NBQWtDLENBQUM7QUFHdkUseUdBQXlHO0FBQ3pHLE1BQU0sT0FBTyx3QkFBeUIsU0FBUSxtQkFBbUI7SUFDL0QsWUFBWSxVQUE0QztRQUN0RCxLQUFLLENBQUMsVUFBVSxDQUFDLENBQUM7SUFDcEIsQ0FBQztDQUNGIn0=

package/dist_ts_web/index.d.ts

@@ -1,3 +1,6 @@
 export { LiveBrowserCanvasRenderer } from './classes.livebrowsercanvasrenderer.js';
 export type * from './interfaces.livebrowsercanvas.js';
 export type { ILiveBrowserError, ILiveBrowserErrorEvent, ILiveBrowserFrame, ILiveBrowserFrameAcknowledgement, ILiveBrowserFrameAcknowledgementRequest, ILiveBrowserFrameEvent, ILiveBrowserInputBase, ILiveBrowserInsertTextInput, ILiveBrowserKeyInput, ILiveBrowserModifierState, ILiveBrowserMouseInput, ILiveBrowserScreencastMetadata, ILiveBrowserState, ILiveBrowserStateEvent, ILiveBrowserTabState, ILiveBrowserViewport, ILiveBrowserWheelInput, TLiveBrowserEvent, TLiveBrowserEventListener, TLiveBrowserImageFormat, TLiveBrowserStatus, TLiveBrowserTabStatus, } from '@push.rocks/smartpuppeteer';
+export { LiveBrowserVideoRenderer } from './classes.livebrowservideorenderer.js';
+export type * from './interfaces.livebrowservideo.js';
+export type { ILiveVideoDescription, ILiveVideoOffer, ILiveVideoSource, ILiveVideoStatistics, ILiveVideoAcceleration } from '@push.rocks/smartpuppeteer';

package/dist_ts_web/index.js

@@ -1,2 +1,3 @@
 export { LiveBrowserCanvasRenderer } from './classes.livebrowsercanvasrenderer.js';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90c193ZWIvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLHlCQUF5QixFQUFFLE1BQU0sd0NBQXdDLENBQUMifQ==
+export { LiveBrowserVideoRenderer } from './classes.livebrowservideorenderer.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90c193ZWIvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLHlCQUF5QixFQUFFLE1BQU0sd0NBQXdDLENBQUM7QUE0Qm5GLE9BQU8sRUFBRSx3QkFBd0IsRUFBRSxNQUFNLHVDQUF1QyxDQUFDIn0=

package/dist_ts_web/interfaces.livebrowsercanvas.d.ts

@@ -11,17 +11,23 @@ export interface ILiveBrowserCanvasClient {
      * It does not prove that the upstream frame was retired.
      */
     acknowledgeFrame(requestArg: ILiveBrowserFrameAcknowledgementRequest, optionsArg: ILiveBrowserCanvasOperationOptions): Promise<ILiveBrowserFrameAcknowledgement>;
-    setViewport(viewportArg: ILiveBrowserViewport, optionsArg: ILiveBrowserCanvasOperationOptions): Promise<void>;
+    /** Shared hosts return their effective viewport, which may be constrained by another viewer. */
+    setViewport(viewportArg: ILiveBrowserViewport, optionsArg: ILiveBrowserCanvasOperationOptions): Promise<void | ILiveBrowserCanvasViewportResult>;
     dispatchMouse(inputArg: ILiveBrowserMouseInput, optionsArg: ILiveBrowserCanvasOperationOptions): Promise<void>;
     dispatchWheel(inputArg: ILiveBrowserWheelInput, optionsArg: ILiveBrowserCanvasOperationOptions): Promise<void>;
     dispatchKey(inputArg: ILiveBrowserKeyInput, optionsArg: ILiveBrowserCanvasOperationOptions): Promise<void>;
     insertText(inputArg: ILiveBrowserInsertTextInput, optionsArg: ILiveBrowserCanvasOperationOptions): Promise<void>;
 }
+export interface ILiveBrowserCanvasViewportResult {
+    viewport: ILiveBrowserViewport;
+    /** The authoritative revision, including when the aggregate viewport did not change. */
+    viewportRevision: number;
+}
 export interface ILiveBrowserCanvasOperationOptions {
     /** Adapters must propagate this signal and reject promptly when it aborts. */
     signal: AbortSignal;
 }
-export type TLiveBrowserCanvasErrorCode = 'frame_acknowledgement_failed' | 'frame_render_failed' | 'input_dispatch_failed' | 'input_queue_capacity_exceeded' | 'remote_browser_error' | 'renderer_callback_failed' | 'renderer_cleanup_failed' | 'viewport_update_failed';
+export type TLiveBrowserCanvasErrorCode = 'video_negotiation_failed' | 'video_connection_failed' | 'video_statistics_failed' | 'frame_acknowledgement_failed' | 'frame_render_failed' | 'input_dispatch_failed' | 'input_queue_capacity_exceeded' | 'remote_browser_error' | 'renderer_callback_failed' | 'renderer_cleanup_failed' | 'viewport_update_failed';
 export interface ILiveBrowserCanvasError {
     code: TLiveBrowserCanvasErrorCode;
     message: string;

package/dist_ts_web/interfaces.livebrowservideo.d.ts

@@ -0,0 +1,31 @@
+import type { ILiveVideoDescription, ILiveVideoOffer, ILiveVideoStatistics } from '@push.rocks/smartpuppeteer';
+import type { ILiveBrowserCanvasClient, ILiveBrowserCanvasOperationOptions, ILiveBrowserCanvasRendererOptions, ILiveBrowserCanvasRendererStatistics } from './interfaces.livebrowsercanvas.js';
+/** Signaling is authorized by the host's existing viewer lease. */
+export interface ILiveBrowserVideoClient extends Omit<ILiveBrowserCanvasClient, 'acknowledgeFrame'> {
+    openVideoPeer(optionsArg: ILiveBrowserCanvasOperationOptions): Promise<Omit<ILiveVideoOffer, 'peerId'>>;
+    answerVideoPeer(negotiationIdArg: string, descriptionArg: ILiveVideoDescription, optionsArg: ILiveBrowserCanvasOperationOptions): Promise<void>;
+    closeVideoPeer(optionsArg: ILiveBrowserCanvasOperationOptions): Promise<void>;
+    getVideoStatistics(optionsArg: ILiveBrowserCanvasOperationOptions): Promise<ILiveVideoStatistics>;
+}
+export interface ILiveBrowserVideoRendererOptions extends Omit<ILiveBrowserCanvasRendererOptions, 'canvas' | 'client' | 'onFrameRendered' | 'frameDecodeTimeoutMs'> {
+    video: HTMLVideoElement;
+    client: ILiveBrowserVideoClient;
+}
+export interface ILiveBrowserVideoStatistics {
+    connectionState: RTCPeerConnectionState;
+    framesDecoded: number;
+    framesDropped: number;
+    bytesReceived: number;
+    bitrate: number;
+    framesPerSecond?: number;
+    roundTripMs?: number;
+    jitterBufferMs?: number;
+    codec?: string;
+    decoderImplementation?: string;
+    powerEfficientDecoder?: boolean;
+    candidateType?: string;
+    sender?: ILiveVideoStatistics;
+}
+export interface ILiveBrowserVideoRendererStatistics extends ILiveBrowserCanvasRendererStatistics {
+    video?: ILiveBrowserVideoStatistics;
+}

package/dist_ts_web/interfaces.livebrowservideo.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlcy5saXZlYnJvd3NlcnZpZGVvLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHNfd2ViL2ludGVyZmFjZXMubGl2ZWJyb3dzZXJ2aWRlby50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIn0=

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@push.rocks/smartbrowser",
-  "version": "4.1.0",
+  "version": "4.3.0",
   "description": "A simplified Puppeteer wrapper for easy automation and testing tasks.",
   "main": "dist_ts/index.js",
   "typings": "dist_ts/index.d.ts",
@@ -31,13 +31,13 @@
   "dependencies": {
     "@push.rocks/smartdelay": "^3.1.0",
     "@push.rocks/smartpdf": "^5.0.1",
-    "@push.rocks/smartpuppeteer": "^2.7.0",
+    "@push.rocks/smartpuppeteer": "^2.8.1",
     "@push.rocks/smartunique": "^3.0.10"
   },
   "devDependencies": {
-    "@git.zone/tsbuild": "^4.4.2",
+    "@git.zone/tsbuild": "^4.4.3",
     "@git.zone/tsrun": "^2.0.6",
-    "@git.zone/tstest": "^4.0.0",
+    "@git.zone/tstest": "^6.0.0",
     "@types/node": "^26.4.1"
   },
   "private": false,

package/readme.md

@@ -1,7 +1,7 @@
 # @push.rocks/smartbrowser
 A simplified Puppeteer wrapper for easy browser automation, PDF generation, screenshots, and page evaluation.
 
-The package also provides an isolated browser-side entry at `@push.rocks/smartbrowser/web`. Its `LiveBrowserCanvasRenderer` displays SmartPuppeteer live-session frames in a canvas and maps local input back to transport-neutral browser commands without bundling Puppeteer or Node.js code into the web application.
+The package also provides an isolated browser-side entry at `@push.rocks/smartbrowser/web`. Its `LiveBrowserVideoRenderer` presents native WebRTC video, while `LiveBrowserCanvasRenderer` displays SmartPuppeteer image frames in a canvas and maps local input back to transport-neutral browser commands without bundling Puppeteer or Node.js code into the web application.
 
 ## Issue Reporting and Security
 
@@ -102,6 +102,28 @@ import { smartpuppeteer } from '@push.rocks/smartbrowser';
 const browser = await smartpuppeteer.getEnvAwareBrowserInstance();
 ```
 
+## Live Browser Video
+
+`LiveBrowserVideoRenderer` presents a SmartPuppeteer video stream directly in an `HTMLVideoElement`. It shares the canvas renderer's bounded input queue, held-input cleanup, viewport negotiation, and suspend/resume lifecycle. There is no JavaScript image decoding or canvas copy in the video path.
+
+```typescript
+import { LiveBrowserVideoRenderer, type ILiveBrowserVideoClient } from '@push.rocks/smartbrowser/web';
+
+export async function mountVideo(video: HTMLVideoElement, client: ILiveBrowserVideoClient) {
+  const renderer = new LiveBrowserVideoRenderer({ video, client, resizeTarget: video.parentElement! });
+  await renderer.start();
+  return renderer;
+}
+```
+
+The client provides the same state and input operations as `ILiveBrowserCanvasClient`, replacing frame acknowledgements with `openVideoPeer(options)`, `answerVideoPeer(negotiationId, description, options)`, `closeVideoPeer(options)`, and `getVideoStatistics(options)`. Every asynchronous operation receives an abort signal and must settle promptly when cancelled. The host authenticates and owns the peer through the viewer's lease; callers do not choose peer IDs or ICE credentials. Subscribe to state/error events without JPEG frames. Keep the signaling transport alive until `stop()` completes, and close the host lease even when transport cleanup fails.
+
+`start()` installs listeners and begins negotiation without waiting for video, allowing applications to activate their signaling transport afterward. Input remains blocked until the browser presents a frame for the exact active tab, stream generation and viewport revision. Source changes clear the old picture immediately. `suspend()`/`resume()` close and negotiate a fresh peer. Hiding the document releases its peer; showing it opens a new one. Native video uses muted autoplay, inline playback, and `object-fit: contain`; pointer coordinates exclude the surrounding letterbox.
+
+ICE configuration comes from the host offer. With the default empty ICE server list, media connects directly over a reachable LAN or VPN without a relay or external STUN service. Signaling continues to use the application's authenticated transport. The receiver requests the lowest supported jitter-buffer target; the browser retains its network-dependent minimum. Chromium owns decoding, congestion control and frame scheduling.
+
+`getStatistics()` includes the existing cumulative input/frame counters and an optional `video` snapshot: connection state, received bytes, bitrate, decoded/dropped frames, FPS, round-trip time, jitter-buffer delay, codec, decoder, selected candidate type and host encoder statistics when available. Sampling is sequential at one-second intervals. Hardware acceleration is reported only when the browser supplies it. Media negotiation and connection failures use `video_negotiation_failed` / `video_connection_failed`; applications should recover or close the view explicitly. There is no automatic JPEG fallback.
+
 ## Live Browser Canvas
 
 Import the browser-only renderer from `@push.rocks/smartbrowser/web`. The Node.js root entry is intentionally separate and must not be imported into a frontend bundle.
@@ -171,6 +193,8 @@ Pointer and wheel input are captured from the canvas. Keyboard and best-effort `
 
 When `resizeTarget` is supplied, resize updates are deduplicated, serialized, and fenced by viewport revision. Sizes observed through `ResizeObserver` are debounced for about 100 ms (trailing), so a drag resize produces one `setViewport()` call for the final size; `syncViewport()` and window resize events measure immediately. Positive fractional dimensions are rounded to at least one CSS pixel, oversized dimensions are reduced proportionally to the 4,096 x 4,096 ceiling, and the device scale factor is clamped to 0.25 through 3 before being reduced further when necessary to stay within the physical-pixel ceiling. The target must have stable CSS dimensions that do not depend on `canvas.width` or `canvas.height`; this prevents intrinsic canvas updates from causing resize feedback.
 
+Shared browser hosts may return `{ viewport, viewportRevision }` from `setViewport()` to acknowledge the effective viewport after combining viewer preferences. The renderer accepts a smaller viewport or an unchanged revision, remembers its own requested size separately, and enables input only when a current displayed frame matches the accepted revision. A frame received before the viewport response can satisfy that fence. A newer authoritative viewport revision supersedes a pending shared resize. Existing clients returning `void` retain the single-view contract: apply the requested size and advance the viewport revision. Input remains blocked while the request settles; a still-current image stays visible when the aggregate size does not change.
+
 `ILiveBrowserCanvasRendererOptions` supports:
 
 - `canvas` and `client`: required rendering and transport-adapter dependencies.

package/ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@push.rocks/smartbrowser',
-  version: '4.1.0',
+  version: '4.3.0',
   description: 'A simplified Puppeteer wrapper for easy automation and testing tasks.'
 }

package/ts_web/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@push.rocks/smartbrowser',
-  version: '4.1.0',
+  version: '4.3.0',
   description: 'A simplified Puppeteer wrapper for easy automation and testing tasks.'
 }