@cloudflare/sandbox 0.0.9 → 0.1.0

package/dist/client-BuVjqV00.d.ts

@@ -1,247 +0,0 @@
-import { Container } from '@cloudflare/containers';
-
-declare function getSandbox(ns: DurableObjectNamespace<Sandbox>, id: string): DurableObjectStub<Sandbox<unknown>>;
-declare class Sandbox<Env = unknown> extends Container<Env> {
-    sleepAfter: string;
-    client: HttpClient;
-    private workerHostname;
-    private sandboxName;
-    constructor(ctx: DurableObjectState, env: Env);
-    setSandboxName(name: string): Promise<void>;
-    onStart(): void;
-    onStop(): void;
-    onError(error: unknown): void;
-    fetch(request: Request): Promise<Response>;
-    private determinePort;
-    exec(command: string, args: string[], options?: {
-        stream?: boolean;
-        background?: boolean;
-    }): Promise<void | ExecuteResponse>;
-    gitCheckout(repoUrl: string, options: {
-        branch?: string;
-        targetDir?: string;
-        stream?: boolean;
-    }): Promise<void | GitCheckoutResponse>;
-    mkdir(path: string, options?: {
-        recursive?: boolean;
-        stream?: boolean;
-    }): Promise<void | MkdirResponse>;
-    writeFile(path: string, content: string, options?: {
-        encoding?: string;
-        stream?: boolean;
-    }): Promise<void | WriteFileResponse>;
-    deleteFile(path: string, options?: {
-        stream?: boolean;
-    }): Promise<void | DeleteFileResponse>;
-    renameFile(oldPath: string, newPath: string, options?: {
-        stream?: boolean;
-    }): Promise<void | RenameFileResponse>;
-    moveFile(sourcePath: string, destinationPath: string, options?: {
-        stream?: boolean;
-    }): Promise<void | MoveFileResponse>;
-    readFile(path: string, options?: {
-        encoding?: string;
-        stream?: boolean;
-    }): Promise<void | ReadFileResponse>;
-    exposePort(port: number, options?: {
-        name?: string;
-    }): Promise<{
-        url: string;
-        port: number;
-        name: string | undefined;
-    }>;
-    unexposePort(port: number): Promise<void>;
-    getExposedPorts(): Promise<{
-        url: string;
-        port: number;
-        name: string | undefined;
-        exposedAt: string;
-    }[]>;
-    private getHostname;
-    private constructPreviewUrl;
-}
-
-interface ExecuteResponse {
-    success: boolean;
-    stdout: string;
-    stderr: string;
-    exitCode: number;
-    command: string;
-    args: string[];
-    timestamp: string;
-}
-interface SessionListResponse {
-    sessions: Array<{
-        sessionId: string;
-        hasActiveProcess: boolean;
-        createdAt: string;
-    }>;
-    count: number;
-    timestamp: string;
-}
-interface GitCheckoutResponse {
-    success: boolean;
-    stdout: string;
-    stderr: string;
-    exitCode: number;
-    repoUrl: string;
-    branch: string;
-    targetDir: string;
-    timestamp: string;
-}
-interface MkdirResponse {
-    success: boolean;
-    stdout: string;
-    stderr: string;
-    exitCode: number;
-    path: string;
-    recursive: boolean;
-    timestamp: string;
-}
-interface WriteFileResponse {
-    success: boolean;
-    exitCode: number;
-    path: string;
-    timestamp: string;
-}
-interface ReadFileResponse {
-    success: boolean;
-    exitCode: number;
-    path: string;
-    content: string;
-    timestamp: string;
-}
-interface DeleteFileResponse {
-    success: boolean;
-    exitCode: number;
-    path: string;
-    timestamp: string;
-}
-interface RenameFileResponse {
-    success: boolean;
-    exitCode: number;
-    oldPath: string;
-    newPath: string;
-    timestamp: string;
-}
-interface MoveFileResponse {
-    success: boolean;
-    exitCode: number;
-    sourcePath: string;
-    destinationPath: string;
-    timestamp: string;
-}
-interface PreviewInfo {
-    url: string;
-    port: number;
-    name?: string;
-}
-interface ExposedPort extends PreviewInfo {
-    exposedAt: string;
-    timestamp: string;
-}
-interface ExposePortResponse {
-    success: boolean;
-    port: number;
-    name?: string;
-    exposedAt: string;
-    timestamp: string;
-}
-interface UnexposePortResponse {
-    success: boolean;
-    port: number;
-    timestamp: string;
-}
-interface GetExposedPortsResponse {
-    ports: ExposedPort[];
-    count: number;
-    timestamp: string;
-}
-interface StreamEvent {
-    type: "command_start" | "output" | "command_complete" | "error";
-    command?: string;
-    args?: string[];
-    stream?: "stdout" | "stderr";
-    data?: string;
-    message?: string;
-    path?: string;
-    oldPath?: string;
-    newPath?: string;
-    sourcePath?: string;
-    destinationPath?: string;
-    content?: string;
-    success?: boolean;
-    exitCode?: number;
-    stdout?: string;
-    stderr?: string;
-    error?: string;
-    timestamp?: string;
-}
-interface HttpClientOptions {
-    stub?: Sandbox;
-    baseUrl?: string;
-    port?: number;
-    onCommandStart?: (command: string, args: string[]) => void;
-    onOutput?: (stream: "stdout" | "stderr", data: string, command: string) => void;
-    onCommandComplete?: (success: boolean, exitCode: number, stdout: string, stderr: string, command: string, args: string[]) => void;
-    onError?: (error: string, command?: string, args?: string[]) => void;
-    onStreamEvent?: (event: StreamEvent) => void;
-}
-declare class HttpClient {
-    private baseUrl;
-    private options;
-    private sessionId;
-    constructor(options?: HttpClientOptions);
-    private doFetch;
-    setOnOutput(handler: (stream: "stdout" | "stderr", data: string, command: string) => void): void;
-    setOnCommandComplete(handler: (success: boolean, exitCode: number, stdout: string, stderr: string, command: string, args: string[]) => void): void;
-    setOnStreamEvent(handler: (event: StreamEvent) => void): void;
-    getOnOutput(): ((stream: "stdout" | "stderr", data: string, command: string) => void) | undefined;
-    getOnCommandComplete(): ((success: boolean, exitCode: number, stdout: string, stderr: string, command: string, args: string[]) => void) | undefined;
-    getOnStreamEvent(): ((event: StreamEvent) => void) | undefined;
-    createSession(): Promise<string>;
-    listSessions(): Promise<SessionListResponse>;
-    execute(command: string, args?: string[], sessionId?: string, background?: boolean): Promise<ExecuteResponse>;
-    executeStream(command: string, args?: string[], sessionId?: string, background?: boolean): Promise<void>;
-    gitCheckout(repoUrl: string, branch?: string, targetDir?: string, sessionId?: string): Promise<GitCheckoutResponse>;
-    gitCheckoutStream(repoUrl: string, branch?: string, targetDir?: string, sessionId?: string): Promise<void>;
-    mkdir(path: string, recursive?: boolean, sessionId?: string): Promise<MkdirResponse>;
-    mkdirStream(path: string, recursive?: boolean, sessionId?: string): Promise<void>;
-    writeFile(path: string, content: string, encoding?: string, sessionId?: string): Promise<WriteFileResponse>;
-    writeFileStream(path: string, content: string, encoding?: string, sessionId?: string): Promise<void>;
-    readFile(path: string, encoding?: string, sessionId?: string): Promise<ReadFileResponse>;
-    readFileStream(path: string, encoding?: string, sessionId?: string): Promise<void>;
-    deleteFile(path: string, sessionId?: string): Promise<DeleteFileResponse>;
-    deleteFileStream(path: string, sessionId?: string): Promise<void>;
-    renameFile(oldPath: string, newPath: string, sessionId?: string): Promise<RenameFileResponse>;
-    renameFileStream(oldPath: string, newPath: string, sessionId?: string): Promise<void>;
-    moveFile(sourcePath: string, destinationPath: string, sessionId?: string): Promise<MoveFileResponse>;
-    moveFileStream(sourcePath: string, destinationPath: string, sessionId?: string): Promise<void>;
-    exposePort(port: number, name?: string): Promise<ExposePortResponse>;
-    unexposePort(port: number): Promise<UnexposePortResponse>;
-    getExposedPorts(): Promise<GetExposedPortsResponse>;
-    ping(): Promise<string>;
-    getCommands(): Promise<string[]>;
-    getSessionId(): string | null;
-    setSessionId(sessionId: string): void;
-    clearSession(): void;
-}
-declare function createClient(options?: HttpClientOptions): HttpClient;
-declare function quickExecute(command: string, args?: string[], options?: HttpClientOptions): Promise<ExecuteResponse>;
-declare function quickExecuteStream(command: string, args?: string[], options?: HttpClientOptions): Promise<void>;
-declare function quickGitCheckout(repoUrl: string, branch?: string, targetDir?: string, options?: HttpClientOptions): Promise<GitCheckoutResponse>;
-declare function quickMkdir(path: string, recursive?: boolean, options?: HttpClientOptions): Promise<MkdirResponse>;
-declare function quickGitCheckoutStream(repoUrl: string, branch?: string, targetDir?: string, options?: HttpClientOptions): Promise<void>;
-declare function quickMkdirStream(path: string, recursive?: boolean, options?: HttpClientOptions): Promise<void>;
-declare function quickWriteFile(path: string, content: string, encoding?: string, options?: HttpClientOptions): Promise<WriteFileResponse>;
-declare function quickWriteFileStream(path: string, content: string, encoding?: string, options?: HttpClientOptions): Promise<void>;
-declare function quickReadFile(path: string, encoding?: string, options?: HttpClientOptions): Promise<ReadFileResponse>;
-declare function quickReadFileStream(path: string, encoding?: string, options?: HttpClientOptions): Promise<void>;
-declare function quickDeleteFile(path: string, options?: HttpClientOptions): Promise<DeleteFileResponse>;
-declare function quickDeleteFileStream(path: string, options?: HttpClientOptions): Promise<void>;
-declare function quickRenameFile(oldPath: string, newPath: string, options?: HttpClientOptions): Promise<RenameFileResponse>;
-declare function quickRenameFileStream(oldPath: string, newPath: string, options?: HttpClientOptions): Promise<void>;
-declare function quickMoveFile(sourcePath: string, destinationPath: string, options?: HttpClientOptions): Promise<MoveFileResponse>;
-declare function quickMoveFileStream(sourcePath: string, destinationPath: string, options?: HttpClientOptions): Promise<void>;
-
-export { type DeleteFileResponse as D, type ExecuteResponse as E, type GitCheckoutResponse as G, HttpClient as H, type MkdirResponse as M, type ReadFileResponse as R, Sandbox as S, type WriteFileResponse as W, type MoveFileResponse as a, type RenameFileResponse as b, createClient as c, quickExecuteStream as d, quickGitCheckout as e, quickMkdir as f, getSandbox as g, quickGitCheckoutStream as h, quickMkdirStream as i, quickWriteFile as j, quickWriteFileStream as k, quickReadFile as l, quickReadFileStream as m, quickDeleteFile as n, quickDeleteFileStream as o, quickRenameFile as p, quickExecute as q, quickRenameFileStream as r, quickMoveFile as s, quickMoveFileStream as t };

