azot 0.8.0 → 0.9.0-alpha.1

package/README.md

@@ -1,66 +1,11 @@
-# azot
+# Azot API
 
-[![npm version](https://img.shields.io/npm/v/azot?style=flat&color=black)](https://www.npmjs.com/package/azot)
-![GitHub Downloads (all assets, latest release)](https://img.shields.io/github/downloads/vitalygashkov/azot/latest/total?style=flat&color=black)
-[![npm downloads](https://img.shields.io/npm/dt/azot?style=flat&color=black)](https://www.npmjs.com/package/azot)
+Type definitions for the latesst [Azot](https://azot.so) API.
 
-Azot (Russian word for "nitrogen", pronounced `/azо́t/`) is a set of tools (JavaScript library, command-line utility and browser extension) for diagnosing, researching, and pentesting [Google's](https://about.google/) [Widevine](https://www.widevine.com/about) [DRM](https://www.urbandictionary.com/define.php?term=DRM).
+## Getting Started
 
-> Azot is still in the early stages of development, so until version 1.0 is released, performance may be unstable and major changes may be made
+Check [TypeScript interfaces](https://github.com/azot-labs/azot/tree/main/packages/api/types) to get started with our API. If you want to discover and install extensions, check out [Extension List](https://github.com/azot-labs/azot/tree/main/extensions/).
 
-## Features
+## Community
 
-- **Minimal** dependencies
-- **Runtime agnostic** core: works in Node.js, Bun, Deno, browsers and more
-- **Logging** details from EME events in Developer Tools console of current page
-- **Encrypted Media Extensions API** compatibility via `requestMediaKeySystemAccess()` method
-- **Converting clients** between formats via CLI
-- **Manifest V3** compliant browser extension
-- **Custom client support**: WVD v2, device_client_id_blob + device_private_key, client_id.bin + private_key.pem
-- **Network-independent interception**, so it doesn't matter if the request has one-time tokens or a custom request/response body format.
-
-## Installation
-
-> JavaScript library and command-line tool installation requires pre-installed JavaScript runtime (e.g. Node.js).
-
-### JavaScript library
-
-```bash
-npm install azot
-```
-
-### Command-line tool
-
-```bash
-npm install -g azot
-```
-
-### Chrome extension
-
-**Developer Mode** needs to be enabled in `chrome://extensions/` page
-
-1. Download archive from [latest release](https://github.com/vitalygashkov/azot/releases/latest)
-2. Go to `chrome://extensions/` page
-3. Ensure Developer Mode enabled and then drag and drop downloaded zip file to this page
-
-[Read Google's guide](https://developer.chrome.com/docs/extensions/get-started/tutorial/hello-world#load-unpacked)
-
-### Firefox extension
-
-1. Download archive from [latest release](https://github.com/vitalygashkov/azot/releases/latest)
-2. Go to `about:debugging#/runtime/this-firefox` page
-3. Click `Load Temporary Add-on` button and choose downloaded zip file
-
-> Temporary add-on is not persistent and will be removed after browser restart
-
-[Read Mozilla's guide](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Your_first_WebExtension#installing)
-
-## Usage
-
-### Library
-
-See [examples](https://github.com/vitalygashkov/azot/blob/main/examples).
-
-### Command-line tool
-
-See help: `azot --help`
+Join our [Discord community](https://discord.gg/fHMgAgc7gU) to share your extension, debug nasty bugs or simply get to know like-minded folks.

package/bin/cli.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+"use strict";var e=(e,t)=>()=>(t||e((t={exports:{}}).exports,t),t.exports),t=e((exports,t)=>{let{readFileSync:n,writeFileSync:r}=require(`node:fs`),{join:i}=require(`node:path`),a=(e,t)=>{let a=n(e,`utf8`),o=t||i(process.cwd(),`package.json`),s=require(o),c=/module\.exports\s*=\s*(\w+)/g,l,u;for(;(l=c.exec(a))!==null;)u=l;if(!u)throw Error(`No module.exports found in source file`);let d=u[1],f=a.replace(/(module\.exports\s*=\s*(\w+))(?![^]*module\.exports\s*=\s*\w+)/,`${d}.package=${JSON.stringify(s)};module.exports = $2`);return r(e,f,`utf8`),{code:f,packageJson:s}};t.exports={injectPackageJson:a}}),n=e((exports,t)=>{let{createCipheriv:n,createDecipheriv:r,publicEncrypt:i,privateDecrypt:a,randomBytes:o}=require(`node:crypto`),{readFileSync:s,writeFileSync:c}=require(`node:fs`),l=Buffer.from(`STX`,`utf8`),u=(e,t,r)=>{let a=o(32),u=o(16),d=s(t),f=n(`aes-256-cbc`,a,u),p=Buffer.concat([f.update(d),f.final()]),m=i(e,a),h=Buffer.concat([l,u,m,p]);return r&&c(r,h),{aesIv:u,encryptedAesKey:m,encryptedCode:p}},d=(e,t,n)=>{let i=s(t),o=l.byteLength,u=i.subarray(0,o);if(!u.equals(l))throw Error(`Incorrect file format`);let d=o,f=d+16,p=f+512,m=i.subarray(d,f),h=i.subarray(f,p),g=i.subarray(p),_=a(e,h),v=r(`aes-256-cbc`,_,m),y=Buffer.concat([v.update(g),v.final()]),b=y.toString(`utf8`);return n&&c(n,b),b};t.exports={encrypt:u,decrypt:d}}),r=e((exports,t)=>{let{readFileSync:n,writeFileSync:r}=require(`node:fs`),i=require(`javascript-obfuscator`),a=(e,t)=>{let a=n(e,`utf8`);console.log(`Obfuscating...`),console.time(`Obfuscation complete in`);let o=i.obfuscate(a,{target:`node`,compact:!0,controlFlowFlattening:!0,controlFlowFlatteningThreshold:1,deadCodeInjection:!0,debugProtection:!0,identifierNamesGenerator:`hexadecimal`,numbersToExpressions:!0,selfDefending:!0,simplify:!0,splitStrings:!0,splitStringsChunkLength:5,stringArray:!0,stringArrayCallsTransform:!0,stringArrayCallsTransformThreshold:1,stringArrayEncoding:[`base64`],stringArrayIndexShift:!0,stringArrayRotate:!0,stringArrayShuffle:!0,stringArrayWrappersCount:2,stringArrayWrappersChainedCalls:!0,stringArrayWrappersType:`function`,stringArrayThreshold:1,transformObjectKeys:!0,unicodeEscapeSequence:!1});console.timeEnd(`Obfuscation complete in`);let s=o.getObfuscatedCode();return r(t||e,s),s};t.exports={obfuscate:a}});const{parseArgs:i}=require(`node:util`),{rmSync:a,readdirSync:o,readFileSync:s}=require(`node:fs`),c=require(`node:path`),{build:l}=require(`tsdown`),{injectPackageJson:u}=t(),{encrypt:d,decrypt:f}=n(),{obfuscate:p}=r(),m=i({allowPositionals:!0,allowNegative:!0,options:{input:{type:`string`,short:`i`,description:`Path to the input file`},key:{type:`string`,short:`k`,description:`Path to the key file (public for encrypt, private for decrypt)`},output:{type:`string`,short:`o`,description:`Path to the output file`},watch:{type:`boolean`,description:`Watch file changes`},minify:{type:`boolean`,description:`Minify output`},obfuscate:{type:`boolean`,description:`Obfuscate output`},encrypt:{type:`boolean`,description:`Encrypt extension source code (.js will be packed inside .stx)`},decrypt:{type:`boolean`,description:`Decrypt encrypted extension`}}}),h=()=>{let e=[process.cwd(),c.join(process.cwd(),`src`),c.join(process.cwd(),`lib`)];for(let t of e){let e=o(t),n=e.filter(e=>!e.endsWith(`.d.ts`)).find(e=>new Set([`.ts`,`.js`]).has(c.extname(e)));if(n)return c.join(t,n)}};(async()=>{let[e,...t]=m.positionals,n=m.values.input||t[0]||h();if(e===`build`||e===`pack`){let t=typeof m.values.minify==`boolean`?m.values.minify:!0;await l({entry:n,format:`cjs`,platform:`node`,target:`node22`,watch:m.values.watch,minify:t}),m.values.input=c.join(process.cwd(),`dist`,c.basename(n).replace(/\.ts$/,`.js`));let{packageJson:r}=u(m.values.input),i=typeof m.values.obfuscate==`boolean`,o=i?m.values.obfuscate:r.private;o&&p(m.values.input,m.values.input);let f=m.values.encrypt||e===`pack`;if(f){let e=s(m.values.key||c.join(__dirname,`../public.pem`)),t=m.values.output||m.values.input.replace(/\.js$/,`-${r.version}.stx`);d(e,m.values.input,t),a(m.values.input)}}else if(e===`decrypt`){let e=s(m.values.key||c.join(__dirname,`../private.pem`)),t=m.values.output||n.replace(/\.stx$/,`.js`);f(e,n,t),a(m.values.input)}else if(e===`dev`||e===`develop`||!e){let e=typeof m.values.minify==`boolean`?m.values.minify:!1;await l({entry:n,format:`cjs`,platform:`node`,target:`node20`,watch:!0,minify:e})}})();

package/dist/index.js

@@ -0,0 +1 @@
+const e=e=>e,t=`Streamyx`in globalThis?globalThis.Streamyx:{},n=`Azot`in globalThis?globalThis.Azot:{};!globalThis.Azot&&globalThis.Streamyx&&(globalThis.Azot=globalThis.Streamyx),module.exports={defineExtension:e,...t,...n};

package/index.d.ts

@@ -0,0 +1,10 @@
+import './types/globals';
+import { Extension } from './types/extension';
+
+export function defineExtension(extension: Extension): Extension;
+
+export const version: AzotModule['version'];
+export const utils: AzotModule['utils'];
+export const prompt: AzotModule['prompt'];
+
+export * from './types/extension';

package/package.json

@@ -1,52 +1,45 @@
 {
   "name": "azot",
-  "version": "0.8.0",
-  "description": "Swiss Army knife for pentesting DRM systems",
-  "type": "module",
+  "version": "0.9.0-alpha.1",
+  "description": "Build extensions for Azot with Node.js",
+  "homepage": "https://developers.azot.so",
+  "main": "./dist/index.js",
+  "bin": {
+    "azt": "./bin/cli.js"
+  },
+  "types": "index.d.ts",
   "files": [
+    "index.d.ts",
+    "bin",
     "dist",
-    "scripts"
+    "types",
+    "public.pem"
   ],
-  "main": "dist/lib/main.cjs",
-  "module": "dist/lib/main.js",
-  "bin": {
-    "azot": "dist/cli/main.cjs"
-  },
   "scripts": {
-    "prepublishOnly": "npm run build:lib && npm run build:cli",
-    "dev": "wxt",
-    "dev:firefox": "wxt -b firefox",
-    "build": "npm run build:lib && npm run build:cli && npm run build:chrome",
-    "build:lib": "tsup --config tsup.lib.config.ts",
-    "build:cli": "tsup --config tsup.cli.config.ts",
-    "build:chrome": "wxt build",
-    "build:firefox": "wxt build -b firefox",
-    "zip": "wxt zip",
-    "zip:firefox": "wxt zip -b firefox",
-    "compile": "tsc --noEmit",
-    "postinstall": "node scripts/postinstall.js",
-    "test": "vitest"
+    "dev": "tsdown ./lib/cli.js --target node22 --format cjs --watch --out-dir ./bin",
+    "build:cli": "tsdown ./lib/cli.js --target node22 --format cjs --minify --out-dir ./bin",
+    "build:lib": "tsdown index.js --target node22 --format cjs --minify",
+    "build": "npm run build:cli && npm run build:lib",
+    "lint": "eslint . && prettier --check .",
+    "fix": "eslint . --fix && prettier --write ."
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/vitalygashkov/azot"
+    "url": "git+https://github.com/azot-labs/extensions.git"
   },
   "keywords": [
-    "widevine",
-    "drm",
-    "google",
-    "pssh",
-    "eme",
-    "encrypted-media-extensions",
-    "media"
+    "azot",
+    "extensions",
+    "types",
+    "api"
   ],
-  "author": "Vitaly Gashkov <vitalygashkov@vk.com>",
-  "license": "AGPL-3.0",
-  "readmeFilename": "README.md",
   "bugs": {
-    "url": "https://github.com/vitalygashkov/azot/issues",
+    "url": "https://github.com/azot-labs/extensions/issues",
     "email": "vitalygashkov@vk.com"
   },
+  "author": "Vitaly Gashkov <vitalygashkov@vk.com>",
+  "license": "MIT",
+  "readmeFilename": "README.md",
   "funding": [
     {
       "type": "individual",
@@ -57,53 +50,22 @@
       "url": "https://www.patreon.com/vitalygashkov"
     }
   ],
-  "exports": {
-    ".": {
-      "require": {
-        "types": "./dist/lib/main.d.cts",
-        "default": "./dist/lib/main.cjs"
-      },
-      "import": {
-        "types": "./dist/lib/main.d.ts",
-        "default": "./dist/lib/main.js"
-      }
-    }
-  },
   "engines": {
-    "node": "20 || 21 || 22 || 23"
-  },
-  "dependencies": {
-    "@fastify/helmet": "^13.0.0",
-    "@fastify/rate-limit": "^10.2.1",
-    "@fastify/sensible": "^6.0.1",
-    "@fastify/type-provider-typebox": "^5.1.0",
-    "@sinclair/typebox": "^0.34.11",
-    "fastify": "^5.1.0",
-    "jsrsasign": "^11.1.0",
-    "protobufjs": "^7.4.0"
+    "node": ">=20"
   },
   "devDependencies": {
-    "@eslint/js": "^9.12.0",
-    "@solidjs/router": "^0.14.10",
-    "@types/jsrsasign": "^10.5.14",
-    "@types/node": "^22.7.5",
-    "@wxt-dev/module-solid": "^1.1.2",
-    "autoprefixer": "^10.4.17",
-    "clsx": "^2.1.1",
-    "eslint": "^9.12.0",
-    "eslint-config-prettier": "^9.1.0",
-    "eslint-plugin-prettier": "^5.2.1",
-    "globals": "^15.11.0",
-    "postcss": "^8.4.33",
-    "solid-icons": "^1.1.0",
-    "solid-js": "^1.9.1",
-    "tailwind-merge": "^2.5.4",
-    "tailwindcss": "^3.4.1",
-    "tsup": "^8.3.0",
-    "typescript": "^5.6.2",
-    "typescript-eslint": "^8.9.0",
-    "vite-plugin-arraybuffer": "^0.0.8",
-    "vitest": "^2.1.3",
-    "wxt": "^0.19.11"
+    "@eslint/js": "^9.31.0",
+    "@types/node": "^24.0.14",
+    "dasha": "^3.1.6",
+    "eslint": "^9.31.0",
+    "eslint-config-prettier": "^10.1.5",
+    "eslint-plugin-prettier": "^5.5.1",
+    "globals": "^16.3.0",
+    "prettier": "^3.6.2",
+    "typescript": "^5.8.3"
+  },
+  "dependencies": {
+    "javascript-obfuscator": "^4.1.1",
+    "tsdown": "^0.12.9"
   }
 }

package/public.pem

@@ -0,0 +1,14 @@
+-----BEGIN PUBLIC KEY-----
+MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEApJVKjJzoV4ati1NHAXjN
+D3CRULVU8g7OzFNCcjqH9fAeByTevYTo4ryttcaljf2qOBNE0RLVgMh1gaU/EjrA
+CA+nXYU4USjknctSKFFspIdnPJfYTe2pu42tQeOr88AASYt/PjHBxHXSr/z2D7H/
+GB51DaakFqM6T6wUyjXOduVuMnVkWtNDexQkjp6AItq2IRyCSjc8X4VtnuIm4D/F
+/Ny7cw0+HBP3c58BBiTpjCc1EI/5gYfqzlo9bGKmbn/s8rRgGAA0v1aPGjjN0Ask
+gTgd4iQE0Qjumu5QiaiYghWiGaiK9Q5RQW0YIu/vh59Ylyul62jUC0+1a+UsoW/U
+0ZQwqub0NnEpHeBboGYQzA6cjDFf7vvlpVp/7vHwsBXcub7pqmi1IVEEpvsaIy11
+dnLFkfWsUHD8w0f6basX8gtd7HRacjWZD+SiBoGCfu3t8KQZizdMeUgBkDuNojij
+UtpyQ5rczO+EuLjkHgjwFpplyOUme1ePENjRzhVdHzPMLohet4EFgMQV6s7vNJgA
+rp71hOnAkOJJ/Pe2/PgFBBbQWgEOqsMopWesVDUV84rIkSnbsuzzzDT9Cfs5Veje
+fyERt4rbt8EEUwDnqZl2vRNDGHjjCl/d1U1iITt6OVSeMd6jA8cg8PmDBq3Wl6bP
+RMZ+4GiuFSJsJG3+bzKaFxMCAwEAAQ==
+-----END PUBLIC KEY-----

package/types/azot.d.ts

@@ -0,0 +1,106 @@
+declare global {
+  /**
+   * Azot runtime APIs
+   *
+   * @example
+   *
+   * ```js
+   * import { sanitizeString } from 'azot';
+   *
+   * const sanitized = sanitizeString('Hello, world!');
+   * // Sanitize string to be able use it in filenames
+   * console.log(sanitized);
+   * ```
+   *
+   * This module aliases `globalThis.Azot`.
+   */
+  const Azot: AzotModule;
+
+  /**
+   * In v5.0.0+ use `Azot` instead
+   */
+  const Streamyx: AzotModule;
+
+  interface AzotModule {
+    version: string;
+    utils: Common;
+    prompt<T = PromptResponse>(request: PromptRequest): Promise<T>;
+  }
+}
+
+export type InputType =
+  | 'text'
+  | 'password'
+  | 'number'
+  | 'checkbox'
+  | 'select'
+  | 'date'
+  | 'confirm';
+
+export type InputField = {
+  type?: InputType;
+  label: string;
+  placeholder?: string;
+  defaultValue?: string;
+  required?: boolean;
+  options?: string[];
+};
+
+export type PromptRequest = {
+  title?: string;
+  description?: string;
+  fields: Record<string, InputField>;
+};
+
+export type PromptResponse = {
+  [field: string]: string; // TODO: Add more types with inference from InputField type
+};
+
+export type Common = {
+  sanitizeString: (text: string) => string;
+
+  execUrlPatterns: (
+    url: string,
+    patterns: string[],
+    baseUrls: string[],
+  ) => {
+    pathname: Record<string, string | undefined>;
+    search: Record<string, string | undefined>;
+  };
+
+  extendEpisodes: (episodesBySeasons?: Map<number, Set<number>>) => {
+    items: Map<number, Set<number>>;
+    has: (episode?: number, season?: number) => boolean;
+    set: (episode?: number, season?: number) => void;
+    getMin: () => number;
+    getMax: () => number;
+    seasonsCount: number;
+    episodesCount: number;
+  };
+
+  getRandomElements: (array: unknown, count?: number) => unknown[];
+};
+
+export type HttpClient = {
+  headers: Record<string, string>;
+  cookies: string[];
+  userAgents: Record<
+    'chromeWindows' | 'chromeMacOS' | 'chromeLinux' | 'smartTv' | 'tizen',
+    string
+  >;
+  fetch(
+    resource: string | URL | Request,
+    options?: RequestInit,
+  ): Promise<Response>;
+  fetchAsChrome(
+    resource: string | URL | Request,
+    options?: RequestInit,
+  ): Promise<Response>;
+  appendCookies(setCookie: string | string[]): void;
+  setAgent(proxy?: string | null): void;
+  setCookies(cookies: string[]): void;
+  setHeader(name: string, value: string): void;
+  setHeaders(headers: Record<string, string>): void;
+  removeHeader(name: string): void;
+  destroySessions(): Promise<void>;
+};

package/types/cookie-store.d.ts

@@ -0,0 +1,34 @@
+declare global {
+  /** [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/CookieStore) */
+  interface CookieStore {
+    get(cookie: string | { name: string; url: string }): Promise<Cookie | null>;
+    getAll(cookie?: string | { name: string; url: string }): Promise<Cookie[]>;
+    set(cookie: Cookie): Promise<void>;
+    delete(
+      cookie?:
+        | string
+        | {
+            name: string;
+            domain?: string;
+            path?: string;
+            partitioned?: boolean;
+          },
+    ): Promise<void>;
+    addToHeaders(headers: Headers): void;
+    toString(): string;
+  }
+
+  interface Cookie {
+    name: string;
+    value: string;
+    domain?: string;
+    path?: string;
+    expires?: string;
+    httpOnly?: boolean;
+    secure?: boolean;
+    sameSite?: 'Strict' | 'Lax' | 'None';
+    partitioned?: boolean;
+  }
+}
+
+export {};

package/types/document.d.ts

@@ -0,0 +1,8 @@
+declare global {
+  /** A partial implementation of the [Document](https://developer.mozilla.org/en-US/docs/Web/API/Document) for Azot */
+  interface Document {
+    readonly cookie: string;
+  }
+}
+
+export {};

package/types/extension.d.ts

@@ -0,0 +1,164 @@
+import { Options } from './options';
+
+export interface ExtensionConfig {
+  id: string;
+  version: string;
+  name: string;
+  tag?: string;
+  icon?: string;
+}
+
+export interface Extension {
+  canHandle?(url: string): boolean | Promise<boolean>;
+
+  /**
+   * Performs initialization of extension (e.g. token refresh)
+   */
+  init?(): void | Promise<void>;
+
+  isAuthenticated?(): Promise<boolean>;
+  login?(username?: string, password?: string): Promise<void>;
+  logout?(): Promise<void>;
+
+  /**
+   * Fetches content metadata from URL
+   */
+  fetchContentMetadata: (
+    url: string,
+    options: Options,
+  ) => Promise<ContentMetadata[]>;
+
+  /**
+   * Fetches data about content source (e.g. manifest URL, external subtitles, etc.)
+   */
+  fetchContentSource?: (
+    contentId: string,
+    options: Options,
+  ) => Promise<ContentSource | null>;
+
+  /**
+   * Fetches just content DRM config (e.g. license server URL, request headers, etc.)
+   */
+  fetchContentDrm?: (payload: any, options: Options) => Promise<DrmConfig>;
+
+  onDownloadFinished?(): Promise<void>;
+
+  /**
+   * Extension name (e.g. Netflix, Prime Video, Apple TV+, etc.)
+   * @deprecated Use `config.title` field in package.json
+   */
+  name?: string;
+
+  /**
+   * Short tag which will be used in filename (e.g. NF, AMZN, ATVP, etc.)
+   * @deprecated Use `config.tag` field in package.json
+   */
+  tag?: string;
+
+  /**
+   * Logo icon URL
+   * @deprecated Use `config.icon` field in package.json
+   */
+  icon?: string;
+
+  /**
+   * Substring pattern to match URL host handled by this plugin
+   * @deprecated
+   */
+  match?: string;
+}
+
+export interface MediaInfo {
+  id: string;
+  type?: 'movie' | 'tv';
+  title?: string;
+  description?: string;
+  thumbnailUrl?: string;
+  author?: string;
+  year?: number;
+
+  season?: number;
+  episode?: number;
+  episodeTitle?: string;
+
+  sources: (MediaSource | string)[];
+
+  [key: string]: any;
+}
+
+export interface MediaSource {
+  url: string;
+
+  headers?: Record<string, string>;
+  drm?: string | MediaDrm | MediaDrm[];
+  type?: 'progressive' | 'direct' | 'hls' | 'dash';
+
+  language?: string;
+  size?: number;
+}
+
+export interface MediaDrm {
+  type?: 'widevine' | 'playready';
+  server: string;
+
+  headers?: Record<string, string>;
+
+  transformRequest?(request: Request): Request;
+  transformResponse?(response: Response): Response;
+
+  fetchCertificate?(
+    message: Uint8Array,
+    sessionId: string,
+  ): Promise<Uint8Array>;
+  fetchLicense?(message: Uint8Array, sessionId: string): Promise<Uint8Array>;
+}
+
+export { Options };
+
+export interface CommonContentMetadata {
+  tag?: string;
+  /**
+   * Required if no `fetchContentSource` method is provided
+   */
+  source?: ContentSource;
+}
+
+export interface MovieMetadata extends CommonContentMetadata {
+  id?: string;
+  title?: string;
+}
+
+export interface EpisodeMetadata extends CommonContentMetadata {
+  id?: string;
+  title?: string;
+  episodeNumber: number;
+  seasonNumber?: number;
+  episodeTitle?: string;
+}
+
+export type ContentMetadata = MovieMetadata | EpisodeMetadata;
+
+export type ContentSource = {
+  /**
+   * URL of the content: manifest URL / playlist URL / direct link to media file
+   */
+  url: string;
+  headers?: Record<string, string>;
+  http2?: boolean;
+  type?: 'video' | 'audio' | 'subtitle' | 'any';
+  audioLanguage?: string;
+  audioType?: string;
+  subtitles?: any[];
+  drm?: DrmConfig;
+};
+
+export type DrmConfig =
+  | {
+      server: string;
+      headers?: Record<string, string>;
+      params?: object;
+      template?: string;
+      http2?: boolean;
+    }
+  | { payload: any }
+  | { keys: { kid: string; key: string }[] };

package/types/globals.d.ts

@@ -0,0 +1,33 @@
+import './azot';
+import './cookie-store';
+import './navigator';
+import './document';
+import './uin8array.extensions';
+
+declare global {
+  /**
+   *
+   * A partial implementation of [Navigator](https://developer.mozilla.org/ru/docs/Web/API/Navigator) for Azot
+   */
+  var navigator: Navigator;
+
+  /** [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Window/cookieStore) */
+  const cookieStore: CookieStore;
+
+  /** [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Window/prompt) */
+  function prompt(message?: string, _default?: string): string | null;
+
+  /** [MDN Reference](https://developer.mozilla.org/ru/docs/Web/API/Window/alert) */
+  function alert(message?: any): void;
+
+  /** [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Window/fetch) */
+  function fetch(
+    input: RequestInfo | URL,
+    init?: RequestInit,
+  ): Promise<Response>;
+
+  /** [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/eval) */
+  function eval(x: string): any;
+}
+
+export {};

package/types/navigator.d.ts

@@ -0,0 +1,28 @@
+declare global {
+  /** A partial implementation of [Navigator](https://developer.mozilla.org/ru/docs/Web/API/Navigator) for Azot */
+  interface Navigator {
+    appName: string;
+    appVersion: string;
+    platform: string;
+    userAgentData: {
+      mobile: boolean;
+      platform: string;
+      getHighEntropyValues(hints: string[]): Promise<UADataValues>;
+    };
+  }
+
+  interface NavigatorUABrandVersion {
+    brand: string;
+    version: string;
+  }
+
+  interface UADataValues {
+    architecture: string;
+    fullVersionList: NavigatorUABrandVersion[];
+    mobile: boolean;
+    platform: string;
+    platformVersion: string;
+  }
+}
+
+export {};