googlevideo 3.0.0 → 4.0.1

package/dist/src/utils/Logger.js

@@ -0,0 +1,93 @@
+export const LogLevel = {
+    NONE: 0, 0: "NONE",
+    ERROR: 1, 1: "ERROR",
+    WARN: 2, 2: "WARN",
+    INFO: 3, 3: "INFO",
+    DEBUG: 4, 4: "DEBUG",
+    ALL: 99, 99: "ALL"
+};
+/**
+ * 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 class Logger {
+    constructor() {
+        this.currentLogLevels = new Set([LogLevel.INFO, LogLevel.ERROR]);
+    }
+    static getInstance() {
+        if (!Logger.instance) {
+            Logger.instance = new Logger();
+        }
+        return Logger.instance;
+    }
+    /**
+     * 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) {
+        if (levels.length === 0 || levels.includes(LogLevel.NONE)) {
+            this.currentLogLevels = new Set(); // Turn off logging
+        }
+        else if (levels.includes(LogLevel.ALL)) {
+            this.currentLogLevels = new Set([
+                LogLevel.ERROR,
+                LogLevel.WARN,
+                LogLevel.INFO,
+                LogLevel.DEBUG
+            ]);
+        }
+        else {
+            this.currentLogLevels = new Set(levels.filter((level) => level !== LogLevel.NONE && level !== LogLevel.ALL));
+        }
+    }
+    /**
+     * Gets the current set of active log levels.
+     * @returns A new Set containing the active LogLevel enums.
+     */
+    getLogLevels() {
+        return new Set(this.currentLogLevels);
+    }
+    log(level, tag, ...messages) {
+        if (level !== LogLevel.NONE && this.currentLogLevels.has(level)) {
+            const prefix = `[${LogLevel[level]}] [${tag}]`;
+            switch (level) {
+                case LogLevel.ERROR:
+                    console.error(prefix, ...messages);
+                    break;
+                case LogLevel.WARN:
+                    console.warn(prefix, ...messages);
+                    break;
+                case LogLevel.INFO:
+                    console.info(prefix, ...messages);
+                    break;
+                case LogLevel.DEBUG:
+                    console.debug(prefix, ...messages);
+                    break;
+            }
+        }
+    }
+    error(tag, ...messages) {
+        this.log(LogLevel.ERROR, tag, ...messages);
+    }
+    warn(tag, ...messages) {
+        this.log(LogLevel.WARN, tag, ...messages);
+    }
+    info(tag, ...messages) {
+        this.log(LogLevel.INFO, tag, ...messages);
+    }
+    debug(tag, ...messages) {
+        this.log(LogLevel.DEBUG, tag, ...messages);
+    }
+}
+//# sourceMappingURL=Logger.js.map

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

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

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

@@ -1,24 +1,31 @@
 export { FormatInitializationMetadata } from '../../protos/generated/video_streaming/format_initialization_metadata.js';
-export { BufferedRange } from '../../protos/generated/video_streaming/buffered_range.js';
 export { MediaHeader } from '../../protos/generated/video_streaming/media_header.js';
-export { NextRequestPolicy } from '../../protos/generated/video_streaming/next_request_policy.js';
+export { BufferedRange } from '../../protos/generated/video_streaming/buffered_range.js';
+export { MediaCapabilities } from '../../protos/generated/video_streaming/media_capabilities.js';
+export { CryptoParams } from '../../protos/generated/video_streaming/crypto_params.js';
 export { PlaybackCookie } from '../../protos/generated/video_streaming/playback_cookie.js';
 export { PlaybackStartPolicy } from '../../protos/generated/video_streaming/playback_start_policy.js';
+export { VideoPlaybackAbrRequest } from '../../protos/generated/video_streaming/video_playback_abr_request.js';
+export { ClientAbrState } from '../../protos/generated/video_streaming/client_abr_state.js';
+export { NextRequestPolicy } from '../../protos/generated/video_streaming/next_request_policy.js';
 export { RequestCancellationPolicy } from '../../protos/generated/video_streaming/request_cancellation_policy.js';
+export { RequestIdentifier } from '../../protos/generated/video_streaming/request_identifier.js';
 export { SabrError } from '../../protos/generated/video_streaming/sabr_error.js';
 export { SabrRedirect } from '../../protos/generated/video_streaming/sabr_redirect.js';
