typescript-virtual-container 1.4.4 → 1.4.6

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 (884) hide show
  1. package/README.md +1 -1
  2. package/builds/self-standalone.js +321 -272
  3. package/builds/self-standalone.js.map +4 -4
  4. package/builds/standalone-wo-sftp.js +262 -212
  5. package/builds/standalone-wo-sftp.js.map +4 -4
  6. package/builds/standalone.cjs +491 -0
  7. package/builds/standalone.cjs.map +7 -0
  8. package/builds/standalone.js +266 -216
  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 +97 -0
  15. package/dist/Honeypot/index.d.ts.map +1 -0
  16. package/dist/Honeypot/index.js +299 -0
  17. package/dist/Honeypot/index.js.map +1 -0
  18. package/dist/SSHClient/index.d.ts.map +1 -0
  19. package/dist/SSHClient/index.js +238 -0
  20. package/dist/SSHClient/index.js.map +1 -0
  21. package/dist/SSHMimic/exec.d.ts.map +1 -0
  22. package/dist/SSHMimic/exec.js +28 -0
  23. package/dist/SSHMimic/exec.js.map +1 -0
  24. package/dist/SSHMimic/executor.d.ts.map +1 -0
  25. package/dist/SSHMimic/executor.js +161 -0
  26. package/dist/SSHMimic/executor.js.map +1 -0
  27. package/dist/SSHMimic/hostKey.d.ts.map +1 -0
  28. package/dist/SSHMimic/hostKey.js +18 -0
  29. package/dist/SSHMimic/hostKey.js.map +1 -0
  30. package/dist/SSHMimic/index.d.ts.map +1 -0
  31. package/dist/SSHMimic/index.js +250 -0
  32. package/dist/SSHMimic/index.js.map +1 -0
  33. package/dist/SSHMimic/loginBanner.d.ts.map +1 -0
  34. package/dist/SSHMimic/loginBanner.js +23 -0
  35. package/dist/SSHMimic/loginBanner.js.map +1 -0
  36. package/dist/SSHMimic/loginFormat.d.ts.map +1 -0
  37. package/dist/SSHMimic/loginFormat.js +11 -0
  38. package/dist/SSHMimic/loginFormat.js.map +1 -0
  39. package/dist/SSHMimic/prompt.d.ts.map +1 -0
  40. package/dist/SSHMimic/prompt.js +10 -0
  41. package/dist/SSHMimic/prompt.js.map +1 -0
  42. package/dist/SSHMimic/sftp.d.ts.map +1 -0
  43. package/dist/SSHMimic/sftp.js +620 -0
  44. package/dist/SSHMimic/sftp.js.map +1 -0
  45. package/dist/VirtualFileSystem/binaryPack.d.ts.map +1 -0
  46. package/dist/VirtualFileSystem/binaryPack.js +217 -0
  47. package/dist/VirtualFileSystem/binaryPack.js.map +1 -0
  48. package/dist/VirtualFileSystem/index.d.ts.map +1 -0
  49. package/dist/VirtualFileSystem/index.js +690 -0
  50. package/dist/VirtualFileSystem/index.js.map +1 -0
  51. package/dist/VirtualFileSystem/internalTypes.d.ts.map +1 -0
  52. package/dist/VirtualFileSystem/internalTypes.js +1 -0
  53. package/dist/VirtualFileSystem/internalTypes.js.map +1 -0
  54. package/dist/VirtualFileSystem/path.d.ts.map +1 -0
  55. package/dist/VirtualFileSystem/path.js +50 -0
  56. package/dist/VirtualFileSystem/path.js.map +1 -0
  57. package/dist/VirtualPackageManager/index.d.ts.map +1 -0
  58. package/dist/VirtualPackageManager/index.js +854 -0
  59. package/dist/VirtualPackageManager/index.js.map +1 -0
  60. package/dist/VirtualShell/index.d.ts.map +1 -0
  61. package/dist/VirtualShell/index.js +285 -0
  62. package/dist/VirtualShell/index.js.map +1 -0
  63. package/dist/VirtualShell/shell.d.ts.map +1 -0
  64. package/dist/VirtualShell/shell.js +503 -0
  65. package/dist/VirtualShell/shell.js.map +1 -0
  66. package/dist/VirtualShell/shellParser.d.ts.map +1 -0
  67. package/dist/VirtualShell/shellParser.js +266 -0
  68. package/dist/VirtualShell/shellParser.js.map +1 -0
  69. package/dist/VirtualUserManager/index.d.ts.map +1 -0
  70. package/dist/VirtualUserManager/index.js +608 -0
  71. package/dist/VirtualUserManager/index.js.map +1 -0
  72. package/dist/commands/adduser.d.ts.map +1 -0
  73. package/dist/commands/adduser.js +90 -0
  74. package/dist/commands/adduser.js.map +1 -0
  75. package/dist/commands/alias.d.ts.map +1 -0
  76. package/dist/commands/alias.js +69 -0
  77. package/dist/commands/alias.js.map +1 -0
  78. package/dist/commands/apt.d.ts.map +1 -0
  79. package/dist/commands/apt.js +211 -0
  80. package/dist/commands/apt.js.map +1 -0
  81. package/dist/commands/awk.d.ts.map +1 -0
  82. package/dist/commands/awk.js +170 -0
  83. package/dist/commands/awk.js.map +1 -0
  84. package/dist/commands/base64.d.ts.map +1 -0
  85. package/dist/commands/base64.js +29 -0
  86. package/dist/commands/base64.js.map +1 -0
  87. package/dist/commands/cat.d.ts.map +1 -0
  88. package/dist/commands/cat.js +45 -0
  89. package/dist/commands/cat.js.map +1 -0
  90. package/dist/commands/cd.d.ts.map +1 -0
  91. package/dist/commands/cd.js +22 -0
  92. package/dist/commands/cd.js.map +1 -0
  93. package/dist/commands/chmod.d.ts.map +1 -0
  94. package/dist/commands/chmod.js +88 -0
  95. package/dist/commands/chmod.js.map +1 -0
  96. package/dist/commands/clear.d.ts.map +1 -0
  97. package/dist/commands/clear.js +14 -0
  98. package/dist/commands/clear.js.map +1 -0
  99. package/dist/commands/command-helpers.d.ts.map +1 -0
  100. package/dist/commands/command-helpers.js +222 -0
  101. package/dist/commands/command-helpers.js.map +1 -0
  102. package/dist/commands/cp.d.ts.map +1 -0
  103. package/dist/commands/cp.js +76 -0
  104. package/dist/commands/cp.js.map +1 -0
  105. package/dist/commands/curl.d.ts.map +1 -0
  106. package/dist/commands/curl.js +128 -0
  107. package/dist/commands/curl.js.map +1 -0
  108. package/dist/commands/cut.d.ts.map +1 -0
  109. package/dist/commands/cut.js +35 -0
  110. package/dist/commands/cut.js.map +1 -0
  111. package/dist/commands/date.d.ts.map +1 -0
  112. package/dist/commands/date.js +29 -0
  113. package/dist/commands/date.js.map +1 -0
  114. package/dist/commands/declare.d.ts.map +1 -0
  115. package/dist/commands/declare.js +45 -0
  116. package/dist/commands/declare.js.map +1 -0
  117. package/dist/commands/deluser.d.ts.map +1 -0
  118. package/dist/commands/deluser.js +84 -0
  119. package/dist/commands/deluser.js.map +1 -0
  120. package/dist/commands/df.d.ts.map +1 -0
  121. package/dist/commands/df.js +22 -0
  122. package/dist/commands/df.js.map +1 -0
  123. package/dist/commands/diff.d.ts.map +1 -0
  124. package/dist/commands/diff.js +46 -0
  125. package/dist/commands/diff.js.map +1 -0
  126. package/dist/commands/dpkg.d.ts.map +1 -0
  127. package/dist/commands/dpkg.js +162 -0
  128. package/dist/commands/dpkg.js.map +1 -0
  129. package/dist/commands/du.d.ts.map +1 -0
  130. package/dist/commands/du.js +51 -0
  131. package/dist/commands/du.js.map +1 -0
  132. package/dist/commands/echo.d.ts.map +1 -0
  133. package/dist/commands/echo.js +46 -0
  134. package/dist/commands/echo.js.map +1 -0
  135. package/dist/commands/env.d.ts.map +1 -0
  136. package/dist/commands/env.js +21 -0
  137. package/dist/commands/env.js.map +1 -0
  138. package/dist/commands/exit.d.ts.map +1 -0
  139. package/dist/commands/exit.js +17 -0
  140. package/dist/commands/exit.js.map +1 -0
  141. package/dist/commands/export.d.ts.map +1 -0
  142. package/dist/commands/export.js +34 -0
  143. package/dist/commands/export.js.map +1 -0
  144. package/dist/commands/find.d.ts.map +1 -0
  145. package/dist/commands/find.js +56 -0
  146. package/dist/commands/find.js.map +1 -0
  147. package/dist/commands/free.d.ts.map +1 -0
  148. package/dist/commands/free.js +44 -0
  149. package/dist/commands/free.js.map +1 -0
  150. package/dist/commands/grep.d.ts.map +1 -0
  151. package/dist/commands/grep.js +121 -0
  152. package/dist/commands/grep.js.map +1 -0
  153. package/dist/commands/groups.d.ts.map +1 -0
  154. package/dist/commands/groups.js +18 -0
  155. package/dist/commands/groups.js.map +1 -0
  156. package/dist/commands/gzip.d.ts.map +1 -0
  157. package/dist/commands/gzip.js +83 -0
  158. package/dist/commands/gzip.js.map +1 -0
  159. package/dist/commands/head.d.ts.map +1 -0
  160. package/dist/commands/head.js +47 -0
  161. package/dist/commands/head.js.map +1 -0
  162. package/dist/commands/help.d.ts.map +1 -0
  163. package/dist/commands/help.js +124 -0
  164. package/dist/commands/help.js.map +1 -0
  165. package/dist/commands/helpers.d.ts.map +1 -0
  166. package/dist/commands/helpers.js +167 -0
  167. package/dist/commands/helpers.js.map +1 -0
  168. package/dist/commands/history.d.ts.map +1 -0
  169. package/dist/commands/history.js +27 -0
  170. package/dist/commands/history.js.map +1 -0
  171. package/dist/commands/hostname.d.ts.map +1 -0
  172. package/dist/commands/hostname.js +13 -0
  173. package/dist/commands/hostname.js.map +1 -0
  174. package/dist/commands/htop.d.ts.map +1 -0
  175. package/dist/commands/htop.js +18 -0
  176. package/dist/commands/htop.js.map +1 -0
  177. package/dist/commands/id.d.ts.map +1 -0
  178. package/dist/commands/id.js +18 -0
  179. package/dist/commands/id.js.map +1 -0
  180. package/dist/commands/index.d.ts.map +1 -0
  181. package/dist/commands/index.js +3 -0
  182. package/dist/commands/index.js.map +1 -0
  183. package/dist/commands/kill.d.ts.map +1 -0
  184. package/dist/commands/kill.js +19 -0
  185. package/dist/commands/kill.js.map +1 -0
  186. package/dist/commands/ln.d.ts.map +1 -0
  187. package/dist/commands/ln.js +67 -0
  188. package/dist/commands/ln.js.map +1 -0
  189. package/dist/commands/ls.d.ts.map +1 -0
  190. package/dist/commands/ls.js +201 -0
  191. package/dist/commands/ls.js.map +1 -0
  192. package/dist/commands/lsb-release.d.ts.map +1 -0
  193. package/dist/commands/lsb-release.js +62 -0
  194. package/dist/commands/lsb-release.js.map +1 -0
  195. package/dist/commands/man.d.ts.map +1 -0
  196. package/dist/commands/man.js +50 -0
  197. package/dist/commands/man.js.map +1 -0
  198. package/dist/commands/mkdir.d.ts.map +1 -0
  199. package/dist/commands/mkdir.js +29 -0
  200. package/dist/commands/mkdir.js.map +1 -0
  201. package/dist/commands/mv.d.ts.map +1 -0
  202. package/dist/commands/mv.js +43 -0
  203. package/dist/commands/mv.js.map +1 -0
  204. package/dist/commands/nano.d.ts.map +1 -0
  205. package/dist/commands/nano.js +35 -0
  206. package/dist/commands/nano.js.map +1 -0
  207. package/dist/commands/neofetch.d.ts.map +1 -0
  208. package/dist/commands/neofetch.js +49 -0
  209. package/dist/commands/neofetch.js.map +1 -0
  210. package/dist/commands/node.d.ts.map +1 -0
  211. package/dist/commands/node.js +317 -0
  212. package/dist/commands/node.js.map +1 -0
  213. package/dist/commands/npm.d.ts.map +1 -0
  214. package/dist/commands/npm.js +110 -0
  215. package/dist/commands/npm.js.map +1 -0
  216. package/dist/commands/passwd.d.ts.map +1 -0
  217. package/dist/commands/passwd.js +45 -0
  218. package/dist/commands/passwd.js.map +1 -0
  219. package/dist/commands/ping.d.ts.map +1 -0
  220. package/dist/commands/ping.js +29 -0
  221. package/dist/commands/ping.js.map +1 -0
  222. package/dist/commands/printf.d.ts.map +1 -0
  223. package/dist/commands/printf.js +145 -0
  224. package/dist/commands/printf.js.map +1 -0
  225. package/dist/commands/ps.d.ts.map +1 -0
  226. package/dist/commands/ps.js +47 -0
  227. package/dist/commands/ps.js.map +1 -0
  228. package/dist/commands/pwd.d.ts.map +1 -0
  229. package/dist/commands/pwd.js +8 -0
  230. package/dist/commands/pwd.js.map +1 -0
  231. package/dist/commands/python.d.ts.map +1 -0
  232. package/dist/commands/python.js +2059 -0
  233. package/dist/commands/python.js.map +1 -0
  234. package/dist/commands/read.d.ts.map +1 -0
  235. package/dist/commands/read.js +40 -0
  236. package/dist/commands/read.js.map +1 -0
  237. package/dist/commands/registry.d.ts.map +1 -0
  238. package/dist/commands/registry.js +235 -0
  239. package/dist/commands/registry.js.map +1 -0
  240. package/dist/commands/rm.d.ts.map +1 -0
  241. package/dist/commands/rm.js +37 -0
  242. package/dist/commands/rm.js.map +1 -0
  243. package/dist/commands/runtime.d.ts.map +1 -0
  244. package/dist/commands/runtime.js +286 -0
  245. package/dist/commands/runtime.js.map +1 -0
  246. package/dist/commands/sed.d.ts.map +1 -0
  247. package/dist/commands/sed.js +61 -0
  248. package/dist/commands/sed.js.map +1 -0
  249. package/dist/commands/seq.d.ts.map +1 -0
  250. package/dist/commands/seq.js +51 -0
  251. package/dist/commands/seq.js.map +1 -0
  252. package/dist/commands/set.d.ts.map +1 -0
  253. package/dist/commands/set.js +27 -0
  254. package/dist/commands/set.js.map +1 -0
  255. package/dist/commands/sh.d.ts.map +1 -0
  256. package/dist/commands/sh.js +432 -0
  257. package/dist/commands/sh.js.map +1 -0
  258. package/dist/commands/shift.d.ts.map +1 -0
  259. package/dist/commands/shift.js +63 -0
  260. package/dist/commands/shift.js.map +1 -0
  261. package/dist/commands/sleep.d.ts.map +1 -0
  262. package/dist/commands/sleep.js +19 -0
  263. package/dist/commands/sleep.js.map +1 -0
  264. package/dist/commands/sort.d.ts.map +1 -0
  265. package/dist/commands/sort.js +45 -0
  266. package/dist/commands/sort.js.map +1 -0
  267. package/dist/commands/source.d.ts.map +1 -0
  268. package/dist/commands/source.js +40 -0
  269. package/dist/commands/source.js.map +1 -0
  270. package/dist/commands/stat.d.ts.map +1 -0
  271. package/dist/commands/stat.js +57 -0
  272. package/dist/commands/stat.js.map +1 -0
  273. package/dist/commands/su.d.ts.map +1 -0
  274. package/dist/commands/su.js +58 -0
  275. package/dist/commands/su.js.map +1 -0
  276. package/dist/commands/sudo.d.ts.map +1 -0
  277. package/dist/commands/sudo.js +55 -0
  278. package/dist/commands/sudo.js.map +1 -0
  279. package/dist/commands/tail.d.ts.map +1 -0
  280. package/dist/commands/tail.js +48 -0
  281. package/dist/commands/tail.js.map +1 -0
  282. package/dist/commands/tar.d.ts.map +1 -0
  283. package/dist/commands/tar.js +103 -0
  284. package/dist/commands/tar.js.map +1 -0
  285. package/dist/commands/tee.d.ts.map +1 -0
  286. package/dist/commands/tee.js +37 -0
  287. package/dist/commands/tee.js.map +1 -0
  288. package/dist/commands/test.d.ts.map +1 -0
  289. package/dist/commands/test.js +115 -0
  290. package/dist/commands/test.js.map +1 -0
  291. package/dist/commands/touch.d.ts.map +1 -0
  292. package/dist/commands/touch.js +26 -0
  293. package/dist/commands/touch.js.map +1 -0
  294. package/dist/commands/tr.d.ts.map +1 -0
  295. package/dist/commands/tr.js +62 -0
  296. package/dist/commands/tr.js.map +1 -0
  297. package/dist/commands/tree.d.ts.map +1 -0
  298. package/dist/commands/tree.js +19 -0
  299. package/dist/commands/tree.js.map +1 -0
  300. package/dist/commands/true.d.ts.map +1 -0
  301. package/dist/commands/true.js +25 -0
  302. package/dist/commands/true.js.map +1 -0
  303. package/dist/commands/type.d.ts.map +1 -0
  304. package/dist/commands/type.js +40 -0
  305. package/dist/commands/type.js.map +1 -0
  306. package/dist/commands/uname.d.ts.map +1 -0
  307. package/dist/commands/uname.js +30 -0
  308. package/dist/commands/uname.js.map +1 -0
  309. package/dist/commands/uniq.d.ts.map +1 -0
  310. package/dist/commands/uniq.js +39 -0
  311. package/dist/commands/uniq.js.map +1 -0
  312. package/dist/commands/unset.d.ts.map +1 -0
  313. package/dist/commands/unset.js +17 -0
  314. package/dist/commands/unset.js.map +1 -0
  315. package/dist/commands/uptime.d.ts.map +1 -0
  316. package/dist/commands/uptime.js +49 -0
  317. package/dist/commands/uptime.js.map +1 -0
  318. package/dist/commands/wc.d.ts.map +1 -0
  319. package/dist/commands/wc.js +56 -0
  320. package/dist/commands/wc.js.map +1 -0
  321. package/dist/commands/wget.d.ts.map +1 -0
  322. package/dist/commands/wget.js +127 -0
  323. package/dist/commands/wget.js.map +1 -0
  324. package/dist/commands/which.d.ts.map +1 -0
  325. package/dist/commands/which.js +33 -0
  326. package/dist/commands/which.js.map +1 -0
  327. package/dist/commands/who.d.ts.map +1 -0
  328. package/dist/commands/who.js +23 -0
  329. package/dist/commands/who.js.map +1 -0
  330. package/dist/commands/whoami.d.ts.map +1 -0
  331. package/dist/commands/whoami.js +13 -0
  332. package/dist/commands/whoami.js.map +1 -0
  333. package/dist/commands/xargs.d.ts.map +1 -0
  334. package/dist/commands/xargs.js +22 -0
  335. package/dist/commands/xargs.js.map +1 -0
  336. package/dist/index.d.ts.map +1 -0
  337. package/dist/index.js +10 -0
  338. package/dist/index.js.map +1 -0
  339. package/dist/modules/linuxRootfs.d.ts.map +1 -0
  340. package/dist/modules/linuxRootfs.js +620 -0
  341. package/dist/modules/linuxRootfs.js.map +1 -0
  342. package/dist/modules/neofetch.d.ts.map +1 -0
  343. package/dist/modules/neofetch.js +285 -0
  344. package/dist/modules/neofetch.js.map +1 -0
  345. package/dist/modules/shellInteractive.d.ts.map +1 -0
  346. package/dist/modules/shellInteractive.js +27 -0
  347. package/dist/modules/shellInteractive.js.map +1 -0
  348. package/dist/modules/shellRuntime.d.ts.map +1 -0
  349. package/dist/modules/shellRuntime.js +53 -0
  350. package/dist/modules/shellRuntime.js.map +1 -0
  351. package/dist/self-standalone.d.ts.map +1 -0
  352. package/dist/self-standalone.js +420 -0
  353. package/dist/self-standalone.js.map +1 -0
  354. package/dist/standalone-wo-sftp.d.ts.map +1 -0
  355. package/dist/standalone-wo-sftp.js +31 -0
  356. package/dist/standalone-wo-sftp.js.map +1 -0
  357. package/dist/standalone.d.ts.map +1 -0
  358. package/dist/standalone.js +40 -0
  359. package/dist/standalone.js.map +1 -0
  360. package/dist/types/commands.d.ts.map +1 -0
  361. package/dist/types/commands.js +1 -0
  362. package/dist/types/commands.js.map +1 -0
  363. package/dist/types/pipeline.d.ts.map +1 -0
  364. package/dist/types/pipeline.js +1 -0
  365. package/dist/types/pipeline.js.map +1 -0
  366. package/dist/types/streams.d.ts.map +1 -0
  367. package/dist/types/streams.js +1 -0
  368. package/dist/types/streams.js.map +1 -0
  369. package/dist/types/vfs.d.ts.map +1 -0
  370. package/dist/types/vfs.js +1 -0
  371. package/dist/types/vfs.js.map +1 -0
  372. package/dist/utils/expand.d.ts.map +1 -0
  373. package/dist/utils/expand.js +477 -0
  374. package/dist/utils/expand.js.map +1 -0
  375. package/dist/utils/perfLogger.d.ts.map +1 -0
  376. package/dist/utils/perfLogger.js +50 -0
  377. package/dist/utils/perfLogger.js.map +1 -0
  378. package/dist/utils/tokenize.d.ts.map +1 -0
  379. package/dist/utils/tokenize.js +115 -0
  380. package/dist/utils/tokenize.js.map +1 -0
  381. package/dist/utils/vfsDiff.d.ts.map +1 -0
  382. package/dist/utils/vfsDiff.js +178 -0
  383. package/dist/utils/vfsDiff.js.map +1 -0
  384. package/dist/web-api.d.ts.map +1 -0
  385. package/dist/web-api.js +47 -0
  386. package/dist/web-api.js.map +1 -0
  387. package/dist/web-full.d.ts.map +1 -0
  388. package/dist/web-full.js +9 -0
  389. package/dist/web-full.js.map +1 -0
  390. package/dist/web.d.ts.map +1 -0
  391. package/dist/web.js +774 -0
  392. package/dist/web.js.map +1 -0
  393. package/docs/.nojekyll +1 -0
  394. package/docs/assets/hierarchy.js +1 -0
  395. package/docs/assets/highlight.css +162 -0
  396. package/docs/assets/icons.js +18 -0
  397. package/docs/assets/icons.svg +1 -0
  398. package/docs/assets/main.js +60 -0
  399. package/docs/assets/navigation.js +1 -0
  400. package/docs/assets/search.js +1 -0
  401. package/docs/assets/style.css +1633 -0
  402. package/docs/classes/HoneyPot.html +31 -0
  403. package/docs/classes/SshClient.html +66 -0
  404. package/docs/classes/VirtualFileSystem.html +262 -0
  405. package/docs/classes/VirtualPackageManager.html +63 -0
  406. package/docs/classes/VirtualSftpServer.html +169 -0
  407. package/docs/classes/VirtualShell.html +265 -0
  408. package/docs/classes/VirtualSshServer.html +177 -0
  409. package/docs/classes/VirtualUserManager.html +276 -0
  410. package/docs/functions/assertDiff.html +6 -0
  411. package/docs/functions/diffSnapshots.html +7 -0
  412. package/docs/functions/formatDiff.html +6 -0
  413. package/docs/functions/getArg.html +13 -0
  414. package/docs/functions/getFlag.html +15 -0
  415. package/docs/functions/ifFlag.html +11 -0
  416. package/docs/hierarchy.html +1 -0
  417. package/docs/index.html +1842 -0
  418. package/docs/interfaces/AuditLogEntry.html +6 -0
  419. package/docs/interfaces/CommandContext.html +22 -0
  420. package/docs/interfaces/CommandResult.html +26 -0
  421. package/docs/interfaces/ExecStream.html +11 -0
  422. package/docs/interfaces/HoneyPotStats.html +14 -0
  423. package/docs/interfaces/InstalledPackage.html +20 -0
  424. package/docs/interfaces/NanoEditorSession.html +8 -0
  425. package/docs/interfaces/PackageDefinition.html +30 -0
  426. package/docs/interfaces/PackageFile.html +8 -0
  427. package/docs/interfaces/RemoveOptions.html +4 -0
  428. package/docs/interfaces/ShellEnv.html +6 -0
  429. package/docs/interfaces/ShellModule.html +14 -0
  430. package/docs/interfaces/ShellProperties.html +14 -0
  431. package/docs/interfaces/ShellStream.html +11 -0
  432. package/docs/interfaces/SudoChallenge.html +24 -0
  433. package/docs/interfaces/VfsBaseNode.html +12 -0
  434. package/docs/interfaces/VfsDiff.html +10 -0
  435. package/docs/interfaces/VfsDiffEntry.html +6 -0
  436. package/docs/interfaces/VfsDiffModified.html +10 -0
  437. package/docs/interfaces/VfsDirectoryNode.html +15 -0
  438. package/docs/interfaces/VfsFileNode.html +17 -0
  439. package/docs/interfaces/VfsOptions.html +12 -0
  440. package/docs/interfaces/VfsSnapshot.html +3 -0
  441. package/docs/interfaces/VfsSnapshotBaseNode.html +8 -0
  442. package/docs/interfaces/VfsSnapshotDirectoryNode.html +10 -0
  443. package/docs/interfaces/VfsSnapshotFileNode.html +12 -0
  444. package/docs/interfaces/WriteFileOptions.html +6 -0
  445. package/docs/media/LICENSE +21 -0
  446. package/docs/modules.html +1 -0
  447. package/docs/types/CommandMode.html +2 -0
  448. package/docs/types/CommandOutcome.html +2 -0
  449. package/docs/types/VfsNodeStats.html +2 -0
  450. package/docs/types/VfsNodeType.html +2 -0
  451. package/docs/types/VfsPersistenceMode.html +5 -0
  452. package/docs/types/VfsSnapshotNode.html +2 -0
  453. package/examples/web.min.js +5 -5
  454. package/package.json +6 -4
  455. package/src/commands/man.ts +1 -1
  456. package/src/self-standalone.ts +1 -1
  457. package/src/standalone.ts +8 -3
  458. package/tsconfig.json +7 -2
  459. package/src/Honeypot/index.d.ts.map +0 -1
  460. package/src/Honeypot/index.js +0 -298
  461. package/src/SSHClient/index.d.ts.map +0 -1
  462. package/src/SSHClient/index.js +0 -237
  463. package/src/SSHMimic/exec.d.ts.map +0 -1
  464. package/src/SSHMimic/exec.js +0 -27
  465. package/src/SSHMimic/executor.d.ts.map +0 -1
  466. package/src/SSHMimic/executor.js +0 -160
  467. package/src/SSHMimic/hostKey.d.ts.map +0 -1
  468. package/src/SSHMimic/hostKey.js +0 -17
  469. package/src/SSHMimic/index.d.ts.map +0 -1
  470. package/src/SSHMimic/index.js +0 -249
  471. package/src/SSHMimic/loginBanner.d.ts.map +0 -1
  472. package/src/SSHMimic/loginBanner.js +0 -22
  473. package/src/SSHMimic/loginFormat.d.ts.map +0 -1
  474. package/src/SSHMimic/loginFormat.js +0 -10
  475. package/src/SSHMimic/prompt.d.ts.map +0 -1
  476. package/src/SSHMimic/prompt.js +0 -9
  477. package/src/SSHMimic/sftp.d.ts.map +0 -1
  478. package/src/SSHMimic/sftp.js +0 -619
  479. package/src/VirtualFileSystem/binaryPack.d.ts.map +0 -1
  480. package/src/VirtualFileSystem/binaryPack.js +0 -216
  481. package/src/VirtualFileSystem/index.d.ts.map +0 -1
  482. package/src/VirtualFileSystem/index.js +0 -689
  483. package/src/VirtualFileSystem/internalTypes.d.ts.map +0 -1
  484. package/src/VirtualFileSystem/internalTypes.js +0 -0
  485. package/src/VirtualFileSystem/path.d.ts.map +0 -1
  486. package/src/VirtualFileSystem/path.js +0 -49
  487. package/src/VirtualPackageManager/index.d.ts.map +0 -1
  488. package/src/VirtualPackageManager/index.js +0 -853
  489. package/src/VirtualShell/index.d.ts.map +0 -1
  490. package/src/VirtualShell/index.js +0 -284
  491. package/src/VirtualShell/shell.d.ts.map +0 -1
  492. package/src/VirtualShell/shell.js +0 -502
  493. package/src/VirtualShell/shellParser.d.ts.map +0 -1
  494. package/src/VirtualShell/shellParser.js +0 -265
  495. package/src/VirtualUserManager/index.d.ts.map +0 -1
  496. package/src/VirtualUserManager/index.js +0 -607
  497. package/src/commands/adduser.d.ts.map +0 -1
  498. package/src/commands/adduser.js +0 -89
  499. package/src/commands/alias.d.ts.map +0 -1
  500. package/src/commands/alias.js +0 -68
  501. package/src/commands/apt.d.ts.map +0 -1
  502. package/src/commands/apt.js +0 -210
  503. package/src/commands/awk.d.ts.map +0 -1
  504. package/src/commands/awk.js +0 -169
  505. package/src/commands/base64.d.ts.map +0 -1
  506. package/src/commands/base64.js +0 -28
  507. package/src/commands/cat.d.ts.map +0 -1
  508. package/src/commands/cat.js +0 -44
  509. package/src/commands/cd.d.ts.map +0 -1
  510. package/src/commands/cd.js +0 -21
  511. package/src/commands/chmod.d.ts.map +0 -1
  512. package/src/commands/chmod.js +0 -87
  513. package/src/commands/clear.d.ts.map +0 -1
  514. package/src/commands/clear.js +0 -13
  515. package/src/commands/command-helpers.d.ts.map +0 -1
  516. package/src/commands/command-helpers.js +0 -221
  517. package/src/commands/cp.d.ts.map +0 -1
  518. package/src/commands/cp.js +0 -75
  519. package/src/commands/curl.d.ts.map +0 -1
  520. package/src/commands/curl.js +0 -127
  521. package/src/commands/cut.d.ts.map +0 -1
  522. package/src/commands/cut.js +0 -34
  523. package/src/commands/date.d.ts.map +0 -1
  524. package/src/commands/date.js +0 -28
  525. package/src/commands/declare.d.ts.map +0 -1
  526. package/src/commands/declare.js +0 -44
  527. package/src/commands/deluser.d.ts.map +0 -1
  528. package/src/commands/deluser.js +0 -83
  529. package/src/commands/df.d.ts.map +0 -1
  530. package/src/commands/df.js +0 -21
  531. package/src/commands/diff.d.ts.map +0 -1
  532. package/src/commands/diff.js +0 -45
  533. package/src/commands/dpkg.d.ts.map +0 -1
  534. package/src/commands/dpkg.js +0 -161
  535. package/src/commands/du.d.ts.map +0 -1
  536. package/src/commands/du.js +0 -50
  537. package/src/commands/echo.d.ts.map +0 -1
  538. package/src/commands/echo.js +0 -45
  539. package/src/commands/env.d.ts.map +0 -1
  540. package/src/commands/env.js +0 -20
  541. package/src/commands/exit.d.ts.map +0 -1
  542. package/src/commands/exit.js +0 -16
  543. package/src/commands/export.d.ts.map +0 -1
  544. package/src/commands/export.js +0 -33
  545. package/src/commands/find.d.ts.map +0 -1
  546. package/src/commands/find.js +0 -55
  547. package/src/commands/free.d.ts.map +0 -1
  548. package/src/commands/free.js +0 -43
  549. package/src/commands/grep.d.ts.map +0 -1
  550. package/src/commands/grep.js +0 -120
  551. package/src/commands/groups.d.ts.map +0 -1
  552. package/src/commands/groups.js +0 -17
  553. package/src/commands/gzip.d.ts.map +0 -1
  554. package/src/commands/gzip.js +0 -82
  555. package/src/commands/head.d.ts.map +0 -1
  556. package/src/commands/head.js +0 -46
  557. package/src/commands/help.d.ts.map +0 -1
  558. package/src/commands/help.js +0 -123
  559. package/src/commands/helpers.d.ts.map +0 -1
  560. package/src/commands/helpers.js +0 -166
  561. package/src/commands/history.d.ts.map +0 -1
  562. package/src/commands/history.js +0 -26
  563. package/src/commands/hostname.d.ts.map +0 -1
  564. package/src/commands/hostname.js +0 -12
  565. package/src/commands/htop.d.ts.map +0 -1
  566. package/src/commands/htop.js +0 -17
  567. package/src/commands/id.d.ts.map +0 -1
  568. package/src/commands/id.js +0 -17
  569. package/src/commands/index.d.ts.map +0 -1
  570. package/src/commands/index.js +0 -2
  571. package/src/commands/kill.d.ts.map +0 -1
  572. package/src/commands/kill.js +0 -18
  573. package/src/commands/ln.d.ts.map +0 -1
  574. package/src/commands/ln.js +0 -66
  575. package/src/commands/ls.d.ts.map +0 -1
  576. package/src/commands/ls.js +0 -200
  577. package/src/commands/lsb-release.d.ts.map +0 -1
  578. package/src/commands/lsb-release.js +0 -61
  579. package/src/commands/man.d.ts.map +0 -1
  580. package/src/commands/man.js +0 -49
  581. package/src/commands/mkdir.d.ts.map +0 -1
  582. package/src/commands/mkdir.js +0 -28
  583. package/src/commands/mv.d.ts.map +0 -1
  584. package/src/commands/mv.js +0 -42
  585. package/src/commands/nano.d.ts.map +0 -1
  586. package/src/commands/nano.js +0 -34
  587. package/src/commands/neofetch.d.ts.map +0 -1
  588. package/src/commands/neofetch.js +0 -48
  589. package/src/commands/node.d.ts.map +0 -1
  590. package/src/commands/node.js +0 -316
  591. package/src/commands/npm.d.ts.map +0 -1
  592. package/src/commands/npm.js +0 -109
  593. package/src/commands/passwd.d.ts.map +0 -1
  594. package/src/commands/passwd.js +0 -44
  595. package/src/commands/ping.d.ts.map +0 -1
  596. package/src/commands/ping.js +0 -28
  597. package/src/commands/printf.d.ts.map +0 -1
  598. package/src/commands/printf.js +0 -144
  599. package/src/commands/ps.d.ts.map +0 -1
  600. package/src/commands/ps.js +0 -46
  601. package/src/commands/pwd.d.ts.map +0 -1
  602. package/src/commands/pwd.js +0 -7
  603. package/src/commands/python.d.ts.map +0 -1
  604. package/src/commands/python.js +0 -2058
  605. package/src/commands/read.d.ts.map +0 -1
  606. package/src/commands/read.js +0 -39
  607. package/src/commands/registry.d.ts.map +0 -1
  608. package/src/commands/registry.js +0 -234
  609. package/src/commands/rm.d.ts.map +0 -1
  610. package/src/commands/rm.js +0 -36
  611. package/src/commands/runtime.d.ts.map +0 -1
  612. package/src/commands/runtime.js +0 -285
  613. package/src/commands/sed.d.ts.map +0 -1
  614. package/src/commands/sed.js +0 -60
  615. package/src/commands/seq.d.ts.map +0 -1
  616. package/src/commands/seq.js +0 -50
  617. package/src/commands/set.d.ts.map +0 -1
  618. package/src/commands/set.js +0 -26
  619. package/src/commands/sh.d.ts.map +0 -1
  620. package/src/commands/sh.js +0 -431
  621. package/src/commands/shift.d.ts.map +0 -1
  622. package/src/commands/shift.js +0 -62
  623. package/src/commands/sleep.d.ts.map +0 -1
  624. package/src/commands/sleep.js +0 -18
  625. package/src/commands/sort.d.ts.map +0 -1
  626. package/src/commands/sort.js +0 -44
  627. package/src/commands/source.d.ts.map +0 -1
  628. package/src/commands/source.js +0 -39
  629. package/src/commands/stat.d.ts.map +0 -1
  630. package/src/commands/stat.js +0 -56
  631. package/src/commands/su.d.ts.map +0 -1
  632. package/src/commands/su.js +0 -57
  633. package/src/commands/sudo.d.ts.map +0 -1
  634. package/src/commands/sudo.js +0 -54
  635. package/src/commands/tail.d.ts.map +0 -1
  636. package/src/commands/tail.js +0 -47
  637. package/src/commands/tar.d.ts.map +0 -1
  638. package/src/commands/tar.js +0 -102
  639. package/src/commands/tee.d.ts.map +0 -1
  640. package/src/commands/tee.js +0 -36
  641. package/src/commands/test.d.ts.map +0 -1
  642. package/src/commands/test.js +0 -114
  643. package/src/commands/touch.d.ts.map +0 -1
  644. package/src/commands/touch.js +0 -25
  645. package/src/commands/tr.d.ts.map +0 -1
  646. package/src/commands/tr.js +0 -61
  647. package/src/commands/tree.d.ts.map +0 -1
  648. package/src/commands/tree.js +0 -18
  649. package/src/commands/true.d.ts.map +0 -1
  650. package/src/commands/true.js +0 -24
  651. package/src/commands/type.d.ts.map +0 -1
  652. package/src/commands/type.js +0 -39
  653. package/src/commands/uname.d.ts.map +0 -1
  654. package/src/commands/uname.js +0 -29
  655. package/src/commands/uniq.d.ts.map +0 -1
  656. package/src/commands/uniq.js +0 -38
  657. package/src/commands/unset.d.ts.map +0 -1
  658. package/src/commands/unset.js +0 -16
  659. package/src/commands/uptime.d.ts.map +0 -1
  660. package/src/commands/uptime.js +0 -48
  661. package/src/commands/wc.d.ts.map +0 -1
  662. package/src/commands/wc.js +0 -55
  663. package/src/commands/wget.d.ts.map +0 -1
  664. package/src/commands/wget.js +0 -126
  665. package/src/commands/which.d.ts.map +0 -1
  666. package/src/commands/which.js +0 -32
  667. package/src/commands/who.d.ts.map +0 -1
  668. package/src/commands/who.js +0 -22
  669. package/src/commands/whoami.d.ts.map +0 -1
  670. package/src/commands/whoami.js +0 -12
  671. package/src/commands/xargs.d.ts.map +0 -1
  672. package/src/commands/xargs.js +0 -21
  673. package/src/index.d.ts.map +0 -1
  674. package/src/index.js +0 -9
  675. package/src/modules/linuxRootfs.d.ts.map +0 -1
  676. package/src/modules/linuxRootfs.js +0 -619
  677. package/src/modules/neofetch.d.ts.map +0 -1
  678. package/src/modules/neofetch.js +0 -284
  679. package/src/modules/shellInteractive.d.ts.map +0 -1
  680. package/src/modules/shellInteractive.js +0 -26
  681. package/src/modules/shellRuntime.d.ts.map +0 -1
  682. package/src/modules/shellRuntime.js +0 -52
  683. package/src/self-standalone.d.ts.map +0 -1
  684. package/src/self-standalone.js +0 -418
  685. package/src/standalone-wo-sftp.d.ts.map +0 -1
  686. package/src/standalone-wo-sftp.js +0 -30
  687. package/src/standalone.d.ts.map +0 -1
  688. package/src/standalone.js +0 -35
  689. package/src/types/commands.d.ts.map +0 -1
  690. package/src/types/commands.js +0 -0
  691. package/src/types/pipeline.d.ts.map +0 -1
  692. package/src/types/pipeline.js +0 -0
  693. package/src/types/streams.d.ts.map +0 -1
  694. package/src/types/streams.js +0 -0
  695. package/src/types/vfs.d.ts.map +0 -1
  696. package/src/types/vfs.js +0 -0
  697. package/src/utils/expand.d.ts.map +0 -1
  698. package/src/utils/expand.js +0 -476
  699. package/src/utils/perfLogger.d.ts.map +0 -1
  700. package/src/utils/perfLogger.js +0 -49
  701. package/src/utils/tokenize.d.ts.map +0 -1
  702. package/src/utils/tokenize.js +0 -114
  703. package/src/utils/vfsDiff.d.ts.map +0 -1
  704. package/src/utils/vfsDiff.js +0 -177
  705. package/src/web-api.d.ts.map +0 -1
  706. package/src/web-api.js +0 -46
  707. package/src/web-full.d.ts.map +0 -1
  708. package/src/web-full.js +0 -8
  709. package/src/web.d.ts.map +0 -1
  710. package/src/web.js +0 -773
  711. package/tests/command-helpers.test.d.ts +0 -2
  712. package/tests/command-helpers.test.d.ts.map +0 -1
  713. package/tests/command-helpers.test.js +0 -92
  714. package/tests/commands-admin-net.test.d.ts +0 -2
  715. package/tests/commands-admin-net.test.d.ts.map +0 -1
  716. package/tests/commands-admin-net.test.js +0 -353
  717. package/tests/commands-advanced.test.d.ts +0 -2
  718. package/tests/commands-advanced.test.d.ts.map +0 -1
  719. package/tests/commands-advanced.test.js +0 -378
  720. package/tests/commands-core.test.d.ts +0 -2
  721. package/tests/commands-core.test.d.ts.map +0 -1
  722. package/tests/commands-core.test.js +0 -477
  723. package/tests/commands-missing.test.d.ts +0 -2
  724. package/tests/commands-missing.test.d.ts.map +0 -1
  725. package/tests/commands-missing.test.js +0 -470
  726. package/tests/commands-specific-units.test.d.ts +0 -2
  727. package/tests/commands-specific-units.test.d.ts.map +0 -1
  728. package/tests/commands-specific-units.test.js +0 -264
  729. package/tests/commands-text-sys.test.d.ts +0 -2
  730. package/tests/commands-text-sys.test.d.ts.map +0 -1
  731. package/tests/commands-text-sys.test.js +0 -366
  732. package/tests/expand.test.d.ts +0 -2
  733. package/tests/expand.test.d.ts.map +0 -1
  734. package/tests/expand.test.js +0 -138
  735. package/tests/helpers.test.d.ts +0 -2
  736. package/tests/helpers.test.d.ts.map +0 -1
  737. package/tests/helpers.test.js +0 -52
  738. package/tests/new-features.test.d.ts +0 -2
  739. package/tests/new-features.test.d.ts.map +0 -1
  740. package/tests/new-features.test.js +0 -850
  741. package/tests/parser-executor.test.d.ts +0 -2
  742. package/tests/parser-executor.test.d.ts.map +0 -1
  743. package/tests/parser-executor.test.js +0 -25
  744. package/tests/sftp.test.d.ts +0 -2
  745. package/tests/sftp.test.d.ts.map +0 -1
  746. package/tests/sftp.test.js +0 -246
  747. package/tests/ssh-exec.test.d.ts +0 -2
  748. package/tests/ssh-exec.test.d.ts.map +0 -1
  749. package/tests/ssh-exec.test.js +0 -39
  750. package/tests/test-helper.d.ts +0 -56
  751. package/tests/test-helper.d.ts.map +0 -1
  752. package/tests/test-helper.js +0 -71
  753. package/tests/users.test.d.ts +0 -2
  754. package/tests/users.test.d.ts.map +0 -1
  755. package/tests/users.test.js +0 -71
  756. package/tests/web.test.d.ts +0 -2
  757. package/tests/web.test.d.ts.map +0 -1
  758. package/tests/web.test.js +0 -149
  759. /package/{src → dist}/Honeypot/index.d.ts +0 -0
  760. /package/{src → dist}/SSHClient/index.d.ts +0 -0
  761. /package/{src → dist}/SSHMimic/exec.d.ts +0 -0
  762. /package/{src → dist}/SSHMimic/executor.d.ts +0 -0
  763. /package/{src → dist}/SSHMimic/hostKey.d.ts +0 -0
  764. /package/{src → dist}/SSHMimic/index.d.ts +0 -0
  765. /package/{src → dist}/SSHMimic/loginBanner.d.ts +0 -0
  766. /package/{src → dist}/SSHMimic/loginFormat.d.ts +0 -0
  767. /package/{src → dist}/SSHMimic/prompt.d.ts +0 -0
  768. /package/{src → dist}/SSHMimic/sftp.d.ts +0 -0
  769. /package/{src → dist}/VirtualFileSystem/binaryPack.d.ts +0 -0
  770. /package/{src → dist}/VirtualFileSystem/index.d.ts +0 -0
  771. /package/{src → dist}/VirtualFileSystem/internalTypes.d.ts +0 -0
  772. /package/{src → dist}/VirtualFileSystem/path.d.ts +0 -0
  773. /package/{src → dist}/VirtualPackageManager/index.d.ts +0 -0
  774. /package/{src → dist}/VirtualShell/index.d.ts +0 -0
  775. /package/{src → dist}/VirtualShell/shell.d.ts +0 -0
  776. /package/{src → dist}/VirtualShell/shellParser.d.ts +0 -0
  777. /package/{src → dist}/VirtualUserManager/index.d.ts +0 -0
  778. /package/{src → dist}/commands/adduser.d.ts +0 -0
  779. /package/{src → dist}/commands/alias.d.ts +0 -0
  780. /package/{src → dist}/commands/apt.d.ts +0 -0
  781. /package/{src → dist}/commands/awk.d.ts +0 -0
  782. /package/{src → dist}/commands/base64.d.ts +0 -0
  783. /package/{src → dist}/commands/cat.d.ts +0 -0
  784. /package/{src → dist}/commands/cd.d.ts +0 -0
  785. /package/{src → dist}/commands/chmod.d.ts +0 -0
  786. /package/{src → dist}/commands/clear.d.ts +0 -0
  787. /package/{src → dist}/commands/command-helpers.d.ts +0 -0
  788. /package/{src → dist}/commands/cp.d.ts +0 -0
  789. /package/{src → dist}/commands/curl.d.ts +0 -0
  790. /package/{src → dist}/commands/cut.d.ts +0 -0
  791. /package/{src → dist}/commands/date.d.ts +0 -0
  792. /package/{src → dist}/commands/declare.d.ts +0 -0
  793. /package/{src → dist}/commands/deluser.d.ts +0 -0
  794. /package/{src → dist}/commands/df.d.ts +0 -0
  795. /package/{src → dist}/commands/diff.d.ts +0 -0
  796. /package/{src → dist}/commands/dpkg.d.ts +0 -0
  797. /package/{src → dist}/commands/du.d.ts +0 -0
  798. /package/{src → dist}/commands/echo.d.ts +0 -0
  799. /package/{src → dist}/commands/env.d.ts +0 -0
  800. /package/{src → dist}/commands/exit.d.ts +0 -0
  801. /package/{src → dist}/commands/export.d.ts +0 -0
  802. /package/{src → dist}/commands/find.d.ts +0 -0
  803. /package/{src → dist}/commands/free.d.ts +0 -0
  804. /package/{src → dist}/commands/grep.d.ts +0 -0
  805. /package/{src → dist}/commands/groups.d.ts +0 -0
  806. /package/{src → dist}/commands/gzip.d.ts +0 -0
  807. /package/{src → dist}/commands/head.d.ts +0 -0
  808. /package/{src → dist}/commands/help.d.ts +0 -0
  809. /package/{src → dist}/commands/helpers.d.ts +0 -0
  810. /package/{src → dist}/commands/history.d.ts +0 -0
  811. /package/{src → dist}/commands/hostname.d.ts +0 -0
  812. /package/{src → dist}/commands/htop.d.ts +0 -0
  813. /package/{src → dist}/commands/id.d.ts +0 -0
  814. /package/{src → dist}/commands/index.d.ts +0 -0
  815. /package/{src → dist}/commands/kill.d.ts +0 -0
  816. /package/{src → dist}/commands/ln.d.ts +0 -0
  817. /package/{src → dist}/commands/ls.d.ts +0 -0
  818. /package/{src → dist}/commands/lsb-release.d.ts +0 -0
  819. /package/{src → dist}/commands/man.d.ts +0 -0
  820. /package/{src → dist}/commands/mkdir.d.ts +0 -0
  821. /package/{src → dist}/commands/mv.d.ts +0 -0
  822. /package/{src → dist}/commands/nano.d.ts +0 -0
  823. /package/{src → dist}/commands/neofetch.d.ts +0 -0
  824. /package/{src → dist}/commands/node.d.ts +0 -0
  825. /package/{src → dist}/commands/npm.d.ts +0 -0
  826. /package/{src → dist}/commands/passwd.d.ts +0 -0
  827. /package/{src → dist}/commands/ping.d.ts +0 -0
  828. /package/{src → dist}/commands/printf.d.ts +0 -0
  829. /package/{src → dist}/commands/ps.d.ts +0 -0
  830. /package/{src → dist}/commands/pwd.d.ts +0 -0
  831. /package/{src → dist}/commands/python.d.ts +0 -0
  832. /package/{src → dist}/commands/read.d.ts +0 -0
  833. /package/{src → dist}/commands/registry.d.ts +0 -0
  834. /package/{src → dist}/commands/rm.d.ts +0 -0
  835. /package/{src → dist}/commands/runtime.d.ts +0 -0
  836. /package/{src → dist}/commands/sed.d.ts +0 -0
  837. /package/{src → dist}/commands/seq.d.ts +0 -0
  838. /package/{src → dist}/commands/set.d.ts +0 -0
  839. /package/{src → dist}/commands/sh.d.ts +0 -0
  840. /package/{src → dist}/commands/shift.d.ts +0 -0
  841. /package/{src → dist}/commands/sleep.d.ts +0 -0
  842. /package/{src → dist}/commands/sort.d.ts +0 -0
  843. /package/{src → dist}/commands/source.d.ts +0 -0
  844. /package/{src → dist}/commands/stat.d.ts +0 -0
  845. /package/{src → dist}/commands/su.d.ts +0 -0
  846. /package/{src → dist}/commands/sudo.d.ts +0 -0
  847. /package/{src → dist}/commands/tail.d.ts +0 -0
  848. /package/{src → dist}/commands/tar.d.ts +0 -0
  849. /package/{src → dist}/commands/tee.d.ts +0 -0
  850. /package/{src → dist}/commands/test.d.ts +0 -0
  851. /package/{src → dist}/commands/touch.d.ts +0 -0
  852. /package/{src → dist}/commands/tr.d.ts +0 -0
  853. /package/{src → dist}/commands/tree.d.ts +0 -0
  854. /package/{src → dist}/commands/true.d.ts +0 -0
  855. /package/{src → dist}/commands/type.d.ts +0 -0
  856. /package/{src → dist}/commands/uname.d.ts +0 -0
  857. /package/{src → dist}/commands/uniq.d.ts +0 -0
  858. /package/{src → dist}/commands/unset.d.ts +0 -0
  859. /package/{src → dist}/commands/uptime.d.ts +0 -0
  860. /package/{src → dist}/commands/wc.d.ts +0 -0
  861. /package/{src → dist}/commands/wget.d.ts +0 -0
  862. /package/{src → dist}/commands/which.d.ts +0 -0
  863. /package/{src → dist}/commands/who.d.ts +0 -0
  864. /package/{src → dist}/commands/whoami.d.ts +0 -0
  865. /package/{src → dist}/commands/xargs.d.ts +0 -0
  866. /package/{src → dist}/index.d.ts +0 -0
  867. /package/{src → dist}/modules/linuxRootfs.d.ts +0 -0
  868. /package/{src → dist}/modules/neofetch.d.ts +0 -0
  869. /package/{src → dist}/modules/shellInteractive.d.ts +0 -0
  870. /package/{src → dist}/modules/shellRuntime.d.ts +0 -0
  871. /package/{src → dist}/self-standalone.d.ts +0 -0
  872. /package/{src → dist}/standalone-wo-sftp.d.ts +0 -0
  873. /package/{src → dist}/standalone.d.ts +0 -0
  874. /package/{src → dist}/types/commands.d.ts +0 -0
  875. /package/{src → dist}/types/pipeline.d.ts +0 -0
  876. /package/{src → dist}/types/streams.d.ts +0 -0
  877. /package/{src → dist}/types/vfs.d.ts +0 -0
  878. /package/{src → dist}/utils/expand.d.ts +0 -0
  879. /package/{src → dist}/utils/perfLogger.d.ts +0 -0
  880. /package/{src → dist}/utils/tokenize.d.ts +0 -0
  881. /package/{src → dist}/utils/vfsDiff.d.ts +0 -0
  882. /package/{src → dist}/web-api.d.ts +0 -0
  883. /package/{src → dist}/web-full.d.ts +0 -0
  884. /package/{src → dist}/web.d.ts +0 -0
