@lunarity/nebula-fetch-cli 0.0.2 → 0.0.3

package/README.md

@@ -1 +1,56 @@
-# nebula-fetch-cli
+# Nebula Fetch CLI
+
+A command-line interface tool for downloading media from different platforms.
+
+## 🚀 Installation
+
+```bash
+npm install -g @lunarity/nebula-fetch-cli
+```
+
+## 📖 Usage
+
+### 📺 YouTube Downloads
+
+Download videos or audio from YouTube using the following commands:
+
+```bash
+# Download video (default)
+nebula-fetch youtube <url>
+# or using alias
+nebula-fetch yt <url>
+
+# Download audio only
+nebula-fetch youtube <url> --audio
+# or
+nebula-fetch yt <url> -a
+
+# Specify output path
+nebula-fetch youtube <url> --output path/to/file
+# or
+nebula-fetch yt <url> -o path/to/file
+
+# Show verbose output
+nebula-fetch youtube <url> --verbose
+# or
+nebula-fetch yt <url> -v
+```
+
+### ⚙️ Options
+
+- `-o, --output <path>` - Specify the output path for the downloaded file
+- `-a, --audio` - Download audio only (saves as .mp3)
+- `-v, --verbose` - Show detailed information during download
+- `--version` - Show version number
+- `--help` - Show help information
+
+## ✨ Features
+
+- YouTube video downloads
+- Audio-only extraction option
+- Custom output path
+- Verbose mode for detailed information
+
+## 📄 License
+
+MIT

package/commands/youtube.ts

@@ -4,36 +4,48 @@ import path from "path";
 import { YtdlCore, toPipeableStream } from "@ybd-project/ytdl-core";
 import chalk from "chalk";
 
