umedia 0.4.2 → 0.5.0

package/bin/umedia.js

@@ -1,99 +1,13 @@
 #!/usr/bin/env node
-/**
- * umedia CLI — the standalone media engine, in your terminal.
- *
- *   umedia search "afrobeats" --type music --limit 5
- *   umedia resolve "https://www.tiktok.com/@user/photo/123"
- *   umedia download "https://youtu.be/jNQXAC9IVRw" --quality best -o ./out
- *   umedia status
- *   umedia capabilities
- */
-import { UMedia, UMediaError } from "../index.js";
-
-function parseArgs(argv) {
-  const out = { _: [] };
-  for (let i = 0; i < argv.length; i++) {
-    const a = argv[i];
-    if (a.startsWith("--") || a.startsWith("-")) {
-      const key = a.replace(/^-+/, "");
-      const next = argv[i + 1];
-      if (next !== undefined && !next.startsWith("-")) { out[key] = next; i++; }
-      else out[key] = true;
-    } else out._.push(a);
-  }
-  return out;
-}
-
-const HELP = `umedia — standalone media engine (runs on YOUR machine, no API needed)
-
-  umedia search "<query>" [--type video|music|movie|short_video] [--limit N]
-  umedia resolve <url>
-  umedia download <url> [--quality best|720p|audio] [-o <dir>] [--zip] [--ytdlp]
-  umedia status
-  umedia capabilities`;
-
-const args = parseArgs(process.argv.slice(2));
-const cmd = args._[0];
-if (!cmd || cmd === "help" || args.help) {
-  console.log(HELP);
-  process.exit(0);
-}
-
-const client = new UMedia({ downloadDir: args.o || args.out || "./umedia-downloads" });
-const print = (x) => console.log(JSON.stringify(x, null, 2));
-
-async function main() {
-  switch (cmd) {
-    case "search": {
-      const q = args._.slice(1).join(" ");
-      if (!q) throw new UMediaError("INVALID_REQUEST", 'usage: umedia search "<query>"');
-      const { data, meta, engine } = await client.search({
-        q, type: args.type || "video", limit: args.limit ? Number(args.limit) : 12, adult: Boolean(args.adult),
-      });
-      print({ items: data.items, meta, engine });
-      break;
-    }
-    case "resolve": {
-      const url = args._[1];
-      if (!url) throw new UMediaError("INVALID_REQUEST", "usage: umedia resolve <url>");
-      const r = await client.resolve(url);
-      print(r);
-      break;
-    }
-    case "download": {
-      const url = args._[1];
-      if (!url) throw new UMediaError("INVALID_REQUEST", "usage: umedia download <url>");
-      const onProgress = args.json ? undefined : (done, total) => {
-        if (total) process.stderr.write(`\r  ${((done / total) * 100).toFixed(1)}%`);
-      };
-      const fn = args.ytdlp ? client.downloadWithYtdlp.bind(client) : client.download.bind(client);
-      const r = await fn({ url, quality: args.quality || "best", type: args.type || "video", zip: Boolean(args.zip), onProgress });
-      if (!args.json) process.stderr.write("\n");
-      print(r.data);
-      break;
-    }
-    case "status": {
-      print((await client.status()).data);
-      break;
-    }
-    case "capabilities": {
-      print((await client.capabilities()).data);
-      break;
-    }
-    default:
-      console.log(HELP);
-      process.exit(1);
-  }
-}
-
-main().catch((e) => {
-  if (e instanceof UMediaError) {
-    console.error(JSON.stringify({
-      success: false,
-      error: { code: e.code, message: e.message, requestId: e.requestId, attempts: e.attempts },
-    }, null, 2));
-  } else {
-    console.error(String(e && e.message ? e.message : e));
-  }
-  process.exit(1);
-});
+import { realpathSync } from "node:fs";
+import { spawnSync } from "node:child_process";
+import { createRequire } from "node:module";
+import path from "node:path";
+
+const require = createRequire(import.meta.url);
+console.error("[umedia] this package was renamed to pappy-media-api — re-exporting it. Please run: npm i pappy-media-api");
+
+// run the real CLI from the pappy-media-api package
+const bin = require.resolve("pappy-media-api/bin/umedia.js");
+const r = spawnSync(process.execPath, [bin, ...process.argv.slice(2)], { stdio: "inherit" });
+process.exit(r.status ?? 0);

