googlevideo 1.0.0

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

@@ -0,0 +1,63 @@
+import type { FormatId } from '../../protos/generated/misc/common.js';
+export declare enum QUALITY {
+    AUTO = 0,
+    TINY = 144,
+    SMALL = 240,
+    MEDIUM = 360,
+    LIGHT = 144,
+    LARGE = 480,
+    HD720 = 720,
+    HD1080 = 1080,
+    HD1440 = 1440,
+    HD2160 = 2160,
+    HD2880 = 2880,
+    HIGHRES = 4320
+}
+export declare enum PART {
+    ONESIE_HEADER = 10,
+    ONESIE_DATA = 11,
+    MEDIA_HEADER = 20,
+    MEDIA = 21,
+    MEDIA_END = 22,
+    LIVE_METADATA = 31,
+    HOSTNAME_CHANGE_HINT = 32,
+    LIVE_METADATA_PROMISE = 33,
+    LIVE_METADATA_PROMISE_CANCELLATION = 34,
+    NEXT_REQUEST_POLICY = 35,
+    USTREAMER_VIDEO_AND_FORMAT_DATA = 36,
+    FORMAT_SELECTION_CONFIG = 37,
+    USTREAMER_SELECTED_MEDIA_STREAM = 38,
+    FORMAT_INITIALIZATION_METADATA = 42,
+    SABR_REDIRECT = 43,
+    SABR_ERROR = 44,
+    SABR_SEEK = 45,
+    RELOAD_PLAYER_RESPONSE = 46,
+    PLAYBACK_START_POLICY = 47,
+    ALLOWED_CACHED_FORMATS = 48,
+    START_BW_SAMPLING_HINT = 49,
+    PAUSE_BW_SAMPLING_HINT = 50,
+    SELECTABLE_FORMATS = 51,
+    REQUEST_IDENTIFIER = 52,
+    REQUEST_CANCELLATION_POLICY = 53,
+    ONESIE_PREFETCH_REJECTION = 54,
+    TIMELINE_CONTEXT = 55,
+    REQUEST_PIPELINING = 56,
+    SABR_CONTEXT_UPDATE = 57,
+    STREAM_PROTECTION_STATUS = 58,
+    SABR_CONTEXT_SENDING_POLICY = 59,
+    LAWNMOWER_POLICY = 60,
+    SABR_ACK = 61,
+    END_OF_TRACK = 62,
+    CACHE_LOAD_POLICY = 63,
+    LAWNMOWER_MESSAGING_POLICY = 64,
+    PREWARM_CONNECTION = 65
+}
+export declare function u8ToBase64(u8: Uint8Array): string;
+export declare function base64ToU8(base64: string): Uint8Array;
+export declare function getFormatKey(formatId: FormatId): string;
+export declare function concatenateChunks(chunks: Uint8Array[]): Uint8Array;
+export declare class CustomEvent extends Event {
+    #private;
+    constructor(type: string, options?: CustomEventInit<any[]>);
+    get detail(): any[] | null;
+}

package/dist/src/utils/helpers.js

