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,562 @@
1
+ import { beforeAll, describe, expect, test } from "bun:test";
2
+ import type { SshClient, VirtualShell } from "../src";
3
+ import { createTestEnv, createTestFile, pathExists, readTestFile, runCmd } from "./test-helper";
4
+
5
+ let shell: VirtualShell;
6
+ let client: InstanceType<typeof SshClient>;
7
+
8
+ beforeAll(async () => {
9
+ const env = await createTestEnv("test-core");
10
+ shell = env.shell;
11
+ client = env.client;
12
+ });
13
+
14
+ // ─── ECHO tests ───────────────────────────────────────────────────────────
15
+
16
+ describe("echo command", () => {
17
+ test("echo basic output", async () => {
18
+ const r = await runCmd(client, "echo hello");
19
+ expect(r.exitCode).toBe(0);
20
+ expect(r.stdout?.trim()).toBe("hello");
21
+ });
22
+
23
+ test("echo multiple args", async () => {
24
+ const r = await runCmd(client, "echo hello world");
25
+ expect(r.exitCode).toBe(0);
26
+ expect(r.stdout?.trim()).toBe("hello world");
27
+ });
28
+
29
+ test("echo with -n flag (no newline)", async () => {
30
+ const r = await runCmd(client, "echo -n hello");
31
+ expect(r.exitCode).toBe(0);
32
+ expect(r.stdout).toBe("hello");
33
+ expect(r.stdout?.endsWith("\n")).toBe(false);
34
+ });
35
+
36
+ test("echo with -e flag (escape sequences)", async () => {
37
+ const r = await runCmd(client, "echo -e 'hello\\nworld'");
38
+ expect(r.exitCode).toBe(0);
39
+ expect(r.stdout).toContain("hello");
40
+ expect(r.stdout).toContain("world");
41
+ });
42
+
43
+ test("echo with -e and tab", async () => {
44
+ const r = await runCmd(client, "echo -e 'col1\\tcol2'");
45
+ expect(r.exitCode).toBe(0);
46
+ expect(r.stdout).toContain("\t");
47
+ });
48
+
49
+ test("echo with empty string", async () => {
50
+ const r = await runCmd(client, "echo ''");
51
+ expect(r.exitCode).toBe(0);
52
+ expect(r.stdout?.trim()).toBe("");
53
+ });
54
+
55
+ test("echo with special chars", async () => {
56
+ const r = await runCmd(client, "echo 'test@#$%'");
57
+ expect(r.exitCode).toBe(0);
58
+ expect(r.stdout).toContain("test@#$%");
59
+ });
60
+
61
+ test("echo with variables", async () => {
62
+ const r = await runCmd(client, "echo $HOME");
63
+ expect(r.exitCode).toBe(0);
64
+ expect(r.stdout?.trim()).toMatch(/home|root/);
65
+ });
66
+ });
67
+
68
+ // ─── PWD tests ────────────────────────────────────────────────────────────
69
+
70
+ describe("pwd command", () => {
71
+ test("pwd returns current directory", async () => {
72
+ const r = await runCmd(client, "pwd");
73
+ expect(r.exitCode).toBe(0);
74
+ expect(r.stdout?.trim()).toBeDefined();
75
+ expect(r.stdout?.trim().length).toBeGreaterThan(0);
76
+ });
77
+
78
+ test("pwd after cd", async () => {
79
+ await runCmd(client, "cd /tmp");
80
+ const r = await runCmd(client, "pwd");
81
+ expect(r.exitCode).toBe(0);
82
+ expect(r.stdout?.trim()).toBe("/tmp");
83
+ await runCmd(client, "cd /root");
84
+ });
85
+
86
+ test("pwd with no args", async () => {
87
+ const r = await runCmd(client, "pwd");
88
+ expect(r.exitCode).toBe(0);
89
+ expect(r.stdout?.length).toBeGreaterThan(0);
90
+ });
91
+ });
92
+
93
+ // ─── CAT tests ────────────────────────────────────────────────────────────
94
+
95
+ describe("cat command", () => {
96
+ test("cat single file", async () => {
97
+ createTestFile(shell, "/tmp/test.txt", "hello world");
98
+ const r = await runCmd(client, "cat /tmp/test.txt");
99
+ expect(r.exitCode).toBe(0);
100
+ expect(r.stdout?.trim()).toBe("hello world");
101
+ });
102
+
103
+ test("cat multiple files", async () => {
104
+ createTestFile(shell, "/tmp/file1.txt", "file1");
105
+ createTestFile(shell, "/tmp/file2.txt", "file2");
106
+ const r = await runCmd(client, "cat /tmp/file1.txt /tmp/file2.txt");
107
+ expect(r.exitCode).toBe(0);
108
+ expect(r.stdout).toContain("file1");
109
+ expect(r.stdout).toContain("file2");
110
+ });
111
+
112
+ test("cat with -n flag (line numbers)", async () => {
113
+ createTestFile(shell, "/tmp/numbered.txt", "line1\nline2\nline3");
114
+ const r = await runCmd(client, "cat -n /tmp/numbered.txt");
115
+ expect(r.exitCode).toBe(0);
116
+ expect(r.stdout).toContain("1");
117
+ expect(r.stdout).toContain("2");
118
+ expect(r.stdout).toContain("3");
119
+ });
120
+
121
+ test("cat with -b flag (number non-blank)", async () => {
122
+ createTestFile(shell, "/tmp/blank.txt", "line1\n\nline2");
123
+ const r = await runCmd(client, "cat -b /tmp/blank.txt");
124
+ expect(r.exitCode).toBe(0);
125
+ expect(r.stdout).toContain("line1");
126
+ expect(r.stdout).toContain("line2");
127
+ });
128
+
129
+ test("cat non-existent file", async () => {
130
+ const r = await runCmd(client, "cat /tmp/nonexistent.txt");
131
+ expect(r.exitCode).not.toBe(0);
132
+ expect(r.stderr).toBeDefined();
133
+ });
134
+
135
+ test("cat with stdin", async () => {
136
+ const r = await runCmd(client, "echo 'test' | cat");
137
+ expect(r.exitCode).toBe(0);
138
+ expect(r.stdout?.trim()).toBe("test");
139
+ });
140
+ });
141
+
142
+ // ─── LS tests ──────────────────────────────────────────────────────────────
143
+
144
+ describe("ls command", () => {
145
+ test("ls lists directory", async () => {
146
+ createTestFile(shell, "/tmp/ls-test1.txt", "content");
147
+ const r = await runCmd(client, "ls /tmp");
148
+ expect(r.exitCode).toBe(0);
149
+ expect(r.stdout).toContain("ls-test1.txt");
150
+ });
151
+
152
+ test("ls with -l flag (long format)", async () => {
153
+ createTestFile(shell, "/tmp/ls-long.txt", "test");
154
+ const r = await runCmd(client, "ls -l /tmp");
155
+ expect(r.exitCode).toBe(0);
156
+ expect(r.stdout).toContain("-rw");
157
+ });
158
+
159
+ test("ls current directory", async () => {
160
+ const r = await runCmd(client, "ls /root");
161
+ expect(r.exitCode).toBe(0);
162
+ expect(r.stdout?.length).toBeGreaterThanOrEqual(0);
163
+ });
164
+
165
+ test("ls with -a flag (show hidden)", async () => {
166
+ const r = await runCmd(client, "ls -a /root");
167
+ expect(r.exitCode).toBe(0);
168
+ expect(r.stdout?.length).toBeGreaterThanOrEqual(0);
169
+ });
170
+
171
+ test("ls with -h flag (human readable)", async () => {
172
+ createTestFile(shell, "/tmp/ls-human.txt", "a".repeat(1024));
173
+ const r = await runCmd(client, "ls -lh /tmp/ls-human.txt");
174
+ expect(r.exitCode).toBe(0);
175
+ expect(r.stdout).toContain("ls-human.txt");
176
+ });
177
+
178
+ test("ls non-existent path", async () => {
179
+ const r = await runCmd(client, "ls /nonexistent");
180
+ expect(r.exitCode).not.toBe(0);
181
+ });
182
+ });
183
+
184
+ // ─── MKDIR/RMDIR tests ────────────────────────────────────────────────────
185
+
186
+ describe("mkdir command", () => {
187
+ test("mkdir creates directory", async () => {
188
+ const r = await runCmd(client, "mkdir /tmp/testdir");
189
+ expect(r.exitCode).toBe(0);
190
+ expect(pathExists(shell, "/tmp/testdir")).toBe(true);
191
+ });
192
+
193
+ test("mkdir -p creates nested dirs", async () => {
194
+ const r = await runCmd(client, "mkdir -p /tmp/a/b/c");
195
+ expect(r.exitCode).toBe(0);
196
+ expect(pathExists(shell, "/tmp/a/b/c")).toBe(true);
197
+ });
198
+
199
+ test("mkdir duplicate dir fails", async () => {
200
+ await runCmd(client, "mkdir /tmp/dup-unique");
201
+ const r = await runCmd(client, "mkdir /tmp/dup-unique 2>&1 || echo 'error'");
202
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
203
+ });
204
+ });
205
+
206
+ // ─── TOUCH tests ───────────────────────────────────────────────────────────
207
+
208
+ describe("touch command", () => {
209
+ test("touch creates file", async () => {
210
+ const r = await runCmd(client, "touch /tmp/newfile.txt");
211
+ expect(r.exitCode).toBe(0);
212
+ expect(pathExists(shell, "/tmp/newfile.txt")).toBe(true);
213
+ });
214
+
215
+ test("touch updates timestamp on existing file", async () => {
216
+ createTestFile(shell, "/tmp/existing.txt", "content");
217
+ const r = await runCmd(client, "touch /tmp/existing.txt");
218
+ expect(r.exitCode).toBe(0);
219
+ expect(pathExists(shell, "/tmp/existing.txt")).toBe(true);
220
+ });
221
+
222
+ test("touch multiple files", async () => {
223
+ const r = await runCmd(client, "touch /tmp/file1.txt /tmp/file2.txt");
224
+ expect(r.exitCode).toBe(0);
225
+ expect(pathExists(shell, "/tmp/file1.txt")).toBe(true);
226
+ expect(pathExists(shell, "/tmp/file2.txt")).toBe(true);
227
+ });
228
+ });
229
+
230
+ // ─── RM tests ──────────────────────────────────────────────────────────────
231
+
232
+ describe("rm command", () => {
233
+ test("rm deletes file", async () => {
234
+ createTestFile(shell, "/tmp/todel.txt", "content");
235
+ const r = await runCmd(client, "rm /tmp/todel.txt");
236
+ expect(r.exitCode).toBe(0);
237
+ expect(pathExists(shell, "/tmp/todel.txt")).toBe(false);
238
+ });
239
+
240
+ test("rm non-existent file fails", async () => {
241
+ const r = await runCmd(client, "rm /tmp/doesnotexist.txt");
242
+ expect(r.exitCode).not.toBe(0);
243
+ });
244
+
245
+ test("rm -r deletes directory recursively", async () => {
246
+ await runCmd(client, "mkdir -p /tmp/rmdir/sub");
247
+ createTestFile(shell, "/tmp/rmdir/sub/file.txt", "test");
248
+ const r = await runCmd(client, "rm -r /tmp/rmdir");
249
+ expect(r.exitCode).toBe(0);
250
+ expect(pathExists(shell, "/tmp/rmdir")).toBe(false);
251
+ });
252
+
253
+ test("rm multiple files", async () => {
254
+ createTestFile(shell, "/tmp/rm1.txt", "1");
255
+ createTestFile(shell, "/tmp/rm2.txt", "2");
256
+ const r = await runCmd(client, "rm /tmp/rm1.txt /tmp/rm2.txt");
257
+ expect(r.exitCode).toBe(0);
258
+ expect(pathExists(shell, "/tmp/rm1.txt")).toBe(false);
259
+ expect(pathExists(shell, "/tmp/rm2.txt")).toBe(false);
260
+ });
261
+ });
262
+
263
+ // ─── CP tests ──────────────────────────────────────────────────────────────
264
+
265
+ describe("cp command", () => {
266
+ test("cp copies file", async () => {
267
+ createTestFile(shell, "/tmp/original.txt", "content");
268
+ const r = await runCmd(client, "cp /tmp/original.txt /tmp/copy.txt");
269
+ expect(r.exitCode).toBe(0);
270
+ expect(pathExists(shell, "/tmp/copy.txt")).toBe(true);
271
+ expect(readTestFile(shell, "/tmp/copy.txt")).toBe("content");
272
+ });
273
+
274
+ test("cp to different name", async () => {
275
+ createTestFile(shell, "/tmp/src.txt", "data");
276
+ const r = await runCmd(client, "cp /tmp/src.txt /tmp/dst.txt");
277
+ expect(r.exitCode).toBe(0);
278
+ expect(readTestFile(shell, "/tmp/dst.txt")).toBe("data");
279
+ });
280
+
281
+ test("cp -r copies directory recursively", async () => {
282
+ await runCmd(client, "mkdir -p /tmp/srcdir/sub");
283
+ createTestFile(shell, "/tmp/srcdir/file.txt", "test");
284
+ createTestFile(shell, "/tmp/srcdir/sub/file2.txt", "test2");
285
+ const r = await runCmd(client, "cp -r /tmp/srcdir /tmp/dstdir");
286
+ expect(r.exitCode).toBe(0);
287
+ expect(pathExists(shell, "/tmp/dstdir/file.txt")).toBe(true);
288
+ expect(pathExists(shell, "/tmp/dstdir/sub/file2.txt")).toBe(true);
289
+ });
290
+
291
+ test("cp to directory", async () => {
292
+ createTestFile(shell, "/tmp/cpfile.txt", "content");
293
+ await runCmd(client, "mkdir -p /tmp/cpdir");
294
+ const r = await runCmd(client, "cp /tmp/cpfile.txt /tmp/cpdir/");
295
+ expect(r.exitCode).toBe(0);
296
+ expect(pathExists(shell, "/tmp/cpdir/cpfile.txt")).toBe(true);
297
+ });
298
+ });
299
+
300
+ // ─── MV tests ──────────────────────────────────────────────────────────────
301
+
302
+ describe("mv command", () => {
303
+ test("mv moves file", async () => {
304
+ createTestFile(shell, "/tmp/mvold.txt", "content");
305
+ const r = await runCmd(client, "mv /tmp/mvold.txt /tmp/mvnew.txt");
306
+ expect(r.exitCode).toBe(0);
307
+ expect(pathExists(shell, "/tmp/mvold.txt")).toBe(false);
308
+ expect(pathExists(shell, "/tmp/mvnew.txt")).toBe(true);
309
+ });
310
+
311
+ test("mv renames file", async () => {
312
+ createTestFile(shell, "/tmp/oldname.txt", "data");
313
+ const r = await runCmd(client, "mv /tmp/oldname.txt /tmp/newname.txt");
314
+ expect(r.exitCode).toBe(0);
315
+ expect(readTestFile(shell, "/tmp/newname.txt")).toBe("data");
316
+ });
317
+
318
+ test("mv to directory", async () => {
319
+ createTestFile(shell, "/tmp/mvfile.txt", "test");
320
+ await runCmd(client, "mkdir -p /tmp/mvdest");
321
+ const r = await runCmd(client, "mv /tmp/mvfile.txt /tmp/mvdest/");
322
+ expect(r.exitCode).toBe(0);
323
+ expect(pathExists(shell, "/tmp/mvdest/mvfile.txt")).toBe(true);
324
+ });
325
+
326
+ test("mv non-existent file fails", async () => {
327
+ const r = await runCmd(client, "mv /tmp/nonexist.txt /tmp/dest.txt");
328
+ expect(r.exitCode).not.toBe(0);
329
+ });
330
+ });
331
+
332
+ // ─── CHMOD tests ──────────────────────────────────────────────────────────
333
+
334
+ describe("chmod command", () => {
335
+ test("chmod changes permissions", async () => {
336
+ createTestFile(shell, "/tmp/chmodfile.txt", "test");
337
+ const r = await runCmd(client, "chmod 644 /tmp/chmodfile.txt");
338
+ expect(r.exitCode).toBe(0);
339
+ });
340
+
341
+ test("chmod recursive", async () => {
342
+ await runCmd(client, "mkdir -p /tmp/chmoddir2/sub");
343
+ createTestFile(shell, "/tmp/chmoddir2/file.txt", "test");
344
+ const r = await runCmd(client, "chmod -R 755 /tmp/chmoddir2");
345
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
346
+ });
347
+
348
+ test("chmod with symbolic notation", async () => {
349
+ createTestFile(shell, "/tmp/symbolic.txt", "test");
350
+ const r = await runCmd(client, "chmod u+x /tmp/symbolic.txt");
351
+ expect(r.exitCode).toBe(0);
352
+ });
353
+ });
354
+
355
+ // ─── GREP tests ───────────────────────────────────────────────────────────
356
+
357
+ describe("grep command", () => {
358
+ test("grep finds pattern", async () => {
359
+ createTestFile(shell, "/tmp/greptarget.txt", "hello\nworld\nhello world");
360
+ const r = await runCmd(client, "grep hello /tmp/greptarget.txt");
361
+ expect(r.exitCode).toBe(0);
362
+ expect(r.stdout).toContain("hello");
363
+ });
364
+
365
+ test("grep -i case insensitive", async () => {
366
+ createTestFile(shell, "/tmp/grep-case.txt", "HELLO\nhello\nHello");
367
+ const r = await runCmd(client, "grep -i hello /tmp/grep-case.txt");
368
+ expect(r.exitCode).toBe(0);
369
+ expect(r.stdout?.split("\n").filter((l) => l).length).toBeGreaterThanOrEqual(3);
370
+ });
371
+
372
+ test("grep -v inverts match", async () => {
373
+ createTestFile(shell, "/tmp/grep-not.txt", "apple\norange\nbanana");
374
+ const r = await runCmd(client, "grep -v apple /tmp/grep-not.txt");
375
+ expect(r.exitCode).toBe(0);
376
+ expect(r.stdout).not.toContain("apple");
377
+ expect(r.stdout).toContain("orange");
378
+ });
379
+
380
+ test("grep from pipe", async () => {
381
+ const r = await runCmd(client, "echo -e 'foo\\nbar\\nfoo' | grep foo");
382
+ expect(r.exitCode).toBe(0);
383
+ expect(r.stdout?.split("\n").filter((l) => l).length).toBe(2);
384
+ });
385
+
386
+ test("grep no match returns non-zero", async () => {
387
+ createTestFile(shell, "/tmp/grep-nomatch.txt", "content");
388
+ const r = await runCmd(client, "grep nomatch /tmp/grep-nomatch.txt");
389
+ expect(r.exitCode).not.toBe(0);
390
+ });
391
+ });
392
+
393
+ // ─── HEAD tests ───────────────────────────────────────────────────────────
394
+
395
+ describe("head command", () => {
396
+ test("head default 10 lines", async () => {
397
+ let content = "";
398
+ for (let i = 1; i <= 20; i++) {
399
+ content += `line${i}\n`;
400
+ }
401
+ createTestFile(shell, "/tmp/head-test.txt", content);
402
+ const r = await runCmd(client, "head /tmp/head-test.txt");
403
+ expect(r.exitCode).toBe(0);
404
+ const lines = r.stdout?.split("\n").filter((l) => l);
405
+ expect(lines?.length).toBe(10);
406
+ expect(r.stdout).toContain("line1");
407
+ expect(r.stdout).not.toContain("line11");
408
+ });
409
+
410
+ test("head -n custom lines", async () => {
411
+ let content = "";
412
+ for (let i = 1; i <= 20; i++) {
413
+ content += `line${i}\n`;
414
+ }
415
+ createTestFile(shell, "/tmp/head-custom.txt", content);
416
+ const r = await runCmd(client, "head -n 5 /tmp/head-custom.txt");
417
+ expect(r.exitCode).toBe(0);
418
+ const lines = r.stdout?.split("\n").filter((l) => l);
419
+ expect(lines?.length).toBe(5);
420
+ });
421
+
422
+ test("head from pipe", async () => {
423
+ const r = await runCmd(client, "seq 1 20 | head -n 5");
424
+ expect(r.exitCode).toBe(0);
425
+ const lines = r.stdout?.split("\n").filter((l) => l);
426
+ expect(lines?.length).toBe(5);
427
+ });
428
+ });
429
+
430
+ // ─── TAIL tests ───────────────────────────────────────────────────────────
431
+
432
+ describe("tail command", () => {
433
+ test("tail default 10 lines", async () => {
434
+ let content = "";
435
+ for (let i = 1; i <= 20; i++) {
436
+ content += `line${i}\n`;
437
+ }
438
+ createTestFile(shell, "/tmp/tail-test2.txt", content);
439
+ const r = await runCmd(client, "tail /tmp/tail-test2.txt");
440
+ expect(r.exitCode).toBe(0);
441
+ const lines = r.stdout?.split("\n").filter((l) => l);
442
+ expect(lines?.length).toBeGreaterThanOrEqual(8);
443
+ expect(r.stdout).toContain("line20");
444
+ });
445
+
446
+ test("tail -n custom lines", async () => {
447
+ let content = "";
448
+ for (let i = 1; i <= 20; i++) {
449
+ content += `line${i}\n`;
450
+ }
451
+ createTestFile(shell, "/tmp/tail-custom.txt", content);
452
+ const r = await runCmd(client, "tail -n 5 /tmp/tail-custom.txt");
453
+ expect(r.exitCode).toBe(0);
454
+ const lines = r.stdout?.split("\n").filter((l) => l);
455
+ expect(lines?.length).toBe(5);
456
+ expect(r.stdout).toContain("line16");
457
+ });
458
+
459
+ test("tail from pipe", async () => {
460
+ const r = await runCmd(client, "seq 1 20 | tail -n 5");
461
+ expect(r.exitCode).toBe(0);
462
+ const lines = r.stdout?.split("\n").filter((l) => l);
463
+ expect(lines?.length).toBe(5);
464
+ });
465
+ });
466
+
467
+ // ─── WC tests ──────────────────────────────────────────────────────────────
468
+
469
+ describe("wc command", () => {
470
+ test("wc counts lines", async () => {
471
+ createTestFile(shell, "/tmp/wc-test.txt", "line1\nline2\nline3");
472
+ const r = await runCmd(client, "wc -l /tmp/wc-test.txt");
473
+ expect(r.exitCode).toBe(0);
474
+ expect(r.stdout?.trim()).toContain("3 /tmp/wc-test.txt");
475
+ });
476
+
477
+ test("wc counts words", async () => {
478
+ createTestFile(shell, "/tmp/wc-words.txt", "one two three");
479
+ const r = await runCmd(client, "wc -w /tmp/wc-words.txt");
480
+ expect(r.exitCode).toBe(0);
481
+ expect(r.stdout?.trim()).toContain("3 /tmp/wc-words.txt");
482
+ });
483
+
484
+ test("wc counts chars", async () => {
485
+ createTestFile(shell, "/tmp/wc-chars.txt", "hello");
486
+ const r = await runCmd(client, "wc -c /tmp/wc-chars.txt");
487
+ expect(r.exitCode).toBe(0);
488
+ expect(r.stdout?.trim()).toContain("5 /tmp/wc-chars.txt");
489
+ });
490
+
491
+ test("wc default (lines words chars)", async () => {
492
+ createTestFile(shell, "/tmp/wc-all.txt", "hello world\ntest");
493
+ const r = await runCmd(client, "wc /tmp/wc-all.txt");
494
+ expect(r.exitCode).toBe(0);
495
+ expect(r.stdout?.trim()).toContain("2");
496
+ expect(r.stdout?.trim()).toContain("3");
497
+ expect(r.stdout?.trim()).toContain("/tmp/wc-all.txt");
498
+ });
499
+ });
500
+
501
+ // ─── SORT tests ───────────────────────────────────────────────────────────
502
+
503
+ describe("sort command", () => {
504
+ test("sort lines alphabetically", async () => {
505
+ createTestFile(shell, "/tmp/sort-test.txt", "zebra\napple\nmango\nbanana");
506
+ const r = await runCmd(client, "sort /tmp/sort-test.txt");
507
+ expect(r.exitCode).toBe(0);
508
+ const lines = r.stdout?.split("\n").filter((l) => l);
509
+ expect(lines?.[0]).toBe("apple");
510
+ expect(lines?.[1]).toBe("banana");
511
+ expect(lines?.[3]).toBe("zebra");
512
+ });
513
+
514
+ test("sort -r reverse", async () => {
515
+ createTestFile(shell, "/tmp/sort-rev.txt", "a\nb\nc");
516
+ const r = await runCmd(client, "sort -r /tmp/sort-rev.txt");
517
+ expect(r.exitCode).toBe(0);
518
+ const lines = r.stdout?.split("\n").filter((l) => l);
519
+ expect(lines?.[0]).toBe("c");
520
+ expect(lines?.[2]).toBe("a");
521
+ });
522
+
523
+ test("sort -n numeric", async () => {
524
+ createTestFile(shell, "/tmp/sort-num.txt", "10\n2\n1\n100");
525
+ const r = await runCmd(client, "sort -n /tmp/sort-num.txt");
526
+ expect(r.exitCode).toBe(0);
527
+ const lines = r.stdout?.split("\n").filter((l) => l);
528
+ expect(lines?.[0]).toBe("1");
529
+ expect(lines?.[1]).toBe("2");
530
+ });
531
+
532
+ test("sort from pipe", async () => {
533
+ const r = await runCmd(client, "echo -e 'c\\na\\nb' | sort");
534
+ expect(r.exitCode).toBe(0);
535
+ const lines = r.stdout?.split("\n").filter((l) => l);
536
+ expect(lines?.[0]).toBe("a");
537
+ });
538
+ });
539
+
540
+ // ─── UNIQ tests ───────────────────────────────────────────────────────────
541
+
542
+ describe("uniq command", () => {
543
+ test("uniq removes consecutive duplicates", async () => {
544
+ createTestFile(shell, "/tmp/uniq-test3.txt", "apple\napple\nbanana\nbanana\napple");
545
+ const r = await runCmd(client, "uniq /tmp/uniq-test3.txt || echo 'uniq'");
546
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
547
+ });
548
+
549
+ test("uniq -c count occurrences", async () => {
550
+ createTestFile(shell, "/tmp/uniq-count2.txt", "a\na\na\nb\nb");
551
+ const r = await runCmd(client, "uniq -c /tmp/uniq-count2.txt");
552
+ expect(r.exitCode).toBe(0);
553
+ expect(r.stdout?.trim().length).toBeGreaterThan(0);
554
+ });
555
+
556
+ test("uniq from pipe", async () => {
557
+ const r = await runCmd(client, "echo -e 'x\\nx\\ny\\ny' | uniq");
558
+ expect(r.exitCode).toBe(0);
559
+ const lines = r.stdout?.split("\n").filter((l) => l);
560
+ expect(lines?.length).toBe(2);
561
+ });
562
+ });