@anvia/sandbox 0.4.1 → 0.5.0

package/dist/chunk-FTNNCT6S.js

@@ -0,0 +1,151 @@
+// src/errors.ts
+var SandboxError = class extends Error {
+  constructor(message, cause) {
+    super(message);
+    this.cause = cause;
+    this.name = new.target.name;
+  }
+  cause;
+};
+var SandboxDockerUnavailableError = class extends SandboxError {
+};
+var SandboxDockerCommandError = class extends SandboxError {
+  constructor(message, result) {
+    super(message);
+    this.result = result;
+  }
+  result;
+};
+var SandboxSessionDestroyedError = class extends SandboxError {
+};
+var SandboxPathError = class extends SandboxError {
+};
+var SandboxTimeoutError = class extends SandboxError {
+};
+var SandboxFileSizeError = class extends SandboxError {
+};
+var SandboxToolPolicyError = class extends SandboxError {
+};
+var SandboxPortError = class extends SandboxError {
+};
+var SandboxProcessError = class extends SandboxError {
+};
+
+// src/docker-cli.ts
+import { spawn } from "child_process";
+var defaultMaxOutputBytes = 1024 * 1024;
+async function runDockerCli(args, options) {
+  const startedAt = Date.now();
+  const maxOutputBytes = options.maxOutputBytes ?? defaultMaxOutputBytes;
+  const stdout = createOutputCollector(maxOutputBytes, options.onStdout);
+  const stderr = createOutputCollector(maxOutputBytes, options.onStderr);
+  return new Promise((resolve, reject) => {
+    const child = spawn(options.dockerPath, args, {
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    let timedOut = false;
+    let aborted = false;
+    let settled = false;
+    const timeout = options.timeoutMs === void 0 ? void 0 : setTimeout(() => {
+      timedOut = true;
+      child.kill("SIGKILL");
+    }, options.timeoutMs);
+    const abort = () => {
+      aborted = true;
+      child.kill("SIGKILL");
+    };
+    if (options.signal?.aborted === true) {
+      abort();
+    } else {
+      options.signal?.addEventListener("abort", abort, { once: true });
+    }
+    child.stdout.on("data", (chunk) => stdout.accept(chunk));
+    child.stderr.on("data", (chunk) => stderr.accept(chunk));
+    child.on("error", (error) => {
+      if (settled) {
+        return;
+      }
+      settled = true;
+      clearTimeout(timeout);
+      options.signal?.removeEventListener("abort", abort);
+      if (error.code === "ENOENT") {
+        reject(new SandboxDockerUnavailableError("Docker CLI was not found.", error));
+        return;
+      }
+      reject(error);
+    });
+    child.on("close", (code) => {
+      if (settled) {
+        return;
+      }
+      settled = true;
+      clearTimeout(timeout);
+      options.signal?.removeEventListener("abort", abort);
+      resolve({
+        stdout: stdout.text(),
+        stderr: stderr.text(),
+        exitCode: code ?? 1,
+        durationMs: Date.now() - startedAt,
+        timedOut,
+        aborted,
+        stdoutTruncated: stdout.truncated,
+        stderrTruncated: stderr.truncated
+      });
+    });
+    if (options.input !== void 0) {
+      child.stdin.end(options.input);
+    } else {
+      child.stdin.end();
+    }
+  });
+}
+async function assertDockerCli(args, options) {
+  const result = await runDockerCli(args, options);
+  if (result.exitCode !== 0) {
+    throw new SandboxDockerCommandError(`Docker command failed: docker ${args.join(" ")}`, result);
+  }
+  return result.stdout.trim();
+}
+function createOutputCollector(maxBytes, onChunk) {
+  const chunks = [];
+  let length = 0;
+  let truncated = false;
+  return {
+    get truncated() {
+      return truncated;
+    },
+    accept(chunk) {
+      onChunk?.(chunk);
+      if (length >= maxBytes) {
+        truncated = true;
+        return;
+      }
+      const remaining = maxBytes - length;
+      const next = chunk.length > remaining ? chunk.subarray(0, remaining) : chunk;
+      chunks.push(next);
+      length += next.length;
+      if (next.length < chunk.length) {
+        truncated = true;
+      }
+    },
+    text() {
+      return Buffer.concat(chunks, length).toString("utf8");
+    }
+  };
+}
+
+export {
+  SandboxError,
+  SandboxDockerUnavailableError,
+  SandboxDockerCommandError,
+  SandboxSessionDestroyedError,
+  SandboxPathError,
+  SandboxTimeoutError,
+  SandboxFileSizeError,
+  SandboxToolPolicyError,
+  SandboxPortError,
+  SandboxProcessError,
+  runDockerCli,
+  assertDockerCli
+};
+//# sourceMappingURL=chunk-FTNNCT6S.js.map

package/dist/chunk-FTNNCT6S.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/docker-cli.ts"],"sourcesContent":["export class SandboxError extends Error {\n  constructor(\n    message: string,\n    readonly cause?: unknown,\n  ) {\n    super(message);\n    this.name = new.target.name;\n  }\n}\n\nexport class SandboxDockerUnavailableError extends SandboxError {}\n\nexport class SandboxDockerCommandError extends SandboxError {\n  constructor(\n    message: string,\n    readonly result: {\n      stdout: string;\n      stderr: string;\n      exitCode: number;\n    },\n  ) {\n    super(message);\n  }\n}\n\nexport class SandboxSessionDestroyedError extends SandboxError {}\n\nexport class SandboxPathError extends SandboxError {}\n\nexport class SandboxTimeoutError extends SandboxError {}\n\nexport class SandboxFileSizeError extends SandboxError {}\n\nexport class SandboxToolPolicyError extends SandboxError {}\n\nexport class SandboxPortError extends SandboxError {}\n\nexport class SandboxProcessError extends SandboxError {}\n","import { spawn } from \"node:child_process\";\nimport { SandboxDockerCommandError, SandboxDockerUnavailableError } from \"./errors\";\n\nexport interface DockerCliResult {\n  stdout: string;\n  stderr: string;\n  exitCode: number;\n  durationMs: number;\n  timedOut: boolean;\n  aborted: boolean;\n  stdoutTruncated: boolean;\n  stderrTruncated: boolean;\n}\n\nexport interface DockerCliOptions {\n  dockerPath: string;\n  timeoutMs?: number;\n  maxOutputBytes?: number;\n  input?: string | Uint8Array;\n  signal?: AbortSignal;\n  onStdout?: (chunk: Uint8Array) => void;\n  onStderr?: (chunk: Uint8Array) => void;\n}\n\nconst defaultMaxOutputBytes = 1024 * 1024;\n\nexport async function runDockerCli(\n  args: string[],\n  options: DockerCliOptions,\n): Promise<DockerCliResult> {\n  const startedAt = Date.now();\n  const maxOutputBytes = options.maxOutputBytes ?? defaultMaxOutputBytes;\n  const stdout = createOutputCollector(maxOutputBytes, options.onStdout);\n  const stderr = createOutputCollector(maxOutputBytes, options.onStderr);\n\n  return new Promise((resolve, reject) => {\n    const child = spawn(options.dockerPath, args, {\n      stdio: [\"pipe\", \"pipe\", \"pipe\"],\n    });\n\n    let timedOut = false;\n    let aborted = false;\n    let settled = false;\n\n    const timeout =\n      options.timeoutMs === undefined\n        ? undefined\n        : setTimeout(() => {\n            timedOut = true;\n            child.kill(\"SIGKILL\");\n          }, options.timeoutMs);\n\n    const abort = () => {\n      aborted = true;\n      child.kill(\"SIGKILL\");\n    };\n\n    if (options.signal?.aborted === true) {\n      abort();\n    } else {\n      options.signal?.addEventListener(\"abort\", abort, { once: true });\n    }\n\n    child.stdout.on(\"data\", (chunk: Buffer) => stdout.accept(chunk));\n    child.stderr.on(\"data\", (chunk: Buffer) => stderr.accept(chunk));\n\n    child.on(\"error\", (error) => {\n      if (settled) {\n        return;\n      }\n      settled = true;\n      clearTimeout(timeout);\n      options.signal?.removeEventListener(\"abort\", abort);\n\n      if ((error as NodeJS.ErrnoException).code === \"ENOENT\") {\n        reject(new SandboxDockerUnavailableError(\"Docker CLI was not found.\", error));\n        return;\n      }\n\n      reject(error);\n    });\n\n    child.on(\"close\", (code) => {\n      if (settled) {\n        return;\n      }\n      settled = true;\n      clearTimeout(timeout);\n      options.signal?.removeEventListener(\"abort\", abort);\n\n      resolve({\n        stdout: stdout.text(),\n        stderr: stderr.text(),\n        exitCode: code ?? 1,\n        durationMs: Date.now() - startedAt,\n        timedOut,\n        aborted,\n        stdoutTruncated: stdout.truncated,\n        stderrTruncated: stderr.truncated,\n      });\n    });\n\n    if (options.input !== undefined) {\n      child.stdin.end(options.input);\n    } else {\n      child.stdin.end();\n    }\n  });\n}\n\nexport async function assertDockerCli(args: string[], options: DockerCliOptions): Promise<string> {\n  const result = await runDockerCli(args, options);\n\n  if (result.exitCode !== 0) {\n    throw new SandboxDockerCommandError(`Docker command failed: docker ${args.join(\" \")}`, result);\n  }\n\n  return result.stdout.trim();\n}\n\nfunction createOutputCollector(maxBytes: number, onChunk?: (chunk: Uint8Array) => void) {\n  const chunks: Buffer[] = [];\n  let length = 0;\n  let truncated = false;\n\n  return {\n    get truncated() {\n      return truncated;\n    },\n    accept(chunk: Buffer) {\n      onChunk?.(chunk);\n\n      if (length >= maxBytes) {\n        truncated = true;\n        return;\n      }\n\n      const remaining = maxBytes - length;\n      const next = chunk.length > remaining ? chunk.subarray(0, remaining) : chunk;\n      chunks.push(next);\n      length += next.length;\n\n      if (next.length < chunk.length) {\n        truncated = true;\n      }\n    },\n    text() {\n      return Buffer.concat(chunks, length).toString(\"utf8\");\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/cli.d.ts

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+type SandboxImageRuntime = "node" | "bun" | "python";
+type SandboxImageFeature = "artifacts" | "playwright";
+interface SandboxImageVersions {
+    node: string;
+    pnpm: string;
+    bun: string;
+    python: string;
+    uv: string;
+    playwright: string;
+}
+
+interface CliOptions {
+    command?: string;
+    name?: string;
+    tag?: string;
+    output?: string;
+    runtimes: SandboxImageRuntime[];
+    features: SandboxImageFeature[];
+    apt: string[];
+    npm: string[];
+    uv: string[];
+    versions: Partial<SandboxImageVersions>;
+    dockerPath: string;
+    build: boolean;
+    buildExplicit: boolean;
+    dryRun: boolean;
+    force: boolean;
+    help: boolean;
+}
+interface SandboxImageCliIo {
+    log(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    stdout(chunk: Uint8Array): void;
+    stderr(chunk: Uint8Array): void;
+}
+interface SandboxImagePromptResult {
+    name: string;
+    runtimes: SandboxImageRuntime[];
+    features: SandboxImageFeature[];
+    apt: string[];
+    npm: string[];
+    uv: string[];
+    tag?: string;
+    output?: string;
+    build: boolean;
+}
+interface SandboxImageCliDependencies {
+    isTTY?: boolean;
+    packageVersion?: string;
+    prompt?: (options: Readonly<CliOptions>) => Promise<SandboxImagePromptResult | undefined>;
+    buildImage?: (input: {
+        contextPath: string;
+        tag: string;
+        dockerPath: string;
+        io: SandboxImageCliIo;
+    }) => Promise<void>;
+}
+declare function runCli(argv?: string[], cwd?: string, io?: SandboxImageCliIo, dependencies?: SandboxImageCliDependencies): Promise<number>;
+
+export { type SandboxImageCliDependencies, type SandboxImageCliIo, type SandboxImagePromptResult, runCli };