CLI Usage

## install for CLi testing of your APIs
npm i -g grab-url

# use "grab" if installed or "npx grab-url" if not
g https://api.example.com/download

# Basic request, no flag
npx grab-url https://api.example.com/download

# Request with params
npx grab-url https://api.example.com/download id=123 name=John

# Request with JSON payload
npx grab-url https://api.example.com/download '{"id":123,"name":"John"}'

# Request with --x flag (just executes once, no watching)
# - **`--x` or `-x` flag**: Simply executes the request/download once and exits—no file watching.
npx grab-url https://api.example.com/download --x

# Request with params and --x flag
npx grab-url https://api.example.com/download id=123 name=John --x

import { MultiColorFileDownloaderCLI } from "grab-url/cli";

const downloader = new MultiColorFileDownloaderCLI();

// Download a single file
await downloader.downloadFile(
  "https://example.com/archive.tar.gz",
  "./downloads/archive.tar.gz",
);

// Download multiple files concurrently with progress bars
await downloader.downloadMultipleFiles([
  {
    url: "https://example.com/a.zip",
    outputPath: "./a.zip",
    filename: "a.zip",
  },
  {
    url: "https://example.com/b.zip",
    outputPath: "./b.zip",
    filename: "b.zip",
  },
]);

// Clean up listeners and abort controllers when done
downloader.cleanup();

import { MultiColorFileDownloaderCLI, generateFilename } from "grab-url/cli";

const downloader = new MultiColorFileDownloaderCLI();

// Start with one file (runs in background)
const initialDownload = downloader.downloadMultipleFiles([
  {
    url: "https://example.com/large-file.iso",
    outputPath: "./large-file.iso",
    filename: "large-file.iso",
  },
]);

// Later, add another file to the running session
setTimeout(async () => {
  const url = "https://example.com/extra-data.zip";
  const filename = generateFilename(url); // => 'extra-data.zip'
  await downloader.addToMultipleDownloads(url, `./${filename}`, filename);
}, 5000);

// Wait for all downloads to finish
await initialDownload;
downloader.cleanup();