@meshstream/p2p-web 1.0.1 → 1.0.3

package/dist/player.d.ts

@@ -9,9 +9,9 @@ import { type MeshStreamServiceWorkerP2pDiagnostics } from "./service-worker-p2p
 import { type MeshStreamQoeSnapshot } from "./qoe.js";
 export type MeshStreamPlaybackMode = "p2p-hls" | "sw-hls-p2p" | "sw-hls-cdn" | "cdn-hls" | "native-hls-cdn" | "sw-direct-p2p" | "sw-direct-cdn" | "cdn-direct" | "unsupported";
 export type MeshStreamTransportPreference = "auto" | "mse" | "service-worker" | "cdn";
-export type MeshStreamP2pFallbackReason = "CAPABILITY_UNSUPPORTED" | "P2P_DISABLED" | "SDK_CONFIG_UNAVAILABLE" | "KEY_P2P_DISABLED" | "QUOTA_EXHAUSTED" | "QUOTA_DISABLED" | "TRACKER_UNAVAILABLE" | "P2P_INITIALIZATION_FAILED";
+export type MeshStreamP2pFallbackReason = "CAPABILITY_UNSUPPORTED" | "P2P_DISABLED" | "SDK_CONFIG_PENDING" | "SDK_CONFIG_UNAVAILABLE" | "KEY_P2P_DISABLED" | "QUOTA_EXHAUSTED" | "QUOTA_DISABLED" | "TRACKER_UNAVAILABLE" | "P2P_INITIALIZATION_FAILED";
 export declare function toP2pUnavailableReason(fallbackReason: MeshStreamP2pFallbackReason | undefined): P2pUnavailableReason | undefined;
-export declare function sdkConfigFallbackReason(config: SdkConfigResponse | undefined): MeshStreamP2pFallbackReason;
+export declare function sdkConfigFallbackReason(config: SdkConfigResponse | undefined, pending?: boolean): MeshStreamP2pFallbackReason;
 export interface MeshStreamServiceWorkerTransportOptions extends Omit<MeshStreamServiceWorkerRegistrationOptions, "registration"> {
     autoRegister?: boolean;
     p2pTimeoutMs?: number;
@@ -88,6 +88,7 @@ export interface HlsLike {
     loadSource(url: string): void;
     attachMedia(video: HTMLMediaElement): void;
     on(event: string, listener: (...args: unknown[]) => void): void;
+    off?(event: string, listener: (...args: unknown[]) => void): void;
     destroy(): void;
 }
 export declare class MeshStreamHlsPlayer {
@@ -120,6 +121,14 @@ export declare class MeshStreamHlsPlayer {
     private mode;
     private p2pEnabledOverride?;
     private readonly eventListeners;
+    /** Emits zero/CDN counters when bootstrap or P2P setup falls back to CDN. */
+    private fallbackStatsTimer?;
+    /** Counts CDN fragment traffic when bootstrap is still pending. */
+    private readonly cdnStats;
+    private cdnStatsHls?;
+    private readonly cdnFragLoadingHandler;
+    private readonly cdnFragLoadedHandler;
+    private readonly cdnFragLoadErrorHandler;
     private playbackState;
     private readonly lifecycle;
     private startPromise?;
@@ -140,6 +149,8 @@ export declare class MeshStreamHlsPlayer {
     private bindEventListeners;
     private bindServiceWorkerEventListeners;
     private completeFallbackStart;
+    private startFallbackStatsNotifications;
+    private stopFallbackStatsNotifications;
     private removeEventListener;
     private setPlaybackState;
     private resolveQoePlaybackState;
@@ -153,6 +164,8 @@ export declare class MeshStreamHlsPlayer {
     private createServiceWorkerP2pEngine;
     private resolveServiceWorkerSwarmId;
     private startCdnFallback;
+    private bindCdnStats;
+    private unbindCdnStats;
     private attachHls;
     private autoplay;
     private canPlayNativeHls;

package/dist/report.d.ts

@@ -132,6 +132,8 @@ export interface P2pReportPayload {
 export declare const DEFAULT_REPORT_INTERVAL_MS = 30000;
 export declare const MIN_REPORT_INTERVAL_MS = 20000;
 export declare function normalizeReportIntervalMs(value: number | undefined): number;
+/** Delay the first periodic report so a synchronized fleet does not burst. */
+export declare function initialReportDelayMs(intervalMs: number): number;
 export interface PostP2pReportOptions {
     fetcher?: typeof fetch;
     authorizationHeader?: string;

package/dist/rx-player.d.ts

@@ -135,6 +135,8 @@ export declare class MeshStreamRxPlayer {
     private mode;
     private p2pEnabledOverride?;
     private readonly eventListeners;
+    /** Emits zero/CDN counters when RxPlayer runs without a P2P client. */
+    private fallbackStatsTimer?;
     private playbackState;
     private readonly lifecycle;
     private startPromise?;
@@ -157,6 +159,8 @@ export declare class MeshStreamRxPlayer {
     private createOriginSegmentLoader;
     private completeFallbackStart;
     private bindEventListeners;
+    private startFallbackStatsNotifications;
+    private stopFallbackStatsNotifications;
     private removeEventListener;
     private setPlaybackState;
     private resolveQoePlaybackState;

package/dist/version.d.ts

@@ -1,4 +1,4 @@
 /** SDK release identifier attached to all Web usage reports. */
-export declare const MESHSTREAM_WEB_SDK_VERSION = "1.0.1";
+export declare const MESHSTREAM_WEB_SDK_VERSION = "1.0.3";
 /** Returns the version of the Web MeshStream SDK loaded by this page. */
 export declare function getSdkVersion(): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meshstream/p2p-web",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "repository": {
     "type": "git",
     "url": "https://github.com/Mesh-Stream/meshstream-p2p-web-sdk"