package/index.d.ts

@@ -1,180 +1,2 @@
-/** umedia — standalone media engine. Runs entirely on your machine: no hosted API, no keys, no bills. */
-
-export type ErrorCode =
-  | "INVALID_REQUEST" | "INVALID_URL" | "SSRF_BLOCKED" | "AUTH_REQUIRED" | "AUTH_INVALID"
-  | "RATE_LIMITED" | "MEDIA_NOT_FOUND" | "CONTENT_PRIVATE" | "ACCESS_RESTRICTED"
-  | "QUALITY_UNAVAILABLE" | "PROVIDER_ERROR" | "PROVIDER_UNAVAILABLE" | "TIMEOUT"
-  | "NOT_FOUND" | "INTERNAL";
-
-export const Codes: Readonly<Record<ErrorCode, ErrorCode>>;
-export const qualityLadder: readonly string[];
-
-export class UMediaError extends Error {
-  name: "UMediaError";
-  code: ErrorCode;
-  status: number;
-  requestId: string | null;
-  attempts: ProviderAttempt[];
-  details: unknown;
-  constructor(code: ErrorCode, message: string, opts?: {
-    status?: number; requestId?: string | null; attempts?: ProviderAttempt[]; details?: unknown;
-  });
-}
-
-/** Honest provider record — which adapter actually did the work (or why it couldn't). */
-export interface ProviderAttempt {
-  provider: string;
-  status: "success" | "failed" | "skipped";
-  latencyMs?: number | null;
-  error?: string | null;
-}
-
-export interface MediaVariant {
-  quality: string;                 // derived from ACTUAL source height — never upscaled
-  width?: number | null;
-  height?: number | null;
-  url?: string | null;             // null when the network is bot-gated — never faked
-  mimeType?: string | null;
-  bitrateKbps?: number | null;
-  hasAudio?: boolean | null;
-  hasVideo?: boolean | null;
-}
-
-export interface MediaObject {
-  type: "image" | "video" | "audio" | "short_video" | "gif";
-  index: number;
-  url: string | null;
-  thumbnail?: string | null;
-  mimeType?: string | null;
-  width?: number | null;
-  height?: number | null;
-  duration?: number | null;
-  size?: number | null;
-  quality?: string | null;
-  hasAudio?: boolean | null;
-  hasVideo?: boolean | null;
-  source?: string;
-  variants: MediaVariant[];
-}
-
-export interface MediaCounts { images: number; videos: number; audios: number; other: number; }
-
-export interface ResolveResult {
-  sourceUrl: string;
-  platform?: string | null;
-  title?: string | null;
-  author?: string | null;
-  thumbnail?: string | null;
-  itemCount: number;
-  counts: MediaCounts;
-  /** true only when an item cap was hit — never silent truncation */
-  truncated: boolean;
-  media: MediaObject[];
-  /** YouTube-specific honesty about stream URL availability on this network */
-  streamUrlsAvailable?: boolean;
-  streamAccess?: string;
-  [k: string]: unknown;
-}
-
-export interface ResolveMeta {
-  attempts: ProviderAttempt[];
-  finalProvider?: string | null;
-  totalLatencyMs?: number | null;
-}
-
-export interface SearchItem {
-  id?: string;
-  title?: string;
-  author?: string;
-  pageUrl?: string;
-  thumbnail?: string | null;
-  duration?: number | null;
-  mediaType?: string;
-  source?: string;
-  explicit?: boolean;
-  /** real 30s clip / trailer / official embed — `none` when nothing honest exists */
-  previewUrl?: string | null;
-  previewKind?: "clip30s" | "trailer" | "embed" | "none";
-  [k: string]: unknown;
-}
-
-export interface DownloadedFile {
-  name: string;
-  path: string;
-  size: number;
-  ext: string;
-  mimeType?: string | null;
-  index: number;
-  quality?: string | null;
-}
-
-export interface DownloadResult {
-  url: string;
-  title?: string | null;
-  source?: string | null;
-  requestedQuality: string;
-  selectedQuality: string | null;
-  fallback: boolean;
-  files: DownloadedFile[];
-  itemCount: number;
-  requestedItems: number;
-  truncated: boolean;
-  failedItems: Array<{ index?: number; type?: string; url?: string; error?: string }>;
-  note?: string;
-}
-
-export interface Meta {
-  requestId: string;
-  source?: string | null;
-  timestamp: string;
-  elapsedMs?: number;
-}
-
-export interface Envelope<T> { data: T; meta: Meta; }
-
-export interface UMediaOptions {
-  /** default directory for downloads (default "./umedia-downloads") */
-  downloadDir?: string;
-  timeoutMs?: number;
-}
-
-export class UMedia {
-  constructor(opts?: UMediaOptions);
-  downloadDir: string;
-
-  search(p?: {
-    q?: string; query?: string;
-    type?: "video" | "music" | "movie" | "short_video";
-    limit?: number; adult?: boolean;
-  }): Promise<Envelope<{ items: SearchItem[]; adultFilter?: unknown }> & { engine: { attempts: ProviderAttempt[] } }>;
-
-  resolve(url: string): Promise<{ data: ResolveResult; engine: ResolveMeta }>;
-
-  download(p: {
-    url: string;
-    /** original | best | 2160p … 144p | audio */
-    quality?: string;
-    type?: "video" | "music" | "movie" | "short_video";
-    dir?: string;
-    zip?: boolean;
-    onProgress?: (done: number, total: number) => void;
-  }): Promise<Envelope<DownloadResult> & { engine?: ResolveMeta }>;
-
-  downloadWithYtdlp(p: {
-    url: string; quality?: string; dir?: string;
-    onProgress?: (done: number, total: number) => void;
-  }): Promise<Envelope<DownloadResult>>;
-
-  capabilities(): Promise<Envelope<{
-    platforms: Array<{ platform: string; search: boolean; resolve: boolean; download: boolean | string; notes?: string }>;
-    qualityLadder: string[];
-  }>>;
-
-  status(): Promise<Envelope<{
-    overall: string;
-    runtime: { node: string; platform: string };
-    providers: Array<{ name: string; state: string; via: string }>;
-  }>>;
-}
-
-export default UMedia;
+export * from "pappy-media-api";
+export { default } from "pappy-media-api";

