googlevideo 3.0.0 → 4.0.1

package/dist/src/types/sabrStreamTypes.d.ts

@@ -0,0 +1,102 @@
+import type { SabrStreamState } from '../core/SabrStream.js';
+import type { FetchFunction, SabrFormat } from './shared.js';
+import type { EnabledTrackTypes } from '../utils/index.js';
+import type { ClientInfo } from '../utils/Protos.js';
+export interface SabrStreamConfig {
+    /**
+     * Custom fetch implementation to use for HTTP requests.
+     * If not provided, the global `fetch` function will be used.
+     */
+    fetch?: FetchFunction;
+    /**
+     * The URL endpoint for server-side ABR streaming requests.
+     * This is typically obtained from the initial player response.
+     */
+    serverAbrStreamingUrl?: string;
+    /**
+     * Base64-encoded Ustreamer configuration obtained from the player response.
+     * Required for authorizing and configuring the streaming session.
+     */
+    videoPlaybackUstreamerConfig?: string;
+    /**
+     * Client information used to identify the requesting device/app.
+     * Contains details like client name, version, and capabilities.
+     */
+    clientInfo?: ClientInfo;
+    /**
+     * Proof of Origin token for content protection verification.
+     */
+    poToken?: string;
+    /**
+     * Total duration of the media content in milliseconds.
+     * If not provided, will be determined from format metadata.
+     */
+    durationMs?: number;
+    /**
+     * Array of available streaming formats obtained from the player response.
+     */
+    formats?: SabrFormat[];
+}
+export interface SabrPlaybackOptions {
+    /**
+     * Video format selection, can be a format ID number, a SabrFormat object,
+     * or a function that selects a format from the available formats array.
+     */
+    videoFormat?: number | SabrFormat | ((formats: SabrFormat[]) => SabrFormat | undefined);
+    /**
+     * Audio format selection, can be a format ID number, a SabrFormat object,
+     * or a function that selects a format from the available formats array.
+     */
+    audioFormat?: number | SabrFormat | ((formats: SabrFormat[]) => SabrFormat | undefined);
+    /**
+     * Preferred video quality (e.g., "1080p", "720p").
+     */
+    videoQuality?: string;
+    /**
+     * Preferred audio quality (e.g., "high", "medium").
+     */
+    audioQuality?: string;
+    /**
+     * Preferred video language code.
+     */
+    videoLanguage?: string;
+    /**
+     * Preferred audio language code.
+     */
+    audioLanguage?: string;
+    /**
+     * Whether to prefer WebM container format.
+     */
+    preferWebM?: boolean;
+    /**
+     * Whether to prefer MP4 container format.
+     */
+    preferMP4?: boolean;
+    /**
+     * Whether to prefer H.264 video codec.
+     */
+    preferH264?: boolean;
+    /**
+     * Whether to prefer Opus audio codec.
+     */
+    preferOpus?: boolean;
+    /**
+     * Maximum number of retry attempts when fetching segments.
+     * Default is 10.
+     */
+    maxRetries?: number;
+    /**
+     * Duration in milliseconds after which a stall is detected if no progress is made.
+     * Default is 30000 (30 seconds).
+     */
+    stallDetectionMs?: number;
+    /**
+     * Enabled track types for streaming (audio only, video only, or both).
+     * @see EnabledTrackTypes
+     */
+    enabledTrackTypes?: EnabledTrackTypes;
+    /**
+     * Previously saved state to resume a download.
+     */
+    state?: SabrStreamState;
+}

package/dist/src/types/sabrStreamTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sabrStreamTypes.js.map

package/dist/src/types/sabrStreamTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sabrStreamTypes.js","sourceRoot":"","sources":["../../../src/types/sabrStreamTypes.ts"],"names":[],"mappings":""}

package/dist/src/types/sabrStreamingAdapterTypes.d.ts

