microsandbox 0.1.0 → 0.1.1

package/dist/command.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Command execution interface for the Microsandbox TypeScript SDK.
+ */
+import { CommandExecution } from "./command-execution";
+import { BaseSandbox } from "./base-sandbox";
+export declare class Command {
+    private sandbox;
+    /**
+     * Initialize the command instance.
+     *
+     * @param sandboxInstance - The sandbox instance this command belongs to
+     */
+    constructor(sandboxInstance: BaseSandbox);
+    /**
+     * Execute a shell command in the sandbox.
+     *
+     * @param command - The command to execute
+     * @param args - Optional list of command arguments
+     * @param timeout - Optional timeout in seconds
+     * @returns A CommandExecution object containing the results
+     * @throws Error if the sandbox is not started or execution fails
+     */
+    run(command: string, args?: string[], timeout?: number): Promise<CommandExecution>;
+}

package/dist/command.js

@@ -0,0 +1,84 @@
+"use strict";
+/**
+ * Command execution interface for the Microsandbox TypeScript SDK.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Command = void 0;
+const uuid_1 = require("uuid");
+const node_fetch_1 = __importDefault(require("node-fetch"));
+const command_execution_1 = require("./command-execution");
+class Command {
+    /**
+     * Initialize the command instance.
+     *
+     * @param sandboxInstance - The sandbox instance this command belongs to
+     */
+    constructor(sandboxInstance) {
+        this.sandbox = sandboxInstance;
+    }
+    /**
+     * Execute a shell command in the sandbox.
+     *
+     * @param command - The command to execute
+     * @param args - Optional list of command arguments
+     * @param timeout - Optional timeout in seconds
+     * @returns A CommandExecution object containing the results
+     * @throws Error if the sandbox is not started or execution fails
+     */
+    async run(command, args, timeout) {
+        if (!this.sandbox.isStarted) {
+            throw new Error("Sandbox is not started. Call start() first.");
+        }
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        if (this.sandbox.apiKey) {
+            headers["Authorization"] = `Bearer ${this.sandbox.apiKey}`;
+        }
+        // Prepare the request data
+        const requestData = {
+            jsonrpc: "2.0",
+            method: "sandbox.command.run",
+            params: {
+                sandbox: this.sandbox.name,
+                namespace: this.sandbox.namespace,
+                command,
+                args: args || [],
+            },
+            id: (0, uuid_1.v4)(),
+        };
+        // Add timeout if specified
+        if (timeout !== undefined) {
+            requestData.params.timeout = timeout;
+        }
+        try {
+            const response = await (0, node_fetch_1.default)(`${this.sandbox.serverUrl}/api/v1/rpc`, {
+                method: "POST",
+                headers,
+                body: JSON.stringify(requestData),
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`Failed to execute command: ${errorText}`);
+            }
+            const responseData = await response.json();
+            if ("error" in responseData) {
+                throw new Error(`Failed to execute command: ${responseData.error.message}`);
+            }
+            const result = responseData.result || {};
+            // Create and return a CommandExecution object with the output data
+            return new command_execution_1.CommandExecution(result);
+        }
+        catch (e) {
+            if (e instanceof Error) {
+                throw new Error(`Failed to execute command: ${e.message}`);
+            }
+            throw new Error("Failed to execute command: Unknown error");
+        }
+    }
+}
+exports.Command = Command;
+//# sourceMappingURL=command.js.map

package/dist/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;AAEH,+BAAoC;AACpC,4DAA+B;AAE/B,2DAAuD;AAGvD,MAAa,OAAO;IAGlB;;;;OAIG;IACH,YAAY,eAA4B;QACtC,IAAI,CAAC,OAAO,GAAG,eAAe,CAAC;IACjC,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,GAAG,CACP,OAAe,EACf,IAAe,EACf,OAAgB;QAEhB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QAED,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;SACnC,CAAC;QAEF,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACxB,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAC7D,CAAC;QAED,2BAA2B;QAC3B,MAAM,WAAW,GAWb;YACF,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,qBAAqB;YAC7B,MAAM,EAAE;gBACN,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI;gBAC1B,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS;gBACjC,OAAO;gBACP,IAAI,EAAE,IAAI,IAAI,EAAE;aACjB;YACD,EAAE,EAAE,IAAA,SAAM,GAAE;SACb,CAAC;QAEF,2BAA2B;QAC3B,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,WAAW,CAAC,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;QACvC,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAA,oBAAK,EAAC,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,aAAa,EAAE;gBACnE,MAAM,EAAE,MAAM;gBACd,OAAO;gBACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;aAClC,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACxC,MAAM,IAAI,KAAK,CAAC,8BAA8B,SAAS,EAAE,CAAC,CAAC;YAC7D,CAAC;YAED,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAE3C,IAAI,OAAO,IAAI,YAAY,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CACb,8BAA8B,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE,CAC3D,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,IAAI,EAAE,CAAC;YAEzC,mEAAmE;YACnE,OAAO,IAAI,oCAAgB,CAAC,MAAM,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,KAAK,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAC7D,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;CACF;AAlGD,0BAkGC"}