@@ -0,0 +1,101 @@
+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 _CustomEvent_detail;
+export var QUALITY;
+(function (QUALITY) {
+    QUALITY[QUALITY["AUTO"] = 0] = "AUTO";
+    QUALITY[QUALITY["TINY"] = 144] = "TINY";
+    QUALITY[QUALITY["SMALL"] = 240] = "SMALL";
+    QUALITY[QUALITY["MEDIUM"] = 360] = "MEDIUM";
+    // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values
+    QUALITY[QUALITY["LIGHT"] = 144] = "LIGHT";
+    QUALITY[QUALITY["LARGE"] = 480] = "LARGE";
+    QUALITY[QUALITY["HD720"] = 720] = "HD720";
+    QUALITY[QUALITY["HD1080"] = 1080] = "HD1080";
+    QUALITY[QUALITY["HD1440"] = 1440] = "HD1440";
+    QUALITY[QUALITY["HD2160"] = 2160] = "HD2160";
+    QUALITY[QUALITY["HD2880"] = 2880] = "HD2880";
+    QUALITY[QUALITY["HIGHRES"] = 4320] = "HIGHRES";
+})(QUALITY || (QUALITY = {}));
+export var PART;
+(function (PART) {
+    PART[PART["ONESIE_HEADER"] = 10] = "ONESIE_HEADER";
+    PART[PART["ONESIE_DATA"] = 11] = "ONESIE_DATA";
+    PART[PART["MEDIA_HEADER"] = 20] = "MEDIA_HEADER";
+    PART[PART["MEDIA"] = 21] = "MEDIA";
+    PART[PART["MEDIA_END"] = 22] = "MEDIA_END";
+    PART[PART["LIVE_METADATA"] = 31] = "LIVE_METADATA";
+    PART[PART["HOSTNAME_CHANGE_HINT"] = 32] = "HOSTNAME_CHANGE_HINT";
+    PART[PART["LIVE_METADATA_PROMISE"] = 33] = "LIVE_METADATA_PROMISE";
+    PART[PART["LIVE_METADATA_PROMISE_CANCELLATION"] = 34] = "LIVE_METADATA_PROMISE_CANCELLATION";
+    PART[PART["NEXT_REQUEST_POLICY"] = 35] = "NEXT_REQUEST_POLICY";
+    PART[PART["USTREAMER_VIDEO_AND_FORMAT_DATA"] = 36] = "USTREAMER_VIDEO_AND_FORMAT_DATA";
+    PART[PART["FORMAT_SELECTION_CONFIG"] = 37] = "FORMAT_SELECTION_CONFIG";
+    PART[PART["USTREAMER_SELECTED_MEDIA_STREAM"] = 38] = "USTREAMER_SELECTED_MEDIA_STREAM";
+    PART[PART["FORMAT_INITIALIZATION_METADATA"] = 42] = "FORMAT_INITIALIZATION_METADATA";
+    PART[PART["SABR_REDIRECT"] = 43] = "SABR_REDIRECT";
+    PART[PART["SABR_ERROR"] = 44] = "SABR_ERROR";
+    PART[PART["SABR_SEEK"] = 45] = "SABR_SEEK";
+    PART[PART["RELOAD_PLAYER_RESPONSE"] = 46] = "RELOAD_PLAYER_RESPONSE";
+    PART[PART["PLAYBACK_START_POLICY"] = 47] = "PLAYBACK_START_POLICY";
+    PART[PART["ALLOWED_CACHED_FORMATS"] = 48] = "ALLOWED_CACHED_FORMATS";
+    PART[PART["START_BW_SAMPLING_HINT"] = 49] = "START_BW_SAMPLING_HINT";
+    PART[PART["PAUSE_BW_SAMPLING_HINT"] = 50] = "PAUSE_BW_SAMPLING_HINT";
+    PART[PART["SELECTABLE_FORMATS"] = 51] = "SELECTABLE_FORMATS";
+    PART[PART["REQUEST_IDENTIFIER"] = 52] = "REQUEST_IDENTIFIER";
+    PART[PART["REQUEST_CANCELLATION_POLICY"] = 53] = "REQUEST_CANCELLATION_POLICY";
+    PART[PART["ONESIE_PREFETCH_REJECTION"] = 54] = "ONESIE_PREFETCH_REJECTION";
+    PART[PART["TIMELINE_CONTEXT"] = 55] = "TIMELINE_CONTEXT";
+    PART[PART["REQUEST_PIPELINING"] = 56] = "REQUEST_PIPELINING";
+    PART[PART["SABR_CONTEXT_UPDATE"] = 57] = "SABR_CONTEXT_UPDATE";
+    PART[PART["STREAM_PROTECTION_STATUS"] = 58] = "STREAM_PROTECTION_STATUS";
+    PART[PART["SABR_CONTEXT_SENDING_POLICY"] = 59] = "SABR_CONTEXT_SENDING_POLICY";
+    PART[PART["LAWNMOWER_POLICY"] = 60] = "LAWNMOWER_POLICY";
+    PART[PART["SABR_ACK"] = 61] = "SABR_ACK";
+    PART[PART["END_OF_TRACK"] = 62] = "END_OF_TRACK";
+    PART[PART["CACHE_LOAD_POLICY"] = 63] = "CACHE_LOAD_POLICY";
+    PART[PART["LAWNMOWER_MESSAGING_POLICY"] = 64] = "LAWNMOWER_MESSAGING_POLICY";
+    PART[PART["PREWARM_CONNECTION"] = 65] = "PREWARM_CONNECTION";
+})(PART || (PART = {}));
+export function u8ToBase64(u8) {
+    return btoa(String.fromCharCode.apply(null, Array.from(u8)));
+}
+export function base64ToU8(base64) {
+    const standard_base64 = base64.replace(/-/g, '+').replace(/_/g, '/');
+    const padded_base64 = standard_base64.padEnd(standard_base64.length + (4 - standard_base64.length % 4) % 4, '=');
+    return new Uint8Array(atob(padded_base64).split('').map((char) => char.charCodeAt(0)));
+}
+export function getFormatKey(formatId) {
+    return `${formatId.itag};${formatId.lastModified};`;
+}
+export function concatenateChunks(chunks) {
+    const totalLength = chunks.reduce((sum, chunk) => sum + chunk.length, 0);
+    const result = new Uint8Array(totalLength);
+    let offset = 0;
+    for (const chunk of chunks) {
+        result.set(chunk, offset);
+        offset += chunk.length;
+    }
+    return result;
+}
+// See https://github.com/nodejs/node/issues/40678#issuecomment-1126944677
+export 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();

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

@@ -0,0 +1,4 @@
+export * from './helpers.js';
+export * from './EventEmitterLike.js';
+export * as Protos from './Protos.js';
+export type * from './types.js';

