@fredlackey/devutils 0.0.18 → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (447) hide show
  1. package/README.md +214 -141
  2. package/package.json +8 -83
  3. package/src/api/loader.js +229 -0
  4. package/src/api/registry.json +62 -0
  5. package/src/cli.js +293 -60
  6. package/src/commands/ai/index.js +16 -0
  7. package/src/commands/ai/launch.js +112 -0
  8. package/src/commands/ai/list.js +54 -0
  9. package/src/commands/ai/resume.js +70 -0
  10. package/src/commands/ai/sessions.js +121 -0
  11. package/src/commands/ai/set.js +131 -0
  12. package/src/commands/ai/show.js +74 -0
  13. package/src/commands/ai/tools.js +46 -0
  14. package/src/commands/alias/add.js +93 -0
  15. package/src/commands/alias/helpers.js +107 -0
  16. package/src/commands/alias/index.js +14 -0
  17. package/src/commands/alias/list.js +55 -0
  18. package/src/commands/alias/remove.js +62 -0
  19. package/src/commands/alias/sync.js +109 -0
  20. package/src/commands/api/disable.js +73 -0
  21. package/src/commands/api/enable.js +148 -0
  22. package/src/commands/api/index.js +15 -0
  23. package/src/commands/api/list.js +66 -0
  24. package/src/commands/api/update.js +87 -0
  25. package/src/commands/auth/index.js +15 -0
  26. package/src/commands/auth/list.js +49 -0
  27. package/src/commands/auth/login.js +384 -0
  28. package/src/commands/auth/logout.js +111 -0
  29. package/src/commands/auth/refresh.js +184 -0
  30. package/src/commands/auth/services.js +169 -0
  31. package/src/commands/auth/status.js +104 -0
  32. package/src/commands/config/export.js +224 -0
  33. package/src/commands/config/get.js +52 -0
  34. package/src/commands/config/import.js +308 -0
  35. package/src/commands/config/index.js +17 -0
  36. package/src/commands/config/init.js +143 -0
  37. package/src/commands/config/reset.js +57 -0
  38. package/src/commands/config/set.js +93 -0
  39. package/src/commands/config/show.js +35 -0
  40. package/src/commands/help.js +338 -0
  41. package/src/commands/identity/add.js +133 -0
  42. package/src/commands/identity/index.js +17 -0
  43. package/src/commands/identity/link.js +76 -0
  44. package/src/commands/identity/list.js +48 -0
  45. package/src/commands/identity/remove.js +72 -0
  46. package/src/commands/identity/show.js +65 -0
  47. package/src/commands/identity/sync.js +172 -0
  48. package/src/commands/identity/unlink.js +57 -0
  49. package/src/commands/ignore/add.js +165 -0
  50. package/src/commands/ignore/index.js +14 -0
  51. package/src/commands/ignore/list.js +89 -0
  52. package/src/commands/ignore/markers.js +43 -0
  53. package/src/commands/ignore/remove.js +164 -0
  54. package/src/commands/ignore/show.js +169 -0
  55. package/src/commands/machine/detect.js +122 -0
  56. package/src/commands/machine/index.js +14 -0
  57. package/src/commands/machine/list.js +74 -0
  58. package/src/commands/machine/set.js +106 -0
  59. package/src/commands/machine/show.js +35 -0
  60. package/src/commands/schema.js +152 -0
  61. package/src/commands/search/collections.js +134 -0
  62. package/src/commands/search/get.js +71 -0
  63. package/src/commands/search/index-cmd.js +54 -0
  64. package/src/commands/search/index.js +21 -0
  65. package/src/commands/search/keyword.js +60 -0
  66. package/src/commands/search/qmd.js +70 -0
  67. package/src/commands/search/query.js +64 -0
  68. package/src/commands/search/semantic.js +62 -0
  69. package/src/commands/search/status.js +46 -0
  70. package/src/commands/status.js +224 -171
  71. package/src/commands/tools/check.js +79 -0
  72. package/src/commands/tools/index.js +14 -0
  73. package/src/commands/tools/install.js +110 -0
  74. package/src/commands/tools/list.js +91 -0
  75. package/src/commands/tools/search.js +60 -0
  76. package/src/commands/update.js +83 -112
  77. package/src/commands/util/add.js +151 -0
  78. package/src/commands/util/index.js +15 -0
  79. package/src/commands/util/list.js +97 -0
  80. package/src/commands/util/remove.js +76 -0
  81. package/src/commands/util/run.js +79 -0
  82. package/src/commands/util/show.js +67 -0
  83. package/src/commands/version.js +21 -88
  84. package/src/installers/_template.js +104 -0
  85. package/src/installers/git.js +150 -0
  86. package/src/installers/homebrew.js +190 -0
  87. package/src/installers/node.js +223 -0
  88. package/src/installers/registry.json +29 -0
  89. package/src/lib/config.js +125 -0
  90. package/src/lib/detect.js +74 -0
  91. package/src/lib/errors.js +114 -0
  92. package/src/lib/github.js +315 -0
  93. package/src/lib/installer.js +225 -0
  94. package/src/lib/output.js +239 -0
  95. package/src/lib/platform.js +112 -0
  96. package/src/lib/platforms/amazon-linux.js +41 -0
  97. package/src/lib/platforms/gitbash.js +46 -0
  98. package/src/lib/platforms/macos.js +45 -0
  99. package/src/lib/platforms/raspbian.js +41 -0
  100. package/src/lib/platforms/ubuntu.js +39 -0
  101. package/src/lib/platforms/windows.js +45 -0
  102. package/src/lib/prompt.js +161 -0
  103. package/src/lib/schema.js +211 -0
  104. package/src/lib/shell.js +75 -0
  105. package/src/patterns/gitignore/claude-code.txt +25 -0
  106. package/src/patterns/gitignore/docker.txt +15 -0
  107. package/src/patterns/gitignore/go.txt +24 -0
  108. package/src/patterns/gitignore/java.txt +38 -0
  109. package/src/patterns/gitignore/jetbrains.txt +26 -0
  110. package/src/patterns/gitignore/linux.txt +18 -0
  111. package/src/patterns/gitignore/macos.txt +27 -0
  112. package/src/patterns/gitignore/node.txt +51 -0
  113. package/src/patterns/gitignore/python.txt +55 -0
  114. package/src/patterns/gitignore/rust.txt +14 -0
  115. package/src/patterns/gitignore/terraform.txt +30 -0
  116. package/src/patterns/gitignore/vscode.txt +15 -0
  117. package/src/patterns/gitignore/windows.txt +25 -0
  118. package/src/utils/clone/index.js +165 -0
  119. package/src/utils/git-push/index.js +230 -0
  120. package/src/utils/git-status/index.js +116 -0
  121. package/src/utils/git-status/unix.sh +75 -0
  122. package/src/utils/registry.json +41 -0
  123. package/bin/dev.js +0 -16
  124. package/files/README.md +0 -0
  125. package/files/claude/.claude/commands/setup-context.md +0 -3
  126. package/files/monorepos/_archive/README.md +0 -36
  127. package/files/monorepos/_legacy/README.md +0 -36
  128. package/files/monorepos/ai-docs/README.md +0 -33
  129. package/files/monorepos/apps/README.md +0 -24
  130. package/files/monorepos/docs/README.md +0 -40
  131. package/files/monorepos/packages/README.md +0 -25
  132. package/files/monorepos/research/README.md +0 -29
  133. package/files/monorepos/scripts/README.md +0 -24
  134. package/src/commands/README.md +0 -41
  135. package/src/commands/configure.js +0 -199
  136. package/src/commands/identity.js +0 -1630
  137. package/src/commands/ignore.js +0 -247
  138. package/src/commands/install.js +0 -526
  139. package/src/commands/setup.js +0 -246
  140. package/src/completion.js +0 -284
  141. package/src/constants.js +0 -45
  142. package/src/ignore/claude-code.txt +0 -10
  143. package/src/ignore/docker.txt +0 -18
  144. package/src/ignore/linux.txt +0 -23
  145. package/src/ignore/macos.txt +0 -36
  146. package/src/ignore/node.txt +0 -55
  147. package/src/ignore/terraform.txt +0 -37
  148. package/src/ignore/vscode.txt +0 -18
  149. package/src/ignore/windows.txt +0 -35
  150. package/src/index.js +0 -0
  151. package/src/installs/README.md +0 -399
  152. package/src/installs/adobe-creative-cloud.js +0 -546
  153. package/src/installs/adobe-creative-cloud.md +0 -605
  154. package/src/installs/appcleaner.js +0 -321
  155. package/src/installs/appcleaner.md +0 -699
  156. package/src/installs/apt-transport-https.js +0 -390
  157. package/src/installs/apt-transport-https.md +0 -678
  158. package/src/installs/atomicparsley.js +0 -642
  159. package/src/installs/atomicparsley.md +0 -795
  160. package/src/installs/aws-cli.js +0 -797
  161. package/src/installs/aws-cli.md +0 -727
  162. package/src/installs/balena-etcher.js +0 -710
  163. package/src/installs/balena-etcher.md +0 -761
  164. package/src/installs/bambu-studio.js +0 -1143
  165. package/src/installs/bambu-studio.md +0 -780
  166. package/src/installs/bash-completion.js +0 -575
  167. package/src/installs/bash-completion.md +0 -833
  168. package/src/installs/bash.js +0 -417
  169. package/src/installs/bash.md +0 -993
  170. package/src/installs/beyond-compare.js +0 -603
  171. package/src/installs/beyond-compare.md +0 -813
  172. package/src/installs/brave-browser.js +0 -968
  173. package/src/installs/brave-browser.md +0 -650
  174. package/src/installs/build-essential.js +0 -529
  175. package/src/installs/build-essential.md +0 -977
  176. package/src/installs/ca-certificates.js +0 -618
  177. package/src/installs/ca-certificates.md +0 -937
  178. package/src/installs/caffeine.js +0 -508
  179. package/src/installs/caffeine.md +0 -839
  180. package/src/installs/camtasia.js +0 -596
  181. package/src/installs/camtasia.md +0 -762
  182. package/src/installs/chatgpt.js +0 -476
  183. package/src/installs/chatgpt.md +0 -814
  184. package/src/installs/chocolatey.js +0 -456
  185. package/src/installs/chocolatey.md +0 -661
  186. package/src/installs/chrome-canary.js +0 -419
  187. package/src/installs/chrome-canary.md +0 -641
  188. package/src/installs/chromium.js +0 -667
  189. package/src/installs/chromium.md +0 -838
  190. package/src/installs/claude-code.js +0 -576
  191. package/src/installs/claude-code.md +0 -1173
  192. package/src/installs/cloudflare-warp.js +0 -900
  193. package/src/installs/cloudflare-warp.md +0 -1047
  194. package/src/installs/comet-browser.js +0 -588
  195. package/src/installs/comet-browser.md +0 -731
  196. package/src/installs/curl.js +0 -379
  197. package/src/installs/curl.md +0 -714
  198. package/src/installs/cursor.js +0 -579
  199. package/src/installs/cursor.md +0 -970
  200. package/src/installs/dbeaver.js +0 -924
  201. package/src/installs/dbeaver.md +0 -939
  202. package/src/installs/dbschema.js +0 -692
  203. package/src/installs/dbschema.md +0 -925
  204. package/src/installs/dependencies.md +0 -453
  205. package/src/installs/development-tools.js +0 -600
  206. package/src/installs/development-tools.md +0 -977
  207. package/src/installs/docker.js +0 -1029
  208. package/src/installs/docker.md +0 -1109
  209. package/src/installs/drawio.js +0 -1019
  210. package/src/installs/drawio.md +0 -795
  211. package/src/installs/elmedia-player.js +0 -347
  212. package/src/installs/elmedia-player.md +0 -556
  213. package/src/installs/ffmpeg.js +0 -889
  214. package/src/installs/ffmpeg.md +0 -852
  215. package/src/installs/file.js +0 -464
  216. package/src/installs/file.md +0 -987
  217. package/src/installs/gemini-cli.js +0 -811
  218. package/src/installs/gemini-cli.md +0 -1153
  219. package/src/installs/git.js +0 -400
  220. package/src/installs/git.md +0 -907
  221. package/src/installs/gitego.js +0 -949
  222. package/src/installs/gitego.md +0 -1172
  223. package/src/installs/go.js +0 -931
  224. package/src/installs/go.md +0 -958
  225. package/src/installs/google-antigravity.js +0 -913
  226. package/src/installs/google-antigravity.md +0 -1075
  227. package/src/installs/google-chrome.js +0 -833
  228. package/src/installs/google-chrome.md +0 -862
  229. package/src/installs/gpg.js +0 -480
  230. package/src/installs/gpg.md +0 -1056
  231. package/src/installs/homebrew.js +0 -1028
  232. package/src/installs/homebrew.md +0 -988
  233. package/src/installs/imageoptim.js +0 -968
  234. package/src/installs/imageoptim.md +0 -1119
  235. package/src/installs/installers.json +0 -4032
  236. package/src/installs/installers.json.tmp +0 -3953
  237. package/src/installs/jq.js +0 -400
  238. package/src/installs/jq.md +0 -809
  239. package/src/installs/keyboard-maestro.js +0 -719
  240. package/src/installs/keyboard-maestro.md +0 -825
  241. package/src/installs/kiro.js +0 -864
  242. package/src/installs/kiro.md +0 -1015
  243. package/src/installs/latex.js +0 -789
  244. package/src/installs/latex.md +0 -1095
  245. package/src/installs/lftp.js +0 -356
  246. package/src/installs/lftp.md +0 -907
  247. package/src/installs/lsb-release.js +0 -346
  248. package/src/installs/lsb-release.md +0 -814
  249. package/src/installs/messenger.js +0 -847
  250. package/src/installs/messenger.md +0 -900
  251. package/src/installs/microsoft-office.js +0 -568
  252. package/src/installs/microsoft-office.md +0 -760
  253. package/src/installs/microsoft-teams.js +0 -801
  254. package/src/installs/microsoft-teams.md +0 -886
  255. package/src/installs/moom.js +0 -326
  256. package/src/installs/moom.md +0 -570
  257. package/src/installs/node.js +0 -904
  258. package/src/installs/node.md +0 -1153
  259. package/src/installs/nordpass.js +0 -716
  260. package/src/installs/nordpass.md +0 -921
  261. package/src/installs/nordvpn.js +0 -892
  262. package/src/installs/nordvpn.md +0 -1052
  263. package/src/installs/nvm.js +0 -995
  264. package/src/installs/nvm.md +0 -1057
  265. package/src/installs/ohmyzsh.js +0 -529
  266. package/src/installs/ohmyzsh.md +0 -1094
  267. package/src/installs/openssh.js +0 -804
  268. package/src/installs/openssh.md +0 -1056
  269. package/src/installs/pandoc.js +0 -662
  270. package/src/installs/pandoc.md +0 -1036
  271. package/src/installs/parallels-desktop.js +0 -431
  272. package/src/installs/parallels-desktop.md +0 -446
  273. package/src/installs/pinentry.js +0 -510
  274. package/src/installs/pinentry.md +0 -1142
  275. package/src/installs/pngyu.js +0 -869
  276. package/src/installs/pngyu.md +0 -896
  277. package/src/installs/postman.js +0 -799
  278. package/src/installs/postman.md +0 -940
  279. package/src/installs/procps.js +0 -425
  280. package/src/installs/procps.md +0 -851
  281. package/src/installs/safari-tech-preview.js +0 -374
  282. package/src/installs/safari-tech-preview.md +0 -533
  283. package/src/installs/sfnt2woff.js +0 -658
  284. package/src/installs/sfnt2woff.md +0 -795
  285. package/src/installs/shellcheck.js +0 -481
  286. package/src/installs/shellcheck.md +0 -1005
  287. package/src/installs/slack.js +0 -741
  288. package/src/installs/slack.md +0 -865
  289. package/src/installs/snagit.js +0 -585
  290. package/src/installs/snagit.md +0 -844
  291. package/src/installs/software-properties-common.js +0 -372
  292. package/src/installs/software-properties-common.md +0 -805
  293. package/src/installs/spotify.js +0 -877
  294. package/src/installs/spotify.md +0 -901
  295. package/src/installs/studio-3t.js +0 -823
  296. package/src/installs/studio-3t.md +0 -918
  297. package/src/installs/sublime-text.js +0 -804
  298. package/src/installs/sublime-text.md +0 -914
  299. package/src/installs/superwhisper.js +0 -706
  300. package/src/installs/superwhisper.md +0 -630
  301. package/src/installs/tailscale.js +0 -745
  302. package/src/installs/tailscale.md +0 -1100
  303. package/src/installs/tar.js +0 -389
  304. package/src/installs/tar.md +0 -946
  305. package/src/installs/termius.js +0 -798
  306. package/src/installs/termius.md +0 -844
  307. package/src/installs/terraform.js +0 -779
  308. package/src/installs/terraform.md +0 -899
  309. package/src/installs/tfenv.js +0 -778
  310. package/src/installs/tfenv.md +0 -1091
  311. package/src/installs/tidal.js +0 -771
  312. package/src/installs/tidal.md +0 -864
  313. package/src/installs/tmux.js +0 -346
  314. package/src/installs/tmux.md +0 -1030
  315. package/src/installs/tree.js +0 -411
  316. package/src/installs/tree.md +0 -833
  317. package/src/installs/unzip.js +0 -460
  318. package/src/installs/unzip.md +0 -879
  319. package/src/installs/vim.js +0 -421
  320. package/src/installs/vim.md +0 -1040
  321. package/src/installs/vlc.js +0 -821
  322. package/src/installs/vlc.md +0 -927
  323. package/src/installs/vscode.js +0 -843
  324. package/src/installs/vscode.md +0 -1002
  325. package/src/installs/wget.js +0 -420
  326. package/src/installs/wget.md +0 -791
  327. package/src/installs/whatsapp.js +0 -729
  328. package/src/installs/whatsapp.md +0 -854
  329. package/src/installs/winpty.js +0 -352
  330. package/src/installs/winpty.md +0 -620
  331. package/src/installs/woff2.js +0 -553
  332. package/src/installs/woff2.md +0 -977
  333. package/src/installs/wsl.js +0 -572
  334. package/src/installs/wsl.md +0 -699
  335. package/src/installs/xcode-clt.js +0 -520
  336. package/src/installs/xcode-clt.md +0 -351
  337. package/src/installs/xcode.js +0 -560
  338. package/src/installs/xcode.md +0 -573
  339. package/src/installs/yarn.js +0 -824
  340. package/src/installs/yarn.md +0 -1074
  341. package/src/installs/yq.js +0 -654
  342. package/src/installs/yq.md +0 -944
  343. package/src/installs/yt-dlp.js +0 -701
  344. package/src/installs/yt-dlp.md +0 -946
  345. package/src/installs/yum-utils.js +0 -297
  346. package/src/installs/yum-utils.md +0 -648
  347. package/src/installs/zoom.js +0 -759
  348. package/src/installs/zoom.md +0 -884
  349. package/src/installs/zsh.js +0 -455
  350. package/src/installs/zsh.md +0 -1008
  351. package/src/scripts/README.md +0 -617
  352. package/src/scripts/STATUS.md +0 -208
  353. package/src/scripts/afk.js +0 -411
  354. package/src/scripts/backup-all.js +0 -746
  355. package/src/scripts/backup-source.js +0 -727
  356. package/src/scripts/brewd.js +0 -389
  357. package/src/scripts/brewi.js +0 -520
  358. package/src/scripts/brewr.js +0 -527
  359. package/src/scripts/brews.js +0 -477
  360. package/src/scripts/brewu.js +0 -504
  361. package/src/scripts/c.js +0 -201
  362. package/src/scripts/ccurl.js +0 -341
  363. package/src/scripts/certbot-crontab-init.js +0 -504
  364. package/src/scripts/certbot-init.js +0 -657
  365. package/src/scripts/ch.js +0 -355
  366. package/src/scripts/claude-danger.js +0 -268
  367. package/src/scripts/clean-dev.js +0 -435
  368. package/src/scripts/clear-dns-cache.js +0 -541
  369. package/src/scripts/clone.js +0 -435
  370. package/src/scripts/code-all.js +0 -437
  371. package/src/scripts/count-files.js +0 -211
  372. package/src/scripts/count-folders.js +0 -211
  373. package/src/scripts/count.js +0 -264
  374. package/src/scripts/d.js +0 -219
  375. package/src/scripts/datauri.js +0 -389
  376. package/src/scripts/delete-files.js +0 -380
  377. package/src/scripts/docker-clean.js +0 -426
  378. package/src/scripts/dp.js +0 -442
  379. package/src/scripts/e.js +0 -390
  380. package/src/scripts/empty-trash.js +0 -513
  381. package/src/scripts/evm.js +0 -444
  382. package/src/scripts/fetch-github-repos.js +0 -456
  383. package/src/scripts/get-channel.js +0 -345
  384. package/src/scripts/get-course.js +0 -399
  385. package/src/scripts/get-dependencies.js +0 -306
  386. package/src/scripts/get-folder.js +0 -799
  387. package/src/scripts/get-tunes.js +0 -426
  388. package/src/scripts/get-video.js +0 -367
  389. package/src/scripts/git-backup.js +0 -577
  390. package/src/scripts/git-clone.js +0 -493
  391. package/src/scripts/git-pup.js +0 -319
  392. package/src/scripts/git-push.js +0 -396
  393. package/src/scripts/h.js +0 -622
  394. package/src/scripts/hide-desktop-icons.js +0 -499
  395. package/src/scripts/hide-hidden-files.js +0 -538
  396. package/src/scripts/install-dependencies-from.js +0 -456
  397. package/src/scripts/ips.js +0 -663
  398. package/src/scripts/iso.js +0 -370
  399. package/src/scripts/killni.js +0 -577
  400. package/src/scripts/ll.js +0 -467
  401. package/src/scripts/local-ip.js +0 -325
  402. package/src/scripts/m.js +0 -524
  403. package/src/scripts/map.js +0 -309
  404. package/src/scripts/mkd.js +0 -351
  405. package/src/scripts/ncu-update-all.js +0 -457
  406. package/src/scripts/nginx-init.js +0 -718
  407. package/src/scripts/npmi.js +0 -382
  408. package/src/scripts/o.js +0 -511
  409. package/src/scripts/org-by-date.js +0 -338
  410. package/src/scripts/p.js +0 -224
  411. package/src/scripts/packages.js +0 -330
  412. package/src/scripts/path.js +0 -225
  413. package/src/scripts/ports.js +0 -597
  414. package/src/scripts/q.js +0 -305
  415. package/src/scripts/refresh-files.js +0 -394
  416. package/src/scripts/remove-smaller-files.js +0 -516
  417. package/src/scripts/rename-files-with-date.js +0 -533
  418. package/src/scripts/resize-image.js +0 -539
  419. package/src/scripts/rm-safe.js +0 -669
  420. package/src/scripts/s.js +0 -540
  421. package/src/scripts/set-git-public.js +0 -365
  422. package/src/scripts/show-desktop-icons.js +0 -475
  423. package/src/scripts/show-hidden-files.js +0 -472
  424. package/src/scripts/tpa.js +0 -280
  425. package/src/scripts/tpo.js +0 -280
  426. package/src/scripts/u.js +0 -505
  427. package/src/scripts/vpush.js +0 -437
  428. package/src/scripts/y.js +0 -283
  429. package/src/utils/README.md +0 -95
  430. package/src/utils/common/apps.js +0 -143
  431. package/src/utils/common/display.js +0 -157
  432. package/src/utils/common/network.js +0 -185
  433. package/src/utils/common/os.js +0 -294
  434. package/src/utils/common/package-manager.js +0 -301
  435. package/src/utils/common/privileges.js +0 -138
  436. package/src/utils/common/shell.js +0 -261
  437. package/src/utils/macos/apps.js +0 -228
  438. package/src/utils/macos/brew.js +0 -315
  439. package/src/utils/ubuntu/apt.js +0 -307
  440. package/src/utils/ubuntu/desktop.js +0 -292
  441. package/src/utils/ubuntu/snap.js +0 -344
  442. package/src/utils/ubuntu/systemd.js +0 -286
  443. package/src/utils/windows/choco.js +0 -465
  444. package/src/utils/windows/env.js +0 -246
  445. package/src/utils/windows/registry.js +0 -269
  446. package/src/utils/windows/shell.js +0 -240
  447. package/src/utils/windows/winget.js +0 -489
