veodl 1.12.0 → 2.0.0

package/src/stats.js

@@ -1,63 +0,0 @@
-import { commandOutput } from './output.js';
-import { randomUUID } from 'node:crypto';
-import { readdir, lstat, rm } from 'node:fs/promises';
-import path from 'node:path';
-import { cacheBase } from './paths.js';
-import { readJson, writeJson } from './state.js';
-
-const fields = ['videos', 'audio', 'failed', 'skipped', 'cancelled', 'elapsedMs'];
-const pattern = /^[a-f0-9-]{36}\.json$/;
-const empty = () => Object.fromEntries(fields.map(key => [key, 0]));
-
-export function createStatsRecorder(root = cacheBase()) {
-  const file = path.join(root, 'stats', `${randomUUID()}.json`);
-  const totals = { version: 1, since: new Date().toISOString(), ...empty() };
-  return async delta => {
-    for (const key of fields) totals[key] += delta[key] || 0;
-    await writeJson(file, totals);
-  };
-}
-
-async function statFiles(root) {
-  const directory = path.resolve(root, 'stats');
-  const info = await lstat(directory).catch(error => { if (error.code === 'ENOENT') return null; throw error; });
-  if (!info) return [];
-  if (!info.isDirectory() || info.isSymbolicLink()) throw new Error(`Invalid statistics directory: ${directory}`);
-  return (await readdir(directory, { withFileTypes: true }))
-    .filter(entry => entry.isFile() && pattern.test(entry.name)).map(entry => path.join(directory, entry.name));
-}
-
-export async function readStats(root = cacheBase()) {
-  const result = { since: null, ...empty() };
-  for (const file of await statFiles(root)) {
-    const value = await readJson(file, null);
-    if (!value) continue;
-    if (value.version !== 1 || !Number.isFinite(Date.parse(value.since)) || fields.some(key => !Number.isFinite(value[key]) || value[key] < 0)) {
-      throw new Error(`Invalid statistics file: ${file}`);
-    }
-    if (!result.since || value.since < result.since) result.since = value.since;
-    for (const key of fields) result[key] += value[key];
-  }
-  return result;
-}
-
-// Called by flush only after registered runs have stopped and while its gate is held.
-export async function resetStats(root = cacheBase()) {
-  for (const file of await statFiles(root)) await rm(file, { force: true });
-}
-
-export async function statsMain(args = [], { stdout = process.stdout, root = cacheBase() } = {}) {
-  [args, stdout] = commandOutput(args, stdout);
-  if (args.length === 1 && ['--help', '-h'].includes(args[0])) {
-    stdout.write('veo stats [--json]\n\nShow recorded download totals. Time includes preparation, processing and saving,\nincluding failed attempts. Parallel run times are added together.\nStats start with this version; old downloads are not imported.\nUse veo flush --stats to clear temporary data and reset statistics.\n');
-    return 0;
-  }
-  if (args.length && (args.length !== 1 || args[0] !== '--json')) throw new Error('Usage: veo stats [--json]');
-  const stats = await readStats(root);
-  if (args[0] === '--json') stdout.write(`${JSON.stringify(stats)}\n`);
-  else {
-    const seconds = Math.floor(stats.elapsedMs / 1000);
-    stdout.write(`veo stats\n\nTracking since: ${stats.since || 'No downloads recorded yet'}\nVideos saved:   ${stats.videos}\nAudio saved:    ${stats.audio}\nTotal failures: ${stats.failed}\nSkipped:        ${stats.skipped}\nCancelled:      ${stats.cancelled}\nDownload time:  ${Math.floor(seconds / 3600)}h ${Math.floor(seconds / 60) % 60}m ${seconds % 60}s\n\nTime includes preparation, processing and saving. Active requests appear when finished.\n`);
-  }
-  return 0;
-}

package/src/terminal-size.js