package/dist/src/utils/index.js

@@ -0,0 +1,3 @@
+export * from './helpers.js';
+export * from './EventEmitterLike.js';
+export * as Protos from './Protos.js';

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

@@ -0,0 +1,65 @@
+import type { FormatId } from '../../protos/generated/misc/common.js';
+import type { SabrError } from '../../protos/generated/video_streaming/sabr_error.js';
+import type { SabrRedirect } from '../../protos/generated/video_streaming/sabr_redirect.js';
+import type { StreamProtectionStatus } from '../../protos/generated/video_streaming/stream_protection_status.js';
+import type { TimeRange } from '../../protos/generated/video_streaming/time_range.js';
+import type { BufferedRange } from '../../protos/generated/video_streaming/buffered_range.js';
+import type { ClientAbrState } from '../../protos/generated/video_streaming/client_abr_state.js';
+import type { ChunkedDataBuffer } from '../core/index.js';
+export type Part = {
+    type: number;
+    size: number;
+    data: ChunkedDataBuffer;
+};
+export type ServerAbrStreamOptions = {
+    fetch: FetchFunction;
+    serverAbrStreamingUrl: string;
+    videoPlaybackUstreamerConfig: string;
+    poToken?: string;
+    durationMs: number;
+};
+export type ServerAbrResponse = {
+    initializedFormats: InitializedFormat[];
+    streamProtectionStatus?: StreamProtectionStatus;
+    sabrRedirect?: SabrRedirect;
+    sabrError?: SabrError;
+};
+export type Sequence = {
+    itag?: number;
+    formatId?: FormatId;
+    isInitSegment?: boolean;
+    durationMs?: number;
+    startMs?: number;
+    startDataRange?: number;
+    sequenceNumber?: number;
+    contentLength?: number;
+    timeRange?: TimeRange;
+};
+export type InitializedFormat = {
+    formatId: FormatId;
+    formatKey: string;
+    durationMs?: number;
+    mimeType?: string;
+    sequenceCount?: number;
+    sequenceList: Sequence[];
+    mediaChunks: Uint8Array[];
+    _state: BufferedRange;
+};
+export type InitOptions = {
+    audioFormats: Format[];
+    videoFormats: Format[];
+    clientAbrState?: ClientAbrState;
+};
+export type MediaArgs = {
+    clientAbrState: ClientAbrState;
+    audioFormatIds: FormatId[];
+    videoFormatIds: FormatId[];
+};
+export type Format = {
+    itag: number;
+    width?: number;
+    height?: number;
+    lastModified: string;
+    xtags?: string;
+};
+export type FetchFunction = typeof fetch;

package/dist/src/utils/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "googlevideo",
+  "version": "1.0.0",
+  "description": "A set of utilities for working with Google Video APIs.",
+  "main": "dist/index.js",
+  "type": "module",
+  "types": "./dist/src/index.d.ts",
+  "module": "./dist/src/index.js",
+  "scripts": {
+    "lint": "npx eslint ./src/**/*.ts",
+    "lint:fix": "npx eslint --fix ./src/**/*.ts",
+    "clean": "npx rimraf ./dist ./bundle ./protos/generated",
+    "build": "npm run clean && npm run lint && npm run build:proto && npm run build:esm && npm run bundle:node",
+    "build:esm": "npx tsc",
+    "build:proto": "node ./dev-scripts/generate-proto.mjs",
+    "bundle:node": "npx esbuild ./dist/src/index.js --bundle --outfile=./bundle/index.cjs --platform=node --target=node16 --format=cjs --sourcemap --banner:js=\"/* eslint-disable */\"",
+    "prepare": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/LuanRT/GoogleVideo.git"
+  },
+  "keywords": [
+    "UMP",
+    "Google",
+    "YouTube"
+  ],
+  "author": "LuanRT <luan.lrt4@gmail.com> (https://github.com/LuanRT)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/LuanRT/GoogleVideo/issues"
+  },
+  "homepage": "https://github.com/LuanRT/GoogleVideo#readme",
+  "funding": [
+    "https://github.com/sponsors/LuanRT"
+  ],
+  "devDependencies": {
+    "@eslint/js": "^9.9.0",
+    "@stylistic/eslint-plugin": "^2.6.4",
+    "@types/eslint__js": "^8.42.3",
+    "@types/xmldom": "^0.1.34",
+    "eslint": "^9.9.0",
+    "globals": "^15.9.0",
+    "ts-proto": "^2.2.0",
+    "typescript": "^5.5.4",
+    "typescript-eslint": "^8.2.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js",
+      "require": "./bundle/index.cjs"
+    }
+  },
+  "dependencies": {
+    "@bufbuild/protobuf": "^2.0.0",
+    "dom-parser": "^1.1.5",
+    "xmldom": "^0.6.0",
+    "youtubei.js": "^10.5.0"
+  }
+}