package/tests/client.example.ts

@@ -1,308 +0,0 @@
-import {
-  createClient,
-  quickExecute,
-  quickExecuteStream,
-  quickGitCheckout,
-  quickGitCheckoutStream,
-  quickMkdir,
-  quickMkdirStream,
-} from "../../sandbox/src/client";
-
-// Example 1: Basic client usage
-async function basicExample() {
-  console.log("=== Basic Client Example ===");
-
-  const client = createClient({
-    baseUrl: "http://localhost:3000",
-    onCommandComplete: (success, exitCode, stdout, stderr, command, args) => {
-      console.log(
-        `Command completed: ${command}, success=${success}, exitCode=${exitCode}`
-      );
-      if (stderr) console.log(`Stderr: ${stderr}`);
-    },
-    onCommandStart: (command, args) => {
-      console.log(`Starting command: ${command} ${args.join(" ")}`);
-    },
-    onError: (error, command, args) => {
-      console.error(`Error in ${command}: ${error}`);
-    },
-    onOutput: (stream, data, command) => {
-      console.log(`[${stream}] ${data}`);
-    },
-  });
-
-  try {
-    // Create a session
-    const sessionId = await client.createSession();
-    console.log(`Created session: ${sessionId}`);
-
-    // Execute some commands
-    const lsResult = await client.execute("ls", ["-la"]);
-    console.log("LS result:", lsResult.stdout);
-
-    const pwdResult = await client.ping();
-    console.log("Ping result:", pwdResult);
-
-    const commands = await client.getCommands();
-    console.log("Available commands:", commands.slice(0, 5));
-
-    // List sessions
-    const sessions = await client.listSessions();
-    console.log(`Active sessions: ${sessions.count}`);
-  } catch (error) {
-    console.error("Operation failed:", error);
-  } finally {
-    client.clearSession();
-  }
-}
-
-// Example 2: Streaming command execution
-async function streamingExample() {
-  console.log("\n=== Streaming Command Example ===");
-
-  const client = createClient({
-    baseUrl: "http://localhost:3000",
-    onCommandComplete: (success, exitCode, stdout, stderr, command, args) => {
-      console.log(
-        `\n✅ Completed: ${command}, success=${success}, exitCode=${exitCode}`
-      );
-    },
-    onCommandStart: (command, args) => {
-      console.log(`🚀 Starting: ${command} ${args.join(" ")}`);
-    },
-    onOutput: (stream, data, command) => {
-      process.stdout.write(data);
-    },
-  });
-
-  try {
-    await client.createSession();
-
-    // Execute a long-running command with streaming
-    console.log("Executing 'find . -name '*.ts' -type f' with streaming...");
-    await client.executeStream("find", [".", "-name", "*.ts", "-type", "f"]);
-
-    console.log("\nExecuting 'ls -la' with streaming...");
-    await client.executeStream("ls", ["-la"]);
-  } catch (error) {
-    console.error("Streaming failed:", error);
-  } finally {
-    client.clearSession();
-  }
-}
-
-// Example 3: Git operations
-async function gitExample() {
-  console.log("\n=== Git Operations Example ===");
-
-  const client = createClient({
-    baseUrl: "http://localhost:3000",
-    onCommandComplete: (success, exitCode, stdout, stderr, command, args) => {
-      console.log(`✅ Git operation completed: ${command}, success=${success}`);
-    },
-    onCommandStart: (command, args) => {
-      console.log(`🔧 Starting: ${command} ${args.join(" ")}`);
-    },
-    onOutput: (stream, data, command) => {
-      console.log(`[${stream}] ${data.trim()}`);
-    },
-  });
-
-  try {
-    await client.createSession();
-
-    // Create a directory for the repository
-    console.log("Creating directory for repository...");
-    const mkdirResult = await client.mkdir("test-repo", true);
-    console.log(`Directory created: ${mkdirResult.success}`);
-
-    // Checkout a small test repository
-    console.log("Checking out a test repository...");
-    const gitResult = await client.gitCheckout(
-      "https://github.com/octocat/Hello-World.git",
-      "main",
-      "test-repo/hello-world"
-    );
-    console.log(
-      `Repository cloned: ${gitResult.success}, target: ${gitResult.targetDir}`
-    );
-
-    // List the contents of the cloned repository
-    console.log("Listing repository contents...");
-    const lsResult = await client.execute("ls", [
-      "-la",
-      "test-repo/hello-world",
-    ]);
-    console.log("Repository contents:", lsResult.stdout);
-  } catch (error) {
-    console.error("Git operations failed:", error);
-  } finally {
-    client.clearSession();
-  }
-}
-
-// Example 4: Streaming git operations
-async function streamingGitExample() {
-  console.log("\n=== Streaming Git Operations Example ===");
-
-  const client = createClient({
-    baseUrl: "http://localhost:3000",
-    onCommandComplete: (success, exitCode, stdout, stderr, command, args) => {
-      console.log(
-        `\n🎉 Git operation completed: ${command}, success=${success}`
-      );
-    },
-    onCommandStart: (command, args) => {
-      console.log(`🌐 Starting git operation: ${command} ${args.join(" ")}`);
-    },
-    onOutput: (stream, data, command) => {
-      if (stream === "stderr") {
-        process.stderr.write(data);
-      } else {
-        process.stdout.write(data);
-      }
-    },
-  });
-
-  try {
-    await client.createSession();
-
-    // Create directory with streaming
-    console.log("Creating directory with streaming...");
-    await client.mkdirStream("streaming-test", true);
-
-    // Checkout repository with streaming (real-time progress)
-    console.log("Checking out repository with streaming...");
-    await client.gitCheckoutStream(
-      "https://github.com/octocat/Hello-World.git",
-      "main",
-      "streaming-test/hello-world"
-    );
-  } catch (error) {
-    console.error("Streaming git operations failed:", error);
-  } finally {
-    client.clearSession();
-  }
-}
-
-// Example 5: Quick execute utilities
-async function quickExecuteExample() {
-  console.log("\n=== Quick Execute Utilities Example ===");
-
-  try {
-    // Quick command execution
-    console.log("Quick command execution...");
-    const dateResult = await quickExecute("date");
-    console.log("Date:", dateResult.stdout.trim());
-
-    const whoamiResult = await quickExecute("whoami");
-    console.log("User:", whoamiResult.stdout.trim());
-
-    // Quick directory creation
-    console.log("Quick directory creation...");
-    const mkdirResult = await quickMkdir("quick-test", true);
-    console.log(`Directory created: ${mkdirResult.success}`);
-
-    // Quick git checkout
-    console.log("Quick git checkout...");
-    const gitResult = await quickGitCheckout(
-      "https://github.com/octocat/Hello-World.git",
-      "main",
-      "quick-test/repo"
-    );
-    console.log(`Repository cloned: ${gitResult.success}`);
-
-    // Quick streaming execution
-    console.log("Quick streaming execution...");
-    await quickExecuteStream("ls", ["-la", "quick-test"]);
-  } catch (error) {
-    console.error("Quick execute failed:", error);
-  }
-}
-
-// Example 6: Error handling
-async function errorHandlingExample() {
-  console.log("\n=== Error Handling Example ===");
-
-  const client = createClient({
-    baseUrl: "http://localhost:3000",
-    onError: (error, command, args) => {
-      console.error(`❌ Error in ${command}: ${error}`);
-    },
-  });
-
-  try {
-    await client.createSession();
-
-    // Try to execute a non-existent command
-    console.log("Trying to execute non-existent command...");
-    try {
-      await client.execute("nonexistentcommand");
-    } catch (error) {
-      console.log(
-        "Expected error caught:",
-        error instanceof Error ? error.message : error
-      );
-    }
-
-    // Try to create a directory in a protected location
-    console.log("Trying to create directory in protected location...");
-    try {
-      await client.mkdir("/etc/test", false);
-    } catch (error) {
-      console.log(
-        "Expected error caught:",
-        error instanceof Error ? error.message : error
-      );
-    }
-
-    // Try to checkout an invalid repository
-    console.log("Trying to checkout invalid repository...");
-    try {
-      await client.gitCheckout("invalid-url");
-    } catch (error) {
-      console.log(
-        "Expected error caught:",
-        error instanceof Error ? error.message : error
-      );
-    }
-  } catch (error) {
-    console.error("Error handling example failed:", error);
-  } finally {
-    client.clearSession();
-  }
-}
-
-// Run examples
-async function runExamples() {
-  console.log("🚀 HTTP Client Examples\n");
-
-  try {
-    await basicExample();
-    await streamingExample();
-    await gitExample();
-    await streamingGitExample();
-    await quickExecuteExample();
-    await errorHandlingExample();
-
-    console.log("\n✅ All examples completed!");
-  } catch (error) {
-    console.error("❌ Example failed:", error);
-  }
-}
-
-// Export for use in other modules
-export {
-  createClient,
-  quickExecute,
-  quickExecuteStream,
-  quickGitCheckout,
-  quickMkdir,
-  quickGitCheckoutStream,
-  quickMkdirStream,
-};
-
-// Run examples if this file is executed directly
-if (require.main === module) {
-  runExamples();
-}