-export async function downloadYoutubeAudio(
-  url: string,
-  outputPath?: string
-): Promise<void> {
-  try {
-    if (!url) {
-      throw new Error("Please provide a YouTube URL");
-    }
+interface DownloadOptions {
+  url: string;
+  audioOnly?: boolean;
+  verbose?: boolean;
+  outputPath?: string;
+}
 
+export async function downloadYoutube(options: DownloadOptions): Promise<void> {
+  const { url, audioOnly = false, verbose = false, outputPath } = options;
+
+  try {
     console.log(chalk.cyan("🔍 Fetching video information..."));
     const ytdl = new YtdlCore({});
     let videoTitle = "";
 
     await ytdl.getBasicInfo(url).then((info) => {
+      console.log(chalk.cyan(`🎬 Video title: ${info.videoDetails.title}`));
+      console.log(
+        chalk.cyan(
+          `🎬 Video author: ${info.videoDetails.author?.name || "Unknown"}`
+        )
+      );
+      if (verbose) {
+        console.log(JSON.stringify(info.videoDetails, null, 2));
+      }
       videoTitle = info.videoDetails.title.replace(/[^\w\s]/gi, "_");
     });
 
     const stream = await ytdl.download(url, {
-      filter: "audioonly",
+      filter: audioOnly ? "audioonly" : "videoandaudio",
+      quality: "highest",
     });
 
     const outputFilePath =
-      outputPath || path.join(process.cwd(), `${videoTitle}.mp3`);
+      outputPath ||
+      path.join(process.cwd(), `${videoTitle}.${audioOnly ? "mp3" : "mp4"}`);
     toPipeableStream(stream).pipe(fs.createWriteStream(outputFilePath));
 
-    console.log(chalk.green(`✅ Download finished: ${outputFilePath}`));
+    console.log(chalk.green.bold(`✅ Download finished: ${outputFilePath}`));
   } catch (error) {
     if (error instanceof Error) {
-      console.error(chalk.red("Error:", error.message));
+      console.error(chalk.red.bold("❌ Error:", error.message));
     }
-    throw error;
   }
 }

package/dist/index.js

@@ -2928,22 +2928,22 @@ var require_diagnostics = __commonJS((exports, module) => {
     const debuglog = fetchDebuglog.enabled ? fetchDebuglog : undiciDebugLog;
     diagnosticsChannel.channel("undici:client:beforeConnect").subscribe((evt) => {
       const {
-        connectParams: { version, protocol, port, host }
+        connectParams: { version: version2, protocol, port, host }
       } = evt;
-      debuglog("connecting to %s using %s%s", `${host}${port ? `:${port}` : ""}`, protocol, version);
+      debuglog("connecting to %s using %s%s", `${host}${port ? `:${port}` : ""}`, protocol, version2);
     });
     diagnosticsChannel.channel("undici:client:connected").subscribe((evt) => {
       const {
-        connectParams: { version, protocol, port, host }
+        connectParams: { version: version2, protocol, port, host }
       } = evt;
-      debuglog("connected to %s using %s%s", `${host}${port ? `:${port}` : ""}`, protocol, version);
+      debuglog("connected to %s using %s%s", `${host}${port ? `:${port}` : ""}`, protocol, version2);
     });
     diagnosticsChannel.channel("undici:client:connectError").subscribe((evt) => {
       const {
-        connectParams: { version, protocol, port, host },
+        connectParams: { version: version2, protocol, port, host },
         error
       } = evt;
-      debuglog("connection to %s using %s%s errored - %s", `${host}${port ? `:${port}` : ""}`, protocol, version, error.message);
+      debuglog("connection to %s using %s%s errored - %s", `${host}${port ? `:${port}` : ""}`, protocol, version2, error.message);
     });
     diagnosticsChannel.channel("undici:client:sendHeaders").subscribe((evt) => {
       const {
@@ -2978,22 +2978,22 @@ var require_diagnostics = __commonJS((exports, module) => {
       const debuglog = undiciDebugLog.enabled ? undiciDebugLog : websocketDebuglog;
       diagnosticsChannel.channel("undici:client:beforeConnect").subscribe((evt) => {
         const {
-          connectParams: { version, protocol, port, host }
+          connectParams: { version: version2, protocol, port, host }
         } = evt;
-        debuglog("connecting to %s%s using %s%s", host, port ? `:${port}` : "", protocol, version);
+        debuglog("connecting to %s%s using %s%s", host, port ? `:${port}` : "", protocol, version2);
       });
       diagnosticsChannel.channel("undici:client:connected").subscribe((evt) => {
         const {
-          connectParams: { version, protocol, port, host }
+          connectParams: { version: version2, protocol, port, host }
         } = evt;
-        debuglog("connected to %s%s using %s%s", host, port ? `:${port}` : "", protocol, version);
+        debuglog("connected to %s%s using %s%s", host, port ? `:${port}` : "", protocol, version2);
       });
       diagnosticsChannel.channel("undici:client:connectError").subscribe((evt) => {
         const {
-          connectParams: { version, protocol, port, host },
+          connectParams: { version: version2, protocol, port, host },
           error
         } = evt;
-        debuglog("connection to %s%s using %s%s errored - %s", host, port ? `:${port}` : "", protocol, version, error.message);
+        debuglog("connection to %s%s using %s%s errored - %s", host, port ? `:${port}` : "", protocol, version2, error.message);
       });
       diagnosticsChannel.channel("undici:client:sendHeaders").subscribe((evt) => {
         const {
@@ -25208,10 +25208,10 @@ var require_acorn = __commonJS((exports, module) => {
       }
       return this.finishToken(type, word);
     };
-    var version = "8.14.0";
+    var version2 = "8.14.0";
     Parser.acorn = {
       Parser,
-      version,
+      version: version2,
       defaultOptions,
       Position,
       SourceLocation,
@@ -25260,7 +25260,7 @@ var require_acorn = __commonJS((exports, module) => {
     exports2.tokContexts = types;
     exports2.tokTypes = types$1;
     exports2.tokenizer = tokenizer;
-    exports2.version = version;
+    exports2.version = version2;
   });
 });
 
@@ -50243,7 +50243,7 @@ var require_nwsapi = __commonJS((exports, module) => {
       global2.NW.Dom = factory(global2, Export);
     }
   })(exports, function Factory(global2, Export) {
-    var version = "nwsapi-2.2.16", doc = global2.document, root = doc.documentElement, slice = Array.prototype.slice, HSP = "[\\x20\\t]", VSP = "[\\r\\n\\f]", WSP = "[\\x20\\t\\r\\n\\f]", CFG = {
+    var version2 = "nwsapi-2.2.16", doc = global2.document, root = doc.documentElement, slice = Array.prototype.slice, HSP = "[\\x20\\t]", VSP = "[\\r\\n\\f]", WSP = "[\\x20\\t\\r\\n\\f]", CFG = {
       operators: "[~*^$|]=|=",
       combinators: "[\\x20\\t>+~](?=[^>+~])"
     }, NOT = {
@@ -51490,7 +51490,7 @@ var require_nwsapi = __commonJS((exports, module) => {
       emit,
       Config,
       Snapshot,
-      Version: version,
+      Version: version2,
       install,
       uninstall,
       Operators,
@@ -55018,9 +55018,9 @@ var require_saxes = __commonJS((exports) => {
         }
       }
     }
-    setXMLVersion(version) {
-      this.currentXMLVersion = version;
-      if (version === "1.0") {
+    setXMLVersion(version2) {
+      this.currentXMLVersion = version2;
+      if (version2 === "1.0") {
         this.isChar = isChar10;
         this.getCode = this.getCode10;
       } else {
@@ -55491,12 +55491,12 @@ var require_saxes = __commonJS((exports) => {
       switch (this.name) {
         case "version": {
           this.xmlDeclExpects = ["encoding", "standalone"];
-          const version = value;
-          this.xmlDecl.version = version;
-          if (!/^1\.[0-9]+$/.test(version)) {
+          const version2 = value;
+          this.xmlDecl.version = version2;
+          if (!/^1\.[0-9]+$/.test(version2)) {
             this.fail("version number must match /^1\\.[0-9]+$/.");
           } else if (!this.opt.forceXMLVersion) {
-            this.setXMLVersion(version);
+            this.setXMLVersion(version2);
           }
           break;
         }
@@ -125844,10 +125844,10 @@ var require_supports_color = __commonJS((exports, module) => {
       return 3;
     }
     if ("TERM_PROGRAM" in env2) {
-      const version = parseInt((env2.TERM_PROGRAM_VERSION || "").split(".")[0], 10);
+      const version2 = parseInt((env2.TERM_PROGRAM_VERSION || "").split(".")[0], 10);
       switch (env2.TERM_PROGRAM) {
         case "iTerm.app":
-          return version >= 3 ? 3 : 2;
+          return version2 >= 3 ? 3 : 2;
         case "Apple_Terminal":
           return 2;
       }
@@ -140758,7 +140758,7 @@ var require_websocket_server = __commonJS((exports, module) => {
       socket.on("error", socketOnError);
       const key = req.headers["sec-websocket-key"];
       const upgrade = req.headers.upgrade;
-      const version = +req.headers["sec-websocket-version"];
+      const version2 = +req.headers["sec-websocket-version"];
       if (req.method !== "GET") {
         const message = "Invalid HTTP method";
         abortHandshakeOrEmitwsClientError(this, req, socket, 405, message);
@@ -140774,7 +140774,7 @@ var require_websocket_server = __commonJS((exports, module) => {
         abortHandshakeOrEmitwsClientError(this, req, socket, 400, message);
         return;
       }
-      if (version !== 8 && version !== 13) {
+      if (version2 !== 8 && version2 !== 13) {
         const message = "Missing or invalid Sec-WebSocket-Version header";
         abortHandshakeOrEmitwsClientError(this, req, socket, 400, message);
         return;
@@ -140812,7 +140812,7 @@ var require_websocket_server = __commonJS((exports, module) => {
       }
       if (this.options.verifyClient) {
         const info = {
-          origin: req.headers[`${version === 8 ? "sec-websocket-origin" : "origin"}`],
+          origin: req.headers[`${version2 === 8 ? "sec-websocket-origin" : "origin"}`],
           secure: !!(req.socket.authorized || req.socket.encrypted),
           req
         };
@@ -151183,6 +151183,8 @@ var {
   Option,
   Help
 } = import__.default;
+// package.json
+var version = "0.0.3";
 
 // node_modules/chalk/source/vendor/ansi-styles/index.js
 var ANSI_BACKGROUND_OFFSET = 10;
@@ -151453,10 +151455,10 @@ function _supportsColor(haveStream, { streamIsTTY, sniffFlags = true } = {}) {
     return 3;
   }
   if ("TERM_PROGRAM" in env) {
-    const version = Number.parseInt((env.TERM_PROGRAM_VERSION || "").split(".")[0], 10);
+    const version2 = Number.parseInt((env.TERM_PROGRAM_VERSION || "").split(".")[0], 10);
     switch (env.TERM_PROGRAM) {
       case "iTerm.app": {
-        return version >= 3 ? 3 : 2;
+        return version2 >= 3 ? 3 : 2;
       }
       case "Apple_Terminal": {
         return 2;
@@ -151668,41 +151670,86 @@ var source_default = chalk;
 var import_ytdl_core = __toESM(require_Default(), 1);
 import fs from "fs";
 import path from "path";
-async function downloadYoutubeAudio(url, outputPath) {
+async function downloadYoutube(options) {
+  const { url, audioOnly = false, verbose = false, outputPath } = options;
   try {
-    if (!url) {
-      throw new Error("Please provide a YouTube URL");
-    }
     console.log(source_default.cyan("\uD83D\uDD0D Fetching video information..."));
     const ytdl = new import_ytdl_core.YtdlCore({});
     let videoTitle = "";
     await ytdl.getBasicInfo(url).then((info) => {
+      console.log(source_default.cyan(`\uD83C\uDFAC Video title: ${info.videoDetails.title}`));
+      console.log(source_default.cyan(`\uD83C\uDFAC Video author: ${info.videoDetails.author?.name || "Unknown"}`));
+      if (verbose) {
+        console.log(JSON.stringify(info.videoDetails, null, 2));
+      }
       videoTitle = info.videoDetails.title.replace(/[^\w\s]/gi, "_");
     });
     const stream2 = await ytdl.download(url, {
-      filter: "audioonly"
+      filter: audioOnly ? "audioonly" : "videoandaudio",
+      quality: "highest"
     });
-    const outputFilePath = outputPath || path.join(process.cwd(), `${videoTitle}.mp3`);
+    const outputFilePath = outputPath || path.join(process.cwd(), `${videoTitle}.${audioOnly ? "mp3" : "mp4"}`);
     import_ytdl_core.toPipeableStream(stream2).pipe(fs.createWriteStream(outputFilePath));
-    console.log(source_default.green(`\u2705 Download finished: ${outputFilePath}`));
+    console.log(source_default.green.bold(`\u2705 Download finished: ${outputFilePath}`));
   } catch (error) {
     if (error instanceof Error) {
-      console.error(source_default.red("Error:", error.message));
+      console.error(source_default.red.bold("\u274C Error:", error.message));
+    }
+  }
+}
+
+// utils/validators.ts
+function isValidYoutubeUrl(url) {
+  try {
+    const urlObj = new URL(url);
+    const validDomains = [
+      "youtube.com",
+      "www.youtube.com",
+      "m.youtube.com",
+      "youtu.be"
+    ];
+    if (!validDomains.includes(urlObj.hostname)) {
+      return false;
     }
-    throw error;
+    if (urlObj.hostname === "youtu.be") {
+      return urlObj.pathname.length > 1;
+    }
+    if (urlObj.pathname === "/watch") {
+      const videoId = urlObj.searchParams.get("v");
+      return !!videoId && videoId.length === 11;
+    }
+    if (urlObj.pathname.startsWith("/embed/")) {
+      const videoId = urlObj.pathname.split("/")[2];
+      return !!videoId && videoId.length === 11;
+    }
+    return false;
+  } catch {
+    return false;
   }
 }
 
 // index.ts
 var program2 = new Command;
-program2.name("nebula-fetch").description("CLI tool for downloading media from different platforms").version("1.0.0");
-program2.command("youtube").description("Download a video from YouTube").argument("<url>", "URL of the video").option("-o, --output <path>", "Output path for the video").action(async (url, options) => {
+program2.name("nebula-fetch").description("CLI tool for downloading media from different platforms").version(version);
+program2.command("youtube").alias("yt").description("Download a video from YouTube").argument("<url>", "URL of the video").option("-o, --output <path>", "Output path for the video").option("-a, --audio", "Download only the audio", false).option("-v, --verbose", "Show verbose output", false).action(async (url, options) => {
   try {
-    console.log(source_default.blue(`Downloading video from: ${url}`));
-    await downloadYoutubeAudio(url, options.output);
+    if (!isValidYoutubeUrl(url)) {
+      console.error(source_default.red("Error: Invalid YouTube URL. Please provide a valid YouTube video URL"));
+      process.exit(1);
+    }
+    console.log(source_default.blue(`\uD83D\uDE80 Downloading ${options.audio ? "audio" : "video"} from: ${url}`));
+    await downloadYoutube({
+      url,
+      audioOnly: options.audio,
+      outputPath: options.output,
+      verbose: options.verbose
+    });
   } catch (error) {
     console.error(source_default.red("Error:"), error);
     process.exit(1);
   }
 });
-program2.parse();
+program2.parseAsync().catch((error) => {
+  console.error(source_default.red("Fatal error:"), error);
+  process.exit(1);
+});

package/index.ts

@@ -1,29 +1,57 @@
 #!/usr/bin/env node
 
 import { Command } from "commander";
+import { version } from "@/package.json";
+
 import chalk from "chalk";
-import { downloadYoutubeAudio } from "./commands/youtube";
+
+import { downloadYoutube } from "@/commands/youtube";
+import { isValidYoutubeUrl } from "./utils/validators";
 
 const program = new Command();
 
 program
   .name("nebula-fetch")
   .description("CLI tool for downloading media from different platforms")
-  .version("1.0.0");
+  .version(version);
 
 program
   .command("youtube")
+  .alias("yt")
   .description("Download a video from YouTube")
   .argument("<url>", "URL of the video")
   .option("-o, --output <path>", "Output path for the video")
+  .option("-a, --audio", "Download only the audio", false)
+  .option("-v, --verbose", "Show verbose output", false)
   .action(async (url, options) => {
     try {
-      console.log(chalk.blue(`Downloading video from: ${url}`));
-      await downloadYoutubeAudio(url, options.output);
+      if (!isValidYoutubeUrl(url)) {
+        console.error(
+          chalk.red(
+            "Error: Invalid YouTube URL. Please provide a valid YouTube video URL"
+          )
+        );
+        process.exit(1);
+      }
+
+      console.log(
+        chalk.blue(
+          `🚀 Downloading ${options.audio ? "audio" : "video"} from: ${url}`
+        )
+      );
+      await downloadYoutube({
+        url,
+        audioOnly: options.audio,
+        outputPath: options.output,
+        verbose: options.verbose,
+      });
     } catch (error) {
       console.error(chalk.red("Error:"), error);
       process.exit(1);
     }
   });
 
-program.parse();
+program.parseAsync().catch((error) => {
+  console.error(chalk.red("Fatal error:"), error);
+  process.exit(1);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunarity/nebula-fetch-cli",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "module": "index.ts",
   "description": "CLI tool for downloading media from different platforms",
   "type": "module",
@@ -27,6 +27,13 @@
   "keywords": [
     "cli",
     "media",
-    "download"
-  ]
+    "download",
+    "youtube"
+  ],
+  "author": "Krzysztof Oszczapiński",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/LUNARITYai/nebula-fetch-cli.git"
+  }
 }

package/tsconfig.json

@@ -22,6 +22,11 @@
     // Some stricter flags (disabled by default)
     "noUnusedLocals": false,
     "noUnusedParameters": false,
-    "noPropertyAccessFromIndexSignature": false
+    "noPropertyAccessFromIndexSignature": false,
+
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./*"]
+    }
   }
 }

package/utils/validators.ts

@@ -0,0 +1,45 @@
+/**
+ * Validates YouTube URLs in various formats:
+ * - Standard: https://www.youtube.com/watch?v=VIDEO_ID
+ * - Short: https://youtu.be/VIDEO_ID
+ * - Embedded: https://www.youtube.com/embed/VIDEO_ID
+ * - Mobile: https://m.youtube.com/watch?v=VIDEO_ID
+ * - With timestamps: https://www.youtube.com/watch?v=VIDEO_ID&t=123s
+ */
+export function isValidYoutubeUrl(url: string): boolean {
+  try {
+    const urlObj = new URL(url);
+
+    // Check for valid YouTube domains
+    const validDomains = [
+      "youtube.com",
+      "www.youtube.com",
+      "m.youtube.com",
+      "youtu.be",
+    ];
+    if (!validDomains.includes(urlObj.hostname)) {
+      return false;
+    }
+
+    // Handle youtu.be format
+    if (urlObj.hostname === "youtu.be") {
+      return urlObj.pathname.length > 1; // Must have video ID after /
+    }
+
+    // Handle standard YouTube URLs
+    if (urlObj.pathname === "/watch") {
+      const videoId = urlObj.searchParams.get("v");
+      return !!videoId && videoId.length === 11;
+    }
+
+    // Handle embedded format
+    if (urlObj.pathname.startsWith("/embed/")) {
+      const videoId = urlObj.pathname.split("/")[2];
+      return !!videoId && videoId.length === 11;
+    }
+
+    return false;
+  } catch {
+    return false;
+  }
+}