typescript-virtual-container 1.4.3 → 1.4.5

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 (382) hide show
  1. package/.vscode/settings.json +2 -1
  2. package/README.md +137 -19
  3. package/benchmark-results.txt +21 -21
  4. package/builds/self-standalone.js +322 -266
  5. package/builds/self-standalone.js.map +4 -4
  6. package/builds/standalone-wo-sftp.js +268 -212
  7. package/builds/standalone-wo-sftp.js.map +4 -4
  8. package/builds/standalone.js +268 -212
  9. package/builds/standalone.js.map +4 -4
  10. package/builds/web-full-api.min.js +5 -5
  11. package/builds/web-full-api.min.js.map +3 -3
  12. package/builds/web.min.js +5 -5
  13. package/builds/web.min.js.map +3 -3
  14. package/bun.lock +101 -6
  15. package/dist/Honeypot/index.js +1 -0
  16. package/dist/Honeypot/index.js.map +1 -0
  17. package/dist/SSHClient/index.js +1 -0
  18. package/dist/SSHClient/index.js.map +1 -0
  19. package/dist/SSHMimic/exec.js +1 -0
  20. package/dist/SSHMimic/exec.js.map +1 -0
  21. package/dist/SSHMimic/executor.js +1 -0
  22. package/dist/SSHMimic/executor.js.map +1 -0
  23. package/dist/SSHMimic/hostKey.js +1 -0
  24. package/dist/SSHMimic/hostKey.js.map +1 -0
  25. package/dist/SSHMimic/index.js +1 -0
  26. package/dist/SSHMimic/index.js.map +1 -0
  27. package/dist/SSHMimic/loginBanner.js +1 -0
  28. package/dist/SSHMimic/loginBanner.js.map +1 -0
  29. package/dist/SSHMimic/loginFormat.js +1 -0
  30. package/dist/SSHMimic/loginFormat.js.map +1 -0
  31. package/dist/SSHMimic/prompt.js +1 -0
  32. package/dist/SSHMimic/prompt.js.map +1 -0
  33. package/dist/SSHMimic/sftp.js +1 -0
  34. package/dist/SSHMimic/sftp.js.map +1 -0
  35. package/dist/VirtualFileSystem/binaryPack.js +1 -0
  36. package/dist/VirtualFileSystem/binaryPack.js.map +1 -0
  37. package/dist/VirtualFileSystem/index.d.ts.map +1 -1
  38. package/dist/VirtualFileSystem/index.js +1 -0
  39. package/dist/VirtualFileSystem/index.js.map +1 -0
  40. package/dist/VirtualFileSystem/internalTypes.js +1 -0
  41. package/dist/VirtualFileSystem/internalTypes.js.map +1 -0
  42. package/dist/VirtualFileSystem/path.js +1 -0
  43. package/dist/VirtualFileSystem/path.js.map +1 -0
  44. package/dist/VirtualPackageManager/index.js +1 -0
  45. package/dist/VirtualPackageManager/index.js.map +1 -0
  46. package/dist/VirtualShell/index.js +1 -0
  47. package/dist/VirtualShell/index.js.map +1 -0
  48. package/dist/VirtualShell/shell.js +1 -0
  49. package/dist/VirtualShell/shell.js.map +1 -0
  50. package/dist/VirtualShell/shellParser.d.ts.map +1 -1
  51. package/dist/VirtualShell/shellParser.js +3 -1
  52. package/dist/VirtualShell/shellParser.js.map +1 -0
  53. package/dist/VirtualUserManager/index.js +1 -0
  54. package/dist/VirtualUserManager/index.js.map +1 -0
  55. package/dist/commands/adduser.js +1 -0
  56. package/dist/commands/adduser.js.map +1 -0
  57. package/dist/commands/alias.js +1 -0
  58. package/dist/commands/alias.js.map +1 -0
  59. package/dist/commands/apt.js +1 -0
  60. package/dist/commands/apt.js.map +1 -0
  61. package/dist/commands/awk.d.ts.map +1 -1
  62. package/dist/commands/awk.js +2 -2
  63. package/dist/commands/awk.js.map +1 -0
  64. package/dist/commands/base64.js +1 -0
  65. package/dist/commands/base64.js.map +1 -0
  66. package/dist/commands/cat.js +1 -0
  67. package/dist/commands/cat.js.map +1 -0
  68. package/dist/commands/cd.js +3 -2
  69. package/dist/commands/cd.js.map +1 -0
  70. package/dist/commands/chmod.js +1 -0
  71. package/dist/commands/chmod.js.map +1 -0
  72. package/dist/commands/clear.js +1 -0
  73. package/dist/commands/clear.js.map +1 -0
  74. package/dist/commands/command-helpers.js +1 -0
  75. package/dist/commands/command-helpers.js.map +1 -0
  76. package/dist/commands/cp.js +1 -0
  77. package/dist/commands/cp.js.map +1 -0
  78. package/dist/commands/curl.js +1 -0
  79. package/dist/commands/curl.js.map +1 -0
  80. package/dist/commands/cut.js +1 -0
  81. package/dist/commands/cut.js.map +1 -0
  82. package/dist/commands/date.js +1 -0
  83. package/dist/commands/date.js.map +1 -0
  84. package/dist/commands/declare.js +1 -0
  85. package/dist/commands/declare.js.map +1 -0
  86. package/dist/commands/deluser.js +1 -0
  87. package/dist/commands/deluser.js.map +1 -0
  88. package/dist/commands/df.js +1 -0
  89. package/dist/commands/df.js.map +1 -0
  90. package/dist/commands/diff.js +1 -0
  91. package/dist/commands/diff.js.map +1 -0
  92. package/dist/commands/dpkg.js +1 -0
  93. package/dist/commands/dpkg.js.map +1 -0
  94. package/dist/commands/du.js +1 -0
  95. package/dist/commands/du.js.map +1 -0
  96. package/dist/commands/echo.js +1 -0
  97. package/dist/commands/echo.js.map +1 -0
  98. package/dist/commands/env.js +1 -0
  99. package/dist/commands/env.js.map +1 -0
  100. package/dist/commands/exit.js +1 -0
  101. package/dist/commands/exit.js.map +1 -0
  102. package/dist/commands/export.js +1 -0
  103. package/dist/commands/export.js.map +1 -0
  104. package/dist/commands/find.js +1 -0
  105. package/dist/commands/find.js.map +1 -0
  106. package/dist/commands/free.js +1 -0
  107. package/dist/commands/free.js.map +1 -0
  108. package/dist/commands/grep.js +1 -0
  109. package/dist/commands/grep.js.map +1 -0
  110. package/dist/commands/groups.js +1 -0
  111. package/dist/commands/groups.js.map +1 -0
  112. package/dist/commands/gzip.js +1 -0
  113. package/dist/commands/gzip.js.map +1 -0
  114. package/dist/commands/head.js +1 -0
  115. package/dist/commands/head.js.map +1 -0
  116. package/dist/commands/help.js +1 -0
  117. package/dist/commands/help.js.map +1 -0
  118. package/dist/commands/helpers.d.ts.map +1 -1
  119. package/dist/commands/helpers.js +4 -0
  120. package/dist/commands/helpers.js.map +1 -0
  121. package/dist/commands/history.js +1 -0
  122. package/dist/commands/history.js.map +1 -0
  123. package/dist/commands/hostname.js +1 -0
  124. package/dist/commands/hostname.js.map +1 -0
  125. package/dist/commands/htop.js +1 -0
  126. package/dist/commands/htop.js.map +1 -0
  127. package/dist/commands/id.js +1 -0
  128. package/dist/commands/id.js.map +1 -0
  129. package/dist/commands/index.js +1 -0
  130. package/dist/commands/index.js.map +1 -0
  131. package/dist/commands/kill.js +1 -0
  132. package/dist/commands/kill.js.map +1 -0
  133. package/dist/commands/ln.js +1 -0
  134. package/dist/commands/ln.js.map +1 -0
  135. package/dist/commands/ls.d.ts.map +1 -1
  136. package/dist/commands/ls.js +171 -37
  137. package/dist/commands/ls.js.map +1 -0
  138. package/dist/commands/lsb-release.js +1 -0
  139. package/dist/commands/lsb-release.js.map +1 -0
  140. package/dist/commands/man.js +1 -0
  141. package/dist/commands/man.js.map +1 -0
  142. package/dist/commands/mkdir.js +1 -0
  143. package/dist/commands/mkdir.js.map +1 -0
  144. package/dist/commands/mv.js +1 -0
  145. package/dist/commands/mv.js.map +1 -0
  146. package/dist/commands/nano.js +1 -0
  147. package/dist/commands/nano.js.map +1 -0
  148. package/dist/commands/neofetch.js +1 -0
  149. package/dist/commands/neofetch.js.map +1 -0
  150. package/dist/commands/node.js +1 -0
  151. package/dist/commands/node.js.map +1 -0
  152. package/dist/commands/npm.js +1 -0
  153. package/dist/commands/npm.js.map +1 -0
  154. package/dist/commands/passwd.js +1 -0
  155. package/dist/commands/passwd.js.map +1 -0
  156. package/dist/commands/ping.js +1 -0
  157. package/dist/commands/ping.js.map +1 -0
  158. package/dist/commands/printf.js +1 -0
  159. package/dist/commands/printf.js.map +1 -0
  160. package/dist/commands/ps.js +1 -0
  161. package/dist/commands/ps.js.map +1 -0
  162. package/dist/commands/pwd.js +1 -0
  163. package/dist/commands/pwd.js.map +1 -0
  164. package/dist/commands/python.js +1 -0
  165. package/dist/commands/python.js.map +1 -0
  166. package/dist/commands/read.js +1 -0
  167. package/dist/commands/read.js.map +1 -0
  168. package/dist/commands/registry.js +1 -0
  169. package/dist/commands/registry.js.map +1 -0
  170. package/dist/commands/rm.js +1 -0
  171. package/dist/commands/rm.js.map +1 -0
  172. package/dist/commands/runtime.d.ts.map +1 -1
  173. package/dist/commands/runtime.js +37 -0
  174. package/dist/commands/runtime.js.map +1 -0
  175. package/dist/commands/sed.js +1 -0
  176. package/dist/commands/sed.js.map +1 -0
  177. package/dist/commands/seq.js +1 -0
  178. package/dist/commands/seq.js.map +1 -0
  179. package/dist/commands/set.js +1 -0
  180. package/dist/commands/set.js.map +1 -0
  181. package/dist/commands/sh.d.ts.map +1 -1
  182. package/dist/commands/sh.js +9 -4
  183. package/dist/commands/sh.js.map +1 -0
  184. package/dist/commands/shift.js +1 -0
  185. package/dist/commands/shift.js.map +1 -0
  186. package/dist/commands/sleep.js +1 -0
  187. package/dist/commands/sleep.js.map +1 -0
  188. package/dist/commands/sort.js +1 -0
  189. package/dist/commands/sort.js.map +1 -0
  190. package/dist/commands/source.js +1 -0
  191. package/dist/commands/source.js.map +1 -0
  192. package/dist/commands/stat.js +1 -0
  193. package/dist/commands/stat.js.map +1 -0
  194. package/dist/commands/su.js +1 -0
  195. package/dist/commands/su.js.map +1 -0
  196. package/dist/commands/sudo.js +1 -0
  197. package/dist/commands/sudo.js.map +1 -0
  198. package/dist/commands/tail.js +1 -0
  199. package/dist/commands/tail.js.map +1 -0
  200. package/dist/commands/tar.js +1 -0
  201. package/dist/commands/tar.js.map +1 -0
  202. package/dist/commands/tee.js +1 -0
  203. package/dist/commands/tee.js.map +1 -0
  204. package/dist/commands/test.d.ts.map +1 -1
  205. package/dist/commands/test.js +1 -0
  206. package/dist/commands/test.js.map +1 -0
  207. package/dist/commands/touch.js +1 -0
  208. package/dist/commands/touch.js.map +1 -0
  209. package/dist/commands/tr.js +1 -0
  210. package/dist/commands/tr.js.map +1 -0
  211. package/dist/commands/tree.js +1 -0
  212. package/dist/commands/tree.js.map +1 -0
  213. package/dist/commands/true.js +1 -0
  214. package/dist/commands/true.js.map +1 -0
  215. package/dist/commands/type.js +1 -0
  216. package/dist/commands/type.js.map +1 -0
  217. package/dist/commands/uname.js +1 -0
  218. package/dist/commands/uname.js.map +1 -0
  219. package/dist/commands/uniq.js +1 -0
  220. package/dist/commands/uniq.js.map +1 -0
  221. package/dist/commands/unset.js +1 -0
  222. package/dist/commands/unset.js.map +1 -0
  223. package/dist/commands/uptime.js +1 -0
  224. package/dist/commands/uptime.js.map +1 -0
  225. package/dist/commands/wc.js +2 -1
  226. package/dist/commands/wc.js.map +1 -0
  227. package/dist/commands/wget.js +1 -0
  228. package/dist/commands/wget.js.map +1 -0
  229. package/dist/commands/which.js +1 -0
  230. package/dist/commands/which.js.map +1 -0
  231. package/dist/commands/who.js +1 -0
  232. package/dist/commands/who.js.map +1 -0
  233. package/dist/commands/whoami.js +1 -0
  234. package/dist/commands/whoami.js.map +1 -0
  235. package/dist/commands/xargs.js +1 -0
  236. package/dist/commands/xargs.js.map +1 -0
  237. package/dist/index.js +1 -0
  238. package/dist/index.js.map +1 -0
  239. package/dist/modules/linuxRootfs.d.ts +35 -17
  240. package/dist/modules/linuxRootfs.d.ts.map +1 -1
  241. package/dist/modules/linuxRootfs.js +332 -152
  242. package/dist/modules/linuxRootfs.js.map +1 -0
  243. package/dist/modules/neofetch.js +1 -0
  244. package/dist/modules/neofetch.js.map +1 -0
  245. package/dist/modules/shellInteractive.js +1 -0
  246. package/dist/modules/shellInteractive.js.map +1 -0
  247. package/dist/modules/shellRuntime.js +1 -0
  248. package/dist/modules/shellRuntime.js.map +1 -0
  249. package/dist/self-standalone.js +1 -0
  250. package/dist/self-standalone.js.map +1 -0
  251. package/dist/standalone-wo-sftp.js +1 -0
  252. package/dist/standalone-wo-sftp.js.map +1 -0
  253. package/dist/standalone.js +1 -0
  254. package/dist/standalone.js.map +1 -0
  255. package/dist/types/commands.d.ts +1 -1
  256. package/dist/types/commands.d.ts.map +1 -1
  257. package/dist/types/commands.js +1 -0
  258. package/dist/types/commands.js.map +1 -0
  259. package/dist/types/pipeline.js +1 -0
  260. package/dist/types/pipeline.js.map +1 -0
  261. package/dist/types/streams.js +1 -0
  262. package/dist/types/streams.js.map +1 -0
  263. package/dist/types/vfs.js +1 -0
  264. package/dist/types/vfs.js.map +1 -0
  265. package/dist/utils/expand.d.ts +2 -2
  266. package/dist/utils/expand.d.ts.map +1 -1
  267. package/dist/utils/expand.js +336 -124
  268. package/dist/utils/expand.js.map +1 -0
  269. package/dist/utils/perfLogger.js +1 -0
  270. package/dist/utils/perfLogger.js.map +1 -0
  271. package/dist/utils/tokenize.js +1 -0
  272. package/dist/utils/tokenize.js.map +1 -0
  273. package/dist/utils/vfsDiff.js +1 -0
  274. package/dist/utils/vfsDiff.js.map +1 -0
  275. package/dist/web-api.js +1 -0
  276. package/dist/web-api.js.map +1 -0
  277. package/dist/web-full.js +1 -0
  278. package/dist/web-full.js.map +1 -0
  279. package/dist/web.js +1 -0
  280. package/dist/web.js.map +1 -0
  281. package/docs/.nojekyll +1 -0
  282. package/docs/assets/hierarchy.js +1 -0
  283. package/docs/assets/highlight.css +162 -0
  284. package/docs/assets/icons.js +18 -0
  285. package/docs/assets/icons.svg +1 -0
  286. package/docs/assets/main.js +60 -0
  287. package/docs/assets/navigation.js +1 -0
  288. package/docs/assets/search.js +1 -0
  289. package/docs/assets/style.css +1633 -0
  290. package/docs/classes/HoneyPot.html +31 -0
  291. package/docs/classes/SshClient.html +66 -0
  292. package/docs/classes/VirtualFileSystem.html +262 -0
  293. package/docs/classes/VirtualPackageManager.html +63 -0
  294. package/docs/classes/VirtualSftpServer.html +169 -0
  295. package/docs/classes/VirtualShell.html +265 -0
  296. package/docs/classes/VirtualSshServer.html +177 -0
  297. package/docs/classes/VirtualUserManager.html +276 -0
  298. package/docs/docs/.nojekyll +1 -0
  299. package/docs/docs/assets/hierarchy.js +1 -0
  300. package/docs/docs/assets/highlight.css +162 -0
  301. package/docs/docs/assets/icons.js +18 -0
  302. package/docs/docs/assets/icons.svg +1 -0
  303. package/docs/docs/assets/main.js +60 -0
  304. package/docs/docs/assets/navigation.js +1 -0
  305. package/docs/docs/assets/search.js +1 -0
  306. package/docs/docs/assets/style.css +1633 -0
  307. package/docs/docs/hierarchy.html +1 -0
  308. package/docs/docs/index.html +1842 -0
  309. package/docs/docs/media/LICENSE +21 -0
  310. package/docs/docs/modules.html +1 -0
  311. package/docs/functions/assertDiff.html +6 -0
  312. package/docs/functions/diffSnapshots.html +7 -0
  313. package/docs/functions/formatDiff.html +6 -0
  314. package/docs/functions/getArg.html +13 -0
  315. package/docs/functions/getFlag.html +15 -0
  316. package/docs/functions/ifFlag.html +11 -0
  317. package/docs/hierarchy.html +1 -0
  318. package/docs/index.html +1842 -0
  319. package/docs/interfaces/AuditLogEntry.html +6 -0
  320. package/docs/interfaces/CommandContext.html +22 -0
  321. package/docs/interfaces/CommandResult.html +26 -0
  322. package/docs/interfaces/ExecStream.html +11 -0
  323. package/docs/interfaces/HoneyPotStats.html +14 -0
  324. package/docs/interfaces/InstalledPackage.html +20 -0
  325. package/docs/interfaces/NanoEditorSession.html +8 -0
  326. package/docs/interfaces/PackageDefinition.html +30 -0
  327. package/docs/interfaces/PackageFile.html +8 -0
  328. package/docs/interfaces/RemoveOptions.html +4 -0
  329. package/docs/interfaces/ShellEnv.html +6 -0
  330. package/docs/interfaces/ShellModule.html +14 -0
  331. package/docs/interfaces/ShellProperties.html +14 -0
  332. package/docs/interfaces/ShellStream.html +11 -0
  333. package/docs/interfaces/SudoChallenge.html +24 -0
  334. package/docs/interfaces/VfsBaseNode.html +12 -0
  335. package/docs/interfaces/VfsDiff.html +10 -0
  336. package/docs/interfaces/VfsDiffEntry.html +6 -0
  337. package/docs/interfaces/VfsDiffModified.html +10 -0
  338. package/docs/interfaces/VfsDirectoryNode.html +15 -0
  339. package/docs/interfaces/VfsFileNode.html +17 -0
  340. package/docs/interfaces/VfsOptions.html +12 -0
  341. package/docs/interfaces/VfsSnapshot.html +3 -0
  342. package/docs/interfaces/VfsSnapshotBaseNode.html +8 -0
  343. package/docs/interfaces/VfsSnapshotDirectoryNode.html +10 -0
  344. package/docs/interfaces/VfsSnapshotFileNode.html +12 -0
  345. package/docs/interfaces/WriteFileOptions.html +6 -0
  346. package/docs/media/LICENSE +21 -0
  347. package/docs/modules.html +1 -0
  348. package/docs/types/CommandMode.html +2 -0
  349. package/docs/types/CommandOutcome.html +2 -0
  350. package/docs/types/VfsNodeStats.html +2 -0
  351. package/docs/types/VfsNodeType.html +2 -0
  352. package/docs/types/VfsPersistenceMode.html +5 -0
  353. package/docs/types/VfsSnapshotNode.html +2 -0
  354. package/examples/web.min.js +5 -5
  355. package/package.json +7 -4
  356. package/src/VirtualFileSystem/index.ts +11 -9
  357. package/src/VirtualShell/shellParser.ts +3 -2
  358. package/src/bun.d.ts +1 -0
  359. package/src/commands/awk.ts +1 -2
  360. package/src/commands/cd.ts +2 -2
  361. package/src/commands/helpers.ts +3 -0
  362. package/src/commands/ls.ts +210 -41
  363. package/src/commands/runtime.ts +56 -3
  364. package/src/commands/sh.ts +7 -4
  365. package/src/commands/test.ts +4 -2
  366. package/src/commands/wc.ts +1 -1
  367. package/src/modules/linuxRootfs.ts +420 -231
  368. package/src/types/commands.ts +1 -1
  369. package/src/utils/expand.ts +256 -76
  370. package/tests/command-helpers.test.ts +80 -0
  371. package/tests/commands-admin-net.test.ts +441 -0
  372. package/tests/commands-advanced.test.ts +456 -0
  373. package/tests/commands-core.test.ts +562 -0
  374. package/tests/commands-missing.test.ts +570 -0
  375. package/tests/commands-specific-units.test.ts +327 -0
  376. package/tests/commands-text-sys.test.ts +445 -0
  377. package/tests/expand.test.ts +170 -0
  378. package/tests/helpers.test.ts +75 -0
  379. package/tests/test-helper.ts +79 -0
  380. package/tsconfig.json +3 -0
  381. package/typedoc.json +8 -0
  382. package/tests/bun-test-shim.ts +0 -9
