typescript-virtual-container 1.4.6 → 1.4.8

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 (139) hide show
  1. package/.vscode/settings.json +1 -0
  2. package/README.md +0 -1
  3. package/benchmark-results.txt +21 -21
  4. package/builds/self-standalone.js +1111 -299
  5. package/builds/self-standalone.js.map +4 -4
  6. package/builds/standalone-wo-sftp.js +993 -183
  7. package/builds/standalone-wo-sftp.js.map +4 -4
  8. package/builds/standalone.cjs +984 -173
  9. package/builds/standalone.cjs.map +4 -4
  10. package/dist/SSHMimic/exec.d.ts.map +1 -1
  11. package/dist/SSHMimic/exec.js +0 -1
  12. package/dist/SSHMimic/exec.js.map +1 -1
  13. package/dist/SSHMimic/index.d.ts.map +1 -1
  14. package/dist/SSHMimic/index.js +3 -1
  15. package/dist/SSHMimic/index.js.map +1 -1
  16. package/dist/SSHMimic/sftp.d.ts.map +1 -1
  17. package/dist/SSHMimic/sftp.js +0 -6
  18. package/dist/SSHMimic/sftp.js.map +1 -1
  19. package/dist/VirtualFileSystem/binaryPack.d.ts.map +1 -1
  20. package/dist/VirtualFileSystem/binaryPack.js +21 -9
  21. package/dist/VirtualFileSystem/binaryPack.js.map +1 -1
  22. package/dist/VirtualFileSystem/index.d.ts +93 -0
  23. package/dist/VirtualFileSystem/index.d.ts.map +1 -1
  24. package/dist/VirtualFileSystem/index.js +361 -46
  25. package/dist/VirtualFileSystem/index.js.map +1 -1
  26. package/dist/VirtualFileSystem/internalTypes.d.ts +23 -4
  27. package/dist/VirtualFileSystem/internalTypes.d.ts.map +1 -1
  28. package/dist/VirtualFileSystem/journal.d.ts +47 -0
  29. package/dist/VirtualFileSystem/journal.d.ts.map +1 -0
  30. package/dist/VirtualFileSystem/journal.js +178 -0
  31. package/dist/VirtualFileSystem/journal.js.map +1 -0
  32. package/dist/VirtualFileSystem/path.js +1 -1
  33. package/dist/VirtualFileSystem/path.js.map +1 -1
  34. package/dist/VirtualShell/idleManager.d.ts +65 -0
  35. package/dist/VirtualShell/idleManager.d.ts.map +1 -0
  36. package/dist/VirtualShell/idleManager.js +106 -0
  37. package/dist/VirtualShell/idleManager.js.map +1 -0
  38. package/dist/VirtualShell/index.d.ts +28 -0
  39. package/dist/VirtualShell/index.d.ts.map +1 -1
  40. package/dist/VirtualShell/index.js +48 -0
  41. package/dist/VirtualShell/index.js.map +1 -1
  42. package/dist/VirtualShell/shell.js +4 -4
  43. package/dist/VirtualShell/shell.js.map +1 -1
  44. package/dist/commands/man.d.ts.map +1 -1
  45. package/dist/commands/man.js +5 -27
  46. package/dist/commands/man.js.map +1 -1
  47. package/dist/commands/manuals-bundle.d.ts +11 -0
  48. package/dist/commands/manuals-bundle.d.ts.map +1 -0
  49. package/dist/commands/manuals-bundle.js +898 -0
  50. package/dist/commands/manuals-bundle.js.map +1 -0
  51. package/dist/index.d.ts +2 -0
  52. package/dist/index.d.ts.map +1 -1
  53. package/dist/index.js +1 -0
  54. package/dist/index.js.map +1 -1
  55. package/dist/modules/linuxRootfs.d.ts +8 -1
  56. package/dist/modules/linuxRootfs.d.ts.map +1 -1
  57. package/dist/modules/linuxRootfs.js +47 -14
  58. package/dist/modules/linuxRootfs.js.map +1 -1
  59. package/dist/self-standalone.js +16 -1
  60. package/dist/self-standalone.js.map +1 -1
  61. package/dist/standalone.js +22 -0
  62. package/dist/standalone.js.map +1 -1
  63. package/docs/assets/hierarchy.js +1 -1
  64. package/docs/assets/navigation.js +1 -1
  65. package/docs/assets/search.js +1 -1
  66. package/docs/classes/HoneyPot.html +8 -8
  67. package/docs/classes/IdleManager.html +159 -0
  68. package/docs/classes/SshClient.html +18 -18
  69. package/docs/classes/VirtualFileSystem.html +57 -32
  70. package/docs/classes/VirtualPackageManager.html +12 -12
  71. package/docs/classes/VirtualSftpServer.html +3 -3
  72. package/docs/classes/VirtualShell.html +40 -25
  73. package/docs/classes/VirtualSshServer.html +5 -5
  74. package/docs/classes/VirtualUserManager.html +26 -26
  75. package/docs/functions/assertDiff.html +1 -1
  76. package/docs/functions/diffSnapshots.html +1 -1
  77. package/docs/functions/formatDiff.html +1 -1
  78. package/docs/functions/getArg.html +1 -1
  79. package/docs/functions/getFlag.html +1 -1
  80. package/docs/functions/ifFlag.html +1 -1
  81. package/docs/hierarchy.html +1 -1
  82. package/docs/index.html +1 -2
  83. package/docs/interfaces/AuditLogEntry.html +2 -2
  84. package/docs/interfaces/CommandContext.html +11 -11
  85. package/docs/interfaces/CommandResult.html +12 -12
  86. package/docs/interfaces/ExecStream.html +5 -5
  87. package/docs/interfaces/HoneyPotStats.html +2 -2
  88. package/docs/interfaces/IdleManagerOptions.html +7 -0
  89. package/docs/interfaces/InstalledPackage.html +10 -10
  90. package/docs/interfaces/NanoEditorSession.html +4 -4
  91. package/docs/interfaces/PackageDefinition.html +13 -13
  92. package/docs/interfaces/PackageFile.html +4 -4
  93. package/docs/interfaces/RemoveOptions.html +2 -2
  94. package/docs/interfaces/ShellEnv.html +3 -3
  95. package/docs/interfaces/ShellModule.html +7 -7
  96. package/docs/interfaces/ShellProperties.html +4 -4
  97. package/docs/interfaces/ShellStream.html +6 -6
  98. package/docs/interfaces/SudoChallenge.html +8 -8
  99. package/docs/interfaces/VfsBaseNode.html +6 -6
  100. package/docs/interfaces/VfsDiff.html +5 -5
  101. package/docs/interfaces/VfsDiffEntry.html +3 -3
  102. package/docs/interfaces/VfsDiffModified.html +5 -5
  103. package/docs/interfaces/VfsDirectoryNode.html +7 -7
  104. package/docs/interfaces/VfsFileNode.html +8 -8
  105. package/docs/interfaces/VfsOptions.html +18 -4
  106. package/docs/interfaces/VfsSnapshot.html +2 -2
  107. package/docs/interfaces/VfsSnapshotBaseNode.html +3 -3
  108. package/docs/interfaces/VfsSnapshotDirectoryNode.html +4 -4
  109. package/docs/interfaces/VfsSnapshotFileNode.html +5 -5
  110. package/docs/interfaces/WriteFileOptions.html +3 -3
  111. package/docs/modules.html +1 -1
  112. package/docs/types/CommandMode.html +1 -1
  113. package/docs/types/CommandOutcome.html +1 -1
  114. package/docs/types/IdleState.html +1 -0
  115. package/docs/types/VfsNodeStats.html +1 -1
  116. package/docs/types/VfsNodeType.html +1 -1
  117. package/docs/types/VfsPersistenceMode.html +1 -1
  118. package/docs/types/VfsSnapshotNode.html +1 -1
  119. package/package.json +5 -4
  120. package/scripts/generate-manuals-bundle.mjs +49 -0
  121. package/src/SSHMimic/exec.ts +0 -1
  122. package/src/SSHMimic/index.ts +3 -1
  123. package/src/SSHMimic/sftp.ts +0 -6
  124. package/src/VirtualFileSystem/binaryPack.ts +21 -9
  125. package/src/VirtualFileSystem/index.ts +369 -52
  126. package/src/VirtualFileSystem/internalTypes.ts +24 -4
  127. package/src/VirtualFileSystem/journal.ts +163 -0
  128. package/src/VirtualFileSystem/path.ts +1 -1
  129. package/src/VirtualShell/idleManager.ts +133 -0
  130. package/src/VirtualShell/index.ts +48 -0
  131. package/src/VirtualShell/shell.ts +4 -4
  132. package/src/commands/man.ts +5 -35
  133. package/src/commands/manuals-bundle.ts +898 -0
  134. package/src/index.ts +2 -0
  135. package/src/modules/linuxRootfs.ts +58 -14
  136. package/src/self-standalone.ts +14 -1
  137. package/src/standalone.ts +23 -0
  138. package/builds/standalone.js +0 -491
  139. package/builds/standalone.js.map +0 -7