@@ -1,833 +0,0 @@
1
- #!/usr/bin/env node
2
-
3
- /**
4
- * @fileoverview Install Google Chrome.
5
- * @module installs/google-chrome
6
- *
7
- * Google Chrome is a fast, secure, and free web browser built by Google.
8
- * It is the most widely used web browser globally, featuring automatic updates,
9
- * built-in PDF viewer, password manager, and powerful developer tools.
10
- *
11
- * This installer provides:
12
- * - Google Chrome via Homebrew cask on macOS
13
- * - Google Chrome via official .deb package on Ubuntu/Debian
14
- * - Google Chrome via official .rpm package on Amazon Linux/RHEL
15
- * - Google Chrome via Chocolatey or winget on Windows
16
- * - Google Chrome within WSL (same as Ubuntu installation)
17
- * - Google Chrome on Windows host from Git Bash
18
- *
19
- * IMPORTANT PLATFORM NOTES:
20
- * - Raspberry Pi OS: Google Chrome does NOT support ARM architecture.
21
- * Google only provides x86/x64 builds. The installer will display
22
- * a graceful message for unsupported platforms.
23
- * - ARM-based systems: Chrome is only available for x86_64 architecture.
24
- */
25
-
26
- const os = require('../utils/common/os');
27
- const shell = require('../utils/common/shell');
28
- const brew = require('../utils/macos/brew');
29
- const choco = require('../utils/windows/choco');
30
- const winget = require('../utils/windows/winget');
31
-
32
- /**
33
- * Indicates whether this installer requires a desktop environment.
34
- * Google Chrome is a GUI web browser and requires a display.
35
- * @type {boolean}
36
- */
37
- const REQUIRES_DESKTOP = true;
38
-
39
- /**
40
- * The Homebrew cask name for Google Chrome on macOS.
41
- * Using the cask (not formula) because Chrome is a GUI application.
42
- */
43
- const HOMEBREW_CASK_NAME = 'google-chrome';
44
-
45
- /**
46
- * The Chocolatey package name for Google Chrome on Windows.
47
- */
48
- const CHOCO_PACKAGE_NAME = 'googlechrome';
49
-
50
- /**
51
- * The winget package ID for Google Chrome on Windows.
52
- * Using the full ID ensures we get the correct package.
53
- */
54
- const WINGET_PACKAGE_ID = 'Google.Chrome';
55
-
56
- /**
57
- * Path to Google Chrome application on macOS.
58
- * Used to verify installation succeeded.
59
- */
60
- const MACOS_APP_PATH = '/Applications/Google Chrome.app';
61
-
62
- /**
63
- * Path to Google Chrome executable on Windows (system-wide installation).
64
- * Used to verify installation and check version.
65
- */
66
- const WINDOWS_CHROME_PATH = 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe';
67
-
68
- /**
69
- * URL to download the official Google Chrome .deb package.
70
- * This package also sets up the Google repository for automatic updates.
71
- */
72
- const CHROME_DEB_URL = 'https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb';
73
-
74
- /**
75
- * URL to download the official Google Chrome .rpm package.
76
- * Used for Amazon Linux and RHEL installations.
77
- */
78
- const CHROME_RPM_URL = 'https://dl.google.com/linux/direct/google-chrome-stable_current_x86_64.rpm';
79
-
80
- /**
81
- * Check if Google Chrome is installed on macOS by verifying the app bundle exists.
82
- *
83
- * On macOS, GUI applications are typically installed as .app bundles in /Applications.
84
- * We check for the bundle's existence rather than relying on PATH because Chrome
85
- * is a GUI application that may not add itself to the shell PATH.
86
- *
87
- * @returns {boolean} True if Google Chrome.app exists in /Applications, false otherwise
88
- */
89
- function isChromeInstalledMacOS() {
90
- const fs = require('fs');
91
- return fs.existsSync(MACOS_APP_PATH);
92
- }
93
-
94
- /**
95
- * Get the installed version of Google Chrome on macOS.
96
- *
97
- * Executes the Chrome binary within the app bundle with --version flag.
98
- * The output format is: "Google Chrome 143.0.7499.170"
99
- *
100
- * @returns {Promise<string|null>} Version string (e.g., "143.0.7499.170") or null if not installed
101
- */
102
- async function getChromeVersionMacOS() {
103
- if (!isChromeInstalledMacOS()) {
104
- return null;
105
- }
106
-
107
- const chromePath = `${MACOS_APP_PATH}/Contents/MacOS/Google Chrome`;
108
- const result = await shell.exec(`"${chromePath}" --version`);
109
-
110
- if (result.code === 0 && result.stdout) {
111
- // Output format: "Google Chrome 143.0.7499.170"
112
- const match = result.stdout.match(/Google Chrome\s+([\d.]+)/);
113
- return match ? match[1] : null;
114
- }
115
- return null;
116
- }
117
-
118
- /**
119
- * Check if Google Chrome is installed on Linux by verifying the google-chrome command exists.
120
- *
121
- * When installed from Google's official .deb or .rpm package, Chrome adds the
122
- * 'google-chrome' or 'google-chrome-stable' command to /usr/bin.
123
- *
124
- * @returns {boolean} True if the google-chrome command is available, false otherwise
125
- */
126
- function isChromeInstalledLinux() {
127
- return shell.commandExists('google-chrome') || shell.commandExists('google-chrome-stable');
128
- }
129
-
130
- /**
131
- * Get the installed version of Google Chrome on Linux.
132
- *
133
- * Tries both 'google-chrome' and 'google-chrome-stable' commands since
134
- * the command name varies between distributions.
135
- *
136
- * @returns {Promise<string|null>} Version string or null if not installed
137
- */
138
- async function getChromeVersionLinux() {
139
- // Try google-chrome first (common symlink name)
140
- if (shell.commandExists('google-chrome')) {
141
- const result = await shell.exec('google-chrome --version');
142
- if (result.code === 0 && result.stdout) {
143
- const match = result.stdout.match(/Google Chrome\s+([\d.]+)/);
144
- return match ? match[1] : null;
145
- }
146
- }
147
-
148
- // Fall back to google-chrome-stable (actual binary name)
149
- if (shell.commandExists('google-chrome-stable')) {
150
- const result = await shell.exec('google-chrome-stable --version');
151
- if (result.code === 0 && result.stdout) {
152
- const match = result.stdout.match(/Google Chrome\s+([\d.]+)/);
153
- return match ? match[1] : null;
154
- }
155
- }
156
-
157
- return null;
158
- }
159
-
160
- /**
161
- * Check if Google Chrome is installed on Windows.
162
- *
163
- * Checks for the Chrome executable at the default installation path.
164
- * Chrome is typically installed to Program Files for system-wide installation
165
- * or to LocalAppData for per-user installation.
166
- *
167
- * @returns {boolean} True if Chrome executable exists, false otherwise
168
- */
169
- function isChromeInstalledWindows() {
170
- const fs = require('fs');
171
-
172
- // Check system-wide installation path
173
- if (fs.existsSync(WINDOWS_CHROME_PATH)) {
174
- return true;
175
- }
176
-
177
- // Check per-user installation path
178
- const localAppData = process.env.LOCALAPPDATA;
179
- if (localAppData) {
180
- const userPath = `${localAppData}\\Google\\Chrome\\Application\\chrome.exe`;
181
- if (fs.existsSync(userPath)) {
182
- return true;
183
- }
184
- }
185
-
186
- return false;
187
- }
188
-
189
- /**
190
- * Get the installed version of Google Chrome on Windows.
191
- *
192
- * Executes the Chrome executable with --version flag to retrieve the version.
193
- *
194
- * @returns {Promise<string|null>} Version string or null if not installed
195
- */
196
- async function getChromeVersionWindows() {
197
- const fs = require('fs');
198
-
199
- // Determine which path has Chrome installed
200
- let chromePath = null;
201
- if (fs.existsSync(WINDOWS_CHROME_PATH)) {
202
- chromePath = WINDOWS_CHROME_PATH;
203
- } else {
204
- const localAppData = process.env.LOCALAPPDATA;
205
- if (localAppData) {
206
- const userPath = `${localAppData}\\Google\\Chrome\\Application\\chrome.exe`;
207
- if (fs.existsSync(userPath)) {
208
- chromePath = userPath;
209
- }
210
- }
211
- }
212
-
213
- if (!chromePath) {
214
- return null;
215
- }
216
-
217
- const result = await shell.exec(`"${chromePath}" --version`);
218
- if (result.code === 0 && result.stdout) {
219
- const match = result.stdout.match(/Google Chrome\s+([\d.]+)/);
220
- return match ? match[1] : null;
221
- }
222
- return null;
223
- }
224
-
225
- /**
226
- * Install Google Chrome on macOS using Homebrew.
227
- *
228
- * Prerequisites:
229
- * - macOS 12 (Monterey) or later
230
- * - Homebrew package manager installed
231
- * - Terminal access
232
- *
233
- * The installation uses the Homebrew cask 'google-chrome' which downloads
234
- * and installs Chrome to /Applications/Google Chrome.app.
235
- *
236
- * This function is idempotent - it checks if Chrome is already installed
237
- * before attempting installation and skips if already present.
238
- *
239
- * @returns {Promise<void>}
240
- * @throws {Error} If Homebrew is not installed or installation fails
241
- */
242
- async function install_macos() {
243
- console.log('Checking if Google Chrome is already installed...');
244
-
245
- // Check if Chrome is already installed via file system check
246
- if (isChromeInstalledMacOS()) {
247
- const version = await getChromeVersionMacOS();
248
- if (version) {
249
- console.log(`Google Chrome ${version} is already installed, skipping installation.`);
250
- } else {
251
- console.log('Google Chrome is already installed, skipping installation.');
252
- }
253
- return;
254
- }
255
-
256
- // Also check if the Homebrew cask is installed (Chrome may be installed but not detected)
257
- const caskInstalled = await brew.isCaskInstalled(HOMEBREW_CASK_NAME);
258
- if (caskInstalled) {
259
- console.log('Google Chrome is already installed via Homebrew, skipping installation.');
260
- return;
261
- }
262
-
263
- // Verify Homebrew is available before proceeding
264
- if (!brew.isInstalled()) {
265
- throw new Error(
266
- 'Homebrew is not installed. Please install Homebrew first using:\n' +
267
- ' dev install homebrew\n' +
268
- 'Then retry installing Google Chrome.'
269
- );
270
- }
271
-
272
- console.log('Installing Google Chrome via Homebrew...');
273
-
274
- // Install Google Chrome cask using the --quiet flag for cleaner output
275
- const result = await brew.installCask(HOMEBREW_CASK_NAME);
276
-
277
- if (!result.success) {
278
- throw new Error(
279
- `Failed to install Google Chrome via Homebrew.\n` +
280
- `Output: ${result.output}\n\n` +
281
- `Troubleshooting:\n` +
282
- ` 1. Run 'brew update && brew cleanup' and retry\n` +
283
- ` 2. Try manual installation: brew reinstall --cask google-chrome\n` +
284
- ` 3. Check if macOS Gatekeeper is blocking the app:\n` +
285
- ` xattr -cr /Applications/Google\\ Chrome.app`
286
- );
287
- }
288
-
289
- // Verify the installation succeeded
290
- if (!isChromeInstalledMacOS()) {
291
- throw new Error(
292
- 'Installation appeared to complete but Google Chrome was not found.\n\n' +
293
- 'Please check /Applications folder for Google Chrome.app'
294
- );
295
- }
296
-
297
- const installedVersion = await getChromeVersionMacOS();
298
- console.log(`Google Chrome ${installedVersion || ''} installed successfully.`);
299
- console.log('');
300
- console.log('You can launch Chrome from Applications or run:');
301
- console.log(' open -a "Google Chrome"');
302
- }
303
-
304
- /**
305
- * Install Google Chrome on Ubuntu/Debian using APT.
306
- *
307
- * Prerequisites:
308
- * - Ubuntu 18.04 or later, or Debian 10 or later (64-bit only)
309
- * - sudo privileges
310
- * - wget installed (used to download the .deb package)
311
- *
312
- * This function downloads Google's official .deb package and installs it.
313
- * The .deb package automatically adds Google's APT repository for future updates.
314
- *
315
- * IMPORTANT: Google Chrome is NOT available in Ubuntu's default repositories.
316
- * Always use Google's official package to ensure you get the latest version
317
- * with security updates.
318
- *
319
- * This function is idempotent - it checks if Chrome is already installed
320
- * before attempting installation.
321
- *
322
- * @returns {Promise<void>}
323
- * @throws {Error} If installation fails
324
- */
325
- async function install_ubuntu() {
326
- console.log('Checking if Google Chrome is already installed...');
327
-
328
- // Check if Chrome is already installed
329
- if (isChromeInstalledLinux()) {
330
- const version = await getChromeVersionLinux();
331
- if (version) {
332
- console.log(`Google Chrome ${version} is already installed, skipping installation.`);
333
- } else {
334
- console.log('Google Chrome is already installed, skipping installation.');
335
- }
336
- return;
337
- }
338
-
339
- console.log('Installing Google Chrome from Google\'s official repository...');
340
-
341
- // Step 1: Download the .deb package
342
- // Using wget with -q for quiet mode (suitable for automation)
343
- console.log('Downloading Google Chrome package...');
344
- const downloadResult = await shell.exec(
345
- `wget -q ${CHROME_DEB_URL} -O /tmp/google-chrome-stable_current_amd64.deb`
346
- );
347
-
348
- if (downloadResult.code !== 0) {
349
- throw new Error(
350
- `Failed to download Google Chrome package.\n` +
351
- `Error: ${downloadResult.stderr}\n\n` +
352
- `Troubleshooting:\n` +
353
- ` 1. Check your internet connection\n` +
354
- ` 2. Ensure wget is installed: sudo apt-get install wget\n` +
355
- ` 3. Try downloading manually: wget ${CHROME_DEB_URL}`
356
- );
357
- }
358
-
359
- // Step 2: Install the package using apt-get
360
- // DEBIAN_FRONTEND=noninteractive prevents interactive prompts during installation
361
- console.log('Installing Google Chrome...');
362
- const installResult = await shell.exec(
363
- 'sudo DEBIAN_FRONTEND=noninteractive apt-get install -y /tmp/google-chrome-stable_current_amd64.deb'
364
- );
365
-
366
- // Clean up the downloaded .deb file regardless of installation result
367
- await shell.exec('rm -f /tmp/google-chrome-stable_current_amd64.deb');
368
-
369
- if (installResult.code !== 0) {
370
- // Try to fix broken dependencies and retry
371
- console.log('Attempting to fix broken dependencies...');
372
- const fixResult = await shell.exec('sudo DEBIAN_FRONTEND=noninteractive apt-get install -y -f');
373
-
374
- if (fixResult.code !== 0) {
375
- throw new Error(
376
- `Failed to install Google Chrome.\n` +
377
- `Error: ${installResult.stderr}\n\n` +
378
- `Troubleshooting:\n` +
379
- ` 1. Run: sudo apt-get update\n` +
380
- ` 2. Install missing dependencies: sudo apt-get install -y -f\n` +
381
- ` 3. Try again: sudo apt-get install -y ./google-chrome-stable_current_amd64.deb`
382
- );
383
- }
384
- }
385
-
386
- // Verify installation
387
- if (!isChromeInstalledLinux()) {
388
- throw new Error(
389
- 'Installation appeared to complete but Google Chrome was not found.\n\n' +
390
- 'Please try running: google-chrome --version'
391
- );
392
- }
393
-
394
- const installedVersion = await getChromeVersionLinux();
395
- console.log(`Google Chrome ${installedVersion || ''} installed successfully.`);
396
- console.log('');
397
- console.log('Launch Chrome with:');
398
- console.log(' google-chrome &');
399
- console.log('');
400
- console.log('NOTE: Chrome will automatically update via apt-get upgrade.');
401
- }
402
-
403
- /**
404
- * Install Google Chrome on Ubuntu running in WSL (Windows Subsystem for Linux).
405
- *
406
- * Prerequisites:
407
- * - Windows 10 version 2004 or higher, or Windows 11
408
- * - WSL 2 with Ubuntu distribution installed
409
- * - WSLg enabled (included by default in Windows 11 and Windows 10 21H2+)
410
- * - sudo privileges within WSL
411
- *
412
- * This function installs Chrome using the same method as Ubuntu since
413
- * WSL Ubuntu is functionally identical to native Ubuntu for package management.
414
- * However, running Chrome requires WSLg for GUI support.
415
- *
416
- * @returns {Promise<void>}
417
- * @throws {Error} If installation fails
418
- */
419
- async function install_ubuntu_wsl() {
420
- console.log('Detected Ubuntu running in WSL (Windows Subsystem for Linux).');
421
- console.log('');
422
-
423
- // Use the same installation process as Ubuntu
424
- await install_ubuntu();
425
-
426
- // Add WSL-specific post-installation notes
427
- console.log('');
428
- console.log('WSL-SPECIFIC NOTES:');
429
- console.log('');
430
- console.log('1. Running GUI apps in WSL requires WSLg (Windows 11 / Windows 10 21H2+).');
431
- console.log(' If Chrome fails to launch, ensure WSLg is enabled.');
432
- console.log('');
433
- console.log('2. If you see sandbox errors, try:');
434
- console.log(' google-chrome --no-sandbox');
435
- console.log('');
436
- console.log('3. For headless automation in WSL:');
437
- console.log(' google-chrome --headless --disable-gpu --dump-dom https://example.com');
438
- }
439
-
440
- /**
441
- * Install Google Chrome on Raspberry Pi OS.
442
- *
443
- * IMPORTANT: Google Chrome does NOT support ARM architecture.
444
- * Google only provides x86/x64 builds of Chrome, and Raspberry Pi uses ARM processors.
445
- * This means Google Chrome cannot be installed natively on any Raspberry Pi device.
446
- *
447
- * This function gracefully informs the user that Chrome is not available
448
- * on this platform without throwing an error or suggesting alternatives.
449
- *
450
- * @returns {Promise<void>}
451
- */
452
- async function install_raspbian() {
453
- console.log('Google Chrome is not available for Raspberry Pi OS.');
454
- return;
455
- }
456
-
457
- /**
458
- * Install Google Chrome on Amazon Linux using DNF/YUM.
459
- *
460
- * Prerequisites:
461
- * - Amazon Linux 2023 (AL2023) recommended
462
- * - Amazon Linux 2 is supported but reached end of standard support
463
- * - sudo privileges
464
- * - x86_64 architecture (ARM/Graviton instances are not supported)
465
- *
466
- * This function downloads and installs Google's official RPM package.
467
- * Amazon Linux 2023 uses DNF, while Amazon Linux 2 uses YUM.
468
- *
469
- * NOTE: Google does not officially support Chrome on Amazon Linux, but the
470
- * Chrome RPM package installs successfully on both AL2023 and AL2.
471
- *
472
- * @returns {Promise<void>}
473
- * @throws {Error} If installation fails
474
- */
475
- async function install_amazon_linux() {
476
- console.log('Checking if Google Chrome is already installed...');
477
-
478
- // Check if Chrome is already installed
479
- if (isChromeInstalledLinux()) {
480
- const version = await getChromeVersionLinux();
481
- if (version) {
482
- console.log(`Google Chrome ${version} is already installed, skipping installation.`);
483
- } else {
484
- console.log('Google Chrome is already installed, skipping installation.');
485
- }
486
- return;
487
- }
488
-
489
- // Detect package manager (dnf for AL2023, yum for AL2)
490
- const hasDnf = shell.commandExists('dnf');
491
- const hasYum = shell.commandExists('yum');
492
- const packageManager = hasDnf ? 'dnf' : (hasYum ? 'yum' : null);
493
-
494
- if (!packageManager) {
495
- throw new Error(
496
- 'Neither dnf nor yum package manager found.\n' +
497
- 'This installer supports Amazon Linux 2023 (dnf) and Amazon Linux 2 (yum).'
498
- );
499
- }
500
-
501
- console.log(`Detected package manager: ${packageManager}`);
502
- console.log('Installing Google Chrome from Google\'s official RPM package...');
503
-
504
- // Install Chrome directly from Google's RPM URL
505
- // This method also installs required dependencies automatically
506
- const installResult = await shell.exec(
507
- `sudo ${packageManager} install -y ${CHROME_RPM_URL}`
508
- );
509
-
510
- if (installResult.code !== 0) {
511
- throw new Error(
512
- `Failed to install Google Chrome.\n` +
513
- `Error: ${installResult.stderr}\n\n` +
514
- `Troubleshooting:\n` +
515
- ` 1. Install common dependencies first:\n` +
516
- ` sudo ${packageManager} install -y libXcomposite libXdamage libXrandr libgbm libxkbcommon pango alsa-lib atk at-spi2-atk cups-libs libdrm mesa-libgbm\n` +
517
- ` 2. Then retry: sudo ${packageManager} install -y ${CHROME_RPM_URL}`
518
- );
519
- }
520
-
521
- // Verify installation
522
- if (!isChromeInstalledLinux()) {
523
- throw new Error(
524
- 'Installation appeared to complete but Google Chrome was not found.\n\n' +
525
- 'Please try running: google-chrome-stable --version'
526
- );
527
- }
528
-
529
- const installedVersion = await getChromeVersionLinux();
530
- console.log(`Google Chrome ${installedVersion || ''} installed successfully.`);
531
- console.log('');
532
- console.log('NOTE: On EC2 instances, you may need to run Chrome with additional flags:');
533
- console.log(' google-chrome-stable --no-sandbox --headless');
534
- }
535
-
536
- /**
537
- * Install Google Chrome on Windows using Chocolatey or winget.
538
- *
539
- * Prerequisites:
540
- * - Windows 10 version 1809 or later, or Windows 11
541
- * - Administrator privileges
542
- * - Chocolatey or winget package manager installed
543
- *
544
- * This function prefers winget if available (built into modern Windows),
545
- * falling back to Chocolatey if winget is not present.
546
- *
547
- * @returns {Promise<void>}
548
- * @throws {Error} If no package manager is available or installation fails
549
- */
550
- async function install_windows() {
551
- console.log('Checking if Google Chrome is already installed...');
552
-
553
- // Check if Chrome is already installed
554
- if (isChromeInstalledWindows()) {
555
- const version = await getChromeVersionWindows();
556
- if (version) {
557
- console.log(`Google Chrome ${version} is already installed, skipping installation.`);
558
- } else {
559
- console.log('Google Chrome is already installed, skipping installation.');
560
- }
561
- return;
562
- }
563
-
564
- // Prefer winget if available (modern Windows includes it by default)
565
- if (winget.isInstalled()) {
566
- console.log('Installing Google Chrome via winget...');
567
-
568
- const result = await winget.install(WINGET_PACKAGE_ID, {
569
- silent: true,
570
- source: 'winget'
571
- });
572
-
573
- if (result.success) {
574
- console.log('Google Chrome installed successfully via winget.');
575
- console.log('');
576
- console.log('NOTE: Chrome is now available in your Start Menu.');
577
- console.log('You may need to open a new terminal to use it from the command line.');
578
- return;
579
- }
580
-
581
- // winget failed - check if it's a "already installed" scenario
582
- // winget returns non-zero even when the app is already installed
583
- if (result.output && result.output.includes('already installed')) {
584
- console.log('Google Chrome is already installed.');
585
- return;
586
- }
587
-
588
- // winget failed, log the error and try Chocolatey as fallback
589
- console.log('winget installation failed:');
590
- if (result.output) {
591
- console.log(result.output);
592
- }
593
- console.log('');
594
- console.log('Trying Chocolatey as fallback...');
595
- }
596
-
597
- // Try Chocolatey if available
598
- if (choco.isInstalled()) {
599
- console.log('Installing Google Chrome via Chocolatey...');
600
-
601
- const result = await choco.install(CHOCO_PACKAGE_NAME);
602
-
603
- if (!result.success) {
604
- throw new Error(
605
- `Failed to install Google Chrome via Chocolatey.\n` +
606
- `Output: ${result.output}\n\n` +
607
- `Troubleshooting:\n` +
608
- ` 1. Ensure you are running as Administrator\n` +
609
- ` 2. Try manual installation: choco install googlechrome -y --force`
610
- );
611
- }
612
-
613
- console.log('Google Chrome installed successfully via Chocolatey.');
614
- console.log('');
615
- console.log('NOTE: Chrome is now available in your Start Menu.');
616
- console.log('You may need to open a new terminal to use it from the command line.');
617
- return;
618
- }
619
-
620
- // Neither package manager is available
621
- throw new Error(
622
- 'Neither winget nor Chocolatey package manager is available.\n\n' +
623
- 'Please install one of the following:\n' +
624
- ' - winget: Included in Windows 10 (2004+) and Windows 11\n' +
625
- ' - Chocolatey: https://chocolatey.org/install\n\n' +
626
- 'After installing a package manager, retry: dev install google-chrome'
627
- );
628
- }
629
-
630
- /**
631
- * Install Google Chrome from Git Bash on Windows.
632
- *
633
- * Git Bash runs within Windows, so this function installs Google Chrome
634
- * on the Windows host using PowerShell interop with Chocolatey or winget.
635
- *
636
- * Prerequisites:
637
- * - Windows 10 or Windows 11
638
- * - Git Bash installed (comes with Git for Windows)
639
- * - Chocolatey or winget available on Windows
640
- *
641
- * @returns {Promise<void>}
642
- * @throws {Error} If installation fails
643
- */
644
- async function install_gitbash() {
645
- console.log('Detected Git Bash on Windows.');
646
- console.log('Installing Google Chrome on the Windows host...');
647
- console.log('');
648
-
649
- // Check if Chrome is already installed by checking the Windows path
650
- const fs = require('fs');
651
-
652
- // Git Bash path format uses forward slashes with drive letter prefix
653
- const windowsPath = '/c/Program Files/Google/Chrome/Application/chrome.exe';
654
- const exists = fs.existsSync(windowsPath);
655
-
656
- if (exists) {
657
- console.log('Google Chrome is already installed, skipping installation.');
658
- console.log('');
659
- console.log('To use Chrome from Git Bash:');
660
- console.log(' "/c/Program Files/Google/Chrome/Application/chrome.exe" --version');
661
- return;
662
- }
663
-
664
- // Try winget first via PowerShell
665
- console.log('Attempting installation via winget...');
666
- const wingetResult = await shell.exec(
667
- 'powershell.exe -NoProfile -Command "winget install --id Google.Chrome --silent --accept-package-agreements --accept-source-agreements"'
668
- );
669
-
670
- if (wingetResult.code === 0) {
671
- console.log('Google Chrome installed successfully via winget.');
672
- console.log('');
673
- console.log('To use Chrome from Git Bash:');
674
- console.log(' "/c/Program Files/Google/Chrome/Application/chrome.exe" --version');
675
- return;
676
- }
677
-
678
- // Fall back to Chocolatey
679
- console.log('winget installation failed, trying Chocolatey...');
680
- const chocoResult = await shell.exec(
681
- 'powershell.exe -NoProfile -Command "choco install googlechrome -y"'
682
- );
683
-
684
- if (chocoResult.code !== 0) {
685
- throw new Error(
686
- `Failed to install Google Chrome.\n` +
687
- `Output: ${chocoResult.stdout || chocoResult.stderr}\n\n` +
688
- `Troubleshooting:\n` +
689
- ` 1. Ensure winget or Chocolatey is installed on Windows\n` +
690
- ` 2. Run Git Bash as Administrator and retry\n` +
691
- ` 3. Try installing directly from PowerShell:\n` +
692
- ` winget install --id Google.Chrome --silent`
693
- );
694
- }
695
-
696
- console.log('Google Chrome installed successfully via Chocolatey.');
697
- console.log('');
698
- console.log('To use Chrome from Git Bash:');
699
- console.log(' "/c/Program Files/Google/Chrome/Application/chrome.exe" --version');
700
- }
701
-
702
- /**
703
- * Check if Google Chrome is currently installed on the system.
704
- *
705
- * This function checks for Google Chrome installation across all supported platforms:
706
- * - macOS: Checks for Google Chrome.app via Homebrew cask or application bundle
707
- * - Windows: Checks for Chrome.exe at standard installation paths
708
- * - Linux: Checks if google-chrome or google-chrome-stable command exists
709
- *
710
- * @returns {Promise<boolean>} True if Google Chrome is installed, false otherwise
711
- */
712
- async function isInstalled() {
713
- const platform = os.detect();
714
-
715
- if (platform.type === 'macos') {
716
- // Check if Google Chrome app bundle exists
717
- if (isChromeInstalledMacOS()) {
718
- return true;
719
- }
720
- // Also check via Homebrew cask
721
- return await brew.isCaskInstalled(HOMEBREW_CASK_NAME);
722
- }
723
-
724
- if (platform.type === 'windows' || platform.type === 'gitbash') {
725
- return isChromeInstalledWindows();
726
- }
727
-
728
- if (platform.type === 'raspbian') {
729
- // Chrome is not available for Raspberry Pi
730
- return false;
731
- }
732
-
733
- // Linux platforms: Check if google-chrome command exists
734
- return isChromeInstalledLinux();
735
- }
736
-
737
- /**
738
- * Check if this installer is supported on the current platform.
739
- *
740
- * Google Chrome is NOT supported on ARM-based platforms (Raspberry Pi)
741
- * and requires a desktop environment since it is a GUI application.
742
- *
743
- * @returns {boolean} True if installation is supported on this platform
744
- */
745
- function isEligible() {
746
- const platform = os.detect();
747
-
748
- // First check if the platform is supported
749
- // Chrome is NOT available for Raspberry Pi (ARM architecture)
750
- const supportedPlatforms = ['macos', 'ubuntu', 'debian', 'wsl', 'amazon_linux', 'rhel', 'fedora', 'windows', 'gitbash'];
751
- if (!supportedPlatforms.includes(platform.type)) {
752
- return false;
753
- }
754
-
755
- // This installer requires a desktop environment
756
- if (REQUIRES_DESKTOP && !os.isDesktopAvailable()) {
757
- return false;
758
- }
759
-
760
- return true;
761
- }
762
-
763
- /**
764
- * Main installation entry point.
765
- *
766
- * Detects the current platform using os.detect() and routes to the appropriate
767
- * platform-specific installer function. Handles platform aliases to ensure
768
- * all supported distributions use the correct installation method.
769
- *
770
- * Supported platforms:
771
- * - macOS: Google Chrome via Homebrew cask
772
- * - Ubuntu/Debian: Google Chrome via official .deb package
773
- * - Amazon Linux/RHEL: Google Chrome via official .rpm package
774
- * - Windows: Google Chrome via winget or Chocolatey
775
- * - WSL (Ubuntu): Google Chrome within WSL environment
776
- * - Git Bash: Google Chrome on Windows host
777
- *
778
- * Unsupported platforms:
779
- * - Raspberry Pi OS (ARM architecture not supported by Chrome)
780
- * - Any other ARM-based Linux distributions
781
- *
782
- * @returns {Promise<void>}
783
- */
784
- async function install() {
785
- const platform = os.detect();
786
-
787
- // Map platform types to their installer functions
788
- // This mapping handles aliases (e.g., debian uses the same installer as ubuntu)
789
- const installers = {
790
- 'macos': install_macos,
791
- 'ubuntu': install_ubuntu,
792
- 'debian': install_ubuntu,
793
- 'wsl': install_ubuntu_wsl,
794
- 'raspbian': install_raspbian,
795
- 'amazon_linux': install_amazon_linux,
796
- 'rhel': install_amazon_linux,
797
- 'fedora': install_amazon_linux,
798
- 'windows': install_windows,
799
- 'gitbash': install_gitbash
800
- };
801
-
802
- const installer = installers[platform.type];
803
-
804
- if (!installer) {
805
- console.log(`Google Chrome is not available for ${platform.type}.`);
806
- return;
807
- }
808
-
809
- await installer();
810
- }
811
-
812
- // Export all functions for use as a module and for testing
813
- module.exports = {
814
- REQUIRES_DESKTOP,
815
- install,
816
- isInstalled,
817
- isEligible,
818
- install_macos,
819
- install_ubuntu,
820
- install_ubuntu_wsl,
821
- install_raspbian,
822
- install_amazon_linux,
823
- install_windows,
824
- install_gitbash
825
- };
826
-
827
- // Allow direct execution: node google-chrome.js
828
- if (require.main === module) {
829
- install().catch(err => {
830
- console.error(err.message);
831
- process.exit(1);
832
- });
833
- }