@@ -0,0 +1,690 @@
1
+ import { EventEmitter } from "node:events";
2
+ import * as fsSync from "node:fs";
3
+ import * as path from "node:path";
4
+ import { gunzipSync, gzipSync } from "node:zlib";
5
+ import { decodeVfs, encodeVfs, isBinarySnapshot } from "./binaryPack";
6
+ import { getNode, getParentDirectory, normalizePath } from "./path";
7
+ // ── VirtualFileSystem ─────────────────────────────────────────────────────────
8
+ /**
9
+ * In-memory virtual filesystem with optional JSON-snapshot persistence.
10
+ *
11
+ * **Memory mode** (default) — all state lives in a fast recursive tree.
12
+ * Use `toSnapshot()` / `fromSnapshot()` / `importSnapshot()` for serialisation.
13
+ *
14
+ * **FS mode** — same in-memory tree, but `restoreMirror()` loads a binary
15
+ * snapshot from disk and `flushMirror()` writes it back. This gives you
16
+ * persistent VFS state across process restarts without any real POSIX filesystem
17
+ * semantics leaking through.
18
+ *
19
+ * @example
20
+ * ```ts
21
+ * // Pure in-memory (default)
22
+ * const vfs = new VirtualFileSystem();
23
+ *
24
+ * // With disk persistence
25
+ * const vfs = new VirtualFileSystem({ mode: "fs", snapshotPath: "./data" });
26
+ * await vfs.restoreMirror(); // load from disk (no-op if no snapshot yet)
27
+ * // ... use vfs ...
28
+ * await vfs.flushMirror(); // persist to disk
29
+ * ```
30
+ */
31
+ class VirtualFileSystem extends EventEmitter {
32
+ root;
33
+ mode;
34
+ snapshotFile;
35
+ /** Active host-directory mounts: vPath → { hostPath, readOnly } */
36
+ mounts = new Map();
37
+ /** True when running in a browser environment (no host FS access). */
38
+ static isBrowser = typeof process === "undefined" || typeof process.versions?.node === "undefined";
39
+ constructor(options = {}) {
40
+ super();
41
+ this.mode = options.mode ?? "memory";
42
+ if (this.mode === "fs") {
43
+ if (!options.snapshotPath) {
44
+ throw new Error('VirtualFileSystem: "snapshotPath" is required when mode is "fs".');
45
+ }
46
+ this.snapshotFile = path.resolve(options.snapshotPath, "vfs-snapshot.vfsb");
47
+ }
48
+ else {
49
+ this.snapshotFile = null;
50
+ }
51
+ this.root = this.makeDir("", 0o755);
52
+ }
53
+ // ── Internal helpers ──────────────────────────────────────────────────────
54
+ makeDir(name, mode) {
55
+ const now = new Date();
56
+ return {
57
+ type: "directory",
58
+ name,
59
+ mode,
60
+ createdAt: now,
61
+ updatedAt: now,
62
+ children: new Map(),
63
+ };
64
+ }
65
+ makeFile(name, content, mode, compressed) {
66
+ const now = new Date();
67
+ return {
68
+ type: "file",
69
+ name,
70
+ content,
71
+ mode,
72
+ compressed,
73
+ createdAt: now,
74
+ updatedAt: now,
75
+ };
76
+ }
77
+ mkdirRecursive(targetPath, mode) {
78
+ const normalized = normalizePath(targetPath);
79
+ if (normalized === "/")
80
+ return;
81
+ const parts = normalized.split("/").filter(Boolean);
82
+ let current = this.root;
83
+ let builtPath = "";
84
+ for (const part of parts) {
85
+ builtPath += `/${part}`;
86
+ let child = current.children.get(part);
87
+ if (!child) {
88
+ child = this.makeDir(part, mode);
89
+ current.children.set(part, child);
90
+ this.emit("dir:create", { path: builtPath, mode });
91
+ }
92
+ else if (child.type !== "directory") {
93
+ throw new Error(`Cannot create directory '${builtPath}': path is a file.`);
94
+ }
95
+ current = child;
96
+ }
97
+ }
98
+ // ── Persistence ───────────────────────────────────────────────────────────
99
+ /**
100
+ * In `"fs"` mode: reads the binary snapshot (`vfs-snapshot.vfsb`) from disk.
101
+ * Automatically falls back to legacy JSON format for backward compatibility.
102
+ * Silently succeeds when the snapshot file does not exist yet.
103
+ *
104
+ * In `"memory"` mode: no-op (kept for API compatibility).
105
+ */
106
+ async restoreMirror() {
107
+ if (this.mode !== "fs" || !this.snapshotFile)
108
+ return;
109
+ if (!fsSync.existsSync(this.snapshotFile))
110
+ return;
111
+ try {
112
+ const raw = fsSync.readFileSync(this.snapshotFile);
113
+ if (isBinarySnapshot(raw)) {
114
+ // Fast binary format (current)
115
+ this.root = decodeVfs(raw);
116
+ }
117
+ else {
118
+ // Legacy JSON fallback — auto-migrates on next flushMirror()
119
+ const snapshot = JSON.parse(raw.toString("utf8"));
120
+ this.root = this.deserializeDir(snapshot.root, "");
121
+ console.info("[VirtualFileSystem] Migrating legacy JSON snapshot to binary format.");
122
+ }
123
+ this.emit("snapshot:restore", { path: this.snapshotFile });
124
+ }
125
+ catch (err) {
126
+ // Corrupt or unreadable snapshot — start fresh and warn
127
+ console.warn(`[VirtualFileSystem] Could not restore snapshot from ${this.snapshotFile}:`, err instanceof Error ? err.message : String(err));
128
+ }
129
+ }
130
+ /**
131
+ * In `"fs"` mode: serialises the in-memory tree to a binary snapshot on disk
132
+ * (`vfs-snapshot.vfsb`). ~27% smaller and significantly faster than JSON+base64.
133
+ * The directory is created if it does not exist.
134
+ *
135
+ * In `"memory"` mode: emits `"mirror:flush"` and returns (no disk write).
136
+ */
137
+ async flushMirror() {
138
+ if (this.mode !== "fs" || !this.snapshotFile) {
139
+ this.emit("mirror:flush");
140
+ return;
141
+ }
142
+ const dir = path.dirname(this.snapshotFile);
143
+ fsSync.mkdirSync(dir, { recursive: true });
144
+ const binary = encodeVfs(this.root);
145
+ fsSync.writeFileSync(this.snapshotFile, binary);
146
+ this.emit("mirror:flush", { path: this.snapshotFile });
147
+ }
148
+ /** Returns the current persistence mode. */
149
+ getMode() {
150
+ return this.mode;
151
+ }
152
+ /** Returns the snapshot file path used in `"fs"` mode, or `null`. */
153
+ getSnapshotPath() {
154
+ return this.snapshotFile;
155
+ }
156
+ // ── Public filesystem API ─────────────────────────────────────────────────
157
+ /** Creates a directory (and any missing parents). */
158
+ // ── Mount API ─────────────────────────────────────────────────────────────
159
+ /**
160
+ * Mount a host directory into the VFS at `vPath`.
161
+ *
162
+ * Files inside `vPath` are read directly from the host filesystem via
163
+ * `node:fs`. All standard VFS operations (`readFile`, `writeFile`,
164
+ * `exists`, `stat`, `list`) are transparently delegated.
165
+ *
166
+ * In browser environments the mount is silently ignored — `vPath` remains
167
+ * an empty in-memory directory.
168
+ *
169
+ * @param vPath Absolute path inside the VM (e.g. `"/app"`).
170
+ * @param hostPath Path on the host filesystem — relative paths are
171
+ * resolved from `process.cwd()`.
172
+ * @param readOnly When `true` (default), write operations inside the
173
+ * mount throw `EROFS: read-only file system`.
174
+ *
175
+ * @example
176
+ * ```ts
177
+ * shell.vfs.mount("/app", "./src", { readOnly: true });
178
+ * // cat /app/index.ts — reads ./src/index.ts from host
179
+ * ```
180
+ */
181
+ mount(vPath, hostPath, { readOnly = true } = {}) {
182
+ if (VirtualFileSystem.isBrowser)
183
+ return; // silently degrade in browser
184
+ const normalized = normalizePath(vPath);
185
+ const resolved = path.resolve(hostPath);
186
+ if (!fsSync.existsSync(resolved)) {
187
+ throw new Error(`VirtualFileSystem.mount: host path does not exist: "${resolved}"`);
188
+ }
189
+ if (!fsSync.statSync(resolved).isDirectory()) {
190
+ throw new Error(`VirtualFileSystem.mount: host path is not a directory: "${resolved}"`);
191
+ }
192
+ // Ensure the mount point exists in the VFS tree
193
+ this.mkdir(normalized);
194
+ this.mounts.set(normalized, { hostPath: resolved, readOnly });
195
+ this.emit("mount", { vPath: normalized, hostPath: resolved, readOnly });
196
+ }
197
+ /**
198
+ * Unmount a previously mounted host directory.
199
+ * The in-memory VFS directory at `vPath` is preserved but the host
200
+ * delegation is removed.
201
+ */
202
+ unmount(vPath) {
203
+ const normalized = normalizePath(vPath);
204
+ if (this.mounts.delete(normalized)) {
205
+ this.emit("unmount", { vPath: normalized });
206
+ }
207
+ }
208
+ /** List all active mounts. */
209
+ getMounts() {
210
+ return [...this.mounts.entries()].map(([vPath, opts]) => ({
211
+ vPath, ...opts,
212
+ }));
213
+ }
214
+ /**
215
+ * If `targetPath` is inside a mount, return `{ hostPath, readOnly, relPath }`.
216
+ * `relPath` is the path relative to the mount's host directory.
217
+ * Returns `null` if the path is not under any mount.
218
+ */
219
+ resolveMount(targetPath) {
220
+ const normalized = normalizePath(targetPath);
221
+ // Iterate mounts from most specific to least specific
222
+ const sorted = [...this.mounts.entries()].sort(([a], [b]) => b.length - a.length);
223
+ for (const [vBase, opts] of sorted) {
224
+ if (normalized === vBase || normalized.startsWith(`${vBase}/`)) {
225
+ const relPath = normalized.slice(vBase.length).replace(/^\//, "");
226
+ const fullHostPath = relPath ? path.join(opts.hostPath, relPath) : opts.hostPath;
227
+ return { hostPath: opts.hostPath, readOnly: opts.readOnly, relPath, fullHostPath };
228
+ }
229
+ }
230
+ return null;
231
+ }
232
+ mkdir(targetPath, mode = 0o755) {
233
+ const normalized = normalizePath(targetPath);
234
+ const existing = (() => {
235
+ try {
236
+ return getNode(this.root, normalized);
237
+ }
238
+ catch {
239
+ return null;
240
+ }
241
+ })();
242
+ if (existing && existing.type !== "directory") {
243
+ throw new Error(`Cannot create directory '${normalized}': path is a file.`);
244
+ }
245
+ this.mkdirRecursive(normalized, mode);
246
+ }
247
+ /**
248
+ * Writes UTF-8 text or binary content into a file.
249
+ * Parent directories are created when missing.
250
+ */
251
+ writeFile(targetPath, content, options = {}) {
252
+ // Delegate to host FS if inside a mount
253
+ const m = this.resolveMount(targetPath);
254
+ if (m) {
255
+ if (m.readOnly)
256
+ throw new Error(`EROFS: read-only file system, open '${m.fullHostPath}'`);
257
+ const dir = path.dirname(m.fullHostPath);
258
+ if (!fsSync.existsSync(dir))
259
+ fsSync.mkdirSync(dir, { recursive: true });
260
+ fsSync.writeFileSync(m.fullHostPath, Buffer.isBuffer(content) ? content : Buffer.from(content, "utf8"));
261
+ return;
262
+ }
263
+ const normalized = normalizePath(targetPath);
264
+ const { parent, name } = getParentDirectory(this.root, normalized, true, (p) => this.mkdirRecursive(p, 0o755));
265
+ const existing = parent.children.get(name);
266
+ if (existing?.type === "directory") {
267
+ throw new Error(`Cannot write file '${normalized}': path is a directory.`);
268
+ }
269
+ const rawContent = Buffer.isBuffer(content)
270
+ ? content
271
+ : Buffer.from(content, "utf8");
272
+ const shouldCompress = options.compress ?? false;
273
+ const storedContent = shouldCompress ? gzipSync(rawContent) : rawContent;
274
+ const mode = options.mode ?? 0o644;
275
+ if (existing) {
276
+ const f = existing;
277
+ f.content = storedContent;
278
+ f.compressed = shouldCompress;
279
+ f.mode = mode;
280
+ f.updatedAt = new Date();
281
+ }
282
+ else {
283
+ parent.children.set(name, this.makeFile(name, storedContent, mode, shouldCompress));
284
+ }
285
+ this.emit("file:write", { path: normalized, size: storedContent.length });
286
+ }
287
+ /**
288
+ * Reads file content as a UTF-8 string.
289
+ * Gzip-compressed files are transparently decompressed.
290
+ */
291
+ readFile(targetPath) {
292
+ const m = this.resolveMount(targetPath);
293
+ if (m) {
294
+ if (!fsSync.existsSync(m.fullHostPath))
295
+ throw new Error(`ENOENT: no such file or directory, open '${m.fullHostPath}'`);
296
+ return fsSync.readFileSync(m.fullHostPath, "utf8");
297
+ }
298
+ const normalized = normalizePath(targetPath);
299
+ const node = getNode(this.root, normalized);
300
+ if (node.type !== "file") {
301
+ throw new Error(`Cannot read '${targetPath}': not a file.`);
302
+ }
303
+ const f = node;
304
+ const raw = f.compressed ? gunzipSync(f.content) : f.content;
305
+ this.emit("file:read", { path: normalized, size: raw.length });
306
+ return raw.toString("utf8");
307
+ }
308
+ /** Reads file content as a Buffer (decompresses if needed). */
309
+ readFileRaw(targetPath) {
310
+ const m = this.resolveMount(targetPath);
311
+ if (m) {
312
+ if (!fsSync.existsSync(m.fullHostPath))
313
+ throw new Error(`ENOENT: no such file or directory, open '${m.fullHostPath}'`);
314
+ return fsSync.readFileSync(m.fullHostPath);
315
+ }
316
+ const normalized = normalizePath(targetPath);
317
+ const node = getNode(this.root, normalized);
318
+ if (node.type !== "file") {
319
+ throw new Error(`Cannot read '${targetPath}': not a file.`);
320
+ }
321
+ const f = node;
322
+ const raw = f.compressed ? gunzipSync(f.content) : f.content;
323
+ this.emit("file:read", { path: normalized, size: raw.length });
324
+ return raw;
325
+ }
326
+ /** Returns true when a file or directory exists at path. */
327
+ exists(targetPath) {
328
+ const m = this.resolveMount(targetPath);
329
+ if (m)
330
+ return fsSync.existsSync(m.fullHostPath);
331
+ try {
332
+ getNode(this.root, normalizePath(targetPath));
333
+ return true;
334
+ }
335
+ catch {
336
+ return false;
337
+ }
338
+ }
339
+ /** Updates mode bits on a node. */
340
+ chmod(targetPath, mode) {
341
+ getNode(this.root, normalizePath(targetPath)).mode = mode;
342
+ }
343
+ /** Returns metadata for a file or directory. */
344
+ stat(targetPath) {
345
+ const m = this.resolveMount(targetPath);
346
+ if (m) {
347
+ if (!fsSync.existsSync(m.fullHostPath))
348
+ throw new Error(`ENOENT: stat '${m.fullHostPath}'`);
349
+ const hst = fsSync.statSync(m.fullHostPath);
350
+ const name = m.relPath.split("/").pop() ?? m.fullHostPath.split("/").pop() ?? "";
351
+ const now = hst.mtime;
352
+ if (hst.isDirectory()) {
353
+ return {
354
+ type: "directory",
355
+ name,
356
+ path: normalizePath(targetPath),
357
+ mode: 0o755,
358
+ createdAt: hst.birthtime,
359
+ updatedAt: now,
360
+ childrenCount: fsSync.readdirSync(m.fullHostPath).length,
361
+ };
362
+ }
363
+ return {
364
+ type: "file",
365
+ name,
366
+ path: normalizePath(targetPath),
367
+ mode: m.readOnly ? 0o444 : 0o644,
368
+ createdAt: hst.birthtime,
369
+ updatedAt: now,
370
+ compressed: false,
371
+ size: hst.size,
372
+ };
373
+ }
374
+ const normalized = normalizePath(targetPath);
375
+ const node = getNode(this.root, normalized);
376
+ const name = normalized === "/" ? "" : path.posix.basename(normalized);
377
+ if (node.type === "file") {
378
+ const f = node;
379
+ return {
380
+ type: "file",
381
+ name,
382
+ path: normalized,
383
+ mode: f.mode,
384
+ createdAt: f.createdAt,
385
+ updatedAt: f.updatedAt,
386
+ compressed: f.compressed,
387
+ size: f.content.length,
388
+ };
389
+ }
390
+ const d = node;
391
+ return {
392
+ type: "directory",
393
+ name,
394
+ path: normalized,
395
+ mode: d.mode,
396
+ createdAt: d.createdAt,
397
+ updatedAt: d.updatedAt,
398
+ childrenCount: d.children.size,
399
+ };
400
+ }
401
+ /** Lists direct children names of a directory (sorted). */
402
+ list(dirPath = "/") {
403
+ const m = this.resolveMount(dirPath);
404
+ if (m) {
405
+ if (!fsSync.existsSync(m.fullHostPath))
406
+ return [];
407
+ try {
408
+ return fsSync.readdirSync(m.fullHostPath).sort();
409
+ }
410
+ catch {
411
+ return [];
412
+ }
413
+ }
414
+ const normalized = normalizePath(dirPath);
415
+ const node = getNode(this.root, normalized);
416
+ if (node.type !== "directory") {
417
+ throw new Error(`Cannot list '${dirPath}': not a directory.`);
418
+ }
419
+ return Array.from(node.children.keys()).sort();
420
+ }
421
+ /** Renders ASCII tree view of a directory hierarchy. */
422
+ tree(dirPath = "/") {
423
+ const normalized = normalizePath(dirPath);
424
+ const node = getNode(this.root, normalized);
425
+ if (node.type !== "directory") {
426
+ throw new Error(`Cannot render tree for '${dirPath}': not a directory.`);
427
+ }
428
+ const label = dirPath === "/" ? "/" : path.posix.basename(normalized);
429
+ return this.renderTreeLines(node, label);
430
+ }
431
+ renderTreeLines(dir, label) {
432
+ const lines = [label];
433
+ const entries = Array.from(dir.children.keys()).sort();
434
+ for (let i = 0; i < entries.length; i++) {
435
+ const name = entries[i];
436
+ const child = dir.children.get(name);
437
+ const isLast = i === entries.length - 1;
438
+ const connector = isLast ? "└── " : "├── ";
439
+ const nextPrefix = isLast ? " " : "│ ";
440
+ lines.push(`${connector}${name}`);
441
+ if (child.type === "directory") {
442
+ const sub = this.renderTreeLines(child, "")
443
+ .split("\n")
444
+ .slice(1)
445
+ .map((l) => `${nextPrefix}${l}`);
446
+ lines.push(...sub);
447
+ }
448
+ }
449
+ return lines.join("\n");
450
+ }
451
+ /** Computes total stored bytes under a path. */
452
+ getUsageBytes(targetPath = "/") {
453
+ return this.computeUsage(getNode(this.root, normalizePath(targetPath)));
454
+ }
455
+ computeUsage(node) {
456
+ if (node.type === "file")
457
+ return node.content.length;
458
+ let total = 0;
459
+ for (const child of node.children.values()) {
460
+ total += this.computeUsage(child);
461
+ }
462
+ return total;
463
+ }
464
+ /** Compresses a file's content with gzip in place. */
465
+ compressFile(targetPath) {
466
+ const node = getNode(this.root, normalizePath(targetPath));
467
+ if (node.type !== "file")
468
+ throw new Error(`Cannot compress '${targetPath}': not a file.`);
469
+ const f = node;
470
+ if (!f.compressed) {
471
+ f.content = gzipSync(f.content);
472
+ f.compressed = true;
473
+ f.updatedAt = new Date();
474
+ }
475
+ }
476
+ /** Decompresses a gzip-compressed file in place. */
477
+ decompressFile(targetPath) {
478
+ const node = getNode(this.root, normalizePath(targetPath));
479
+ if (node.type !== "file")
480
+ throw new Error(`Cannot decompress '${targetPath}': not a file.`);
481
+ const f = node;
482
+ if (f.compressed) {
483
+ f.content = gunzipSync(f.content);
484
+ f.compressed = false;
485
+ f.updatedAt = new Date();
486
+ }
487
+ }
488
+ /**
489
+ * Creates a symbolic link.
490
+ * The link node is stored with mode `0o120777` (POSIX symlink convention).
491
+ */
492
+ symlink(targetPath, linkPath) {
493
+ const normalizedLink = normalizePath(linkPath);
494
+ const normalizedTarget = targetPath.startsWith("/")
495
+ ? normalizePath(targetPath)
496
+ : targetPath;
497
+ const { parent, name } = getParentDirectory(this.root, normalizedLink, true, (p) => this.mkdirRecursive(p, 0o755));
498
+ const symNode = {
499
+ type: "file",
500
+ name,
501
+ content: Buffer.from(normalizedTarget, "utf8"),
502
+ mode: 0o120777,
503
+ compressed: false,
504
+ createdAt: new Date(),
505
+ updatedAt: new Date(),
506
+ };
507
+ parent.children.set(name, symNode);
508
+ this.emit("symlink:create", {
509
+ link: normalizedLink,
510
+ target: normalizedTarget,
511
+ });
512
+ }
513
+ /** Returns true when the path is a symbolic link node. */
514
+ isSymlink(targetPath) {
515
+ try {
516
+ const node = getNode(this.root, normalizePath(targetPath));
517
+ return node.type === "file" && node.mode === 0o120777;
518
+ }
519
+ catch {
520
+ return false;
521
+ }
522
+ }
523
+ /**
524
+ * Resolves a symlink chain up to `maxDepth` hops.
525
+ * Throws when the chain is too long (circular links).
526
+ */
527
+ resolveSymlink(linkPath, maxDepth = 8) {
528
+ let current = normalizePath(linkPath);
529
+ for (let depth = 0; depth < maxDepth; depth++) {
530
+ try {
531
+ const node = getNode(this.root, current);
532
+ if (node.type === "file" && node.mode === 0o120777) {
533
+ const target = node.content.toString("utf8");
534
+ current = target.startsWith("/")
535
+ ? target
536
+ : normalizePath(path.posix.join(path.posix.dirname(current), target));
537
+ continue;
538
+ }
539
+ }
540
+ catch {
541
+ break;
542
+ }
543
+ return current;
544
+ }
545
+ throw new Error(`Too many levels of symbolic links: ${linkPath}`);
546
+ }
547
+ /** Removes a file or directory node. */
548
+ remove(targetPath, options = {}) {
549
+ const m = this.resolveMount(targetPath);
550
+ if (m) {
551
+ if (m.readOnly)
552
+ throw new Error(`EROFS: read-only file system, unlink '${m.fullHostPath}'`);
553
+ if (!fsSync.existsSync(m.fullHostPath))
554
+ throw new Error(`ENOENT: no such file or directory, unlink '${m.fullHostPath}'`);
555
+ const hst = fsSync.statSync(m.fullHostPath);
556
+ if (hst.isDirectory()) {
557
+ fsSync.rmSync(m.fullHostPath, { recursive: options.recursive ?? false });
558
+ }
559
+ else {
560
+ fsSync.unlinkSync(m.fullHostPath);
561
+ }
562
+ return;
563
+ }
564
+ const normalized = normalizePath(targetPath);
565
+ if (normalized === "/")
566
+ throw new Error("Cannot remove root directory.");
567
+ const node = getNode(this.root, normalized);
568
+ if (node.type === "directory") {
569
+ const dir = node;
570
+ if (!options.recursive && dir.children.size > 0) {
571
+ throw new Error(`Directory '${normalized}' is not empty. Use recursive option.`);
572
+ }
573
+ }
574
+ const { parent, name } = getParentDirectory(this.root, normalized, false, () => { });
575
+ parent.children.delete(name);
576
+ this.emit("node:remove", { path: normalized });
577
+ }
578
+ /** Moves or renames a node. */
579
+ move(fromPath, toPath) {
580
+ const fromNormalized = normalizePath(fromPath);
581
+ const toNormalized = normalizePath(toPath);
582
+ if (fromNormalized === "/" || toNormalized === "/") {
583
+ throw new Error("Cannot move root directory.");
584
+ }
585
+ const node = getNode(this.root, fromNormalized);
586
+ if (this.exists(toNormalized)) {
587
+ throw new Error(`Destination '${toNormalized}' already exists.`);
588
+ }
589
+ this.mkdirRecursive(path.posix.dirname(toNormalized), 0o755);
590
+ const { parent: destParent, name: destName } = getParentDirectory(this.root, toNormalized, false, () => { });
591
+ const { parent: srcParent, name: srcName } = getParentDirectory(this.root, fromNormalized, false, () => { });
592
+ srcParent.children.delete(srcName);
593
+ node.name = destName;
594
+ destParent.children.set(destName, node);
595
+ }
596
+ // ── Snapshot serialisation ─────────────────────────────────────────────────
597
+ /**
598
+ * Exports the entire filesystem as a JSON-serialisable snapshot.
599
+ *
600
+ * Works regardless of the persistence mode. Useful for test fixtures,
601
+ * manual backups, or passing VFS state between processes.
602
+ */
603
+ toSnapshot() {
604
+ return { root: this.serializeDir(this.root) };
605
+ }
606
+ serializeDir(dir) {
607
+ const children = [];
608
+ for (const child of dir.children.values()) {
609
+ children.push(child.type === "file"
610
+ ? this.serializeFile(child)
611
+ : this.serializeDir(child));
612
+ }
613
+ return {
614
+ type: "directory",
615
+ name: dir.name,
616
+ mode: dir.mode,
617
+ createdAt: dir.createdAt.toISOString(),
618
+ updatedAt: dir.updatedAt.toISOString(),
619
+ children,
620
+ };
621
+ }
622
+ serializeFile(file) {
623
+ return {
624
+ type: "file",
625
+ name: file.name,
626
+ mode: file.mode,
627
+ createdAt: file.createdAt.toISOString(),
628
+ updatedAt: file.updatedAt.toISOString(),
629
+ compressed: file.compressed,
630
+ contentBase64: file.content.toString("base64"),
631
+ };
632
+ }
633
+ /**
634
+ * Creates a new `VirtualFileSystem` instance (memory mode) from a snapshot.
635
+ *
636
+ * @example
637
+ * ```ts
638
+ * const vfs = VirtualFileSystem.fromSnapshot(savedSnapshot);
639
+ * ```
640
+ */
641
+ static fromSnapshot(snapshot) {
642
+ const vfs = new VirtualFileSystem();
643
+ vfs.root = vfs.deserializeDir(snapshot.root, "");
644
+ return vfs;
645
+ }
646
+ /**
647
+ * Replaces the current filesystem state with the content of a snapshot.
648
+ * The persistence mode is preserved.
649
+ *
650
+ * @example
651
+ * ```ts
652
+ * vfs.importSnapshot(savedSnapshot);
653
+ * ```
654
+ */
655
+ importSnapshot(snapshot) {
656
+ this.root = this.deserializeDir(snapshot.root, "");
657
+ this.emit("snapshot:import");
658
+ }
659
+ deserializeDir(snap, name) {
660
+ const dir = {
661
+ type: "directory",
662
+ name,
663
+ mode: snap.mode,
664
+ createdAt: new Date(snap.createdAt),
665
+ updatedAt: new Date(snap.updatedAt),
666
+ children: new Map(),
667
+ };
668
+ for (const child of snap.children) {
669
+ if (child.type === "file") {
670
+ const f = child;
671
+ dir.children.set(f.name, {
672
+ type: "file",
673
+ name: f.name,
674
+ mode: f.mode,
675
+ createdAt: new Date(f.createdAt),
676
+ updatedAt: new Date(f.updatedAt),
677
+ compressed: f.compressed,
678
+ content: Buffer.from(f.contentBase64, "base64"),
679
+ });
680
+ }
681
+ else {
682
+ const sub = this.deserializeDir(child, child.name);
683
+ dir.children.set(child.name, sub);
684
+ }
685
+ }
686
+ return dir;
687
+ }
688
+ }
689
+ export default VirtualFileSystem;
690
+ //# sourceMappingURL=index.js.map