1#!/usr/bin/env bun
2 
3import {
4  runConvertCommand,
5  type ConvertCommandOptions,
6  type OutputFormat,
7  type WaitMode,
8} from "./commands/convert";
9 
10export const HELP_TEXT = `
11baoyu-fetch - Read a URL into Markdown or JSON with Chrome CDP
12 
13Usage:
14  baoyu-fetch <url> [options]
15 
16Options:
17  --output <file>       Save output to file
18  --format <type>       Output format: markdown | json
19  --json                Alias for --format json
20  --adapter <name>      Force an adapter (e.g. x, generic)
21  --download-media      Download adapter-reported media into ./imgs and ./videos, then rewrite markdown links
22  --media-dir <dir>     Base directory for downloaded media. Defaults to the output directory
23  --debug-dir <dir>     Write debug artifacts
24  --cdp-url <url>       Reuse an existing Chrome DevTools endpoint
25  --browser-path <path> Explicit Chrome binary path
26  --chrome-profile-dir <path>
27                        Chrome user data dir. Defaults to BAOYU_CHROME_PROFILE_DIR
28                        or baoyu-skills/chrome-profile.
29  --headless            Launch a temporary headless Chrome if needed
30  --wait-for <mode>     Wait mode: interaction | force
31                        interaction: start visible Chrome and auto-wait only when login or verification is required
32                        force: start visible Chrome, then auto-continue after it detects login/challenge progress
33                               or continue immediately when you press Enter
34  --wait-for-interaction
35                        Alias for --wait-for interaction
36  --wait-for-login      Alias for --wait-for interaction
37  --interaction-timeout <ms>
38                        How long to wait for manual interaction before failing (default: 600000)
39  --interaction-poll-interval <ms>
40                        How often to poll interaction state while waiting (default: 1500)
41  --login-timeout <ms>  Alias for --interaction-timeout
42  --login-poll-interval <ms>
43                        Alias for --interaction-poll-interval
44  --timeout <ms>        Page timeout in milliseconds (default: 30000)
45  --help                Show help
46 
47Examples:
48  baoyu-fetch https://example.com
49  baoyu-fetch https://example.com --format markdown --output article.md --download-media
50  baoyu-fetch https://example.com --format json --output article.json
51  baoyu-fetch https://x.com/lennysan/status/2036483059407810640 --wait-for interaction
52  baoyu-fetch https://x.com/lennysan/status/2036483059407810640 --wait-for force
53`.trim();
54 
55interface CliOptions extends ConvertCommandOptions {
56  url?: string;
57  help: boolean;
58}
59 
60function normalizeWaitMode(raw: string): WaitMode {
61  const value = raw.toLowerCase();
62  if (value === "interaction" || value === "auto") {
63    return "interaction";
64  }
65  if (value === "force" || value === "manual" || value === "always") {
66    return "force";
67  }
68  throw new Error(`Invalid wait mode: ${raw}. Expected interaction or force.`);
69}
70 
71function normalizeOutputFormat(raw: string): OutputFormat {
72  const value = raw.toLowerCase();
73  if (value === "markdown" || value === "json") {
74    return value;
75  }
76 
77  throw new Error(`Invalid output format: ${raw}. Expected markdown or json.`);
78}
79 
80export function parseArgs(argv: string[]): CliOptions {
81  const options: CliOptions = {
82    format: "markdown",
83    headless: false,
84    downloadMedia: false,
85    waitMode: "none",
86    interactionTimeoutMs: 600_000,
87    interactionPollIntervalMs: 1_500,
88    timeoutMs: 30_000,
89    help: false,
90  };
91 
92  const args = argv.slice(2);
93  for (let index = 0; index < args.length; index += 1) {
94    const value = args[index];
95 
96    if (value === "--help" || value === "-h") {
97      options.help = true;
98      continue;
99    }
100    if (value === "--format") {
101      const format = args[index + 1];
102      if (!format) {
103        throw new Error("--format requires a value");
104      }
105      options.format = normalizeOutputFormat(format);
106      index += 1;
107      continue;
108    }
109    if (value === "--json") {
110      options.format = "json";
111      continue;
112    }
113    if (value === "--download-media") {
114      options.downloadMedia = true;
115      continue;
116    }
117    if (value === "--headless") {
118      options.headless = true;
119      continue;
120    }
121    if (value === "--wait-for") {
122      const mode = args[index + 1];
123      if (!mode) {
124        throw new Error("--wait-for requires a mode");
125      }
126      options.waitMode = normalizeWaitMode(mode);
127      index += 1;
128      continue;
129    }
130    if (value === "--wait-for-interaction" || value === "--wait-for-login") {
131      options.waitMode = "interaction";
132      continue;
133    }
134    if (value === "--output") {
135      options.output = args[index + 1];
136      index += 1;
137      continue;
138    }
139    if (value === "--adapter") {
140      options.adapter = args[index + 1];
141      index += 1;
142      continue;
143    }
144    if (value === "--debug-dir") {
145      options.debugDir = args[index + 1];
146      index += 1;
147      continue;
148    }
149    if (value === "--media-dir") {
150      options.mediaDir = args[index + 1];
151      index += 1;
152      continue;
153    }
154    if (value === "--cdp-url") {
155      options.cdpUrl = args[index + 1];
156      index += 1;
157      continue;
158    }
159    if (value === "--browser-path") {
160      options.browserPath = args[index + 1];
161      index += 1;
162      continue;
163    }
164    if (value === "--chrome-profile-dir") {
165      options.chromeProfileDir = args[index + 1];
166      index += 1;
167      continue;
168    }
169    if (value === "--timeout") {
170      const parsed = Number(args[index + 1]);
171      if (!Number.isFinite(parsed) || parsed <= 0) {
172        throw new Error(`Invalid timeout: ${args[index + 1]}`);
173      }
174      options.timeoutMs = parsed;
175      index += 1;
176      continue;
177    }
178    if (value === "--interaction-timeout" || value === "--login-timeout") {
179      const parsed = Number(args[index + 1]);
180      if (!Number.isFinite(parsed) || parsed <= 0) {
181        throw new Error(`Invalid interaction timeout: ${args[index + 1]}`);
182      }
183      options.interactionTimeoutMs = parsed;
184      index += 1;
185      continue;
186    }
187    if (value === "--interaction-poll-interval" || value === "--login-poll-interval") {
188      const parsed = Number(args[index + 1]);
189      if (!Number.isFinite(parsed) || parsed <= 0) {
190        throw new Error(`Invalid interaction poll interval: ${args[index + 1]}`);
191      }
192      options.interactionPollIntervalMs = parsed;
193      index += 1;
194      continue;
195    }
196    if (value.startsWith("-")) {
197      throw new Error(`Unknown option: ${value}`);
198    }
199    if (!options.url) {
200      options.url = value;
201      continue;
202    }
203    throw new Error(`Unexpected argument: ${value}`);
204  }
205 
206  return options;
207}
208 
209async function main(): Promise<void> {
210  try {
211    const options = parseArgs(process.argv);
212    if (options.help || !options.url) {
213      console.log(HELP_TEXT);
214      return;
215    }
216 
217    await runConvertCommand(options);
218  } catch (error) {
219    const message = error instanceof Error ? error.message : String(error);
220    console.error(message);
221    process.exitCode = 1;
222  }
223}
224 
225if (import.meta.main) {
226  void main();
227}
228