package/.vscode/settings.json CHANGED
@@ -10,6 +10,7 @@
10
10
  ".ssh-mimic": true,
11
11
  ".vfs": true,
12
12
  "builds": true,
13
+ "docs": true,
13
14
  "examples": true,
14
15
 
15
16
  "LICENSE": true,
package/README.md CHANGED
@@ -85,7 +85,6 @@ curl -s https://raw.githubusercontent.com/itsrealfortune/typescript-virtual-cont
85
85
 
86
86
  > [!NOTE]
87
87
  > The standalone builds are intended for quick demos and testing. For production use, it's recommended to install the package and import the relevant classes directly in your codebase for better performance, stability, and security.
88
- > It implies command `man` is not available in standalone mode because manuals are not included in the minimal build, but you can always refer to the [API Reference](#api-reference) for detailed documentation.
89
88
 
90
89
  **`self-standalone.js` options:**
91
90
 
package/benchmark-results.txt CHANGED
@@ -1,40 +1,40 @@
1
1
  Benchmarking VirtualShell concurrency:
2
2
 
3
3
  Running 1 shells...
4
- Initialized 1 shells in 55ms, RSS 96 MB
5
- Executed shell commands in 5ms, RSS now 97 MB (+0 MB)
4
+ Initialized 1 shells in 58ms, RSS 98 MB
5
+ Executed shell commands in 5ms, RSS now 98 MB (+1 MB)
6
6
 
7
7
  Running 2 shells...
8
- Initialized 2 shells in 7ms, RSS 99 MB
9
- Executed shell commands in 1ms, RSS now 99 MB (+0 MB)
8
+ Initialized 2 shells in 10ms, RSS 102 MB
9
+ Executed shell commands in 1ms, RSS now 102 MB (+0 MB)
10
10
 
11
11
  Running 5 shells...
12
- Initialized 5 shells in 18ms, RSS 108 MB
13
- Executed shell commands in 1ms, RSS now 109 MB (+1 MB)
12
+ Initialized 5 shells in 21ms, RSS 113 MB
13
+ Executed shell commands in 1ms, RSS now 113 MB (+0 MB)
14
14
 
15
15
  Running 10 shells...
16
- Initialized 10 shells in 33ms, RSS 122 MB
17
- Executed shell commands in 2ms, RSS now 122 MB (+0 MB)
16
+ Initialized 10 shells in 43ms, RSS 132 MB
17
+ Executed shell commands in 6ms, RSS now 132 MB (+1 MB)
18
18
 
19
19
  Running 20 shells...
20
- Initialized 20 shells in 64ms, RSS 147 MB
21
- Executed shell commands in 4ms, RSS now 148 MB (+1 MB)
20
+ Initialized 20 shells in 107ms, RSS 150 MB
21
+ Executed shell commands in 4ms, RSS now 150 MB (+0 MB)
22
22
 
23
23
  Running 50 shells...
24
- Initialized 50 shells in 127ms, RSS 157 MB
25
- Executed shell commands in 5ms, RSS now 158 MB (+0 MB)
24
+ Initialized 50 shells in 177ms, RSS 178 MB
25
+ Executed shell commands in 5ms, RSS now 179 MB (+0 MB)
26
26
 
27
27
  Running 100 shells...
28
- Initialized 100 shells in 256ms, RSS 185 MB
29
- Executed shell commands in 9ms, RSS now 186 MB (+0 MB)
28
+ Initialized 100 shells in 302ms, RSS 190 MB
29
+ Executed shell commands in 9ms, RSS now 190 MB (+0 MB)
30
30
 
31
31
  Summary:
32
32
 
33
33
  count init_ms cmd_ms init_rss final_rss delta_rss
34
- 1 55 5 96 MB 97 MB 0 MB
35
- 2 7 1 99 MB 99 MB 0 MB
36
- 5 18 1 108 MB 109 MB 1 MB
37
- 10 33 2 122 MB 122 MB 0 MB
38
- 20 64 4 147 MB 148 MB 1 MB
39
- 50 127 5 157 MB 158 MB 0 MB
40
- 100 256 9 185 MB 186 MB 0 MB
34
+ 1 58 5 98 MB 98 MB 1 MB
35
+ 2 10 1 102 MB 102 MB 0 MB
36
+ 5 21 1 113 MB 113 MB 0 MB
37
+ 10 43 6 132 MB 132 MB 1 MB
38
+ 20 107 4 150 MB 150 MB 0 MB
39
+ 50 177 5 178 MB 179 MB 0 MB
40
+ 100 302 9 190 MB 190 MB 0 MB