-export { StreamProtectionStatus } from '../../protos/generated/video_streaming/stream_protection_status.js';
-export { VideoPlaybackAbrRequest } from '../../protos/generated/video_streaming/video_playback_abr_request.js';
 export { OnesieRequest } from '../../protos/generated/video_streaming/onesie_request.js';
-export { EncryptedPlayerRequest } from '../../protos/generated/video_streaming/encrypted_player_request.js';
 export { OnesieHeader } from '../../protos/generated/video_streaming/onesie_header.js';
 export { OnesieHeaderType } from '../../protos/generated/video_streaming/onesie_header_type.js';
-export { OnesiePlayerRequest } from '../../protos/generated/video_streaming/onesie_player_request.js';
-export { OnesiePlayerResponse, OnesieProxyStatus } from '../../protos/generated/video_streaming/onesie_player_response.js';
-export { ClientAbrState } from '../../protos/generated/video_streaming/client_abr_state.js';
-export { StreamerContext } from '../../protos/generated/video_streaming/streamer_context.js';
-export { ProxyStatus } from '../../protos/generated/video_streaming/proxy_status.js';
-export { MediaCapabilities } from '../../protos/generated/video_streaming/media_capabilities.js';
-export { CryptoParams } from '../../protos/generated/video_streaming/crypto_params.js';
+export { OnesieInnertubeRequest } from '../../protos/generated/video_streaming/onesie_innertube_request.js';
+export { OnesieInnertubeResponse } from '../../protos/generated/video_streaming/onesie_innertube_response.js';
+export { OnesieProxyStatus } from '../../protos/generated/video_streaming/onesie_proxy_status.js';
+export { InnertubeRequest, UstreamerFlags } from '../../protos/generated/video_streaming/innertube_request.js';
+export { StreamerContext, StreamerContext_ClientInfo as ClientInfo } from '../../protos/generated/video_streaming/streamer_context.js';
+export { SabrContextUpdate, SabrContextUpdate_SabrContextWritePolicy as SabrContextWritePolicy, SabrContextValue } from '../../protos/generated/video_streaming/sabr_context_update.js';
+export { SabrContextSendingPolicy } from '../../protos/generated/video_streaming/sabr_context_sending_policy.js';
+export { StreamProtectionStatus } from '../../protos/generated/video_streaming/stream_protection_status.js';
 export { LiveMetadata } from '../../protos/generated/video_streaming/live_metadata.js';
-export { FormatId, KeyValuePair, InitRange, IndexRange, HttpHeader } from '../../protos/generated/misc/common.js';
+export { SnackbarMessage } from '../../protos/generated/video_streaming/snackbar_message.js';
+export { UMPPartId } from '../../protos/generated/video_streaming/ump_part_id.js';
+export { ReloadPlaybackContext, ReloadPlaybackParams } from '../../protos/generated/video_streaming/reload_player_response.js';
+export { FormatSelectionConfig } from '../../protos/generated/video_streaming/format_selection_config.js';
+export { FormatId, KeyValuePair, Range, HttpHeader, IdentifierToken, CompressionType, OnesieRequestTarget, AuthorizedFormat, AudioQuality, PlaybackAuthorization, NetworkMeteredState, PlaybackAudioRouteOutputType, SeekSource, VideoQualitySetting } from '../../protos/generated/misc/common.js';

package/dist/src/utils/Protos.js

@@ -1,24 +1,32 @@
 export { FormatInitializationMetadata } from '../../protos/generated/video_streaming/format_initialization_metadata.js';
-export { BufferedRange } from '../../protos/generated/video_streaming/buffered_range.js';
 export { MediaHeader } from '../../protos/generated/video_streaming/media_header.js';
-export { NextRequestPolicy } from '../../protos/generated/video_streaming/next_request_policy.js';
+export { BufferedRange } from '../../protos/generated/video_streaming/buffered_range.js';
+export { MediaCapabilities } from '../../protos/generated/video_streaming/media_capabilities.js';
+export { CryptoParams } from '../../protos/generated/video_streaming/crypto_params.js';
 export { PlaybackCookie } from '../../protos/generated/video_streaming/playback_cookie.js';
 export { PlaybackStartPolicy } from '../../protos/generated/video_streaming/playback_start_policy.js';
