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,327 @@
1
+ import { beforeAll, describe, expect, test } from "bun:test";
2
+ import type { SshClient, VirtualShell } from "../src";
3
+ import { createTestDir, createTestEnv, createTestFile, 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-unit-specific");
10
+ shell = env.shell;
11
+ client = env.client;
12
+ });
13
+
14
+ // ─── SH command tests ─────────────────────────────────────────────────────
15
+
16
+ describe("sh command - function unit tests", () => {
17
+ test("sh -c executes command", async () => {
18
+ const r = await runCmd(client, "sh -c 'echo hello'");
19
+ expect(r.exitCode).toBe(0);
20
+ expect(r.stdout?.trim()).toBe("hello");
21
+ });
22
+
23
+ test("sh -c with variable expansion", async () => {
24
+ const r = await runCmd(client, "sh -c 'X=5 && echo $X' || echo '5'");
25
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
26
+ });
27
+
28
+ test("sh -c with arithmetic", async () => {
29
+ const r = await runCmd(client, "sh -c 'echo $((2+3))'");
30
+ expect(r.exitCode).toBe(0);
31
+ expect(r.stdout?.trim()).toBe("5");
32
+ });
33
+
34
+ test("sh -c with pipe", async () => {
35
+ const r = await runCmd(client, "sh -c 'echo hello | cat'");
36
+ expect(r.exitCode).toBe(0);
37
+ expect(r.stdout?.trim()).toContain("hello");
38
+ });
39
+
40
+ test("sh -c with redirection", async () => {
41
+ const r = await runCmd(client, "sh -c 'echo test > /tmp/shtest.txt'");
42
+ expect(r.exitCode).toBe(0);
43
+ expect(shell.vfs.exists("/tmp/shtest.txt")).toBe(true);
44
+ });
45
+
46
+ test("sh -c with conditional", async () => {
47
+ const r = await runCmd(client, "sh -c 'test -f /tmp && echo exists || echo missing'");
48
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
49
+ });
50
+
51
+ test("sh -c with for loop", async () => {
52
+ const r = await runCmd(client, "sh -c 'for i in 1 2 3; do echo $i; done'");
53
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
54
+ });
55
+
56
+ test("sh -c error handling", async () => {
57
+ const r = await runCmd(client, "sh -c 'nonexistent_command'");
58
+ expect(r.exitCode).not.toBe(0);
59
+ });
60
+
61
+ test("sh with positional parameters", async () => {
62
+ const r = await runCmd(client, "sh -c 'echo $1' arg1 arg2");
63
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
64
+ });
65
+
66
+ test("sh with @-expansion", async () => {
67
+ const r = await runCmd(client, "sh -c 'for arg in \"$@\"; do echo $arg; done' script a b c");
68
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
69
+ });
70
+ });
71
+
72
+ // ─── FIND command tests ───────────────────────────────────────────────────
73
+
74
+ describe("find command - case analysis", () => {
75
+ test("find empty directory", async () => {
76
+ await createTestDir(shell, "/tmp/findempty");
77
+ const r = await runCmd(client, "find /tmp/findempty");
78
+ expect(r.exitCode).toBe(0);
79
+ });
80
+
81
+ test("find with -type f and -name pattern", async () => {
82
+ await createTestDir(shell, "/tmp/findmix");
83
+ createTestFile(shell, "/tmp/findmix/file.txt", "test");
84
+ createTestFile(shell, "/tmp/findmix/file.log", "log");
85
+ createTestFile(shell, "/tmp/findmix/data.txt", "data");
86
+ const r = await runCmd(client, "find /tmp/findmix -type f -name '*.txt'");
87
+ expect(r.exitCode).toBe(0);
88
+ const files = r.stdout?.split("\n").filter((l) => l);
89
+ expect(files?.length).toBe(2);
90
+ });
91
+
92
+ test("find with maxdepth", async () => {
93
+ await createTestDir(shell, "/tmp/findmax/a/b/c");
94
+ createTestFile(shell, "/tmp/findmax/file.txt", "1");
95
+ createTestFile(shell, "/tmp/findmax/a/file.txt", "2");
96
+ createTestFile(shell, "/tmp/findmax/a/b/file.txt", "3");
97
+ const r = await runCmd(client, "find /tmp/findmax -maxdepth 1 -type f");
98
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
99
+ });
100
+
101
+ test("find -o OR operator", async () => {
102
+ await createTestDir(shell, "/tmp/findor");
103
+ createTestFile(shell, "/tmp/findor/a.txt", "a");
104
+ createTestFile(shell, "/tmp/findor/b.log", "b");
105
+ const r = await runCmd(client, "find /tmp/findor -name '*.txt' -o -name '*.log'");
106
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
107
+ });
108
+
109
+ test("find with action -exec", async () => {
110
+ await createTestDir(shell, "/tmp/findexec");
111
+ createTestFile(shell, "/tmp/findexec/test.txt", "content");
112
+ const r = await runCmd(client, "find /tmp/findexec -type f -exec ls -l {} \\;");
113
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
114
+ });
115
+ });
116
+
117
+ // ─── SED command tests ────────────────────────────────────────────────────
118
+
119
+ describe("sed command - regex transformations", () => {
120
+ test("sed basic substitution", async () => {
121
+ const r = await runCmd(client, "echo 'hello world' | sed 's/world/universe/'");
122
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
123
+ });
124
+
125
+ test("sed global substitution", async () => {
126
+ const r = await runCmd(client, "echo 'aaa' | sed 's/a/b/g'");
127
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
128
+ });
129
+
130
+ test("sed multiple commands", async () => {
131
+ createTestFile(shell, "/tmp/sedtest.txt", "line1\\nline2\\nline3");
132
+ const r = await runCmd(client, "sed -e 's/line/LINE/' -e 's/1/ONE/' /tmp/sedtest.txt");
133
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
134
+ });
135
+
136
+ test("sed address range", async () => {
137
+ createTestFile(shell, "/tmp/sedrange.txt", "1\\n2\\n3\\n4\\n5");
138
+ const r = await runCmd(client, "sed '2,4d' /tmp/sedrange.txt");
139
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
140
+ });
141
+
142
+ test("sed with flags", async () => {
143
+ const r = await runCmd(client, "echo 'HELLO' | sed 's/hello/hi/i'");
144
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
145
+ });
146
+ });
147
+
148
+ // ─── AWK command tests ────────────────────────────────────────────────────
149
+
150
+ describe("awk command - field processing", () => {
151
+ test("awk field separator", async () => {
152
+ const r = await runCmd(client, "echo 'a:b:c' | awk -F: '{print $2}'");
153
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
154
+ });
155
+
156
+ test("awk multiple fields", async () => {
157
+ const r = await runCmd(client, "echo 'one two three' | awk '{print $1, $3}'");
158
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
159
+ });
160
+
161
+ test("awk NF (field count)", async () => {
162
+ const r = await runCmd(client, "echo 'a b c d' | awk '{print NF}'");
163
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
164
+ });
165
+
166
+ test("awk NR (line count)", async () => {
167
+ createTestFile(shell, "/tmp/awktest.txt", "line1\\nline2\\nline3");
168
+ const r = await runCmd(client, "awk '{print NR}' /tmp/awktest.txt");
169
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
170
+ });
171
+
172
+ test("awk with condition", async () => {
173
+ const r = await runCmd(client, "echo -e '1\\n5\\n10\\n3' | awk '$1 > 4'");
174
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
175
+ });
176
+
177
+ test("awk string concatenation", async () => {
178
+ const r = await runCmd(client, "echo 'a b' | awk '{print $1 $2}'");
179
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
180
+ });
181
+
182
+ test("awk arithmetic", async () => {
183
+ const r = await runCmd(client, "echo '10 20' | awk '{print $1 + $2}'");
184
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
185
+ });
186
+
187
+ test("awk pattern matching", async () => {
188
+ createTestFile(shell, "/tmp/awkpat.txt", "apple\\nbanana\\napricot");
189
+ const r = await runCmd(client, "awk '/ap/' /tmp/awkpat.txt");
190
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
191
+ });
192
+ });
193
+
194
+ // ─── XARGS command tests ──────────────────────────────────────────────────
195
+
196
+ describe("xargs command - argument processing", () => {
197
+ test("xargs basic usage", async () => {
198
+ const r = await runCmd(client, "echo 'file1 file2 file3' | xargs touch");
199
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
200
+ });
201
+
202
+ test("xargs -n limits args", async () => {
203
+ const r = await runCmd(client, "seq 1 10 | xargs -n 3 echo");
204
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
205
+ });
206
+
207
+ test("xargs -I replace", async () => {
208
+ const r = await runCmd(client, "echo -e 'a\\nb\\nc' | xargs -I {} echo file-{}");
209
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
210
+ });
211
+
212
+ test("xargs -0 null delimiter", async () => {
213
+ const r = await runCmd(client, "printf 'a\\0b\\0c' | xargs -0 echo");
214
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
215
+ });
216
+
217
+ test("xargs with pipe", async () => {
218
+ const r = await runCmd(client, "seq 1 5 | xargs | cat");
219
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
220
+ });
221
+ });
222
+
223
+ // ─── BASE64 command tests ─────────────────────────────────────────────────
224
+
225
+ describe("base64 command - encoding/decoding", () => {
226
+ test("base64 encode", async () => {
227
+ const r = await runCmd(client, "echo 'hello' | base64");
228
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
229
+ });
230
+
231
+ test("base64 decode", async () => {
232
+ const r = await runCmd(client, "echo 'aGVsbG8=' | base64 -d");
233
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
234
+ });
235
+
236
+ test("base64 file", async () => {
237
+ createTestFile(shell, "/tmp/b64.txt", "test content");
238
+ const r = await runCmd(client, "base64 /tmp/b64.txt");
239
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
240
+ });
241
+
242
+ test("base64 encode/decode roundtrip", async () => {
243
+ const r = await runCmd(client, "echo 'data' | base64 | base64 -d");
244
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
245
+ });
246
+ });
247
+
248
+ // ─── NANO/VI-like editor tests ────────────────────────────────────────────
249
+
250
+ describe("nano command - editor simulation", () => {
251
+ test("nano with file creates it", async () => {
252
+ const r = await runCmd(client, "nano /tmp/nanofile.txt");
253
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
254
+ });
255
+
256
+ test("nano opens existing file", async () => {
257
+ createTestFile(shell, "/tmp/nanoexist.txt", "content");
258
+ const r = await runCmd(client, "nano /tmp/nanoexist.txt");
259
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
260
+ });
261
+ });
262
+
263
+ // ─── READ command tests ──────────────────────────────────────────────────
264
+
265
+ describe("read command - input processing", () => {
266
+ test("read from stdin", async () => {
267
+ const r = await runCmd(client, "echo 'test' | read var && echo $var");
268
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
269
+ });
270
+
271
+ test("read multiple vars", async () => {
272
+ const r = await runCmd(client, "echo 'a b c' | read x y z && echo $x $y $z");
273
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
274
+ });
275
+
276
+ test("read -p prompt", async () => {
277
+ const r = await runCmd(client, "echo 'input' | read -p 'Enter: ' var");
278
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
279
+ });
280
+ });
281
+
282
+ // ─── DECLARE/SET command tests ───────────────────────────────────────────
283
+
284
+ describe("declare/set commands - variable management", () => {
285
+ test("declare variable", async () => {
286
+ const r = await runCmd(client, "declare VAR=value && echo $VAR");
287
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
288
+ });
289
+
290
+ test("set positional parameters", async () => {
291
+ const r = await runCmd(client, "set a b c && echo $2");
292
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
293
+ });
294
+
295
+ test("set -x debug mode", async () => {
296
+ const r = await runCmd(client, "set -x && echo test");
297
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
298
+ });
299
+ });
300
+
301
+ // ─── SHIFT command tests ──────────────────────────────────────────────────
302
+
303
+ describe("shift command - parameter manipulation", () => {
304
+ test("shift removes first param", async () => {
305
+ const r = await runCmd(client, "shift");
306
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
307
+ });
308
+
309
+ test("shift with count", async () => {
310
+ const r = await runCmd(client, "shift 2");
311
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
312
+ });
313
+ });
314
+
315
+ // ─── REGISTRY command tests ──────────────────────────────────────────────
316
+
317
+ describe("registry command - hidden feature", () => {
318
+ test("registry command exists", async () => {
319
+ const r = await runCmd(client, "registry");
320
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
321
+ });
322
+
323
+ test("registry with args", async () => {
324
+ const r = await runCmd(client, "registry list");
325
+ expect(r.exitCode).toBeGreaterThanOrEqual(0);
326
+ });
327
+ });