@opencoredev/sandbox-sdk 0.1.1 → 1.0.0-beta.0

package/dist/testing/index.d.mts

@@ -1,27 +0,0 @@
-import "../types-DEi_dfRR.mjs";
-import { o as SandboxProvider } from "../provider-BzzkIVmv.mjs";
-import { t as CreateSandboxOptions } from "../sandbox-Dco6z9aB.mjs";
-
-//#region src/testing/conformance.d.ts
-declare const conformanceCases: readonly ["create and stop", "idempotent stop", "text files", "binary files", "directories", "relative paths", "invalid paths", "successful command", "stdout", "stderr", "nonzero exit", "timeout", "background process", "stdin", "ports", "snapshot create", "snapshot delete", "snapshot restore", "cleanup after failure"];
-interface ConformanceSubject<TProvider extends SandboxProvider<unknown>> {
-  create: CreateSandboxOptions<TProvider>;
-  commands: {
-    success: string;
-    stdout: string;
-    stderr: string;
-    nonzero: string;
-    timeout: string;
-    background: string;
-    stdin: string;
-  };
-}
-interface ConformanceResult {
-  name: (typeof conformanceCases)[number];
-  status: "passed" | "failed" | "skipped";
-  error?: unknown;
-}
-declare function runConformance<TProvider extends SandboxProvider<unknown>>(subject: ConformanceSubject<TProvider>): Promise<ConformanceResult[]>;
-//#endregion
-export { type ConformanceResult, type ConformanceSubject, conformanceCases, runConformance };
-//# sourceMappingURL=index.d.mts.map

package/dist/testing/index.mjs