+export { VideoPlaybackAbrRequest } from '../../protos/generated/video_streaming/video_playback_abr_request.js';
+export { ClientAbrState } from '../../protos/generated/video_streaming/client_abr_state.js';
+export { NextRequestPolicy } from '../../protos/generated/video_streaming/next_request_policy.js';
 export { RequestCancellationPolicy } from '../../protos/generated/video_streaming/request_cancellation_policy.js';
+export { RequestIdentifier } from '../../protos/generated/video_streaming/request_identifier.js';
 export { SabrError } from '../../protos/generated/video_streaming/sabr_error.js';
 export { SabrRedirect } from '../../protos/generated/video_streaming/sabr_redirect.js';
-export { StreamProtectionStatus } from '../../protos/generated/video_streaming/stream_protection_status.js';
-export { VideoPlaybackAbrRequest } from '../../protos/generated/video_streaming/video_playback_abr_request.js';
 export { OnesieRequest } from '../../protos/generated/video_streaming/onesie_request.js';
-export { EncryptedPlayerRequest } from '../../protos/generated/video_streaming/encrypted_player_request.js';
 export { OnesieHeader } from '../../protos/generated/video_streaming/onesie_header.js';
 export { OnesieHeaderType } from '../../protos/generated/video_streaming/onesie_header_type.js';
-export { OnesiePlayerRequest } from '../../protos/generated/video_streaming/onesie_player_request.js';
-export { OnesiePlayerResponse, OnesieProxyStatus } from '../../protos/generated/video_streaming/onesie_player_response.js';
-export { ClientAbrState } from '../../protos/generated/video_streaming/client_abr_state.js';
-export { StreamerContext } from '../../protos/generated/video_streaming/streamer_context.js';
-export { ProxyStatus } from '../../protos/generated/video_streaming/proxy_status.js';
-export { MediaCapabilities } from '../../protos/generated/video_streaming/media_capabilities.js';
-export { CryptoParams } from '../../protos/generated/video_streaming/crypto_params.js';
+export { OnesieInnertubeRequest } from '../../protos/generated/video_streaming/onesie_innertube_request.js';
+export { OnesieInnertubeResponse } from '../../protos/generated/video_streaming/onesie_innertube_response.js';
+export { OnesieProxyStatus } from '../../protos/generated/video_streaming/onesie_proxy_status.js';
+export { InnertubeRequest, UstreamerFlags } from '../../protos/generated/video_streaming/innertube_request.js';
+export { StreamerContext, StreamerContext_ClientInfo as ClientInfo } from '../../protos/generated/video_streaming/streamer_context.js';
+export { SabrContextUpdate, SabrContextUpdate_SabrContextWritePolicy as SabrContextWritePolicy, SabrContextValue } from '../../protos/generated/video_streaming/sabr_context_update.js';
+export { SabrContextSendingPolicy } from '../../protos/generated/video_streaming/sabr_context_sending_policy.js';
+export { StreamProtectionStatus } from '../../protos/generated/video_streaming/stream_protection_status.js';
 export { LiveMetadata } from '../../protos/generated/video_streaming/live_metadata.js';
