yt-dlp-bridge 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Antonio Orionus
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,19 @@
+# yt-dlp-bridge
+
+Typed, source-derived yt-dlp command planning and execution primitives for Node.js.
+
+This package is intentionally MCP-agnostic. It provides the yt-dlp integration layer used by `yt-dlp-mcp-server`: option catalog access, safe argv generation, dependency-aware planning, process execution, redaction, filesystem policy, and structured error adaptation via `ytdlp-errors`.
+
+## Local pre-release use
+
+```bash
+cd /home/anton/projects/y/yt-dlp-bridge
+pnpm install
+pnpm test
+pnpm run typecheck
+pnpm run build
+```
+
+Node >= 20. ESM only.
+
+This package is not published yet. It currently depends on the sibling local `ytdlp-errors` package via `file:../ytdlp-errors` so the full yt-dlp MCP stack can be polished before release.

package/dist/argv.d.ts

@@ -0,0 +1,18 @@
+import type { z } from "zod";
+import { type ServerConfig } from "./config.js";
+import { type ResolvedOutputPolicy } from "./filesystem.js";
+import { type DownloadInputSchema, type InspectInputSchema, type PlanDownloadInputSchema } from "./schemas.js";
+import type { YtdlpCommand } from "./types.js";
+type InspectInput = z.infer<typeof InspectInputSchema>;
+type PlanDownloadInput = z.infer<typeof PlanDownloadInputSchema>;
+type DownloadInput = z.infer<typeof DownloadInputSchema>;
+type DownloadLikeInput = PlanDownloadInput | DownloadInput;
+export type ListKind = "formats" | "subtitles" | "thumbnails";
+export declare function ytdlpCommand(args: string[], config?: ServerConfig): YtdlpCommand;
+export declare function buildMetadataArgs(input: InspectInput, config?: ServerConfig): string[];
+export declare function buildSingleJsonArgs(input: InspectInput, config?: ServerConfig): string[];
+export declare function buildListArgs(kind: ListKind, input: InspectInput, config?: ServerConfig): string[];
+export declare function buildSimulationArgs(input: DownloadLikeInput, policy: ResolvedOutputPolicy, config?: ServerConfig): string[];
+export declare function buildDownloadArgs(input: DownloadLikeInput, policy: ResolvedOutputPolicy, config?: ServerConfig): string[];
+export {};
+//# sourceMappingURL=argv.d.ts.map

package/dist/argv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"argv.d.ts","sourceRoot":"","sources":["../src/argv.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAAU,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAsB,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEhF,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC7B,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,KAAK,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACvD,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACjE,KAAK,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACzD,KAAK,iBAAiB,GAAG,iBAAiB,GAAG,aAAa,CAAC;AAE3D,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,YAAY,CAAC;AAE9D,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,GAAE,YAAqB,GAAG,YAAY,CAMxF;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,GAAE,YAAqB,GAAG,MAAM,EAAE,CAE9F;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,GAAE,YAAqB,GAAG,MAAM,EAAE,CAEhG;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,GAAE,YAAqB,GAAG,MAAM,EAAE,CAG1G;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,GAAE,YAAqB,GAAG,MAAM,EAAE,CAEnI;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,GAAE,YAAqB,GAAG,MAAM,EAAE,CAkCjI"}

package/dist/argv.js

