@fredlackey/devutils 0.0.1 → 0.0.2

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 (257) hide show
  1. package/README.md +5 -5
  2. package/package.json +1 -1
  3. package/src/commands/install.js +374 -36
  4. package/src/installs/adobe-creative-cloud.js +527 -25
  5. package/src/installs/adobe-creative-cloud.md +605 -0
  6. package/src/installs/appcleaner.js +303 -26
  7. package/src/installs/appcleaner.md +699 -0
  8. package/src/installs/apt-transport-https.js +390 -0
  9. package/src/installs/apt-transport-https.md +678 -0
  10. package/src/installs/atomicparsley.js +624 -26
  11. package/src/installs/atomicparsley.md +795 -0
  12. package/src/installs/aws-cli.js +779 -26
  13. package/src/installs/aws-cli.md +727 -0
  14. package/src/installs/balena-etcher.js +688 -26
  15. package/src/installs/balena-etcher.md +761 -0
  16. package/src/installs/bambu-studio.js +912 -26
  17. package/src/installs/bambu-studio.md +780 -0
  18. package/src/installs/bash-completion.js +554 -23
  19. package/src/installs/bash-completion.md +833 -0
  20. package/src/installs/bash.js +399 -26
  21. package/src/installs/bash.md +993 -0
  22. package/src/installs/beyond-compare.js +585 -26
  23. package/src/installs/beyond-compare.md +813 -0
  24. package/src/installs/build-essential.js +511 -26
  25. package/src/installs/build-essential.md +977 -0
  26. package/src/installs/ca-certificates.js +618 -0
  27. package/src/installs/ca-certificates.md +937 -0
  28. package/src/installs/caffeine.js +490 -26
  29. package/src/installs/caffeine.md +839 -0
  30. package/src/installs/camtasia.js +577 -25
  31. package/src/installs/camtasia.md +762 -0
  32. package/src/installs/chatgpt.js +458 -26
  33. package/src/installs/chatgpt.md +814 -0
  34. package/src/installs/chocolatey.js +447 -0
  35. package/src/installs/chocolatey.md +661 -0
  36. package/src/installs/chrome-canary.js +472 -26
  37. package/src/installs/chrome-canary.md +641 -0
  38. package/src/installs/chromium.js +645 -26
  39. package/src/installs/chromium.md +838 -0
  40. package/src/installs/claude-code.js +558 -26
  41. package/src/installs/claude-code.md +1173 -0
  42. package/src/installs/curl.js +361 -26
  43. package/src/installs/curl.md +714 -0
  44. package/src/installs/cursor.js +561 -26
  45. package/src/installs/cursor.md +970 -0
  46. package/src/installs/dbschema.js +674 -26
  47. package/src/installs/dbschema.md +925 -0
  48. package/src/installs/dependencies.md +435 -0
  49. package/src/installs/development-tools.js +600 -0
  50. package/src/installs/development-tools.md +977 -0
  51. package/src/installs/docker.js +1010 -25
  52. package/src/installs/docker.md +1109 -0
  53. package/src/installs/drawio.js +1001 -26
  54. package/src/installs/drawio.md +795 -0
  55. package/src/installs/elmedia-player.js +328 -25
  56. package/src/installs/elmedia-player.md +556 -0
  57. package/src/installs/ffmpeg.js +870 -25
  58. package/src/installs/ffmpeg.md +852 -0
  59. package/src/installs/file.js +464 -0
  60. package/src/installs/file.md +987 -0
  61. package/src/installs/gemini-cli.js +793 -26
  62. package/src/installs/gemini-cli.md +1153 -0
  63. package/src/installs/git.js +382 -26
  64. package/src/installs/git.md +907 -0
  65. package/src/installs/gitego.js +931 -26
  66. package/src/installs/gitego.md +1172 -0
  67. package/src/installs/go.js +913 -26
  68. package/src/installs/go.md +958 -0
  69. package/src/installs/google-chrome.js +801 -25
  70. package/src/installs/google-chrome.md +862 -0
  71. package/src/installs/gpg.js +412 -73
  72. package/src/installs/gpg.md +1056 -0
  73. package/src/installs/homebrew.js +1015 -26
  74. package/src/installs/homebrew.md +988 -0
  75. package/src/installs/imageoptim.js +950 -26
  76. package/src/installs/imageoptim.md +1119 -0
  77. package/src/installs/installers.json +2297 -0
  78. package/src/installs/jq.js +382 -26
  79. package/src/installs/jq.md +809 -0
  80. package/src/installs/keyboard-maestro.js +701 -26
  81. package/src/installs/keyboard-maestro.md +825 -0
  82. package/src/installs/latex.js +771 -26
  83. package/src/installs/latex.md +1095 -0
  84. package/src/installs/lftp.js +338 -26
  85. package/src/installs/lftp.md +907 -0
  86. package/src/installs/lsb-release.js +346 -0
  87. package/src/installs/lsb-release.md +814 -0
  88. package/src/installs/messenger.js +829 -26
  89. package/src/installs/messenger.md +900 -0
  90. package/src/installs/microsoft-office.js +550 -26
  91. package/src/installs/microsoft-office.md +760 -0
  92. package/src/installs/microsoft-teams.js +782 -25
  93. package/src/installs/microsoft-teams.md +886 -0
  94. package/src/installs/node.js +886 -26
  95. package/src/installs/node.md +1153 -0
  96. package/src/installs/nordpass.js +698 -26
  97. package/src/installs/nordpass.md +921 -0
  98. package/src/installs/nvm.js +977 -26
  99. package/src/installs/nvm.md +1057 -0
  100. package/src/installs/openssh.js +734 -64
  101. package/src/installs/openssh.md +1056 -0
  102. package/src/installs/pandoc.js +644 -26
  103. package/src/installs/pandoc.md +1036 -0
  104. package/src/installs/pinentry.js +492 -26
  105. package/src/installs/pinentry.md +1142 -0
  106. package/src/installs/pngyu.js +851 -26
  107. package/src/installs/pngyu.md +896 -0
  108. package/src/installs/postman.js +781 -26
  109. package/src/installs/postman.md +940 -0
  110. package/src/installs/procps.js +425 -0
  111. package/src/installs/procps.md +851 -0
  112. package/src/installs/safari-tech-preview.js +355 -25
  113. package/src/installs/safari-tech-preview.md +533 -0
  114. package/src/installs/sfnt2woff.js +640 -26
  115. package/src/installs/sfnt2woff.md +795 -0
  116. package/src/installs/shellcheck.js +463 -26
  117. package/src/installs/shellcheck.md +1005 -0
  118. package/src/installs/slack.js +722 -25
  119. package/src/installs/slack.md +865 -0
  120. package/src/installs/snagit.js +566 -25
  121. package/src/installs/snagit.md +844 -0
  122. package/src/installs/software-properties-common.js +372 -0
  123. package/src/installs/software-properties-common.md +805 -0
  124. package/src/installs/spotify.js +858 -25
  125. package/src/installs/spotify.md +901 -0
  126. package/src/installs/studio-3t.js +803 -26
  127. package/src/installs/studio-3t.md +918 -0
  128. package/src/installs/sublime-text.js +780 -25
  129. package/src/installs/sublime-text.md +914 -0
  130. package/src/installs/superwhisper.js +687 -25
  131. package/src/installs/superwhisper.md +630 -0
  132. package/src/installs/tailscale.js +727 -26
  133. package/src/installs/tailscale.md +1100 -0
  134. package/src/installs/tar.js +389 -0
  135. package/src/installs/tar.md +946 -0
  136. package/src/installs/termius.js +780 -26
  137. package/src/installs/termius.md +844 -0
  138. package/src/installs/terraform.js +761 -26
  139. package/src/installs/terraform.md +899 -0
  140. package/src/installs/tidal.js +752 -25
  141. package/src/installs/tidal.md +864 -0
  142. package/src/installs/tmux.js +328 -26
  143. package/src/installs/tmux.md +1030 -0
  144. package/src/installs/tree.js +393 -26
  145. package/src/installs/tree.md +833 -0
  146. package/src/installs/unzip.js +460 -0
  147. package/src/installs/unzip.md +879 -0
  148. package/src/installs/vim.js +403 -26
  149. package/src/installs/vim.md +1040 -0
  150. package/src/installs/vlc.js +803 -26
  151. package/src/installs/vlc.md +927 -0
  152. package/src/installs/vscode.js +825 -26
  153. package/src/installs/vscode.md +1002 -0
  154. package/src/installs/wget.js +415 -0
  155. package/src/installs/wget.md +791 -0
  156. package/src/installs/whatsapp.js +710 -25
  157. package/src/installs/whatsapp.md +854 -0
  158. package/src/installs/winpty.js +352 -0
  159. package/src/installs/winpty.md +620 -0
  160. package/src/installs/woff2.js +535 -26
  161. package/src/installs/woff2.md +977 -0
  162. package/src/installs/wsl.js +572 -0
  163. package/src/installs/wsl.md +699 -0
  164. package/src/installs/xcode-clt.js +520 -0
  165. package/src/installs/xcode-clt.md +351 -0
  166. package/src/installs/xcode.js +542 -26
  167. package/src/installs/xcode.md +573 -0
  168. package/src/installs/yarn.js +806 -26
  169. package/src/installs/yarn.md +1074 -0
  170. package/src/installs/yq.js +636 -26
  171. package/src/installs/yq.md +944 -0
  172. package/src/installs/yt-dlp.js +683 -26
  173. package/src/installs/yt-dlp.md +946 -0
  174. package/src/installs/yum-utils.js +297 -0
  175. package/src/installs/yum-utils.md +648 -0
  176. package/src/installs/zoom.js +740 -25
  177. package/src/installs/zoom.md +884 -0
  178. package/src/scripts/README.md +567 -45
  179. package/src/scripts/STATUS.md +208 -0
  180. package/src/scripts/afk.js +395 -7
  181. package/src/scripts/backup-all.js +731 -9
  182. package/src/scripts/backup-source.js +711 -8
  183. package/src/scripts/brewd.js +373 -7
  184. package/src/scripts/brewi.js +505 -9
  185. package/src/scripts/brewr.js +512 -9
  186. package/src/scripts/brews.js +462 -9
  187. package/src/scripts/brewu.js +488 -7
  188. package/src/scripts/c.js +185 -7
  189. package/src/scripts/ccurl.js +325 -8
  190. package/src/scripts/certbot-crontab-init.js +488 -8
  191. package/src/scripts/certbot-init.js +641 -9
  192. package/src/scripts/ch.js +339 -7
  193. package/src/scripts/claude-danger.js +253 -8
  194. package/src/scripts/clean-dev.js +419 -8
  195. package/src/scripts/clear-dns-cache.js +525 -7
  196. package/src/scripts/clone.js +417 -7
  197. package/src/scripts/code-all.js +420 -7
  198. package/src/scripts/count-files.js +195 -8
  199. package/src/scripts/count-folders.js +195 -8
  200. package/src/scripts/count.js +248 -8
  201. package/src/scripts/d.js +203 -7
  202. package/src/scripts/datauri.js +373 -8
  203. package/src/scripts/delete-files.js +363 -7
  204. package/src/scripts/docker-clean.js +410 -8
  205. package/src/scripts/dp.js +426 -7
  206. package/src/scripts/e.js +375 -9
  207. package/src/scripts/empty-trash.js +497 -7
  208. package/src/scripts/evm.js +428 -9
  209. package/src/scripts/fetch-github-repos.js +441 -10
  210. package/src/scripts/get-channel.js +329 -8
  211. package/src/scripts/get-course.js +384 -11
  212. package/src/scripts/get-dependencies.js +290 -9
  213. package/src/scripts/get-folder.js +783 -10
  214. package/src/scripts/get-tunes.js +411 -10
  215. package/src/scripts/get-video.js +352 -9
  216. package/src/scripts/git-backup.js +561 -9
  217. package/src/scripts/git-clone.js +477 -9
  218. package/src/scripts/git-pup.js +303 -7
  219. package/src/scripts/git-push.js +380 -8
  220. package/src/scripts/h.js +607 -9
  221. package/src/scripts/hide-desktop-icons.js +483 -7
  222. package/src/scripts/hide-hidden-files.js +522 -7
  223. package/src/scripts/install-dependencies-from.js +440 -9
  224. package/src/scripts/ips.js +647 -10
  225. package/src/scripts/iso.js +354 -8
  226. package/src/scripts/killni.js +561 -7
  227. package/src/scripts/ll.js +451 -8
  228. package/src/scripts/local-ip.js +310 -8
  229. package/src/scripts/m.js +508 -8
  230. package/src/scripts/map.js +293 -8
  231. package/src/scripts/mkd.js +287 -7
  232. package/src/scripts/ncu-update-all.js +441 -8
  233. package/src/scripts/nginx-init.js +702 -12
  234. package/src/scripts/npmi.js +366 -7
  235. package/src/scripts/o.js +495 -8
  236. package/src/scripts/org-by-date.js +321 -7
  237. package/src/scripts/p.js +208 -7
  238. package/src/scripts/packages.js +313 -8
  239. package/src/scripts/path.js +209 -7
  240. package/src/scripts/ports.js +582 -8
  241. package/src/scripts/q.js +290 -8
  242. package/src/scripts/refresh-files.js +378 -10
  243. package/src/scripts/remove-smaller-files.js +500 -8
  244. package/src/scripts/rename-files-with-date.js +517 -9
  245. package/src/scripts/resize-image.js +523 -9
  246. package/src/scripts/rm-safe.js +653 -8
  247. package/src/scripts/s.js +525 -9
  248. package/src/scripts/set-git-public.js +349 -7
  249. package/src/scripts/show-desktop-icons.js +459 -7
  250. package/src/scripts/show-hidden-files.js +456 -7
  251. package/src/scripts/tpa.js +265 -8
  252. package/src/scripts/tpo.js +264 -7
  253. package/src/scripts/u.js +489 -7
  254. package/src/scripts/vpush.js +422 -8
  255. package/src/scripts/y.js +267 -7
  256. package/src/utils/common/os.js +94 -2
  257. package/src/utils/ubuntu/apt.js +13 -7