package/dist/execution.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Class representing code execution results in a sandbox environment.
+ */
+import { OutputData } from "./types";
+export declare class Execution {
+    private outputLines;
+    private _status;
+    private _language;
+    private _hasError;
+    /**
+     * Initialize an execution instance.
+     *
+     * @param outputData - Output data from the sandbox.repl.run response
+     */
+    constructor(outputData?: OutputData);
+    /**
+     * Process output data from the sandbox.repl.run response.
+     *
+     * @param outputData - Dictionary containing the output data
+     */
+    private processOutputData;
+    /**
+     * Get the standard output from the execution.
+     *
+     * @returns String containing the stdout output of the execution
+     */
+    output(): Promise<string>;
+    /**
+     * Get the error output from the execution.
+     *
+     * @returns String containing the stderr output of the execution
+     */
+    error(): Promise<string>;
+    /**
+     * Check if the execution contains an error.
+     *
+     * @returns Boolean indicating whether the execution encountered an error
+     */
+    hasError(): boolean;
+    /**
+     * Get the status of the execution.
+     *
+     * @returns String containing the execution status (e.g., "success")
+     */
+    get status(): string;
+    /**
+     * Get the language used for the execution.
+     *
+     * @returns String containing the execution language (e.g., "python")
+     */
+    get language(): string;
+}

package/dist/execution.js

@@ -0,0 +1,103 @@
+"use strict";
+/**
+ * Class representing code execution results in a sandbox environment.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Execution = void 0;
+class Execution {
+    /**
+     * Initialize an execution instance.
+     *
+     * @param outputData - Output data from the sandbox.repl.run response
+     */
+    constructor(outputData) {
+        this.outputLines = [];
+        this._status = "unknown";
+        this._language = "unknown";
+        this._hasError = false;
+        if (outputData) {
+            this.processOutputData(outputData);
+        }
+    }
+    /**
+     * Process output data from the sandbox.repl.run response.
+     *
+     * @param outputData - Dictionary containing the output data
+     */
+    processOutputData(outputData) {
+        // Extract output lines from the response
+        this.outputLines = outputData.output || [];
+        // Store additional metadata that might be useful
+        this._status = outputData.status || "unknown";
+        this._language = outputData.language || "unknown";
+        // Check for errors in the output or status
+        if (this._status === "error" || this._status === "exception") {
+            this._hasError = true;
+        }
+        else {
+            // Check if there's any stderr output
+            for (const line of this.outputLines) {
+                if (line.stream === "stderr" && line.text) {
+                    this._hasError = true;
+                    break;
+                }
+            }
+        }
+    }
+    /**
+     * Get the standard output from the execution.
+     *
+     * @returns String containing the stdout output of the execution
+     */
+    async output() {
+        // Combine the stdout output lines into a single string
+        let outputText = "";
+        for (const line of this.outputLines) {
+            if (line.stream === "stdout") {
+                outputText += line.text + "\n";
+            }
+        }
+        return outputText.trim();
+    }
+    /**
+     * Get the error output from the execution.
+     *
+     * @returns String containing the stderr output of the execution
+     */
+    async error() {
+        // Combine the stderr output lines into a single string
+        let errorText = "";
+        for (const line of this.outputLines) {
+            if (line.stream === "stderr") {
+                errorText += line.text + "\n";
+            }
+        }
+        return errorText.trim();
+    }
+    /**
+     * Check if the execution contains an error.
+     *
+     * @returns Boolean indicating whether the execution encountered an error
+     */
+    hasError() {
+        return this._hasError;
+    }
+    /**
+     * Get the status of the execution.
+     *
+     * @returns String containing the execution status (e.g., "success")
+     */
+    get status() {
+        return this._status;
+    }
+    /**
+     * Get the language used for the execution.
+     *
+     * @returns String containing the execution language (e.g., "python")
+     */
+    get language() {
+        return this._language;
+    }
+}
+exports.Execution = Execution;
+//# sourceMappingURL=execution.js.map

