typescript-virtual-container 1.5.7 → 1.5.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.
- package/README.md +21 -21
- package/dist/.tsbuildinfo +1 -1
- package/dist/SSHMimic/prompt.d.ts +2 -1
- package/dist/SSHMimic/prompt.js +27 -5
- package/dist/SSHMimic/sftp.d.ts +1 -1
- package/dist/SSHMimic/sftp.js +1 -1
- package/dist/VirtualShell/index.d.ts +2 -3
- package/dist/VirtualShell/index.js +2 -3
- package/dist/VirtualShell/shell.js +77 -133
- package/dist/commands/id.js +8 -1
- package/dist/commands/index.d.ts +1 -1
- package/dist/commands/index.js +1 -1
- package/dist/commands/manuals-bundle.js +10 -1
- package/dist/commands/rm.d.ts +1 -1
- package/dist/commands/rm.js +48 -11
- package/dist/commands/runtime.d.ts +5 -0
- package/dist/commands/runtime.js +25 -1
- package/dist/modules/linuxRootfs.js +7 -3
- package/dist/modules/nanoEditor.d.ts +92 -0
- package/dist/modules/nanoEditor.js +956 -0
- package/dist/modules/webTermRenderer.d.ts +42 -0
- package/dist/modules/webTermRenderer.js +291 -0
- package/dist/utils/shellSession.d.ts +10 -0
- package/dist/utils/shellSession.js +56 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -44,8 +44,8 @@
|
|
|
44
44
|
| Mode | Entry point | Use case |
|
|
45
45
|
|------|-------------|----------|
|
|
46
46
|
| **SSH/SFTP server** | `VirtualSshServer` / `VirtualSftpServer` | Honeypots, remote testing, training environments |
|
|
47
|
-
| **Web shell** | `builds/fortune-nyx-v1.5.
|
|
48
|
-
| **Standalone CLI** | `builds/fortune-nyx-v1.5.
|
|
47
|
+
| **Web shell** | `builds/fortune-nyx-v1.5.8-web.min.js` (ESM) | Embedded terminals, interactive tutorials, browser demos |
|
|
48
|
+
| **Standalone CLI** | `builds/fortune-nyx-v1.5.8-directbash-k6.1.0.mjs` (single file) | Local shell, one-liner demos, no install required |
|
|
49
49
|
<!-- /BUILD:mode-table -->
|
|
50
50
|
|
|
51
51
|
All three modes share the same core: a pure in-memory VFS, a real shell interpreter, a virtual package manager, and a typed programmatic API.
|
|
@@ -66,22 +66,22 @@ npm install typescript-virtual-container
|
|
|
66
66
|
<!-- BUILD:curl-start -->
|
|
67
67
|
#### Interactive local shell — persists VFS in .vfs/ in the current directory
|
|
68
68
|
```bash
|
|
69
|
-
curl -s https://raw.githubusercontent.com/itsrealfortune/typescript-virtual-container/refs/heads/main/builds/fortune-nyx-v1.5.
|
|
69
|
+
curl -s https://raw.githubusercontent.com/itsrealfortune/typescript-virtual-container/refs/heads/main/builds/fortune-nyx-v1.5.8-directbash-k6.1.0.mjs -o fortune-nyx-v1.5.8-directbash-k6.1.0.mjs && node fortune-nyx-v1.5.8-directbash-k6.1.0.mjs
|
|
70
70
|
```
|
|
71
71
|
|
|
72
72
|
#### SSH server with built-in SFTP subsystem (scp / sftp on port 2222)
|
|
73
73
|
```bash
|
|
74
|
-
curl -s https://raw.githubusercontent.com/itsrealfortune/typescript-virtual-container/refs/heads/main/builds/fortune-nyx-v1.5.
|
|
74
|
+
curl -s https://raw.githubusercontent.com/itsrealfortune/typescript-virtual-container/refs/heads/main/builds/fortune-nyx-v1.5.8-ssh.cjs -o fortune-nyx-v1.5.8-ssh.cjs && node fortune-nyx-v1.5.8-ssh.cjs
|
|
75
75
|
```
|
|
76
76
|
|
|
77
77
|
#### Custom SSH port
|
|
78
78
|
```bash
|
|
79
|
-
node fortune-nyx-v1.5.
|
|
79
|
+
node fortune-nyx-v1.5.8-ssh.cjs --ssh-port=2022
|
|
80
80
|
```
|
|
81
81
|
|
|
82
82
|
#### SSH disabled (handler only, no server started)
|
|
83
83
|
```bash
|
|
84
|
-
node fortune-nyx-v1.5.
|
|
84
|
+
node fortune-nyx-v1.5.8-ssh.cjs --no-ssh
|
|
85
85
|
```
|
|
86
86
|
<!-- /BUILD:curl-start -->
|
|
87
87
|
|
|
@@ -89,16 +89,16 @@ node fortune-nyx-v1.5.7-ssh.cjs --no-ssh
|
|
|
89
89
|
> 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.
|
|
90
90
|
|
|
91
91
|
<!-- BUILD:selfStandalone-options -->
|
|
92
|
-
**`fortune-nyx-v1.5.
|
|
92
|
+
**`fortune-nyx-v1.5.8-directbash-k6.1.0.mjs` options:**
|
|
93
93
|
|
|
94
94
|
```bash
|
|
95
|
-
node fortune-nyx-v1.5.
|
|
96
|
-
node fortune-nyx-v1.5.
|
|
97
|
-
node fortune-nyx-v1.5.
|
|
98
|
-
node fortune-nyx-v1.5.
|
|
99
|
-
node fortune-nyx-v1.5.
|
|
100
|
-
node fortune-nyx-v1.5.
|
|
101
|
-
node fortune-nyx-v1.5.
|
|
95
|
+
node fortune-nyx-v1.5.8-directbash-k6.1.0.mjs # boot as root
|
|
96
|
+
node fortune-nyx-v1.5.8-directbash-k6.1.0.mjs --user alice # boot as alice (prompts for password if set)
|
|
97
|
+
node fortune-nyx-v1.5.8-directbash-k6.1.0.mjs --user=alice # same, inline form
|
|
98
|
+
node fortune-nyx-v1.5.8-directbash-k6.1.0.mjs --hostname=my-box # custom hostname
|
|
99
|
+
node fortune-nyx-v1.5.8-directbash-k6.1.0.mjs --snapshot=/data/.vfs # custom VFS snapshot path
|
|
100
|
+
node fortune-nyx-v1.5.8-directbash-k6.1.0.mjs --help # show all options
|
|
101
|
+
node fortune-nyx-v1.5.8-directbash-k6.1.0.mjs --version # print version
|
|
102
102
|
```
|
|
103
103
|
<!-- /BUILD:selfStandalone-options -->
|
|
104
104
|
|
|
@@ -125,7 +125,7 @@ Two browser bundles are available:
|
|
|
125
125
|
<!-- BUILD:web-table -->
|
|
126
126
|
| Bundle | Format | Entry point | Use case |
|
|
127
127
|
|--------|--------|-------------|----------|
|
|
128
|
-
| `builds/fortune-nyx-v1.5.
|
|
128
|
+
| `builds/fortune-nyx-v1.5.8-web.min.js` | ESM | `createWebShell()` | Embedded terminals, modern bundlers |
|
|
129
129
|
<!-- /BUILD:web-table -->
|
|
130
130
|
|
|
131
131
|
Both bundles persist the VFS in **IndexedDB** — state survives page reloads.
|
|
@@ -137,11 +137,11 @@ bun run build-all # rebuild everything
|
|
|
137
137
|
```
|
|
138
138
|
|
|
139
139
|
<!-- BUILD:web-options -->
|
|
140
|
-
**`fortune-nyx-v1.5.
|
|
140
|
+
**`fortune-nyx-v1.5.8-web.min.js`** — lightweight shell with IndexedDB VFS:
|
|
141
141
|
|
|
142
142
|
```html
|
|
143
143
|
<script type="module">
|
|
144
|
-
import { createWebShell } from "./builds/fortune-nyx-v1.5.
|
|
144
|
+
import { createWebShell } from "./builds/fortune-nyx-v1.5.8-web.min.js";
|
|
145
145
|
|
|
146
146
|
const shell = createWebShell("web-vm", {
|
|
147
147
|
vfs: { databaseName: "virtual-env-js", storeName: "vfs" },
|
|
@@ -153,11 +153,11 @@ bun run build-all # rebuild everything
|
|
|
153
153
|
</script>
|
|
154
154
|
```
|
|
155
155
|
|
|
156
|
-
**`fortune-nyx-v1.5.
|
|
156
|
+
**`fortune-nyx-v1.5.8-web.min.js`** — mirrors the `VirtualShell` programmatic API:
|
|
157
157
|
|
|
158
158
|
```html
|
|
159
159
|
<script type="module">
|
|
160
|
-
import { createVirtualShellShim } from "./builds/fortune-nyx-v1.5.
|
|
160
|
+
import { createVirtualShellShim } from "./builds/fortune-nyx-v1.5.8-web.min.js";
|
|
161
161
|
|
|
162
162
|
const shell = createVirtualShellShim("web-vm");
|
|
163
163
|
await shell.ensureInitialized();
|
|
@@ -1244,8 +1244,8 @@ Open:
|
|
|
1244
1244
|
- [x] Snapshot diff tooling — `diffSnapshots`, `formatDiff`, `assertDiff`
|
|
1245
1245
|
- [x] `node`/`python3`/`npm`/`npx` — package-gated virtual REPL stubs
|
|
1246
1246
|
<!-- BUILD:changelog -->
|
|
1247
|
-
- [x] Web shell bundles (`fortune-nyx-v1.5.
|
|
1248
|
-
- [x] Self-standalone CLI (`fortune-nyx-v1.5.
|
|
1247
|
+
- [x] Web shell bundles (`fortune-nyx-v1.5.8-web.min.js`) — fully browser-native with IndexedDB VFS
|
|
1248
|
+
- [x] Self-standalone CLI (`fortune-nyx-v1.5.8-directbash-k6.1.0.mjs`) — single-file interactive shell, per-user history, tab completion
|
|
1249
1249
|
<!-- /BUILD:changelog -->
|
|
1250
1250
|
- [x] 120+ `man` pages — all built-in commands documented via `man <cmd>`
|
|
1251
1251
|
- [x] Shared `tokenize.ts` — unified tokenizer for shell parser and runtime (eliminates duplication)
|