@boxlite-ai/boxlite 0.1.0

package/dist/constants.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Default configuration constants for BoxLite specialized boxes.
+ *
+ * These values match the Python SDK for consistency across language bindings.
+ */
+export declare const COMPUTERBOX_IMAGE = "ghcr.io/boxlite-labs/computerbox:latest";
+export declare const COMPUTERBOX_CPUS = 2;
+export declare const COMPUTERBOX_MEMORY_MIB = 2048;
+export declare const COMPUTERBOX_DISPLAY_NUMBER = ":1";
+export declare const COMPUTERBOX_DISPLAY_WIDTH = 1024;
+export declare const COMPUTERBOX_DISPLAY_HEIGHT = 768;
+export declare const COMPUTERBOX_GUI_HTTP_PORT = 3000;
+export declare const COMPUTERBOX_GUI_HTTPS_PORT = 3001;
+export declare const DESKTOP_READY_TIMEOUT = 60;
+export declare const DESKTOP_READY_RETRY_DELAY = 2;
+export declare const BROWSERBOX_IMAGE_CHROMIUM = "browserless/chrome:latest";
+export declare const BROWSERBOX_IMAGE_FIREFOX = "browserless/firefox:latest";
+export declare const BROWSERBOX_IMAGE_WEBKIT = "browserless/webkit:latest";
+export declare const BROWSERBOX_PORT_CHROMIUM = 9222;
+export declare const BROWSERBOX_PORT_FIREFOX = 9223;
+export declare const BROWSERBOX_PORT_WEBKIT = 9224;
+export declare const DEFAULT_CPUS = 1;
+export declare const DEFAULT_MEMORY_MIB = 512;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../lib/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,eAAO,MAAM,iBAAiB,4CAA4C,CAAC;AAC3E,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAClC,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAC3C,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAC/C,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAC9C,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAC9C,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAC9C,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAG/C,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAG3C,eAAO,MAAM,yBAAyB,8BAA8B,CAAC;AACrE,eAAO,MAAM,wBAAwB,+BAA+B,CAAC;AACrE,eAAO,MAAM,uBAAuB,8BAA8B,CAAC;AAGnE,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAC7C,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAC5C,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAG3C,eAAO,MAAM,YAAY,IAAI,CAAC;AAC9B,eAAO,MAAM,kBAAkB,MAAM,CAAC"}

