UNPKG

@bitkyc08/opencodex

Version:

Universal provider proxy for OpenAI Codex & Claude Code — use any LLM with Codex CLI/App/SDK and Claude Code

48 lines (44 loc) • 2.16 kB
/** * What to tell the operator after a failed npm self-update (#5624). * * The transactional updater (`transactional-install.mjs`) either leaves the live package * untouched, rolls it back, or — only on a double fault — leaves it moved aside with a recovery * marker. Each of those needs a different next step, and the one command a user most often * reaches for after a failed update, a bare `npm install -g` under a live proxy, is the one that * fences the proxy (#5496). So the guidance stops the proxy first. * * Plain ESM with no Bun APIs: the Node launcher (`bin/ocx.mjs`) imports it. */ /** Phases in which the live package was never touched. */ const UNTOUCHED_PHASES = new Set(["stage", "verify", "swap-backup"]); /** * @param {{ phase?: string; rolledBack?: boolean; pkgName: string; version?: string; tag?: string }} failure * @returns {{ previousVersionKept: boolean; lines: string[] }} */ export function npmUpdateFailureGuidance({ phase, rolledBack, pkgName, version, tag }) { const reinstall = "npm install -g --allow-scripts=bun " + pkgName + "@" + (version || tag || "latest"); const kept = UNTOUCHED_PHASES.has(phase ?? "") || rolledBack === true; if (!kept) { return { previousVersionKept: false, lines: [ "The previous version was moved aside and could not be put back automatically.", "Next: run the \"restore\" command recorded in .ocx-recovery.json next to the package, or reinstall with '" + reinstall + "'.", ], }; } return { previousVersionKept: true, lines: [ "The previous version is still installed.", "Next: run 'ocx update' again. If it fails the same way, run 'ocx stop', then '" + reinstall + "', then 'ocx service restart' ('ocx start' when no background service is installed).", ], }; } /** * The dashboard job only sees the launcher's exit status; its output is withheld because it can * carry local paths. Point at the terminal, where the launcher prints the phase-specific step. */ export const GUI_UPDATE_FAILURE_NEXT_STEP = "Run 'ocx update' in a terminal to see the reason and the exact recovery step.";