@@ -0,0 +1,93 @@
+import type { ClientInfo, FormatInitializationMetadata, MediaHeader, NextRequestPolicy, PlaybackCookie, ReloadPlaybackContext, SabrContextSendingPolicy, SabrContextUpdate, SabrError, SabrRedirect, SnackbarMessage, StreamProtectionStatus } from '../utils/Protos.js';
+import type { SabrFormat } from './shared.js';
+import type { CacheManager, RequestMetadataManager } from '../utils/index.js';
+export interface SabrRequestMetadata {
+    byteRange?: {
+        start: number;
+        end: number;
+    };
+    format?: SabrFormat;
+    isInit?: boolean;
+    isUMP?: boolean;
+    isSABR?: boolean;
+    streamInfo?: {
+        playbackCookie?: PlaybackCookie;
+        nextRequestPolicy?: NextRequestPolicy;
+        formatInitMetadata?: FormatInitializationMetadata[];
+        streamProtectionStatus?: StreamProtectionStatus;
+        reloadPlaybackContext?: ReloadPlaybackContext;
+        sabrContextSendingPolicy?: SabrContextSendingPolicy;
+        sabrContextUpdate?: SabrContextUpdate;
+        snackbarMessage?: SnackbarMessage;
+        mediaHeader?: MediaHeader;
+        redirect?: SabrRedirect;
+    };
+    error?: {
+        sabrError?: SabrError;
+    };
+    timestamp: number;
+}
+export interface SabrOptions {
+    /**
+     * Whether to enable caching of SABR segments.
+     * @default true
+     */
+    enableCaching?: boolean;
+    /**
+     * Enables verbose logging of all SABR requests made by the player.
+     * @NOTE: `DEBUG` level logging must be enabled for this to take effect.
+     * @default false
+     */
+    enableVerboseRequestLogging?: boolean;
+    /**
+     * Maximum size of the segment cache in megabytes.
+     * @default 3
+     */
+    maxCacheSizeMB?: number;
+    /**
+     * Maximum age of cached segments in seconds.
+     * @default 300 (5 minutes)
+     */
+    maxCacheAgeSeconds?: number;
+    /**
+     * Player adapter to use for SABR streaming.
+     */
+    playerAdapter?: SabrPlayerAdapter;
+    /**
+     * Client information to send with SABR requests.
+     */
+    clientInfo?: ClientInfo;
+}
+export interface PlayerHttpResponse {
+    url: string;
+    method: string;
+    headers: Record<string, string>;
+    data?: ArrayBuffer | ArrayBufferView;
+    makeRequest: (url: string, headers: Record<string, string>) => Promise<Omit<PlayerHttpResponse, 'makeRequest'>>;
+}
+export interface PlayerHttpRequest {
+    url: string;
+    method: string;
+    headers: Record<string, string>;
+    segment: RequestSegment;
+    body?: ArrayBuffer | ArrayBufferView | null;
+}
+export interface RequestSegment {
+    getStartTime: () => number | null;
+    isInit: () => boolean;
+}
+export type RequestFilter = (request: PlayerHttpRequest) => Promise<PlayerHttpRequest | undefined> | PlayerHttpRequest | undefined;
+export type ResponseFilter = (response: PlayerHttpResponse) => Promise<PlayerHttpResponse | undefined> | PlayerHttpResponse | undefined;
+export interface SabrPlayerAdapter {
+    initialize(player: any, requestMetadataManager: RequestMetadataManager, cache: CacheManager | null): void;
+    getPlayerTime(): number;
+    getPlaybackRate(): number;
+    getBandwidthEstimate(): number;
+    getActiveTrackFormats(activeFormat: SabrFormat, sabrFormats: SabrFormat[]): {
+        audioFormat?: SabrFormat;
+        videoFormat?: SabrFormat;
+    };
+    registerRequestInterceptor(interceptor: RequestFilter): void;
+    registerResponseInterceptor(interceptor: ResponseFilter): void;
+    dispose(): void;
+}

package/dist/src/types/sabrStreamingAdapterTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sabrStreamingAdapterTypes.js.map

package/dist/src/types/sabrStreamingAdapterTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sabrStreamingAdapterTypes.js","sourceRoot":"","sources":["../../../src/types/sabrStreamingAdapterTypes.ts"],"names":[],"mappings":""}

package/dist/src/types/shared.d.ts