package/dist/constants.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * Default configuration constants for BoxLite specialized boxes.
+ *
+ * These values match the Python SDK for consistency across language bindings.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_MEMORY_MIB = exports.DEFAULT_CPUS = exports.BROWSERBOX_PORT_WEBKIT = exports.BROWSERBOX_PORT_FIREFOX = exports.BROWSERBOX_PORT_CHROMIUM = exports.BROWSERBOX_IMAGE_WEBKIT = exports.BROWSERBOX_IMAGE_FIREFOX = exports.BROWSERBOX_IMAGE_CHROMIUM = exports.DESKTOP_READY_RETRY_DELAY = exports.DESKTOP_READY_TIMEOUT = exports.COMPUTERBOX_GUI_HTTPS_PORT = exports.COMPUTERBOX_GUI_HTTP_PORT = exports.COMPUTERBOX_DISPLAY_HEIGHT = exports.COMPUTERBOX_DISPLAY_WIDTH = exports.COMPUTERBOX_DISPLAY_NUMBER = exports.COMPUTERBOX_MEMORY_MIB = exports.COMPUTERBOX_CPUS = exports.COMPUTERBOX_IMAGE = void 0;
+// ComputerBox (Desktop Automation) defaults
+exports.COMPUTERBOX_IMAGE = 'ghcr.io/boxlite-labs/computerbox:latest';
+exports.COMPUTERBOX_CPUS = 2;
+exports.COMPUTERBOX_MEMORY_MIB = 2048;
+exports.COMPUTERBOX_DISPLAY_NUMBER = ':1';
+exports.COMPUTERBOX_DISPLAY_WIDTH = 1024;
+exports.COMPUTERBOX_DISPLAY_HEIGHT = 768;
+exports.COMPUTERBOX_GUI_HTTP_PORT = 3000;
+exports.COMPUTERBOX_GUI_HTTPS_PORT = 3001;
+// Desktop readiness detection
+exports.DESKTOP_READY_TIMEOUT = 60; // seconds
+exports.DESKTOP_READY_RETRY_DELAY = 2; // seconds
+// BrowserBox defaults
+exports.BROWSERBOX_IMAGE_CHROMIUM = 'browserless/chrome:latest';
+exports.BROWSERBOX_IMAGE_FIREFOX = 'browserless/firefox:latest';
+exports.BROWSERBOX_IMAGE_WEBKIT = 'browserless/webkit:latest';
+// Browser CDP ports
+exports.BROWSERBOX_PORT_CHROMIUM = 9222;
+exports.BROWSERBOX_PORT_FIREFOX = 9223;
+exports.BROWSERBOX_PORT_WEBKIT = 9224;
+// Default resource limits
+exports.DEFAULT_CPUS = 1;
+exports.DEFAULT_MEMORY_MIB = 512;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../lib/constants.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,4CAA4C;AAC/B,QAAA,iBAAiB,GAAG,yCAAyC,CAAC;AAC9D,QAAA,gBAAgB,GAAG,CAAC,CAAC;AACrB,QAAA,sBAAsB,GAAG,IAAI,CAAC;AAC9B,QAAA,0BAA0B,GAAG,IAAI,CAAC;AAClC,QAAA,yBAAyB,GAAG,IAAI,CAAC;AACjC,QAAA,0BAA0B,GAAG,GAAG,CAAC;AACjC,QAAA,yBAAyB,GAAG,IAAI,CAAC;AACjC,QAAA,0BAA0B,GAAG,IAAI,CAAC;AAE/C,8BAA8B;AACjB,QAAA,qBAAqB,GAAG,EAAE,CAAC,CAAC,UAAU;AACtC,QAAA,yBAAyB,GAAG,CAAC,CAAC,CAAC,UAAU;AAEtD,sBAAsB;AACT,QAAA,yBAAyB,GAAG,2BAA2B,CAAC;AACxD,QAAA,wBAAwB,GAAG,4BAA4B,CAAC;AACxD,QAAA,uBAAuB,GAAG,2BAA2B,CAAC;AAEnE,oBAAoB;AACP,QAAA,wBAAwB,GAAG,IAAI,CAAC;AAChC,QAAA,uBAAuB,GAAG,IAAI,CAAC;AAC/B,QAAA,sBAAsB,GAAG,IAAI,CAAC;AAE3C,0BAA0B;AACb,QAAA,YAAY,GAAG,CAAC,CAAC;AACjB,QAAA,kBAAkB,GAAG,GAAG,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Base error class for all BoxLite-related errors.
+ *
+ * All BoxLite errors inherit from this class, allowing easy error type checking:
+ * ```typescript
+ * try {
+ *   await box.exec('invalid-command');
+ * } catch (err) {
+ *   if (err instanceof BoxliteError) {
+ *     console.error('BoxLite error:', err.message);
+ *   }
+ * }
+ * ```
+ */
+export declare class BoxliteError extends Error {
+    constructor(message: string);
+}
+/**
+ * Execution error thrown when a command fails (non-zero exit code).
+ *
+ * Contains details about the failed command, exit code, and stderr output.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const result = await box.exec('false');
+ * } catch (err) {
+ *   if (err instanceof ExecError) {
+ *     console.error(`Command '${err.command}' failed with exit code ${err.exitCode}`);
+ *     console.error(`Stderr: ${err.stderr}`);
+ *   }
+ * }
+ * ```
+ */
+export declare class ExecError extends BoxliteError {
+    readonly command: string;
+    readonly exitCode: number;
+    readonly stderr: string;
+    /**
+     * @param command - The command that failed
+     * @param exitCode - The non-zero exit code
+     * @param stderr - Standard error output
+     */
+    constructor(command: string, exitCode: number, stderr: string);
+}
+/**
+ * Timeout error thrown when an operation exceeds its time limit.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await waitForDesktopReady(box, 60); // 60 second timeout
+ * } catch (err) {
+ *   if (err instanceof TimeoutError) {
+ *     console.error('Operation timed out:', err.message);
+ *   }
+ * }
+ * ```
+ */
+export declare class TimeoutError extends BoxliteError {
+    constructor(message: string);
+}
+/**
+ * Parse error thrown when unable to parse command output.
+ *
+ * Used when parsing structured output (JSON, coordinates, etc.) fails.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const position = parseCursorPosition(output);
+ * } catch (err) {
+ *   if (err instanceof ParseError) {
+ *     console.error('Failed to parse output:', err.message);
+ *   }
+ * }
+ * ```
+ */
+export declare class ParseError extends BoxliteError {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../lib/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAQ5B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,SAAU,SAAQ,YAAY;aAOvB,OAAO,EAAE,MAAM;aACf,QAAQ,EAAE,MAAM;aAChB,MAAM,EAAE,MAAM;IARhC;;;;OAIG;gBAEe,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM;CAQjC;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,YAAa,SAAQ,YAAY;gBAChC,OAAO,EAAE,MAAM;CAO5B;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,UAAW,SAAQ,YAAY;gBAC9B,OAAO,EAAE,MAAM;CAO5B"}

package/dist/errors.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ParseError = exports.TimeoutError = exports.ExecError = exports.BoxliteError = void 0;
+/**
+ * Base error class for all BoxLite-related errors.
+ *
+ * All BoxLite errors inherit from this class, allowing easy error type checking:
+ * ```typescript
+ * try {
+ *   await box.exec('invalid-command');
+ * } catch (err) {
+ *   if (err instanceof BoxliteError) {
+ *     console.error('BoxLite error:', err.message);
+ *   }
+ * }
+ * ```
+ */
+class BoxliteError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'BoxliteError';
+        // Maintain proper stack trace for where our error was thrown (V8 only)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, BoxliteError);
+        }
+    }
+}
+exports.BoxliteError = BoxliteError;
+/**
+ * Execution error thrown when a command fails (non-zero exit code).
+ *
+ * Contains details about the failed command, exit code, and stderr output.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const result = await box.exec('false');
+ * } catch (err) {
+ *   if (err instanceof ExecError) {
+ *     console.error(`Command '${err.command}' failed with exit code ${err.exitCode}`);
+ *     console.error(`Stderr: ${err.stderr}`);
+ *   }
+ * }
+ * ```
+ */
+class ExecError extends BoxliteError {
+    /**
+     * @param command - The command that failed
+     * @param exitCode - The non-zero exit code
+     * @param stderr - Standard error output
+     */
+    constructor(command, exitCode, stderr) {
+        super(`Command '${command}' failed with exit code ${exitCode}: ${stderr}`);
+        this.command = command;
+        this.exitCode = exitCode;
+        this.stderr = stderr;
+        this.name = 'ExecError';
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, ExecError);
+        }
+    }
+}
+exports.ExecError = ExecError;
+/**
+ * Timeout error thrown when an operation exceeds its time limit.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await waitForDesktopReady(box, 60); // 60 second timeout
+ * } catch (err) {
+ *   if (err instanceof TimeoutError) {
+ *     console.error('Operation timed out:', err.message);
+ *   }
+ * }
+ * ```
+ */
+class TimeoutError extends BoxliteError {
+    constructor(message) {
+        super(message);
+        this.name = 'TimeoutError';
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, TimeoutError);
+        }
+    }
+}
+exports.TimeoutError = TimeoutError;
+/**
+ * Parse error thrown when unable to parse command output.
+ *
+ * Used when parsing structured output (JSON, coordinates, etc.) fails.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const position = parseCursorPosition(output);
+ * } catch (err) {
+ *   if (err instanceof ParseError) {
+ *     console.error('Failed to parse output:', err.message);
+ *   }
+ * }
+ * ```
+ */
+class ParseError extends BoxliteError {
+    constructor(message) {
+        super(message);
+        this.name = 'ParseError';
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, ParseError);
+        }
+    }
+}
+exports.ParseError = ParseError;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../lib/errors.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;GAaG;AACH,MAAa,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,uEAAuE;QACvE,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;CACF;AATD,oCASC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAa,SAAU,SAAQ,YAAY;IACzC;;;;OAIG;IACH,YACkB,OAAe,EACf,QAAgB,EAChB,MAAc;QAE9B,KAAK,CAAC,YAAY,OAAO,2BAA2B,QAAQ,KAAK,MAAM,EAAE,CAAC,CAAC;QAJ3D,YAAO,GAAP,OAAO,CAAQ;QACf,aAAQ,GAAR,QAAQ,CAAQ;QAChB,WAAM,GAAN,MAAM,CAAQ;QAG9B,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;CACF;AAjBD,8BAiBC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAa,YAAa,SAAQ,YAAY;IAC5C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;CACF;AARD,oCAQC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAa,UAAW,SAAQ,YAAY;IAC1C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;CACF;AARD,gCAQC"}

