137 lines
4.5 KiB
TypeScript
137 lines
4.5 KiB
TypeScript
/** Cross-platform native single-directory picker used by the local GUI carrier. */
|
|
|
|
import { execFile } from 'node:child_process'
|
|
|
|
/** Testable command boundary; native implementations never invoke a shell. */
|
|
export type DirectoryPickerRunner = (
|
|
command: string,
|
|
args: readonly string[],
|
|
signal: AbortSignal,
|
|
) => Promise<{ stdout: string; stderr: string }>
|
|
|
|
/** Injectable platform facts for deterministic adapter tests. */
|
|
export interface DirectoryPickerInternals {
|
|
platform?: NodeJS.Platform
|
|
run?: DirectoryPickerRunner
|
|
}
|
|
|
|
const runCommand: DirectoryPickerRunner = (command, args, signal) =>
|
|
new Promise((resolve, reject) => {
|
|
execFile(
|
|
command,
|
|
[...args],
|
|
{ encoding: 'utf8', signal, windowsHide: true },
|
|
(error, stdout, stderr) => {
|
|
if (error !== null) {
|
|
const failure = Object.assign(new Error(error.message, { cause: error }), {
|
|
code: error.code,
|
|
stdout,
|
|
stderr,
|
|
})
|
|
reject(failure)
|
|
return
|
|
}
|
|
resolve({ stdout, stderr })
|
|
},
|
|
)
|
|
})
|
|
|
|
function outputPath(stdout: string): string | null {
|
|
const path = stdout.replace(/[\r\n]+$/, '')
|
|
return path === '' ? null : path
|
|
}
|
|
|
|
function errorCode(error: unknown): string | number | undefined {
|
|
if (typeof error !== 'object' || error === null || !('code' in error)) return undefined
|
|
const code = (error as { code?: unknown }).code
|
|
return typeof code === 'string' || typeof code === 'number' ? code : undefined
|
|
}
|
|
|
|
function errorStderr(error: unknown): string {
|
|
if (typeof error !== 'object' || error === null || !('stderr' in error)) return ''
|
|
const stderr = (error as { stderr?: unknown }).stderr
|
|
return typeof stderr === 'string' ? stderr : ''
|
|
}
|
|
|
|
function isMissingCommand(error: unknown): boolean {
|
|
return errorCode(error) === 'ENOENT'
|
|
}
|
|
|
|
function rethrowIfAborted(signal: AbortSignal, error: unknown): void {
|
|
if (signal.aborted) throw error
|
|
}
|
|
|
|
/**
|
|
* Open the platform directory picker.
|
|
* @param signal - caller/connection lifetime; abort terminates the native command.
|
|
* @param internals - platform and runner seam for deterministic tests.
|
|
* @returns the selected path, or null when the user cancels.
|
|
*/
|
|
export async function pickNativeDirectory(
|
|
signal: AbortSignal,
|
|
internals: DirectoryPickerInternals = {},
|
|
): Promise<string | null> {
|
|
const platform = internals.platform ?? process.platform
|
|
const run = internals.run ?? runCommand
|
|
|
|
if (platform === 'darwin') {
|
|
try {
|
|
const result = await run('osascript', [
|
|
'-e', 'set selectedFolder to choose folder with prompt "Select Workspace Directory"',
|
|
'-e', 'POSIX path of selectedFolder',
|
|
], signal)
|
|
return outputPath(result.stdout)
|
|
} catch (error: unknown) {
|
|
if (!signal.aborted && errorCode(error) === 1
|
|
&& /(?:User canceled|-128)/i.test(errorStderr(error))) return null
|
|
throw error
|
|
}
|
|
}
|
|
|
|
if (platform === 'win32') {
|
|
const script = [
|
|
"$ErrorActionPreference = 'Stop'",
|
|
'Add-Type -AssemblyName System.Windows.Forms',
|
|
'$dialog = New-Object System.Windows.Forms.FolderBrowserDialog',
|
|
"$dialog.Description = 'Select Workspace Directory'",
|
|
'$dialog.ShowNewFolderButton = $true',
|
|
'$result = $dialog.ShowDialog()',
|
|
'if ($result -eq [System.Windows.Forms.DialogResult]::OK) {',
|
|
' [Console]::OutputEncoding = [System.Text.Encoding]::UTF8',
|
|
' [Console]::WriteLine($dialog.SelectedPath)',
|
|
'}',
|
|
].join('; ')
|
|
const result = await run('powershell.exe', ['-NoProfile', '-STA', '-Command', script], signal)
|
|
return outputPath(result.stdout)
|
|
}
|
|
|
|
if (platform === 'linux') {
|
|
try {
|
|
const result = await run('zenity', [
|
|
'--file-selection', '--directory', '--title=Select Workspace Directory',
|
|
], signal)
|
|
return outputPath(result.stdout)
|
|
} catch (error: unknown) {
|
|
rethrowIfAborted(signal, error)
|
|
if (errorCode(error) === 1) return null
|
|
if (!isMissingCommand(error)) throw error
|
|
}
|
|
|
|
try {
|
|
const result = await run('kdialog', [
|
|
'--getexistingdirectory', '.', '--title', 'Select Workspace Directory',
|
|
], signal)
|
|
return outputPath(result.stdout)
|
|
} catch (error: unknown) {
|
|
rethrowIfAborted(signal, error)
|
|
if (errorCode(error) === 1) return null
|
|
if (isMissingCommand(error)) {
|
|
throw new Error('no supported native directory picker found (install zenity or kdialog)')
|
|
}
|
|
throw error
|
|
}
|
|
}
|
|
|
|
throw new Error(`native directory picker is unsupported on ${platform}`)
|
|
}
|