@@ -0,0 +1,64 @@
+import type { CompositeBuffer } from '../core/CompositeBuffer.js';
+export type Part = {
+    type: number;
+    size: number;
+    data: CompositeBuffer;
+};
+export interface SabrFormat {
+    itag: number;
+    lastModified: number;
+    xtags?: string;
+    width?: number;
+    height?: number;
+    contentLength?: number;
+    audioTrackId?: string;
+    mimeType?: string;
+    isDrc?: boolean;
+    quality?: string;
+    qualityLabel?: string;
+    averageBitrate?: number;
+    bitrate: number;
+    audioQuality?: string;
+    approxDurationMs: number;
+    language?: string | null;
+    isDubbed?: boolean;
+    isAutoDubbed?: boolean;
+    isDescriptive?: boolean;
+    isSecondary?: boolean;
+    isOriginal?: boolean;
+}
+export interface FormatStream {
+    itag: number;
+    last_modified_ms?: string;
+    lastModified?: string;
+    xtags?: string;
+    width?: number;
+    height?: number;
+    mime_type?: string;
+    mimeType?: string;
+    audio_quality?: string;
+    audioQuality?: string;
+    bitrate: number;
+    average_bitrate?: number;
+    averageBitrate?: number;
+    quality?: string;
+    quality_label?: string;
+    qualityLabel?: string;
+    audio_track?: {
+        id: string;
+    };
+    audioTrackId?: string;
+    is_drc?: boolean;
+    isDrc?: boolean;
+    approx_duration_ms?: number;
+    approxDurationMs?: string;
+    content_length?: number;
+    contentLength?: string;
+    is_auto_dubbed?: boolean;
+    is_descriptive?: boolean;
+    is_dubbed?: boolean;
+    language?: string | null;
+    is_original?: boolean;
+    is_secondary?: boolean;
+}
+export type FetchFunction = typeof fetch;

package/dist/src/types/shared.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=shared.js.map

package/dist/src/types/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/types/shared.ts"],"names":[],"mappings":""}

package/dist/src/utils/CacheManager.d.ts

@@ -0,0 +1,32 @@
+export interface CacheEntry {
+    data: Uint8Array;
+    timestamp: number;
+    size: number;
+}
+/**
+ * A "proper" cache for storing segments.
+ */
+export declare class CacheManager {
+    private initSegmentCache;
+    private segmentCache;
+    private currentSize;
+    private timerId;
+    private readonly maxCacheSize;
+    private readonly maxAge;
+    private readonly logger;
+    constructor(maxSizeMB?: number, maxAgeSeconds?: number);
+    getCacheEntries(): {
+        initSegmentCache: Map<string, CacheEntry>;
+        segmentCache: Map<string, CacheEntry>;
+    };
+    setInitSegment(key: string, data: Uint8Array): void;
+    setSegment(key: string, data: Uint8Array): void;
+    getInitSegment(key: string): Uint8Array | undefined;
+    getSegment(key: string): Uint8Array | undefined;
+    private isExpired;
+    private enforceStorageLimit;
+    private clearExpiredEntries;
+    private removeOldestEntries;
+    private startGarbageCollection;
+    dispose(): void;
+}

package/dist/src/utils/CacheManager.js

