@huntapi/cli 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 HuntAPI
+
+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

@@ -1,3 +1,102 @@
-# Temporary Holding Version
+# HuntAPI CLI
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Official command-line interface for the [HuntAPI](https://www.huntapi.com) media download API.
+
+Download video and audio from public media URLs, or extract their metadata, with one async REST API.
+
+Every documented endpoint is a command — **6 commands** — and `request` reaches any other path. JSON responses are pretty-printed; files (images, PDFs…) are saved with `-o`.
+
+## Requirements
+
+- Node.js 20 or newer
+- a HuntAPI [API key](https://app.huntapi.com)
+
+## Install
+
+```sh
+npm install --global @huntapi/cli
+huntapi --help
+```
+
+Or run it without installing:
+
+```sh
+npx @huntapi/cli --help
+```
+
+## Configure your API key
+
+The CLI reads the key from the environment; it does not load `.env` files.
+
+```sh
+export HUNTAPI_API_KEY="YOUR_API_KEY"
+```
+
+PowerShell:
+
+```powershell
+$env:HUNTAPI_API_KEY = "YOUR_API_KEY"
+```
+
+## Usage
+
+```sh
+huntapi media-metadata --query 'https://www.youtube.com/watch?v=Z5YP8kznWZs'
+```
+
+Parameters use the names of the [API reference](https://docs.huntapi.com) as flags: `--full-page` and `--full_page` are equivalent. Boolean flags can be bare (`--flag`) or explicit (`--flag=false`); array parameters accept commas or repeated flags.
+
+```sh
+huntapi media-metadata --help     # parameters of one command
+huntapi endpoints                # every command and its HTTP path
+huntapi endpoints search         # filter the list
+```
+
+### JSON parameters
+
+```sh
+echo '{"query": "https://www.youtube.com/watch?v=Z5YP8kznWZs"}' | huntapi media-metadata --params -
+huntapi media-metadata --params params.json --compact
+```
+
+Flags override values read with `--params`.
+
+### Any endpoint
+
+```sh
+huntapi request get /v1/usage
+huntapi request post /v1/some/new/endpoint --params body.json
+```
+
+### Pipe into jq
+
+```sh
+huntapi media-metadata --query 'https://www.youtube.com/watch?v=Z5YP8kznWZs' | jq .
+```
+
+## Exit codes
+
+| Code | Meaning                                                                             |
+| ---- | ----------------------------------------------------------------------------------- |
+| `0`  | Success.                                                                            |
+| `1`  | The API returned an error (details on standard error) or the network failed.        |
+| `2`  | Invalid usage: unknown command or parameter, missing API key or required parameter. |
+
+## Commands
+
+| Command          | HTTP                            | Description                                                                                                              |
+| ---------------- | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
+| `audio-download` | GET / POST `/v1/audio/download` | Download audio from a URL via HuntAPI and receive a job id.                                                              |
+| `jobs`           | GET `/v1/jobs/{id}`             | Poll status, progress (0–100), and result of an async HuntAPI job.                                                       |
+| `media-metadata` | GET `/v1/media/metadata`        | Extract metadata from a media URL without downloading the file.                                                          |
+| `stats`          | GET `/v1/stats`                 | Infrastructure health for an engine or endpoint over the last hour. Not scoped to your account or tenant. Enabled per a… |
+| `usage`          | GET `/v1/usage`                 | Retrieve real-time usage statistics and credit balance for your Huntapi account.                                         |
+| `video-download` | GET / POST `/v1/video/download` | Video Download                                                                                                           |
+
+## Built on the SDK
+
+The CLI uses the official [Node.js SDK](https://github.com/huntapi/huntapi-node) (`@huntapi/sdk`). Use the SDK directly for programmatic access.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

package/SECURITY.md

@@ -0,0 +1,16 @@
+# Security Policy
+
+## Supported versions
+
+Security fixes are released for the latest published version of the HuntAPI CLI.
+
+## Reporting a vulnerability
+
+Please do not report security vulnerabilities through public GitHub issues.
+
+Email **contact@huntapi.com** with a description of the issue, the affected version, and steps to reproduce. We acknowledge reports within three business days and keep you informed until the issue is resolved.
+
+## Handling API keys
+
+- Keep your HuntAPI API key out of source control. Load it from the `HUNTAPI_API_KEY` environment variable or a secret manager.
+- Rotate the key from the [HuntAPI dashboard](https://app.huntapi.com) if you believe it was exposed.

package/dist/args.d.ts

@@ -0,0 +1,17 @@
+import type { ParamDefinition } from "./types.js";
+export interface ParsedArgs {
+    readonly positionals: string[];
+    readonly flags: Map<string, string[]>;
+}
+/**
+ * Splits argv into positionals and `--name value` / `--name=value` flags. A flag directly followed by
+ * another flag (or nothing) is recorded as the string "true", so boolean parameters can be bare.
+ */
+export declare function parseArgs(argv: readonly string[], booleanFlags?: ReadonlySet<string>): ParsedArgs;
+/** `--full-page` and `--full_page` both address the `full_page` parameter. */
+export declare function normalize(name: string): string;
+/** Converts raw flag strings into typed parameter values. */
+export declare function coerce(definition: ParamDefinition, raw: readonly string[]): unknown;
+export declare function flag(name: string): string;
+/** Interprets a free-form value for `request` and `--params` overrides: numbers and booleans stay strings. */
+export declare function looseValue(raw: readonly string[]): unknown;

package/dist/args.js

@@ -0,0 +1,111 @@
+import { CliUsageError } from "./errors.js";
+const BOOLEAN_CONTROLS = new Set(["help", "h", "version", "raw", "compact"]);
+/**
+ * Splits argv into positionals and `--name value` / `--name=value` flags. A flag directly followed by
+ * another flag (or nothing) is recorded as the string "true", so boolean parameters can be bare.
+ */
+export function parseArgs(argv, booleanFlags = new Set()) {
+    const positionals = [];
+    const flags = new Map();
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === "--") {
+            positionals.push(...argv.slice(i + 1));
+            break;
+        }
+        if (arg === "-o") {
+            const value = argv[i + 1];
+            if (value === undefined)
+                throw new CliUsageError("-o needs a path (or - for standard output).");
+            push(flags, "output", value);
+            i++;
+            continue;
+        }
+        if (arg === "-h") {
+            push(flags, "help", "true");
+            continue;
+        }
+        if (!arg.startsWith("--") || arg === "--") {
+            positionals.push(arg);
+            continue;
+        }
+        const body = arg.slice(2);
+        const eq = body.indexOf("=");
+        if (eq >= 0) {
+            push(flags, normalize(body.slice(0, eq)), body.slice(eq + 1));
+            continue;
+        }
+        const name = normalize(body);
+        const next = argv[i + 1];
+        if (BOOLEAN_CONTROLS.has(name) ||
+            booleanFlags.has(name) ||
+            next === undefined ||
+            next.startsWith("--")) {
+            push(flags, name, "true");
+        }
+        else {
+            push(flags, name, next);
+            i++;
+        }
+    }
+    return { positionals, flags };
+}
+/** `--full-page` and `--full_page` both address the `full_page` parameter. */
+export function normalize(name) {
+    return name.replace(/-/g, "_");
+}
+function push(flags, name, value) {
+    const list = flags.get(name) ?? [];
+    list.push(value);
+    flags.set(name, list);
+}
+/** Converts raw flag strings into typed parameter values. */
+export function coerce(definition, raw) {
+    const last = raw[raw.length - 1];
+    switch (definition.type) {
+        case "boolean":
+            if (last === "true" || last === "1")
+                return true;
+            if (last === "false" || last === "0")
+                return false;
+            throw new CliUsageError(`--${flag(definition.name)} expects true or false.`);
+        case "number":
+        case "integer": {
+            const value = Number(last);
+            if (last.trim() === "" || !Number.isFinite(value)) {
+                throw new CliUsageError(`--${flag(definition.name)} expects a number.`);
+            }
+            if (definition.type === "integer" && !Number.isInteger(value)) {
+                throw new CliUsageError(`--${flag(definition.name)} expects an integer.`);
+            }
+            return value;
+        }
+        case "array":
+            if (definition.items === "object")
+                return raw.map((item) => parseJson(definition.name, item));
+            return raw.flatMap((item) => item
+                .split(",")
+                .map((part) => part.trim())
+                .filter((part) => part !== ""));
+        case "object":
+            return parseJson(definition.name, last);
+        default:
+            return last;
+    }
+}
+export function flag(name) {
+    return name.replace(/_/g, "-");
+}
+function parseJson(name, text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        throw new CliUsageError(`--${flag(name)} expects JSON.`);
+    }
+}
+/** Interprets a free-form value for `request` and `--params` overrides: numbers and booleans stay strings. */
+export function looseValue(raw) {
+    return raw.length === 1 ? raw[0] : [...raw];
+}
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,5 @@
+import { HuntApiClient, type HuntApiClientOptions } from "@huntapi/sdk";
+import type { CliIo } from "./types.js";
+export type ClientFactory = (options: HuntApiClientOptions) => Pick<HuntApiClient, "request">;
+/** Runs the CLI and returns the process exit code: 0 success, 1 API or network failure, 2 usage error. */
+export declare function runCli(argv: readonly string[], io: CliIo, clientFactory?: ClientFactory): Promise<number>;

package/dist/cli.js

@@ -0,0 +1,178 @@
+import { HuntApiApiError, HuntApiClient, HuntApiError, } from "@huntapi/sdk";
+import { coerce, looseValue, normalize, parseArgs } from "./args.js";
+import { COMMANDS } from "./commands.js";
+import { CliUsageError } from "./errors.js";
+import { commandHelp, endpointsList, rootHelp } from "./help.js";
+import { VERSION } from "./version.js";
+const DEFAULT_FACTORY = (options) => new HuntApiClient(options);
+const CONTROL_FLAGS = new Set([
+    "output",
+    "method",
+    "params",
+    "help",
+    "compact",
+    "raw",
+]);
+/** Runs the CLI and returns the process exit code: 0 success, 1 API or network failure, 2 usage error. */
+export async function runCli(argv, io, clientFactory = DEFAULT_FACTORY) {
+    try {
+        return await dispatch(argv, io, clientFactory);
+    }
+    catch (error) {
+        if (error instanceof CliUsageError) {
+            io.stderr.write(`Error: ${error.message}\n`);
+            return 2;
+        }
+        if (error instanceof HuntApiApiError) {
+            io.stderr.write(`HuntAPI API error ${error.status}: ${error.message}\n`);
+            if (error.responseBody !== undefined)
+                io.stderr.write(`${JSON.stringify(error.responseBody, null, 2)}\n`);
+            return 1;
+        }
+        if (error instanceof HuntApiError) {
+            io.stderr.write(`Error: ${error.message}\n`);
+            return error.name.endsWith("ConfigurationError") ? 2 : 1;
+        }
+        throw error;
+    }
+}
+async function dispatch(argv, io, clientFactory) {
+    const [first, ...rest] = argv;
+    if (first === undefined ||
+        first === "--help" ||
+        first === "-h" ||
+        first === "help") {
+        io.stdout.write(rootHelp());
+        return first === undefined ? 2 : 0;
+    }
+    if (first === "--version" || first === "-v") {
+        io.stdout.write(`${VERSION}\n`);
+        return 0;
+    }
+    if (first === "endpoints") {
+        io.stdout.write(endpointsList(rest[0]));
+        return 0;
+    }
+    if (first === "request") {
+        return runRequest(rest, io, clientFactory);
+    }
+    const command = COMMANDS.find((c) => c.command === first || c.operation === first);
+    if (!command) {
+        throw new CliUsageError(`Unknown command "${first}". Run "huntapi endpoints" to list commands.`);
+    }
+    const booleans = new Set(command.params.filter((p) => p.type === "boolean").map((p) => p.name));
+    const parsed = parseArgs(rest, booleans);
+    if (parsed.flags.has("help")) {
+        io.stdout.write(commandHelp(command));
+        return 0;
+    }
+    if (parsed.positionals.length > 0) {
+        throw new CliUsageError(`Unexpected argument "${parsed.positionals[0]}". Pass parameters as --name value.`);
+    }
+    const params = await readParamsFile(parsed.flags, io);
+    for (const [name, raw] of parsed.flags) {
+        if (CONTROL_FLAGS.has(name))
+            continue;
+        const definition = command.params.find((p) => p.name === name);
+        if (!definition) {
+            throw new CliUsageError(`Unknown parameter --${name.replace(/_/g, "-")} for ${command.command}. Run "huntapi ${command.command} --help".`);
+        }
+        params[name] = coerce(definition, raw);
+    }
+    const missing = command.params.filter((p) => p.required && params[p.name] === undefined);
+    if (missing.length > 0) {
+        throw new CliUsageError(`Missing required parameter${missing.length > 1 ? "s" : ""}: ${missing.map((p) => `--${p.name.replace(/_/g, "-")}`).join(", ")}.`);
+    }
+    const method = readMethod(parsed.flags, command);
+    const client = createClient(io, clientFactory);
+    const response = await client.request(method, command.path, params);
+    return writeResponse(response, parsed.flags, io);
+}
+async function runRequest(argv, io, clientFactory) {
+    const parsed = parseArgs(argv);
+    if (parsed.flags.has("help")) {
+        io.stdout.write("Usage:\n  huntapi request <get|post> <path> [--name value ...] [-o <path|->] [--params <file|->]\n");
+        return 0;
+    }
+    const [method, path, extra] = parsed.positionals;
+    if (!method || !path || extra !== undefined) {
+        throw new CliUsageError("request needs exactly <get|post> and <path>, e.g. huntapi request get /v1/usage");
+    }
+    const verb = method.toUpperCase();
+    if (verb !== "GET" && verb !== "POST")
+        throw new CliUsageError(`Unsupported method "${method}".`);
+    if (!path.startsWith("/"))
+        throw new CliUsageError('The path must start with "/".');
+    const params = await readParamsFile(parsed.flags, io);
+    for (const [name, raw] of parsed.flags) {
+        if (!CONTROL_FLAGS.has(name))
+            params[name] = looseValue(raw);
+    }
+    const client = createClient(io, clientFactory);
+    const response = await client.request(verb, path, params);
+    return writeResponse(response, parsed.flags, io);
+}
+function readMethod(flags, command) {
+    const raw = flags.get("method")?.at(-1);
+    if (raw === undefined)
+        return command.methods[0];
+    const method = raw.toUpperCase();
+    if (method !== "GET" && method !== "POST")
+        throw new CliUsageError(`--method must be get or post.`);
+    if (!command.methods.includes(method)) {
+        throw new CliUsageError(`${command.command} supports ${command.methods.join(", ").toLowerCase()} only.`);
+    }
+    return method;
+}
+async function readParamsFile(flags, io) {
+    const source = flags.get("params")?.at(-1);
+    if (source === undefined)
+        return {};
+    const text = source === "-" ? await io.readStdin() : await io.readFile(source);
+    let value;
+    try {
+        value = JSON.parse(text);
+    }
+    catch {
+        throw new CliUsageError("--params must contain a JSON object.");
+    }
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new CliUsageError("--params must contain a JSON object.");
+    }
+    return Object.fromEntries(Object.entries(value).map(([k, v]) => [normalize(k), v]));
+}
+function createClient(io, clientFactory) {
+    const apiKey = io.env.HUNTAPI_API_KEY;
+    if (!apiKey || apiKey.trim() === "") {
+        throw new CliUsageError("Set the HUNTAPI_API_KEY environment variable to your HuntAPI API key.");
+    }
+    const baseUrl = io.env.HUNTAPI_BASE_URL;
+    return clientFactory({ apiKey, ...(baseUrl ? { baseUrl } : {}) });
+}
+async function writeResponse(response, flags, io) {
+    const output = flags.get("output")?.at(-1);
+    const compact = flags.has("compact");
+    if (response.kind === "json") {
+        const text = `${JSON.stringify(response.data, null, compact ? 0 : 2)}\n`;
+        if (output === undefined || output === "-")
+            io.stdout.write(text);
+        else
+            await io.writeFile(output, text);
+        return 0;
+    }
+    if (output === undefined) {
+        if (io.stdout.isTTY) {
+            throw new CliUsageError(`The response is binary (${response.contentType ?? "unknown type"}). Use -o <file> to save it, or -o - to pipe it.`);
+        }
+        io.stdout.write(response.bytes);
+        return 0;
+    }
+    if (output === "-")
+        io.stdout.write(response.bytes);
+    else {
+        await io.writeFile(output, response.bytes);
+        io.stderr.write(`Saved ${output} (${response.contentType ?? "binary"}, ${response.bytes.length} bytes)\n`);
+    }
+    return 0;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands.d.ts

@@ -0,0 +1,2 @@
+import type { CommandDefinition } from "./types.js";
+export declare const COMMANDS: readonly CommandDefinition[];

package/dist/commands.js

@@ -0,0 +1,237 @@
+// Generated from the HuntAPI OpenAPI document. Do not edit by hand.
+export const COMMANDS = [
+    {
+        command: "audio-download",
+        operation: "audio_download",
+        path: "/v1/audio/download",
+        methods: ["GET", "POST"],
+        summary: "Audio Download",
+        description: "Download audio from a URL via HuntAPI and receive a job id.",
+        params: [
+            {
+                name: "query",
+                type: "string",
+                required: true,
+                description: "URL to download audio from.",
+            },
+            {
+                name: "download_type",
+                type: "string",
+                required: false,
+                description: "Desired download type. Supported values: audio (default).",
+                default: "audio",
+            },
+            {
+                name: "max_duration",
+                type: "number",
+                required: false,
+                description: "Maximum duration of the downloaded content in seconds. If the audio is longer than this value, only the content up to this duration will be downloaded.",
+            },
+            {
+                name: "audio_quality",
+                type: "string",
+                required: false,
+                description: "Desired audio quality.",
+                default: "best",
+            },
+            {
+                name: "audio_format",
+                type: "string",
+                required: false,
+                description: "Desired output format for the audio.",
+                default: "mp3",
+            },
+            {
+                name: "webhook_url",
+                type: "string",
+                required: false,
+                description: "URL of the webhook where results will be sent. When specified, the system will attempt to send the response to this URL up to 3 times with a 5-second delay between each attempt. The results will be s…",
+            },
+            {
+                name: "webhook_authorization",
+                type: "string",
+                required: false,
+                description: "Authorization header for the webhook. This parameter allows you to add authentication to your webhook endpoint.",
+            },
+            {
+                name: "fields",
+                type: "string",
+                required: false,
+                description: "Comma-separated list of fields to keep in the response, with dot notation for nested fields (e.g. name,location.city). Does not change the credit cost.",
+            },
+            {
+                name: "is_async",
+                type: "boolean",
+                required: false,
+                description: "Process the request asynchronously: the response is a job_id to poll on /v1/jobs/{id} (see waitForJob).",
+                default: false,
+            },
+            {
+                name: "soft_fail",
+                type: "boolean",
+                required: false,
+                description: "Return HTTP 200 even when an error occurs; the error is then in the response body.",
+                default: false,
+            },
+        ],
+    },
+    {
+        command: "jobs",
+        operation: "jobs",
+        path: "/v1/jobs/{id}",
+        methods: ["GET"],
+        summary: "Jobs",
+        description: "Poll status, progress (0–100), and result of an async HuntAPI job.",
+        params: [
+            {
+                name: "id",
+                type: "string",
+                required: true,
+                description: "Job UUID returned as job_id by async endpoints such as /v1/video/download and /v1/audio/download.",
+            },
+        ],
+    },
+    {
+        command: "media-metadata",
+        operation: "media_metadata",
+        path: "/v1/media/metadata",
+        methods: ["GET"],
+        summary: "Media Metadata",
+        description: "Extract metadata from a media URL without downloading the file.",
+        params: [
+            {
+                name: "query",
+                type: "string",
+                required: true,
+                description: "Media URL to inspect (YouTube, Instagram, TikTok, Vimeo, X, Facebook, Twitch, Reddit, etc.).",
+            },
+            {
+                name: "fields",
+                type: "string",
+                required: false,
+                description: "Comma-separated list of fields to keep in the response, with dot notation for nested fields (e.g. name,location.city). Does not change the credit cost.",
+            },
+            {
+                name: "is_async",
+                type: "boolean",
+                required: false,
+                description: "Process the request asynchronously: the response is a job_id to poll on /v1/jobs/{id} (see waitForJob).",
+                default: false,
+            },
+            {
+                name: "soft_fail",
+                type: "boolean",
+                required: false,
+                description: "Return HTTP 200 even when an error occurs; the error is then in the response body.",
+                default: false,
+            },
+        ],
+    },
+    {
+        command: "stats",
+        operation: "stats",
+        path: "/v1/stats",
+        methods: ["GET"],
+        summary: "Stats",
+        description: "Infrastructure health for an engine or endpoint over the last hour. Not scoped to your account or tenant. Enabled per account: HTTP 403 means contact support to activate it.",
+        params: [
+            {
+                name: "engine",
+                type: "string",
+                required: false,
+                description: "API family to check, for example video. Provide at least engine or path.",
+            },
+            {
+                name: "path",
+                type: "string",
+                required: false,
+                description: "Specific endpoint to check, for example /v1/video/download. If you also pass engine, use an endpoint from that API.",
+            },
+        ],
+    },
+    {
+        command: "usage",
+        operation: "usage",
+        path: "/v1/usage",
+        methods: ["GET"],
+        summary: "Usage",
+        description: "Retrieve real-time usage statistics and credit balance for your Huntapi account.",
+        params: [],
+    },
+    {
+        command: "video-download",
+        operation: "video_download",
+        path: "/v1/video/download",
+        methods: ["GET", "POST"],
+        summary: "Video Download",
+        description: "",
+        params: [
+            {
+                name: "query",
+                type: "string",
+                required: true,
+                description: "Video URL to download.",
+            },
+            {
+                name: "download_type",
+                type: "string",
+                required: false,
+                description: "Desired download type. You have three options:",
+                default: "audio_video",
+            },
+            {
+                name: "max_duration",
+                type: "number",
+                required: false,
+                description: "Maximum duration of the downloaded content in seconds. If the video/audio is longer than this value, only the content up to this duration will be downloaded.",
+            },
+            {
+                name: "video_quality",
+                type: "string",
+                required: false,
+                description: "Desired video quality. Available options:",
+                default: "best",
+            },
+            {
+                name: "video_format",
+                type: "string",
+                required: false,
+                description: "Desired output format for the video. Available options:",
+                default: "mp4",
+            },
+            {
+                name: "webhook_url",
+                type: "string",
+                required: false,
+                description: "URL of the webhook where results will be sent. When specified, the system will attempt to send the response to this URL up to 3 times with a 5-second delay between each attempt. The results will be s…",
+            },
+            {
+                name: "webhook_authorization",
+                type: "string",
+                required: false,
+                description: "Authorization header for the webhook. This parameter allows you to add authentication to your webhook endpoint. This value will be included in the Authorization header when making the webhook request…",
+            },
+            {
+                name: "fields",
+                type: "string",
+                required: false,
+                description: "Comma-separated list of fields to keep in the response, with dot notation for nested fields (e.g. name,location.city). Does not change the credit cost.",
+            },
+            {
+                name: "is_async",
+                type: "boolean",
+                required: false,
+                description: "Process the request asynchronously: the response is a job_id to poll on /v1/jobs/{id} (see waitForJob).",
+                default: false,
+            },
+            {
+                name: "soft_fail",
+                type: "boolean",
+                required: false,
+                description: "Return HTTP 200 even when an error occurs; the error is then in the response body.",
+                default: false,
+            },
+        ],
+    },
+];
+//# sourceMappingURL=commands.js.map

package/dist/commands.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,4 @@
+/** Invalid command-line usage; exits with status 2. */
+export declare class CliUsageError extends Error {
+    constructor(message: string);
+}

package/dist/errors.js

@@ -0,0 +1,8 @@
+/** Invalid command-line usage; exits with status 2. */
+export class CliUsageError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "CliUsageError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF"}

package/dist/help.d.ts

@@ -0,0 +1,4 @@
+import type { CommandDefinition } from "./types.js";
+export declare function rootHelp(): string;
+export declare function commandHelp(command: CommandDefinition): string;
+export declare function endpointsList(filter: string | undefined): string;

package/dist/help.js

@@ -0,0 +1,78 @@
+import { flag } from "./args.js";
+import { COMMANDS } from "./commands.js";
+export function rootHelp() {
+    const width = Math.max(...COMMANDS.map((c) => c.command.length), "endpoints".length) + 2;
+    const lines = COMMANDS.map((c) => `  ${c.command.padEnd(width)}${c.summary}`);
+    return `HuntAPI CLI — media download API
+
+Usage:
+  huntapi <command> [--param value ...] [-o <path|->] [--method get|post] [--params <file|->]
+  huntapi request <get|post> <path> [--param value ...]
+  huntapi endpoints [filter]
+  huntapi --help | --version
+
+Commands:
+${lines.join("\n")}
+
+  ${"request".padEnd(width)}Call any API path.
+  ${"endpoints".padEnd(width)}List commands with their HTTP paths.
+
+Environment:
+  HUNTAPI_API_KEY   API key (required).
+
+Run "huntapi <command> --help" for the parameters of a command.
+`;
+}
+export function commandHelp(command) {
+    const params = command.params.map(formatParam).join("\n");
+    return `${command.summary} — ${command.methods.join(" / ")} ${command.path}
+${command.description ? `\n${command.description}\n` : ""}
+Usage:
+  huntapi ${command.command}${command.params
+        .filter((p) => p.required)
+        .map((p) => ` --${flag(p.name)} <${p.type}>`)
+        .join("")} [options]
+
+Parameters:
+${params || "  (none)"}
+
+CLI controls:
+  -o, --output <path|->   Write the response to a file, or - for standard output.
+  --method <get|post>     HTTP method (default ${command.methods[0].toLowerCase()}).
+  --params <path|->       Read a JSON object of parameters from a file or standard input; flags override it.
+  --compact               Print JSON on one line.
+  --help                  Show this help.
+`;
+}
+function formatParam(param) {
+    const shape = param.type === "boolean"
+        ? "[=true|false]"
+        : ` <${param.type === "array" ? `${param.items ?? "string"},...` : param.type}>`;
+    const notes = [];
+    if (param.required)
+        notes.push("required");
+    if (param.enum)
+        notes.push(`one of: ${param.enum.slice(0, 12).join(", ")}${param.enum.length > 12 ? ", …" : ""}`);
+    if (param.default !== undefined)
+        notes.push(`default: ${JSON.stringify(param.default)}`);
+    const head = `  --${flag(param.name)}${shape}`;
+    const description = [
+        param.description,
+        notes.length ? `(${notes.join("; ")})` : "",
+    ]
+        .filter(Boolean)
+        .join(" ");
+    return description ? `${head}\n      ${description}` : head;
+}
+export function endpointsList(filter) {
+    const needle = filter?.toLowerCase();
+    const rows = COMMANDS.filter((c) => !needle ||
+        c.command.includes(needle) ||
+        c.path.toLowerCase().includes(needle) ||
+        c.summary.toLowerCase().includes(needle));
+    const width = Math.max(0, ...rows.map((c) => c.command.length)) + 2;
+    return (rows
+        .map((c) => `${c.command.padEnd(width)}${c.methods.join("/").padEnd(10)}${c.path}`)
+        .join("\n") + "\n");
+}
+//# sourceMappingURL=help.js.map

package/dist/help.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+import { readFile, writeFile } from "node:fs/promises";
+import process from "node:process";
+import { runCli } from "./cli.js";
+async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin)
+        chunks.push(Buffer.from(chunk));
+    return Buffer.concat(chunks).toString("utf8");
+}
+process.exitCode = await runCli(process.argv.slice(2), {
+    env: process.env,
+    stdout: process.stdout,
+    stderr: process.stderr,
+    readStdin,
+    writeFile: (path, data) => writeFile(path, data),
+    readFile: (path) => readFile(path, "utf8"),
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,KAAK,UAAU,SAAS;IACtB,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK;QACrC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAmB,CAAC,CAAC,CAAC;IAChD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAChD,CAAC;AAED,OAAO,CAAC,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;IACrD,GAAG,EAAE,OAAO,CAAC,GAAG;IAChB,MAAM,EAAE,OAAO,CAAC,MAAM;IACtB,MAAM,EAAE,OAAO,CAAC,MAAM;IACtB,SAAS;IACT,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC;IAChD,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CAC3C,CAAC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,33 @@
+export type ParamType = "string" | "integer" | "number" | "boolean" | "array" | "object";
+export interface ParamDefinition {
+    readonly name: string;
+    readonly type: ParamType;
+    readonly items?: ParamType;
+    readonly required: boolean;
+    readonly description: string;
+    readonly enum?: readonly string[];
+    readonly default?: unknown;
+}
+export interface CommandDefinition {
+    readonly command: string;
+    readonly operation: string;
+    readonly path: string;
+    readonly methods: readonly ("GET" | "POST")[];
+    readonly summary: string;
+    readonly description: string;
+    readonly params: readonly ParamDefinition[];
+}
+/** Process streams and environment, injectable for tests. */
+export interface CliIo {
+    readonly env: Readonly<Record<string, string | undefined>>;
+    readonly stdout: {
+        write(chunk: string | Uint8Array): unknown;
+        isTTY?: boolean;
+    };
+    readonly stderr: {
+        write(chunk: string): unknown;
+    };
+    readonly readStdin: () => Promise<string>;
+    readonly writeFile: (path: string, data: string | Uint8Array) => Promise<void>;
+    readonly readFile: (path: string) => Promise<string>;
+}

package/dist/types.js

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

package/dist/types.js.map

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

package/dist/version.d.ts

@@ -0,0 +1 @@
+export declare const VERSION = "0.1.0";

package/dist/version.js

@@ -0,0 +1,2 @@
+export const VERSION = "0.1.0";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/package.json

@@ -1,6 +1,57 @@
 {
   "name": "@huntapi/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Official command-line interface for the HuntAPI media download API.",
+  "type": "module",
+  "bin": {
+    "huntapi": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "SECURITY.md"
+  ],
+  "scripts": {
+    "build": "npm run clean && tsc -p tsconfig.build.json",
+    "clean": "node -e \"require('node:fs').rmSync('dist', { force: true, recursive: true })\"",
+    "format:check": "prettier --check .",
+    "prepack": "npm run build",
+    "test": "tsx --test test/*.test.ts",
+    "typecheck": "tsc -p tsconfig.json"
+  },
+  "author": "HuntAPI",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/huntapi/huntapi-cli.git"
+  },
+  "homepage": "https://github.com/huntapi/huntapi-cli#readme",
+  "bugs": {
+    "url": "https://github.com/huntapi/huntapi-cli/issues"
+  },
+  "keywords": [
+    "cli",
+    "command-line",
+    "huntapi",
+    "video-download-api",
+    "audio-download-api",
+    "media-metadata",
+    "async-api"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@huntapi/sdk": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "prettier": "^3.4.2",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2"
+  }
+}