@@ -1,8 +0,0 @@
-// Windows stderr can retain an old size between writes. Refresh the native TTY
-// before reading it; custom/test streams retain their own live columns getter.
-export function terminalColumns(stream) {
-  if (process.platform === 'win32' && (stream === process.stdout || stream === process.stderr)) {
-    try { stream._refreshSize?.(); } catch { /* Cosmetic fallback only. */ }
-  }
-  return Number.isInteger(stream.columns) && stream.columns > 0 ? stream.columns : 80;
-}

package/src/terminal-title.js

@@ -1,19 +0,0 @@
-import { cleanText } from './utils.js';
-
-// PowerShell's console title API on Windows; OSC 0 on xterm-compatible Unix
-// terminals. Never put escape sequences into redirected output or dumb terminals.
-export function createTerminalTitle(stream, { platform = process.platform, env = process.env, processInfo = process } = {}) {
-  let previous;
-  return title => {
-    if (!stream.isTTY || env.TERM === 'dumb') return;
-    const safe = cleanText(title).slice(0, 240);
-    if (safe === previous) return;
-    try {
-      if (platform === 'win32') processInfo.title = safe;
-      else stream.write(`\x1b]0;${safe}\x07`);
-      previous = safe;
-    } catch {
-      // Cosmetic only: a terminal that rejects titles must not break downloads.
-    }
-  };
-}

package/src/tool-setup.js

