@ekipnico/video-fetch 1.0.0

package/out/DownloadProvider.d.ts

@@ -0,0 +1,22 @@
+import { DownloadConfig } from './schema/DownloadConfig.js';
+import { DownloadResult } from './schema/DownloadResult.js';
+import { VideoMetadata } from './schema/VideoMetadata.js';
+/**
+ * Abstract contract for video download providers.
+ * Concrete implementations handle platform-specific logic.
+ */
+export declare abstract class DownloadProvider {
+    abstract readonly name: string;
+    /**
+     * Download video from URL.
+     */
+    abstract download(url: string, config: DownloadConfig): Promise<DownloadResult>;
+    /**
+     * Extract metadata without downloading video.
+     */
+    abstract extractMetadata(url: string): Promise<VideoMetadata>;
+    /**
+     * Check if URL is supported by this provider.
+     */
+    abstract isSupported(url: string): Promise<boolean>;
+}

package/out/DownloadProvider.js

@@ -0,0 +1,7 @@
+/**
+ * Abstract contract for video download providers.
+ * Concrete implementations handle platform-specific logic.
+ */
+export class DownloadProvider {
+}
+//# sourceMappingURL=DownloadProvider.js.map

package/out/DownloadProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DownloadProvider.js","sourceRoot":"","sources":["../src/DownloadProvider.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,OAAgB,gBAAgB;CAmBrC"}

package/out/VideoDownloadModule.d.ts

@@ -0,0 +1,27 @@
+import { Mesh } from 'mesh-ioc';
+/**
+ * Creates a configured Mesh for video downloading.
+ *
+ * ## Requirements
+ * - `yt-dlp` must be installed and available in PATH
+ *
+ * @example
+ * const mesh = createVideoDownloadMesh();
+ * const downloader = mesh.resolve(VideoDownloader);
+ *
+ * // Download video
+ * const result = await downloader.download('https://youtube.com/watch?v=xyz');
+ *
+ * // Extract metadata only
+ * const metadata = await downloader.extractMetadata('https://youtube.com/watch?v=xyz');
+ */
+export declare function createVideoDownloadMesh(): Mesh;
+/**
+ * Register video download services into an existing Mesh.
+ *
+ * @example
+ * const mesh = new Mesh('MyApp');
+ * registerVideoDownloadServices(mesh);
+ * const downloader = mesh.resolve(VideoDownloader);
+ */
+export declare function registerVideoDownloadServices(mesh: Mesh): void;

package/out/VideoDownloadModule.js

@@ -0,0 +1,39 @@
+import { Mesh } from 'mesh-ioc';
+import { VideoDownloader } from './VideoDownloader.js';
+import { DownloadProvider } from './DownloadProvider.js';
+import { YtDlpProvider } from './providers/YtDlpProvider.js';
+/**
+ * Creates a configured Mesh for video downloading.
+ *
+ * ## Requirements
+ * - `yt-dlp` must be installed and available in PATH
+ *
+ * @example
+ * const mesh = createVideoDownloadMesh();
+ * const downloader = mesh.resolve(VideoDownloader);
+ *
+ * // Download video
+ * const result = await downloader.download('https://youtube.com/watch?v=xyz');
+ *
+ * // Extract metadata only
+ * const metadata = await downloader.extractMetadata('https://youtube.com/watch?v=xyz');
+ */
+export function createVideoDownloadMesh() {
+    const mesh = new Mesh('VideoDownload');
+    mesh.service(DownloadProvider, YtDlpProvider);
+    mesh.service(VideoDownloader);
+    return mesh;
+}
+/**
+ * Register video download services into an existing Mesh.
+ *
+ * @example
+ * const mesh = new Mesh('MyApp');
+ * registerVideoDownloadServices(mesh);
+ * const downloader = mesh.resolve(VideoDownloader);
+ */
+export function registerVideoDownloadServices(mesh) {
+    mesh.service(DownloadProvider, YtDlpProvider);
+    mesh.service(VideoDownloader);
+}
+//# sourceMappingURL=VideoDownloadModule.js.map