@@ -0,0 +1,276 @@
+import { CONFIG } from "./config.js";
+import { resolveManagedPath } from "./filesystem.js";
+import { redactArgs } from "./redaction.js";
+import {} from "./schemas.js";
+export function ytdlpCommand(args, config = CONFIG) {
+    return {
+        command: config.ytdlpPath,
+        args,
+        redactedArgs: redactArgs(args)
+    };
+}
+export function buildMetadataArgs(input, config = CONFIG) {
+    return [...buildInspectBaseArgs(input, config), "--dump-json", input.url];
+}
+export function buildSingleJsonArgs(input, config = CONFIG) {
+    return [...buildInspectBaseArgs(input, config), "--dump-single-json", input.url];
+}
+export function buildListArgs(kind, input, config = CONFIG) {
+    const flag = kind === "formats" ? "--list-formats" : kind === "subtitles" ? "--list-subs" : "--list-thumbnails";
+    return [...buildInspectBaseArgs(input, config), flag, input.url];
+}
+export function buildSimulationArgs(input, policy, config = CONFIG) {
+    return ["--simulate", ...buildDownloadArgs(input, policy, config)];
+}
+export function buildDownloadArgs(input, policy, config = CONFIG) {
+    const args = buildBaseArgs(input, config);
+    push(args, "--paths", `home:${policy.outputRoot}`);
+    push(args, "--paths", `temp:${policy.tempRoot}`);
+    push(args, "--output", policy.outputTemplate);
+    args.push(policy.allowOverwrite ? "--force-overwrites" : "--no-overwrites");
+    args.push("--newline", "--progress");
+    push(args, "--print", "after_move:filepath");
+    appendSelectionArgs(args, input, policy, config);
+    appendDownloadArgs(args, input);
+    appendFormatArgs(args, input);
+    appendSubtitleArgs(args, input);
+    appendThumbnailArgs(args, input);
+    appendPostprocessArgs(args, input);
+    appendSponsorBlockArgs(args, input);
+    appendExtractorArgs(args, input);
+    if (input.kind === "audio" && !input.postprocess.extractAudio) {
+        args.push("--extract-audio");
+    }
+    if (input.kind === "subtitles") {
+        args.push("--skip-download");
+        if (!input.subtitles.writeSubs && !input.subtitles.writeAutoSubs)
+            args.push("--write-subs");
+    }
+    if (input.kind === "thumbnail") {
+        args.push("--skip-download");
+        if (!input.thumbnails.writeThumbnail && !input.thumbnails.writeAllThumbnails)
+            args.push("--write-thumbnail");
+    }
+    if (input.kind === "playlist" && !input.selection.noPlaylist)
+        args.push("--yes-playlist");
+    args.push(input.url);
+    return args;
+}
+function buildInspectBaseArgs(input, config) {
+    const args = buildBaseArgs(input, config);
+    if (input.flatPlaylist)
+        args.push("--flat-playlist");
+    return args;
+}
+function buildBaseArgs(input, config) {
+    const args = ["--ignore-config", "--no-warnings"];
+    appendNetworkArgs(args, input.network);
+    appendAuthArgs(args, input.auth, config);
+    return args;
+}
+function appendNetworkArgs(args, network) {
+    push(args, "--proxy", network.proxy);
+    if (network.socketTimeout !== undefined)
+        push(args, "--socket-timeout", String(network.socketTimeout));
+    push(args, "--source-address", network.sourceAddress);
+    push(args, "--impersonate", network.impersonate);
+    push(args, "--geo-verification-proxy", network.geoVerificationProxy);
+    push(args, "--xff", network.xff);
+    if (network.forceIpv4)
+        args.push("--force-ipv4");
+    if (network.forceIpv6)
+        args.push("--force-ipv6");
+}
+function appendAuthArgs(args, auth, config) {
+    push(args, "--username", auth.username);
+    push(args, "--password", auth.password);
+    push(args, "--twofactor", auth.twofactor);
+    if (auth.netrc) {
+        requireConfigFilePolicy("auth.netrc", config);
+        args.push("--netrc");
+    }
+    if (auth.netrcLocation)
+        requireConfigFilePolicy("auth.netrcLocation", config);
+    if (auth.netrcCmd)
+        requireConfigFilePolicy("auth.netrcCmd", config);
+    push(args, "--netrc-location", auth.netrcLocation);
+    push(args, "--netrc-cmd", auth.netrcCmd);
+    push(args, "--video-password", auth.videoPassword);
+    push(args, "--cookies", configuredOrAllowed(auth.cookiesFile, config.cookiesFile, "auth.cookiesFile", config));
+    push(args, "--cookies-from-browser", configuredOrAllowed(auth.cookiesFromBrowser, config.cookiesFromBrowser, "auth.cookiesFromBrowser", config));
+}
+function appendSelectionArgs(args, input, policy, config) {
+    const selection = input.selection;
+    push(args, "--playlist-items", selection.playlistItems);
+    if (selection.noPlaylist)
+        args.push("--no-playlist");
+    if (selection.yesPlaylist)
+        args.push("--yes-playlist");
+    push(args, "--min-filesize", selection.minFilesize);
+    push(args, "--max-filesize", selection.maxFilesize);
+    push(args, "--date", selection.date);
+    push(args, "--datebefore", selection.dateBefore);
+    push(args, "--dateafter", selection.dateAfter);
+    pushRepeated(args, "--match-filters", selection.matchFilters);
+    pushRepeated(args, "--break-match-filters", selection.breakMatchFilters);
+    if (selection.ageLimit !== undefined)
+        push(args, "--age-limit", String(selection.ageLimit));
+    push(args, "--download-archive", selection.downloadArchive ? resolveManagedPath(policy.outputRoot, selection.downloadArchive, "downloadArchive", config.allowArbitraryOutputPaths) : undefined);
+    if (selection.maxDownloads !== undefined)
+        push(args, "--max-downloads", String(selection.maxDownloads));
+    if (selection.breakOnExisting)
+        args.push("--break-on-existing");
+    if (selection.breakPerInput)
+        args.push("--break-per-input");
+    if (selection.skipPlaylistAfterErrors !== undefined)
+        push(args, "--skip-playlist-after-errors", String(selection.skipPlaylistAfterErrors));
+}
+function configuredOrAllowed(inputValue, configuredValue, label, config) {
+    if (inputValue !== undefined && inputValue !== configuredValue)
+        requireConfigFilePolicy(label, config);
+    return inputValue ?? configuredValue;
+}
+function requireConfigFilePolicy(label, config) {
+    if (!config.allowConfigFiles)
+        throw new Error(`${label} requires YTDLP_MCP_ALLOW_CONFIG_FILES=true or a matching server-level environment setting`);
+}
+function appendDownloadArgs(args, input) {
+    const download = input.download;
+    if (download.concurrentFragments !== undefined)
+        push(args, "--concurrent-fragments", String(download.concurrentFragments));
+    push(args, "--limit-rate", download.limitRate);
+    push(args, "--throttled-rate", download.throttledRate);
+    push(args, "--retries", download.retries);
+    push(args, "--file-access-retries", download.fileAccessRetries);
+    push(args, "--fragment-retries", download.fragmentRetries);
+    pushRepeated(args, "--retry-sleep", download.retrySleep);
+    if (download.keepFragments)
+        args.push("--keep-fragments");
+    push(args, "--buffer-size", download.bufferSize);
+    push(args, "--http-chunk-size", download.httpChunkSize);
+    if (download.playlistRandom)
+        args.push("--playlist-random");
+    if (download.lazyPlaylist)
+        args.push("--lazy-playlist");
+    if (download.hlsUseMpegts)
+        args.push("--hls-use-mpegts");
+    pushRepeated(args, "--download-sections", download.downloadSections);
+    pushRepeated(args, "--downloader", download.downloader);
+    pushRepeated(args, "--downloader-args", download.downloaderArgs);
+}
+function appendFormatArgs(args, input) {
+    const format = input.format;
+    push(args, "--format", format.format);
+    pushRepeated(args, "--format-sort", format.formatSort);
+    if (format.formatSortReset)
+        args.push("--format-sort-reset");
+    if (format.formatSortForce)
+        args.push("--format-sort-force");
+    if (format.videoMultistreams)
+        args.push("--video-multistreams");
+    if (format.audioMultistreams)
+        args.push("--audio-multistreams");
+    if (format.preferFreeFormats)
+        args.push("--prefer-free-formats");
+    if (format.checkFormats)
+        args.push("--check-formats");
+    if (format.checkAllFormats)
+        args.push("--check-all-formats");
+    push(args, "--merge-output-format", format.mergeOutputFormat);
+}
+function appendSubtitleArgs(args, input) {
+    const subtitles = input.subtitles;
+    if (subtitles.writeSubs)
+        args.push("--write-subs");
+    if (subtitles.writeAutoSubs)
+        args.push("--write-auto-subs");
+    push(args, "--sub-format", subtitles.subFormat);
+    push(args, "--sub-langs", subtitles.subLangs);
+    push(args, "--convert-subs", subtitles.convertSubs);
+}
+function appendThumbnailArgs(args, input) {
+    const thumbnails = input.thumbnails;
+    if (thumbnails.writeThumbnail)
+        args.push("--write-thumbnail");
+    if (thumbnails.writeAllThumbnails)
+        args.push("--write-all-thumbnails");
+    push(args, "--convert-thumbnails", thumbnails.convertThumbnails);
+}
+function appendPostprocessArgs(args, input) {
+    const postprocess = input.postprocess;
+    if (postprocess.extractAudio)
+        args.push("--extract-audio");
+    push(args, "--audio-format", postprocess.audioFormat);
+    push(args, "--audio-quality", postprocess.audioQuality);
+    push(args, "--remux-video", postprocess.remuxVideo);
+    push(args, "--recode-video", postprocess.recodeVideo);
+    pushRepeated(args, "--postprocessor-args", postprocess.postprocessorArgs);
+    if (postprocess.keepVideo)
+        args.push("--keep-video");
+    if (postprocess.postOverwrites)
+        args.push("--post-overwrites");
+    if (postprocess.embedSubs)
+        args.push("--embed-subs");
+    if (postprocess.embedThumbnail)
+        args.push("--embed-thumbnail");
+    if (postprocess.embedMetadata)
+        args.push("--embed-metadata");
+    if (postprocess.embedChapters)
+        args.push("--embed-chapters");
+    if (postprocess.embedInfoJson)
+        args.push("--embed-info-json");
+    pushRepeated(args, "--parse-metadata", postprocess.parseMetadata);
+    pushRepeated(args, "--replace-in-metadata", postprocess.replaceInMetadata);
+    if (postprocess.xattrs)
+        args.push("--xattrs");
+    push(args, "--concat-playlist", postprocess.concatPlaylist);
+    push(args, "--fixup", postprocess.fixup);
+    if (postprocess.splitChapters)
+        args.push("--split-chapters");
+    pushRepeated(args, "--remove-chapters", postprocess.removeChapters);
+    if (postprocess.forceKeyframesAtCuts)
+        args.push("--force-keyframes-at-cuts");
+    pushRepeated(args, "--use-postprocessor", postprocess.usePostprocessor);
+}
+function appendSponsorBlockArgs(args, input) {
+    push(args, "--sponsorblock-mark", input.sponsorblock.mark);
+    push(args, "--sponsorblock-remove", input.sponsorblock.remove);
+    push(args, "--sponsorblock-chapter-title", input.sponsorblock.chapterTitle);
+    push(args, "--sponsorblock-api", input.sponsorblock.api);
+}
+function appendExtractorArgs(args, input) {
+    const extractor = input.extractor;
+    push(args, "--extractor-retries", extractor.extractorRetries);
+    if (extractor.allowDynamicMpd)
+        args.push("--allow-dynamic-mpd");
+    if (extractor.hlsSplitDiscontinuity)
+        args.push("--hls-split-discontinuity");
+    pushRepeated(args, "--extractor-args", extractor.extractorArgs);
+    const youtube = extractor.youtube;
+    if (!youtube)
+        return;
+    push(args, "--extractor-args", keyed("youtube", "lang", youtube.lang));
+    push(args, "--extractor-args", keyed("youtube", "comment_sort", youtube.commentSort));
+    push(args, "--extractor-args", keyed("youtube", "max_comments", youtube.maxComments));
+    push(args, "--extractor-args", keyed("youtube", "fetch_pot", youtube.fetchPot));
+    pushJoined(args, "youtube", "skip", youtube.skip);
+    pushJoined(args, "youtube", "player_client", youtube.playerClient);
+    pushJoined(args, "youtube", "formats", youtube.formats);
+    pushJoined(args, "youtube", "po_token", youtube.poToken);
+}
+function keyed(namespace, key, value) {
+    return value ? `${namespace}:${key}=${value}` : undefined;
+}
+function pushJoined(args, namespace, key, values) {
+    if (values.length > 0)
+        push(args, "--extractor-args", `${namespace}:${key}=${values.join(",")}`);
+}
+function push(args, flag, value) {
+    if (value !== undefined && value !== "")
+        args.push(flag, value);
+}
+function pushRepeated(args, flag, values) {
+    for (const value of values)
+        push(args, flag, value);
+}
+//# sourceMappingURL=argv.js.map

