@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,710 +0,0 @@
1
- #!/usr/bin/env node
2
-
3
- /**
4
- * @fileoverview Install Balena Etcher - a powerful OS image flasher for SD cards and USB drives.
5
- * @module installs/balena-etcher
6
- *
7
- * Balena Etcher is a GUI application that safely flashes OS images to SD cards and USB drives.
8
- * It validates writes to ensure data integrity and includes safeguards against accidental
9
- * overwrites of system drives.
10
- *
11
- * Supported platforms:
12
- * - macOS: Homebrew cask
13
- * - Ubuntu/Debian: Direct .deb download from GitHub
14
- * - Raspberry Pi OS: Pi-Apps (requires 64-bit)
15
- * - Amazon Linux/RHEL: Direct .rpm download from GitHub
16
- * - Windows: Chocolatey or winget
17
- * - WSL: Direct .deb download (requires WSLg for GUI)
18
- * - Git Bash: Uses Windows Chocolatey
19
- */
20
-
21
- const fs = require('fs');
22
- const path = require('path');
23
- const os = require('../utils/common/os');
24
- const shell = require('../utils/common/shell');
25
- const brew = require('../utils/macos/brew');
26
- const apt = require('../utils/ubuntu/apt');
27
- const choco = require('../utils/windows/choco');
28
- const winget = require('../utils/windows/winget');
29
- const macosApps = require('../utils/macos/apps');
30
-
31
- /**
32
- * Whether this installer requires a desktop environment to function.
33
- * Balena Etcher is a GUI application for flashing OS images.
34
- */
35
- const REQUIRES_DESKTOP = true;
36
-
37
- /**
38
- * The current version of Balena Etcher to install when downloading directly.
39
- * Update this value when a new version is released.
40
- */
41
- const ETCHER_VERSION = '2.1.4';
42
-
43
- /**
44
- * Download URLs for direct installation methods (non-package-manager installs).
45
- */
46
- const DOWNLOAD_URLS = {
47
- deb: `https://github.com/balena-io/etcher/releases/download/v${ETCHER_VERSION}/balena-etcher_${ETCHER_VERSION}_amd64.deb`,
48
- rpm: `https://github.com/balena-io/etcher/releases/download/v${ETCHER_VERSION}/balena-etcher-${ETCHER_VERSION}-1.x86_64.rpm`
49
- };
50
-
51
- /**
52
- * Checks if Balena Etcher is already installed on macOS by looking for the application bundle.
53
- * @returns {boolean} True if balenaEtcher.app exists in /Applications
54
- */
55
- function isInstalledOnMacOS() {
56
- return macosApps.isAppInstalled('balenaEtcher');
57
- }
58
-
59
- /**
60
- * Checks if Balena Etcher is already installed on Debian-based systems.
61
- * Uses dpkg to query the package database.
62
- * @returns {Promise<boolean>} True if the balena-etcher package is installed
63
- */
64
- async function isInstalledOnDebian() {
65
- return apt.isPackageInstalled('balena-etcher');
66
- }
67
-
68
- /**
69
- * Checks if Balena Etcher is already installed on RPM-based systems.
70
- * Uses rpm to query the package database.
71
- * @returns {Promise<boolean>} True if the balena-etcher package is installed
72
- */
73
- async function isInstalledOnRPM() {
74
- const result = await shell.exec('rpm -q balena-etcher 2>/dev/null');
75
- return result.code === 0;
76
- }
77
-
78
- /**
79
- * Checks if Balena Etcher is already installed on Windows.
80
- * Checks the standard installation directory.
81
- * @returns {Promise<boolean>} True if balenaEtcher.exe exists in Program Files
82
- */
83
- async function isInstalledOnWindows() {
84
- // Check common installation paths
85
- const result = await shell.exec('powershell -Command "Test-Path \'C:\\Program Files\\balenaEtcher\\balenaEtcher.exe\'"');
86
- return result.stdout.trim().toLowerCase() === 'true';
87
- }
88
-
89
- /**
90
- * Checks if Balena Etcher is installed on Raspberry Pi via Pi-Apps.
91
- * Looks for the balena-etcher-electron binary.
92
- * @returns {Promise<boolean>} True if the binary exists
93
- */
94
- async function isInstalledOnRaspbian() {
95
- // Pi-Apps installs to /usr/bin/balena-etcher-electron
96
- return shell.commandExists('balena-etcher-electron') || shell.commandExists('balena-etcher');
97
- }
98
-
99
- /**
100
- * Install Balena Etcher on macOS using Homebrew Cask.
101
- *
102
- * Prerequisites:
103
- * - macOS 10.15 (Catalina) or later
104
- * - Homebrew package manager installed
105
- *
106
- * @returns {Promise<void>}
107
- */
108
- async function install_macos() {
109
- // Check if Homebrew is available
110
- if (!brew.isInstalled()) {
111
- console.log('Homebrew is not installed. Please install Homebrew first:');
112
- console.log(' /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"');
113
- return;
114
- }
115
-
116
- // Check if already installed (idempotency check)
117
- if (isInstalledOnMacOS()) {
118
- console.log('Balena Etcher is already installed.');
119
- return;
120
- }
121
-
122
- console.log('Installing Balena Etcher via Homebrew Cask...');
123
-
124
- // Install using the brew cask command
125
- // Using --quiet to suppress non-essential output for cleaner automation
126
- const result = await brew.installCask('balenaetcher');
127
-
128
- if (!result.success) {
129
- console.error('Failed to install Balena Etcher:', result.output);
130
- return;
131
- }
132
-
133
- // Verify installation succeeded
134
- if (isInstalledOnMacOS()) {
135
- console.log('Balena Etcher installed successfully.');
136
- console.log('Location: /Applications/balenaEtcher.app');
137
- } else {
138
- console.error('Installation completed but Balena Etcher was not found in /Applications.');
139
- }
140
- }
141
-
142
- /**
143
- * Install Balena Etcher on Ubuntu/Debian using direct .deb download.
144
- *
145
- * The official APT repository is deprecated, so we download the .deb package
146
- * directly from GitHub releases.
147
- *
148
- * Prerequisites:
149
- * - Ubuntu 18.04+ or Debian 10+ (64-bit)
150
- * - sudo privileges
151
- * - wget installed
152
- *
153
- * @returns {Promise<void>}
154
- */
155
- async function install_ubuntu() {
156
- // Check architecture FIRST - Balena Etcher only provides AMD64 packages for Linux
157
- // This must be checked before attempting any installations
158
- const arch = os.getArch();
159
- if (arch !== 'x64') {
160
- console.log(`Balena Etcher does not provide official ${arch} packages for Ubuntu/Debian.`);
161
- console.log('');
162
- console.log('Note: Official Balena Etcher releases only support x64 (AMD64) architecture.');
163
- console.log('For ARM64 systems:');
164
- console.log(' - Raspberry Pi: Use Pi-Apps (community ARM build)');
165
- console.log(' - Other ARM64 Linux: Community builds available at:');
166
- console.log(' https://github.com/Itai-Nelken/BalenaEtcher-arm');
167
- console.log('');
168
- console.log('Alternatively, consider using Raspberry Pi Imager (official ARM support):');
169
- console.log(' sudo apt-get install -y rpi-imager');
170
- return;
171
- }
172
-
173
- // Check if already installed (idempotency check)
174
- const alreadyInstalled = await isInstalledOnDebian();
175
- if (alreadyInstalled) {
176
- console.log('Balena Etcher is already installed.');
177
- return;
178
- }
179
-
180
- // Ensure wget is available for downloading
181
- if (!shell.commandExists('wget')) {
182
- console.log('Installing wget (required for download)...');
183
- // Update package lists first
184
- await shell.exec('sudo DEBIAN_FRONTEND=noninteractive apt-get update -y');
185
- const wgetResult = await shell.exec('sudo DEBIAN_FRONTEND=noninteractive apt-get install -y wget');
186
- if (wgetResult.code !== 0) {
187
- console.error('Failed to install wget:', wgetResult.stderr);
188
- return;
189
- }
190
- }
191
-
192
- console.log('Downloading Balena Etcher .deb package...');
193
-
194
- // Download the .deb package to /tmp
195
- const downloadResult = await shell.exec(
196
- `wget -q -O /tmp/balena-etcher.deb "${DOWNLOAD_URLS.deb}"`
197
- );
198
-
199
- if (downloadResult.code !== 0) {
200
- console.error('Failed to download Balena Etcher:', downloadResult.stderr);
201
- return;
202
- }
203
-
204
- console.log('Installing Balena Etcher...');
205
-
206
- // Update package lists first to ensure dependencies can be resolved
207
- // This is important for fresh systems where package lists may be stale
208
- await shell.exec('sudo DEBIAN_FRONTEND=noninteractive apt-get update -y');
209
-
210
- // Install the .deb package using apt-get
211
- // DEBIAN_FRONTEND=noninteractive ensures no interactive prompts
212
- const installResult = await shell.exec(
213
- 'sudo DEBIAN_FRONTEND=noninteractive apt-get install -y /tmp/balena-etcher.deb'
214
- );
215
-
216
- // Clean up the downloaded file regardless of installation outcome
217
- await shell.exec('rm -f /tmp/balena-etcher.deb');
218
-
219
- if (installResult.code !== 0) {
220
- console.error('Failed to install Balena Etcher:', installResult.stderr);
221
- // Attempt to fix broken dependencies
222
- console.log('Attempting to fix broken dependencies...');
223
- await shell.exec('sudo DEBIAN_FRONTEND=noninteractive apt-get install -f -y');
224
- return;
225
- }
226
-
227
- // Verify installation succeeded
228
- const verifyInstalled = await isInstalledOnDebian();
229
- if (verifyInstalled) {
230
- console.log('Balena Etcher installed successfully.');
231
- console.log('Launch with: balena-etcher');
232
- } else {
233
- console.error('Installation completed but Balena Etcher package was not found.');
234
- }
235
- }
236
-
237
- /**
238
- * Install Balena Etcher on Raspberry Pi OS using Pi-Apps.
239
- *
240
- * IMPORTANT: Balena Etcher does NOT have an official ARM installer.
241
- * Pi-Apps provides a community-compiled ARM64 version.
242
- *
243
- * Prerequisites:
244
- * - Raspberry Pi OS (64-bit only - aarch64)
245
- * - Raspberry Pi 3, 4, or 5
246
- * - Desktop environment
247
- *
248
- * @returns {Promise<void>}
249
- */
250
- async function install_raspbian() {
251
- // Check if already installed (idempotency check)
252
- const alreadyInstalled = await isInstalledOnRaspbian();
253
- if (alreadyInstalled) {
254
- console.log('Balena Etcher is already installed.');
255
- return;
256
- }
257
-
258
- // Verify we are running on 64-bit Raspberry Pi OS
259
- // Balena Etcher ARM builds only support aarch64
260
- const archResult = await shell.exec('uname -m');
261
- const architecture = archResult.stdout.trim();
262
-
263
- if (architecture !== 'aarch64') {
264
- console.log('Balena Etcher requires 64-bit Raspberry Pi OS (aarch64).');
265
- console.log(`Current architecture: ${architecture}`);
266
- console.log('Please install 64-bit Raspberry Pi OS from:');
267
- console.log(' https://www.raspberrypi.com/software/operating-systems/');
268
- return;
269
- }
270
-
271
- // Check if Pi-Apps is already installed
272
- const homeDir = os.getHomeDir();
273
- const piAppsPath = path.join(homeDir, 'pi-apps', 'manage');
274
- const piAppsInstalled = fs.existsSync(piAppsPath);
275
-
276
- if (!piAppsInstalled) {
277
- console.log('Installing Pi-Apps (required for Balena Etcher on Raspberry Pi)...');
278
-
279
- // Install Pi-Apps from the official repository
280
- const piAppsResult = await shell.exec(
281
- 'wget -qO- https://raw.githubusercontent.com/Botspot/pi-apps/master/install | bash'
282
- );
283
-
284
- if (piAppsResult.code !== 0) {
285
- console.error('Failed to install Pi-Apps:', piAppsResult.stderr);
286
- console.log('You may need to install required dependencies first:');
287
- console.log(' sudo apt-get update && sudo apt-get install -y yad curl wget');
288
- return;
289
- }
290
- }
291
-
292
- console.log('Installing Balena Etcher via Pi-Apps...');
293
-
294
- // Install Balena Etcher using Pi-Apps CLI
295
- // Note: The app name in Pi-Apps is 'BalenaEtcher' (case-sensitive)
296
- const installResult = await shell.exec(
297
- `"${piAppsPath}" install 'BalenaEtcher'`
298
- );
299
-
300
- if (installResult.code !== 0) {
301
- console.error('Failed to install Balena Etcher via Pi-Apps:', installResult.stderr);
302
- return;
303
- }
304
-
305
- // Verify installation succeeded
306
- const verifyInstalled = await isInstalledOnRaspbian();
307
- if (verifyInstalled) {
308
- console.log('Balena Etcher installed successfully.');
309
- console.log('Launch with: balena-etcher-electron');
310
- } else {
311
- console.error('Installation completed but Balena Etcher was not found.');
312
- }
313
- }
314
-
315
- /**
316
- * Install Balena Etcher on Amazon Linux/RHEL using direct .rpm download.
317
- *
318
- * Prerequisites:
319
- * - Amazon Linux 2023, Amazon Linux 2, RHEL 8+, or Fedora 35+
320
- * - 64-bit (x86_64) architecture
321
- * - sudo privileges
322
- * - Desktop environment (for GUI operation)
323
- *
324
- * @returns {Promise<void>}
325
- */
326
- async function install_amazon_linux() {
327
- // Check architecture FIRST - Balena Etcher only provides x86_64 packages for Linux
328
- // This must be checked before attempting any installations
329
- const arch = os.getArch();
330
- if (arch !== 'x64') {
331
- console.log(`Balena Etcher does not provide official ${arch} packages for RHEL/Fedora/Amazon Linux.`);
332
- console.log('');
333
- console.log('Note: Official Balena Etcher releases only support x64 (x86_64) architecture.');
334
- console.log('For ARM64 systems, community builds may be available at:');
335
- console.log(' https://github.com/Itai-Nelken/BalenaEtcher-arm');
336
- console.log('');
337
- console.log('Alternatively, consider using other image writing tools with ARM support.');
338
- return;
339
- }
340
-
341
- // Check if already installed (idempotency check)
342
- const alreadyInstalled = await isInstalledOnRPM();
343
- if (alreadyInstalled) {
344
- console.log('Balena Etcher is already installed.');
345
- return;
346
- }
347
-
348
- // Ensure wget is available for downloading
349
- if (!shell.commandExists('wget')) {
350
- console.log('Installing wget (required for download)...');
351
- // Detect whether to use dnf or yum
352
- const packageManager = shell.commandExists('dnf') ? 'dnf' : 'yum';
353
- const wgetResult = await shell.exec(`sudo ${packageManager} install -y wget`);
354
- if (wgetResult.code !== 0) {
355
- console.error('Failed to install wget:', wgetResult.stderr);
356
- return;
357
- }
358
- }
359
-
360
- console.log('Downloading Balena Etcher .rpm package...');
361
-
362
- // Download the .rpm package to /tmp
363
- const downloadResult = await shell.exec(
364
- `wget -q -O /tmp/balena-etcher.rpm "${DOWNLOAD_URLS.rpm}"`
365
- );
366
-
367
- if (downloadResult.code !== 0) {
368
- console.error('Failed to download Balena Etcher:', downloadResult.stderr);
369
- return;
370
- }
371
-
372
- console.log('Installing Balena Etcher...');
373
-
374
- // Determine which package manager to use (dnf preferred over yum)
375
- const packageManager = shell.commandExists('dnf') ? 'dnf' : 'yum';
376
-
377
- // Install the .rpm package
378
- const installResult = await shell.exec(
379
- `sudo ${packageManager} install -y /tmp/balena-etcher.rpm`
380
- );
381
-
382
- // Clean up the downloaded file regardless of installation outcome
383
- await shell.exec('rm -f /tmp/balena-etcher.rpm');
384
-
385
- if (installResult.code !== 0) {
386
- console.error('Failed to install Balena Etcher:', installResult.stderr);
387
- console.log('You may need to install missing dependencies:');
388
- console.log(' sudo dnf install -y libXScrnSaver gtk3 nss alsa-lib');
389
- return;
390
- }
391
-
392
- // Verify installation succeeded
393
- const verifyInstalled = await isInstalledOnRPM();
394
- if (verifyInstalled) {
395
- console.log('Balena Etcher installed successfully.');
396
- console.log('Launch with: balena-etcher');
397
- } else {
398
- console.error('Installation completed but Balena Etcher package was not found.');
399
- }
400
- }
401
-
402
- /**
403
- * Install Balena Etcher on Windows using Chocolatey or winget.
404
- *
405
- * Prefers winget if available, falls back to Chocolatey.
406
- *
407
- * Prerequisites:
408
- * - Windows 10 or Windows 11 (64-bit)
409
- * - Chocolatey or winget package manager
410
- * - Administrator privileges
411
- *
412
- * @returns {Promise<void>}
413
- */
414
- async function install_windows() {
415
- // Check if already installed (idempotency check)
416
- const alreadyInstalled = await isInstalledOnWindows();
417
- if (alreadyInstalled) {
418
- console.log('Balena Etcher is already installed.');
419
- return;
420
- }
421
-
422
- // Try winget first (preferred on modern Windows)
423
- if (winget.isInstalled()) {
424
- console.log('Installing Balena Etcher via winget...');
425
-
426
- const result = await winget.install('Balena.Etcher');
427
-
428
- if (result.success) {
429
- // Verify installation succeeded
430
- const verifyInstalled = await isInstalledOnWindows();
431
- if (verifyInstalled) {
432
- console.log('Balena Etcher installed successfully.');
433
- console.log('Location: C:\\Program Files\\balenaEtcher\\balenaEtcher.exe');
434
- return;
435
- }
436
- }
437
-
438
- // If winget failed, fall through to try Chocolatey
439
- console.log('winget installation was not successful, trying Chocolatey...');
440
- }
441
-
442
- // Fall back to Chocolatey
443
- if (choco.isInstalled()) {
444
- console.log('Installing Balena Etcher via Chocolatey...');
445
-
446
- // Chocolatey package name is 'etcher'
447
- const result = await choco.install('etcher');
448
-
449
- if (!result.success) {
450
- console.error('Failed to install Balena Etcher:', result.output);
451
- return;
452
- }
453
-
454
- // Verify installation succeeded
455
- const verifyInstalled = await isInstalledOnWindows();
456
- if (verifyInstalled) {
457
- console.log('Balena Etcher installed successfully.');
458
- console.log('Location: C:\\Program Files\\balenaEtcher\\balenaEtcher.exe');
459
- } else {
460
- console.error('Installation completed but Balena Etcher was not found.');
461
- }
462
- return;
463
- }
464
-
465
- // Neither package manager is available
466
- console.log('Neither winget nor Chocolatey is installed.');
467
- console.log('Please install one of them first:');
468
- console.log('');
469
- console.log('For Chocolatey (PowerShell as Administrator):');
470
- console.log(' Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString(\'https://community.chocolatey.org/install.ps1\'))');
471
- }
472
-
473
- /**
474
- * Install Balena Etcher on Ubuntu running in WSL (Windows Subsystem for Linux).
475
- *
476
- * Uses the same installation method as Ubuntu, but notes that WSLg is required
477
- * for GUI support and that USB device access is limited in WSL.
478
- *
479
- * Prerequisites:
480
- * - WSL 2 with Ubuntu
481
- * - Windows 11 or Windows 10 with WSLg enabled
482
- * - sudo privileges
483
- *
484
- * @returns {Promise<void>}
485
- */
486
- async function install_ubuntu_wsl() {
487
- // Check architecture FIRST - Balena Etcher only provides AMD64 packages for Linux
488
- // This must be checked before attempting any installations
489
- const arch = os.getArch();
490
- if (arch !== 'x64') {
491
- console.log(`Balena Etcher does not provide official ${arch} packages for WSL.`);
492
- console.log('');
493
- console.log('Note: Official Balena Etcher releases only support x64 (AMD64) architecture.');
494
- console.log('For ARM64 WSL, consider installing Balena Etcher on Windows directly instead.');
495
- return;
496
- }
497
-
498
- // Check if already installed (idempotency check)
499
- const alreadyInstalled = await isInstalledOnDebian();
500
- if (alreadyInstalled) {
501
- console.log('Balena Etcher is already installed.');
502
- return;
503
- }
504
-
505
- // WSL-specific note about USB limitations
506
- console.log('Note: Balena Etcher in WSL has limited USB device access.');
507
- console.log('For full USB support, consider installing on Windows directly.');
508
- console.log('');
509
-
510
- // Ensure wget is available for downloading
511
- if (!shell.commandExists('wget')) {
512
- console.log('Installing wget (required for download)...');
513
- // Update apt cache first for WSL
514
- await shell.exec('sudo DEBIAN_FRONTEND=noninteractive apt-get update -y');
515
- const wgetResult = await shell.exec('sudo DEBIAN_FRONTEND=noninteractive apt-get install -y wget');
516
- if (wgetResult.code !== 0) {
517
- console.error('Failed to install wget:', wgetResult.stderr);
518
- return;
519
- }
520
- }
521
-
522
- console.log('Downloading Balena Etcher .deb package...');
523
-
524
- // Download the .deb package to /tmp
525
- const downloadResult = await shell.exec(
526
- `wget -q -O /tmp/balena-etcher.deb "${DOWNLOAD_URLS.deb}"`
527
- );
528
-
529
- if (downloadResult.code !== 0) {
530
- console.error('Failed to download Balena Etcher:', downloadResult.stderr);
531
- return;
532
- }
533
-
534
- console.log('Installing Balena Etcher...');
535
-
536
- // Update package list first (important for fresh WSL instances)
537
- await shell.exec('sudo DEBIAN_FRONTEND=noninteractive apt-get update -y');
538
-
539
- // Install the .deb package using apt-get
540
- const installResult = await shell.exec(
541
- 'sudo DEBIAN_FRONTEND=noninteractive apt-get install -y /tmp/balena-etcher.deb'
542
- );
543
-
544
- // Clean up the downloaded file regardless of installation outcome
545
- await shell.exec('rm -f /tmp/balena-etcher.deb');
546
-
547
- if (installResult.code !== 0) {
548
- console.error('Failed to install Balena Etcher:', installResult.stderr);
549
- // Attempt to fix broken dependencies
550
- console.log('Attempting to fix broken dependencies...');
551
- await shell.exec('sudo DEBIAN_FRONTEND=noninteractive apt-get install -f -y');
552
- return;
553
- }
554
-
555
- // Verify installation succeeded
556
- const verifyInstalled = await isInstalledOnDebian();
557
- if (verifyInstalled) {
558
- console.log('Balena Etcher installed successfully.');
559
- console.log('Launch with: balena-etcher');
560
- console.log('');
561
- console.log('Note: Requires WSLg for GUI support. If you encounter display errors:');
562
- console.log(' 1. Ensure you are using WSL 2');
563
- console.log(' 2. Run: wsl --update (in PowerShell)');
564
- console.log(' 3. Restart WSL: wsl --shutdown && wsl');
565
- } else {
566
- console.error('Installation completed but Balena Etcher package was not found.');
567
- }
568
- }
569
-
570
- /**
571
- * Install Balena Etcher from Git Bash on Windows.
572
- *
573
- * Git Bash runs on Windows, so this function delegates to the Windows
574
- * installation method using Chocolatey.
575
- *
576
- * Prerequisites:
577
- * - Git Bash installed (comes with Git for Windows)
578
- * - Chocolatey installed on Windows
579
- * - Administrator privileges
580
- *
581
- * @returns {Promise<void>}
582
- */
583
- async function install_gitbash() {
584
- // Git Bash runs on Windows and can access Windows package managers
585
- // Delegate to Windows installation
586
- console.log('Installing Balena Etcher for Windows from Git Bash...');
587
- await install_windows();
588
- }
589
-
590
- /**
591
- * Check if Balena Etcher is installed on the current platform.
592
- *
593
- * Uses platform-appropriate verification:
594
- * - macOS: Checks for application bundle in /Applications
595
- * - Ubuntu/Debian/WSL: Checks dpkg package database
596
- * - Raspberry Pi OS: Checks for balena-etcher-electron command
597
- * - Amazon Linux/RHEL/Fedora: Checks rpm package database
598
- * - Windows: Checks for executable in Program Files
599
- *
600
- * @returns {Promise<boolean>} True if Balena Etcher is installed
601
- */
602
- async function isInstalled() {
603
- const platform = os.detect();
604
-
605
- const checks = {
606
- 'macos': isInstalledOnMacOS,
607
- 'ubuntu': isInstalledOnDebian,
608
- 'debian': isInstalledOnDebian,
609
- 'wsl': isInstalledOnDebian,
610
- 'raspbian': isInstalledOnRaspbian,
611
- 'amazon_linux': isInstalledOnRPM,
612
- 'fedora': isInstalledOnRPM,
613
- 'rhel': isInstalledOnRPM,
614
- 'windows': isInstalledOnWindows,
615
- 'gitbash': isInstalledOnWindows,
616
- };
617
-
618
- const checker = checks[platform.type];
619
- if (!checker) {
620
- return false;
621
- }
622
-
623
- // Handle both sync and async checkers
624
- const result = checker();
625
- return result instanceof Promise ? await result : result;
626
- }
627
-
628
- /**
629
- * Check if this installer is supported on the current platform.
630
- *
631
- * Balena Etcher can be installed on all supported platforms:
632
- * - macOS (via Homebrew cask)
633
- * - Ubuntu/Debian (via direct .deb download)
634
- * - Raspberry Pi OS (via Pi-Apps, 64-bit only)
635
- * - Amazon Linux/RHEL/Fedora (via direct .rpm download)
636
- * - Windows (via Chocolatey or winget)
637
- * - WSL (via direct .deb download)
638
- * - Git Bash (via Windows Chocolatey)
639
- *
640
- * @returns {boolean} True if installation is supported on this platform
641
- */
642
- function isEligible() {
643
- const platform = os.detect();
644
- const supportedPlatforms = ['macos', 'ubuntu', 'debian', 'wsl', 'raspbian', 'amazon_linux', 'fedora', 'rhel', 'windows', 'gitbash'];
645
- if (!supportedPlatforms.includes(platform.type)) {
646
- return false;
647
- }
648
- if (REQUIRES_DESKTOP && !os.isDesktopAvailable()) {
649
- return false;
650
- }
651
- return true;
652
- }
653
-
654
- /**
655
- * Main installation entry point - detects platform and runs appropriate installer.
656
- *
657
- * This function automatically determines the current operating system and
658
- * invokes the correct platform-specific installation function.
659
- *
660
- * @returns {Promise<void>}
661
- */
662
- async function install() {
663
- const platform = os.detect();
664
-
665
- // Map platform types to their respective installer functions
666
- const installers = {
667
- 'macos': install_macos,
668
- 'ubuntu': install_ubuntu,
669
- 'debian': install_ubuntu,
670
- 'wsl': install_ubuntu_wsl,
671
- 'raspbian': install_raspbian,
672
- 'amazon_linux': install_amazon_linux,
673
- 'fedora': install_amazon_linux,
674
- 'rhel': install_amazon_linux,
675
- 'windows': install_windows,
676
- 'gitbash': install_gitbash
677
- };
678
-
679
- const installer = installers[platform.type];
680
-
681
- // Handle unsupported platforms gracefully (no errors, no alternatives)
682
- if (!installer) {
683
- console.log(`Balena Etcher is not available for ${platform.type}.`);
684
- return;
685
- }
686
-
687
- await installer();
688
- }
689
-
690
- module.exports = {
691
- REQUIRES_DESKTOP,
692
- install,
693
- isEligible,
694
- isInstalled,
695
- install_macos,
696
- install_ubuntu,
697
- install_ubuntu_wsl,
698
- install_raspbian,
699
- install_amazon_linux,
700
- install_windows,
701
- install_gitbash
702
- };
703
-
704
- // Allow direct execution of this script
705
- if (require.main === module) {
706
- install().catch(err => {
707
- console.error(err.message);
708
- process.exit(1);
709
- });
710
- }