package/index.js

@@ -1,76 +1,8 @@
 /**
- * umedia — standalone media engine. Runs entirely on YOUR machine:
- * no hosted API, no keys, no rate limits, no server bills.
- *
- * Search · Resolve · Download — honest quality labels, real previews, complete galleries.
+ * umedia -> pappy-media-api compatibility shim.
+ * The engine now lives in pappy-media-api. Install that instead:
+ *   npm uninstall umedia && npm install pappy-media-api
+ * The API is identical; only the import path changes.
  */
-import { rid } from "./lib/util.js";
-import * as registry from "./lib/registry.js";
-import { download, downloadWithYtdlp } from "./lib/download.js";
-import { UMediaError, Codes } from "./lib/errors.js";
-
-export { UMediaError, Codes };
-export { LADDER as qualityLadder } from "./lib/quality.js";
-
-export class UMedia {
-  /** @param {{downloadDir?: string, timeoutMs?: number}} [opts] */
-  constructor(opts = {}) {
-    this.downloadDir = opts.downloadDir || "./umedia-downloads";
-    this.timeoutMs = opts.timeoutMs ?? 120_000;
-  }
-
-  /**
-   * Multi-source search. Music leads with REAL 30s previews (iTunes), then YouTube.
-   * @param {{q?: string, query?: string, type?: "video"|"music"|"movie"|"short_video", limit?: number, adult?: boolean}} [p]
-   */
-  async search(p = {}) {
-    const t0 = Date.now();
-    const { items, attempts } = await registry.search({
-      q: p.q ?? p.query ?? "",
-      type: p.type ?? "video",
-      limit: Math.max(1, Math.min(25, p.limit ?? 12)),
-      adult: Boolean(p.adult),
-    });
-    return {
-      data: { items, adultFilter: { enabled: !p.adult } },
-      meta: { requestId: rid(), source: attempts.find((a) => a.status === "success")?.provider ?? null, timestamp: new Date().toISOString(), elapsedMs: Date.now() - t0 },
-      engine: { attempts },
-    };
-  }
-
-  /**
-   * Resolve a post URL into ALL of its media — every photo, every video, in order.
-   * `engine.attempts` is the honest provider trail.
-   */
-  async resolve(url) {
-    return registry.resolve(url);
-  }
-
-  /**
-   * Download every media item to disk (order preserved, failures named).
-   * Quality is honest: `requestedQuality` vs `selectedQuality` + `fallback`.
-   * @param {{url: string, quality?: string, type?: string, dir?: string, zip?: boolean, onProgress?: (done:number,total:number)=>void}} p
-   */
-  async download(p = {}) {
-    if (!p.url) throw new UMediaError(Codes.INVALID_REQUEST, "download({ url }) — url is required");
-    return download({ ...p, dir: p.dir || this.downloadDir });
-  }
-
-  /** Power tier: route a download through yt-dlp (1800+ sites, hard networks, muxing). */
-  async downloadWithYtdlp(p = {}) {
-    if (!p.url) throw new UMediaError(Codes.INVALID_REQUEST, "downloadWithYtdlp({ url }) — url is required");
-    return downloadWithYtdlp({ ...p, dir: p.dir || this.downloadDir });
-  }
-
-  /** What this engine can actually do on THIS machine — never overstated. */
-  async capabilities() {
-    return { data: registry.capabilities(), meta: { requestId: rid(), source: "local", timestamp: new Date().toISOString() } };
-  }
-
-  /** Real engine status — which adapters are operational here. */
-  async status() {
-    return { data: registry.status(), meta: { requestId: rid(), source: "local", timestamp: new Date().toISOString() } };
-  }
-}
-
-export default UMedia;
+export * from "pappy-media-api";
+export { default } from "pappy-media-api";