package/out/VideoDownloadModule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VideoDownloadModule.js","sourceRoot":"","sources":["../src/VideoDownloadModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,uBAAuB;IACnC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,eAAe,CAAC,CAAC;IAEvC,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,aAAa,CAAC,CAAC;IAC9C,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAE9B,OAAO,IAAI,CAAC;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,6BAA6B,CAAC,IAAU;IACpD,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,aAAa,CAAC,CAAC;IAC9C,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;AAClC,CAAC"}

package/out/VideoDownloader.d.ts

@@ -0,0 +1,22 @@
+import { DownloadConfig } from './schema/DownloadConfig.js';
+import { DownloadResult } from './schema/DownloadResult.js';
+import { VideoMetadata } from './schema/VideoMetadata.js';
+/**
+ * Main orchestrator for video downloading.
+ * Delegates to configured DownloadProvider.
+ */
+export declare class VideoDownloader {
+    private provider;
+    /**
+     * Download a video from URL.
+     */
+    download(url: string, config?: Partial<DownloadConfig>): Promise<DownloadResult>;
+    /**
+     * Extract metadata without downloading.
+     */
+    extractMetadata(url: string): Promise<VideoMetadata>;
+    /**
+     * Check if URL is supported.
+     */
+    isSupported(url: string): Promise<boolean>;
+}

package/out/VideoDownloader.js

@@ -0,0 +1,42 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { dep } from 'mesh-ioc';
+import { DownloadProvider } from './DownloadProvider.js';
+import { DEFAULT_DOWNLOAD_CONFIG } from './schema/DownloadConfig.js';
+/**
+ * Main orchestrator for video downloading.
+ * Delegates to configured DownloadProvider.
+ */
+export class VideoDownloader {
+    /**
+     * Download a video from URL.
+     */
+    async download(url, config) {
+        const mergedConfig = { ...DEFAULT_DOWNLOAD_CONFIG, ...config };
+        return this.provider.download(url, mergedConfig);
+    }
+    /**
+     * Extract metadata without downloading.
+     */
+    async extractMetadata(url) {
+        return this.provider.extractMetadata(url);
+    }
+    /**
+     * Check if URL is supported.
+     */
+    async isSupported(url) {
+        return this.provider.isSupported(url);
+    }
+}
+__decorate([
+    dep(),
+    __metadata("design:type", DownloadProvider)
+], VideoDownloader.prototype, "provider", void 0);
+//# sourceMappingURL=VideoDownloader.js.map

package/out/VideoDownloader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VideoDownloader.js","sourceRoot":"","sources":["../src/VideoDownloader.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAkB,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAIrF;;;GAGG;AACH,MAAM,OAAO,eAAe;IAIxB;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,GAAW,EAAE,MAAgC;QACxD,MAAM,YAAY,GAAG,EAAE,GAAG,uBAAuB,EAAE,GAAG,MAAM,EAAE,CAAC;QAC/D,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,GAAW;QAC7B,OAAO,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,GAAW;QACzB,OAAO,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC1C,CAAC;CAEJ;AAxBkB;IAAd,GAAG,EAAE;8BAAoB,gBAAgB;iDAAC"}

package/out/index.d.ts

@@ -0,0 +1,5 @@
+export * from './schema/index.js';
+export * from './DownloadProvider.js';
+export * from './providers/YtDlpProvider.js';
+export * from './VideoDownloader.js';
+export * from './VideoDownloadModule.js';

package/out/index.js

@@ -0,0 +1,6 @@
+export * from './schema/index.js';
+export * from './DownloadProvider.js';
+export * from './providers/YtDlpProvider.js';
+export * from './VideoDownloader.js';
+export * from './VideoDownloadModule.js';
+//# sourceMappingURL=index.js.map

package/out/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC"}

package/out/providers/YtDlpProvider.d.ts