package/dist/argv.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,20 @@
+export interface ServerConfig {
+    ytdlpPath: string;
+    ffmpegPath?: string | undefined;
+    ffprobePath?: string | undefined;
+    outputRoot: string;
+    tempRoot: string;
+    allowArbitraryOutputPaths: boolean;
+    allowConfigFiles: boolean;
+    allowPluginDirs: boolean;
+    enableExpertMode: boolean;
+    defaultTimeoutMs: number;
+    maxOutputBytes: number;
+    cookiesFile?: string | undefined;
+    cookiesFromBrowser?: string | undefined;
+    jsRuntimes: string[];
+}
+export declare function expandHome(input: string): string;
+export declare function loadConfig(env?: NodeJS.ProcessEnv): ServerConfig;
+export declare const CONFIG: ServerConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB,EAAE,OAAO,CAAC;IACnC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAWD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,YAAY,CAiB7E;AAED,eAAO,MAAM,MAAM,cAAe,CAAC"}

package/dist/config.js

@@ -0,0 +1,36 @@
+import os from "node:os";
+import path from "node:path";
+function bool(value) {
+    return value ? ["1", "true", "yes", "on"].includes(value.toLowerCase()) : false;
+}
+function int(value, fallback) {
+    const parsed = value ? Number.parseInt(value, 10) : Number.NaN;
+    return Number.isFinite(parsed) ? parsed : fallback;
+}
+export function expandHome(input) {
+    if (input === "~")
+        return os.homedir();
+    if (input.startsWith("~/") || input.startsWith("~\\"))
+        return path.join(os.homedir(), input.slice(2));
+    return input;
+}
+export function loadConfig(env = process.env) {
+    return {
+        ytdlpPath: env.YTDLP_MCP_YTDLP_PATH ?? env.YTDLP_PATH ?? "yt-dlp",
+        ffmpegPath: env.YTDLP_MCP_FFMPEG_PATH ?? env.FFMPEG_PATH,
+        ffprobePath: env.YTDLP_MCP_FFPROBE_PATH ?? env.FFPROBE_PATH,
+        outputRoot: path.resolve(expandHome(env.YTDLP_MCP_OUTPUT_ROOT ?? path.join(os.homedir(), "Downloads", "yt-dlp-mcp"))),
+        tempRoot: path.resolve(expandHome(env.YTDLP_MCP_TEMP_ROOT ?? path.join(os.tmpdir(), "yt-dlp-mcp"))),
+        allowArbitraryOutputPaths: bool(env.YTDLP_MCP_ALLOW_ARBITRARY_OUTPUT_PATHS),
+        allowConfigFiles: bool(env.YTDLP_MCP_ALLOW_CONFIG_FILES),
+        allowPluginDirs: bool(env.YTDLP_MCP_ALLOW_PLUGIN_DIRS),
+        enableExpertMode: bool(env.YTDLP_MCP_ENABLE_EXPERT),
+        defaultTimeoutMs: int(env.YTDLP_MCP_TIMEOUT_MS, 15 * 60 * 1000),
+        maxOutputBytes: int(env.YTDLP_MCP_MAX_OUTPUT_BYTES, 4 * 1024 * 1024),
+        cookiesFile: env.YTDLP_MCP_COOKIES_FILE,
+        cookiesFromBrowser: env.YTDLP_MCP_COOKIES_FROM_BROWSER,
+        jsRuntimes: (env.YTDLP_MCP_JS_RUNTIMES ?? "deno,node,bun,quickjs").split(",").map((v) => v.trim()).filter(Boolean)
+    };
+}
+export const CONFIG = loadConfig();
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAmB7B,SAAS,IAAI,CAAC,KAAyB;IACrC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAClF,CAAC;AAED,SAAS,GAAG,CAAC,KAAyB,EAAE,QAAgB;IACtD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;IAC/D,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,IAAI,KAAK,KAAK,GAAG;QAAE,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC;IACvC,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACtG,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC7D,OAAO;QACL,SAAS,EAAE,GAAG,CAAC,oBAAoB,IAAI,GAAG,CAAC,UAAU,IAAI,QAAQ;QACjE,UAAU,EAAE,GAAG,CAAC,qBAAqB,IAAI,GAAG,CAAC,WAAW;QACxD,WAAW,EAAE,GAAG,CAAC,sBAAsB,IAAI,GAAG,CAAC,YAAY;QAC3D,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,qBAAqB,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC;QACrH,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,mBAAmB,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;QACnG,yBAAyB,EAAE,IAAI,CAAC,GAAG,CAAC,sCAAsC,CAAC;QAC3E,gBAAgB,EAAE,IAAI,CAAC,GAAG,CAAC,4BAA4B,CAAC;QACxD,eAAe,EAAE,IAAI,CAAC,GAAG,CAAC,2BAA2B,CAAC;QACtD,gBAAgB,EAAE,IAAI,CAAC,GAAG,CAAC,uBAAuB,CAAC;QACnD,gBAAgB,EAAE,GAAG,CAAC,GAAG,CAAC,oBAAoB,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAC/D,cAAc,EAAE,GAAG,CAAC,GAAG,CAAC,0BAA0B,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;QACpE,WAAW,EAAE,GAAG,CAAC,sBAAsB;QACvC,kBAAkB,EAAE,GAAG,CAAC,8BAA8B;QACtD,UAAU,EAAE,CAAC,GAAG,CAAC,qBAAqB,IAAI,uBAAuB,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;KACnH,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC"}