package/package.json

@@ -1,57 +1,14 @@
 {
   "name": "umedia",
-  "version": "0.4.2",
-  "description": "Standalone media engine — search, resolve and download media from YouTube, TikTok, Instagram, Reddit, X, iTunes (and 1800+ sites via the yt-dlp tier) entirely on your machine. No hosted API, no keys, no server bills. Honest quality labels, complete galleries, typed errors.",
-  "type": "module",
-  "main": "./index.js",
-  "types": "./index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./index.d.ts",
-      "import": "./index.js"
-    }
-  },
-  "bin": {
-    "umedia": "bin/umedia.js"
-  },
-  "files": [
-    "index.js",
-    "index.d.ts",
-    "lib/",
-    "bin/",
-    "README.md",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": ">=18"
-  },
-  "scripts": {
-    "test": "node --test test/"
-  },
-  "dependencies": {
-    "fflate": "^0.8.2",
-    "youtubei.js": "^18.1.0"
-  },
-  "keywords": [
-    "media",
-    "downloader",
-    "youtube",
-    "tiktok",
-    "instagram",
-    "reddit",
-    "search",
-    "engine",
-    "ytdlp",
-    "cli"
-  ],
+  "version": "0.5.0",
+  "description": "Renamed to pappy-media-api. This package is now a thin compatibility shim that re-exports pappy-media-api.",
+  "keywords": ["media", "downloader", "youtube", "tiktok", "instagram", "pinterest", "snapchat", "pappy"],
   "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Anonymous20666/unified-media-api.git",