package/dist/execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.js","sourceRoot":"","sources":["../src/execution.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAIH,MAAa,SAAS;IAMpB;;;;OAIG;IACH,YAAY,UAAuB;QAV3B,gBAAW,GAAiB,EAAE,CAAC;QAC/B,YAAO,GAAW,SAAS,CAAC;QAC5B,cAAS,GAAW,SAAS,CAAC;QAC9B,cAAS,GAAY,KAAK,CAAC;QAQjC,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,iBAAiB,CAAC,UAAsB;QAC9C,yCAAyC;QACzC,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC,MAAM,IAAI,EAAE,CAAC;QAE3C,iDAAiD;QACjD,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,MAAM,IAAI,SAAS,CAAC;QAC9C,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,QAAQ,IAAI,SAAS,CAAC;QAElD,2CAA2C;QAC3C,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,IAAI,IAAI,CAAC,OAAO,KAAK,WAAW,EAAE,CAAC;YAC7D,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACxB,CAAC;aAAM,CAAC;YACN,qCAAqC;YACrC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBACpC,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;oBAC1C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;oBACtB,MAAM;gBACR,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM;QACV,uDAAuD;QACvD,IAAI,UAAU,GAAG,EAAE,CAAC;QACpB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACpC,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC7B,UAAU,IAAI,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACjC,CAAC;QACH,CAAC;QAED,OAAO,UAAU,CAAC,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK;QACT,uDAAuD;QACvD,IAAI,SAAS,GAAG,EAAE,CAAC;QACnB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACpC,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC7B,SAAS,IAAI,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YAChC,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC,IAAI,EAAE,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACH,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;;;OAIG;IACH,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;CACF;AAxGD,8BAwGC"}

package/dist/index.d.ts

@@ -1,12 +1,13 @@
 /**
- * Microsandbox JavaScript SDK
+ * Microsandbox TypeScript SDK
  *
- * A minimal SDK for the Microsandbox project.
+ * A TypeScript SDK for creating and managing secure sandboxes for code execution.
  */
-/**
- * Returns a greeting message for the given name.
- *
- * @param name - The name to greet
- * @returns A greeting message
- */
-export declare function greet(name: string): string;
+export { BaseSandbox } from "./base-sandbox";
+export { Command } from "./command";
+export { CommandExecution } from "./command-execution";
+export { Execution } from "./execution";
+export { Metrics } from "./metrics";
+export { NodeSandbox } from "./node-sandbox";
+export { PythonSandbox } from "./python-sandbox";
+export { SandboxOptions } from "./types";

package/dist/index.js

