@vosjs/cli 0.37.0 → 0.38.0

package/dist/chunk-NHKHTIDR.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/args.ts","../src/loadConfig.ts","../src/browser.ts"],"sourcesContent":["/**\n * Minimal argv parser — positionals + `--flag value` / `--flag=value` /\n * boolean flags. Deliberately tiny: the CLI has a small, stable surface and\n * agents benefit from predictable, dependency-free parsing.\n */\nexport interface ParsedArgs {\n  positionals: string[]\n  flags: Record<string, string | true>\n}\n\nexport class UsageError extends Error {}\n\nexport function parseArgs(\n  argv: string[],\n  booleanFlags: ReadonlySet<string>,\n): ParsedArgs {\n  const positionals: string[] = []\n  const flags: Record<string, string | true> = {}\n  for (let i = 0; i < argv.length; i++) {\n    const arg = argv[i]\n    if (arg === '--') {\n      positionals.push(...argv.slice(i + 1))\n      break\n    }\n    if (arg.startsWith('--')) {\n      const eq = arg.indexOf('=')\n      if (eq !== -1) {\n        flags[arg.slice(2, eq)] = arg.slice(eq + 1)\n        continue\n      }\n      const name = arg.slice(2)\n      if (booleanFlags.has(name)) {\n        flags[name] = true\n        continue\n      }\n      const next = argv[i + 1]\n      if (next === undefined || next.startsWith('--')) {\n        throw new UsageError(`--${name} expects a value`)\n      }\n      flags[name] = next\n      i++\n      continue\n    }\n    positionals.push(arg)\n  }\n  return { positionals, flags }\n}\n\nexport function numFlag(\n  flags: ParsedArgs['flags'],\n  name: string,\n  fallback: number,\n): number {\n  const v = flags[name]\n  if (v === undefined) return fallback\n  const n = Number(v)\n  if (!Number.isFinite(n))\n    throw new UsageError(`--${name} expects a number, got \"${String(v)}\"`)\n  return n\n}\n","import { readFile } from 'node:fs/promises'\nimport { existsSync, readFileSync, statSync } from 'node:fs'\nimport { join } from 'node:path'\nimport {\n  CURRENT_CONFIG_VERSION,\n  migrateConfig,\n  vosConfigJsonSchema,\n} from '@vosjs/core'\nimport { UsageError } from './args'\n\nexport interface LoadedConfig {\n  config: Record<string, unknown>\n  warnings: string[]\n}\n\n/**\n * What a directory holds, by one deterministic sniff and never a flag:\n * a TAKE carries a recording document (`doc.json` with `source`); a PROGRAM\n * directory carries `config.json`, optionally beside a program document\n * (`doc.json` without `source`: the shared layers, the tween overlay, the\n * program's own length, with `program.config` omitted on disk). An unparsable\n * doc.json counts as a take so the take path reports the real error.\n */\nexport type DirectoryKind = 'take' | 'program' | 'none'\n\nexport function directoryKind(target: string): DirectoryKind {\n  try {\n    if (!statSync(target).isDirectory()) return 'none'\n  } catch {\n    return 'none'\n  }\n  const docPath = join(target, 'doc.json')\n  if (existsSync(docPath)) {\n    try {\n      const doc: unknown = JSON.parse(readFileSync(docPath, 'utf8'))\n      if (typeof doc === 'object' && doc !== null && 'source' in doc)\n        return 'take'\n    } catch {\n      return 'take'\n    }\n  }\n  return existsSync(join(target, 'config.json')) ? 'program' : 'none'\n}\n\n/**\n * A program directory's config: `config.json`, composed with the program\n * document beside it when there is one (the layers ride as the studio stack\n * entry, the tween overlay is baked into `createTimeline`), so a render of\n * the directory is a render of what the studio and vos.so play.\n */\nexport async function loadProgramDirectory(\n  dir: string,\n  warnings: string[],\n): Promise<unknown> {\n  const config: unknown = JSON.parse(\n    await readFile(join(dir, 'config.json'), 'utf8'),\n  )\n  const docPath = join(dir, 'doc.json')\n  if (!existsSync(docPath)) return config\n  const doc: unknown = JSON.parse(await readFile(docPath, 'utf8'))\n  if (typeof doc !== 'object' || doc === null || 'source' in doc) return config\n  if (typeof config !== 'object' || config === null) {\n    throw new UsageError(`${dir}/config.json does not contain a JSON object`)\n  }\n  const raw = doc as Record<string, unknown>\n  const program =\n    raw.program && typeof raw.program === 'object'\n      ? (raw.program as Record<string, unknown>)\n      : {}\n  const { lowerProgramDoc } = await import('@vosjs/studio-core')\n  const composed = lowerProgramDoc(\n    { ...raw, program: { ...program, config } } as never,\n    { bake: true },\n  ).config\n  warnings.push(\n    'composed config.json with doc.json (a program document: its layers and tween edits ride the render)',\n  )\n  return composed\n}\n\n/**\n * The text of a config source: an http(s) URL or a file. A directory that is\n * neither a take nor a program directory is refused in words, since the raw\n * read would report a bare EISDIR.\n */\nexport async function readSourceText(source: string): Promise<string> {\n  if (/^https?:\\/\\//.test(source)) {\n    const res = await fetch(source)\n    if (!res.ok) throw new Error(`fetch ${source} → ${res.status}`)\n    return await res.text()\n  }\n  let isDir = false\n  try {\n    isDir = statSync(source).isDirectory()\n  } catch {\n    /* a missing path reads below and reports itself */\n  }\n  if (isDir) {\n    throw new UsageError(\n      `${source} is a directory with no config.json and no doc.json — pass a config file, a URL, a program directory or a take`,\n    )\n  }\n  return await readFile(source, 'utf8')\n}\n\n/**\n * Load a VosConfigJson from a file path, an http(s) URL, or a program\n * directory (config.json, composed with a program document when one sits\n * beside it); unwrap API `{ config }` envelopes, migrate old versions, and\n * validate against the schema. A take directory is refused here in words:\n * takes render through the take pipeline (`vos render <take>`).\n */\nexport async function loadVosConfig(source: string): Promise<LoadedConfig> {\n  const warnings: string[] = []\n  let parsed: unknown\n  const kind = /^https?:\\/\\//.test(source) ? 'none' : directoryKind(source)\n  if (kind === 'take') {\n    throw new UsageError(\n      `${source} is a take (its doc.json is a recording document). Render it through the take pipeline: vos render ${source} [out]; vos frames ${source} for stills.`,\n    )\n  }\n  if (kind === 'program') {\n    parsed = await loadProgramDirectory(source, warnings)\n    return finish(source, parsed, warnings)\n  }\n  const raw = await readSourceText(source)\n\n  try {\n    parsed = JSON.parse(raw)\n  } catch (e) {\n    throw new UsageError(`${source} is not valid JSON: ${(e as Error).message}`)\n  }\n  return finish(source, parsed, warnings)\n}\n\nfunction finish(\n  source: string,\n  parsed: unknown,\n  warnings: string[],\n): LoadedConfig {\n  if (typeof parsed !== 'object' || parsed === null) {\n    throw new UsageError(`${source} does not contain a JSON object`)\n  }\n\n  // API endpoints wrap the config: { config: {...} }.\n  let obj = parsed as Record<string, unknown>\n  if (\n    typeof obj.config === 'object' &&\n    obj.config !== null &&\n    !('createTimeline' in obj)\n  ) {\n    obj = obj.config as Record<string, unknown>\n    warnings.push('unwrapped { config } envelope')\n  }\n\n  const version = obj.version\n  const migrated = migrateConfig(obj)\n  if (version === undefined) {\n    // Plays fine (the stamp happens above), but a storer refuses it.\n    warnings.push(\n      `config declares no \"version\". Add \"version\": ${CURRENT_CONFIG_VERSION} before pushing it.`,\n    )\n  } else if (version !== CURRENT_CONFIG_VERSION) {\n    warnings.push(\n      `migrated config v${String(version)} to v${CURRENT_CONFIG_VERSION}`,\n    )\n  }\n\n  const check = vosConfigJsonSchema.safeParse(migrated)\n  if (!check.success) {\n    const issues = check.error.issues\n      .slice(0, 5)\n      .map((i) => `  ${i.path.join('.') || '(root)'}: ${i.message}`)\n      .join('\\n')\n    throw new UsageError(`invalid vos config:\\n${issues}`)\n  }\n\n  return { config: migrated, warnings }\n}\n\n/** Best-effort duration from the config (seconds). */\nexport function configDuration(\n  config: Record<string, unknown>,\n): number | undefined {\n  const d = config.duration\n  return typeof d === 'number' && Number.isFinite(d) && d > 0 ? d : undefined\n}\n","import { chromium } from 'playwright'\nimport type { Browser } from 'playwright'\n\nexport class BrowserUnavailableError extends Error {\n  constructor(cause: string) {\n    super(\n      `Could not launch a Chromium-family browser (${cause}).\\n` +\n        `Fixes, in order of preference:\\n` +\n        `  1. Install Google Chrome (used automatically), or\\n` +\n        `  2. npx playwright install chromium, or\\n` +\n        `  3. Set VOS_BROWSER_PATH to a Chrome/Chromium executable.`,\n    )\n  }\n}\n\n/**\n * Launch headless Chromium: explicit VOS_BROWSER_PATH → system Chrome\n * (no download needed) → Playwright's bundled Chromium.\n */\nexport async function launchBrowser(): Promise<Browser> {\n  const explicit = process.env.VOS_BROWSER_PATH\n  if (explicit) {\n    return chromium.launch({ executablePath: explicit }).catch((e) => {\n      throw new BrowserUnavailableError(\n        `VOS_BROWSER_PATH failed: ${(e as Error).message}`,\n      )\n    })\n  }\n  try {\n    return await chromium.launch({ channel: 'chrome' })\n  } catch {\n    try {\n      return await chromium.launch()\n    } catch (e) {\n      throw new BrowserUnavailableError(\n        (e as Error).message.split('\\n')[0] ?? 'unknown',\n      )\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/run-6T4NK5P2.js

@@ -1,9 +0,0 @@
-#!/usr/bin/env node
-import {
-  run
-} from "./chunk-DD6OXVFJ.js";
-import "./chunk-NHKHTIDR.js";
-export {
-  run
-};
-//# sourceMappingURL=run-6T4NK5P2.js.map