@@ -1,173 +0,0 @@
-import "../errors-Ch9PHKTd.mjs";
-import { i as supports } from "../capabilities-COKpwoFH.mjs";
-import { t as createSandbox } from "../sandbox-rIOcbhtM.mjs";
-
-//#region src/testing/conformance.ts
-const conformanceCases = [
-	"create and stop",
-	"idempotent stop",
-	"text files",
-	"binary files",
-	"directories",
-	"relative paths",
-	"invalid paths",
-	"successful command",
-	"stdout",
-	"stderr",
-	"nonzero exit",
-	"timeout",
-	"background process",
-	"stdin",
-	"ports",
-	"snapshot create",
-	"snapshot delete",
-	"snapshot restore",
-	"cleanup after failure"
-];
-async function runConformance(subject) {
-	const results = [];
-	const check = async (name, test) => {
-		try {
-			await test();
-			results.push({
-				name,
-				status: "passed"
-			});
-		} catch (error) {
-			results.push({
-				name,
-				status: "failed",
-				error
-			});
-		}
-	};
-	await check("create and stop", async () => {
-		await (await createSandbox(subject.create)).stop();
-	});
-	await check("idempotent stop", async () => {
-		const sandbox$1 = await createSandbox(subject.create);
-		await sandbox$1.stop();
-		await sandbox$1.stop();
-	});
-	const sandbox = await createSandbox(subject.create);
-	try {
-		await check("text files", async () => {
-			await sandbox.files.write("text.txt", "hello");
-			if (await sandbox.files.text("text.txt") !== "hello") throw new Error("text mismatch");
-		});
-		await check("binary files", async () => {
-			const expected = new Uint8Array([
-				0,
-				1,
-				2,
-				255
-			]);
-			await sandbox.files.write("binary.bin", expected);
-			if (!(await sandbox.files.read("binary.bin")).every((value, index) => value === expected[index])) throw new Error("binary mismatch");
-		});
-		await check("directories", async () => {
-			await sandbox.files.mkdir("nested");
-			await sandbox.files.write("nested/item.txt", "item");
-			if (!(await sandbox.files.list("nested")).some((entry) => entry.name === "item.txt")) throw new Error("list mismatch");
-			await sandbox.files.remove("nested");
-		});
-		await check("relative paths", async () => {
-			await sandbox.files.write("relative.txt", "yes");
-			if (!await sandbox.files.exists("relative.txt")) throw new Error("relative path not resolved");
-		});
-		await check("invalid paths", async () => {
-			try {
-				await sandbox.files.read("../escape");
-			} catch {
-				return;
-			}
-			throw new Error("path traversal accepted");
-		});
-		await check("successful command", async () => {
-			if (!(await sandbox.run(subject.commands.success)).success) throw new Error("command failed");
-		});
-		await check("stdout", async () => {
-			if (!(await sandbox.run(subject.commands.stdout)).stdout.includes("stdout")) throw new Error("stdout missing");
-		});
-		await check("stderr", async () => {
-			const result = await sandbox.run(subject.commands.stderr);
-			if (!(sandbox.capabilities["process.run"] === "combined-stream" ? `${result.stdout}${result.stderr}` : result.stderr).includes("stderr")) throw new Error("stderr missing");
-		});
-		await check("nonzero exit", async () => {
-			if ((await sandbox.run(subject.commands.nonzero)).exitCode === 0) throw new Error("expected nonzero exit");
-		});
-		await check("timeout", async () => {
-			try {
-				await sandbox.run(subject.commands.timeout, { timeout: 20 });
-			} catch {
-				return;
-			}
-			throw new Error("timeout not enforced");
-		});
-		if (supports(sandbox, "process.background")) await check("background process", async () => {
-			await (await sandbox.processes.start(subject.commands.background)).kill();
-		});
-		else results.push({
-			name: "background process",
-			status: "skipped"
-		});
-		if (supports(sandbox, "process.stdin")) await check("stdin", async () => {
-			const process = await sandbox.processes.start(subject.commands.stdin);
-			await process.write("received\n");
-			for await (const event of process.output()) if ((typeof event.data === "string" ? event.data : new TextDecoder().decode(event.data)).includes("received")) return;
-			throw new Error("stdin output missing");
-		});
-		else results.push({
-			name: "stdin",
-			status: "skipped"
-		});
-		if (supports(sandbox, "ports.expose")) await check("ports", async () => {
-			const port = await sandbox.ports.expose(3e3);
-			if (port.port !== 3e3 || !port.url) throw new Error("invalid exposed port");
-		});
-		else results.push({
-			name: "ports",
-			status: "skipped"
-		});
-		let createdSnapshot;
-		if (supports(sandbox, "snapshot.create")) await check("snapshot create", async () => {
-			await sandbox.files.write("snapshot.txt", "before");
-			createdSnapshot = await sandbox.snapshots.create({ name: "conformance" });
-		});
-		else results.push({
-			name: "snapshot create",
-			status: "skipped"
-		});
-		if (createdSnapshot && supports(sandbox, "snapshot.restore")) await check("snapshot restore", async () => {
-			await sandbox.files.write("snapshot.txt", "after");
-			await sandbox.snapshots.restore(createdSnapshot);
-			if (await sandbox.files.text("snapshot.txt") !== "before") throw new Error("snapshot not restored");
-		});
-		else results.push({
-			name: "snapshot restore",
-			status: "skipped"
-		});
-		if (createdSnapshot && supports(sandbox, "snapshot.delete")) await check("snapshot delete", async () => {
-			await sandbox.snapshots.delete(createdSnapshot);
-		});
-		else results.push({
-			name: "snapshot delete",
-			status: "skipped"
-		});
-	} finally {
-		await sandbox.stop();
-	}
-	await check("cleanup after failure", async () => {
-		const temporary = await createSandbox(subject.create);
-		try {
-			throw new Error("expected");
-		} catch {} finally {
-			await temporary.stop();
-		}
-	});
-	return results;
-}
-
-//#endregion
-export { conformanceCases, runConformance };
-//# sourceMappingURL=index.mjs.map