@@ -0,0 +1,36 @@
+import { DownloadProvider } from '../DownloadProvider.js';
+import { DownloadConfig } from '../schema/DownloadConfig.js';
+import { DownloadResult } from '../schema/DownloadResult.js';
+import { VideoMetadata } from '../schema/VideoMetadata.js';
+export interface YtDlpProviderOptions {
+    outputDir?: string;
+    cookiesPath?: string;
+    /** Browser to get cookies from (safari, chrome, firefox, etc.) */
+    cookiesFromBrowser?: string;
+}
+/**
+ * yt-dlp based download provider.
+ * Supports 1000+ video platforms.
+ *
+ * ## Environment Variables
+ * - `YTDLP_COOKIES_FROM_BROWSER`: Browser to get cookies from (safari, chrome, firefox)
+ * - `YTDLP_COOKIES_PATH`: Path to cookies.txt file
+ */
+export declare class YtDlpProvider extends DownloadProvider {
+    readonly name = "yt-dlp";
+    private outputDir;
+    private cookiesPath?;
+    private cookiesFromBrowser?;
+    constructor(options?: YtDlpProviderOptions);
+    /**
+     * Build cookies flag for yt-dlp commands.
+     */
+    private getCookiesFlag;
+    download(url: string, config: DownloadConfig): Promise<DownloadResult>;
+    extractMetadata(url: string): Promise<VideoMetadata>;
+    isSupported(url: string): Promise<boolean>;
+    private mapMetadata;
+    private mapChapters;
+    private buildDownloadArgs;
+    private findDownloadedFiles;
+}

package/out/providers/YtDlpProvider.js