@@ -1,19 +1,25 @@
 "use strict";
 /**
- * Microsandbox JavaScript SDK
+ * Microsandbox TypeScript SDK
  *
- * A minimal SDK for the Microsandbox project.
+ * A TypeScript SDK for creating and managing secure sandboxes for code execution.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.greet = greet;
-/**
- * Returns a greeting message for the given name.
- *
- * @param name - The name to greet
- * @returns A greeting message
- */
-function greet(name) {
-    const message = `Hello, ${name}! Welcome to Microsandbox!`;
-    console.log(message);
-    return message;
-}
+exports.SandboxOptions = exports.PythonSandbox = exports.NodeSandbox = exports.Metrics = exports.Execution = exports.CommandExecution = exports.Command = exports.BaseSandbox = void 0;
+var base_sandbox_1 = require("./base-sandbox");
+Object.defineProperty(exports, "BaseSandbox", { enumerable: true, get: function () { return base_sandbox_1.BaseSandbox; } });
+var command_1 = require("./command");
+Object.defineProperty(exports, "Command", { enumerable: true, get: function () { return command_1.Command; } });
+var command_execution_1 = require("./command-execution");
+Object.defineProperty(exports, "CommandExecution", { enumerable: true, get: function () { return command_execution_1.CommandExecution; } });
+var execution_1 = require("./execution");
+Object.defineProperty(exports, "Execution", { enumerable: true, get: function () { return execution_1.Execution; } });
+var metrics_1 = require("./metrics");
+Object.defineProperty(exports, "Metrics", { enumerable: true, get: function () { return metrics_1.Metrics; } });
+var node_sandbox_1 = require("./node-sandbox");
+Object.defineProperty(exports, "NodeSandbox", { enumerable: true, get: function () { return node_sandbox_1.NodeSandbox; } });
+var python_sandbox_1 = require("./python-sandbox");
+Object.defineProperty(exports, "PythonSandbox", { enumerable: true, get: function () { return python_sandbox_1.PythonSandbox; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "SandboxOptions", { enumerable: true, get: function () { return types_1.SandboxOptions; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AACpB,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAChB,yDAAuD;AAA9C,qHAAA,gBAAgB,OAAA;AACzB,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAClB,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAChB,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AACpB,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AACtB,iCAAyC;AAAhC,uGAAA,cAAc,OAAA"}

package/dist/metrics.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Metrics interface for the Microsandbox TypeScript SDK.
+ */
+import { BaseSandbox } from "./base-sandbox";
+export declare class Metrics {
+    private sandbox;
+    /**
+     * Initialize the metrics instance.
+     *
+     * @param sandboxInstance - The sandbox instance this metrics object belongs to
+     */
+    constructor(sandboxInstance: BaseSandbox);
+    /**
+     * Internal method to fetch current metrics from the server.
+     *
+     * @returns A dictionary containing the metrics data for the sandbox
+     * @throws Error if the request to the server fails
+     */
+    private getMetrics;
+    /**
+     * Get all metrics for the current sandbox.
+     *
+     * @returns A dictionary containing all metrics for the sandbox:
+     * {
+     *   "name": string,
+     *   "namespace": string,
+     *   "running": boolean,
+     *   "cpu_usage": number | null,
+     *   "memory_usage": number | null,
+     *   "disk_usage": number | null
+     * }
+     *
+     * @throws Error if the sandbox is not started or if the request fails
+     */
+    all(): Promise<any>;
+    /**
+     * Get CPU usage percentage for the current sandbox.
+     *
+     * @returns CPU usage as a percentage (0-100) or undefined if not available.
+     * May return 0.0 for idle sandboxes or when metrics are not precise.
+     *
+     * @throws Error if the sandbox is not started or if the request fails
+     */
+    cpu(): Promise<number | undefined>;
+    /**
+     * Get memory usage for the current sandbox.
+     *
+     * @returns Memory usage in MiB or undefined if not available
+     *
+     * @throws Error if the sandbox is not started or if the request fails
+     */
+    memory(): Promise<number | undefined>;
+    /**
+     * Get disk usage for the current sandbox.
+     *
+     * @returns Disk usage in bytes or undefined if not available
+     *
+     * @throws Error if the sandbox is not started or if the request fails
+     */
+    disk(): Promise<number | undefined>;
+    /**
+     * Check if the sandbox is currently running.
+     *
+     * @returns True if the sandbox is running, False otherwise
+     *
+     * @throws Error if the request to the server fails
+     */
+    isRunning(): Promise<boolean>;
+}

package/dist/metrics.js

@@ -0,0 +1,142 @@
+"use strict";
+/**
+ * Metrics interface for the Microsandbox TypeScript SDK.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Metrics = void 0;
+const uuid_1 = require("uuid");
+const node_fetch_1 = __importDefault(require("node-fetch"));
+class Metrics {
+    /**
+     * Initialize the metrics instance.
+     *
+     * @param sandboxInstance - The sandbox instance this metrics object belongs to
+     */
+    constructor(sandboxInstance) {
+        this.sandbox = sandboxInstance;
+    }
+    /**
+     * Internal method to fetch current metrics from the server.
+     *
+     * @returns A dictionary containing the metrics data for the sandbox
+     * @throws Error if the request to the server fails
+     */
+    async getMetrics() {
+        if (!this.sandbox.isStarted) {
+            throw new Error("Sandbox is not started. Call start() first.");
+        }
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        if (this.sandbox.apiKey) {
+            headers["Authorization"] = `Bearer ${this.sandbox.apiKey}`;
+        }
+        // Prepare the request data
+        const requestData = {
+            jsonrpc: "2.0",
+            method: "sandbox.metrics.get",
+            params: {
+                namespace: this.sandbox.namespace,
+                sandbox: this.sandbox.name,
+            },
+            id: (0, uuid_1.v4)(),
+        };
+        try {
+            const response = await (0, node_fetch_1.default)(`${this.sandbox.serverUrl}/api/v1/rpc`, {
+                method: "POST",
+                headers,
+                body: JSON.stringify(requestData),
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`Failed to get sandbox metrics: ${errorText}`);
+            }
+            const responseData = await response.json();
+            if ("error" in responseData) {
+                throw new Error(`Failed to get sandbox metrics: ${responseData.error.message}`);
+            }
+            const result = responseData.result || {};
+            const sandboxes = result.sandboxes || [];
+            // We expect exactly one sandbox in the response (our own)
+            if (!sandboxes.length) {
+                return {};
+            }
+            // Return the first (and should be only) sandbox data
+            return sandboxes[0];
+        }
+        catch (e) {
+            if (e instanceof Error) {
+                throw new Error(`Failed to get sandbox metrics: ${e.message}`);
+            }
+            throw new Error("Failed to get sandbox metrics: Unknown error");
+        }
+    }
+    /**
+     * Get all metrics for the current sandbox.
+     *
+     * @returns A dictionary containing all metrics for the sandbox:
+     * {
+     *   "name": string,
+     *   "namespace": string,
+     *   "running": boolean,
+     *   "cpu_usage": number | null,
+     *   "memory_usage": number | null,
+     *   "disk_usage": number | null
+     * }
+     *
+     * @throws Error if the sandbox is not started or if the request fails
+     */
+    async all() {
+        return await this.getMetrics();
+    }
+    /**
+     * Get CPU usage percentage for the current sandbox.
+     *
+     * @returns CPU usage as a percentage (0-100) or undefined if not available.
+     * May return 0.0 for idle sandboxes or when metrics are not precise.
+     *
+     * @throws Error if the sandbox is not started or if the request fails
+     */
+    async cpu() {
+        const metrics = await this.getMetrics();
+        return metrics.cpu_usage;
+    }
+    /**
+     * Get memory usage for the current sandbox.
+     *
+     * @returns Memory usage in MiB or undefined if not available
+     *
+     * @throws Error if the sandbox is not started or if the request fails
+     */
+    async memory() {
+        const metrics = await this.getMetrics();
+        return metrics.memory_usage;
+    }
+    /**
+     * Get disk usage for the current sandbox.
+     *
+     * @returns Disk usage in bytes or undefined if not available
+     *
+     * @throws Error if the sandbox is not started or if the request fails
+     */
+    async disk() {
+        const metrics = await this.getMetrics();
+        return metrics.disk_usage;
+    }
+    /**
+     * Check if the sandbox is currently running.
+     *
+     * @returns True if the sandbox is running, False otherwise
+     *
+     * @throws Error if the request to the server fails
+     */
+    async isRunning() {
+        const metrics = await this.getMetrics();
+        return metrics.running || false;
+    }
+}
+exports.Metrics = Metrics;
+//# sourceMappingURL=metrics.js.map

package/dist/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"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"}

package/dist/node-sandbox.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Node.js-specific sandbox implementation for the Microsandbox TypeScript SDK.
+ */
+import { BaseSandbox } from "./base-sandbox";
+import { Execution } from "./execution";
+import { SandboxOptions } from "./types";
+export declare class NodeSandbox extends BaseSandbox {
+    /**
+     * Get the default Docker image for Node.js sandbox.
+     *
+     * @returns A string containing the Docker image name and tag
+     */
+    getDefaultImage(): Promise<string>;
+    /**
+     * Execute JavaScript code in the sandbox.
+     *
+     * @param code - JavaScript code to execute
+     * @param options - Optional execution options like timeout
+     * @returns An Execution object that represents the executed code
+     * @throws Error if the sandbox is not started or execution fails
+     */
+    run(code: string, options?: {
+        timeout?: number;
+    }): Promise<Execution>;
+    /**
+     * Create and initialize a new NodeSandbox instance.
+     *
+     * @param options - Configuration options for the sandbox
+     * @returns A Promise resolving to a new NodeSandbox instance
+     */
+    static create(options?: SandboxOptions): Promise<NodeSandbox>;
+}