@tacone/prosey 0.2.3 → 0.2.6

package/bin/prosey

@@ -2114,7 +2114,7 @@ var require_symbol_define_to_primitive = __commonJS((exports, module) => {
     var valueOf = SymbolPrototype && SymbolPrototype.valueOf;
     var TO_PRIMITIVE = wellKnownSymbol("toPrimitive");
     if (SymbolPrototype && !SymbolPrototype[TO_PRIMITIVE]) {
-      defineBuiltIn(SymbolPrototype, TO_PRIMITIVE, function(hint) {
+      defineBuiltIn(SymbolPrototype, TO_PRIMITIVE, function(hint2) {
         return call(valueOf, this);
       }, { arity: 1 });
     }
@@ -4397,9 +4397,9 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
     return global2 ? result || [] : result && result[0];
   };
   XRegExp.matchChain = function(str, chain) {
-    return function recurseChain(values, level) {
-      var item = chain[level].regex ? chain[level] : {
-        regex: chain[level]
+    return function recurseChain(values, level2) {
+      var item = chain[level2].regex ? chain[level2] : {
+        regex: chain[level2]
       };
       var matches = [];
       function addMatch(match) {
@@ -4430,7 +4430,7 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
       } finally {
         _iterator3.f();
       }
-      return level === chain.length - 1 || !matches.length ? matches : recurseChain(matches, level + 1);
+      return level2 === chain.length - 1 || !matches.length ? matches : recurseChain(matches, level2 + 1);
     }([str], 0);
   };
   XRegExp.replace = function(str, search, replacement, scope) {
@@ -94145,9 +94145,81 @@ ${Me13.join(`
   Y42 = k0(G42);
 });
 
+// src/debug.ts
+var GRAY = "\x1B[90m";
+var RESET = "\x1B[0m";
+var level = "normal";
+function setLevel(l) {
+  level = l;
+}
+var lastTime = performance.now();
+var resumed = false;
+function stamp() {
+  const now = performance.now();
+  if (resumed) {
+    lastTime = now;
+    resumed = false;
+  }
+  const elapsed = now - lastTime;
+  lastTime = now;
+  const text = elapsed < 1000 ? `${elapsed.toFixed(0)}ms` : `${(elapsed / 1000).toFixed(1)}s`;
+  return text.padStart(5);
+}
+var INFO_BEFORE = "\x1B[0m\x1B[2m\x1B[1m";
+var INFO_AFTER = "\x1B[0m";
+function info(...args) {
+  if (level === "quiet")
+    return;
+  console.error(INFO_BEFORE, `[${stamp()}]`, ...args, INFO_AFTER);
+}
+function debug(...args) {
+  if (level !== "verbose")
+    return;
+  console.error(GRAY, `[${stamp()}]`, ...args, RESET);
+}
+function startTimer() {
+  resumed = true;
+}
+function resetTimer() {
+  lastTime = performance.now();
+  resumed = false;
+}
+var YELLOW = "\x1B[33m";
+function hint(message) {
+  console.error(YELLOW + message + RESET + " " + GRAY + "[use prosey config to disable hints]" + RESET);
+}
+
 // src/index.ts
+import { spawn as spawn2 } from "node:child_process";
 import { writeFile as writeFile3 } from "node:fs/promises";
 
+// src/pager.ts
+import { execSync } from "node:child_process";
+function hasCommand(cmd) {
+  try {
+    execSync(`command -v ${cmd} 2>/dev/null`, { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function detectPager(cfgPager) {
+  const env = process.env.PROSEY_PAGER;
+  if (env !== undefined && env !== "" && env !== "auto")
+    return env;
+  if (cfgPager !== undefined && cfgPager !== "" && cfgPager !== "auto")
+    return cfgPager;
+  if (hasCommand("bat"))
+    return "bat -lmd --style plain";
+  if (hasCommand("glow"))
+    return "glow -p";
+  if (hasCommand("mdcat"))
+    return "mdcat -l -p";
+  if (hasCommand("less"))
+    return "less";
+  return null;
+}
+
 // node_modules/youtube-transcript-plus/dist/youtube-transcript-plus.mjs
 function __awaiter(thisArg, _arguments, P, generator) {
   function adopt(value) {
@@ -101530,6 +101602,16 @@ var lt = (r) => {
 var FALLBACK_CONFIG_TOML = `# Default prosey configuration
 # Created automatically on first run. Edit as needed.
 
+# Pager command for transcript and summary output.
+# Defaults to "auto": bat -lmd --style plain → glow -p → mdcat -l -p → less
+# Set to a custom command (e.g. "less -R") to override.
+# Can also be set via the PROSEY_PAGER env var (takes precedence).
+pager = "auto"
+
+# Show hints for missing tools (e.g. markdown highlighter).
+# Can also be set via PROSEY_HINTS env var (yes, no, 1, 0, true, false).
+hints = true
+
 [summarize]
 # Prompt sent to the command via stdin.
 # Customize this to change how transcripts are summarized.
@@ -101674,23 +101756,10 @@ async function writeCache(dir, filename, data) {
     await mkdir2(dir, { recursive: true });
   await writeFile2(join2(dir, filename), data, "utf8");
 }
-
-// src/debug.ts
-var GRAY = "\x1B[90m";
-var RESET = "\x1B[0m";
-var enabled = false;
-function enableDebug() {
-  enabled = true;
-}
-function debug(...args) {
-  if (!enabled)
-    return;
-  console.error(GRAY, ...args, RESET);
-}
 // package.json
 var package_default = {
   name: "@tacone/prosey",
-  version: "0.2.3",
+  version: "0.2.6",
   description: "Download YouTube video transcripts from the CLI",
   module: "src/index.ts",
   type: "module",
@@ -101753,6 +101822,31 @@ var package_default = {
   }
 };
 
+// src/version-check.ts
+var TIMEOUT_MS = 3000;
+var registryUrl = `https://registry.npmjs.org/${package_default.name}/latest`;
+async function checkVersion() {
+  try {
+    const controller = new AbortController;
+    const timer2 = setTimeout(() => controller.abort(), TIMEOUT_MS);
+    const res = await fetch(registryUrl, { signal: controller.signal });
+    clearTimeout(timer2);
+    if (!res.ok) {
+      debug("Version check failed: HTTP", res.status);
+      return null;
+    }
+    const data = await res.json();
+    if (!data.version) {
+      debug("Version check: no version field in response");
+      return null;
+    }
+    return data.version;
+  } catch (err) {
+    debug("Version check error:", err instanceof Error ? err.message : String(err));
+    return null;
+  }
+}
+
 // node_modules/prettier/index.mjs
 import { createRequire as __prettierCreateRequire } from "module";
 import { fileURLToPath as __prettierFileUrlToPath } from "url";
@@ -102266,7 +102360,7 @@ function addAlignmentToDoc(doc, size, tabWidth) {
   assertDoc(doc);
   let aligned = doc;
   if (size > 0) {
-    for (let level = 0;level < Math.floor(size / tabWidth); ++level) {
+    for (let level2 = 0;level2 < Math.floor(size / tabWidth); ++level2) {
       aligned = indent(aligned);
     }
     aligned = align(size % tabWidth, aligned);
@@ -107697,7 +107791,7 @@ var require_partial = __commonJS2({
       match(filepath) {
         const parts = filepath.split("/");
         const levels = parts.length;
-        const patterns = this._storage.filter((info) => !info.complete || info.segments.length > levels);
+        const patterns = this._storage.filter((info2) => !info2.complete || info2.segments.length > levels);
         for (const pattern of patterns) {
           const section = pattern.sections[0];
           if (!pattern.complete && levels > section.length) {
@@ -108269,10 +108363,10 @@ var require_picocolors = __commonJS2({
       } while (~index);
       return result + string.substring(cursor2);
     };
-    var createColors2 = (enabled2 = isColorSupported2) => {
-      let f7 = enabled2 ? formatter : () => String;
+    var createColors2 = (enabled = isColorSupported2) => {
+      let f7 = enabled ? formatter : () => String;
       return {
-        isColorSupported: enabled2,
+        isColorSupported: enabled,
         reset: f7("\x1B[0m", "\x1B[0m"),
         bold: f7("\x1B[1m", "\x1B[22m", "\x1B[22m\x1B[1m"),
         dim: f7("\x1B[2m", "\x1B[22m", "\x1B[22m\x1B[2m"),
@@ -113965,8 +114059,8 @@ function buildDefs(colors) {
 }
 var defsOn = buildDefs((0, import_picocolors4.createColors)(true));
 var defsOff = buildDefs((0, import_picocolors4.createColors)(false));
-function getDefs(enabled2) {
-  return enabled2 ? defsOn : defsOff;
+function getDefs(enabled) {
+  return enabled ? defsOn : defsOff;
 }
 var sometimesKeywords = /* @__PURE__ */ new Set(["as", "async", "from", "get", "of", "set"]);
 var NEWLINE$1 = /\r\n|[\n\r\u2028\u2029]/;
@@ -120293,18 +120387,30 @@ var debugApis = {
 // src/index.ts
 var NAME2 = "prosey";
 var VERSION2 = package_default.version;
+var latestVersion = null;
+var versionCheck = checkVersion().then((v11) => {
+  latestVersion = v11;
+});
+function exitProcess(code) {
+  if (useHints && code === 0 && latestVersion && latestVersion !== VERSION2) {
+    hint(`\uD83D\uDCE6 New version available: ${latestVersion} — use npm/pnpm/bun -g i ${package_default.name} to upgrade`);
+  }
+  process.exit(code);
+}
 function help() {
   return `${NAME2} v${VERSION2}
 
 Usage: ${NAME2} [options] <video-url-or-id>
        ${NAME2} info [options] <video-url-or-id>
        ${NAME2} summarize [options] <video-url-or-id>
+       ${NAME2} config
 
 Download a YouTube video transcript or show video details.
 
 Commands:
   info                  Show video metadata (title, channel, duration, etc.)
   summarize             Pipe transcript to the command configured in [summarize]
+  config                Open config file in $EDITOR
 
 Arguments:
   video-url-or-id        YouTube URL (full or short) or bare video ID
@@ -120322,7 +120428,12 @@ Options:
   --reset-config         Reset config file to defaults and exit.
   --no-cache             Skip cache and overwrite cache files.
   --no-format            Skip prettier formatting.
-  --debug                Print debug information to stderr.
+  --no-pager             Disable pager for stdout output.
+  --pager                Use pager for stdout output (default).
+  --no-hints             Disable hints.
+  --hints                Show hints (default).
+  -q, --quiet            Suppress all stderr logging.
+  -v, --verbose          Print debug information to stderr.
   --help                 Show this help message.
   --version              Show version.
 
@@ -120392,23 +120503,56 @@ async function formatMd(text) {
     return text;
   }
 }
+async function outputText(text) {
+  if (outputPath) {
+    await writeFile3(outputPath, text, "utf8");
+    return;
+  }
+  if (!pagerCmd || !process.stdout.isTTY) {
+    process.stdout.write(text);
+    return;
+  }
+  const parts = pagerCmd.split(/\s+/);
+  const proc = spawn2(parts[0], parts.slice(1), {
+    stdio: ["pipe", "inherit", "inherit"]
+  });
+  await new Promise((resolve3) => {
+    let done = false;
+    proc.on("error", () => {
+      if (done)
+        return;
+      done = true;
+      process.stdout.write(text);
+      resolve3();
+    });
+    proc.on("exit", () => {
+      if (done)
+        return;
+      done = true;
+      resolve3();
+    });
+    proc.stdin.write(text);
+    proc.stdin.end();
+  });
+}
+var pagerCmd = null;
 var args = process.argv.slice(2);
 if (args.length === 0 || args.includes("--help")) {
   console.log(help());
-  process.exit(0);
+  exitProcess(0);
 }
 if (args.includes("--version")) {
   console.log(VERSION2);
-  process.exit(0);
+  exitProcess(0);
 }
 if (args.includes("--reset-config")) {
   const path15 = await resetConfig();
   console.log(`Config reset to defaults: ${path15}`);
-  process.exit(0);
+  exitProcess(0);
 }
 var config = await loadConfig().catch(() => ({}));
 var mode = "transcript";
-var subcmdIndex = args.findIndex((a5) => a5 === "info" || a5 === "summarize");
+var subcmdIndex = args.findIndex((a5) => a5 === "info" || a5 === "summarize" || a5 === "config");
 if (subcmdIndex !== -1) {
   mode = args[subcmdIndex];
   args.splice(subcmdIndex, 1);
@@ -120423,7 +120567,9 @@ var noDecode = false;
 var showDetails = true;
 var noCache = false;
 var noFormat = false;
-var debugMode = false;
+var usePager = true;
+var useHints = true;
+var logLevel = "normal";
 for (let i = 0;i < args.length; i++) {
   const arg = args[i];
   if (!arg)
@@ -120432,7 +120578,7 @@ for (let i = 0;i < args.length; i++) {
     lang = args[++i] ?? undefined;
     if (!lang) {
       console.error("Error: --lang requires a language code");
-      process.exit(1);
+      exitProcess(1);
     }
   } else if (arg === "--timestamps" || arg === "-t") {
     timestamps = true;
@@ -120442,7 +120588,7 @@ for (let i = 0;i < args.length; i++) {
     outputPath = args[++i] ?? undefined;
     if (!outputPath) {
       console.error("Error: -o/--output requires a file path");
-      process.exit(1);
+      exitProcess(1);
     }
   } else if (arg === "--json") {
     outputJson = true;
@@ -120456,35 +120602,76 @@ for (let i = 0;i < args.length; i++) {
     noCache = true;
   } else if (arg === "--no-format") {
     noFormat = true;
-  } else if (arg === "--debug") {
-    debugMode = true;
+  } else if (arg === "--no-pager") {
+    usePager = false;
+  } else if (arg === "--pager") {
+    usePager = true;
+  } else if (arg === "--no-hints") {
+    useHints = false;
+  } else if (arg === "--hints") {
+    useHints = true;
+  } else if (arg === "--quiet" || arg === "-q") {
+    logLevel = "quiet";
+  } else if (arg === "--verbose" || arg === "-v") {
+    logLevel = "verbose";
   } else if (arg === "--no-decode-entities") {
     noDecode = true;
   } else if (arg.startsWith("-")) {
     console.error(`Unknown option: ${arg}`);
-    process.exit(1);
+    exitProcess(1);
   } else {
     videoId = arg;
   }
 }
+if (mode === "config") {
+  const path15 = configPath();
+  const editor = process.env.EDITOR;
+  if (editor) {
+    await new Promise((resolve3) => {
+      const proc = spawn2(editor, [path15], { stdio: "inherit" });
+      proc.on("exit", () => resolve3());
+      proc.on("error", () => resolve3());
+    });
+  } else {
+    console.log(`Config file: ${path15}`);
+  }
+  exitProcess(0);
+}
 if (!videoId) {
   console.error("Error: missing video URL or ID");
   console.log(help());
-  process.exit(1);
+  exitProcess(1);
 }
 var extracted = extractVideoId(videoId);
 if (!extracted) {
   console.error("Error: invalid YouTube video URL or ID");
-  process.exit(65);
+  exitProcess(65);
 }
 videoId = extracted;
-if (debugMode)
-  enableDebug();
+setLevel(logLevel);
+resetTimer();
+pagerCmd = usePager ? detectPager(config.pager) : null;
+debug("Pager:", pagerCmd ?? "none");
+{
+  const envHints = process.env.PROSEY_HINTS;
+  if (envHints !== undefined) {
+    useHints = envHints === "yes" || envHints === "1" || envHints === "true";
+  } else if (config.hints !== undefined) {
+    useHints = config.hints;
+  }
+}
+if (useHints) {
+  const hasMarkdownPager = pagerCmd === "bat -lmd --style plain" || pagerCmd === "glow -p" || pagerCmd === "mdcat -l -p";
+  if (!hasMarkdownPager) {
+    hint("Tip: install a markdown highlighter for better output (e.g. bat, glow, mdcat)");
+  }
+}
 debug("Config file:", configPath());
 debug("Video ID:", videoId);
 debug("Mode:", mode);
 if (lang)
   debug("Language:", lang);
+await Promise.race([versionCheck, new Promise((r5) => setTimeout(r5, 1000))]);
 try {
   if (mode === "info") {
     const result = await fetchTranscript(videoId, { videoDetails: true, lang });
@@ -120493,21 +120680,23 @@ try {
     } else {
       printVideoInfo(result.videoDetails);
     }
-    process.exit(0);
+    exitProcess(0);
   }
   if (mode === "summarize") {
     if (!config.summarize?.command) {
       console.error("Error: [summarize] section with a command is required in config");
-      process.exit(1);
+      exitProcess(1);
     }
     const cacheOpts2 = { lang, mode: "summarize", noDecode };
     const dir2 = cacheDir(videoId, cacheOpts2);
     let segments2 = null;
     let summary = null;
+    startTimer();
     if (!noCache) {
       const cachedSegments = await readCache(dir2, "transcript.json");
       const cachedSummary = await readCache(dir2, "summary.md");
       if (cachedSegments && cachedSummary) {
+        info("Transcript cached");
         debug("Cache hit:", dir2);
         segments2 = JSON.parse(cachedSegments);
         summary = cachedSummary;
@@ -120518,46 +120707,45 @@ try {
       debug("Cache skipped (--no-cache)");
     }
     if (!segments2) {
-      debug("Fetching transcript...");
+      info("Fetching transcript...");
       segments2 = lang ? await fetchTranscript(videoId, { lang }) : await fetchTranscript(videoId);
-      debug(`Transcript fetched: ${segments2.length} segments`);
+      info(`Transcript: ${segments2.length} segments`);
       await writeCache(dir2, "transcript.json", JSON.stringify(segments2));
       debug("Cache written: transcript.json");
     }
     const prompt = config.summarize.prompt ?? "";
     const transcriptText = toText(segments2, !noDecode);
     if (!summary) {
-      debug("Running command:", config.summarize.command);
+      info(`Summarizing...`);
       summary = await summarize({
         prompt,
         command: config.summarize.command,
         transcript: transcriptText,
         cwd: dir2
       });
-      debug("Command exit: 0");
+      info("Summary ready");
       await writeCache(dir2, "summary.md", summary);
       debug("Cache written: summary.md");
     }
     const formatted = noFormat ? summary : await formatMd(summary);
-    if (outputPath) {
-      await writeFile3(outputPath, formatted, "utf8");
-    } else {
-      console.log(formatted);
-    }
-    process.exit(0);
+    await outputText(formatted + `
+`);
+    exitProcess(0);
   } else if (listOnly) {
     const languages2 = await listLanguages(videoId);
     printLanguages(languages2);
-    process.exit(0);
+    exitProcess(0);
   }
   const decode = !noDecode;
   const cacheOpts = { lang, timestamps, json: outputJson, noDecode };
   const dir = cacheDir(videoId, cacheOpts);
   let segments = null;
   let videoDetailsCache = null;
+  startTimer();
   if (!noCache) {
     const cached = await readCache(dir, "transcript.json");
     if (cached) {
+      info("Transcript cached");
       debug("Cache hit:", dir);
       segments = JSON.parse(cached);
     } else {
@@ -120567,7 +120755,7 @@ try {
     debug("Cache skipped (--no-cache)");
   }
   if (!segments) {
-    debug("Fetching transcript...");
+    info("Fetching transcript...");
     if (showDetails && !outputJson) {
       const opts = lang ? { lang, videoDetails: true } : { videoDetails: true };
       const result = await fetchTranscript(videoId, opts);
@@ -120576,6 +120764,7 @@ try {
     } else {
       segments = lang ? await fetchTranscript(videoId, { lang }) : await fetchTranscript(videoId);
     }
+    info(`Transcript: ${segments.length} segments`);
     await writeCache(dir, "transcript.json", JSON.stringify(segments));
   }
   if (showDetails && !outputJson) {
@@ -120591,24 +120780,17 @@ try {
 
 ` + transcriptText + `
 `;
-    if (outputPath) {
-      await writeFile3(outputPath, output, "utf8");
-    } else {
-      console.log(output);
-    }
+    await outputText(output);
   } else {
     const output = outputJson ? toJSON(segments, decode) + `
 ` : timestamps ? formatWithTimestamps(segments, decode) + `
 ` : toText(segments, decode) + `
 `;
-    if (outputPath) {
-      await writeFile3(outputPath, output, "utf8");
-    } else {
-      console.log(output);
-    }
+    await outputText(output);
   }
+  exitProcess(0);
 } catch (err) {
   const message = err instanceof Error ? err.message : String(err);
   console.error(`Error: ${message}`);
-  process.exit(1);
+  exitProcess(1);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tacone/prosey",
-  "version": "0.2.3",
+  "version": "0.2.6",
   "description": "Download YouTube video transcripts from the CLI",
   "module": "src/index.ts",
   "type": "module",

package/src/config-command.test.ts

@@ -0,0 +1,50 @@
+import { describe, expect, test, afterEach } from "bun:test";
+import { $ } from "bun";
+import { rm } from "node:fs/promises";
+import { existsSync } from "node:fs";
+
+const testConfigPath = "/tmp/prosey-test-config.toml";
+
+afterEach(async () => {
+  try {
+    await rm(testConfigPath);
+  } catch {}
+  delete process.env.PROSEY_CONFIG_PATH;
+});
+
+describe("config subcommand", () => {
+  test("prints config path when EDITOR is not set", async () => {
+    delete process.env.EDITOR;
+    process.env.PROSEY_CONFIG_PATH = testConfigPath;
+
+    const { stdout, exitCode } = await $`bin/prosey config`.quiet();
+
+    expect(exitCode).toBe(0);
+    expect(stdout.toString().trim()).toBe(`Config file: ${testConfigPath}`);
+  });
+
+  test("creates config file when missing", async () => {
+    delete process.env.EDITOR;
+    process.env.PROSEY_CONFIG_PATH = testConfigPath;
+
+    expect(existsSync(testConfigPath)).toBe(false);
+    await $`bin/prosey config`.quiet();
+    expect(existsSync(testConfigPath)).toBe(true);
+  });
+
+  test("does not require a video ID", async () => {
+    delete process.env.EDITOR;
+    process.env.PROSEY_CONFIG_PATH = testConfigPath;
+
+    const { exitCode } = await $`bin/prosey config`.quiet();
+    expect(exitCode).toBe(0);
+  });
+
+  test("exits with code 0 after spawning editor", async () => {
+    process.env.EDITOR = "cat";
+    process.env.PROSEY_CONFIG_PATH = testConfigPath;
+
+    const { exitCode } = await $`bin/prosey config`.quiet();
+    expect(exitCode).toBe(0);
+  });
+});

package/src/config.ts

@@ -6,6 +6,8 @@ import { fileURLToPath } from "node:url";
 import { load } from "js-toml";
 
 export interface ProseyConfig {
+  pager?: string;
+  hints?: boolean;
   summarize?: {
     prompt?: string;
     command?: string;
@@ -15,6 +17,16 @@ export interface ProseyConfig {
 const FALLBACK_CONFIG_TOML = `# Default prosey configuration
 # Created automatically on first run. Edit as needed.
 
+# Pager command for transcript and summary output.
+# Defaults to "auto": bat -lmd --style plain → glow -p → mdcat -l -p → less
+# Set to a custom command (e.g. "less -R") to override.
+# Can also be set via the PROSEY_PAGER env var (takes precedence).
+pager = "auto"
+
+# Show hints for missing tools (e.g. markdown highlighter).
+# Can also be set via PROSEY_HINTS env var (yes, no, 1, 0, true, false).
+hints = true
+
 [summarize]
 # Prompt sent to the command via stdin.
 # Customize this to change how transcripts are summarized.