package/dist/environment.d.ts

@@ -0,0 +1,27 @@
+import { type ServerConfig } from "./config.js";
+import type { DetectedDependency } from "./types.js";
+export interface EnvironmentReport {
+    platform: NodeJS.Platform;
+    arch: string;
+    node: {
+        version: string;
+        execPath: string;
+    };
+    dependencies: DetectedDependency[];
+    cookies: {
+        fileConfigured: boolean;
+        fileExists?: boolean;
+        browserConfigured: boolean;
+        browser?: string;
+    };
+    policy: {
+        outputRoot: string;
+        tempRoot: string;
+        allowArbitraryOutputPaths: boolean;
+        allowConfigFiles: boolean;
+        allowPluginDirs: boolean;
+        enableExpertMode: boolean;
+    };
+}
+export declare function checkEnvironment(config?: ServerConfig): Promise<EnvironmentReport>;
+//# sourceMappingURL=environment.d.ts.map

package/dist/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../src/environment.ts"],"names":[],"mappings":"AAEA,OAAO,EAAU,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAExD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,YAAY,EAAE,kBAAkB,EAAE,CAAC;IACnC,OAAO,EAAE;QACP,cAAc,EAAE,OAAO,CAAC;QACxB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,iBAAiB,EAAE,OAAO,CAAC;QAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,MAAM,EAAE;QACN,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,yBAAyB,EAAE,OAAO,CAAC;QACnC,gBAAgB,EAAE,OAAO,CAAC;QAC1B,eAAe,EAAE,OAAO,CAAC;QACzB,gBAAgB,EAAE,OAAO,CAAC;KAC3B,CAAC;CACH;AAED,wBAAsB,gBAAgB,CAAC,MAAM,GAAE,YAAqB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAiChG"}