@@ -1,151 +0,0 @@
-import { spawn } from 'node:child_process';
-import { access, chmod, mkdtemp, realpath, rm, stat } from 'node:fs/promises';
-import path from 'node:path';
-import { cleanText } from './utils.js';
-
-// Only fixed package names and arguments are passed to these installers.
-export function runSetup(command, args, {
-  signal, env = process.env, cwd, status = () => {}, timeoutMs = 600_000,
-} = {}) {
-  signal?.throwIfAborted();
-  return new Promise((resolve, reject) => {
-    const child = spawn(command, args, {
-      shell: false, windowsHide: true, detached: process.platform !== 'win32',
-      stdio: ['ignore', 'pipe', 'pipe'], env, cwd,
-    });
-    let output = '';
-    let stopped;
-    const stop = error => {
-      if (stopped) return;
-      stopped = error;
-      if (process.platform === 'win32' && child.pid) {
-        const killer = spawn('taskkill.exe', ['/PID', String(child.pid), '/T', '/F'], { shell: false, windowsHide: true, stdio: 'ignore' });
-        killer.on('error', () => child.kill());
-      } else {
-        try { process.kill(-child.pid, 'SIGKILL'); } catch { child.kill('SIGKILL'); }
-      }
-    };
-    const abort = () => stop(signal.reason);
-    const timer = setTimeout(() => stop(new Error('Tool installation timed out. Retry with veo doctor fix.')), timeoutMs);
-    const receive = chunk => {
-      const text = cleanText(String(chunk));
-      output = (output + text).slice(-8192);
-      // Surface package-manager progress without taking over stdin or stdout.
-      for (const line of text.split(/[\r\n]+/)) if (line.trim()) status(line.slice(0, 500));
-    };
-    child.stdout.on('data', receive);
-    child.stderr.on('data', receive);
-    signal?.addEventListener('abort', abort, { once: true });
-    if (signal?.aborted) abort();
-    const cleanup = () => { clearTimeout(timer); signal?.removeEventListener('abort', abort); };
-    child.once('error', error => { cleanup(); reject(stopped || error); });
-    child.once('close', code => {
-      cleanup();
-      if (stopped) reject(stopped);
-      else if (code !== 0) reject(new Error(`${path.basename(command)} exited with code ${code}: ${output.trim()}`));
-      else resolve(output);
-    });
-  });
-}
-
-export async function hasTermuxEjs({ find, run = runSetup, signal }) {
-  const python = await find(['python', 'python3']);
-  if (!python) return false;
-  try {
-    await run(python, ['-B', '-c', 'import yt_dlp_ejs'], { signal, timeoutMs: 15_000 });
-    return true;
-  } catch {
-    signal?.throwIfAborted();
-    return false;
-  }
-}
-
-let termuxInstall;
-export async function installTermuxTools({ find, signal, status, run = runSetup, env = process.env }) {
-  if (termuxInstall) {
-    await termuxInstall;
-    signal?.throwIfAborted();
-    return;
-  }
-  termuxInstall = (async () => {
-    const pkg = await find(['pkg']);
-    if (!pkg) throw new Error('Automatic Android setup requires Termux with pkg on PATH. Install python-yt-dlp, yt-dlp-ejs and ffmpeg in Termux.');
-    signal?.throwIfAborted();
-    status('Installing yt-dlp, JavaScript support and FFmpeg with Termux pkg (first use)…');
-    // pkg refreshes mirrors/package lists itself. No full system upgrade or sudo.
-    await run(pkg, ['install', env.TERMUX_APP_PACKAGE_MANAGER === 'pacman' ? '--noconfirm' : '-y', 'python-yt-dlp', 'yt-dlp-ejs', 'ffmpeg'], {
-      signal, status, env: { ...env, DEBIAN_FRONTEND: 'noninteractive' },
-    });
-  })();
-  try { await termuxInstall; }
-  catch (cause) {
-    signal?.throwIfAborted();
-    throw new Error(`Automatic Termux setup failed: ${cause.message}. Retry with veo doctor fix; if the repository needs repair, run pkg update in Termux.`, { cause });
-  } finally { termuxInstall = undefined; }
-}
-
-export function mediaPackagePlan(platform = process.platform, arch = process.arch) {
-  // Windows 11 ARM runs the upstream x64 media tools via OS emulation.
-  const binaryArch = platform === 'win32' && arch === 'arm64' ? 'x64' : arch;
-  const versions = {
-    'win32-x64': '5.1.0', 'win32-ia32': '5.1.0',
-    'darwin-x64': '5.1.0', 'darwin-arm64': '5.0.1',
-    'linux-x64': '5.2.0', 'linux-ia32': '5.2.0', 'linux-arm64': '5.2.0', 'linux-arm': '5.2.0',
-  };
-  const target = `${platform}-${binaryArch}`;
-  if (!versions[target]) return undefined;
-  return { binaryArch, probePackage: `@ffprobe-installer/${target}`, probeVersion: versions[target] };
-}
-
-async function npmCli(find, env) {
-  const npm = await find(['npm']);
-  const candidates = [
-    env.npm_execpath,
-    npm && await realpath(npm).catch(() => undefined),
-    npm && path.join(path.dirname(npm), 'node_modules', 'npm', 'bin', 'npm-cli.js'),
-    path.join(path.dirname(process.execPath), 'node_modules', 'npm', 'bin', 'npm-cli.js'),
-    path.resolve(path.dirname(process.execPath), '../lib/node_modules/npm/bin/npm-cli.js'),
-  ];
-  for (const candidate of candidates) {
-    if (!candidate || path.basename(candidate) !== 'npm-cli.js') continue;
-    if (await stat(candidate).then(info => info.isFile(), () => false)) return candidate;
-  }
-  throw new Error('npm was not found. Install Node.js with npm, then run veo doctor fix.');
-}
-
-export async function installMediaTools({
-  directory, find, stage, signal, status, platform = process.platform, arch = process.arch,
-  env = process.env, run = runSetup, locateNpm = npmCli,
-}) {
-  const plan = mediaPackagePlan(platform, arch);
-  if (!plan) throw new Error(`Automatic FFmpeg setup is unavailable for ${platform}/${arch}. Set VEO_FFMPEG_PATH to a directory containing ffmpeg and ffprobe.`);
-  const cli = await locateNpm(find, env);
-  const temporary = await mkdtemp(path.join(directory, '.media-setup-'));
-  const suffix = platform === 'win32' ? '.exe' : '';
-  try {
-    status('Downloading FFmpeg and FFprobe into the veo cache (first use)…');
-    // This is a private throwaway project, never the global package or cwd.
-    // Ignore dependency scripts; invoke the pinned ffmpeg installer explicitly.
-    const args = [cli, 'install', '--prefix', temporary, '--no-save', '--package-lock=false', '--ignore-scripts', '--no-audit', '--no-fund', '--global=false', 'ffmpeg-static@5.3.0', `${plan.probePackage}@${plan.probeVersion}`];
-    if (platform === 'win32' && arch === 'arm64') args.push('--force');
-    await run(process.execPath, args, { signal, status, cwd: temporary, env });
-    const modules = path.join(temporary, 'node_modules');
-    await run(process.execPath, [path.join(modules, 'ffmpeg-static', 'install.js')], {
-      signal, status, cwd: temporary,
-      env: { ...env, npm_config_platform: platform, npm_config_arch: plan.binaryArch, FFMPEG_BIN: '', FFMPEG_BINARY_RELEASE: 'b6.1.1' },
-    });
-    const ffmpeg = path.join(modules, 'ffmpeg-static', `ffmpeg${suffix}`);
-    const ffprobe = path.join(modules, ...plan.probePackage.split('/'), `ffprobe${suffix}`);
-    for (const file of [ffmpeg, ffprobe]) {
-      await access(file);
-      if (process.platform !== 'win32') await chmod(file, 0o755);
-      await run(file, ['-version'], { signal, timeoutMs: 15_000 });
-    }
-    await stage(ffmpeg, path.join(directory, `ffmpeg${suffix}`), signal);
-    await stage(ffprobe, path.join(directory, `ffprobe${suffix}`), signal);
-    return directory;
-  } catch (cause) {
-    signal?.throwIfAborted();
-    throw new Error(`Automatic FFmpeg setup failed: ${cause.message}. Retry with veo doctor fix or set VEO_FFMPEG_PATH to installed tools.`, { cause });
-  } finally { await rm(temporary, { recursive: true, force: true }); }
-}