-export { FormatId, KeyValuePair, InitRange, IndexRange, HttpHeader } from '../../protos/generated/misc/common.js';
+export { SnackbarMessage } from '../../protos/generated/video_streaming/snackbar_message.js';
+export { UMPPartId } from '../../protos/generated/video_streaming/ump_part_id.js';
+export { ReloadPlaybackContext, ReloadPlaybackParams } from '../../protos/generated/video_streaming/reload_player_response.js';
+export { FormatSelectionConfig } from '../../protos/generated/video_streaming/format_selection_config.js';
+export { FormatId, KeyValuePair, Range, HttpHeader, IdentifierToken, CompressionType, OnesieRequestTarget, AuthorizedFormat, AudioQuality, PlaybackAuthorization, NetworkMeteredState, PlaybackAudioRouteOutputType, SeekSource, VideoQualitySetting } from '../../protos/generated/misc/common.js';
+//# sourceMappingURL=Protos.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Protos.js","sourceRoot":"","sources":["../../../src/utils/Protos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,0EAA0E,CAAC;AACxH,OAAO,EAAE,WAAW,EAAE,MAAM,wDAAwD,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,MAAM,0DAA0D,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,8DAA8D,CAAC;AACjG,OAAO,EAAE,YAAY,EAAE,MAAM,yDAAyD,CAAC;AAEvF,OAAO,EAAE,cAAc,EAAE,MAAM,2DAA2D,CAAC;AAC3F,OAAO,EAAE,mBAAmB,EAAE,MAAM,iEAAiE,CAAC;AACtG,OAAO,EAAE,uBAAuB,EAAE,MAAM,sEAAsE,CAAC;AAC/G,OAAO,EAAE,cAAc,EAAE,MAAM,4DAA4D,CAAC;AAE5F,OAAO,EAAE,iBAAiB,EAAE,MAAM,+DAA+D,CAAC;AAClG,OAAO,EAAE,yBAAyB,EAAE,MAAM,uEAAuE,CAAC;AAClH,OAAO,EAAE,iBAAiB,EAAE,MAAM,8DAA8D,CAAC;AACjG,OAAO,EAAE,SAAS,EAAE,MAAM,sDAAsD,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,yDAAyD,CAAC;AAEvF,OAAO,EAAE,aAAa,EAAE,MAAM,0DAA0D,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,MAAM,yDAAyD,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,8DAA8D,CAAC;AAChG,OAAO,EAAE,sBAAsB,EAAE,MAAM,oEAAoE,CAAC;AAC5G,OAAO,EAAE,uBAAuB,EAAE,MAAM,qEAAqE,CAAC;AAC9G,OAAO,EAAE,iBAAiB,EAAE,MAAM,+DAA+D,CAAC;AAClG,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,6DAA6D,CAAC;AAC/G,OAAO,EAAE,eAAe,EAAE,0BAA0B,IAAI,UAAU,EAAE,MAAM,4DAA4D,CAAC;AACvI,OAAO,EAAE,iBAAiB,EAAE,wCAAwC,IAAI,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,+DAA+D,CAAC;AACxL,OAAO,EAAE,wBAAwB,EAAE,MAAM,uEAAuE,CAAC;AAEjH,OAAO,EAAE,sBAAsB,EAAE,MAAM,oEAAoE,CAAC;AAC5G,OAAO,EAAE,YAAY,EAAE,MAAM,yDAAyD,CAAC;AACvF,OAAO,EAAE,eAAe,EAAE,MAAM,4DAA4D,CAAC;AAC7F,OAAO,EAAE,SAAS,EAAE,MAAM,uDAAuD,CAAC;AAClF,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,kEAAkE,CAAC;AAC/H,OAAO,EAAE,qBAAqB,EAAE,MAAM,mEAAmE,CAAC;AAE1G,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,KAAK,EACL,UAAU,EACV,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,YAAY,EACZ,qBAAqB,EACrB,mBAAmB,EACnB,4BAA4B,EAC5B,UAAU,EACV,mBAAmB,EACpB,MAAM,uCAAuC,CAAC"}

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

@@ -0,0 +1,15 @@
+import type { SabrRequestMetadata } from '../types/sabrStreamingAdapterTypes.js';
+/**
+ * Manages request metadata objects.
+ */
+export declare class RequestMetadataManager {
+    metadataMap: Map<string, SabrRequestMetadata>;
+    private lastCleanup;
+    private readonly CLEANUP_INTERVAL;
+    private readonly ENTRY_EXPIRATION_TIME;
+    constructor();
+    getRequestMetadata(url: string, del?: boolean): SabrRequestMetadata | undefined;
+    setRequestMetadata(url: string, context: SabrRequestMetadata): void;
+    private conditionalCleanUp;
+    private cleanUp;
+}

package/dist/src/utils/RequestMetadataManager.js