@@ -0,0 +1,131 @@
+import { Logger } from './Logger.js';
+const TAG = 'CacheManager';
+/**
+ * A "proper" cache for storing segments.
+ */
+export class CacheManager {
+    constructor(maxSizeMB = 50, maxAgeSeconds = 600) {
+        this.initSegmentCache = new Map();
+        this.segmentCache = new Map();
+        this.currentSize = 0;
+        this.logger = Logger.getInstance();
+        this.maxCacheSize = maxSizeMB * 1024 * 1024;
+        this.maxAge = maxAgeSeconds * 1000;
+        this.startGarbageCollection();
+    }
+    getCacheEntries() {
+        return {
+            initSegmentCache: this.initSegmentCache,
+            segmentCache: this.segmentCache
+        };
+    }
+    setInitSegment(key, data) {
+        const entry = {
+            data,
+            timestamp: Date.now(),
+            size: data.byteLength
+        };
+        if (!this.initSegmentCache.has(key)) {
+            this.currentSize += entry.size;
+            this.enforceStorageLimit();
+        }
+        this.initSegmentCache.set(key, entry);
+    }
+    setSegment(key, data) {
+        const entry = {
+            data,
+            timestamp: Date.now(),
+            size: data.byteLength
+        };
+        this.currentSize += entry.size;
+        this.enforceStorageLimit();
+        this.segmentCache.set(key, entry);
+    }
+    getInitSegment(key) {
+        const entry = this.initSegmentCache.get(key);
+        if (entry && !this.isExpired(entry)) {
+            this.logger.debug(TAG, `Cache hit for init segment: ${key}`);
+            entry.timestamp = Date.now();
+            return entry.data;
+        }
+        // Expired. Get rid of it.
+        if (entry) {
+            this.initSegmentCache.delete(key);
+            this.currentSize -= entry.size;
+        }
+        return undefined;
+    }
+    getSegment(key) {
+        const entry = this.segmentCache.get(key);
+        if (entry && !this.isExpired(entry)) {
+            this.logger.debug(TAG, `Cache hit for segment: ${key}`);
+            const data = entry.data;
+            this.segmentCache.delete(key);
+            this.currentSize -= entry.size;
+            return data;
+        }
+        // Expired. Get rid of it.
+        if (entry) {
+            this.segmentCache.delete(key);
+            this.currentSize -= entry.size;
+        }
+        return undefined;
+    }
+    isExpired(entry) {
+        return Date.now() - entry.timestamp > this.maxAge;
+    }
+    enforceStorageLimit() {
+        if (this.currentSize <= this.maxCacheSize)
+            return;
+        this.clearExpiredEntries();
+        // If still over limit, remove oldest entries.
+        if (this.currentSize > this.maxCacheSize) {
+            this.removeOldestEntries();
+        }
+    }
+    clearExpiredEntries() {
+        const now = Date.now();
+        for (const [key, entry] of this.segmentCache.entries()) {
+            if (now - entry.timestamp > this.maxAge) {
+                this.logger.debug(TAG, `Removing expired segment from cache: ${key}`);
+                this.segmentCache.delete(key);
+                this.currentSize -= entry.size;
+            }
+        }
+        for (const [key, entry] of this.initSegmentCache.entries()) {
+            if (now - entry.timestamp > this.maxAge) {
+                this.logger.debug(TAG, `Removing expired init segment from cache: ${key}`);
+                this.initSegmentCache.delete(key);
+                this.currentSize -= entry.size;
+            }
+        }
+    }
+    removeOldestEntries() {
+        const segments = Array.from(this.segmentCache.entries());
+        const initSegments = Array.from(this.initSegmentCache.entries());
+        const allEntries = [...segments, ...initSegments]
+            .sort((a, b) => a[1].timestamp - b[1].timestamp);
+        while (this.currentSize > this.maxCacheSize && allEntries.length > 0) {
+            const [key, entry] = allEntries.shift();
+            this.segmentCache.delete(key);
+            this.initSegmentCache.delete(key);
+            this.currentSize -= entry.size;
+        }
+    }
+    startGarbageCollection() {
+        this.timerId = setInterval(() => {
+            this.clearExpiredEntries();
+        }, 60000);
+    }
+    dispose() {
+        this.initSegmentCache.clear();
+        this.segmentCache.clear();
+        this.currentSize = 0;
+        if (this.timerId) {
+            clearInterval(this.timerId);
+            this.timerId = undefined;
+        }
+        this.logger.debug(TAG, 'Disposed');
+    }
+}
+//# sourceMappingURL=CacheManager.js.map

package/dist/src/utils/CacheManager.js.map

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

package/dist/src/utils/EventEmitterLike.d.ts