package/dist/environment.js

@@ -0,0 +1,80 @@
+import fs from "node:fs";
+import os from "node:os";
+import { CONFIG } from "./config.js";
+import { runCommand } from "./runner.js";
+export async function checkEnvironment(config = CONFIG) {
+    const dependencies = await Promise.all([
+        detectBinary("yt-dlp", config.ytdlpPath, ["--version"], ["all yt-dlp operations"], true, config),
+        detectBinary("ffmpeg", config.ffmpegPath ?? "ffmpeg", ["-version"], ["merge", "remux", "recode", "extract audio", "embed assets"], false, config),
+        detectBinary("ffprobe", config.ffprobePath ?? "ffprobe", ["-version"], ["audio extraction", "media probing"], false, config),
+        detectBinary("deno", "deno", ["--version"], ["yt-dlp JavaScript challenges"], false, config),
+        detectBinary("node", process.execPath, ["--version"], ["yt-dlp JavaScript challenges"], false, config),
+        detectBinary("bun", "bun", ["--version"], ["yt-dlp JavaScript challenges"], false, config),
+        detectBinary("qjs", "qjs", ["--version"], ["yt-dlp JavaScript challenges"], false, config),
+        detectBinary("AtomicParsley", "AtomicParsley", ["--version"], ["legacy thumbnail embedding"], false, config),
+        detectBinary("aria2c", "aria2c", ["--version"], ["external downloader"], false, config),
+        detectBinary("curl", "curl", ["--version"], ["external downloader"], false, config),
+        detectBinary("wget", "wget", ["--version"], ["external downloader"], false, config)
+    ]);
+    return {
+        platform: process.platform,
+        arch: os.arch(),
+        node: {
+            version: process.version,
+            execPath: process.execPath
+        },
+        dependencies,
+        cookies: cookieStatus(config),
+        policy: {
+            outputRoot: config.outputRoot,
+            tempRoot: config.tempRoot,
+            allowArbitraryOutputPaths: config.allowArbitraryOutputPaths,
+            allowConfigFiles: config.allowConfigFiles,
+            allowPluginDirs: config.allowPluginDirs,
+            enableExpertMode: config.enableExpertMode
+        }
+    };
+}
+async function detectBinary(name, command, args, requiredFor, required, config) {
+    try {
+        const result = await runCommand(command, args, {
+            timeoutMs: Math.min(config.defaultTimeoutMs, 10_000),
+            maxOutputBytes: 64 * 1024
+        });
+        return {
+            name,
+            status: "available",
+            command,
+            version: firstLine(result.stdout || result.stderr),
+            requiredFor,
+            notes: required ? [] : ["Optional dependency; required only for matching workflows."]
+        };
+    }
+    catch (error) {
+        return {
+            name,
+            status: "missing",
+            command,
+            requiredFor,
+            notes: [required ? "Required dependency is not available." : "Optional dependency is not available.", error instanceof Error ? error.message : String(error)]
+        };
+    }
+}
+function cookieStatus(config) {
+    const status = {
+        fileConfigured: Boolean(config.cookiesFile),
+        browserConfigured: Boolean(config.cookiesFromBrowser)
+    };
+    if (config.cookiesFile)
+        status.fileExists = fs.existsSync(config.cookiesFile);
+    if (config.cookiesFromBrowser) {
+        const browser = config.cookiesFromBrowser.split(":")[0];
+        if (browser)
+            status.browser = browser;
+    }
+    return status;
+}
+function firstLine(value) {
+    return value.split(/\r?\n/).map((line) => line.trim()).find(Boolean) ?? "";
+}
+//# sourceMappingURL=environment.js.map