@@ -0,0 +1,48 @@
+/**
+ * Manages request metadata objects.
+ */
+export class RequestMetadataManager {
+    constructor() {
+        this.CLEANUP_INTERVAL = 30000;
+        this.ENTRY_EXPIRATION_TIME = 1000 * 60 * 3;
+        this.metadataMap = new Map();
+        this.lastCleanup = Date.now();
+    }
+    getRequestMetadata(url, del = false) {
+        const requestNumber = new URL(url).searchParams.get('rn') || '';
+        const streamingContext = this.metadataMap.get(requestNumber);
+        // Check if this specific entry is expired.
+        if (streamingContext && Date.now() - streamingContext.timestamp > this.ENTRY_EXPIRATION_TIME) {
+            this.metadataMap.delete(requestNumber);
+            return undefined;
+        }
+        if (del) {
+            this.metadataMap.delete(requestNumber);
+        }
+        this.conditionalCleanUp();
+        return streamingContext;
+    }
+    setRequestMetadata(url, context) {
+        const requestNumber = new URL(url).searchParams.get('rn');
+        if (requestNumber) {
+            this.metadataMap.set(requestNumber, context);
+            this.conditionalCleanUp();
+        }
+    }
+    conditionalCleanUp() {
+        const now = Date.now();
+        if (now - this.lastCleanup > this.CLEANUP_INTERVAL) {
+            this.cleanUp();
+            this.lastCleanup = now;
+        }
+    }
+    cleanUp() {
+        // Should rarely run. This is only for requests that fail and never get handled (e.g., network errors).
+        for (const [key, context] of this.metadataMap.entries()) {
+            if (Date.now() - context.timestamp > this.ENTRY_EXPIRATION_TIME) {
+                this.metadataMap.delete(key);
+            }
+        }
+    }
+}
+//# sourceMappingURL=RequestMetadataManager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RequestMetadataManager.js","sourceRoot":"","sources":["../../../src/utils/RequestMetadataManager.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,sBAAsB;IAMjC;QAHiB,qBAAgB,GAAG,KAAK,CAAC;QACzB,0BAAqB,GAAG,IAAI,GAAG,EAAE,GAAG,CAAC,CAAC;QAGrD,IAAI,CAAC,WAAW,GAAG,IAAI,GAAG,EAA+B,CAAC;QAC1D,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAChC,CAAC;IAEM,kBAAkB,CAAC,GAAW,EAAE,GAAG,GAAG,KAAK;QAChD,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAEhE,MAAM,gBAAgB,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAE7D,2CAA2C;QAC3C,IAAI,gBAAgB,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,gBAAgB,CAAC,SAAS,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAC7F,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;YACvC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,GAAG,EAAE,CAAC;YACR,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAE1B,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAEM,kBAAkB,CAAC,GAAW,EAAE,OAA4B;QACjE,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1D,IAAI,aAAa,EAAE,CAAC;YAClB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;YAC7C,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC5B,CAAC;IACH,CAAC;IAEO,kBAAkB;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,GAAG,GAAG,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACnD,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC;QACzB,CAAC;IACH,CAAC;IAEO,OAAO;QACb,uGAAuG;QACvG,KAAK,MAAM,CAAE,GAAG,EAAE,OAAO,CAAE,IAAI,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,CAAC;YAC1D,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;gBAChE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,45 @@
+import type { MediaHeader } from './Protos.js';
+import type { FormatInitializationMetadata } from './Protos.js';
+import type { SabrFormat } from '../types/shared.js';
+import type { SabrRequestMetadata } from '../types/sabrStreamingAdapterTypes.js';
+/**
+ * Creates a format key based on itag and xtags.
+ * @returns A string format key.
+ */
+export declare function createKey(itag: number | undefined, xtags: string | undefined): string;
+/**
+ * Creates a format key from a SabrFormat object.
+ * @returns A string format key or undefined if format is undefined.
+ */
+export declare function fromFormat(format?: {
+    itag?: number;
+    xtags?: string;
+}): string | undefined;
+/**
+ * Creates a format key from a MediaHeader object.
+ * @returns A string format key.
+ */
+export declare function fromMediaHeader(mediaHeader: MediaHeader): string;
+/**
+ * Creates a format key from FormatInitializationMetadata.
+ * @returns A string format key or undefined if formatId is undefined.
+ */
+export declare function fromFormatInitializationMetadata(formatInitMetadata: FormatInitializationMetadata): string;
+/**
+ * Creates a segment cache key.
+ * @param mediaHeader - The MediaHeader object.
+ * @param format - Format object (needed for init segments.)
+ * @returns A string key for caching segments.
+ */
+export declare function createSegmentCacheKey(mediaHeader: MediaHeader, format?: SabrFormat): string;
+/**
+ * Creates a cache key from request metadata.
+ * @returns A string key for caching segments.
+ */
+export declare function createSegmentCacheKeyFromMetadata(requestMetadata: SabrRequestMetadata): string;
+/**
+ * Generates a unique format ID based on the SabrFormat properties.
+ * @param format - The SabrFormat object.
+ * @returns A unique string identifier for the format.
+ */
+export declare function getUniqueFormatId(format: SabrFormat): string;

