@saikrishnaambeti/docker-sandbox 1.0.0

package/dist/index-rff3tvyv.js

@@ -0,0 +1,21 @@
+// @bun
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __toESM = (mod, isNodeMode, target) => {
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: () => mod[key],
+        enumerable: true
+      });
+  return to;
+};
+var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __require = import.meta.require;
+
+export { __toESM, __commonJS, __require };

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { Sandbox, createLogStream, type SandboxOptions, type CommandOptions, type CommandFinished, } from "./sdk";
+export { startServer, type ServerOptions } from "./server";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,OAAO,EACP,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,OAAO,CAAC;AAGf,OAAO,EAAE,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+// @bun
+import {
+  Sandbox,
+  createLogStream
+} from "./sdk/index.js";
+import {
+  startServer
+} from "./server/index.js";
+import"./index-rff3tvyv.js";
+export {
+  startServer,
+  createLogStream,
+  Sandbox
+};

package/dist/sdk/index.d.ts

@@ -0,0 +1,67 @@
+export interface SandboxOptions {
+    /** Server URL (defaults to http://localhost:4000) */
+    serverUrl?: string;
+    /** Git source to clone into the sandbox */
+    source?: {
+        url: string;
+        type: "git";
+    };
+    /** Timeout in milliseconds */
+    timeout?: number;
+    /** Ports to expose from the container */
+    ports?: number[];
+    /** Runtime environment (e.g., "node22") */
+    runtime?: string;
+}
+export interface CommandOptions {
+    /** Command to run */
+    cmd: string;
+    /** Arguments for the command */
+    args: string[];
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** Stream to write stderr output */
+    stderr?: WritableStream<Uint8Array>;
+    /** Stream to write stdout output */
+    stdout?: WritableStream<Uint8Array>;
+    /** Run in background without waiting */
+    detached?: boolean;
+}
+export interface CommandFinished {
+    /** Exit code of the command */
+    exitCode: number;
+}
+export declare class Sandbox {
+    /** Container ID */
+    id: string;
+    /** Mapped ports (container port -> host port) */
+    ports: Record<number, number>;
+    /** Server URL */
+    private serverUrl;
+    constructor(id: string, ports: Record<number, number>, serverUrl?: string);
+    /**
+     * Create a new sandbox container
+     */
+    static create(opts?: SandboxOptions): Promise<Sandbox>;
+    /**
+     * Run a command in the sandbox
+     */
+    runCommand(opts: CommandOptions): Promise<CommandFinished>;
+    /**
+     * Get the info about the sandbox container
+     */
+    getInfo(): Promise<unknown>;
+    /**
+     * Stop and remove the sandbox container
+     */
+    destroy(): Promise<void>;
+    /**
+     * Get the URL for an exposed port
+     */
+    domain(port: number): string;
+}
+/**
+ * Helper to create a WritableStream from Node.js stdout/stderr
+ */
+export declare function createLogStream(stream: NodeJS.WriteStream): WritableStream<Uint8Array>;
+//# sourceMappingURL=index.d.ts.map

package/dist/sdk/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,MAAM,CAAC,EAAE;QACP,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,KAAK,CAAC;KACb,CAAC;IACF,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,qBAAqB;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,gCAAgC;IAChC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,oCAAoC;IACpC,MAAM,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IACpC,oCAAoC;IACpC,MAAM,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IACpC,wCAAwC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;CAClB;AASD,qBAAa,OAAO;IAClB,mBAAmB;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,iBAAiB;IACjB,OAAO,CAAC,SAAS,CAAS;gBAGxB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7B,SAAS,GAAE,MAA2B;IAOxC;;OAEG;WACU,MAAM,CAAC,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAqBhE;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IA4EhE;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAQjC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAS9B;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAK7B;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,CAAC,WAAW,GACzB,cAAc,CAAC,UAAU,CAAC,CAM5B"}

package/dist/sdk/index.js

