@bitkyc08/opencodex
Version:
Universal provider proxy for OpenAI Codex & Claude Code — use any LLM with Codex CLI/App/SDK and Claude Code
70 lines (65 loc) • 3.17 kB
text/typescript
import { spawn } from "node:child_process";
import { existsSync } from "node:fs";
import { join } from "node:path";
function windowsRundll32(): string {
const windowsRoot = process.env.SystemRoot || process.env.WINDIR || "C:\\Windows";
const candidate = join(windowsRoot, "System32", "rundll32.exe");
return existsSync(candidate) ? candidate : "rundll32";
}
/**
* Whether the OS launcher actually started. `started` does not prove a browser rendered the
* page — nothing observable from here can — but it does separate "we handed the URL off" from
* "there was nothing to hand it to", which is the distinction a caller needs (#5261).
*/
export type OpenUrlResult =
| { status: "started" }
| { status: "failed"; reason: "invalid-url" | "spawn-error" | "launcher-exit" };
/**
* How long to watch a launcher that did spawn before calling it started.
*
* `spawn` only proves a process began. `xdg-open` with no desktop handler, and rundll32 given a
* broken association, both spawn happily and exit nonzero a moment later without opening
* anything — so resolving on `spawn` alone would report a launch that did not happen. Those
* failures are immediate, and the only caller that awaits this is a login start, so a short
* window buys a true answer cheaply. A launcher still running when it elapses has started.
*/
const LAUNCHER_SETTLE_MS = 400;
/**
* Never rejects. A browser that would not open is an inconvenience, not a login failure: the
* URL is still a valid thing to open by hand, so the caller decides what to say about it.
* Callers that genuinely do not care use `void openUrl(...)`.
*/
export function openUrl(url: string): Promise<OpenUrlResult> {
if (!/^https?:\/\//i.test(url)) return Promise.resolve({ status: "failed", reason: "invalid-url" });
const cmd =
process.platform === "darwin" ? "open"
: process.platform === "win32" ? windowsRundll32()
: "xdg-open";
const args = process.platform === "win32"
? ["url.dll,FileProtocolHandler", url]
: [url];
return new Promise<OpenUrlResult>(resolve => {
let settled = false;
let timer: ReturnType<typeof setTimeout> | undefined;
const settle = (result: OpenUrlResult) => {
if (settled) return;
settled = true;
if (timer) clearTimeout(timer);
resolve(result);
};
const child = spawn(cmd, args, { detached: true, stdio: "ignore", shell: false });
// Headless hosts (no xdg-open) emit ENOENT as an async 'error' event; without a
// listener that is an uncaught exception that kills the whole proxy/login flow.
// It is also the signal itself: on Windows this is how a missing rundll32 arrives.
child.on("error", () => settle({ status: "failed", reason: "spawn-error" }));
child.on("spawn", () => {
// Unref'd either way: this never keeps the process alive, it only decides what to report.
timer = setTimeout(() => settle({ status: "started" }), LAUNCHER_SETTLE_MS);
timer.unref?.();
});
child.on("exit", code => settle(code === 0 || code === null
? { status: "started" }
: { status: "failed", reason: "launcher-exit" }));
child.unref();
});
}