package/dist/src/utils/formatKeyUtils.js

@@ -0,0 +1,77 @@
+/**
+ * Creates a format key based on itag and xtags.
+ * @returns A string format key.
+ */
+export function createKey(itag, xtags) {
+    return `${itag || ''}:${xtags || ''}`;
+}
+/**
+ * Creates a format key from a SabrFormat object.
+ * @returns A string format key or undefined if format is undefined.
+ */
+export function fromFormat(format) {
+    if (!format)
+        return undefined;
+    return createKey(format.itag, format.xtags);
+}
+/**
+ * Creates a format key from a MediaHeader object.
+ * @returns A string format key.
+ */
+export function fromMediaHeader(mediaHeader) {
+    return createKey(mediaHeader.itag, mediaHeader.xtags);
+}
+/**
+ * Creates a format key from FormatInitializationMetadata.
+ * @returns A string format key or undefined if formatId is undefined.
+ */
+export function fromFormatInitializationMetadata(formatInitMetadata) {
+    if (!formatInitMetadata.formatId)
+        return '';
+    return createKey(formatInitMetadata.formatId.itag, formatInitMetadata.formatId.xtags);
+}
+/**
+ * Creates a segment cache key.
+ * @param mediaHeader - The MediaHeader object.
+ * @param format - Format object (needed for init segments.)
+ * @returns A string key for caching segments.
+ */
+export function createSegmentCacheKey(mediaHeader, format) {
+    if (mediaHeader.isInitSeg && format) {
+        return `${mediaHeader.itag}:${mediaHeader.xtags || ''}:${format.contentLength || ''}:${format.mimeType || ''}`;
+    }
+    return `${mediaHeader.startRange || '0'}-${mediaHeader.itag}-${mediaHeader.xtags || ''}`;
+}
+/**
+ * Creates a cache key from request metadata.
+ * @returns A string key for caching segments.
+ */
+export function createSegmentCacheKeyFromMetadata(requestMetadata) {
+    if (!requestMetadata.byteRange || !requestMetadata.format)
+        throw new Error('Invalid metadata: byteRange or format is missing');
+    const pseudoMediaHeader = {
+        itag: requestMetadata.format.itag,
+        xtags: requestMetadata.format.xtags || '',
+        startRange: requestMetadata.byteRange.start,
+        isInitSeg: requestMetadata.isInit
+    };
+    return createSegmentCacheKey(pseudoMediaHeader, requestMetadata.isInit ? requestMetadata.format : undefined);
+}
+/**
+ * Generates a unique format ID based on the SabrFormat properties.
+ * @param format - The SabrFormat object.
+ * @returns A unique string identifier for the format.
+ */
+export function getUniqueFormatId(format) {
+    if (format.width)
+        return format.itag.toString();
+    const uidParts = [format.itag.toString()];
+    if (format.audioTrackId) {
+        uidParts.push(format.audioTrackId);
+    }
+    if (format.isDrc) {
+        uidParts.push('drc');
+    }
+    return uidParts.join('-');
+}
+//# sourceMappingURL=formatKeyUtils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formatKeyUtils.js","sourceRoot":"","sources":["../../../src/utils/formatKeyUtils.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,IAAwB,EAAE,KAAyB;IAC3E,OAAO,GAAG,IAAI,IAAI,EAAE,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,MAA0C;IACnE,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,OAAO,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,WAAwB;IACtD,OAAO,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gCAAgC,CAC9C,kBAAgD;IAChD,IAAI,CAAC,kBAAkB,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC;IAC5C,OAAO,SAAS,CAAC,kBAAkB,CAAC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACxF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,WAAwB,EACxB,MAAmB;IAEnB,IAAI,WAAW,CAAC,SAAS,IAAI,MAAM,EAAE,CAAC;QACpC,OAAO,GAAG,WAAW,CAAC,IAAI,IAAI,WAAW,CAAC,KAAK,IAAI,EAAE,IAAI,MAAM,CAAC,aAAa,IAAI,EAAE,IAAI,MAAM,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;IACjH,CAAC;IACD,OAAO,GAAG,WAAW,CAAC,UAAU,IAAI,GAAG,IAAI,WAAW,CAAC,IAAI,IAAI,WAAW,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;AAC3F,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iCAAiC,CAC/C,eAAoC;IAEpC,IAAI,CAAC,eAAe,CAAC,SAAS,IAAI,CAAC,eAAe,CAAC,MAAM;QACvD,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IAEtE,MAAM,iBAAiB,GAAG;QACxB,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,IAAI;QACjC,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE;QACzC,UAAU,EAAE,eAAe,CAAC,SAAS,CAAC,KAAK;QAC3C,SAAS,EAAE,eAAe,CAAC,MAAM;KAClC,CAAC;IAEF,OAAO,qBAAqB,CAC1B,iBAAiB,EACjB,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAC5D,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAkB;IAClD,IAAI,MAAM,CAAC,KAAK;QACd,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;IAEhC,MAAM,QAAQ,GAAG,CAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAE,CAAC;IAE5C,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QACxB,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC"}

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

