@bitkyc08/opencodex
Version:
Universal provider proxy for OpenAI Codex & Claude Code — use any LLM with Codex CLI/App/SDK and Claude Code
76 lines (68 loc) • 3.54 kB
text/typescript
import { chmodSync, existsSync } from "node:fs";
import { homedir } from "node:os";
import { join, resolve } from "node:path";
import { flushWindowsSecretAclReapsBeforeRemoval, hardenSecretDirAsync, windowsSecretAclApplies } from "../lib/windows-secret-acl";
import { assertNotRealHomeUnderTest } from "../lib/test-home-guard";
/**
* Expand a leading `~` in user-supplied paths without interpreting shell
* variables or `~user` forms that belong to the caller's shell.
*/
export function expandUserPath(raw: string): string {
if (raw === "~") return homedir();
if (raw.startsWith("~/") || raw.startsWith("~\\")) return join(homedir(), raw.slice(2));
return raw;
}
let resolvedConfigDirCache: { raw: string | undefined; path: string } | null = null;
const configDirHardeningFlights = new Map<string, Promise<void>>();
export function getConfigDir(): string {
const raw = process.env["OPENCODEX_HOME"]?.trim() || undefined;
if (resolvedConfigDirCache && resolvedConfigDirCache.raw === raw) return resolvedConfigDirCache.path;
const path = raw ? resolve(expandUserPath(raw)) : join(homedir(), ".opencodex");
resolvedConfigDirCache = { raw, path };
return path;
}
export function getConfigPath(): string {
return join(getConfigDir(), "config.json");
}
export function hardenConfigDir(): void {
const dir = getConfigDir();
// The guard runs before any mutation: refusing after chmod/ACL would already
// have changed the protected directory used by the test-home boundary.
assertNotRealHomeUnderTest(dir);
if (!existsSync(dir)) return;
try { chmodSync(dir, 0o700); } catch { /* best-effort */ }
if (windowsSecretAclApplies() && !configDirHardeningFlights.has(dir)) {
// This is an optional read-path harden. Waiting synchronously here used to stop the Bun
// event loop (including /healthz) for the full icacls timeout. Required mutation paths keep
// their own awaited/fail-closed hardening; ordinary config reads only start one soft flight.
const flight = hardenSecretDirAsync(dir, { required: false })
.then(() => undefined)
.catch(() => undefined)
.finally(() => {
if (configDirHardeningFlights.get(dir) === flight) configDirHardeningFlights.delete(dir);
});
configDirHardeningFlights.set(dir, flight);
}
}
/**
* Settle the optional hardening flight for one config directory.
*
* The flight spawns `icacls.exe`, which holds the directory open until it exits. Windows file
* locking is mandatory, so anything that removes or renames that directory after a "clean"
* shutdown — a test fixture teardown, an uninstaller, a home move — gets EPERM/EBUSY unless the
* process that started the child also waits for it. `server.stop` calls this so the shutdown
* contract owns every child it started. No-op when nothing is in flight.
*/
export async function flushConfigDirHardening(dir: string = getConfigDir()): Promise<void> {
const flight = configDirHardeningFlights.get(dir);
if (flight) await flight;
}
/** A settled ACL deadline is not proof its child has exited; stop must drain both before removal. */
export async function flushConfigDirHardeningAndReaps(dir: string): Promise<void> {
try { await flushConfigDirHardening(dir); }
finally { await flushWindowsSecretAclReapsBeforeRemoval(dir); }
}
/** Test-only: settle every in-flight config-directory harden regardless of directory. */
export async function flushConfigDirHardeningForTests(): Promise<void> {
await Promise.all([...configDirHardeningFlights.values()]);
}