package/dist/testing/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.mjs","names":["results: ConformanceResult[]","sandbox","createdSnapshot: Awaited<ReturnType<typeof sandbox.snapshots.create>> | undefined"],"sources":["../../src/testing/conformance.ts"],"sourcesContent":["import { createSandbox, type CreateSandboxOptions } from \"../core/sandbox\";\nimport { supports } from \"../core/capabilities\";\nimport type { SandboxProvider } from \"../core/provider\";\n\nexport const conformanceCases = [\n  \"create and stop\",\n  \"idempotent stop\",\n  \"text files\",\n  \"binary files\",\n  \"directories\",\n  \"relative paths\",\n  \"invalid paths\",\n  \"successful command\",\n  \"stdout\",\n  \"stderr\",\n  \"nonzero exit\",\n  \"timeout\",\n  \"background process\",\n  \"stdin\",\n  \"ports\",\n  \"snapshot create\",\n  \"snapshot delete\",\n  \"snapshot restore\",\n  \"cleanup after failure\",\n] as const;\n\nexport interface ConformanceSubject<TProvider extends SandboxProvider<unknown>> {\n  create: CreateSandboxOptions<TProvider>;\n  commands: {\n    success: string;\n    stdout: string;\n    stderr: string;\n    nonzero: string;\n    timeout: string;\n    background: string;\n    stdin: string;\n  };\n}\n\nexport interface ConformanceResult {\n  name: (typeof conformanceCases)[number];\n  status: \"passed\" | \"failed\" | \"skipped\";\n  error?: unknown;\n}\n\nexport async function runConformance<TProvider extends SandboxProvider<unknown>>(\n  subject: ConformanceSubject<TProvider>,\n): Promise<ConformanceResult[]> {\n  const results: ConformanceResult[] = [];\n  const check = async (name: ConformanceResult[\"name\"], test: () => Promise<void>) => {\n    try {\n      await test();\n      results.push({ name, status: \"passed\" });\n    } catch (error) {\n      results.push({ name, status: \"failed\", error });\n    }\n  };\n  await check(\"create and stop\", async () => {\n    const sandbox = await createSandbox(subject.create);\n    await sandbox.stop();\n  });\n  await check(\"idempotent stop\", async () => {\n    const sandbox = await createSandbox(subject.create);\n    await sandbox.stop();\n    await sandbox.stop();\n  });\n  const sandbox = await createSandbox(subject.create);\n  try {\n    await check(\"text files\", async () => {\n      await sandbox.files.write(\"text.txt\", \"hello\");\n      if ((await sandbox.files.text(\"text.txt\")) !== \"hello\") throw new Error(\"text mismatch\");\n    });\n    await check(\"binary files\", async () => {\n      const expected = new Uint8Array([0, 1, 2, 255]);\n      await sandbox.files.write(\"binary.bin\", expected);\n      const actual = await sandbox.files.read(\"binary.bin\");\n      if (!actual.every((value, index) => value === expected[index]))\n        throw new Error(\"binary mismatch\");\n    });\n    await check(\"directories\", async () => {\n      await sandbox.files.mkdir(\"nested\");\n      await sandbox.files.write(\"nested/item.txt\", \"item\");\n      if (!(await sandbox.files.list(\"nested\")).some((entry) => entry.name === \"item.txt\"))\n        throw new Error(\"list mismatch\");\n      await sandbox.files.remove(\"nested\");\n    });\n    await check(\"relative paths\", async () => {\n      await sandbox.files.write(\"relative.txt\", \"yes\");\n      if (!(await sandbox.files.exists(\"relative.txt\")))\n        throw new Error(\"relative path not resolved\");\n    });\n    await check(\"invalid paths\", async () => {\n      try {\n        await sandbox.files.read(\"../escape\");\n      } catch {\n        return;\n      }\n      throw new Error(\"path traversal accepted\");\n    });\n    await check(\"successful command\", async () => {\n      if (!(await sandbox.run(subject.commands.success)).success) throw new Error(\"command failed\");\n    });\n    await check(\"stdout\", async () => {\n      if (!(await sandbox.run(subject.commands.stdout)).stdout.includes(\"stdout\"))\n        throw new Error(\"stdout missing\");\n    });\n    await check(\"stderr\", async () => {\n      const result = await sandbox.run(subject.commands.stderr);\n      const output =\n        sandbox.capabilities[\"process.run\"] === \"combined-stream\"\n          ? `${result.stdout}${result.stderr}`\n          : result.stderr;\n      if (!output.includes(\"stderr\")) throw new Error(\"stderr missing\");\n    });\n    await check(\"nonzero exit\", async () => {\n      if ((await sandbox.run(subject.commands.nonzero)).exitCode === 0)\n        throw new Error(\"expected nonzero exit\");\n    });\n    await check(\"timeout\", async () => {\n      try {\n        await sandbox.run(subject.commands.timeout, { timeout: 20 });\n      } catch {\n        return;\n      }\n      throw new Error(\"timeout not enforced\");\n    });\n    if (supports(sandbox, \"process.background\"))\n      await check(\"background process\", async () => {\n        const process = await sandbox.processes.start(subject.commands.background);\n        await process.kill();\n      });\n    else results.push({ name: \"background process\", status: \"skipped\" });\n    if (supports(sandbox, \"process.stdin\"))\n      await check(\"stdin\", async () => {\n        const process = await sandbox.processes.start(subject.commands.stdin);\n        await process.write(\"received\\n\");\n        for await (const event of process.output()) {\n          const data =\n            typeof event.data === \"string\" ? event.data : new TextDecoder().decode(event.data);\n          if (data.includes(\"received\")) return;\n        }\n        throw new Error(\"stdin output missing\");\n      });\n    else results.push({ name: \"stdin\", status: \"skipped\" });\n    if (supports(sandbox, \"ports.expose\"))\n      await check(\"ports\", async () => {\n        const port = await sandbox.ports.expose(30_00);\n        if (port.port !== 3000 || !port.url) throw new Error(\"invalid exposed port\");\n      });\n    else results.push({ name: \"ports\", status: \"skipped\" });\n    let createdSnapshot: Awaited<ReturnType<typeof sandbox.snapshots.create>> | undefined;\n    if (supports(sandbox, \"snapshot.create\"))\n      await check(\"snapshot create\", async () => {\n        await sandbox.files.write(\"snapshot.txt\", \"before\");\n        createdSnapshot = await sandbox.snapshots.create({ name: \"conformance\" });\n      });\n    else results.push({ name: \"snapshot create\", status: \"skipped\" });\n    if (createdSnapshot && supports(sandbox, \"snapshot.restore\"))\n      await check(\"snapshot restore\", async () => {\n        await sandbox.files.write(\"snapshot.txt\", \"after\");\n        await sandbox.snapshots.restore(createdSnapshot!);\n        if ((await sandbox.files.text(\"snapshot.txt\")) !== \"before\")\n          throw new Error(\"snapshot not restored\");\n      });\n    else results.push({ name: \"snapshot restore\", status: \"skipped\" });\n    if (createdSnapshot && supports(sandbox, \"snapshot.delete\"))\n      await check(\"snapshot delete\", async () => {\n        await sandbox.snapshots.delete(createdSnapshot!);\n      });\n    else results.push({ name: \"snapshot delete\", status: \"skipped\" });\n  } finally {\n    await sandbox.stop();\n  }\n  await check(\"cleanup after failure\", async () => {\n    const temporary = await createSandbox(subject.create);\n    try {\n      throw new Error(\"expected\");\n    } catch {\n      /* expected */\n    } finally {\n      await temporary.stop();\n    }\n  });\n  return results;\n}\n"],"mappings":"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"}

