Function installCli

apps/desktop/src/main/cli-install.ts:346–399

()

/* ---------- Install --------------------------------------------------- */

export async function installCli(): Promise<CliInstallStatus> {
  if (process.platform === 'win32') {
    throw new Error('CLI install is not yet supported on Windows.')
  }
  const wrapper = await locateWrapper()
  if (!wrapper) {
    throw new Error(
      'The CLI wrapper is not bundled with this build. Run `npm run build` (or launch from a packaged build) and try again.'
    )
  }

  // If something is already installed at one of our candidates, prefer
  // overwriting it in place rather than creating a second copy on PATH.
  const existing = await findExistingInstall(wrapper)
  let target: InstallTarget
  if (existing && existing.installedByThisApp) {
    target = {
      linkPath: existing.linkPath,
      onPath: pathDirsOnPath().has(path.dirname(existing.linkPath)),
      requiresSudo: !(await isWritableDir(path.dirname(existing.linkPath))),
      pathHint: null
    }
  } else if (existing && !existing.installedByThisApp) {
    throw new Error(
      `${existing.linkPath} already exists and is not managed by ZenNotes. Remove it manually if you want ZenNotes to take over.`
    )
  } else {
    target = await pickInstallTarget()
  }

  const linkDir = path.dirname(target.linkPath)
  await fsp.mkdir(linkDir, { recursive: true }).catch(() => undefined)

  if (!target.requiresSudo) {
    await writeSymlink(wrapper.wrapperPath, target.linkPath)
  } else {
    try {
      await writeSymlink(wrapper.wrapperPath, target.linkPath)
    } catch (err) {
      const code = (err as NodeJS.ErrnoException).code
      if (code === 'EACCES' || code === 'EPERM' || code === 'EROFS') {
        await elevateAndSymlink(wrapper.wrapperPath, target.linkPath)
      } else {
        throw err
      }
    }
  }

  // #126: migrate off the legacy `zen` name — drop any ZenNotes-managed `zen`
  // symlink now that `zn` is installed.
  await removeManagedLinks(LEGACY_CLI_NAMES, wrapper)

  return await getCliInstallStatus()
}

async function writeSymlink(source: string, target: string): Promise<void> {
  try {