-    "directory": "sdk"
-  },
-  "bugs": {
-    "url": "https://github.com/Anonymous20666/unified-media-api/issues"
-  },
-  "homepage": "https://github.com/Anonymous20666/unified-media-api#readme"
+  "type": "module",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "bin": { "umedia": "bin/umedia.js", "pappy-media-api": "bin/umedia.js" },
+  "files": ["index.js", "index.d.ts", "bin"],
+  "dependencies": { "pappy-media-api": "^0.5.0" },
+  "engines": { "node": ">=18" }
 }

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Anonymous20666
-
-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,156 +0,0 @@
-<div align="center">
-
-<img src="https://dev-pappy-api-downloader.duckdns.org/og-image.jpg" alt="Unified Media API — one API for every media platform" width="760" />
-
-# umedia
-
-**The standalone media engine — search, resolve and download, entirely on YOUR machine.**
-
-No hosted API. No API keys. No rate limits. **No server bill.**
-
-YouTube · TikTok · Pinterest · SoundCloud · Dailymotion · Vimeo · Streamable · Twitch · Bluesky · Instagram · Reddit · X · Facebook · Threads · Snapchat · Rumble · Tumblr · iTunes · 1800+ sites (via the optional yt-dlp tier)
-
-[![npm version](https://img.shields.io/npm/v/umedia?color=67e8f9&label=npm)](https://www.npmjs.com/package/umedia)
-[![node](https://img.shields.io/badge/node-%E2%89%A5%2018-brightgreen)](https://nodejs.org)
-[![license](https://img.shields.io/npm/l/umedia?color=22d3ee)](LICENSE)
-
-</div>
-
----
-
-## 💸 Why this exists
-
-Hosted media APIs cost money **every month** — per request, per user, per server.
-`umedia` flips the model: the engine runs **inside your app**. Your users' machines do the work,
-so your costs are… zero. Install it, call it, ship.
-
-```bash
-npm install umedia
-```
-
-```js
-import { UMedia } from "umedia";
-
-const media = new UMedia();
-
-// 1) Search — music leads with REAL 30-second previews
-const { data } = await media.search({ q: "afrobeats", type: "music", limit: 3 });
-for (const item of data.items) console.log(item.title, "—", item.previewKind, "→", item.previewUrl);
-
-// 2) Resolve a post → ALL media, in order
-const { data: post } = await media.resolve("https://www.tiktok.com/@user/photo/7690630628697459990");
-console.log(post.itemCount, post.counts);   // 30 { images: 30, … } — never truncated silently
-
-// 3) Download everything to disk
-const { data: job } = await media.download({ url: post.sourceUrl, quality: "best", dir: "./out" });
-console.log(job.requestedQuality, "→", job.selectedQuality);  // "best" → "720p" — real, never invented
-```
-
-That's the whole model: **your code, your machine, your files.**
-
----
-
-## 🎯 The contract that keeps your app honest
-
-### 🏷️ Quality is never manufactured
-`requestedQuality` vs `selectedQuality` on every download. A 240p source never arrives wearing a
-1080p sticker. `fallback: true` tells you exactly when reality differed from the request.
-
-### 🖼️ Galleries arrive complete
-100 photos → **100 files, in order** (`001 - …`, `002 - …`). Anything that failed is named in
-`failedItems[]` with the reason — never silent, never partial-by-accident.
-
-### 🎧 Previews drop first
-Music search leads with real **30s iTunes clips** (`previewKind: "clip30s"`), movies with YouTube
-trailers, social posts with official embeds. `previewKind: "none"` beats a fake preview.
-
-### 🧯 Typed failures, always
-`UMediaError` with a stable `code` (`RATE_LIMITED`, `MEDIA_NOT_FOUND`, `PROVIDER_UNAVAILABLE`,
-`SSRF_BLOCKED`, …), plus `engine.attempts[]` — the real trail of which providers were tried and why.
-
----
-
-## 🗺️ What runs where (honest edition)
-
-| Platform | Search | Resolve | Download | How |
-|---|---|---|---|---|
-| **YouTube** | ✅ | ✅ | ✅ * | InnerTube — search & metadata always; stream URLs depend on your network (see below) |
-| **TikTok** | — | ✅ | ✅ | video posts = direct CDN mp4; photo galleries = every slide the platform publicly exposes, `truncated: true` when it degrades galleries |
-| **Pinterest** | — | ✅ | ✅ | image pins, video pins (direct mp4 + HLS variants), idea/story pins, `pin.it` short links |
-| **SoundCloud** | — | ✅ | ✅ | full tracks as direct progressive MP3 (+ HLS) with real titles/artists |
-| **Dailymotion** | — | ✅ | ✅ | public player metadata — HLS/progressive renditions (HLS saved as `.ts`) |
-| **Vimeo** | — | ✅ | ✅ | player config — progressive mp4 when served, HLS otherwise |
-| **Streamable** | — | ✅ | ✅ | direct mp4 renditions |
-| **Twitch** | — | ✅ | ✅ | clips = direct CloudFront mp4s; VODs/livestreams via the yt-dlp tier |
-| **Bluesky** | — | ✅ | ✅ | public AppView API — full-size images + video playlists |
-| **Instagram** | — | ✅ | ✅ | oEmbed→mobile info API: photos, videos, full carousels |
-| **Reddit** | — | ✅ | ✅ | posts + galleries + video with its audio sidecar (DC IPs may 403 — typed honest error) |
-| **X** | — | ✅ | ✅ | syndication token + guest GraphQL: photos/videos/gifs at real bitrates |
-| **Facebook** | — | ✅ | ✅ | reels/watch/videos/shares/fb.watch via the web player JSON |
-| **Threads** | — | ✅ | ✅ | post SSR state + og media (Meta gates some networks — typed honest error) |
-| **Snapchat** | — | ✅ | ✅ | spotlight videos (direct sc-cdn mp4) + public stories/highlights — ALL snaps in order |
-| **Rumble** | — | ✅ best-effort | ✅ best-effort | embed API direct mp4s (site blocks datacenter IPs) |
-| **Tumblr** | — | ✅ | ✅ | mobile API: video/audio/photo posts + reblog trails, all in order |
-| **iTunes** | ✅ | — | ✅ previews | real 30s clips, rock solid |
-| **1800+ sites** | — | ✅ | ✅ | optional tier: `pip install yt-dlp` — labeled `source: "ytdlp"` |
-
-**\* About YouTube stream URLs:** YouTube bot-gates datacenter IPs and serves formats without URLs.
-On typical home connections `download()` just works; on hard networks you'll get a typed
-`PROVIDER_UNAVAILABLE` with the real reason — or run `download({ … })` via
-`downloadWithYtdlp()` / `umedia download <url> --ytdlp` which handles PO tokens, cookies and muxing.
-We'd rather tell you the truth than fake a download.
-
-**Direct media URLs always work:** give `resolve()`/`download()` any direct `.mp4/.m4a/.jpg/…` link and it
-goes straight to disk — no platform needed.
-
-```js
-// the power tier — one function, 1800+ sites, hard networks
-await media.downloadWithYtdlp({ url: "https://example.com/anything", quality: "720p", dir: "./out" });
-```
-
----
-
-## 📚 API
-
-| Call | What it does |
-|---|---|
-| `media.search({q, type, limit, adult})` | Multi-source search — `type`: `video` \| `music` \| `movie` \| `short_video` |
-| `media.resolve(url)` | Every media item of a post, in order + honest `engine.attempts` |
-| `media.download({url, quality, dir, zip, onProgress})` | Saves files to disk — `quality`: `original` \| `best` \| `2160p` … `144p` \| `audio` |
-| `media.downloadWithYtdlp({url, quality, dir})` | yt-dlp tier (requires `yt-dlp` on PATH) |
-| `media.capabilities()` | What THIS machine can actually do — never overstated |
-| `media.status()` | Real adapter status |
-
-**Error codes** — `INVALID_REQUEST` · `INVALID_URL` · `SSRF_BLOCKED` · `AUTH_REQUIRED` ·
-`AUTH_INVALID` · `RATE_LIMITED` · `MEDIA_NOT_FOUND` · `CONTENT_PRIVATE` · `ACCESS_RESTRICTED` ·
-`QUALITY_UNAVAILABLE` · `PROVIDER_ERROR` · `PROVIDER_UNAVAILABLE` · `TIMEOUT` · `NOT_FOUND` · `INTERNAL`
-
----
-
-## 🖥️ CLI
-
-```bash
-npx umedia search "lofi beats" --type music --limit 5
-npx umedia resolve "https://www.tiktok.com/@user/photo/7690630628697459990"
-npx umedia download "https://youtu.be/jNQXAC9IVRw" --quality best -o ./out
-npx umedia download "https://example.com/video" --ytdlp      # power tier
-npx umedia status
-```
-
----
-
-## 🧯 Safety, built in
-
-- **SSRF hygiene** — private, loopback and internal hosts are refused (`SSRF_BLOCKED`).
-- **No secrets to manage** — there are none. No keys, no tokens, no dashboards.
-- **Zero telemetry.** Your users' requests never touch anyone's server — because there isn't one.
-
----
-
-<div align="center">
-
-**Built to save you the hosting bill.** Ship the engine, not the infrastructure.
-
-MIT © 2026 · part of the [Unified Media API](https://dev-pappy-api-downloader.duckdns.org) project
-
-</div>