package/dist/exec.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Result of a completed command execution.
+ *
+ * Contains the exit code and collected stdout/stderr output.
+ * Used by SimpleBox and specialized box classes that collect
+ * output into strings rather than streaming.
+ *
+ * @example
+ * ```typescript
+ * const result = await simpleBox.exec('ls', '-la');
+ * console.log(`Exit code: ${result.exitCode}`);
+ * console.log(`Output:\n${result.stdout}`);
+ * if (result.stderr) {
+ *   console.error(`Errors:\n${result.stderr}`);
+ * }
+ * ```
+ */
+export interface ExecResult {
+    /**
+     * Process exit code (0 = success, non-zero = error)
+     */
+    exitCode: number;
+    /**
+     * Standard output (stdout) as a string
+     */
+    stdout: string;
+    /**
+     * Standard error (stderr) as a string
+     */
+    stderr: string;
+}
+//# sourceMappingURL=exec.d.ts.map

package/dist/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../lib/exec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/exec.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=exec.js.map

package/dist/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../lib/exec.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * BoxLite Node.js SDK
+ *
+ * Embeddable VM runtime for secure, isolated code execution environments.
+ *
+ * @example
+ * ```typescript
+ * import { SimpleBox } from '@boxlite/boxlite';
+ *
+ * const box = new SimpleBox({ image: 'alpine:latest' });
+ * try {
+ *   const result = await box.exec('echo', 'Hello from BoxLite!');
+ *   console.log(result.stdout);
+ * } finally {
+ *   await box.stop();
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+import { getNativeModule, getJsBoxlite } from './native';
+export declare const JsBoxlite: any;
+export { getNativeModule, getJsBoxlite };
+export { SimpleBox, type SimpleBoxOptions } from './simplebox';
+export { type ExecResult } from './exec';
+export { BoxliteError, ExecError, TimeoutError, ParseError } from './errors';
+export * from './constants';
+export { CodeBox, type CodeBoxOptions } from './codebox';
+export { BrowserBox, type BrowserBoxOptions, type BrowserType } from './browserbox';
+export { ComputerBox, type ComputerBoxOptions, type Screenshot } from './computerbox';
+export { InteractiveBox, type InteractiveBoxOptions } from './interactivebox';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGzD,eAAO,MAAM,SAAS,KAAiB,CAAC;AAGxC,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,CAAC;AAGzC,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC7E,cAAc,aAAa,CAAC;AAG5B,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AACtF,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * BoxLite Node.js SDK
+ *
+ * Embeddable VM runtime for secure, isolated code execution environments.
+ *
+ * @example
+ * ```typescript
+ * import { SimpleBox } from '@boxlite/boxlite';
+ *
+ * const box = new SimpleBox({ image: 'alpine:latest' });
+ * try {
+ *   const result = await box.exec('echo', 'Hello from BoxLite!');
+ *   console.log(result.stdout);
+ * } finally {
+ *   await box.stop();
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InteractiveBox = exports.ComputerBox = exports.BrowserBox = exports.CodeBox = exports.ParseError = exports.TimeoutError = exports.ExecError = exports.BoxliteError = exports.SimpleBox = exports.getJsBoxlite = exports.getNativeModule = exports.JsBoxlite = void 0;
+const native_1 = require("./native");
+Object.defineProperty(exports, "getNativeModule", { enumerable: true, get: function () { return native_1.getNativeModule; } });
+Object.defineProperty(exports, "getJsBoxlite", { enumerable: true, get: function () { return native_1.getJsBoxlite; } });
+// Re-export native bindings
+exports.JsBoxlite = (0, native_1.getJsBoxlite)();
+// Re-export TypeScript wrappers
+var simplebox_1 = require("./simplebox");
+Object.defineProperty(exports, "SimpleBox", { enumerable: true, get: function () { return simplebox_1.SimpleBox; } });
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "BoxliteError", { enumerable: true, get: function () { return errors_1.BoxliteError; } });
+Object.defineProperty(exports, "ExecError", { enumerable: true, get: function () { return errors_1.ExecError; } });
+Object.defineProperty(exports, "TimeoutError", { enumerable: true, get: function () { return errors_1.TimeoutError; } });
+Object.defineProperty(exports, "ParseError", { enumerable: true, get: function () { return errors_1.ParseError; } });
+__exportStar(require("./constants"), exports);
+// Specialized boxes
+var codebox_1 = require("./codebox");
+Object.defineProperty(exports, "CodeBox", { enumerable: true, get: function () { return codebox_1.CodeBox; } });
+var browserbox_1 = require("./browserbox");
+Object.defineProperty(exports, "BrowserBox", { enumerable: true, get: function () { return browserbox_1.BrowserBox; } });
+var computerbox_1 = require("./computerbox");
+Object.defineProperty(exports, "ComputerBox", { enumerable: true, get: function () { return computerbox_1.ComputerBox; } });
+var interactivebox_1 = require("./interactivebox");
+Object.defineProperty(exports, "InteractiveBox", { enumerable: true, get: function () { return interactivebox_1.InteractiveBox; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;;;;;;;;;;;;;;;AAEH,qCAAyD;AAMhD,gGANA,wBAAe,OAMA;AAAE,6FANA,qBAAY,OAMA;AAJtC,4BAA4B;AACf,QAAA,SAAS,GAAG,IAAA,qBAAY,GAAE,CAAC;AAKxC,gCAAgC;AAChC,yCAA+D;AAAtD,sGAAA,SAAS,OAAA;AAElB,mCAA6E;AAApE,sGAAA,YAAY,OAAA;AAAE,mGAAA,SAAS,OAAA;AAAE,sGAAA,YAAY,OAAA;AAAE,oGAAA,UAAU,OAAA;AAC1D,8CAA4B;AAE5B,oBAAoB;AACpB,qCAAyD;AAAhD,kGAAA,OAAO,OAAA;AAChB,2CAAoF;AAA3E,wGAAA,UAAU,OAAA;AACnB,6CAAsF;AAA7E,0GAAA,WAAW,OAAA;AACpB,mDAA8E;AAArE,gHAAA,cAAc,OAAA"}

package/dist/interactivebox.d.ts

@@ -0,0 +1,155 @@
+/**
+ * InteractiveBox - Interactive terminal sessions with PTY support.
+ *
+ * Provides automatic PTY-based interactive sessions, similar to `docker exec -it`.
+ */
+import { SimpleBoxOptions } from './simplebox';
+type Boxlite = any;
+type Box = any;
+type Execution = any;
+/**
+ * Options for creating an InteractiveBox.
+ */
+export interface InteractiveBoxOptions extends SimpleBoxOptions {
+    /** Shell to run (default: '/bin/sh') */
+    shell?: string;
+    /**
+     * Control terminal I/O forwarding behavior:
+     * - undefined (default): Auto-detect - forward I/O if stdin is a TTY
+     * - true: Force I/O forwarding (manual interactive mode)
+     * - false: No I/O forwarding (programmatic control only)
+     */
+    tty?: boolean;
+}
+/**
+ * Interactive box with automatic PTY and terminal forwarding.
+ *
+ * When used as a context manager, automatically:
+ * 1. Auto-detects terminal size (like Docker)
+ * 2. Starts a shell with PTY
+ * 3. Sets local terminal to raw mode
+ * 4. Forwards stdin/stdout bidirectionally
+ * 5. Restores terminal mode on exit
+ *
+ * ## Example
+ *
+ * ```typescript
+ * const box = new InteractiveBox({ image: 'alpine:latest' });
+ * try {
+ *   await box.start();
+ *   // You're now in an interactive shell!
+ *   // Type commands, see output in real-time
+ *   // Type "exit" to close
+ *   await box.wait();
+ * } finally {
+ *   await box.stop();
+ * }
+ * ```
+ *
+ * Or with async disposal (TypeScript 5.2+):
+ *
+ * ```typescript
+ * await using box = new InteractiveBox({ image: 'alpine:latest' });
+ * await box.start();
+ * await box.wait();
+ * // Automatically stopped when leaving scope
+ * ```
+ */
+export declare class InteractiveBox {
+    protected _runtime: Boxlite;
+    protected _box: Box;
+    protected _shell: string;
+    protected _env?: Record<string, string>;
+    protected _tty: boolean;
+    protected _execution?: Execution;
+    protected _stdin?: any;
+    protected _stdout?: any;
+    protected _stderr?: any;
+    protected _ioTasks: Promise<void>[];
+    protected _exited: boolean;
+    /**
+     * Create an interactive box.
+     *
+     * @param options - InteractiveBox configuration options
+     *
+     * @example
+     * ```typescript
+     * const box = new InteractiveBox({
+     *   image: 'alpine:latest',
+     *   shell: '/bin/sh',
+     *   tty: true,
+     *   memoryMib: 512,
+     *   cpus: 1
+     * });
+     * ```
+     */
+    constructor(options: InteractiveBoxOptions);
+    /**
+     * Get the box ID (ULID format).
+     */
+    get id(): string;
+    /**
+     * Start the interactive shell session.
+     *
+     * This method:
+     * 1. Starts the shell with PTY
+     * 2. Sets terminal to raw mode (if tty=true)
+     * 3. Begins I/O forwarding
+     *
+     * @example
+     * ```typescript
+     * await box.start();
+     * ```
+     */
+    start(): Promise<void>;
+    /**
+     * Wait for the shell to exit.
+     *
+     * @example
+     * ```typescript
+     * await box.start();
+     * await box.wait();  // Blocks until shell exits
+     * ```
+     */
+    wait(): Promise<void>;
+    /**
+     * Stop the box and restore terminal settings.
+     *
+     * @example
+     * ```typescript
+     * await box.stop();
+     * ```
+     */
+    stop(): Promise<void>;
+    /**
+     * Implement async disposable pattern (TypeScript 5.2+).
+     *
+     * Allows using `await using` syntax for automatic cleanup.
+     *
+     * @example
+     * ```typescript
+     * await using box = new InteractiveBox({ image: 'alpine' });
+     * await box.start();
+     * // Box automatically stopped when leaving scope
+     * ```
+     */
+    [Symbol.asyncDispose](): Promise<void>;
+    /**
+     * Forward stdin to PTY (internal).
+     */
+    private _forwardStdin;
+    /**
+     * Forward PTY output to stdout (internal).
+     */
+    private _forwardOutput;
+    /**
+     * Forward PTY stderr to stderr (internal).
+     */
+    private _forwardStderr;
+    /**
+     * Wait for the shell to exit (internal).
+     */
+    private _waitForExit;
+}
+export {};
+//# sourceMappingURL=interactivebox.d.ts.map

package/dist/interactivebox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactivebox.d.ts","sourceRoot":"","sources":["../lib/interactivebox.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAI/C,KAAK,OAAO,GAAG,GAAG,CAAC;AACnB,KAAK,GAAG,GAAG,GAAG,CAAC;AACf,KAAK,SAAS,GAAG,GAAG,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,gBAAgB;IAC7D,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;OAKG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,cAAc;IACzB,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC5B,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC;IACpB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC;IACjC,SAAS,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC;IACvB,SAAS,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC;IACxB,SAAS,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC;IACxB,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,CAAM;IACzC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAS;IAEnC;;;;;;;;;;;;;;;OAeG;gBACS,OAAO,EAAE,qBAAqB;IAyB1C;;OAEG;IACH,IAAI,EAAE,IAAI,MAAM,CAEf;IAED;;;;;;;;;;;;OAYG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA+C5B;;;;;;;;OAQG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;;;;;;OAOG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAyB3B;;;;;;;;;;;OAWG;IACG,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C;;OAEG;YACW,aAAa;IA4B3B;;OAEG;YACW,cAAc;IAoB5B;;OAEG;YACW,cAAc;IAoB5B;;OAEG;YACW,YAAY;CAW3B"}