@@ -1,28 +1,718 @@
1
1
  #!/usr/bin/env node
2
2
 
3
3
  /**
4
- * @fileoverview Create nginx configuration from template.
4
+ * nginx-init - Create nginx configuration from template
5
+ *
6
+ * Migrated from legacy dotfiles function.
7
+ * Original:
8
+ * nginx-init() {
9
+ * # Initialize nginx configuration from template files.
10
+ * # Usage: nginx-init -d example.com -h http://127.0.0.1:3000 -f example.conf
11
+ * # Copies template, replaces %DOMAINS% and %HOST_URL% tokens,
12
+ * # writes to /etc/nginx/sites-available, optionally creates symlink
13
+ * }
14
+ *
15
+ * This script creates nginx site configuration files from templates,
16
+ * replacing placeholder tokens with actual domain names and upstream URLs.
17
+ * It supports:
18
+ * - Multiple domains per configuration (-d can be used multiple times)
19
+ * - Standard and API templates (with CORS preflight handling)
20
+ * - Automatic symlink creation in sites-enabled
21
+ *
5
22
  * @module scripts/nginx-init
6
23
  */
7
24
 
25
+ const os = require('../utils/common/os');
26
+ const fs = require('fs');
27
+ const path = require('path');
28
+ const { execSync, spawnSync } = require('child_process');
29
+
30
+ // Define the nginx template content directly in the script
31
+ // This ensures the script works regardless of where it's installed
32
+
33
+ /**
34
+ * Standard nginx template for proxying requests to a backend service.
35
+ * Uses %DOMAINS% and %HOST_URL% as placeholder tokens.
36
+ */
37
+ const TEMPLATE_STANDARD = `server {
38
+
39
+ server_name %DOMAINS%;
40
+ listen 80;
41
+
42
+ # Allow GET requests to root path
43
+ location / {
44
+ proxy_pass %HOST_URL%;
45
+ proxy_set_header Host $host;
46
+ proxy_set_header X-Real-IP $remote_addr;
47
+ proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
48
+ proxy_set_header X-Forwarded-Proto $scheme;
49
+ }
50
+
51
+ }
52
+ `;
53
+
54
+ /**
55
+ * API nginx template with CORS preflight handling.
56
+ * Includes OPTIONS request handling for cross-origin API requests.
57
+ * Uses %DOMAINS% and %HOST_URL% as placeholder tokens.
58
+ */
59
+ const TEMPLATE_API = `server {
60
+
61
+ server_name %DOMAINS%;
62
+ listen 80;
63
+
64
+ # Allow GET requests to root path
65
+ location / {
66
+ proxy_pass %HOST_URL%;
67
+ proxy_http_version 1.1;
68
+ proxy_set_header Host $host;
69
+ proxy_set_header X-Real-IP $remote_addr;
70
+ proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
71
+ proxy_set_header X-Forwarded-Proto $scheme;
72
+
73
+ # Preflight CORS requests
74
+ if ($request_method = OPTIONS ) {
75
+ add_header Access-Control-Allow-Origin *;
76
+ add_header Access-Control-Allow-Methods "GET, POST, OPTIONS";
77
+ add_header Access-Control-Allow-Headers "Content-Type";
78
+ add_header Content-Length 0;
79
+ add_header Content-Type text/plain;
80
+ return 204;
81
+ }
82
+ }
83
+
84
+ }
85
+ `;
86
+
87
+ /**
88
+ * Display usage information and examples.
89
+ * Shows all available options and how to use them correctly.
90
+ */
91
+ function showUsage() {
92
+ console.log(`nginx-init - Create nginx configuration from template
93
+
94
+ USAGE:
95
+ nginx-init [OPTIONS]
96
+
97
+ OPTIONS:
98
+ -a, --api Use API template with CORS preflight handling
99
+ -d, --domain Domain name for server_name directive (can be used multiple times) (required)
100
+ -h, --host Upstream URL for proxy_pass directive (required)
101
+ -f, --file Output filename in /etc/nginx/sites-available (must end with .conf) (required)
102
+ -l, --link Create symbolic link in /etc/nginx/sites-enabled
103
+ --help Show this help message
104
+
105
+ EXAMPLES:
106
+ nginx-init -d example.com -h http://127.0.0.1:3000 -f example.conf
107
+ nginx-init -d example.com -d www.example.com -h http://127.0.0.1:3000 -f example.conf
108
+ nginx-init --api -d api.example.com -h http://127.0.0.1:8080 -f api.conf --link
109
+
110
+ NOTE:
111
+ This command requires sudo access to write to /etc/nginx/
112
+ The output file will be created in /etc/nginx/sites-available/
113
+ Use --link to also create a symlink in /etc/nginx/sites-enabled/`);
114
+ }
115
+
116
+ /**
117
+ * Parse command line arguments into structured options.
118
+ * Handles -a/--api, -d/--domain (multiple allowed), -h/--host, -f/--file, -l/--link flags.
119
+ *
120
+ * @param {string[]} args - Raw command line arguments
121
+ * @returns {{ useApi: boolean, domains: string[], host: string, filename: string, createLink: boolean, help: boolean, error: string|null }}
122
+ */
123
+ function parseArgs(args) {
124
+ const result = {
125
+ useApi: false,
126
+ domains: [],
127
+ host: '',
128
+ filename: '',
129
+ createLink: false,
130
+ help: false,
131
+ error: null
132
+ };
133
+
134
+ let i = 0;
135
+ while (i < args.length) {
136
+ const arg = args[i];
137
+
138
+ if (arg === '--help') {
139
+ result.help = true;
140
+ return result;
141
+ }
142
+
143
+ if (arg === '-a' || arg === '--api') {
144
+ result.useApi = true;
145
+ i += 1;
146
+ continue;
147
+ }
148
+
149
+ if (arg === '-l' || arg === '--link') {
150
+ result.createLink = true;
151
+ i += 1;
152
+ continue;
153
+ }
154
+
155
+ if (arg === '-d' || arg === '--domain') {
156
+ // Check if next argument exists and is not another flag
157
+ if (i + 1 >= args.length || args[i + 1].startsWith('-')) {
158
+ result.error = 'Domain value required after -d/--domain';
159
+ return result;
160
+ }
161
+ result.domains.push(args[i + 1]);
162
+ i += 2;
163
+ continue;
164
+ }
165
+
166
+ if (arg === '-h' || arg === '--host') {
167
+ // Check if next argument exists and is not another flag
168
+ if (i + 1 >= args.length || args[i + 1].startsWith('-')) {
169
+ result.error = 'Host URL value required after -h/--host';
170
+ return result;
171
+ }
172
+ result.host = args[i + 1];
173
+ i += 2;
174
+ continue;
175
+ }
176
+
177
+ if (arg === '-f' || arg === '--file') {
178
+ // Check if next argument exists and is not another flag
179
+ if (i + 1 >= args.length || args[i + 1].startsWith('-')) {
180
+ result.error = 'Filename value required after -f/--file';
181
+ return result;
182
+ }
183
+ result.filename = args[i + 1];
184
+ i += 2;
185
+ continue;
186
+ }
187
+
188
+ // Unknown option
189
+ result.error = `Unknown option: ${arg}`;
190
+ return result;
191
+ }
192
+
193
+ return result;
194
+ }
195
+
196
+ /**
197
+ * Check if a command exists on the system.
198
+ * Uses 'which' on Unix-like systems to locate executables.
199
+ *
200
+ * @param {string} cmd - The command name to check
201
+ * @returns {boolean} True if the command exists in PATH
202
+ */
203
+ function isCommandAvailable(cmd) {
204
+ try {
205
+ const checkCmd = process.platform === 'win32' ? `where ${cmd}` : `which ${cmd}`;
206
+ execSync(checkCmd, { stdio: 'ignore' });
207
+ return true;
208
+ } catch {
209
+ return false;
210
+ }
211
+ }
212
+
213
+ /**
214
+ * Check if the current user has sudo access.
215
+ * First tries passwordless sudo, then validates sudo credentials.
216
+ *
217
+ * @returns {boolean} True if sudo access is available
218
+ */
219
+ function checkSudoAccess() {
220
+ try {
221
+ // Try passwordless sudo first
222
+ execSync('sudo -n true', { stdio: 'ignore' });
223
+ console.log('Using passwordless sudo');
224
+ return true;
225
+ } catch {
226
+ // Fall back to regular sudo (will prompt for password if needed)
227
+ console.log('Authenticating with sudo...');
228
+ try {
229
+ // sudo -v validates the user's credentials and extends the timeout
230
+ const result = spawnSync('sudo', ['-v'], { stdio: 'inherit' });
231
+ return result.status === 0;
232
+ } catch {
233
+ return false;
234
+ }
235
+ }
236
+ }
237
+
238
+ /**
239
+ * Pure Node.js implementation - NOT APPLICABLE for this script.
240
+ *
241
+ * Writing to /etc/nginx/ requires sudo access which cannot be done
242
+ * in pure Node.js. Each platform function handles the sudo elevation
243
+ * using OS-specific commands.
244
+ *
245
+ * @param {string[]} args - Command line arguments
246
+ * @returns {Promise<void>}
247
+ * @throws {Error} Always throws - this function should not be called directly
248
+ */
249
+ async function do_nginx_init_nodejs(args) {
250
+ throw new Error(
251
+ 'do_nginx_init_nodejs should not be called directly. ' +
252
+ 'Writing to /etc/nginx/ requires sudo access which is OS-specific.'
253
+ );
254
+ }
255
+
256
+ /**
257
+ * Core implementation for creating nginx configuration.
258
+ * This function contains the shared logic for all Unix-like platforms.
259
+ * It handles argument parsing, validation, template processing, and file writing.
260
+ *
261
+ * @param {string[]} args - Command line arguments
262
+ * @param {string} sitesAvailable - Path to nginx sites-available directory
263
+ * @param {string} sitesEnabled - Path to nginx sites-enabled directory
264
+ * @returns {Promise<void>}
265
+ */
266
+ async function createNginxConfig(args, sitesAvailable, sitesEnabled) {
267
+ // Parse and validate arguments
268
+ const options = parseArgs(args);
269
+
270
+ if (options.help) {
271
+ showUsage();
272
+ return;
273
+ }
274
+
275
+ if (options.error) {
276
+ console.error(`Error: ${options.error}`);
277
+ showUsage();
278
+ process.exit(1);
279
+ }
280
+
281
+ // Show usage if no arguments provided
282
+ if (args.length === 0) {
283
+ showUsage();
284
+ return;
285
+ }
286
+
287
+ // Validate required arguments
288
+ if (options.domains.length === 0) {
289
+ console.error('Error: At least one domain is required (-d or --domain)');
290
+ showUsage();
291
+ process.exit(1);
292
+ }
293
+
294
+ if (!options.host) {
295
+ console.error('Error: Host URL is required (-h or --host)');
296
+ showUsage();
297
+ process.exit(1);
298
+ }
299
+
300
+ if (!options.filename) {
301
+ console.error('Error: Filename is required (-f or --file)');
302
+ showUsage();
303
+ process.exit(1);
304
+ }
305
+
306
+ // Validate filename ends with .conf
307
+ if (!options.filename.endsWith('.conf')) {
308
+ console.error('Error: Filename must end with .conf');
309
+ process.exit(1);
310
+ }
311
+
312
+ // Check if sites-available directory exists
313
+ if (!fs.existsSync(sitesAvailable)) {
314
+ console.error(`Error: Directory ${sitesAvailable} does not exist`);
315
+ console.error('');
316
+ console.error('Make sure nginx is installed:');
317
+ console.error(' Ubuntu/Debian: sudo apt install nginx');
318
+ console.error(' macOS: brew install nginx');
319
+ console.error(' Amazon Linux: sudo dnf install nginx');
320
+ process.exit(1);
321
+ }
322
+
323
+ // Check sudo access
324
+ console.log('This command requires sudo access to write to /etc/nginx/');
325
+ if (!checkSudoAccess()) {
326
+ console.error('Error: sudo authentication failed');
327
+ process.exit(1);
328
+ }
329
+
330
+ // Select template
331
+ const templateContent = options.useApi ? TEMPLATE_API : TEMPLATE_STANDARD;
332
+ const templateName = options.useApi ? 'API template (with CORS)' : 'Standard template';
333
+
334
+ // Join domains into a single string for server_name directive
335
+ const domainString = options.domains.join(' ');
336
+
337
+ // Perform token replacement
338
+ const configContent = templateContent
339
+ .replace(/%DOMAINS%/g, domainString)
340
+ .replace(/%HOST_URL%/g, options.host);
341
+
342
+ // Create output file path
343
+ const outputFile = path.join(sitesAvailable, options.filename);
344
+
345
+ // Check if output file already exists
346
+ if (fs.existsSync(outputFile)) {
347
+ console.log(`Warning: File ${outputFile} already exists and will be overwritten`);
348
+ }
349
+
350
+ // Display what we're about to do
351
+ console.log('');
352
+ console.log('Creating nginx configuration...');
353
+ console.log(` Template: ${templateName}`);
354
+ console.log(` Domains: ${domainString}`);
355
+ console.log(` Host: ${options.host}`);
356
+ console.log(` Output: ${outputFile}`);
357
+ console.log('');
358
+
359
+ // Write configuration file using sudo tee
360
+ // We use a temporary file and sudo mv because direct sudo write is tricky in Node.js
361
+ try {
362
+ // Create a temporary file with the config content
363
+ const tmpFile = path.join('/tmp', `nginx-config-${Date.now()}.conf`);
364
+ fs.writeFileSync(tmpFile, configContent, 'utf8');
365
+
366
+ // Use sudo to copy the file to the destination
367
+ execSync(`sudo cp "${tmpFile}" "${outputFile}"`, { stdio: 'inherit' });
368
+
369
+ // Clean up temporary file
370
+ fs.unlinkSync(tmpFile);
371
+
372
+ console.log('Configuration file created successfully');
373
+ } catch (error) {
374
+ console.error('Failed to create configuration file');
375
+ console.error(error.message);
376
+ process.exit(1);
377
+ }
378
+
379
+ // Create symbolic link if requested
380
+ if (options.createLink) {
381
+ // Check if sites-enabled directory exists
382
+ if (!fs.existsSync(sitesEnabled)) {
383
+ console.error(`Error: Directory ${sitesEnabled} does not exist`);
384
+ process.exit(1);
385
+ }
386
+
387
+ const linkPath = path.join(sitesEnabled, options.filename);
388
+
389
+ // Remove existing link if it exists
390
+ try {
391
+ const linkStats = fs.lstatSync(linkPath);
392
+ if (linkStats.isSymbolicLink()) {
393
+ execSync(`sudo rm "${linkPath}"`, { stdio: 'inherit' });
394
+ console.log('Removed existing symbolic link');
395
+ }
396
+ } catch {
397
+ // Link doesn't exist, which is fine
398
+ }
399
+
400
+ // Create new symbolic link
401
+ try {
402
+ execSync(`sudo ln -s "${outputFile}" "${linkPath}"`, { stdio: 'inherit' });
403
+ console.log(`Symbolic link created: ${linkPath}`);
404
+ } catch (error) {
405
+ console.error('Failed to create symbolic link');
406
+ console.error(error.message);
407
+ process.exit(1);
408
+ }
409
+ }
410
+
411
+ console.log('');
412
+ console.log('Done!');
413
+ console.log('');
414
+ console.log('Next steps:');
415
+ console.log(' 1. Test nginx configuration: sudo nginx -t');
416
+ console.log(' 2. Reload nginx: sudo systemctl reload nginx');
417
+ if (!options.createLink) {
418
+ console.log(` 3. Enable site (if not using --link): sudo ln -s ${outputFile} ${sitesEnabled}/${options.filename}`);
419
+ }
420
+ console.log(' 4. Set up SSL (optional): certbot-init -d ' + options.domains[0] + ' -e admin@' + options.domains[0]);
421
+ }
422
+
423
+ /**
424
+ * Create nginx configuration on macOS.
425
+ *
426
+ * macOS with Homebrew installs nginx to different paths than Linux.
427
+ * The sites-available and sites-enabled directories may need to be created
428
+ * or the configuration may go directly into /usr/local/etc/nginx/servers/.
429
+ *
430
+ * @param {string[]} args - Command line arguments
431
+ * @returns {Promise<void>}
432
+ */
433
+ async function do_nginx_init_macos(args) {
434
+ // Check for help flag first (before nginx check)
435
+ const options = parseArgs(args);
436
+ if (options.help || args.length === 0) {
437
+ showUsage();
438
+ return;
439
+ }
440
+
441
+ // Check if nginx is installed
442
+ if (!isCommandAvailable('nginx')) {
443
+ console.error('Error: nginx is not installed.');
444
+ console.error('Install it with: brew install nginx');
445
+ process.exit(1);
446
+ }
447
+
448
+ // macOS Homebrew nginx paths
449
+ // Modern Homebrew (Apple Silicon): /opt/homebrew/etc/nginx/
450
+ // Older Homebrew (Intel): /usr/local/etc/nginx/
451
+ let nginxBase = '/usr/local/etc/nginx';
452
+ if (fs.existsSync('/opt/homebrew/etc/nginx')) {
453
+ nginxBase = '/opt/homebrew/etc/nginx';
454
+ }
455
+
456
+ // Homebrew nginx uses 'servers' directory instead of sites-available/sites-enabled
457
+ // But we can create the standard directories for compatibility
458
+ const sitesAvailable = path.join(nginxBase, 'sites-available');
459
+ const sitesEnabled = path.join(nginxBase, 'sites-enabled');
460
+
461
+ // Create directories if they don't exist
462
+ if (!fs.existsSync(sitesAvailable)) {
463
+ console.log(`Creating ${sitesAvailable} directory...`);
464
+ try {
465
+ execSync(`sudo mkdir -p "${sitesAvailable}"`, { stdio: 'inherit' });
466
+ } catch (error) {
467
+ console.error(`Failed to create ${sitesAvailable}`);
468
+ process.exit(1);
469
+ }
470
+ }
471
+
472
+ if (!fs.existsSync(sitesEnabled)) {
473
+ console.log(`Creating ${sitesEnabled} directory...`);
474
+ try {
475
+ execSync(`sudo mkdir -p "${sitesEnabled}"`, { stdio: 'inherit' });
476
+ } catch (error) {
477
+ console.error(`Failed to create ${sitesEnabled}`);
478
+ process.exit(1);
479
+ }
480
+ }
481
+
482
+ console.log('');
483
+ console.log('Note: macOS nginx configuration');
484
+ console.log(` Base path: ${nginxBase}`);
485
+ console.log(' You may need to include sites-enabled in your nginx.conf:');
486
+ console.log(` include ${sitesEnabled}/*;`);
487
+ console.log('');
488
+
489
+ await createNginxConfig(args, sitesAvailable, sitesEnabled);
490
+ }
491
+
8
492
  /**
9
- * Creates an nginx site configuration file from a template,
10
- * replacing domain and host URL placeholders.
493
+ * Create nginx configuration on Ubuntu.
494
+ *
495
+ * Ubuntu uses the standard /etc/nginx/sites-available and sites-enabled
496
+ * directories that Debian established for nginx configuration management.
11
497
  *
12
498
  * @param {string[]} args - Command line arguments
13
- * @param {string} args.0 - -d/--domain: Domain name(s)
14
- * @param {string} args.1 - -h/--host: Upstream host URL
15
- * @param {string} args.2 - -f/--file: Output filename
16
- * @param {string} [args.3] - -l/--link: Create symlink to sites-enabled
17
- * @param {string} [args.4] - -a/--api: Use API template variant
18
499
  * @returns {Promise<void>}
19
500
  */