package/tests/connection-test.ts

@@ -1,81 +0,0 @@
-import { HttpClient } from "../../sandbox/src/client";
-
-async function connectionTest() {
-  console.log("🔌 Testing HTTP Connection Only");
-
-  const client = new HttpClient({
-    baseUrl: "http://localhost:3000",
-    onCommandComplete: (
-      success: boolean,
-      exitCode: number,
-      stdout: string,
-      stderr: string,
-      command: string,
-      args: string[]
-    ) => {
-      console.log(
-        `✅ Command completed: ${command}, Success: ${success}, Exit code: ${exitCode}`
-      );
-    },
-    onCommandStart: (command: string, args: string[]) => {
-      console.log("📝 Command started:", command, args);
-    },
-    onError: (error: string, command?: string, args?: string[]) => {
-      console.error(`❌ Error: ${error}`);
-    },
-    onOutput: (stream: "stdout" | "stderr", data: string, command: string) => {
-      console.log(`📤 [${stream}] ${data.trim()}`);
-    },
-  });
-
-  try {
-    // Test ping to verify server is reachable
-    console.log("🏓 Testing ping...");
-    const pingResult = await client.ping();
-    console.log("✅ Ping successful:", pingResult);
-
-    // Create a session
-    console.log("🔗 Creating session...");
-    const sessionId = await client.createSession();
-    console.log("✅ Session created:", sessionId);
-
-    // Test getting available commands
-    console.log("📋 Getting available commands...");
-    const commands = await client.getCommands();
-    console.log("✅ Available commands:", commands.length);
-
-    // Test listing sessions
-    console.log("📝 Listing sessions...");
-    const sessions = await client.listSessions();
-    console.log("✅ Active sessions:", sessions.count);
-
-    // Wait a moment
-    await new Promise((resolve) => setTimeout(resolve, 1000));
-
-    console.log("✅ Connection test successful");
-  } catch (error) {
-    console.error("❌ Connection test failed:", error);
-    throw error;
-  } finally {
-    client.clearSession();
-    console.log("🔌 Session cleared");
-  }
-}
-
-// Add a timeout to prevent hanging
-const timeout = setTimeout(() => {
-  console.error("❌ Connection test timed out after 15 seconds");
-  process.exit(1);
-}, 15000);
-
-connectionTest()
-  .then(() => {
-    clearTimeout(timeout);
-    console.log("✅ Connection test finished successfully");
-    process.exit(0);
-  })
-  .catch((error) => {
-    clearTimeout(timeout);
-    console.error("❌ Connection test failed:", error);
-    process.exit(1);
-  });