Node.js SDK

import { JsBoxlite, SimpleBox, CodeBox, BrowserBox, ComputerBox } from '@boxlite-ai/boxlite';

npm install @boxlite-ai/boxlite

yarn add @boxlite-ai/boxlite

import { JsBoxlite } from '@boxlite-ai/boxlite';
// or use the wrapper classes
import { SimpleBox } from '@boxlite-ai/boxlite';

new JsBoxlite(options: JsOptions)

// Default runtime
const runtime = JsBoxlite.withDefaultConfig();

// Custom runtime
const runtime = new JsBoxlite({ homeDir: '/custom/path' });

// Create a box
const box = await runtime.create({
  image: 'alpine:latest',
  cpus: 2,
  memoryMib: 512
}, 'my-box');

// List all boxes
const boxes = await runtime.listInfo();
boxes.forEach(info => console.log(`${info.id}: ${info.status}`));

interface JsEnvVar {
  key: string;
  value: string;
}

interface JsVolumeSpec {
  hostPath: string;    // Path on host
  guestPath: string;   // Path in container
  readOnly?: boolean;  // Default: false
}

interface JsPortSpec {
  hostPort?: number;   // None = auto-assign
  guestPort: number;   // Port inside container
  protocol?: string;   // "tcp" or "udp" (default: "tcp")
  hostIp?: string;     // Default: "0.0.0.0"
}