20
- async function main(args) {
21
- // TODO: Implement nginx config generation
501
+ async function do_nginx_init_ubuntu(args) {
502
+ // Check for help flag first (before nginx check)
503
+ const options = parseArgs(args);
504
+ if (options.help || args.length === 0) {
505
+ showUsage();
506
+ return;
507
+ }
508
+
509
+ // Check if nginx is installed
510
+ if (!isCommandAvailable('nginx')) {
511
+ console.error('Error: nginx is not installed.');
512
+ console.error('Install it with: sudo apt install nginx');
513
+ process.exit(1);
514
+ }
515
+
516
+ // Standard Debian/Ubuntu nginx paths
517
+ const sitesAvailable = '/etc/nginx/sites-available';
518
+ const sitesEnabled = '/etc/nginx/sites-enabled';
519
+
520
+ await createNginxConfig(args, sitesAvailable, sitesEnabled);
521
+ }
522
+
523
+ /**
524
+ * Create nginx configuration on Raspberry Pi OS.
525
+ *
526
+ * Raspberry Pi OS is Debian-based and uses the same nginx paths as Ubuntu.
527
+ *
528
+ * @param {string[]} args - Command line arguments
529
+ * @returns {Promise<void>}
530
+ */
531
+ async function do_nginx_init_raspbian(args) {
532
+ // Check for help flag first (before nginx check)
533
+ const options = parseArgs(args);
534
+ if (options.help || args.length === 0) {
535
+ showUsage();
536
+ return;
537
+ }
538
+
539
+ // Check if nginx is installed
540
+ if (!isCommandAvailable('nginx')) {
541
+ console.error('Error: nginx is not installed.');
542
+ console.error('Install it with: sudo apt install nginx');
543
+ process.exit(1);
544
+ }
545
+
546
+ // Same paths as Ubuntu (Debian-based)
547
+ const sitesAvailable = '/etc/nginx/sites-available';
548
+ const sitesEnabled = '/etc/nginx/sites-enabled';
549
+
550
+ await createNginxConfig(args, sitesAvailable, sitesEnabled);
551
+ }
552
+
553
+ /**
554
+ * Create nginx configuration on Amazon Linux.
555
+ *
556
+ * Amazon Linux (and other RHEL-based systems) use /etc/nginx/conf.d/
557
+ * instead of the Debian-style sites-available/sites-enabled structure.
558
+ * Configuration files placed in conf.d are automatically included.
559
+ *
560
+ * @param {string[]} args - Command line arguments
561
+ * @returns {Promise<void>}
562
+ */
563
+ async function do_nginx_init_amazon_linux(args) {
564
+ // Check for help flag first (before nginx check)
565
+ const options = parseArgs(args);
566
+ if (options.help || args.length === 0) {
567
+ showUsage();
568
+ return;
569
+ }
570
+
571
+ // Check if nginx is installed
572
+ if (!isCommandAvailable('nginx')) {
573
+ console.error('Error: nginx is not installed.');
574
+ console.error('Install it with: sudo dnf install nginx');
575
+ console.error(' or: sudo yum install nginx');
576
+ process.exit(1);
577
+ }
578
+
579
+ // RHEL-based systems use conf.d instead of sites-available/sites-enabled
580
+ // Files in conf.d are automatically included by the main nginx.conf
581
+ const confDir = '/etc/nginx/conf.d';
582
+
583
+ // For RHEL systems, we use conf.d for both "available" and "enabled"
584
+ // since all configs in conf.d are automatically loaded
585
+ // We still support the --link flag but it's not strictly necessary
586
+ console.log('');
587
+ console.log('Note: Amazon Linux/RHEL nginx configuration');
588
+ console.log(' Configuration files in /etc/nginx/conf.d/ are automatically included.');
589
+ console.log(' The --link option is not required on RHEL-based systems.');
590
+ console.log('');
591
+
592
+ await createNginxConfig(args, confDir, confDir);
593
+ }
594
+
595
+ /**
596
+ * nginx configuration on Windows Command Prompt.
597
+ *
598
+ * nginx on Windows is less common and has a different directory structure.
599
+ * This command is primarily designed for Linux servers.
600
+ *
601
+ * @param {string[]} args - Command line arguments
602
+ * @returns {Promise<void>}
603
+ */
604
+ async function do_nginx_init_cmd(args) {
605
+ console.log('nginx-init is not fully supported on Windows.');
606
+ console.log('');
607
+ console.log('This command is designed for Linux servers running nginx.');
608
+ console.log('');
609
+ console.log('For Windows environments, consider:');
610
+ console.log(' - Using WSL (Windows Subsystem for Linux) for a Linux-like experience');
611
+ console.log(' - Manually editing nginx configuration files');
612
+ console.log(' - Using IIS as the web server instead');
613
+ console.log('');
614
+ console.log('If nginx is installed on Windows:');
615
+ console.log(' 1. Locate your nginx installation directory');
616
+ console.log(' 2. Create configuration files in the conf/ subdirectory');
617
+ console.log(' 3. Include them in nginx.conf');
618
+ process.exit(1);
619
+ }
620
+
621
+ /**
622
+ * nginx configuration on Windows PowerShell.
623
+ *
624
+ * Same limitations as CMD - nginx on Windows is not the primary target.
625
+ *
626
+ * @param {string[]} args - Command line arguments
627
+ * @returns {Promise<void>}
628
+ */
629
+ async function do_nginx_init_powershell(args) {
630
+ // Same behavior as CMD
631
+ return do_nginx_init_cmd(args);
632
+ }
633
+
634
+ /**
635
+ * nginx configuration from Git Bash on Windows.
636
+ *
637
+ * Git Bash runs on Windows, so it has the same limitations as CMD.
638
+ *
639
+ * @param {string[]} args - Command line arguments
640
+ * @returns {Promise<void>}
641
+ */
642
+ async function do_nginx_init_gitbash(args) {
643
+ // Same behavior as CMD
644
+ return do_nginx_init_cmd(args);
645
+ }
646
+
647
+ /**
648
+ * Main entry point - detects environment and executes appropriate implementation.
649
+ *
650
+ * The nginx-init command creates nginx site configuration files from templates.
651
+ * It automates the common task of setting up a reverse proxy configuration
652
+ * for web applications running on local ports.
653
+ *
654
+ * Features:
655
+ * - Multiple domain support (server_name directive)
656
+ * - Standard and API templates (CORS preflight handling)
657
+ * - Automatic symlink creation in sites-enabled
658
+ * - Cross-platform support (Linux variants, macOS)
659
+ *
660
+ * This command requires:
661
+ * - nginx installed on the system
662
+ * - sudo access for writing to /etc/nginx/
663
+ *
664
+ * @param {string[]} args - Command line arguments
665
+ * @returns {Promise<void>}
666
+ */
667
+ async function do_nginx_init(args) {
668
+ const platform = os.detect();
669
+
670
+ const handlers = {
671
+ 'macos': do_nginx_init_macos,
672
+ 'ubuntu': do_nginx_init_ubuntu,
673
+ 'debian': do_nginx_init_ubuntu,
674
+ 'raspbian': do_nginx_init_raspbian,
675
+ 'amazon_linux': do_nginx_init_amazon_linux,
676
+ 'rhel': do_nginx_init_amazon_linux,
677
+ 'fedora': do_nginx_init_amazon_linux,
678
+ 'linux': do_nginx_init_ubuntu,
679
+ 'wsl': do_nginx_init_ubuntu,
680
+ 'cmd': do_nginx_init_cmd,
681
+ 'windows': do_nginx_init_cmd,
682
+ 'powershell': do_nginx_init_powershell,
683
+ 'gitbash': do_nginx_init_gitbash
684
+ };
685
+
686
+ const handler = handlers[platform.type];
687
+ if (!handler) {
688
+ console.error(`Platform '${platform.type}' is not supported for this command.`);
689
+ console.error('');
690
+ console.error('Supported platforms:');
691
+ console.error(' - macOS (with Homebrew nginx)');
692
+ console.error(' - Ubuntu, Debian (with APT)');
693
+ console.error(' - Raspberry Pi OS (with APT)');
694
+ console.error(' - Amazon Linux, RHEL, Fedora (with DNF/YUM)');
695
+ console.error('');
696
+ console.error('Windows is not fully supported - use WSL for a Linux environment.');
697
+ process.exit(1);
698
+ }
699
+
700
+ await handler(args);
22
701
  }
23
702
 
24
- module.exports = { main };
703
+ module.exports = {
704
+ main: do_nginx_init,
705
+ do_nginx_init,
706
+ do_nginx_init_nodejs,
707
+ do_nginx_init_macos,
708
+ do_nginx_init_ubuntu,
709
+ do_nginx_init_raspbian,
710
+ do_nginx_init_amazon_linux,
711
+ do_nginx_init_cmd,
712
+ do_nginx_init_powershell,
713
+ do_nginx_init_gitbash
714
+ };
25
715
 
26
716
  if (require.main === module) {
27
- main(process.argv.slice(2));
717
+ do_nginx_init(process.argv.slice(2));
28
718
  }