@@ -1,4 +1,6 @@
-export * from './helpers.js';
+export * from './Logger.js';
+export * from './shared.js';
+export * from './CacheManager.js';
 export * from './EventEmitterLike.js';
-export * as Protos from './Protos.js';
-export type * from './types.js';
+export * from './RequestMetadataManager.js';
+export * as FormatKeyUtils from './formatKeyUtils.js';

package/dist/src/utils/index.js

@@ -1,3 +1,7 @@
-export * from './helpers.js';
+export * from './Logger.js';
+export * from './shared.js';
+export * from './CacheManager.js';
 export * from './EventEmitterLike.js';
-export * as Protos from './Protos.js';
+export * from './RequestMetadataManager.js';
+export * as FormatKeyUtils from './formatKeyUtils.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAC"}

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

@@ -0,0 +1,28 @@
+import type { InitializedFormat } from '../core/SabrStream.js';
+import type { SabrFormat } from '../types/shared.js';
+/**
+ * Determines the media type (video or audio) based on the format initialization metadata.
+ * @param initializedFormat
+ */
+export declare function getMediaType(initializedFormat: InitializedFormat): 'video' | 'audio';
+/**
+ * Calculates the total duration of downloaded segments in milliseconds.
+ * @param initializedFormat
+ */
+export declare function getTotalDownloadedDuration(initializedFormat: InitializedFormat): number;
+/**
+ * Filters formats by media type (audio or video)
+ */
+export declare function filterFormatsByType(formats: SabrFormat[], isAudio: boolean): SabrFormat[];
+/**
+ * Choose the best format based on options
+ */
+export declare function chooseFormat(formats: SabrFormat[], formatOption: number | SabrFormat | ((formats: SabrFormat[]) => SabrFormat | undefined) | undefined, preferences: {
+    quality?: string;
+    language?: string;
+    preferWebM?: boolean;
+    preferMP4?: boolean;
+    preferH264?: boolean;
+    preferOpus?: boolean;
+    isAudio: boolean;
+}): SabrFormat | undefined;

package/dist/src/utils/sabrStreamUtils.js

