@meshstream/p2p-web 1.0.1 → 1.0.2

package/dist/config.d.ts

@@ -91,9 +91,28 @@ export interface LoadSdkConfigOptions {
     fetcher?: typeof fetch;
     now?: () => number;
     timeoutMs?: number;
+    onFailure?: (reason: SdkConfigFailureReason) => void;
+    /** Internal guard used by the bounded background retry loop. */
+    suppressBackgroundRetry?: boolean;
 }
+export type SdkConfigLoader = (request: SdkConfigRequest, options?: LoadSdkConfigOptions) => Promise<SdkConfigResponse | undefined>;
+export interface PlaybackBootstrapResult {
+    config?: SdkConfigResponse;
+    /** True when playback continued before the control-plane request settled. */
+    timedOut: boolean;
+}
+export type SdkConfigFailureReason = "NETWORK" | "TRANSIENT_HTTP" | "REJECTED";
 export declare const DEFAULT_BOOTSTRAP_URL = "https://api.meshstream.net/config-api/v1/sdk/bootstrap";
 export declare const DEFAULT_BOOTSTRAP_TIMEOUT_MS = 8000;
+/**
+ * Bootstrap is started immediately, but media playback does not wait for a
+ * network round trip. A cached or already-resolved bootstrap can still enable
+ * P2P in the current session; a network response is cached for the next one.
+ */
+export declare const DEFAULT_BOOTSTRAP_STARTUP_WAIT_MS = 0;
+/** Do not keep an old policy alive indefinitely when bootstrap is down. */
+export declare const STALE_SDK_CONFIG_GRACE_MS: number;
+export declare function loadSdkConfigForPlayback(loader: SdkConfigLoader, request: SdkConfigRequest, options?: LoadSdkConfigOptions, startupWaitMs?: number): Promise<PlaybackBootstrapResult>;
 export declare function loadSdkConfig(request: SdkConfigRequest, options?: LoadSdkConfigOptions): Promise<SdkConfigResponse | undefined>;
 export declare function normalizeSdkConfig(config: Partial<SdkConfigResponse>): SdkConfigResponse;
 export declare function isSdkP2pConfigUsable(config: SdkConfigResponse | undefined): config is SdkConfigResponse;

package/dist/dash.d.ts

@@ -80,6 +80,8 @@ export declare class MeshStreamDashPlayer {
     private mode;
     private p2pEnabledOverride?;
     private readonly eventListeners;
+    /** Emits zero counters while playback is using CDN after bootstrap failure. */
+    private fallbackStatsTimer?;
     private playbackState;
     private readonly lifecycle;
     private startPromise?;
@@ -99,6 +101,8 @@ export declare class MeshStreamDashPlayer {
     private teardown;
     private startCdnDash;
     addEventListener(listener: P2pEventListener): () => void;
+    private startFallbackStatsNotifications;
+    private stopFallbackStatsNotifications;
     private startP2pDashJs;
     private effectiveP2pEnabled;
     private bindEventListeners;