package/src/uninstall.js

@@ -1,222 +0,0 @@
-import path from 'node:path';
-import { spawn } from 'node:child_process';
-import { rm } from 'node:fs/promises';
-import { commandOutput } from './output.js';
-import { cacheBase } from './paths.js';
-import { configFile as resolveConfigFile } from './config.js';
-import { cleanText, readableError } from './utils.js';
-import { removeAlias, validateAliasName, listAliases } from './alias.js';
-
-const PACKAGE = 'veodl';
-
-export const UNINSTALL_HELP = `veo uninstall - remove veo completely or one command alias
-
-Usage:
-  veo uninstall [-p|--prefix <name>] [--json]
-                               Remove one alias (e.g. veo uninstall -p veodl)
-  veo uninstall [--yes] [--keep-cache] [--keep-config] [--keep-aliases] [--json]
-                               Remove everything: aliases, package, cache, config
-  veo uninstall --help         Show this help
-
-With -p/--prefix, only that alias is deleted; veo itself stays installed.
-Without -p, veo prints what would be removed. Add --yes to delete everything:
-custom wrappers created with veo alias add, the ${PACKAGE} package itself
-(commands veo, veodl) with npm, veo's cache directory (downloads, jobs,
-backend tools, history, statistics) and the config file. Use --keep-cache,
---keep-config or --keep-aliases to preserve one part. The config file is
-deleted by default; its path is shown before and after.
-`;
-
-export function npmUninstallCommand({ platform = process.platform } = {}) {
-  const args = ['uninstall', '-g', PACKAGE];
-  if (platform === 'win32') {
-    return {
-      command: 'cmd.exe',
-      args: ['/d', '/s', '/c', `npm ${args.join(' ')}`],
-      shell: false,
-      windowsVerbatimArguments: true,
-    };
-  }
-  return { command: 'npm', args, shell: false };
-}
-
-export function runNpmUninstall({ spawnImpl = spawn, platform = process.platform, signal, timeoutMs = 600_000 } = {}) {
-  const { command, args, ...spawnOptions } = npmUninstallCommand({ platform });
-  return new Promise((resolve, reject) => {
-    const child = spawnImpl(command, args, { ...spawnOptions, stdio: 'inherit', windowsHide: true, signal: signal ? AbortSignal.any([signal, AbortSignal.timeout(timeoutMs)]) : AbortSignal.timeout(timeoutMs) });
-    child.once('error', reject);
-    child.once('close', resolve);
-  });
-}
-
-function parseUninstallArgs(args) {
-  let prefix;
-  let yes = false;
-  let keepCache = false;
-  let keepConfig = false;
-  let keepAliases = false;
-  let json = false;
-  let binDir;
-  const rest = [];
-  for (let index = 0; index < args.length; index++) {
-    const token = args[index];
-    if (token === '-p' || token === '--prefix') {
-      prefix = args[++index];
-      if (!prefix) throw new Error('--prefix requires an alias name. Use: veo uninstall -p veodl');
-    } else if (token.startsWith('-p=')) {
-      prefix = token.slice(3) || undefined;
-      if (!prefix) throw new Error('--prefix requires an alias name. Use: veo uninstall -p veodl');
-    } else if (token.startsWith('--prefix=')) {
-      prefix = token.slice(9) || undefined;
-      if (!prefix) throw new Error('--prefix requires an alias name. Use: veo uninstall -p veodl');
-    } else if (token === '--yes') yes = true;
-    else if (token === '--purge') {
-      // Deprecated: full cleanup is now the default. Kept so older commands keep working.
-    } else if (token === '--keep-cache') keepCache = true;
-    else if (token === '--keep-config') keepConfig = true;
-    else if (token === '--keep-aliases') keepAliases = true;
-    else if (token === '--json') json = true;
-    else if (token === '--bin-dir') {
-      binDir = args[++index];
-      if (!binDir) throw new Error('--bin-dir requires a directory.');
-    } else if (token.startsWith('--bin-dir=')) {
-      binDir = token.slice(10) || undefined;
-      if (!binDir) throw new Error('--bin-dir requires a directory.');
-    } else rest.push(token);
-  }
-  return { prefix, yes, keepCache, keepConfig, keepAliases, json, binDir, rest };
-}
-
-export async function uninstallMain(args = [], {
-  stdout = process.stdout,
-  stderr = process.stderr,
-  platform = process.platform,
-  env = process.env,
-  spawnImpl = spawn,
-  rmImpl = rm,
-  cacheRoot,
-  configFile,
-  listImpl = listAliases,
-  removeImpl = removeAlias,
-} = {}) {
-  [args, stdout, stderr] = commandOutput(args, stdout, stderr);
-  const { prefix, yes, keepCache, keepConfig, keepAliases, json, binDir, rest } = parseUninstallArgs(args);
-  if (rest.includes('-h') || rest.includes('--help')) {
-    stdout.write(UNINSTALL_HELP);
-    return 0;
-  }
-  if (rest.length) throw new Error(`Unknown option for veo uninstall: ${rest.join(' ')}. Use: veo uninstall --help`);
-
-  if (prefix) {
-    if (keepCache || keepConfig || keepAliases) throw new Error('--keep-* cannot be combined with --prefix. Remove one alias or uninstall veo itself.');
-    const valid = validateAliasName(prefix);
-    const removed = await removeImpl(valid, { binDir, platform, env });
-    if (json) {
-      stdout.write(`${JSON.stringify({ status: 'removed', ...removed })}\n`);
-      return 0;
-    }
-    stdout.write(`Alias removed: ${removed.name} (${removed.removed.length} file(s) in ${removed.binDir})\n`);
-    if (removed.builtin) stdout.write('Note: veo update recreates the shipped veodl name.\n');
-    return 0;
-  }
-
-  const cache = cacheRoot || cacheBase({ platform, env });
-  const config = configFile || resolveConfigFile({ platform, env });
-  const manual = `npm uninstall -g ${PACKAGE}`;
-
-  // Custom wrappers first so the plan names them; npm removes veo/veodl itself.
-  let customAliases = [];
-  let aliasDir = binDir ? path.resolve(binDir) : null;
-  try {
-    const listed = await listImpl({ binDir: binDir || undefined, platform, env });
-    aliasDir = listed.binDir;
-    customAliases = listed.aliases.filter(entry => entry.present && entry.managed && !entry.builtin).map(entry => entry.name);
-  } catch {
-    // No bin directory (e.g. running from source without a global install):
-    // npm uninstall still works, alias cleanup is reported as skipped.
-  }
-
-  if (!yes) {
-    if (json) {
-      stdout.write(`${JSON.stringify({ status: 'planned', package: PACKAGE, manual, aliases: customAliases, binDir: aliasDir, cache, config })}\n`);
-      return 0;
-    }
-    stdout.write(`This removes everything: the ${PACKAGE} package with npm (commands veo, veodl).\n`);
-    if (!keepAliases) {
-      stdout.write(customAliases.length
-        ? `Custom wrappers to delete: ${customAliases.join(', ')} (${aliasDir})\n`
-        : `Custom wrappers: none found${aliasDir ? ` (${aliasDir})` : ''}.\n`);
-    }
-    if (!keepCache) stdout.write(`Cache to delete: ${cache}\n`);
-    if (!keepConfig) stdout.write(`Config to delete: ${config}\n`);
-    if (keepCache || keepConfig || keepAliases) {
-      const kept = [
-        keepAliases && 'aliases',
-        keepCache && 'cache',
-        keepConfig && 'config',
-      ].filter(Boolean).join(', ');
-      stdout.write(`Kept: ${kept}.\n`);
-    }
-    const keepFlags = `${keepAliases ? ' --keep-aliases' : ''}${keepCache ? ' --keep-cache' : ''}${keepConfig ? ' --keep-config' : ''}`;
-    stdout.write(`Run with --yes to proceed: veo uninstall --yes${keepFlags}\n`);
-    stdout.write(`Manual command: ${manual}\n`);
-    return 0;
-  }
-
-  let code;
-  try {
-    stdout.write(`Uninstalling ${PACKAGE} with npm…\n`);
-    code = await runNpmUninstall({ spawnImpl, platform, signal: AbortSignal.timeout(600_000) });
-  } catch (error) {
-    const reason = error.code === 'ENOENT' ? 'npm was not found. Install Node.js/npm, or uninstall manually.' : `Could not run npm: ${readableError(error)}`;
-    stderr.write(`veo: ${reason}\nManual command: ${manual}\n`);
-    return 1;
-  }
-  if (code !== 0) {
-    stderr.write(`veo: npm exited with code ${code}. Uninstall manually with: ${manual}\n`);
-    return 1;
-  }
-
-  const removedAliases = [];
-  if (!keepAliases) {
-    for (const name of customAliases) {
-      try {
-        await removeImpl(name, { binDir: aliasDir, platform, env });
-        removedAliases.push(name);
-      } catch (error) {
-        stderr.write(`veo: removed the package but could not delete alias ${name}: ${readableError(error)}\n`);
-        return 1;
-      }
-    }
-  }
-  let cacheDeleted = false;
-  if (!keepCache) {
-    try {
-      await rmImpl(cache, { recursive: true, force: true });
-      cacheDeleted = true;
-    } catch (error) {
-      stderr.write(`veo: removed the package but could not delete the cache ${cache}: ${readableError(error)}\n`);
-      return 1;
-    }
-  }
-  let configDeleted = false;
-  if (!keepConfig) {
-    try {
-      await rmImpl(config, { force: true });
-      configDeleted = true;
-    } catch (error) {
-      stderr.write(`veo: removed the package but could not delete the config ${config}: ${readableError(error)}\n`);
-      return 1;
-    }
-  }
-  if (json) {
-    stdout.write(`${JSON.stringify({ status: 'uninstalled', package: PACKAGE, aliases: removedAliases, binDir: aliasDir, cacheDeleted, cache, configDeleted, config })}\n`);
-    return 0;
-  }
-  stdout.write(`veo uninstalled (${PACKAGE}).`);
-  if (!keepAliases) stdout.write(removedAliases.length ? ` Aliases deleted: ${removedAliases.join(', ')}.` : ' No custom wrappers found.');
-  stdout.write(cacheDeleted ? ` Cache deleted: ${cache}.` : ` Cache kept: ${cache}.`);
-  stdout.write(configDeleted ? ` Config deleted: ${config}.` : ` Config kept: ${config}.`);
-  stdout.write('\n');
-  return 0;
-}