@@ -0,0 +1,76 @@
+/**
+ * Determines the media type (video or audio) based on the format initialization metadata.
+ * @param initializedFormat
+ */
+export function getMediaType(initializedFormat) {
+    return initializedFormat.formatInitializationMetadata?.mimeType?.includes('video') ? 'video' : 'audio';
+}
+/**
+ * Calculates the total duration of downloaded segments in milliseconds.
+ * @param initializedFormat
+ */
+export function getTotalDownloadedDuration(initializedFormat) {
+    return Array.from(initializedFormat.downloadedSegments.values())
+        .reduce((sum, segment) => sum + (segment.durationMs || 0), 0);
+}
+/**
+ * Filters formats by media type (audio or video)
+ */
+export function filterFormatsByType(formats, isAudio) {
+    return formats.filter((format) => {
+        if (!format.mimeType)
+            return false;
+        return isAudio
+            ? format.mimeType.includes('audio')
+            : format.mimeType.includes('video');
+    });
+}
+/**
+ * Choose the best format based on options
+ */
+export function chooseFormat(formats, formatOption, preferences) {
+    if (!formats.length)
+        return undefined;
+    const typeFormats = filterFormatsByType(formats, preferences.isAudio);
+    if (!typeFormats.length)
+        return undefined;
+    if (typeof formatOption === 'number') {
+        return typeFormats.find((format) => format.itag === formatOption);
+    }
+    if (formatOption && typeof formatOption !== 'function') {
+        return formatOption;
+    }
+    if (typeof formatOption === 'function') {
+        return formatOption(typeFormats);
+    }
+    let filteredFormats = typeFormats;
+    if (preferences.language) {
+        filteredFormats = filteredFormats.filter((format) => format.language === preferences.language);
+    }
+    if (preferences.quality) {
+        filteredFormats = filteredFormats.filter((format) => preferences.isAudio
+            ? !!format.audioQuality?.toLowerCase().includes(preferences.quality?.toLowerCase() || '')
+            : !!format.qualityLabel?.toLowerCase().includes(preferences.quality?.toLowerCase() || ''));
+    }
+    if (preferences.isAudio) {
+        if (preferences.preferOpus) {
+            filteredFormats = applyMimeTypeFilter(filteredFormats, 'opus');
+        }
+    }
+    else if (preferences.preferH264) {
+        filteredFormats = filteredFormats.filter((format) => !!format.mimeType && format.mimeType.includes('mp4') && format.mimeType.includes('avc'));
+    }
+    if (preferences.preferWebM) {
+        filteredFormats = applyMimeTypeFilter(filteredFormats, 'webm');
+    }
+    else if (preferences.preferMP4) {
+        filteredFormats = applyMimeTypeFilter(filteredFormats, 'mp4');
+    }
+    return preferences.isAudio
+        ? filteredFormats.sort((a, b) => (b.bitrate || 0) - (a.bitrate || 0))[0]
+        : filteredFormats.sort((a, b) => (b.height || 0) - (a.height || 0))[0];
+}
+function applyMimeTypeFilter(formats, mimeTypePart) {
+    return formats.filter((format) => format.mimeType?.includes(mimeTypePart));
+}
+//# sourceMappingURL=sabrStreamUtils.js.map

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

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

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

@@ -0,0 +1,55 @@
+import type { FormatStream, SabrFormat } from '../types/shared.js';
+export declare const MAX_INT32_VALUE = 2147483647;
+export declare enum EnabledTrackTypes {
+    VIDEO_AND_AUDIO = 0,
+    AUDIO_ONLY = 1,
+    VIDEO_ONLY = 2
+}
+/**
+ * Determines if a given URL is a Google video URL, specifically for YouTube or SABR-related content.
+ *
+ * @param url - The URL to check.
+ *
+ * The function checks the following conditions:
+ * 1. If the URL starts with the `sabr://` protocol, it is considered a Google video URL.
+ * 2. If the URL ends with `/videoplayback`, it parses the query parameters to check for specific keys
+ *    (`source=youtube`, `sabr`, `lsig`, or `expire`) that indicate a Google video URL.
+ * 3. If the URL contains `/videoplayback/` (e.g., for live or post-live content), it checks the path
+ *    segments for specific keywords (`videoplayback`, `sabr`, `lsig`, or `expire`).
+ */
+export declare function isGoogleVideoURL(url: string): boolean;
+interface Range {
+    start: number;
+    end: number;
+}
+/**
+ * Parses the Range header value to extract the start and end byte positions.
+ * @param rangeHeaderValue
+ */
+export declare function parseRangeHeader(rangeHeaderValue: string | undefined): Range | undefined;
+/**
+ * Converts a Uint8Array to a Base64 string.
+ * @param u8
+ */
+export declare function u8ToBase64(u8: Uint8Array): string;
+/**
+ * Converts a Base64 string to a Uint8Array.
+ * @param base64
+ */
+export declare function base64ToU8(base64: string): Uint8Array;
+/**
+ * Concatenates multiple Uint8Array chunks into a single Uint8Array.
+ * @param chunks
+ */
+export declare function concatenateChunks(chunks: Uint8Array[]): Uint8Array;
+/**
+ * Converts a FormatStream object to a SabrFormat object.
+ * @param formatStream
+ */
+export declare function buildSabrFormat(formatStream: FormatStream): SabrFormat;
+/**
+ * Returns a promise that resolves after a specified number of milliseconds.
+ * @param ms - The number of milliseconds to wait.
+ */
+export declare function wait(ms: number): Promise<void>;
+export {};