package/dist/types-DEi_dfRR.d.mts

@@ -1,103 +0,0 @@
-//#region src/core/types.d.ts
-declare const providerNames: readonly ["local", "e2b", "daytona", "vercel", "upstash"];
-type ProviderName = (typeof providerNames)[number];
-declare const capabilityNames: readonly ["files.read", "files.write", "files.list", "files.remove", "process.run", "process.stream", "process.background", "process.stdin", "process.cancel", "ports.expose", "ports.authenticatedRequest", "snapshot.create", "snapshot.delete", "snapshot.restore", "sandbox.resume", "filesystem.persistent", "image.custom", "network.policy", "process.pty", "compute.gpu"];
-type Capability = (typeof capabilityNames)[number];
-type CapabilityMode = "filesystem" | "memory" | "template" | "fork" | "public" | "authenticated" | "combined-stream" | "separate-streams" | "ephemeral" | "persistent" | "localhost" | "in-process" | "full" | "native";
-type CapabilityMap = Readonly<Record<Capability, false | CapabilityMode>>;
-type CommandInput = string | {
-  command: string;
-  args?: readonly string[];
-};
-interface RunOptions {
-  cwd?: string;
-  env?: Readonly<Record<string, string>>;
-  timeout?: number;
-  signal?: AbortSignal;
-}
-interface CommandResult {
-  stdout: string;
-  stderr: string;
-  exitCode: number;
-  success: boolean;
-  signal?: string;
-  durationMs?: number;
-}
-type FileValue = string | Uint8Array | ArrayBuffer | Blob | ReadableStream<Uint8Array>;
-interface SandboxDirectoryEntry {
-  name: string;
-  path: string;
-  type: "file" | "directory" | "symlink" | "unknown";
-  size?: number;
-}
-interface SandboxFiles {
-  write(path: string, value: FileValue): Promise<void>;
-  read(path: string): Promise<Uint8Array>;
-  text(path: string): Promise<string>;
-  list(path?: string): Promise<SandboxDirectoryEntry[]>;
-  mkdir(path: string): Promise<void>;
-  remove(path: string): Promise<void>;
-  exists(path: string): Promise<boolean>;
-}
-interface ProcessOutputEvent {
-  stream: "stdout" | "stderr";
-  data: string | Uint8Array;
-  timestamp?: Date;
-}
-type ProcessStatus = "starting" | "running" | "exited" | "killed" | "unknown";
-interface SandboxProcess {
-  readonly id: string;
-  status(): Promise<ProcessStatus>;
-  output(): AsyncIterable<ProcessOutputEvent>;
-  write(value: string | Uint8Array): Promise<void>;
-  wait(): Promise<{
-    exitCode: number;
-  }>;
-  kill(signal?: string): Promise<void>;
-}
-interface SandboxProcesses {
-  start(command: CommandInput, options?: RunOptions): Promise<SandboxProcess>;
-}
-interface ExposedPort {
-  readonly port: number;
-  readonly url: string;
-  readonly public: boolean;
-  readonly authenticated: boolean;
-  request?(path?: string, init?: RequestInit): Promise<Response>;
-  toJSON(): Omit<ExposedPort, "request" | "toJSON">;
-}
-interface SandboxPorts {
-  expose(port: number): Promise<ExposedPort>;
-}
-interface SandboxSnapshot {
-  readonly id: string;
-  readonly name?: string;
-  readonly mode: CapabilityMode;
-  readonly createdAt?: Date;
-}
-interface SandboxSnapshots {
-  create(options?: {
-    name?: string;
-  }): Promise<SandboxSnapshot>;
-  delete(snapshot: SandboxSnapshot | string): Promise<void>;
-  restore(snapshot: SandboxSnapshot | string): Promise<void>;
-}
-interface Sandbox<TRaw = unknown> {
-  readonly id: string;
-  readonly provider: ProviderName;
-  readonly cwd: string;
-  readonly capabilities: CapabilityMap;
-  readonly raw: TRaw;
-  readonly files: SandboxFiles;
-  readonly processes: SandboxProcesses;
-  readonly ports: SandboxPorts;
-  readonly snapshots: SandboxSnapshots;
-  run(command: CommandInput, options?: RunOptions): Promise<CommandResult>;
-  /** Stops the provider runtime. Repeated calls share the same cleanup operation. */
-  stop(): Promise<void>;
-  /** Stops the sandbox when an `await using` scope exits. */
-  [Symbol.asyncDispose](): Promise<void>;
-}
-//#endregion
-export { SandboxProcesses as _, CommandResult as a, capabilityNames as b, ProcessOutputEvent as c, RunOptions as d, Sandbox as f, SandboxProcess as g, SandboxPorts as h, CommandInput as i, ProcessStatus as l, SandboxFiles as m, CapabilityMap as n, ExposedPort as o, SandboxDirectoryEntry as p, CapabilityMode as r, FileValue as s, Capability as t, ProviderName as u, SandboxSnapshot as v, providerNames as x, SandboxSnapshots as y };
-//# sourceMappingURL=types-DEi_dfRR.d.mts.map