package/dist/environment.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,3 @@
+import type { StructuredError } from "./types.js";
+export declare function toStructuredError(error: unknown): StructuredError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAmCjE"}

package/dist/errors.js

@@ -0,0 +1,73 @@
+import { classifyYtDlpStderr, errorKindMetadata, extractLastError } from "ytdlp-errors";
+import { excerpt } from "./redaction.js";
+import { CommandExecutionError } from "./runner.js";
+export function toStructuredError(error) {
+    if (error instanceof CommandExecutionError) {
+        const stderr = error.result.stderr || error.result.stdout || error.message;
+        const classified = classifyYtDlpStderr(stderr);
+        const kind = inferUnsupportedUrl(stderr) ? "unsupportedUrl" : classified.kind;
+        const metadata = errorKindMetadata(kind);
+        const structured = {
+            kind,
+            message: extractLastError(stderr) || error.message,
+            retryable: metadata.recoverable,
+            exitCode: error.result.exitCode,
+            stderrExcerpt: excerpt(stderr),
+            suggestedFixes: suggestedFixes(kind, metadata.suggestedFlags)
+        };
+        const dependency = inferDependency(stderr);
+        if (dependency)
+            structured.dependency = dependency;
+        return structured;
+    }
+    if (error instanceof Error) {
+        return {
+            kind: "internal",
+            message: error.message,
+            retryable: false,
+            stderrExcerpt: excerpt(error.stack ?? error.message),
+            suggestedFixes: []
+        };
+    }
+    return {
+        kind: "internal",
+        message: String(error),
+        retryable: false,
+        suggestedFixes: []
+    };
+}
+function inferDependency(text) {
+    if (/ffmpeg/i.test(text))
+        return "ffmpeg";
+    if (/ffprobe/i.test(text))
+        return "ffprobe";
+    if (/atomicparsley/i.test(text))
+        return "AtomicParsley";
+    if (/aria2c/i.test(text))
+        return "aria2c";
+    if (/curl_cffi|impersonat/i.test(text))
+        return "curl_cffi";
+    if (/deno|node|bun|quickjs|javascript/i.test(text))
+        return "js-runtime";
+    return undefined;
+}
+function inferUnsupportedUrl(text) {
+    return /unsupported url|no suitable extractor|not a valid URL/i.test(text);
+}
+function suggestedFixes(kind, flags) {
+    const fixes = new Set();
+    for (const flag of flags ?? [])
+        fixes.add(`Consider ${flag} when appropriate.`);
+    if (kind === "missingDependency")
+        fixes.add("Install the missing dependency or configure its path with the matching server environment variable.");
+    if (kind === "botBlock" || kind === "loginRequired" || kind === "ageRestricted")
+        fixes.add("Provide cookies via a cookies file or cookies-from-browser configuration.");
+    if (kind === "rateLimit")
+        fixes.add("Retry later or add conservative sleep/retry settings.");
+    if (kind === "geoBlocked")
+        fixes.add("Use an allowed region, proxy, or yt-dlp geo-bypass option where legal.");
+    if (kind === "outOfDiskSpace")
+        fixes.add("Free disk space or choose a different output root.");
+    return [...fixes];
+}
+//# sourceMappingURL=errors.js.map