@mattebox/player-diagnostics 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @mattebox/player-diagnostics: <mbx-diagnostics>, a control for the
+ * player's bar, or a panel under the video, that shows what the session
+ * is doing and what the browser can do, and writes a report. Importing
+ * this module registers the element; that is the package's one side
+ * effect. It reaches the player only through the contract a control of
+ * the page's own has, and the engine through its public surface.
+ */
+import { MbxDiagnostics } from './element.js';
+export { MbxDiagnostics } from './element.js';
+export type { DiagnosticsReport, EngineReport, PlaybackReport } from './report.js';
+export type { Counters, Mark, Sample } from './sampler.js';
+export type { CodecRow, DrmRow, PlatformRow, Support } from './support.js';
+export { probeSupport } from './support.js';
+export declare const DIAGNOSTICS = "mbx-diagnostics";
+declare global {
+    interface HTMLElementTagNameMap {
+        'mbx-diagnostics': MbxDiagnostics;
+    }
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACnF,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3D,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,eAAO,MAAM,WAAW,oBAAoB,CAAC;AAM7C,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,iBAAiB,EAAE,cAAc,CAAC;KACnC;CACF"}

package/dist/index.js

@@ -0,0 +1,16 @@
+/**
+ * @mattebox/player-diagnostics: <mbx-diagnostics>, a control for the
+ * player's bar, or a panel under the video, that shows what the session
+ * is doing and what the browser can do, and writes a report. Importing
+ * this module registers the element; that is the package's one side
+ * effect. It reaches the player only through the contract a control of
+ * the page's own has, and the engine through its public surface.
+ */
+import { MbxDiagnostics } from './element.js';
+export { MbxDiagnostics } from './element.js';
+export { probeSupport } from './support.js';
+export const DIAGNOSTICS = 'mbx-diagnostics';
+if (customElements.get(DIAGNOSTICS) === undefined) {
+    customElements.define(DIAGNOSTICS, MbxDiagnostics);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAI9C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,CAAC,MAAM,WAAW,GAAG,iBAAiB,CAAC;AAE7C,IAAI,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,SAAS,EAAE,CAAC;IAClD,cAAc,CAAC,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;AACrD,CAAC"}

package/dist/report.d.ts

@@ -0,0 +1,140 @@
+/**
+ * The report: everything the panel shows, as one plain object a page can
+ * send when something goes wrong, and the trace the engine's guide asks
+ * for with every error report (chapter 12), as the element kept it: see
+ * `trace.ts` for what is kept of each entry. Every field is serializable;
+ * a native session has no engine part.
+ */
+import type { Mattebox } from 'mattebox';
+import type { PlayerError, PlayerHost } from './host.js';
+import type { Counters, Mark, Sample } from './sampler.js';
+import type { Support } from './support.js';
+export interface RangeReport {
+    readonly start: number;
+    readonly end: number;
+}
+export interface PlaybackReport {
+    readonly currentTime: number;
+    readonly duration: number;
+    readonly paused: boolean;
+    readonly ended: boolean;
+    readonly seeking: boolean;
+    readonly readyState: number;
+    readonly networkState: number;
+    readonly playbackRate: number;
+    readonly volume: number;
+    readonly muted: boolean;
+    readonly videoWidth: number;
+    readonly videoHeight: number;
+    readonly buffered: readonly RangeReport[];
+    readonly seekable: readonly RangeReport[];
+    readonly frames: {
+        readonly decoded: number;
+        readonly dropped: number;
+    } | null;
+    readonly mediaError: {
+        readonly code: number;
+        readonly message: string;
+    } | null;
+}
+export interface EngineReport {
+    readonly phase: string;
+    readonly capabilities: readonly string[];
+    readonly throughput: {
+        readonly slow: number;
+        readonly fast: number;
+    };
+    readonly bufferGoal: number;
+    readonly buffers: ReadonlyArray<{
+        readonly id: string;
+        readonly codecs: string;
+        readonly ranges: readonly RangeReport[];
+    }>;
+    readonly inflight: ReadonlyArray<{
+        readonly trackId: string;
+        readonly seq: number;
+        readonly url: string;
+    }>;
+    readonly live: {
+        readonly start: number;
+        readonly end: number;
+        readonly edge: number;
+        readonly latency: number | null;
+    } | null;
+    readonly tracks: {
+        readonly active: Readonly<Record<string, string | null>>;
+        readonly available: ReadonlyArray<{
+            readonly id: string;
+            readonly contentType: string;
+            readonly mimeType: string;
+            readonly lang: string | null;
+            readonly role: string | null;
+            readonly renditions: number;
+        }>;
+    };
+    readonly quality: {
+        readonly playing: string | null;
+        readonly active: string | null;
+        readonly pinned: string | null;
+        readonly allowed: readonly string[];
+        readonly renditions: ReadonlyArray<{
+            readonly id: string;
+            readonly bitrate: number;
+            readonly width: number | null;
+            readonly height: number | null;
+            readonly frameRate: number | null;
+            readonly codecs: string | null;
+        }>;
+    };
+    readonly drm: {
+        readonly keySystem: string | null;
+        readonly sessions: ReadonlyArray<{
+            readonly keyId: string;
+            readonly status: string;
+        }>;
+    } | null;
+    readonly error: {
+        readonly category: string;
+        readonly code: string;
+        readonly fatal: boolean;
+        readonly recoverable: boolean;
+        readonly context: Readonly<Record<string, unknown>> | null;
+    } | null;
+}
+export interface DiagnosticsReport {
+    /** When the report was taken, ISO 8601. */
+    readonly at: string;
+    readonly userAgent: string;
+    readonly source: {
+        readonly url: string | null;
+        readonly type: string | null;
+        /** The name of the handler that won, or null before a session. */
+        readonly handler: string | null;
+    };
+    readonly playback: PlaybackReport;
+    /** The player's fatal error of the current load, or null. */
+    readonly error: PlayerError | null;
+    /** Null for a native session. */
+    readonly engine: EngineReport | null;
+    readonly counters: Counters;
+    /** The last two minutes of samples, and the marks in them. */
+    readonly samples: readonly Sample[];
+    readonly marks: readonly Mark[];
+    /** What the browser supports, when it was probed before the report. */
+    readonly support: Support | null;
+    /** The trace entries the element kept, slimmed, oldest first, or null for a native session. */
+    readonly trace: readonly unknown[] | null;
+}
+export declare function playbackFacts(video: HTMLVideoElement): PlaybackReport;
+export declare function engineFacts(engine: Mattebox): EngineReport;
+export interface ReportSources {
+    readonly player: PlayerHost;
+    readonly samples: readonly Sample[];
+    readonly marks: readonly Mark[];
+    readonly counters: Counters;
+    /** The trace entries kept, slimmed, oldest first. */
+    readonly history: readonly unknown[];
+    readonly support: Support | null;
+}
+export declare function buildReport(sources: ReportSources): DiagnosticsReport;
+//# sourceMappingURL=report.d.ts.map

package/dist/report.d.ts.map

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

package/dist/report.js

@@ -0,0 +1,125 @@
+function ranges(list) {
+    return Array.from({ length: list.length }, (_, i) => ({
+        start: list.start(i),
+        end: list.end(i),
+    }));
+}
+export function playbackFacts(video) {
+    const quality = video.getVideoPlaybackQuality?.();
+    return {
+        currentTime: video.currentTime,
+        duration: video.duration,
+        paused: video.paused,
+        ended: video.ended,
+        seeking: video.seeking,
+        readyState: video.readyState,
+        networkState: video.networkState,
+        playbackRate: video.playbackRate,
+        volume: video.volume,
+        muted: video.muted,
+        videoWidth: video.videoWidth,
+        videoHeight: video.videoHeight,
+        buffered: ranges(video.buffered),
+        seekable: ranges(video.seekable),
+        frames: quality === undefined
+            ? null
+            : { decoded: quality.totalVideoFrames, dropped: quality.droppedVideoFrames },
+        mediaError: video.error === null ? null : { code: video.error.code, message: video.error.message },
+    };
+}
+export function engineFacts(engine) {
+    const state = engine.stats.snapshot();
+    const optional = engine;
+    const error = engine.error;
+    return {
+        phase: state.lifecycle.phase,
+        capabilities: [...engine.capabilities()],
+        throughput: { slow: state.stats.throughputEwma, fast: state.stats.throughputFastEwma },
+        bufferGoal: state.scheduling.bufferGoal,
+        buffers: [...state.buffers.entries()].map(([id, buffer]) => ({
+            id,
+            codecs: buffer.codecs,
+            ranges: buffer.ranges.map((range) => ({ start: range.start, end: range.end })),
+        })),
+        inflight: [...state.scheduling.inflight.values()].map((request) => ({
+            trackId: request.trackId,
+            seq: request.seq,
+            url: request.url,
+        })),
+        live: state.live === null
+            ? null
+            : {
+                start: state.live.span.start,
+                end: state.live.span.end,
+                edge: state.live.edge,
+                latency: optional.live?.latency ?? null,
+            },
+        tracks: {
+            active: Object.fromEntries(['video', 'audio', 'text'].map((type) => [
+                type,
+                engine.tracks.active(type)?.id ?? null,
+            ])),
+            available: engine.tracks.available.map((track) => ({
+                id: track.id,
+                contentType: track.contentType,
+                mimeType: track.mimeType,
+                lang: track.lang ?? null,
+                role: track.role ?? null,
+                renditions: track.renditions.length,
+            })),
+        },
+        quality: {
+            playing: engine.quality.playing?.id ?? null,
+            active: engine.quality.active?.id ?? null,
+            pinned: engine.quality.pinned,
+            allowed: engine.quality.allowed.map((r) => r.id),
+            renditions: engine.quality.renditions.map((r) => ({
+                id: r.id,
+                bitrate: r.bitrate,
+                width: r.width ?? null,
+                height: r.height ?? null,
+                frameRate: r.frameRate ?? null,
+                codecs: r.codecs,
+            })),
+        },
+        drm: optional.drm === undefined
+            ? null
+            : { keySystem: optional.drm.keySystem, sessions: [...optional.drm.sessions] },
+        error: error === null
+            ? null
+            : {
+                category: error.category,
+                code: error.code,
+                fatal: error.fatal,
+                recoverable: error.recoverable,
+                context: error.context ?? null,
+            },
+    };
+}
+/** Two minutes of samples at two a second, and the marks of the same two minutes. */
+const KEEP_SAMPLES = 240;
+const KEEP_MS = 120_000;
+export function buildReport(sources) {
+    const { player } = sources;
+    const engine = player.engine;
+    const samples = sources.samples.slice(-KEEP_SAMPLES);
+    const since = performance.now() - KEEP_MS;
+    return {
+        at: new Date().toISOString(),
+        userAgent: navigator.userAgent,
+        source: {
+            url: player.getAttribute('src'),
+            type: player.getAttribute('type'),
+            handler: player.player?.session?.handler ?? null,
+        },
+        playback: playbackFacts(player.video),
+        error: player.error,
+        engine: engine === null ? null : engineFacts(engine),
+        counters: sources.counters,
+        samples,
+        marks: sources.marks.filter((mark) => mark.t >= since),
+        support: sources.support,
+        trace: engine === null ? null : sources.history,
+    };
+}
+//# sourceMappingURL=report.js.map

package/dist/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AAiIA,SAAS,MAAM,CAAC,IAAgB;IAC9B,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACpD,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACpB,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;KACjB,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAuB;IACnD,MAAM,OAAO,GAAG,KAAK,CAAC,uBAAuB,EAAE,EAAE,CAAC;IAClD,OAAO;QACL,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC;QAChC,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC;QAChC,MAAM,EACJ,OAAO,KAAK,SAAS;YACnB,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,gBAAgB,EAAE,OAAO,EAAE,OAAO,CAAC,kBAAkB,EAAE;QAChF,UAAU,EACR,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE;KACzF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAgB;IAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAG,MAAoB,CAAC;IACtC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC3B,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,KAAK;QAC5B,YAAY,EAAE,CAAC,GAAG,MAAM,CAAC,YAAY,EAAE,CAAC;QACxC,UAAU,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,cAAc,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,kBAAkB,EAAE;QACtF,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,UAAU;QACvC,OAAO,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3D,EAAE;YACF,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;SAC/E,CAAC,CAAC;QACH,QAAQ,EAAE,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAClE,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG;SACjB,CAAC,CAAC;QACH,IAAI,EACF,KAAK,CAAC,IAAI,KAAK,IAAI;YACjB,CAAC,CAAC,IAAI;YACN,CAAC,CAAC;gBACE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK;gBAC5B,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;gBACxB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI;gBACrB,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,IAAI,IAAI;aACxC;QACP,MAAM,EAAE;YACN,MAAM,EAAE,MAAM,CAAC,WAAW,CACvB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;gBAClD,IAAI;gBACJ,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,IAAI;aACvC,CAAC,CACH;YACD,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACjD,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,IAAI;gBACxB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,IAAI;gBACxB,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,MAAM;aACpC,CAAC,CAAC;SACJ;QACD,OAAO,EAAE;YACP,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,IAAI,IAAI;YAC3C,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,IAAI,IAAI;YACzC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;YAC7B,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChD,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAChD,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI;gBACtB,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,IAAI;gBACxB,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,IAAI;gBAC9B,MAAM,EAAE,CAAC,CAAC,MAAM;aACjB,CAAC,CAAC;SACJ;QACD,GAAG,EACD,QAAQ,CAAC,GAAG,KAAK,SAAS;YACxB,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE;QACjF,KAAK,EACH,KAAK,KAAK,IAAI;YACZ,CAAC,CAAC,IAAI;YACN,CAAC,CAAC;gBACE,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI;aAC/B;KACR,CAAC;AACJ,CAAC;AAED,qFAAqF;AACrF,MAAM,YAAY,GAAG,GAAG,CAAC;AACzB,MAAM,OAAO,GAAG,OAAO,CAAC;AAYxB,MAAM,UAAU,WAAW,CAAC,OAAsB;IAChD,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC3B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;IAC1C,OAAO;QACL,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC5B,SAAS,EAAE,SAAS,CAAC,SAAS;QAC9B,MAAM,EAAE;YACN,GAAG,EAAE,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC;YAC/B,IAAI,EAAE,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC;YACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI;SACjD;QACD,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC;QACrC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC;QACpD,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,OAAO;QACP,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC;QACtD,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO;KAChD,CAAC;AACJ,CAAC"}

package/dist/sampler.d.ts

@@ -0,0 +1,68 @@
+/**
+ * The sampler: what the charts, the counters and the report are drawn
+ * from, taken every half second while the element is attached, so a stall
+ * counted before the panel opened is still counted. It reads the way the
+ * engine's playground reads: the kernel state through
+ * `engine.stats.snapshot()`, the rendition playing through
+ * `engine.quality.playing`, the trace for the segments, the stalls, the
+ * seeks and what recovery did, and the video itself for the buffer ahead,
+ * the frames and whether it is stalled. The engine emits no event for a
+ * quality switch, so the switch is a poll's diff.
+ *
+ * The trace arrives as `trace` events where the engine emits them, one
+ * entry at a time, and the sampler keeps its own history of them, slimmed
+ * and bounded, which is what the report sends. An engine without the
+ * event keeps a ring instead, and the sampler reads it through a cursor
+ * that remembers the last entry seen by identity and, once the ring has
+ * evicted it, by its clock. Both routes feed the same intake, and an
+ * entry seen once is not taken twice.
+ */
+import type { Mattebox } from 'mattebox';
+export interface Sample {
+    /** performance.now() */
+    readonly t: number;
+    readonly currentTime: number;
+    /** The slow and the fast throughput estimates, bits per second. */
+    readonly slow: number;
+    readonly fast: number;
+    /** Seconds buffered ahead of the playhead. */
+    readonly ahead: number;
+    readonly stalled: boolean;
+    /** Frames dropped and decoded since the last sample. */
+    readonly dropped: number;
+    readonly decoded: number;
+    readonly playingId: string | null;
+    readonly playingBitrate: number;
+    readonly playingHeight: number;
+}
+export type MarkKind = 'segment' | 'stall' | 'seek' | 'nudge' | 'flush' | 'skip' | 'gap-jump' | 'switch';
+export interface Mark {
+    readonly t: number;
+    readonly kind: MarkKind;
+    readonly value: number;
+    readonly label: string;
+    readonly trackId?: string;
+}
+export interface Counters {
+    readonly stalls: number;
+    /** Seconds spent stalled, the current stall included. */
+    readonly stalledSeconds: number;
+    readonly switches: number;
+    /** The video's own totals for the session. */
+    readonly decoded: number;
+    readonly dropped: number;
+}
+export interface Sampler {
+    /** Forgets everything and follows a session's trace: a new session starts its counts at zero. */
+    attach(video: HTMLVideoElement, engine: Mattebox | null): void;
+    /** Lets go of the session's trace. */
+    release(): void;
+    poll(video: HTMLVideoElement, engine: Mattebox | null): void;
+    readonly samples: readonly Sample[];
+    readonly marks: readonly Mark[];
+    readonly counters: Counters;
+    /** The trace entries kept, slimmed and plain, oldest first. */
+    readonly history: readonly unknown[];
+}
+export declare function createSampler(): Sampler;
+//# sourceMappingURL=sampler.d.ts.map

package/dist/sampler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sampler.d.ts","sourceRoot":"","sources":["../src/sampler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAyB,MAAM,UAAU,CAAC;AAGhE,MAAM,WAAW,MAAM;IACrB,wBAAwB;IACxB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,MAAM,QAAQ,GAChB,SAAS,GACT,OAAO,GACP,MAAM,GACN,OAAO,GACP,OAAO,GACP,MAAM,GACN,UAAU,GACV,QAAQ,CAAC;AAEb,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,8CAA8C;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,OAAO;IACtB,iGAAiG;IACjG,MAAM,CAAC,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAC;IAC/D,sCAAsC;IACtC,OAAO,IAAI,IAAI,CAAC;IAChB,IAAI,CAAC,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAC;IAC7D,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,CAAC;CACtC;AAcD,wBAAgB,aAAa,IAAI,OAAO,CA2MvC"}

package/dist/sampler.js

@@ -0,0 +1,208 @@
+import { slimEntry } from './trace.js';
+/** Twenty minutes at two samples a second. */
+const MAX_SAMPLES = 2400;
+/** Trace entries kept, the engine's own default for a ring. */
+const MAX_HISTORY = 500;
+const RECOVERY = new Set(['nudge', 'flush', 'skip', 'gap-jump']);
+/** A rendition's name for a mark: its height, else its bitrate. */
+function label(r) {
+    return r.height !== undefined ? `${r.height}p` : `${Math.round(r.bitrate / 1000)} kbps`;
+}
+export function createSampler() {
+    let samples = [];
+    let marks = [];
+    let history = [];
+    /** Entries already taken, so the event and the ring never count one twice. */
+    let seen = new WeakSet();
+    let off = null;
+    let last = null;
+    let lastT = 0;
+    let lastQuality = null;
+    let lastPlayingId = null;
+    let stallStart = null;
+    let stalls = 0;
+    let stalledTotal = 0;
+    let switches = 0;
+    let decoded = 0;
+    let dropped = 0;
+    function push(mark) {
+        marks.push(mark);
+        if (marks.length > MAX_SAMPLES * 2)
+            marks.splice(0, marks.length - MAX_SAMPLES * 2);
+    }
+    /** The trace entries since the last read, oldest first. */
+    function fresh(engine) {
+        const trace = engine.stats.trace();
+        let from = 0;
+        if (last !== null) {
+            const at = trace.indexOf(last);
+            from = at >= 0 ? at + 1 : trace.findIndex((entry) => entry.t > lastT);
+            if (from < 0)
+                from = trace.length;
+        }
+        const tail = trace[trace.length - 1];
+        if (tail !== undefined) {
+            last = tail;
+            lastT = tail.t;
+        }
+        return trace.slice(from);
+    }
+    /** One entry in: its marks for the charts, and its slimmed self for the history. */
+    function take(entry, video) {
+        if (seen.has(entry))
+            return;
+        seen.add(entry);
+        history.push(slimEntry(entry));
+        if (history.length > MAX_HISTORY)
+            history.splice(0, history.length - MAX_HISTORY);
+        {
+            const msg = entry.msg;
+            if (msg.type === 'SEGMENT_LOADED' && msg.trackId !== 'manifest' && msg.size > 0) {
+                push({
+                    t: entry.t,
+                    kind: 'segment',
+                    value: (msg.size * 8000) / Math.max(msg.rtt, 1),
+                    label: `${msg.trackId} #${msg.seq}`,
+                    trackId: msg.trackId,
+                });
+            }
+            else if (msg.type === 'STALLED') {
+                push({
+                    t: entry.t,
+                    kind: 'stall',
+                    value: msg.at,
+                    label: `stalled at ${msg.at.toFixed(1)}s`,
+                });
+            }
+            else if (msg.type === 'SEEKING') {
+                push({ t: entry.t, kind: 'seek', value: msg.to, label: `seek to ${msg.to.toFixed(1)}s` });
+            }
+            for (const effect of entry.effects) {
+                if (effect.kind !== 'emit')
+                    continue;
+                const name = effect.event.replace('recovery:', '');
+                if (RECOVERY.has(name)) {
+                    push({
+                        t: entry.t,
+                        kind: name,
+                        value: video.currentTime,
+                        label: `recovery ${name}`,
+                    });
+                }
+            }
+        }
+    }
+    function reset() {
+        samples = [];
+        marks = [];
+        history = [];
+        seen = new WeakSet();
+        last = null;
+        lastT = 0;
+        lastQuality = null;
+        lastPlayingId = null;
+        stallStart = null;
+        stalls = 0;
+        stalledTotal = 0;
+        switches = 0;
+        decoded = 0;
+        dropped = 0;
+    }
+    function release() {
+        off?.();
+        off = null;
+    }
+    return {
+        attach(video, engine) {
+            release();
+            reset();
+            if (engine === null)
+                return;
+            off = engine.on('trace', (entry) => {
+                take(entry, video);
+            });
+        },
+        release,
+        poll(video, engine) {
+            const now = performance.now();
+            // The ring, for an engine that keeps one and emits nothing.
+            if (engine !== null)
+                for (const entry of fresh(engine))
+                    take(entry, video);
+            const state = engine?.stats.snapshot() ?? null;
+            const playing = engine?.quality.playing ?? null;
+            const quality = video.getVideoPlaybackQuality?.();
+            decoded = quality?.totalVideoFrames ?? 0;
+            dropped = quality?.droppedVideoFrames ?? 0;
+            const droppedDelta = lastQuality === null ? 0 : Math.max(0, dropped - lastQuality.dropped);
+            const decodedDelta = lastQuality === null ? 0 : Math.max(0, decoded - lastQuality.decoded);
+            lastQuality = { dropped, decoded };
+            let ahead = 0;
+            for (let i = 0; i < video.buffered.length; i += 1) {
+                if (video.buffered.start(i) <= video.currentTime + 0.25 &&
+                    video.buffered.end(i) > video.currentTime) {
+                    ahead = video.buffered.end(i) - video.currentTime;
+                }
+            }
+            const stalled = !video.paused &&
+                !video.ended &&
+                !video.seeking &&
+                video.readyState < 3 &&
+                video.currentTime > 0;
+            if (stalled && stallStart === null) {
+                stallStart = now;
+                stalls += 1;
+            }
+            else if (!stalled && stallStart !== null) {
+                stalledTotal += (now - stallStart) / 1000;
+                stallStart = null;
+            }
+            if (playing !== null && lastPlayingId !== null && playing.id !== lastPlayingId) {
+                switches += 1;
+                push({
+                    t: now,
+                    kind: 'switch',
+                    value: playing.height ?? playing.bitrate,
+                    label: `now ${label(playing)}`,
+                });
+            }
+            if (playing !== null)
+                lastPlayingId = playing.id;
+            samples.push({
+                t: now,
+                currentTime: video.currentTime,
+                slow: state?.stats.throughputEwma ?? 0,
+                fast: state?.stats.throughputFastEwma ?? 0,
+                ahead,
+                stalled,
+                dropped: droppedDelta,
+                decoded: decodedDelta,
+                playingId: playing?.id ?? null,
+                playingBitrate: playing?.bitrate ?? 0,
+                playingHeight: playing?.height ?? 0,
+            });
+            if (samples.length > MAX_SAMPLES)
+                samples.splice(0, samples.length - MAX_SAMPLES);
+        },
+        get samples() {
+            return samples;
+        },
+        get marks() {
+            return marks;
+        },
+        get history() {
+            return history;
+        },
+        get counters() {
+            const current = stallStart === null ? 0 : (performance.now() - stallStart) / 1000;
+            return {
+                stalls,
+                stalledSeconds: stalledTotal + current,
+                switches,
+                decoded,
+                dropped,
+            };
+        },
+    };
+}
+//# sourceMappingURL=sampler.js.map

package/dist/sampler.js.map

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

package/dist/style.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The element's stylesheet. The button is drawn the way the player's own
+ * buttons are, in a copy: the player's styles are internal, and a control
+ * of the page's own carries its own sheet. Tokens come through the
+ * `--mbx-*` custom properties the player sets, which inherit through light
+ * DOM; the chart colours have defaults here and a page overrides them the
+ * same way. Nothing carries `!important`, so a page's `::part()` rule wins.
+ */
+export declare const STYLE = "\n:host {\n  display: inline-flex;\n  position: relative;\n  --mbx-chart-1: #5aa9e0;\n  --mbx-chart-2: #6fbf8f;\n  --mbx-chart-3: #d9a83f;\n  --mbx-chart-4: #e05a6e;\n  --mbx-chart-5: #a98fe0;\n}\n:host([hidden]) { display: none; }\n:host([inline]) { display: block; }\n[part~=\"button\"] {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  flex: none;\n  width: 40px;\n  height: 40px;\n  padding: 0;\n  font: inherit;\n  color: inherit;\n  background: transparent;\n  border: 0;\n  border-radius: var(--mbx-radius);\n  cursor: pointer;\n  opacity: 0.9;\n}\n[part~=\"button\"]:hover { opacity: 1; }\n[part~=\"button\"]:focus-visible { outline: 2px solid var(--mbx-accent); outline-offset: -2px; }\n[part~=\"icon\"], ::slotted(*) { width: 1.75em; height: 1.75em; fill: currentColor; }\n:host([inline]) [part~=\"button\"] { display: none; }\n[part~=\"panel\"] {\n  position: absolute;\n  right: 0;\n  bottom: 100%;\n  box-sizing: border-box;\n  width: 560px;\n  margin-bottom: 8px;\n  display: flex;\n  flex-direction: column;\n  overflow: hidden;\n  color: var(--mbx-text, #f2f3f5);\n  background: rgba(16, 17, 20, 0.95);\n  border-radius: var(--mbx-radius, 4px);\n  box-shadow: 0 4px 16px rgba(0, 0, 0, 0.5);\n  font: 400 12px/1.5 var(--mbx-mono, ui-monospace, SFMono-Regular, Menlo, Consolas, monospace);\n  text-align: left;\n  white-space: normal;\n}\n[part~=\"panel\"][hidden] { display: none; }\n:host([inline]) [part~=\"panel\"] {\n  position: static;\n  width: auto;\n  max-height: none;\n  margin: 0;\n  box-shadow: none;\n  border-radius: 0;\n}\n[part~=\"head\"] {\n  display: flex;\n  align-items: center;\n  gap: 4px;\n  padding: 6px 8px;\n  border-bottom: 1px solid rgba(255, 255, 255, 0.12);\n}\n[part~=\"tab\"], [part~=\"chart-tab\"] {\n  font: inherit;\n  color: var(--mbx-muted, #9aa0a6);\n  background: transparent;\n  border: 0;\n  border-radius: var(--mbx-radius, 4px);\n  padding: 3px 8px;\n  cursor: pointer;\n}\n[part~=\"tab\"][aria-selected=\"true\"], [part~=\"chart-tab\"][aria-selected=\"true\"] {\n  color: var(--mbx-text, #f2f3f5);\n  background: rgba(255, 255, 255, 0.12);\n}\n[part~=\"copy\"], [part~=\"close\"], [part~=\"window\"] {\n  font: inherit;\n  color: inherit;\n  background: transparent;\n  border: 1px solid rgba(255, 255, 255, 0.25);\n  border-radius: var(--mbx-radius, 4px);\n  padding: 2px 8px;\n  cursor: pointer;\n}\n[part~=\"copy\"] { margin-left: auto; }\n[part~=\"window\"] { margin-left: auto; }\n[part~=\"window\"] option { color: #000; }\n[part~=\"tab\"]:focus-visible, [part~=\"chart-tab\"]:focus-visible, [part~=\"copy\"]:focus-visible,\n[part~=\"close\"]:focus-visible, [part~=\"window\"]:focus-visible {\n  outline: 2px solid var(--mbx-accent, #5b8cff);\n  outline-offset: -2px;\n}\n[part~=\"body\"] { min-height: 0; overflow: auto; overscroll-behavior: contain; padding: 8px; }\n[part~=\"page\"][hidden] { display: none; }\n[part~=\"rows\"] { display: grid; grid-template-columns: max-content 1fr; gap: 2px 12px; margin: 0; }\n[part~=\"key\"] { color: var(--mbx-muted, #9aa0a6); white-space: nowrap; }\n[part~=\"value\"] { margin: 0; overflow-wrap: anywhere; }\n[part~=\"heading\"] {\n  margin: 10px 0 4px;\n  font-size: 11px;\n  font-weight: 600;\n  letter-spacing: 0.06em;\n  text-transform: uppercase;\n  color: var(--mbx-muted, #9aa0a6);\n}\n[part~=\"heading\"]:first-child { margin-top: 0; }\n[part~=\"note\"] { margin: 0; color: var(--mbx-muted, #9aa0a6); }\n[part~=\"chart-tabs\"] { display: flex; flex-wrap: wrap; align-items: center; gap: 4px; margin-bottom: 6px; }\n[part~=\"chart\"] { display: block; width: 100%; height: 160px; }\n[part~=\"legend\"] { display: flex; flex-wrap: wrap; gap: 2px 12px; margin-top: 4px; color: var(--mbx-muted, #9aa0a6); }\n[part~=\"swatch\"] { display: inline-block; width: 10px; height: 10px; margin-right: 4px; border-radius: 2px; vertical-align: middle; }\n[part~=\"readout\"] { margin-top: 4px; }\n[part~=\"table\"] { width: 100%; border-collapse: collapse; margin-bottom: 4px; }\n[part~=\"cell\"] { padding: 2px 6px; text-align: left; border-bottom: 1px solid rgba(255, 255, 255, 0.08); white-space: nowrap; font-weight: 400; }\n[part~=\"label\"] { color: var(--mbx-muted, #9aa0a6); }\n[part~=\"ok\"] { color: var(--mbx-chart-2); }\n[part~=\"bad\"] { color: var(--mbx-chart-4); }\n[part~=\"na\"] { color: var(--mbx-muted, #9aa0a6); }\n[part~=\"ok\"], [part~=\"bad\"], [part~=\"na\"], [part~=\"maybe\"] { font-weight: 600; }\n";
+//# sourceMappingURL=style.d.ts.map

package/dist/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../src/style.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,KAAK,g3IA2HjB,CAAC"}