52 lines
1.3 KiB
TypeScript
52 lines
1.3 KiB
TypeScript
|
/**
|
||
|
|
* Cross-platform browser opening utility.
|
||
|
|
* Uses the "open" npm package for reliable cross-platform support.
|
||
|
|
*
|
||
|
|
* Supports: macOS, Windows, Linux (including WSL)
|
||
|
|
*/
|
||
|
|
|
||
|
|
import open from "open"
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Debug logging helper.
|
||
|
|
* Only logs when ANTIGRAVITY_DEBUG=1
|
||
|
|
*/
|
||
|
|
function debugLog(message: string): void {
|
||
|
|
if (process.env.ANTIGRAVITY_DEBUG === "1") {
|
||
|
|
console.log(`[antigravity-browser] ${message}`)
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Opens a URL in the user's default browser.
|
||
|
|
*
|
||
|
|
* Cross-platform support:
|
||
|
|
* - macOS: uses `open` command
|
||
|
|
* - Windows: uses `start` command
|
||
|
|
* - Linux: uses `xdg-open` command
|
||
|
|
* - WSL: uses Windows PowerShell
|
||
|
|
*
|
||
|
|
* @param url - The URL to open in the browser
|
||
|
|
* @returns Promise<boolean> - true if browser opened successfully, false otherwise
|
||
|
|
*
|
||
|
|
* @example
|
||
|
|
* ```typescript
|
||
|
|
* const success = await openBrowserURL("https://accounts.google.com/oauth...")
|
||
|
|
* if (!success) {
|
||
|
|
* console.log("Please open this URL manually:", url)
|
||
|
|
* }
|
||
|
|
* ```
|
||
|
|
*/
|
||
|
|
export async function openBrowserURL(url: string): Promise<boolean> {
|
||
|
|
debugLog(`Opening browser: ${url}`)
|
||
|
|
|
||
|
|
try {
|
||
|
|
await open(url)
|
||
|
|
debugLog("Browser opened successfully")
|
||
|
|
return true
|
||
|
|
} catch (error) {
|
||
|
|
debugLog(`Failed to open browser: ${error instanceof Error ? error.message : String(error)}`)
|
||
|
|
return false
|
||
|
|
}
|
||
|
|
}
|