@@ -0,0 +1,128 @@
+// @bun
+import"../index-rff3tvyv.js";
+
+// src/sdk/index.ts
+var DEFAULT_SERVER_URL = "http://localhost:4000";
+
+class Sandbox {
+  id;
+  ports;
+  serverUrl;
+  constructor(id, ports, serverUrl = DEFAULT_SERVER_URL) {
+    this.id = id;
+    this.ports = ports;
+    this.serverUrl = serverUrl;
+  }
+  static async create(opts = {}) {
+    const serverUrl = opts.serverUrl || DEFAULT_SERVER_URL;
+    const res = await fetch(`${serverUrl}/sandbox`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        source: opts.source,
+        ports: opts.ports,
+        runtime: opts.runtime
+      })
+    });
+    if (!res.ok) {
+      throw new Error(`Failed to create sandbox: ${await res.text()}`);
+    }
+    const data = await res.json();
+    return new Sandbox(data.id, data.ports, serverUrl);
+  }
+  async runCommand(opts) {
+    const res = await fetch(`${this.serverUrl}/sandbox/${this.id}/exec`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        cmd: opts.cmd,
+        args: opts.args,
+        detached: opts.detached
+      })
+    });
+    if (!res.ok) {
+      throw new Error(`Failed to run command: ${await res.text()}`);
+    }
+    if (opts.detached) {
+      return { exitCode: 0 };
+    }
+    if (!res.body)
+      return { exitCode: 0 };
+    const reader = res.body.getReader();
+    const stdoutWriter = opts.stdout ? opts.stdout.getWriter() : null;
+    const stderrWriter = opts.stderr ? opts.stderr.getWriter() : null;
+    let buffer = new Uint8Array(0);
+    try {
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done)
+          break;
+        const newBuffer = new Uint8Array(buffer.length + value.length);
+        newBuffer.set(buffer);
+        newBuffer.set(value, buffer.length);
+        buffer = newBuffer;
+        while (buffer.length >= 8) {
+          const type = buffer[0];
+          const b4 = buffer[4];
+          const b5 = buffer[5];
+          const b6 = buffer[6];
+          const b7 = buffer[7];
+          const size = b4 << 24 | b5 << 16 | b6 << 8 | b7;
+          if (buffer.length < 8 + size) {
+            break;
+          }
+          const payload = buffer.slice(8, 8 + size);
+          buffer = buffer.slice(8 + size);
+          if (type === 1 && stdoutWriter) {
+            await stdoutWriter.write(payload);
+          } else if (type === 2 && stderrWriter) {
+            await stderrWriter.write(payload);
+          } else {
+            if (stdoutWriter)
+              await stdoutWriter.write(payload);
+          }
+        }
+      }
+    } finally {
+      if (stdoutWriter)
+        stdoutWriter.releaseLock();
+      if (stderrWriter)
+        stderrWriter.releaseLock();
+    }
+    return { exitCode: 0 };
+  }
+  async getInfo() {
+    const res = await fetch(`${this.serverUrl}/sandbox/${this.id}`);
+    if (!res.ok) {
+      throw new Error(`Failed to get sandbox info: ${await res.text()}`);
+    }
+    return res.json();
+  }
+  async destroy() {
+    const res = await fetch(`${this.serverUrl}/sandbox/${this.id}`, {
+      method: "DELETE"
+    });
+    if (!res.ok) {
+      throw new Error(`Failed to destroy sandbox: ${await res.text()}`);
+    }
+  }
+  domain(port) {
+    const mapped = this.ports[port];
+    if (!mapped)
+      throw new Error(`Port ${port} not exposed`);
+    return `http://localhost:${mapped}`;
+  }
+}
+function createLogStream(stream) {
+  return new WritableStream({
+    write(chunk) {
+      stream.write(chunk);
+    }
+  });
+}
+export {
+  createLogStream,
+  Sandbox
+};
+
+export { Sandbox, createLogStream };

package/dist/server/index.d.ts

@@ -0,0 +1,18 @@
+export interface ServerOptions {
+    port?: number;
+}
+export interface SandboxCreateRequest {
+    source?: {
+        url: string;
+        type: "git";
+    };
+    ports?: number[];
+    runtime?: string;
+}
+export interface ExecRequest {
+    cmd: string;
+    args?: string[];
+    detached?: boolean;
+}
+export declare function startServer(options?: ServerOptions): Bun.Server<undefined>;
+//# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE;QACP,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,KAAK,CAAC;KACb,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AASD,wBAAgB,WAAW,CAAC,OAAO,GAAE,aAAkB,yBAoOtD"}