@@ -1,3 +1,7 @@
+export declare class SabrAdapterError extends Error {
+    code?: string | undefined;
+    constructor(message: string, code?: string | undefined);
+}
 export declare class EventEmitterLike extends EventTarget {
     #private;
     constructor();
@@ -5,4 +9,5 @@ export declare class EventEmitterLike extends EventTarget {
     on(type: string, listener: (...args: any[]) => void): void;
     once(type: string, listener: (...args: any[]) => void): void;
     off(type: string, listener: (...args: any[]) => void): void;
+    removeAllListeners(type?: string): void;
 }

package/dist/src/utils/EventEmitterLike.js

@@ -1,14 +1,38 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
 var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
     if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
-var _EventEmitterLike_legacy_listeners;
-import { CustomEvent } from './index.js';
+var _CustomEvent_detail, _EventEmitterLike_legacyListeners;
+// See https://github.com/nodejs/node/issues/40678#issuecomment-1126944677
+class CustomEvent extends Event {
+    constructor(type, options) {
+        super(type, options);
+        _CustomEvent_detail.set(this, void 0);
+        __classPrivateFieldSet(this, _CustomEvent_detail, options?.detail ?? null, "f");
+    }
+    get detail() {
+        return __classPrivateFieldGet(this, _CustomEvent_detail, "f");
+    }
+}
+_CustomEvent_detail = new WeakMap();
+export class SabrAdapterError extends Error {
+    constructor(message, code) {
+        super(`[SabrStreamingAdapter] ${message}`);
+        this.code = code;
+        this.name = 'SabrAdapterError';
+    }
+}
 export class EventEmitterLike extends EventTarget {
     constructor() {
         super();
-        _EventEmitterLike_legacy_listeners.set(this, new Map());
+        _EventEmitterLike_legacyListeners.set(this, new Map());
     }
     emit(type, ...args) {
         const event = new CustomEvent(type, { detail: args });
@@ -23,7 +47,7 @@ export class EventEmitterLike extends EventTarget {
                 listener(ev);
             }
         };
-        __classPrivateFieldGet(this, _EventEmitterLike_legacy_listeners, "f").set(listener, wrapper);
+        __classPrivateFieldGet(this, _EventEmitterLike_legacyListeners, "f").set(listener, { type, wrapper });
         this.addEventListener(type, wrapper);
     }
     once(type, listener) {
@@ -36,15 +60,32 @@ export class EventEmitterLike extends EventTarget {
             }
             this.off(type, listener);
         };
-        __classPrivateFieldGet(this, _EventEmitterLike_legacy_listeners, "f").set(listener, wrapper);
+        __classPrivateFieldGet(this, _EventEmitterLike_legacyListeners, "f").set(listener, { type, wrapper });
         this.addEventListener(type, wrapper);
     }
     off(type, listener) {
-        const wrapper = __classPrivateFieldGet(this, _EventEmitterLike_legacy_listeners, "f").get(listener);
-        if (wrapper) {
-            this.removeEventListener(type, wrapper);
-            __classPrivateFieldGet(this, _EventEmitterLike_legacy_listeners, "f").delete(listener);
+        const listenerData = __classPrivateFieldGet(this, _EventEmitterLike_legacyListeners, "f").get(listener);
+        if (listenerData && listenerData.type === type) {
+            this.removeEventListener(type, listenerData.wrapper);
+            __classPrivateFieldGet(this, _EventEmitterLike_legacyListeners, "f").delete(listener);
+        }
+    }
+    removeAllListeners(type) {
+        if (type) {
+            for (const [listener, listenerData] of __classPrivateFieldGet(this, _EventEmitterLike_legacyListeners, "f").entries()) {
+                if (listenerData.type === type) {
+                    this.removeEventListener(type, listenerData.wrapper);
+                    __classPrivateFieldGet(this, _EventEmitterLike_legacyListeners, "f").delete(listener);
+                }
+            }
+        }
+        else {
+            for (const [listener, listenerData] of __classPrivateFieldGet(this, _EventEmitterLike_legacyListeners, "f").entries()) {
+                this.removeEventListener(listenerData.type, listenerData.wrapper);
+                __classPrivateFieldGet(this, _EventEmitterLike_legacyListeners, "f").delete(listener);
+            }
         }
     }
 }
-_EventEmitterLike_legacy_listeners = new WeakMap();
+_EventEmitterLike_legacyListeners = new WeakMap();
+//# sourceMappingURL=EventEmitterLike.js.map

package/dist/src/utils/EventEmitterLike.js.map

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

package/dist/src/utils/Logger.d.ts

@@ -0,0 +1,43 @@
+export declare enum LogLevel {
+    NONE = 0,
+    ERROR = 1,
+    WARN = 2,
+    INFO = 3,
+    DEBUG = 4,
+    ALL = 99
+}
+/**
+ * Singleton logger utility.
+ *
+ * Allows enabling or disabling specific log levels (`ERROR`, `WARN`, `INFO`, `DEBUG`)
+ * at runtime. Supports logging with tags and message arguments.
+ *
+ * Usage:
+ * ```ts
+ * const logger = Logger.getInstance();
+ * logger.setLogLevels(LogLevel.ERROR, LogLevel.INFO);
+ * logger.error('MyTag', 'An error occurred');
+ * ```
+ */
+export declare class Logger {
+    private static instance;
+    private currentLogLevels;
+    static getInstance(): Logger;
+    /**
+     * Sets the active log levels.
+     * Call with LogLevel.NONE or no arguments to turn off all logging.
+     * Otherwise, specify one or more log levels to be active.
+     * Use LogLevel.ALL to enable all log levels.
+     */
+    setLogLevels(...levels: LogLevel[]): void;
+    /**
+     * Gets the current set of active log levels.
+     * @returns A new Set containing the active LogLevel enums.
+     */
+    getLogLevels(): Set<LogLevel>;
+    private log;
+    error(tag: string, ...messages: any[]): void;
+    warn(tag: string, ...messages: any[]): void;
+    info(tag: string, ...messages: any[]): void;
+    debug(tag: string, ...messages: any[]): void;
+}