@@ -0,0 +1,215 @@
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import { existsSync } from 'fs';
+import { stat, mkdir, readdir, writeFile } from 'fs/promises';
+import { join, extname } from 'path';
+import { tmpdir } from 'os';
+import { DownloadProvider } from '../DownloadProvider.js';
+import { DEFAULT_DOWNLOAD_CONFIG } from '../schema/DownloadConfig.js';
+import { DownloadError } from '@ekipnico/video-core';
+const execAsync = promisify(exec);
+/**
+ * yt-dlp based download provider.
+ * Supports 1000+ video platforms.
+ *
+ * ## Environment Variables
+ * - `YTDLP_COOKIES_FROM_BROWSER`: Browser to get cookies from (safari, chrome, firefox)
+ * - `YTDLP_COOKIES_PATH`: Path to cookies.txt file
+ */
+export class YtDlpProvider extends DownloadProvider {
+    constructor(options) {
+        super();
+        this.name = 'yt-dlp';
+        this.outputDir = options?.outputDir || join(tmpdir(), 'video-download');
+        this.cookiesPath = options?.cookiesPath || process.env.YTDLP_COOKIES_PATH;
+        this.cookiesFromBrowser = options?.cookiesFromBrowser || process.env.YTDLP_COOKIES_FROM_BROWSER;
+    }
+    /**
+     * Build cookies flag for yt-dlp commands.
+     */
+    getCookiesFlag() {
+        if (this.cookiesFromBrowser) {
+            return `--cookies-from-browser ${this.cookiesFromBrowser}`;
+        }
+        if (this.cookiesPath) {
+            return `--cookies "${this.cookiesPath}"`;
+        }
+        return '';
+    }
+    async download(url, config) {
+        const mergedConfig = { ...DEFAULT_DOWNLOAD_CONFIG, ...config };
+        const outputDir = mergedConfig.outputDir || this.outputDir;
+        // First get metadata to know the video ID
+        const metadata = await this.extractMetadata(url);
+        // Create per-video folder: {outputDir}/{videoId}/
+        const videoDir = join(outputDir, metadata.id);
+        if (!existsSync(videoDir)) {
+            await mkdir(videoDir, { recursive: true });
+        }
+        // Output template: video.{ext} inside the video folder
+        const outputTemplate = join(videoDir, 'video.%(ext)s');
+        // Build yt-dlp command
+        const args = this.buildDownloadArgs(url, outputTemplate, mergedConfig);
+        const command = `yt-dlp ${args.join(' ')}`;
+        try {
+            await execAsync(command, {
+                timeout: (mergedConfig.timeout || 600) * 1000,
+                maxBuffer: 10 * 1024 * 1024,
+            });
+            // Find the downloaded video file
+            const files = await this.findDownloadedFiles(videoDir);
+            if (files.length === 0) {
+                throw new DownloadError(url, new Error('No files downloaded'));
+            }
+            const videoFile = files[0];
+            const stats = await stat(videoFile.path);
+            // Save metadata to meta.json
+            const metadataPath = join(videoDir, 'meta.json');
+            await writeFile(metadataPath, JSON.stringify(metadata, null, 2));
+            return {
+                success: true,
+                videoDir,
+                filePath: videoFile.path,
+                metadataPath,
+                format: videoFile.ext,
+                sizeBytes: stats.size,
+                duration: metadata.duration,
+                metadata,
+            };
+        }
+        catch (error) {
+            if (error instanceof DownloadError) {
+                throw error;
+            }
+            throw new DownloadError(url, error);
+        }
+    }
+    async extractMetadata(url) {
+        const cookiesFlag = this.getCookiesFlag();
+        const command = `yt-dlp ${cookiesFlag} --dump-json --no-download "${url}"`;
+        try {
+            const { stdout } = await execAsync(command, {
+                maxBuffer: 10 * 1024 * 1024,
+            });
+            const data = JSON.parse(stdout);
+            return this.mapMetadata(data, url);
+        }
+        catch (error) {
+            throw new DownloadError(url, error);
+        }
+    }
+    async isSupported(url) {
+        try {
+            const command = `yt-dlp --simulate --no-download "${url}" 2>&1`;
+            await execAsync(command);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    mapMetadata(data, url) {
+        return {
+            id: data.id,
+            platform: (data.extractor_key?.toLowerCase() || data.extractor || 'unknown'),
+            url: data.webpage_url || url,
+            title: data.title || 'Untitled',
+            description: data.description || '',
+            uploader: data.uploader || data.channel || 'Unknown',
+            uploaderUrl: data.uploader_url,
+            channel: data.channel,
+            channelId: data.channel_id,
+            uploadDate: data.upload_date,
+            uploadTimestamp: data.timestamp,
+            duration: data.duration || 0,
+            viewCount: data.view_count,
+            likeCount: data.like_count,
+            commentCount: data.comment_count,
+            width: data.width,
+            height: data.height,
+            fps: data.fps,
+            vcodec: data.vcodec,
+            acodec: data.acodec,
+            filesize: (data.filesize || data.filesize_approx),
+            categories: data.categories,
+            tags: data.tags,
+            ageLimit: data.age_limit,
+            thumbnail: data.thumbnail,
+            thumbnails: data.thumbnails,
+            subtitles: data.subtitles,
+            chapters: this.mapChapters(data.chapters),
+        };
+    }
+    mapChapters(chapters) {
+        if (!chapters) {
+            return undefined;
+        }
+        return chapters.map(ch => ({
+            title: ch.title,
+            startTime: ch.start_time,
+            endTime: ch.end_time,
+        }));
+    }
+    buildDownloadArgs(url, outputPath, config) {
+        const args = [];
+        // Cookies for authentication
+        if (this.cookiesFromBrowser) {
+            args.push('--cookies-from-browser', this.cookiesFromBrowser);
+        }
+        else if (this.cookiesPath && existsSync(this.cookiesPath)) {
+            args.push('--cookies', `"${this.cookiesPath}"`);
+        }
+        // Format selection (quote format string to handle shell metacharacters like < and >)
+        if (config.audioOnly) {
+            args.push('-f', '"bestaudio[ext=m4a]/bestaudio"');
+            args.push('-x'); // Extract audio
+        }
+        else if (config.quality && config.quality !== 'best') {
+            args.push('-f', `"bestvideo[height<=${config.quality}]+bestaudio/best[height<=${config.quality}]"`);
+        }
+        else {
+            args.push('-f', '"bestvideo+bestaudio/best"');
+        }
+        // Merge to mp4 when possible
+        args.push('--merge-output-format', 'mp4');
+        // Subtitles
+        if (config.includeSubtitles) {
+            args.push('--write-subs');
+            if (config.subtitleLang) {
+                args.push('--sub-lang', config.subtitleLang);
+            }
+        }
+        // Rate limiting
+        if (config.rateLimit) {
+            args.push('-r', `${config.rateLimit}`);
+        }
+        // Output path
+        args.push('-o', `"${outputPath}"`);
+        // Extra args
+        if (config.extraArgs) {
+            args.push(...config.extraArgs);
+        }
+        // URL (always last)
+        args.push(`"${url}"`);
+        return args;
+    }
+    async findDownloadedFiles(videoDir) {
+        const files = await readdir(videoDir);
+        const results = [];
+        for (const file of files) {
+            // Look for video.* files (video.mp4, video.webm, etc.)
+            if (file.startsWith('video.')) {
+                const ext = extname(file).slice(1);
+                // Skip subtitle files
+                if (!['vtt', 'srt', 'ass', 'json'].includes(ext)) {
+                    results.push({
+                        path: join(videoDir, file),
+                        ext,
+                    });
+                }
+            }
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=YtDlpProvider.js.map

package/out/providers/YtDlpProvider.js.map

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

package/out/schema/DownloadConfig.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Configuration options for video download.
+ */
+export interface DownloadConfig {
+    /** Output directory for downloaded files */
+    outputDir?: string;
+    /** Preferred format (best, mp4, webm, etc.) */
+    format?: string;
+    /** Maximum quality (480, 720, 1080, 2160, or 'best') */
+    quality?: string | number;
+    /** Download only audio */
+    audioOnly?: boolean;
+    /** Include subtitles if available */
+    includeSubtitles?: boolean;
+    /** Preferred subtitle language */
+    subtitleLang?: string;
+    /** Timeout in seconds */
+    timeout?: number;
+    /** Rate limit (bytes per second) */
+    rateLimit?: number;
+    /** Custom yt-dlp arguments */
+    extraArgs?: string[];
+}
+export declare const DEFAULT_DOWNLOAD_CONFIG: DownloadConfig;

package/out/schema/DownloadConfig.js

@@ -0,0 +1,8 @@
+export const DEFAULT_DOWNLOAD_CONFIG = {
+    format: 'best',
+    quality: 'best',
+    audioOnly: false,
+    includeSubtitles: false,
+    timeout: 600,
+};
+//# sourceMappingURL=DownloadConfig.js.map

package/out/schema/DownloadConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DownloadConfig.js","sourceRoot":"","sources":["../../src/schema/DownloadConfig.ts"],"names":[],"mappings":"AAwBA,MAAM,CAAC,MAAM,uBAAuB,GAAmB;IACnD,MAAM,EAAE,MAAM;IACd,OAAO,EAAE,MAAM;IACf,SAAS,EAAE,KAAK;IAChB,gBAAgB,EAAE,KAAK;IACvB,OAAO,EAAE,GAAG;CACf,CAAC"}

package/out/schema/DownloadResult.d.ts

@@ -0,0 +1,26 @@
+import { VideoMetadata } from './VideoMetadata.js';
+/**
+ * Result of a video download operation.
+ */
+export interface DownloadResult {
+    /** Whether download succeeded */
+    success: boolean;
+    /** Path to the video's folder (contains all related files) */
+    videoDir: string;
+    /** Path to downloaded video file */
+    filePath: string;
+    /** Path to metadata JSON file */
+    metadataPath: string;
+    /** Video format (mp4, webm, etc.) */
+    format: string;
+    /** File size in bytes */
+    sizeBytes: number;
+    /** Duration in seconds */
+    duration: number;
+    /** Extracted metadata from platform */
+    metadata: VideoMetadata;
+    /** Path to subtitles file (if downloaded) */
+    subtitlesPath?: string;
+    /** Path to thumbnail (if downloaded) */
+    thumbnailPath?: string;
+}

package/out/schema/DownloadResult.js

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

package/out/schema/DownloadResult.js.map

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

package/out/schema/VideoMetadata.d.ts

@@ -0,0 +1,46 @@
+import { Schema } from 'airtight';
+/**
+ * Video platform-specific metadata extracted during download.
+ */
+export interface VideoMetadata {
+    id: string;
+    platform: string;
+    url: string;
+    title: string;
+    description: string;
+    uploader: string;
+    uploaderUrl?: string;
+    channel?: string;
+    channelId?: string;
+    uploadDate?: string;
+    uploadTimestamp?: number;
+    duration: number;
+    viewCount?: number;
+    likeCount?: number;
+    commentCount?: number;
+    width?: number;
+    height?: number;
+    fps?: number;
+    vcodec?: string;
+    acodec?: string;
+    filesize?: number;
+    categories?: string[];
+    tags?: string[];
+    ageLimit?: number;
+    thumbnail?: string;
+    thumbnails?: Array<{
+        url: string;
+        width?: number;
+        height?: number;
+    }>;
+    subtitles?: Record<string, Array<{
+        ext: string;
+        url: string;
+    }>>;
+    chapters?: Array<{
+        title: string;
+        startTime: number;
+        endTime: number;
+    }>;
+}
+export declare const VideoMetadataSchema: Schema<VideoMetadata>;

package/out/schema/VideoMetadata.js

@@ -0,0 +1,35 @@
+import { Schema } from 'airtight';
+export const VideoMetadataSchema = new Schema({
+    type: 'object',
+    properties: {
+        id: { type: 'string' },
+        platform: { type: 'string' },
+        url: { type: 'string' },
+        title: { type: 'string' },
+        description: { type: 'string' },
+        uploader: { type: 'string' },
+        uploaderUrl: { type: 'string', optional: true },
+        channel: { type: 'string', optional: true },
+        channelId: { type: 'string', optional: true },
+        uploadDate: { type: 'string', optional: true },
+        uploadTimestamp: { type: 'number', optional: true },
+        duration: { type: 'number' },
+        viewCount: { type: 'number', optional: true },
+        likeCount: { type: 'number', optional: true },
+        commentCount: { type: 'number', optional: true },
+        width: { type: 'number', optional: true },
+        height: { type: 'number', optional: true },
+        fps: { type: 'number', optional: true },
+        vcodec: { type: 'string', optional: true },
+        acodec: { type: 'string', optional: true },
+        filesize: { type: 'number', optional: true },
+        categories: { type: 'array', items: { type: 'string' }, optional: true },
+        tags: { type: 'array', items: { type: 'string' }, optional: true },
+        ageLimit: { type: 'number', optional: true },
+        thumbnail: { type: 'string', optional: true },
+        thumbnails: { type: 'any', optional: true },
+        subtitles: { type: 'any', optional: true },
+        chapters: { type: 'any', optional: true },
+    },
+});
+//# sourceMappingURL=VideoMetadata.js.map

package/out/schema/VideoMetadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VideoMetadata.js","sourceRoot":"","sources":["../../src/schema/VideoMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAgElC,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,MAAM,CAAgB;IACzD,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACR,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACtB,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC5B,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACvB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC/B,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC5B,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC/C,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC3C,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC7C,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC9C,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QACnD,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC5B,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC7C,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC7C,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAChD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QACzC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC1C,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QACvC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC1C,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC1C,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC5C,UAAU,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;QACxE,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;QAClE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC5C,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC7C,UAAU,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC3C,SAAS,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC1C,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE;KAC5C;CACJ,CAAC,CAAC"}

package/out/schema/index.d.ts

@@ -0,0 +1,3 @@
+export * from './VideoMetadata.js';
+export * from './DownloadConfig.js';
+export * from './DownloadResult.js';

package/out/schema/index.js

@@ -0,0 +1,4 @@
+export * from './VideoMetadata.js';
+export * from './DownloadConfig.js';
+export * from './DownloadResult.js';
+//# sourceMappingURL=index.js.map

package/out/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}

package/out/test/VideoDownloadModule.test.d.ts

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