oppi.li
source dump of claude code
1import { homedir } from 'os'
2import { join } from 'path'
3import { logForDebugging } from './debug.js'
4import { getPlatform, type Platform } from './platform.js'
5
6export type SystemDirectories = {
7 HOME: string
8 DESKTOP: string
9 DOCUMENTS: string
10 DOWNLOADS: string
11 [key: string]: string // Index signature for compatibility with Record<string, string>
12}
13
14type EnvLike = Record<string, string | undefined>
15
16type SystemDirectoriesOptions = {
17 env?: EnvLike
18 homedir?: string
19 platform?: Platform
20}
21
22/**
23 * Get cross-platform system directories
24 * Handles differences between Windows, macOS, Linux, and WSL
25 * @param options Optional overrides for testing (env, homedir, platform)
26 */
27export function getSystemDirectories(
28 options?: SystemDirectoriesOptions,
29): SystemDirectories {
30 const platform = options?.platform ?? getPlatform()
31 const homeDir = options?.homedir ?? homedir()
32 const env = options?.env ?? process.env
33
34 // Default paths used by most platforms
35 const defaults: SystemDirectories = {
36 HOME: homeDir,
37 DESKTOP: join(homeDir, 'Desktop'),
38 DOCUMENTS: join(homeDir, 'Documents'),
39 DOWNLOADS: join(homeDir, 'Downloads'),
40 }
41
42 switch (platform) {
43 case 'windows': {
44 // Windows: Use USERPROFILE if available (handles localized folder names)
45 const userProfile = env.USERPROFILE || homeDir
46 return {
47 HOME: homeDir,
48 DESKTOP: join(userProfile, 'Desktop'),
49 DOCUMENTS: join(userProfile, 'Documents'),
50 DOWNLOADS: join(userProfile, 'Downloads'),
51 }
52 }
53
54 case 'linux':
55 case 'wsl': {
56 // Linux/WSL: Check XDG Base Directory specification first
57 return {
58 HOME: homeDir,
59 DESKTOP: env.XDG_DESKTOP_DIR || defaults.DESKTOP,
60 DOCUMENTS: env.XDG_DOCUMENTS_DIR || defaults.DOCUMENTS,
61 DOWNLOADS: env.XDG_DOWNLOAD_DIR || defaults.DOWNLOADS,
62 }
63 }
64
65 case 'macos':
66 default: {
67 // macOS and unknown platforms use standard paths
68 if (platform === 'unknown') {
69 logForDebugging(`Unknown platform detected, using default paths`)
70 }
71 return defaults
72 }
73 }
74}