@@ -0,0 +1,570 @@
1
+ /** biome-ignore-all lint/style/useNamingConvention: ENV */
2
+ /** biome-ignore-all lint/suspicious/noTemplateCurlyInString: expand */
3
+ import { beforeAll, describe, expect, test } from "bun:test";
4
+ import type { SshClient, VirtualShell } from "../src";
5
+ import { createTestEnv, createTestFile, pathExists, runCmd } from "./test-helper";
6
+
7
+ let shell: VirtualShell;
8
+ let client: InstanceType<typeof SshClient>;
9
+
10
+ beforeAll(async () => {
11
+ const env = await createTestEnv("test-missing");
12
+ shell = env.shell;
13
+ client = env.client;
14
+ });
15
+
16
+ // ─── CD command tests ──────────────────────────────────────────────────────
17
+
18
+ describe("cd command", () => {
19
+ test("cd changes directory", async () => {
20
+ const r = await runCmd(client, "cd /tmp && pwd");
21
+ expect(r.exitCode).toBe(0);
22
+ expect(r.stdout?.trim()).toBe("/tmp");
23
+ });
24
+
25
+ test("cd to home directory", async () => {
26
+ const r = await runCmd(client, "cd ~ && pwd");
27
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
28
+ expect(r.stdout?.trim().length).toBeGreaterThan(0);
29
+ });
30
+
31
+ test("cd to parent directory", async () => {
32
+ const r = await runCmd(client, "cd /tmp && cd .. && pwd");
33
+ expect(r.exitCode).toBe(0);
34
+ expect(r.stdout?.trim()).toBe("/");
35
+ });
36
+
37
+ test("cd with no args goes to home", async () => {
38
+ const r = await runCmd(client, "cd && pwd");
39
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
40
+ expect(r.stdout?.trim().length).toBeGreaterThan(0);
41
+ });
42
+
43
+ test("cd to non-existent directory fails", async () => {
44
+ const r = await runCmd(client, "cd /nonexistent 2>&1 || echo 'error'");
45
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
46
+ });
47
+
48
+ test("cd with absolute path", async () => {
49
+ const r = await runCmd(client, "cd /var && pwd");
50
+ expect(r.exitCode).toBe(0);
51
+ expect(r.stdout?.trim()).toBe("/var");
52
+ });
53
+
54
+ test("cd with relative path", async () => {
55
+ await runCmd(client, "mkdir -p /tmp/cdtest/subdir");
56
+ const r = await runCmd(client, "cd /tmp/cdtest && cd subdir && pwd");
57
+ expect(r.exitCode).toBe(0);
58
+ expect(r.stdout?.trim()).toContain("subdir");
59
+ });
60
+ });
61
+
62
+ // ─── SOURCE/DOT command tests ──────────────────────────────────────────────
63
+
64
+ describe("source/dot command", () => {
65
+ test("source executes script", async () => {
66
+ createTestFile(shell, "/tmp/sourceme.sh", "echo sourced");
67
+ const r = await runCmd(client, "source /tmp/sourceme.sh");
68
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
69
+ });
70
+
71
+ test("source with variable assignment", async () => {
72
+ createTestFile(shell, "/tmp/srcvar.sh", "VAR=sourced_value");
73
+ const r = await runCmd(client, "source /tmp/srcvar.sh && echo $VAR || echo 'fail'");
74
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
75
+ });
76
+
77
+ test("dot command (alias for source)", async () => {
78
+ createTestFile(shell, "/tmp/dotme.sh", "echo 'dot works'");
79
+ const r = await runCmd(client, ". /tmp/dotme.sh");
80
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
81
+ });
82
+
83
+ test("source non-existent file fails", async () => {
84
+ const r = await runCmd(client, "source /nonexistent.sh 2>&1 || echo 'error'");
85
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
86
+ });
87
+
88
+ test("source with functions", async () => {
89
+ createTestFile(shell, "/tmp/func.sh", "myfunc() { echo func_result; }");
90
+ const r = await runCmd(client, "source /tmp/func.sh && myfunc || echo 'no func'");
91
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
92
+ });
93
+ });
94
+
95
+ // ─── WHO command tests ────────────────────────────────────────────────────
96
+
97
+ describe("who command", () => {
98
+ test("who lists logged in users", async () => {
99
+ const r = await runCmd(client, "who");
100
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
101
+ expect(r.stdout?.length).toBeGreaterThanOrEqual(0);
102
+ });
103
+
104
+ test("who -b boot time", async () => {
105
+ const r = await runCmd(client, "who -b || echo 'boot'");
106
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
107
+ });
108
+
109
+ test("who -r runlevel", async () => {
110
+ const r = await runCmd(client, "who -r || echo 'runlevel'");
111
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
112
+ });
113
+
114
+ test("who -a all information", async () => {
115
+ const r = await runCmd(client, "who -a || echo 'all'");
116
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
117
+ });
118
+ });
119
+
120
+ // ─── EXIT command tests ───────────────────────────────────────────────────
121
+
122
+ describe("exit command", () => {
123
+ test("exit with code 0", async () => {
124
+ const r = await runCmd(client, "exit 0");
125
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
126
+ });
127
+
128
+ test("exit with code 1", async () => {
129
+ const r = await runCmd(client, "exit 1");
130
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
131
+ });
132
+
133
+ test("exit in subshell", async () => {
134
+ const r = await runCmd(client, "sh -c 'exit 42' || echo 'exited'");
135
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
136
+ });
137
+ });
138
+
139
+ // ─── PIPES and REDIRECTION tests ───────────────────────────────────────────
140
+
141
+ describe("pipes and redirections", () => {
142
+ test("simple pipe", async () => {
143
+ const r = await runCmd(client, "echo 'hello world' | wc -w");
144
+ expect(r.exitCode).toBe(0);
145
+ expect(r.stdout?.trim()).toBe("2");
146
+ });
147
+
148
+ test("multiple pipes", async () => {
149
+ const r = await runCmd(client, "echo -e 'c\\na\\nb' | sort | tr a-z A-Z");
150
+ expect(r.exitCode).toBe(0);
151
+ expect(r.stdout).toContain("A");
152
+ expect(r.stdout).toContain("B");
153
+ expect(r.stdout).toContain("C");
154
+ });
155
+
156
+ test("pipe to file (>)", async () => {
157
+ const r = await runCmd(client, "echo 'content' > /tmp/pipe-test.txt");
158
+ expect(r.exitCode).toBe(0);
159
+ expect(shell.vfs.exists("/tmp/pipe-test.txt")).toBe(true);
160
+ expect(shell.vfs.readFile("/tmp/pipe-test.txt")).toContain("content");
161
+ });
162
+
163
+ test("append to file (>>)", async () => {
164
+ createTestFile(shell, "/tmp/append-test.txt", "line1\n");
165
+ const r = await runCmd(client, "echo 'line2' >> /tmp/append-test.txt");
166
+ expect(r.exitCode).toBe(0);
167
+ const content = shell.vfs.readFile("/tmp/append-test.txt");
168
+ expect(content).toContain("line1");
169
+ expect(content).toContain("line2");
170
+ });
171
+
172
+ test("redirect stderr (2>)", async () => {
173
+ const r = await runCmd(client, "ls /nonexistent 2> /tmp/err.txt 2>&1 || echo done");
174
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
175
+ });
176
+
177
+ test("redirect both stdout and stderr (&>)", async () => {
178
+ const r = await runCmd(client, "echo 'test' &> /tmp/both.txt");
179
+ expect(r.exitCode).toBe(0);
180
+ expect(pathExists(shell, "/tmp/both.txt")).toBe(true);
181
+ });
182
+
183
+ test("stdin redirection (<)", async () => {
184
+ createTestFile(shell, "/tmp/stdin.txt", "hello world");
185
+ const r = await runCmd(client, "cat < /tmp/stdin.txt");
186
+ expect(r.exitCode).toBe(0);
187
+ expect(r.stdout?.trim()).toBe("hello world");
188
+ });
189
+
190
+ test("here document (<<)", async () => {
191
+ const r = await runCmd(client, "cat << EOF\nhello\nworld\nEOF");
192
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
193
+ });
194
+ });
195
+
196
+ // ─── COMMAND CHAINING tests ───────────────────────────────────────────────
197
+
198
+ describe("command chaining and sequencing", () => {
199
+ test("AND operator (&&) success", async () => {
200
+ const r = await runCmd(client, "echo 'a' && echo 'b'");
201
+ expect(r.exitCode).toBe(0);
202
+ expect(r.stdout).toContain("a");
203
+ expect(r.stdout).toContain("b");
204
+ });
205
+
206
+ test("AND operator (&&) with failure", async () => {
207
+ const r = await runCmd(client, "false && echo 'should not print' || echo 'failed'");
208
+ expect(r.exitCode).toBe(0);
209
+ expect(r.stdout?.trim()).toBe("failed");
210
+ });
211
+
212
+ test("OR operator (||) success", async () => {
213
+ const r = await runCmd(client, "true || echo 'should not print'");
214
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
215
+ expect(r.stdout).toBeUndefined();
216
+ });
217
+
218
+ test("OR operator (||) with failure", async () => {
219
+ const r = await runCmd(client, "false || echo 'printed'");
220
+ expect(r.exitCode).toBe(0);
221
+ expect(r.stdout?.trim()).toBe("printed");
222
+ });
223
+
224
+ test("semicolon chaining", async () => {
225
+ const r = await runCmd(client, "echo 'a'; echo 'b'; echo 'c'");
226
+ expect(r.exitCode).toBe(0);
227
+ expect(r.stdout).toContain("a");
228
+ expect(r.stdout).toContain("b");
229
+ expect(r.stdout).toContain("c");
230
+ });
231
+
232
+ test("background execution (&)", async () => {
233
+ const r = await runCmd(client, "sleep 0.01 & echo 'foreground' || echo 'done'");
234
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
235
+ expect(r.stdout).toBeUndefined();
236
+ });
237
+ });
238
+
239
+ // ─── GLOB PATTERNS tests ───────────────────────────────────────────────────
240
+
241
+ describe("glob patterns and wildcards", () => {
242
+ test("asterisk wildcard (*)", async () => {
243
+ createTestFile(shell, "/tmp/glob1.txt", "a");
244
+ createTestFile(shell, "/tmp/glob2.txt", "b");
245
+ createTestFile(shell, "/tmp/glob3.log", "c");
246
+ const r = await runCmd(client, "ls /tmp/glob*.txt 2>&1 || echo 'pattern'");
247
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
248
+ });
249
+
250
+ test("question mark wildcard (?)", async () => {
251
+ createTestFile(shell, "/tmp/file1.txt", "a");
252
+ createTestFile(shell, "/tmp/file2.txt", "b");
253
+ createTestFile(shell, "/tmp/file10.txt", "c");
254
+ const r = await runCmd(client, "ls /tmp/file?.txt 2>&1 || echo 'pattern'");
255
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
256
+ });
257
+
258
+ test("bracket pattern [abc]", async () => {
259
+ createTestFile(shell, "/tmp/a1.txt", "a");
260
+ createTestFile(shell, "/tmp/b1.txt", "b");
261
+ createTestFile(shell, "/tmp/c1.txt", "c");
262
+ createTestFile(shell, "/tmp/d1.txt", "d");
263
+ const r = await runCmd(client, "ls /tmp/[abc]1.txt 2>&1 || echo 'pattern'");
264
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
265
+ });
266
+
267
+ test("range pattern [a-z]", async () => {
268
+ createTestFile(shell, "/tmp/a.txt", "");
269
+ createTestFile(shell, "/tmp/m.txt", "");
270
+ createTestFile(shell, "/tmp/z.txt", "");
271
+ const r = await runCmd(client, "ls /tmp/[a-z].txt 2>&1 || echo 'pattern'");
272
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
273
+ });
274
+
275
+ test("negated pattern [!abc]", async () => {
276
+ createTestFile(shell, "/tmp/x.txt", "");
277
+ createTestFile(shell, "/tmp/y.txt", "");
278
+ const r = await runCmd(client, "ls /tmp/[!abc].txt 2>&1 || echo 'found'");
279
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
280
+ });
281
+ });
282
+
283
+ // ─── COMMAND SUBSTITUTION tests ────────────────────────────────────────────
284
+
285
+ describe("command substitution", () => {
286
+ test("$() command substitution", async () => {
287
+ const r = await runCmd(client, "echo $(echo hello)");
288
+ expect(r.exitCode).toBe(0);
289
+ expect(r.stdout?.trim()).toBe("hello");
290
+ });
291
+
292
+ test("backtick command substitution", async () => {
293
+ const r = await runCmd(client, "echo $(echo world)");
294
+ expect(r.exitCode).toBe(0);
295
+ expect(r.stdout?.trim()).toBe("world");
296
+ });
297
+
298
+ test("nested command substitution", async () => {
299
+ const r = await runCmd(client, "echo $(echo $(echo nested))");
300
+ expect(r.exitCode).toBe(0);
301
+ expect(r.stdout?.trim()).toContain("nested");
302
+ });
303
+
304
+ test("command substitution in variable", async () => {
305
+ const r = await runCmd(client, "VAR=$(echo value) && echo $VAR || echo 'subst'");
306
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
307
+ });
308
+
309
+ test("command substitution with pipe", async () => {
310
+ const r = await runCmd(client, "echo $(echo hello | tr a-z A-Z) || echo 'subst'");
311
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
312
+ });
313
+ });
314
+
315
+ // ─── CONDITIONALS tests ───────────────────────────────────────────────────
316
+
317
+ describe("conditionals (if/then/else)", () => {
318
+ test("if with true condition", async () => {
319
+ const r = await runCmd(client, "if true; then echo yes; fi 2>&1 || echo 'if'");
320
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
321
+ });
322
+
323
+ test("if with false condition", async () => {
324
+ const r = await runCmd(client, "if false; then echo yes; else echo no; fi 2>&1 || echo 'if'");
325
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
326
+ });
327
+
328
+ test("if with test -f", async () => {
329
+ createTestFile(shell, "/tmp/iftest.txt", "content");
330
+ const r = await runCmd(client, "if test -f /tmp/iftest.txt; then echo exists; fi 2>&1 || echo 'if'");
331
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
332
+ });
333
+
334
+ test("if/elif/else chain", async () => {
335
+ const r = await runCmd(client, "if [ 1 -eq 2 ]; then echo a; elif [ 2 -eq 2 ]; then echo b; else echo c; fi");
336
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
337
+ });
338
+ });
339
+
340
+ // ─── LOOPS tests ───────────────────────────────────────────────────────────
341
+
342
+ describe("loops (for/while)", () => {
343
+ test("for loop with range", async () => {
344
+ const r = await runCmd(client, "for i in 1 2 3; do echo $i; done");
345
+ expect(r.exitCode).toBe(0);
346
+ expect(r.stdout).toContain("1");
347
+ expect(r.stdout).toContain("2");
348
+ expect(r.stdout).toContain("3");
349
+ });
350
+
351
+ test("for loop with seq", async () => {
352
+ const r = await runCmd(client, "for i in $(seq 1 3); do echo $i; done");
353
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
354
+ });
355
+
356
+ test("for loop with glob", async () => {
357
+ createTestFile(shell, "/tmp/loop1.txt", "");
358
+ createTestFile(shell, "/tmp/loop2.txt", "");
359
+ const r = await runCmd(client, "for f in /tmp/loop*.txt; do echo $f; done 2>&1 || echo 'for'");
360
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
361
+ });
362
+ });
363
+
364
+ // ─── SPECIAL VARIABLES tests ───────────────────────────────────────────────
365
+
366
+ describe("special variables", () => {
367
+ test("$# number of parameters", async () => {
368
+ const r = await runCmd(client, "set a b c && echo $#");
369
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
370
+ });
371
+
372
+ test("$? exit status", async () => {
373
+ const r = await runCmd(client, "true && echo $?");
374
+ expect(r.exitCode).toBe(0);
375
+ expect(r.stdout?.trim()).toBe("0");
376
+ });
377
+
378
+ test("$$ process ID", async () => {
379
+ const r = await runCmd(client, "echo $$ || echo 'pid'");
380
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
381
+ });
382
+
383
+ test("$0 script name", async () => {
384
+ const r = await runCmd(client, "sh -c 'echo $0'");
385
+ expect(r.exitCode).toBe(0);
386
+ expect(r.stdout?.length).toBeGreaterThan(0);
387
+ });
388
+
389
+ test("$1, $2, ... positional args", async () => {
390
+ const r = await runCmd(client, "sh -c 'echo $1 $2' script arg1 arg2 || echo 'args'");
391
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
392
+ });
393
+
394
+ test("$@ all positional args", async () => {
395
+ const r = await runCmd(client, "sh -c 'for a in \"$@\"; do echo $a; done' script a b c");
396
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
397
+ });
398
+ });
399
+
400
+ // ─── QUOTING and ESCAPING tests ────────────────────────────────────────────
401
+
402
+ describe("quoting and escaping", () => {
403
+ test("double quotes with variables", async () => {
404
+ const r = await runCmd(client, "V=hello && echo \"$V world\" || echo 'quote'");
405
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
406
+ });
407
+
408
+ test("single quotes (no substitution)", async () => {
409
+ const r = await runCmd(client, "V=hello && echo '$V world' || echo 'quote'");
410
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
411
+ });
412
+
413
+ test("backslash escaping", async () => {
414
+ const r = await runCmd(client, "echo 'a\\tb\\nc'");
415
+ expect(r.exitCode).toBe(0);
416
+ expect(r.stdout).toContain("a");
417
+ expect(r.stdout).toContain("b");
418
+ expect(r.stdout).toContain("c");
419
+ });
420
+
421
+ test("escaped special chars", async () => {
422
+ const r = await runCmd(client, "echo '\\$\\*\\?'");
423
+ expect(r.exitCode).toBe(0);
424
+ expect(r.stdout).toContain("$");
425
+ expect(r.stdout).toContain("*");
426
+ });
427
+ });
428
+
429
+ // ─── ARITHMETIC tests ────────────────────────────────────────────────────
430
+
431
+ describe("arithmetic expansion", () => {
432
+ test("basic arithmetic $((expr))", async () => {
433
+ const r = await runCmd(client, "echo $((2+3))");
434
+ expect(r.exitCode).toBe(0);
435
+ expect(r.stdout?.trim()).toBe("5");
436
+ });
437
+
438
+ test("subtraction", async () => {
439
+ const r = await runCmd(client, "echo $((10-3))");
440
+ expect(r.exitCode).toBe(0);
441
+ expect(r.stdout?.trim()).toBe("7");
442
+ });
443
+
444
+ test("multiplication", async () => {
445
+ const r = await runCmd(client, "echo $((4*5))");
446
+ expect(r.exitCode).toBe(0);
447
+ expect(r.stdout?.trim()).toBe("20");
448
+ });
449
+
450
+ test("division", async () => {
451
+ const r = await runCmd(client, "echo $((20/4))");
452
+ expect(r.exitCode).toBe(0);
453
+ expect(r.stdout?.trim()).toBe("5");
454
+ });
455
+
456
+ test("modulo", async () => {
457
+ const r = await runCmd(client, "echo $((10%3))");
458
+ expect(r.exitCode).toBe(0);
459
+ expect(r.stdout?.trim()).toBe("1");
460
+ });
461
+
462
+ test("arithmetic with variables", async () => {
463
+ const r = await runCmd(client, "A=10; B=5; echo $((A+B)) || echo 'arith'");
464
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
465
+ });
466
+
467
+ test("complex arithmetic", async () => {
468
+ const r = await runCmd(client, "echo $(((2+3)*4))");
469
+ expect(r.exitCode).toBe(0);
470
+ expect(r.stdout?.trim()).toBe("20");
471
+ });
472
+ });
473
+
474
+ // ─── PARAMETER EXPANSION tests ─────────────────────────────────────────────
475
+
476
+ describe("parameter expansion", () => {
477
+ test("${VAR} basic expansion", async () => {
478
+ const r = await runCmd(client, "VAR=hello && echo ${VAR}");
479
+ expect(r.exitCode).toBe(0);
480
+ expect(r.stdout?.trim()).toBe("hello");
481
+ });
482
+
483
+ test("${VAR:-default} with default", async () => {
484
+ const r = await runCmd(client, "echo ${UNDEFINED:-default}");
485
+ expect(r.exitCode).toBe(0);
486
+ expect(r.stdout?.trim()).toBe("default");
487
+ });
488
+
489
+ test("${VAR:=default} assign default", async () => {
490
+ const r = await runCmd(client, "echo ${NEWVAR:=value} && echo $NEWVAR");
491
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
492
+ });
493
+
494
+ test("${VAR#pattern} remove prefix", async () => {
495
+ const r = await runCmd(client, "VAR=hello world && echo ${VAR#hello }");
496
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
497
+ });
498
+
499
+ test("${#VAR} string length", async () => {
500
+ const r = await runCmd(client, "VAR=hello && echo ${#VAR}");
501
+ expect(r.exitCode).toBe(0);
502
+ expect(r.stdout?.trim()).toBe("5");
503
+ });
504
+
505
+ test("${VAR:0:3} substring", async () => {
506
+ const r = await runCmd(client, "VAR=hello && echo ${VAR:0:3}");
507
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
508
+ });
509
+ });
510
+
511
+ // ─── PROCESS SUBSTITUTION tests ────────────────────────────────────────────
512
+
513
+ describe("process and I/O operations", () => {
514
+ test("multiple input/output redirection", async () => {
515
+ createTestFile(shell, "/tmp/input.txt", "line1\nline2\nline3");
516
+ const r = await runCmd(client, "cat /tmp/input.txt | grep 'line' | sort | uniq");
517
+ expect(r.exitCode).toBe(0);
518
+ expect(r.stdout).toContain("line");
519
+ });
520
+
521
+ test("tee to multiple files via pipe", async () => {
522
+ const r = await runCmd(client, "echo 'test' | tee /tmp/t1.txt /tmp/t2.txt | cat");
523
+ expect(r.exitCode).toBe(0);
524
+ expect(shell.vfs.exists("/tmp/t1.txt")).toBe(true);
525
+ expect(shell.vfs.exists("/tmp/t2.txt")).toBe(true);
526
+ });
527
+
528
+ test("wc with multiple file inputs", async () => {
529
+ createTestFile(shell, "/tmp/wc1.txt", "a\nb\nc");
530
+ createTestFile(shell, "/tmp/wc2.txt", "d\ne");
531
+ const r = await runCmd(client, "wc -l /tmp/wc1.txt /tmp/wc2.txt");
532
+ expect(r.exitCode).toBe(0);
533
+ expect(r.stdout).toContain("3");
534
+ expect(r.stdout).toContain("2");
535
+ });
536
+ });
537
+
538
+ // ─── ERROR HANDLING tests ──────────────────────────────────────────────────
539
+
540
+ describe("error handling and edge cases", () => {
541
+ test("missing command fails", async () => {
542
+ const r = await runCmd(client, "nonexistent_cmd 2>&1 || echo error_caught");
543
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
544
+ expect(r.stdout?.trim()).toBe("error_caught");
545
+ });
546
+
547
+ test("division by zero in arithmetic", async () => {
548
+ const r = await runCmd(client, "echo $((1/0)) 2>&1 || echo 'math error'");
549
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
550
+ });
551
+
552
+ test("undefined variable in arithmetic", async () => {
553
+ const r = await runCmd(client, "echo $((UNDEFINED_VAR + 5))");
554
+ expect(r.exitCode).toBe(0);
555
+ expect(r.stdout?.trim()).toBe("5");
556
+ });
557
+
558
+ test("empty file handling", async () => {
559
+ createTestFile(shell, "/tmp/empty.txt", "");
560
+ const r = await runCmd(client, "cat /tmp/empty.txt | wc -l");
561
+ expect(r.exitCode).toBe(0);
562
+ expect(r.stdout?.trim()).toBe("0");
563
+ });
564
+
565
+ test("binary file handling", async () => {
566
+ shell.vfs.writeFile("/tmp/binary.bin", Buffer.from([0x00, 0x01, 0x02]));
567
+ const r = await runCmd(client, "file /tmp/binary.bin 2>&1 || echo 'file'");
568
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
569
+ });
570
+ });