@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,801 +0,0 @@
1
- #!/usr/bin/env node
2
-
3
- /**
4
- * @fileoverview Install Microsoft Teams.
5
- * @module installs/microsoft-teams
6
- *
7
- * Microsoft Teams is a collaboration and communication platform developed by Microsoft.
8
- * It provides chat, video meetings, file storage, and application integration for teams
9
- * and organizations.
10
- *
11
- * IMPORTANT PLATFORM NOTES:
12
- * - macOS: Installs Microsoft Teams via Homebrew cask (native client)
13
- * - Windows: Installs Microsoft Teams via Chocolatey (native client)
14
- * - Ubuntu/Debian: Installs unofficial "Teams for Linux" via APT repository (Electron wrapper)
15
- * - Raspberry Pi OS: Installs "Teams for Linux" via Snap (ARM support)
16
- * - Amazon Linux/RHEL: Installs "Teams for Linux" via RPM repository
17
- * - WSL: Installs on Windows host via Chocolatey (accessed from WSL)
18
- * - Git Bash: Installs on Windows host via Chocolatey
19
- *
20
- * NOTE: Microsoft discontinued native Linux desktop applications for Teams at the end of 2022.
21
- * Linux platforms use the unofficial "Teams for Linux" Electron-based client which wraps
22
- * the Teams web application.
23
- */
24
-
25
- const os = require('../utils/common/os');
26
- const shell = require('../utils/common/shell');
27
- const brew = require('../utils/macos/brew');
28
- const snap = require('../utils/ubuntu/snap');
29
- const choco = require('../utils/windows/choco');
30
- const fs = require('fs');
31
-
32
- /**
33
- * Indicates whether this installer requires a desktop environment.
34
- * Microsoft Teams is a GUI collaboration application and requires a display.
35
- * @type {boolean}
36
- */
37
- const REQUIRES_DESKTOP = true;
38
-
39
- /**
40
- * The Homebrew cask name for Microsoft Teams on macOS.
41
- */
42
- const HOMEBREW_CASK_NAME = 'microsoft-teams';
43
-
44
- /**
45
- * The Chocolatey package name for Microsoft Teams on Windows.
46
- * Uses the new Teams client bootstrapper which downloads the latest MSIX package.
47
- */
48
- const CHOCO_PACKAGE_NAME = 'microsoft-teams-new-bootstrapper';
49
-
50
- /**
51
- * The Snap package name for Teams for Linux.
52
- * This is an unofficial Electron wrapper that supports ARM architectures.
53
- */
54
- const SNAP_PACKAGE_NAME = 'teams-for-linux';
55
-
56
- /**
57
- * The APT package name for Teams for Linux.
58
- * This is installed from the unofficial teamsforlinux.de repository.
59
- */
60
- const APT_PACKAGE_NAME = 'teams-for-linux';
61
-
62
- /**
63
- * Check if Microsoft Teams is installed on macOS.
64
- *
65
- * Looks for the Microsoft Teams.app in the Applications folder.
66
- * This is the standard installation location for the Homebrew cask.
67
- *
68
- * @returns {boolean} True if Teams is installed, false otherwise
69
- */
70
- function isTeamsInstalledMacOS() {
71
- try {
72
- return fs.existsSync('/Applications/Microsoft Teams.app');
73
- } catch {
74
- return false;
75
- }
76
- }
77
-
78
- /**
79
- * Check if Teams for Linux command is available.
80
- *
81
- * Checks if the teams-for-linux command exists in PATH, which works
82
- * for both APT and Snap installations.
83
- *
84
- * @returns {boolean} True if teams-for-linux command exists, false otherwise
85
- */
86
- function isTeamsForLinuxInstalled() {
87
- return shell.commandExists('teams-for-linux');
88
- }
89
-
90
- /**
91
- * Set up the Teams for Linux APT repository on Ubuntu/Debian.
92
- *
93
- * This function:
94
- * 1. Creates the keyrings directory
95
- * 2. Downloads and installs the Teams for Linux GPG key
96
- * 3. Adds the Teams for Linux APT repository to sources
97
- * 4. Updates the package cache
98
- *
99
- * @returns {Promise<void>}
100
- * @throws {Error} If any step fails
101
- */
102
- async function setupTeamsForLinuxAptRepository() {
103
- console.log('Setting up Teams for Linux APT repository...');
104
-
105
- // Ensure prerequisites are installed (wget, ca-certificates)
106
- console.log('Installing prerequisites (wget, ca-certificates)...');
107
- const prereqResult = await shell.exec(
108
- 'sudo DEBIAN_FRONTEND=noninteractive apt-get update -y && ' +
109
- 'sudo DEBIAN_FRONTEND=noninteractive apt-get install -y wget ca-certificates'
110
- );
111
- if (prereqResult.code !== 0) {
112
- throw new Error(`Failed to install prerequisites: ${prereqResult.stderr}`);
113
- }
114
-
115
- // Create keyrings directory
116
- console.log('Setting up GPG keyring...');
117
- const keyringResult = await shell.exec('sudo mkdir -p /etc/apt/keyrings');
118
- if (keyringResult.code !== 0) {
119
- throw new Error(`Failed to create keyring directory: ${keyringResult.stderr}`);
120
- }
121
-
122
- // Download and install the GPG key
123
- const gpgResult = await shell.exec(
124
- 'sudo wget -qO /etc/apt/keyrings/teams-for-linux.asc https://repo.teamsforlinux.de/teams-for-linux.asc'
125
- );
126
- if (gpgResult.code !== 0) {
127
- throw new Error(`Failed to add Teams for Linux GPG key: ${gpgResult.stderr}`);
128
- }
129
-
130
- // Add the repository source using the modern DEB822 format
131
- console.log('Adding Teams for Linux repository...');
132
- const repoContent = `Types: deb
133
- URIs: https://repo.teamsforlinux.de/debian/
134
- Suites: stable
135
- Components: main
136
- Signed-By: /etc/apt/keyrings/teams-for-linux.asc
137
- Architectures: amd64`;
138
-
139
- const repoResult = await shell.exec(
140
- `echo "${repoContent}" | sudo tee /etc/apt/sources.list.d/teams-for-linux-packages.sources > /dev/null`
141
- );
142
- if (repoResult.code !== 0) {
143
- throw new Error(`Failed to add Teams for Linux repository: ${repoResult.stderr}`);
144
- }
145
-
146
- // Update package cache
147
- console.log('Updating package cache...');
148
- const updateResult = await shell.exec('sudo DEBIAN_FRONTEND=noninteractive apt-get update -y');
149
- if (updateResult.code !== 0) {
150
- throw new Error(`Failed to update package cache: ${updateResult.stderr}`);
151
- }
152
- }
153
-
154
- /**
155
- * Set up the Teams for Linux RPM repository on Amazon Linux/RHEL/Fedora.
156
- *
157
- * This function:
158
- * 1. Downloads and imports the GPG key
159
- * 2. Adds the Teams for Linux RPM repository
160
- *
161
- * @returns {Promise<void>}
162
- * @throws {Error} If any step fails
163
- */
164
- async function setupTeamsForLinuxRpmRepository() {
165
- console.log('Setting up Teams for Linux RPM repository...');
166
-
167
- // Download and import the GPG key
168
- console.log('Importing GPG key...');
169
- const gpgDownloadResult = await shell.exec(
170
- 'curl -1sLf -o /tmp/teams-for-linux.asc https://repo.teamsforlinux.de/teams-for-linux.asc'
171
- );
172
- if (gpgDownloadResult.code !== 0) {
173
- throw new Error(`Failed to download GPG key: ${gpgDownloadResult.stderr}`);
174
- }
175
-
176
- const gpgImportResult = await shell.exec('sudo rpm --import /tmp/teams-for-linux.asc');
177
- if (gpgImportResult.code !== 0) {
178
- throw new Error(`Failed to import GPG key: ${gpgImportResult.stderr}`);
179
- }
180
-
181
- // Add the repository
182
- console.log('Adding Teams for Linux repository...');
183
- const repoResult = await shell.exec(
184
- 'sudo curl -1sLf -o /etc/yum.repos.d/teams-for-linux.repo https://repo.teamsforlinux.de/rpm/teams-for-linux.repo'
185
- );
186
- if (repoResult.code !== 0) {
187
- throw new Error(`Failed to add Teams for Linux repository: ${repoResult.stderr}`);
188
- }
189
- }
190
-
191
- /**
192
- * Install Microsoft Teams on macOS using Homebrew.
193
- *
194
- * Prerequisites:
195
- * - macOS 11 (Big Sur) or later
196
- * - Homebrew package manager installed
197
- * - At least 2 GB free disk space
198
- * - Apple Silicon (M1/M2/M3/M4) or Intel processor
199
- *
200
- * The installation uses the Homebrew cask 'microsoft-teams' which downloads
201
- * and installs Microsoft Teams to /Applications/Microsoft Teams.app.
202
- *
203
- * @returns {Promise<void>}
204
- * @throws {Error} If Homebrew is not installed or installation fails
205
- */
206
- async function install_macos() {
207
- console.log('Checking if Microsoft Teams is already installed...');
208
-
209
- // Check if Teams is already installed via the app bundle
210
- if (isTeamsInstalledMacOS()) {
211
- console.log('Microsoft Teams is already installed, skipping installation.');
212
- return;
213
- }
214
-
215
- // Also check if the cask is installed
216
- const caskInstalled = await brew.isCaskInstalled(HOMEBREW_CASK_NAME);
217
- if (caskInstalled) {
218
- console.log('Microsoft Teams is already installed via Homebrew, skipping installation.');
219
- return;
220
- }
221
-
222
- // Verify Homebrew is available
223
- if (!brew.isInstalled()) {
224
- throw new Error(
225
- 'Homebrew is not installed. Please install Homebrew first using:\n' +
226
- ' dev install homebrew\n' +
227
- 'Then retry installing Microsoft Teams.'
228
- );
229
- }
230
-
231
- console.log('Installing Microsoft Teams via Homebrew...');
232
-
233
- // Install Microsoft Teams cask
234
- const result = await brew.installCask(HOMEBREW_CASK_NAME);
235
-
236
- if (!result.success) {
237
- throw new Error(
238
- `Failed to install Microsoft Teams via Homebrew.\n` +
239
- `Output: ${result.output}\n\n` +
240
- `Troubleshooting:\n` +
241
- ` 1. Run 'brew update && brew cleanup' and retry\n` +
242
- ` 2. If on Apple Silicon, ensure you have Rosetta 2: softwareupdate --install-rosetta\n` +
243
- ` 3. Try manual installation: brew reinstall --cask microsoft-teams`
244
- );
245
- }
246
-
247
- console.log('Microsoft Teams installed successfully.');
248
- console.log('');
249
- console.log('To launch Microsoft Teams:');
250
- console.log(' - Open from Applications folder, or');
251
- console.log(' - Run: open -a "Microsoft Teams"');
252
- console.log('');
253
- console.log('On first launch, sign in with your Microsoft account (personal, work, or school).');
254
- }
255
-
256
- /**
257
- * Install Teams for Linux on Ubuntu/Debian using APT.
258
- *
259
- * Prerequisites:
260
- * - Ubuntu 20.04, 22.04, 24.04 or later, or Debian 11, 12 or later (64-bit)
261
- * - sudo privileges
262
- * - At least 1 GB free disk space
263
- *
264
- * NOTE: Microsoft discontinued native Linux support. This installs the unofficial
265
- * "Teams for Linux" Electron-based client from https://github.com/IsmaelMartinez/teams-for-linux
266
- *
267
- * @returns {Promise<void>}
268
- * @throws {Error} If installation fails
269
- */
270
- async function install_ubuntu() {
271
- console.log('Checking if Teams for Linux is already installed...');
272
-
273
- // Check if already installed
274
- if (isTeamsForLinuxInstalled()) {
275
- console.log('Teams for Linux is already installed, skipping installation.');
276
- return;
277
- }
278
-
279
- // Also check via Snap as a fallback
280
- const snapInstalled = await snap.isSnapInstalled(SNAP_PACKAGE_NAME);
281
- if (snapInstalled) {
282
- console.log('Teams for Linux is already installed via Snap, skipping installation.');
283
- return;
284
- }
285
-
286
- console.log('');
287
- console.log('NOTE: Microsoft discontinued native Linux support for Teams.');
288
- console.log('Installing the unofficial "Teams for Linux" client (Electron wrapper).');
289
- console.log('');
290
-
291
- // Set up the APT repository
292
- await setupTeamsForLinuxAptRepository();
293
-
294
- // Install Teams for Linux
295
- console.log('Installing Teams for Linux...');
296
- const installResult = await shell.exec(
297
- `sudo DEBIAN_FRONTEND=noninteractive apt-get install -y ${APT_PACKAGE_NAME}`
298
- );
299
-
300
- if (installResult.code !== 0) {
301
- throw new Error(
302
- `Failed to install Teams for Linux.\n` +
303
- `Output: ${installResult.stderr}\n\n` +
304
- `Troubleshooting:\n` +
305
- ` 1. Run 'sudo apt-get update' and retry\n` +
306
- ` 2. Verify the repository was added: cat /etc/apt/sources.list.d/teams-for-linux-packages.sources\n` +
307
- ` 3. Alternative: Try installing via Snap: sudo snap install teams-for-linux`
308
- );
309
- }
310
-
311
- // Verify installation
312
- if (!isTeamsForLinuxInstalled()) {
313
- throw new Error(
314
- 'Installation appeared to complete but Teams for Linux was not found.\n\n' +
315
- 'Please try:\n' +
316
- ' 1. Restart your terminal session\n' +
317
- ' 2. Run: teams-for-linux --version'
318
- );
319
- }
320
-
321
- console.log('Teams for Linux installed successfully.');
322
- console.log('');
323
- console.log('To launch Teams for Linux:');
324
- console.log(' - Run: teams-for-linux');
325
- console.log(' - Or launch from your application menu');
326
- console.log('');
327
- console.log('NOTE: Some features like screen sharing may have limitations on Linux.');
328
- }
329
-
330
- /**
331
- * Install Teams for Linux on Raspberry Pi OS using Snap.
332
- *
333
- * Prerequisites:
334
- * - Raspberry Pi OS (64-bit recommended) - Bookworm or Bullseye
335
- * - Raspberry Pi 3B+ or later (arm64 or armhf architecture)
336
- * - At least 2 GB RAM (4 GB recommended for video calls)
337
- * - sudo privileges
338
- * - snapd installed
339
- *
340
- * NOTE: The APT repository only provides amd64 packages. Snap is required for ARM.
341
- *
342
- * @returns {Promise<void>}
343
- * @throws {Error} If installation fails
344
- */
345
- async function install_raspbian() {
346
- console.log('Checking if Teams for Linux is already installed...');
347
-
348
- // Check if already installed via Snap
349
- const snapInstalled = await snap.isSnapInstalled(SNAP_PACKAGE_NAME);
350
- if (snapInstalled) {
351
- console.log('Teams for Linux is already installed via Snap, skipping installation.');
352
- return;
353
- }
354
-
355
- // Also check if command exists (from another installation method)
356
- if (isTeamsForLinuxInstalled()) {
357
- console.log('Teams for Linux is already installed, skipping installation.');
358
- return;
359
- }
360
-
361
- console.log('');
362
- console.log('NOTE: Microsoft discontinued native Linux support for Teams.');
363
- console.log('Installing the unofficial "Teams for Linux" client via Snap.');
364
- console.log('Snap is required for Raspberry Pi as the APT repository only supports amd64.');
365
- console.log('');
366
-
367
- // Ensure snapd is installed
368
- if (!snap.isInstalled()) {
369
- console.log('Installing snapd...');
370
- const snapdResult = await shell.exec(
371
- 'sudo DEBIAN_FRONTEND=noninteractive apt-get update -y && ' +
372
- 'sudo DEBIAN_FRONTEND=noninteractive apt-get install -y snapd'
373
- );
374
- if (snapdResult.code !== 0) {
375
- throw new Error(
376
- `Failed to install snapd.\n` +
377
- `Output: ${snapdResult.stderr}\n\n` +
378
- `Please install snapd manually and retry:\n` +
379
- ` sudo apt-get install snapd\n` +
380
- ` sudo reboot`
381
- );
382
- }
383
- console.log('');
384
- console.log('IMPORTANT: snapd was just installed. You may need to reboot');
385
- console.log('and run this installer again for Snap to work properly.');
386
- console.log('');
387
- }
388
-
389
- // Install Teams for Linux via Snap
390
- console.log('Installing Teams for Linux via Snap...');
391
- const result = await snap.install(SNAP_PACKAGE_NAME);
392
-
393
- if (!result.success) {
394
- throw new Error(
395
- `Failed to install Teams for Linux via Snap.\n` +
396
- `Output: ${result.output}\n\n` +
397
- `Troubleshooting:\n` +
398
- ` 1. If snapd was just installed, try rebooting first\n` +
399
- ` 2. Ensure snapd socket is running: sudo systemctl enable --now snapd.socket\n` +
400
- ` 3. Try manual installation: sudo snap install teams-for-linux`
401
- );
402
- }
403
-
404
- console.log('Teams for Linux installed successfully.');
405
- console.log('');
406
- console.log('To launch Teams for Linux:');
407
- console.log(' - Run: teams-for-linux');
408
- console.log(' - Or launch from your application menu');
409
- console.log('');
410
- console.log('PERFORMANCE NOTES for Raspberry Pi:');
411
- console.log(' - Use a Raspberry Pi 4 or 5 with at least 4 GB RAM for video calls');
412
- console.log(' - Close other applications during video calls');
413
- console.log(' - Screen sharing may have limited support on ARM devices');
414
- }
415
-
416
- /**
417
- * Install Teams for Linux on Amazon Linux/RHEL using DNF/YUM.
418
- *
419
- * Prerequisites:
420
- * - Amazon Linux 2023, Amazon Linux 2, RHEL 8, RHEL 9, or Fedora
421
- * - sudo privileges
422
- * - At least 1 GB free disk space
423
- *
424
- * NOTE: Microsoft discontinued native Linux support. This installs the unofficial
425
- * "Teams for Linux" client from the teamsforlinux.de RPM repository.
426
- *
427
- * @returns {Promise<void>}
428
- * @throws {Error} If installation fails
429
- */
430
- async function install_amazon_linux() {
431
- console.log('Checking if Teams for Linux is already installed...');
432
-
433
- // Check if already installed
434
- if (isTeamsForLinuxInstalled()) {
435
- console.log('Teams for Linux is already installed, skipping installation.');
436
- return;
437
- }
438
-
439
- console.log('');
440
- console.log('NOTE: Microsoft discontinued native Linux support for Teams.');
441
- console.log('Installing the unofficial "Teams for Linux" client.');
442
- console.log('');
443
-
444
- // Detect package manager (dnf for AL2023/RHEL 8+/Fedora, yum for AL2)
445
- const hasDnf = shell.commandExists('dnf');
446
- const hasYum = shell.commandExists('yum');
447
- const packageManager = hasDnf ? 'dnf' : (hasYum ? 'yum' : null);
448
-
449
- if (!packageManager) {
450
- throw new Error(
451
- 'Neither dnf nor yum package manager found.\n' +
452
- 'This installer supports Amazon Linux 2023 (dnf), Amazon Linux 2 (yum),\n' +
453
- 'RHEL 8/9 (dnf), and Fedora (dnf).'
454
- );
455
- }
456
-
457
- console.log(`Detected package manager: ${packageManager}`);
458
-
459
- // Set up the RPM repository
460
- await setupTeamsForLinuxRpmRepository();
461
-
462
- // Install Teams for Linux
463
- console.log('Installing Teams for Linux...');
464
- const installResult = await shell.exec(`sudo ${packageManager} install -y ${APT_PACKAGE_NAME}`);
465
-
466
- if (installResult.code !== 0) {
467
- throw new Error(
468
- `Failed to install Teams for Linux.\n` +
469
- `Output: ${installResult.stderr}\n\n` +
470
- `Troubleshooting:\n` +
471
- ` 1. Verify the repository was added: cat /etc/yum.repos.d/teams-for-linux.repo\n` +
472
- ` 2. Update system packages: sudo ${packageManager} update -y\n` +
473
- ` 3. Retry installation: sudo ${packageManager} install -y teams-for-linux`
474
- );
475
- }
476
-
477
- // Verify installation
478
- if (!isTeamsForLinuxInstalled()) {
479
- throw new Error(
480
- 'Installation appeared to complete but Teams for Linux was not found.\n\n' +
481
- 'Please try:\n' +
482
- ' 1. Restart your terminal session\n' +
483
- ' 2. Run: teams-for-linux --version'
484
- );
485
- }
486
-
487
- console.log('Teams for Linux installed successfully.');
488
- console.log('');
489
- console.log('To launch Teams for Linux:');
490
- console.log(' - Run: teams-for-linux');
491
- console.log(' - Or launch from your application menu');
492
- console.log('');
493
- console.log('NOTE: If running on a headless EC2 instance, Teams cannot be used directly.');
494
- console.log('Consider accessing Teams via a browser on a machine with GUI access.');
495
- }
496
-
497
- /**
498
- * Install Microsoft Teams on Windows using Chocolatey.
499
- *
500
- * Prerequisites:
501
- * - Windows 10 version 20H1 (10.0.19041) or later, or Windows 11
502
- * - At least 2 GB RAM and 3 GB free disk space
503
- * - Administrator PowerShell or Command Prompt
504
- * - Chocolatey package manager installed
505
- *
506
- * The installation uses the new Microsoft Teams client (version 2.x) via the
507
- * official Microsoft bootstrapper, which downloads and installs the latest
508
- * Teams MSIX package.
509
- *
510
- * @returns {Promise<void>}
511
- * @throws {Error} If Chocolatey is not installed or installation fails
512
- */
513
- async function install_windows() {
514
- console.log('Checking if Microsoft Teams is already installed...');
515
-
516
- // Check if Teams package is installed via Chocolatey
517
- const packageInstalled = await choco.isPackageInstalled(CHOCO_PACKAGE_NAME);
518
- if (packageInstalled) {
519
- console.log('Microsoft Teams is already installed via Chocolatey, skipping installation.');
520
- return;
521
- }
522
-
523
- // Also check for the older package name
524
- const oldPackageInstalled = await choco.isPackageInstalled('microsoft-teams');
525
- if (oldPackageInstalled) {
526
- console.log('Microsoft Teams (classic) is already installed, skipping installation.');
527
- console.log('');
528
- console.log('NOTE: To upgrade to the new Teams client, run:');
529
- console.log(' choco uninstall microsoft-teams -y');
530
- console.log(' choco install microsoft-teams-new-bootstrapper -y');
531
- return;
532
- }
533
-
534
- // Verify Chocolatey is available
535
- if (!choco.isInstalled()) {
536
- throw new Error(
537
- 'Chocolatey is not installed. Please install Chocolatey first:\n\n' +
538
- 'Run the following in an Administrator PowerShell:\n' +
539
- ' Set-ExecutionPolicy Bypass -Scope Process -Force; ' +
540
- '[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; ' +
541
- 'iex ((New-Object System.Net.WebClient).DownloadString(\'https://community.chocolatey.org/install.ps1\'))\n\n' +
542
- 'Then retry installing Microsoft Teams.'
543
- );
544
- }
545
-
546
- console.log('Installing Microsoft Teams via Chocolatey...');
547
- console.log('This may take a few minutes...');
548
-
549
- // Install Microsoft Teams
550
- const result = await choco.install(CHOCO_PACKAGE_NAME);
551
-
552
- if (!result.success) {
553
- throw new Error(
554
- `Failed to install Microsoft Teams via Chocolatey.\n` +
555
- `Output: ${result.output}\n\n` +
556
- `Troubleshooting:\n` +
557
- ` 1. Ensure you are running as Administrator\n` +
558
- ` 2. Update Chocolatey: choco upgrade chocolatey -y\n` +
559
- ` 3. Try manual installation: choco install microsoft-teams-new-bootstrapper -y --force`
560
- );
561
- }
562
-
563
- console.log('Microsoft Teams installed successfully.');
564
- console.log('');
565
- console.log('To launch Microsoft Teams:');
566
- console.log(' - Search for "Microsoft Teams" in the Start Menu');
567
- console.log(' - Or run: Start-Process ms-teams:');
568
- console.log('');
569
- console.log('On first launch, sign in with your Microsoft account (personal, work, or school).');
570
- }
571
-
572
- /**
573
- * Install Microsoft Teams for WSL (Windows Subsystem for Linux).
574
- *
575
- * WSL runs a Linux environment, but the recommended approach is to install
576
- * Teams on the Windows host and launch it from WSL. This provides better
577
- * audio/video support and system integration.
578
- *
579
- * Prerequisites:
580
- * - Windows 10 version 2004 or higher, or Windows 11
581
- * - WSL 2 enabled with Ubuntu distribution installed
582
- * - Administrator access on Windows for installation
583
- *
584
- * @returns {Promise<void>}
585
- * @throws {Error} If installation fails
586
- */
587
- async function install_ubuntu_wsl() {
588
- console.log('Detected Ubuntu running in WSL (Windows Subsystem for Linux).');
589
- console.log('');
590
- console.log('Installing Microsoft Teams on the Windows host...');
591
- console.log('This is the recommended approach for better audio/video support.');
592
- console.log('');
593
-
594
- // Install Teams on Windows host via PowerShell
595
- console.log('Installing Microsoft Teams via Chocolatey on Windows...');
596
- const installResult = await shell.exec(
597
- `powershell.exe -NoProfile -Command "choco install ${CHOCO_PACKAGE_NAME} -y"`
598
- );
599
-
600
- if (installResult.code !== 0) {
601
- // Check if Chocolatey is not installed
602
- if (installResult.stderr && installResult.stderr.includes('not recognized')) {
603
- throw new Error(
604
- 'Chocolatey is not installed on Windows. Please install it first:\n\n' +
605
- 'Run the following in an Administrator PowerShell on Windows:\n' +
606
- ' Set-ExecutionPolicy Bypass -Scope Process -Force; ' +
607
- '[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; ' +
608
- 'iex ((New-Object System.Net.WebClient).DownloadString(\'https://community.chocolatey.org/install.ps1\'))\n\n' +
609
- 'Then retry installing Microsoft Teams from WSL.'
610
- );
611
- }
612
-
613
- throw new Error(
614
- `Failed to install Microsoft Teams.\n` +
615
- `Output: ${installResult.stdout || installResult.stderr}\n\n` +
616
- `Troubleshooting:\n` +
617
- ` 1. Ensure Chocolatey is installed on Windows\n` +
618
- ` 2. Run the installer from an Administrator terminal\n` +
619
- ` 3. Try installing directly from PowerShell:\n` +
620
- ` choco install microsoft-teams-new-bootstrapper -y`
621
- );
622
- }
623
-
624
- console.log('Microsoft Teams installed successfully on Windows.');
625
- console.log('');
626
- console.log('To launch Teams from WSL:');
627
- console.log(' cmd.exe /c start ms-teams:');
628
- console.log('');
629
- console.log('On first launch, sign in with your Microsoft account.');
630
- }
631
-
632
- /**
633
- * Install Microsoft Teams from Git Bash on Windows.
634
- *
635
- * Git Bash runs within Windows, so this function installs Microsoft Teams
636
- * on the Windows host using Chocolatey via PowerShell interop.
637
- *
638
- * Prerequisites:
639
- * - Windows 10 or Windows 11 (64-bit)
640
- * - Git Bash installed (comes with Git for Windows)
641
- * - Chocolatey package manager installed on Windows
642
- * - Administrator privileges
643
- *
644
- * @returns {Promise<void>}
645
- * @throws {Error} If installation fails
646
- */
647
- async function install_gitbash() {
648
- console.log('Detected Git Bash on Windows.');
649
- console.log('Installing Microsoft Teams on the Windows host...');
650
- console.log('');
651
-
652
- // Install via PowerShell using Chocolatey
653
- console.log('Installing Microsoft Teams via Chocolatey...');
654
- const installResult = await shell.exec(
655
- `powershell.exe -NoProfile -Command "choco install ${CHOCO_PACKAGE_NAME} -y"`
656
- );
657
-
658
- if (installResult.code !== 0) {
659
- throw new Error(
660
- `Failed to install Microsoft Teams.\n` +
661
- `Output: ${installResult.stdout || installResult.stderr}\n\n` +
662
- `Troubleshooting:\n` +
663
- ` 1. Ensure Chocolatey is installed on Windows\n` +
664
- ` 2. Run Git Bash as Administrator and retry\n` +
665
- ` 3. Try installing directly from PowerShell:\n` +
666
- ` choco install microsoft-teams-new-bootstrapper -y`
667
- );
668
- }
669
-
670
- console.log('Microsoft Teams installed successfully.');
671
- console.log('');
672
- console.log('To launch Teams from Git Bash:');
673
- console.log(' start ms-teams:');
674
- console.log(' OR');
675
- console.log(' cmd //c "start ms-teams:"');
676
- console.log('');
677
- console.log('On first launch, sign in with your Microsoft account.');
678
- }
679
-
680
- /**
681
- * Check if Microsoft Teams is installed on the current platform.
682
- *
683
- * On macOS, checks if Teams.app exists.
684
- * On Windows/Git Bash, checks if Teams is installed via Chocolatey.
685
- * On Linux, checks if teams-for-linux command exists.
686
- *
687
- * @returns {Promise<boolean>} True if installed, false otherwise
688
- */
689
- async function isInstalled() {
690
- const platform = os.detect();
691
-
692
- if (platform.type === 'macos') {
693
- return brew.isCaskInstalled(HOMEBREW_CASK_NAME);
694
- }
695
-
696
- if (platform.type === 'windows' || platform.type === 'gitbash' || platform.type === 'wsl') {
697
- return choco.isPackageInstalled(CHOCO_PACKAGE_NAME);
698
- }
699
-
700
- if (platform.type === 'raspbian') {
701
- return snap.isSnapInstalled(SNAP_PACKAGE_NAME);
702
- }
703
-
704
- // Ubuntu/Debian and other Linux: Check for teams-for-linux command
705
- if (['ubuntu', 'debian', 'amazon_linux', 'rhel', 'fedora'].includes(platform.type)) {
706
- return shell.commandExists('teams-for-linux');
707
- }
708
-
709
- return false;
710
- }
711
-
712
- /**
713
- * Check if this installer is supported on the current platform.
714
- * Microsoft Teams is supported on all major platforms.
715
- * @returns {boolean} True if installation is supported on this platform
716
- */
717
- function isEligible() {
718
- const platform = os.detect();
719
-
720
- // First check if the platform is supported
721
- const supportedPlatforms = ['macos', 'ubuntu', 'debian', 'wsl', 'raspbian', 'amazon_linux', 'rhel', 'fedora', 'windows', 'gitbash'];
722
- if (!supportedPlatforms.includes(platform.type)) {
723
- return false;
724
- }
725
-
726
- // This installer requires a desktop environment
727
- if (REQUIRES_DESKTOP && !os.isDesktopAvailable()) {
728
- return false;
729
- }
730
-
731
- return true;
732
- }
733
-
734
- /**
735
- * Main installation entry point.
736
- *
737
- * Detects the current platform and runs the appropriate installer function.
738
- * Handles platform-specific mappings to ensure all supported platforms
739
- * have appropriate installation logic.
740
- *
741
- * Supported platforms:
742
- * - macOS: Microsoft Teams via Homebrew cask
743
- * - Ubuntu/Debian: Teams for Linux via APT repository
744
- * - Raspberry Pi OS: Teams for Linux via Snap (ARM support)
745
- * - Amazon Linux/RHEL/Fedora: Teams for Linux via RPM repository
746
- * - Windows: Microsoft Teams via Chocolatey
747
- * - WSL (Ubuntu): Microsoft Teams on Windows host
748
- * - Git Bash: Microsoft Teams on Windows host
749
- *
750
- * @returns {Promise<void>}
751
- */
752
- async function install() {
753
- const platform = os.detect();
754
-
755
- // Map platform types to their installer functions
756
- // This mapping handles aliases and variant platforms
757
- const installers = {
758
- 'macos': install_macos,
759
- 'ubuntu': install_ubuntu,
760
- 'debian': install_ubuntu,
761
- 'wsl': install_ubuntu_wsl,
762
- 'raspbian': install_raspbian,
763
- 'amazon_linux': install_amazon_linux,
764
- 'rhel': install_amazon_linux,
765
- 'fedora': install_amazon_linux,
766
- 'windows': install_windows,
767
- 'gitbash': install_gitbash
768
- };
769
-
770
- const installer = installers[platform.type];
771
-
772
- if (!installer) {
773
- console.log(`Microsoft Teams is not available for ${platform.type}.`);
774
- return;
775
- }
776
-
777
- await installer();
778
- }
779
-
780
- // Export all functions for use as a module and for testing
781
- module.exports = {
782
- REQUIRES_DESKTOP,
783
- install,
784
- isInstalled,
785
- isEligible,
786
- install_macos,
787
- install_ubuntu,
788
- install_ubuntu_wsl,
789
- install_raspbian,
790
- install_amazon_linux,
791
- install_windows,
792
- install_gitbash
793
- };
794
-
795
- // Allow direct execution: node microsoft-teams.js
796
- if (require.main === module) {
797
- install().catch(err => {
798
- console.error(err.message);
799
- process.exit(1);
800
- });
801
- }