@local-sandbox/lsb-nodejs 0.1.0 → 0.2.0

package/README.md

@@ -48,11 +48,9 @@ const dataDir = `${process.env.HOME}/.local/share/lsb`
 const sandbox = await Sandbox.start({
   dataDir,
   cpus: 2,
-  memory: 2048,
-  allowNet: true,
-  mounts: {
-    './src': '/workspace',
-  },
+  memoryMb: 2048,
+  mounts: [{ type: 'overlay', hostPath: './src', guestPath: '/workspace' }],
+  network: { allow: ['registry.npmjs.org'] },
 })
 
 const result = await sandbox.exec('echo hello from lsb')
@@ -123,15 +121,17 @@ import { Sandbox } from '@local-sandbox/lsb-nodejs'
 
 const sandbox = await Sandbox.start({
   cpus: 4,
-  memory: 4096,
-  diskSize: 8192,
-  allowNet: true,
-  ports: ['8080:80'],
-  mounts: { './src': '/workspace' },
-  secrets: {
-    API_KEY: { value: 'sk-test', hosts: ['api.openai.com'] },
+  memoryMb: 4096,
+  diskSizeMb: 8192,
+  ports: [{ host: 8080, guest: 80 }],
+  mounts: [{ type: 'direct', hostPath: './src', guestPath: '/workspace', flags: 0 }],
+  network: {
+    allow: ['api.openai.com', 'registry.npmjs.org'],
+    exposeHost: [{ host: 3000, guest: 3000 }],
+    secrets: {
+      API_KEY: { value: 'sk-test', hosts: ['api.openai.com'] },
+    },
   },
-  network: { allow: ['api.openai.com', 'registry.npmjs.org'] },
 })
 
 console.log(sandbox.instanceDir)
@@ -141,19 +141,64 @@ await sandbox.stop()
 
 ### Start options
 
-| Option | Type | Description |
-|--------|------|-------------|
-| `from` | `string` | Checkpoint name to start from |
-| `cpus` | `number` | Number of vCPUs |
-| `memory` | `number` | Memory in MB |
-| `diskSize` | `number` | Disk size in MB |
-| `dataDir` | `string` | lsb runtime data directory |
-| `allowNet` | `boolean` | Enable network access |
-| `allowedHosts` | `string[]` | Additional allowlisted hosts |
-| `ports` | `string[]` | Port forwards (`"host:guest"`) |
-| `mounts` | `Record<string, string>` | Directory mounts (`{ hostPath: guestPath }`) |
-| `secrets` | `Record<string, SecretConfig>` | Secrets injected via the lsb proxy |
-| `network` | `NetworkConfig` | Network access policy |
+| Option       | Type                                | Description                    |
+| ------------ | ----------------------------------- | ------------------------------ |
+| `instanceId` | `string`                            | Stable instance directory name |
+| `from`       | `string`                            | Checkpoint name to start from  |
+| `cpus`       | `number`                            | Number of vCPUs                |
+| `memoryMb`   | `number`                            | Memory in MB                   |
+| `diskSizeMb` | `number`                            | Disk size in MB                |
+| `dataDir`    | `string`                            | lsb runtime data directory     |
+| `ports`      | `{ host: number; guest: number }[]` | Host-to-guest port forwards    |
+| `mounts`     | `MountConfig[]`                     | Directory mounts               |
+| `network`    | `NetworkConfig`                     | Network access policy          |
+
+`mounts` accepts discriminated entries:
+
+| Type      | Shape                                                                    | Behavior                                      |
+| --------- | ------------------------------------------------------------------------ | --------------------------------------------- |
+| `overlay` | `{ type: 'overlay'; hostPath: string; guestPath: string }`               | Host is read-only; guest writes go to overlay |
+| `direct`  | `{ type: 'direct'; hostPath: string; guestPath: string; flags: number }` | Mounts VirtioFS directly with libc flags      |
+
+For direct mounts, `flags: 0` is read-write and `flags: 1` is `MS_RDONLY`.
+
+`network` enables proxy networking when present. It accepts:
+
+| Option       | Type                                 | Description                        |
+| ------------ | ------------------------------------ | ---------------------------------- |
+| `allow`      | `string[]`                           | Allowed outbound host patterns     |
+| `exposeHost` | `{ host: number; guest?: number }[]` | Host ports exposed to the guest    |
+| `secrets`    | `Record<string, SecretConfig>`       | Secrets injected via the lsb proxy |
+
+### Stream process output
+
+```ts
+import { Sandbox } from '@local-sandbox/lsb-nodejs'
+
+const sandbox = await Sandbox.start()
+const proc = await sandbox.spawn('echo out; echo err >&2')
+
+for await (const chunk of proc.stdout) {
+  process.stdout.write(chunk)
+}
+
+console.log(await proc.exited)
+
+await sandbox.stop()
+```
+
+### Watch files
+
+```ts
+import { Sandbox } from '@local-sandbox/lsb-nodejs'
+
+const sandbox = await Sandbox.start()
+const events = await sandbox.watch('/tmp')
+
+for await (const event of events) {
+  console.log(event.path, event.event)
+}
+```
 
 ## Scripts
 

package/index.d.ts

@@ -1,106 +1,339 @@
 /* auto-generated by NAPI-RS */
 /* eslint-disable */
+/**
+ * Async byte stream returned by process stdout and stderr.
+ *
+ * Usage: `for await (const chunk of proc.stdout) process.stdout.write(chunk)`
+ *
+ * This type implements JavaScript's async iterable protocol.
+ * It can be used with `for await...of` loops.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols#the_async_iterator_and_async_iterable_protocols
+ */
+export declare class ByteStream {
+
+}
+
+/**
+ * Running sandbox VM instance.
+ *
+ * Usage: `const sandbox = await Sandbox.start(); await sandbox.stop()`
+ */
 export declare class Sandbox {
+  /**
+   * Boot a new sandbox VM.
+   *
+   * Usage: `const sandbox = await Sandbox.start({ cpus: 2, mounts: [{ type: 'overlay', hostPath: '.', guestPath: '/workspace' }] })`
+   */
   static start(opts?: StartOptions | undefined | null): Promise<Sandbox>
+  /**
+   * Execute a command and wait for stdout, stderr, and exit code.
+   *
+   * Usage: `const result = await sandbox.exec('npm test', { cwd: '/workspace' })`
+   */
   exec(command: string | Array<string>, opts?: ExecOptions | undefined | null): Promise<ExecResult>
-  execShell(command: string): Promise<ExecResult>
+  /**
+   * Execute a shell command string with the SDK shell runner.
+   *
+   * Usage: `const result = await sandbox.execShell('echo $PWD && ls', { cwd: '/workspace' })`
+   */
+  execShell(command: string, opts?: ExecOptions | undefined | null): Promise<ExecResult>
+  /**
+   * Start a long-running process with streamable stdout and stderr.
+   *
+   * Usage: `const proc = await sandbox.spawn(['node', 'server.js'], { cwd: '/workspace' })`
+   */
   spawn(command: string | Array<string>, opts?: SpawnOptions | undefined | null): Promise<SpawnedProcess>
-  watch(path: string, callback: (arg: FileChangeEvent) => unknown, opts?: WatchOptions | undefined | null): void
+  /**
+   * Watch a guest path for file changes.
+   *
+   * Usage: `for await (const event of await sandbox.watch('/workspace')) console.log(event.path, event.event)`
+   */
+  watch(path: string, opts?: WatchOptions | undefined | null): Promise<WatchStream>
+  /**
+   * Read a guest file as a Buffer.
+   *
+   * Usage: `const content = await sandbox.readFile('/workspace/package.json')`
+   */
   readFile(path: string): Promise<Buffer>
+  /**
+   * Write a string or Uint8Array to a guest file.
+   *
+   * Usage: `await sandbox.writeFile('/tmp/input.txt', 'hello')`
+   */
   writeFile(path: string, content: string | Uint8Array): Promise<void>
+  /**
+   * Create a guest directory.
+   *
+   * Usage: `await sandbox.mkdir('/workspace/out', { recursive: true })`
+   */
   mkdir(path: string, opts?: MkdirOptions | undefined | null): Promise<void>
+  /**
+   * List entries in a guest directory.
+   *
+   * Usage: `const entries = await sandbox.readDir('/workspace')`
+   */
   readDir(path: string): Promise<Array<DirEntry>>
+  /**
+   * Return metadata for a guest path.
+   *
+   * Usage: `const stat = await sandbox.stat('/workspace/package.json')`
+   */
   stat(path: string): Promise<StatResult>
+  /**
+   * Remove a guest file or directory.
+   *
+   * Usage: `await sandbox.remove('/workspace/out', { recursive: true })`
+   */
   remove(path: string, opts?: RemoveOptions | undefined | null): Promise<void>
+  /**
+   * Rename or move a guest file or directory.
+   *
+   * Usage: `await sandbox.rename('/tmp/a.txt', '/tmp/b.txt')`
+   */
   rename(oldPath: string, newPath: string): Promise<void>
+  /**
+   * Copy a guest file or directory.
+   *
+   * Usage: `await sandbox.copy('/workspace/src', '/workspace/src-copy', { recursive: true })`
+   */
   copy(src: string, dst: string, opts?: CopyOptions | undefined | null): Promise<void>
+  /**
+   * Change permission bits on a guest path.
+   *
+   * Usage: `await sandbox.chmod('/workspace/script.sh', 0o755)`
+   */
   chmod(path: string, mode: number): Promise<void>
+  /**
+   * Check whether a guest path exists.
+   *
+   * Usage: `if (await sandbox.exists('/workspace/package.json')) console.log('found')`
+   */
   exists(path: string): Promise<boolean>
+  /**
+   * Save a named VM checkpoint that can be used with `Sandbox.start({ from })`.
+   *
+   * Usage: `await sandbox.checkpoint('deps-installed')`
+   */
   checkpoint(name: string): Promise<void>
+  /**
+   * Stop the sandbox VM and release runtime resources.
+   *
+   * Usage: `await sandbox.stop()`
+   */
   stop(): Promise<void>
+  /**
+   * Absolute host path for this sandbox instance directory.
+   *
+   * Usage: `console.log(sandbox.instanceDir)`
+   */
   get instanceDir(): string
 }
 
+/**
+ * Handle for a process spawned inside the sandbox.
+ *
+ * Usage: `const proc = await sandbox.spawn('npm test')`
+ */
 export declare class SpawnedProcess {
-  on(event: string, callback: (arg: unknown) => unknown): void
+  /**
+   * Stream stdout chunks from the spawned process.
+   *
+   * Usage: `for await (const chunk of proc.stdout) process.stdout.write(chunk)`
+   */
+  get stdout(): ByteStream
+  /**
+   * Stream stderr chunks from the spawned process.
+   *
+   * Usage: `for await (const chunk of proc.stderr) process.stderr.write(chunk)`
+   */
+  get stderr(): ByteStream
+  /**
+   * Write data to the process stdin.
+   *
+   * Usage: `proc.write('hello')`
+   */
   write(data: string | Uint8Array): void
-  kill(): Promise<void>
-  get pid(): string
+  /**
+   * Request termination of the process.
+   *
+   * Usage: `proc.kill()`
+   */
+  kill(): void
+  /**
+   * Promise resolving to the process exit code.
+   *
+   * Usage: `const exitCode = await proc.exited`
+   */
   get exited(): Promise<number>
 }
 
+/**
+ * Async stream of file change events returned by `sandbox.watch`.
+ *
+ * Usage: `for await (const event of await sandbox.watch('/workspace')) console.log(event.path)`
+ *
+ * This type implements JavaScript's async iterable protocol.
+ * It can be used with `for await...of` loops.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols#the_async_iterator_and_async_iterable_protocols
+ */
+export declare class WatchStream {
+
+}
+
+/** Options for copying files or directories. */
 export interface CopyOptions {
+  /** Copy directory trees recursively. Defaults to false. */
   recursive?: boolean
 }
 
+/** Directory entry returned by `readDir`. */
 export interface DirEntry {
+  /** Entry basename. */
   name: string
+  /** Entry type such as `file`, `dir`, or `symlink`. */
   type: string
+  /** Entry size in bytes. */
   size: number
 }
 
+/** Per-command execution options. */
 export interface ExecOptions {
+  /** Guest working directory. */
+  cwd?: string
+  /** Additional environment variables. */
+  env?: Record<string, string>
+  /** Shell used when the command is a string. Defaults to `sh`. */
   shell?: string
 }
 
+/** Completed command result. */
 export interface ExecResult {
+  /** Captured stdout as UTF-8 text. */
   stdout: string
+  /** Captured stderr as UTF-8 text. */
   stderr: string
+  /** Process exit code. */
   exitCode: number
 }
 
+/** Host port made reachable from inside the guest via host.lsb.internal. */
+export interface ExposeHostConfig {
+  /** Port on the host machine. */
+  host: number
+  /** Port visible to the guest. Defaults to `host` when omitted. */
+  guest?: number
+}
+
+/** File watcher event. */
 export interface FileChangeEvent {
+  /** Changed guest path. */
   path: string
+  /** Event kind reported by the guest watcher. */
   event: string
 }
 
+/** Options for directory creation. */
 export interface MkdirOptions {
+  /** Create parent directories as needed. Defaults to true. */
   recursive?: boolean
 }
 
+/** Directory mount configuration. */
+export interface MountConfig {
+  /** Mount behavior: `overlay` isolates writes, `direct` applies libc mount flags. */
+  type: 'overlay' | 'direct'
+  /** Existing host directory to share with the VM. */
+  hostPath: string
+  /** Absolute guest path where the directory appears. */
+  guestPath: string
+  /** libc mount flags for direct mounts. Use `0` for read-write, `1` for MS_RDONLY. */
+  flags?: number
+}
+
+/** Network policy for a sandbox. */
 export interface NetworkConfig {
+  /** Outbound host patterns allowed by the proxy. */
   allow?: Array<string>
+  /** Host ports exposed to the guest. */
+  exposeHost?: Array<ExposeHostConfig>
+  /** Secrets injected by the proxy for allowed hosts. */
+  secrets?: Record<string, SecretConfig>
+}
+
+/** Host-to-guest TCP port forwarding rule. */
+export interface PortMappingConfig {
+  /** Host port to listen on. */
+  host: number
+  /** Guest port to forward to. */
+  guest: number
 }
 
+/** Options for removing files or directories. */
 export interface RemoveOptions {
+  /** Remove directory trees recursively. Defaults to false. */
   recursive?: boolean
 }
 
+/** Secret value that is only exposed to requests for the listed hosts. */
 export interface SecretConfig {
+  /** Secret payload or source value. */
   value: string
+  /** Host allowlist for this secret. */
   hosts: Array<string>
 }
 
+/** Options for spawned processes. */
 export interface SpawnOptions {
+  /** Guest working directory. */
   cwd?: string
+  /** Additional environment variables. */
   env?: Record<string, string>
+  /** Shell used when the command is a string. Defaults to `sh`. */
   shell?: string
 }
 
+/** Options used when booting a sandbox. */
 export interface StartOptions {
+  /** Stable instance directory name. */
   instanceId?: string
+  /** Checkpoint name to resume from. */
   from?: string
+  /** Number of virtual CPUs. */
   cpus?: number
-  memory?: number
-  diskSize?: number
+  /** Guest memory in MiB. */
+  memoryMb?: number
+  /** Writable root disk size in MiB. */
+  diskSizeMb?: number
+  /** Runtime data directory containing VM assets and instances. */
   dataDir?: string
-  allowNet?: boolean
-  allowedHosts?: Array<string>
-  ports?: Array<string>
-  mounts?: Record<string, string>
-  secrets?: Record<string, SecretConfig>
+  /** Host-to-guest port forwards. */
+  ports?: Array<PortMappingConfig>
+  /** Directory mounts applied during boot. */
+  mounts?: Array<{ type: 'overlay'; hostPath: string; guestPath: string } | { type: 'direct'; hostPath: string; guestPath: string; flags: number }>
+  /** Network proxy, host exposure, and secret policy. */
   network?: NetworkConfig
 }
 
+/** File metadata returned by `stat`. */
 export interface StatResult {
+  /** Size in bytes. */
   size: number
+  /** POSIX mode bits. */
   mode: number
+  /** Modified time as a Unix timestamp in milliseconds. */
   mtime: number
+  /** True when the path is a directory. */
   isDir: boolean
+  /** True when the path is a regular file. */
   isFile: boolean
+  /** True when the path is a symbolic link. */
   isSymlink: boolean
 }
 
+/** Options for file watching. */
 export interface WatchOptions {
+  /** Watch subdirectories recursively. Defaults to true. */
   recursive?: boolean
 }

package/index.js

@@ -80,8 +80,8 @@ function requireNative() {
       try {
         const binding = require('@local-sandbox/lsb-nodejs-android-arm64')
         const bindingPackageVersion = require('@local-sandbox/lsb-nodejs-android-arm64/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -96,8 +96,8 @@ function requireNative() {
       try {
         const binding = require('@local-sandbox/lsb-nodejs-android-arm-eabi')
         const bindingPackageVersion = require('@local-sandbox/lsb-nodejs-android-arm-eabi/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -116,8 +116,8 @@ function requireNative() {
       try {
         const binding = require('@local-sandbox/lsb-nodejs-win32-x64-msvc')
         const bindingPackageVersion = require('@local-sandbox/lsb-nodejs-win32-x64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -132,8 +132,8 @@ function requireNative() {
       try {
         const binding = require('@local-sandbox/lsb-nodejs-win32-ia32-msvc')
         const bindingPackageVersion = require('@local-sandbox/lsb-nodejs-win32-ia32-msvc/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -148,8 +148,8 @@ function requireNative() {
       try {
         const binding = require('@local-sandbox/lsb-nodejs-win32-arm64-msvc')
         const bindingPackageVersion = require('@local-sandbox/lsb-nodejs-win32-arm64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -167,8 +167,8 @@ function requireNative() {
     try {
       const binding = require('@local-sandbox/lsb-nodejs-darwin-universal')
       const bindingPackageVersion = require('@local-sandbox/lsb-nodejs-darwin-universal/package.json').version
-      if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-        throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
       }
       return binding
     } catch (e) {
@@ -183,8 +183,8 @@ function requireNative() {
       try {
         const binding = require('@local-sandbox/lsb-nodejs-darwin-x64')
         const bindingPackageVersion = require('@local-sandbox/lsb-nodejs-darwin-x64/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -199,8 +199,8 @@ function requireNative() {
       try {
         const binding = require('@local-sandbox/lsb-nodejs-darwin-arm64')
         const bindingPackageVersion = require('@local-sandbox/lsb-nodejs-darwin-arm64/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -219,8 +219,8 @@ function requireNative() {
       try {
         const binding = require('@local-sandbox/lsb-nodejs-freebsd-x64')
         const bindingPackageVersion = require('@local-sandbox/lsb-nodejs-freebsd-x64/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -235,8 +235,8 @@ function requireNative() {
       try {
         const binding = require('@local-sandbox/lsb-nodejs-freebsd-arm64')
         const bindingPackageVersion = require('@local-sandbox/lsb-nodejs-freebsd-arm64/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -256,8 +256,8 @@ function requireNative() {
         try {
           const binding = require('@local-sandbox/lsb-nodejs-linux-x64-musl')
           const bindingPackageVersion = require('@local-sandbox/lsb-nodejs-linux-x64-musl/package.json').version
-          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -272,8 +272,8 @@ function requireNative() {
         try {
           const binding = require('@local-sandbox/lsb-nodejs-linux-x64-gnu')
           const bindingPackageVersion = require('@local-sandbox/lsb-nodejs-linux-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -290,8 +290,8 @@ function requireNative() {
         try {
           const binding = require('@local-sandbox/lsb-nodejs-linux-arm64-musl')
           const bindingPackageVersion = require('@local-sandbox/lsb-nodejs-linux-arm64-musl/package.json').version
-          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -306,8 +306,8 @@ function requireNative() {
         try {
           const binding = require('@local-sandbox/lsb-nodejs-linux-arm64-gnu')
           const bindingPackageVersion = require('@local-sandbox/lsb-nodejs-linux-arm64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -324,8 +324,8 @@ function requireNative() {
         try {
           const binding = require('@local-sandbox/lsb-nodejs-linux-arm-musleabihf')
           const bindingPackageVersion = require('@local-sandbox/lsb-nodejs-linux-arm-musleabihf/package.json').version
-          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -340,8 +340,8 @@ function requireNative() {
         try {
           const binding = require('@local-sandbox/lsb-nodejs-linux-arm-gnueabihf')
           const bindingPackageVersion = require('@local-sandbox/lsb-nodejs-linux-arm-gnueabihf/package.json').version
-          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -358,8 +358,8 @@ function requireNative() {
         try {
           const binding = require('@local-sandbox/lsb-nodejs-linux-loong64-musl')
           const bindingPackageVersion = require('@local-sandbox/lsb-nodejs-linux-loong64-musl/package.json').version
-          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -374,8 +374,8 @@ function requireNative() {
         try {
           const binding = require('@local-sandbox/lsb-nodejs-linux-loong64-gnu')
           const bindingPackageVersion = require('@local-sandbox/lsb-nodejs-linux-loong64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -392,8 +392,8 @@ function requireNative() {
         try {
           const binding = require('@local-sandbox/lsb-nodejs-linux-riscv64-musl')
           const bindingPackageVersion = require('@local-sandbox/lsb-nodejs-linux-riscv64-musl/package.json').version
-          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -408,8 +408,8 @@ function requireNative() {
         try {
           const binding = require('@local-sandbox/lsb-nodejs-linux-riscv64-gnu')
           const bindingPackageVersion = require('@local-sandbox/lsb-nodejs-linux-riscv64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -425,8 +425,8 @@ function requireNative() {
       try {
         const binding = require('@local-sandbox/lsb-nodejs-linux-ppc64-gnu')
         const bindingPackageVersion = require('@local-sandbox/lsb-nodejs-linux-ppc64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -441,8 +441,8 @@ function requireNative() {
       try {
         const binding = require('@local-sandbox/lsb-nodejs-linux-s390x-gnu')
         const bindingPackageVersion = require('@local-sandbox/lsb-nodejs-linux-s390x-gnu/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -461,8 +461,8 @@ function requireNative() {
       try {
         const binding = require('@local-sandbox/lsb-nodejs-openharmony-arm64')
         const bindingPackageVersion = require('@local-sandbox/lsb-nodejs-openharmony-arm64/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -477,8 +477,8 @@ function requireNative() {
       try {
         const binding = require('@local-sandbox/lsb-nodejs-openharmony-x64')
         const bindingPackageVersion = require('@local-sandbox/lsb-nodejs-openharmony-x64/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -493,8 +493,8 @@ function requireNative() {
       try {
         const binding = require('@local-sandbox/lsb-nodejs-openharmony-arm')
         const bindingPackageVersion = require('@local-sandbox/lsb-nodejs-openharmony-arm/package.json').version
-        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -557,5 +557,7 @@ if (!nativeBinding) {
 }
 
 module.exports = nativeBinding
+module.exports.ByteStream = nativeBinding.ByteStream
 module.exports.Sandbox = nativeBinding.Sandbox
 module.exports.SpawnedProcess = nativeBinding.SpawnedProcess
+module.exports.WatchStream = nativeBinding.WatchStream

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@local-sandbox/lsb-nodejs",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Native Node.js bindings for lsb microVM sandboxes",
   "main": "index.js",
   "types": "index.d.ts",
@@ -14,7 +14,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/LocalSandBox/local-sandbox.git",
+    "url": "git+https://github.com/LocalSandBox/local-sandbox.git",
     "directory": "bindings/nodejs"
   },
   "keywords": [
@@ -96,7 +96,7 @@
   },
   "packageManager": "yarn@4.12.0",
   "optionalDependencies": {
-    "@local-sandbox/lsb-nodejs-darwin-arm64": "0.1.0",
-    "@local-sandbox/lsb-nodejs-darwin-x64": "0.1.0"
+    "@local-sandbox/lsb-nodejs-darwin-arm64": "0.2.0",
+    "@local-sandbox/lsb-nodejs-darwin-x64": "0.2.0"
   }
 }