@computesdk/codesandbox 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 computesdk
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,232 @@
+# @computesdk/codesandbox
+
+CodeSandbox provider for ComputeSDK - Execute code in secure, isolated CodeSandbox environments with full filesystem and development environment support.
+
+## Installation
+
+```bash
+npm install @computesdk/codesandbox
+```
+
+## Setup
+
+1. Get your CodeSandbox API key from [codesandbox.io/t/api](https://codesandbox.io/t/api)
+2. Set the environment variable:
+
+```bash
+export CSB_API_KEY=your_api_key_here
+```
+
+## Usage
+
+### With ComputeSDK
+
+```typescript
+import { compute } from 'computesdk';
+import { codesandbox } from '@computesdk/codesandbox';
+
+// Set as default provider
+compute.setConfig({ 
+  provider: codesandbox({ apiKey: process.env.CSB_API_KEY }) 
+});
+
+// Create sandbox
+const sandbox = await compute.sandbox.create({});
+
+// Execute JavaScript/Node.js code
+const result = await sandbox.runCode(`
+const message = "Hello from CodeSandbox!";
+console.log(message);
+
+const data = { users: 3, tasks: 15 };
+console.log(JSON.stringify(data, null, 2));
+`);
+
+console.log(result.stdout);
+// Output:
+// Hello from CodeSandbox!
+// {
+//   "users": 3,
+//   "tasks": 15
+// }
+
+// Execute Python code
+const pythonResult = await sandbox.runCode(`
+import json
+data = {"framework": "CodeSandbox", "language": "Python"}
+print(json.dumps(data, indent=2))
+print(f"Running in: {data['framework']}")
+`, 'python');
+
+console.log(pythonResult.stdout);
+// Output:
+// {
+//   "framework": "CodeSandbox",
+//   "language": "Python"
+// }
+// Running in: CodeSandbox
+
+// Clean up
+await compute.sandbox.destroy(sandbox.sandboxId);
+```
+
+### Direct Usage
+
+```typescript
+import { codesandbox } from '@computesdk/codesandbox';
+
+// Create provider
+const provider = codesandbox({ 
+  apiKey: 'your_api_key',
+  templateId: 'universal', // Optional: specify template
+  timeout: 600000 // 10 minutes
+});
+
+// Use with compute singleton
+const sandbox = await compute.sandbox.create({ provider });
+```
+
+## Configuration
+
+### Environment Variables
+
+```bash
+export CSB_API_KEY=your_api_key_here
+```
+
+### Configuration Options
+
+```typescript
+interface CodesandboxConfig {
+  /** CodeSandbox API key - if not provided, will use CSB_API_KEY env var */
+  apiKey?: string;
+  /** Template to use for new sandboxes (defaults to universal template) */
+  templateId?: string;
+  /** Default runtime environment */
+  runtime?: 'python' | 'node';
+  /** Execution timeout in milliseconds */
+  timeout?: number;
+}
+```
+
+## Features
+
+- ✅ **Code Execution** - Python and Node.js runtime support
+- ✅ **Command Execution** - Run shell commands in sandbox
+- ✅ **Filesystem Operations** - Full file system access via CodeSandbox API
+- ✅ **Template Support** - Create sandboxes from custom templates
+- ✅ **Auto Runtime Detection** - Automatically detects Python vs Node.js
+- ✅ **Development Environment** - Full development setup with package managers
+- ✅ **Persistence** - Files persist across hibernation/resume cycles
+- ✅ **Snapshot/Resume** - Fast sandbox restoration from snapshots
+
+## API Reference
+
+### Code Execution
+
+```typescript
+// Execute Node.js code
+const result = await sandbox.runCode(`
+const fs = require('fs');
+const data = { timestamp: Date.now() };
+console.log('Processing data:', JSON.stringify(data));
+`);
+
+// Execute Python code  
+const result = await sandbox.runCode(`
+import datetime
+import json
+
+data = {'timestamp': datetime.datetime.now().isoformat()}
+print('Processing data:', json.dumps(data))
+`, 'python');
+
+// Auto-detection (based on code patterns)
+const result = await sandbox.runCode('print("Auto-detected as Python")');
+```
+
+### Command Execution
+
+```typescript
+// List files
+const result = await sandbox.runCommand('ls', ['-la']);
+
+// Install Node.js packages
+const result = await sandbox.runCommand('npm', ['install', 'lodash']);
+
+// Install Python packages
+const result = await sandbox.runCommand('pip', ['install', 'requests']);
+
+// Run development server
+const result = await sandbox.runCommand('npm', ['run', 'dev']);
+```
+
+### Filesystem Operations
+
+```typescript
+// Write file
+await sandbox.filesystem.writeFile('/project/workspace/app.js', `
+const express = require('express');
+const app = express();
+
+app.get('/', (req, res) => {
+  res.json({ message: 'Hello from CodeSandbox!' });
+});
+
+app.listen(3000, () => {
+  console.log('Server running on port 3000');
+});
+`);
+
+// Read file
+const content = await sandbox.filesystem.readFile('/project/workspace/package.json');
+
+// Create directory
+await sandbox.filesystem.mkdir('/project/workspace/src');
+
+// List directory contents
+const files = await sandbox.filesystem.readdir('/project/workspace');
+
+// Check if file exists
+const exists = await sandbox.filesystem.exists('/project/workspace/app.js');
+
+// Remove file or directory
+await sandbox.filesystem.remove('/project/workspace/temp.txt');
+```
+
+### Sandbox Management
+
+```typescript
+// Get sandbox info
+const info = await sandbox.getInfo();
+console.log(info.id, info.provider, info.status);
+
+// Resume existing sandbox
+const existing = await compute.sandbox.getById(provider, 'sandbox-id');
+
+// Hibernate sandbox (saves state)
+await compute.sandbox.destroy(provider, 'sandbox-id'); // Actually hibernates
+
+// Note: CodeSandbox doesn't support listing all sandboxes
+// Each sandbox is managed individually
+```
+
+## Best Practices
+
+1. **Resource Management**: Use hibernation instead of destroying sandboxes to preserve state
+2. **Error Handling**: Use try-catch blocks for robust error handling
+3. **Timeouts**: Set appropriate timeouts for long-running tasks
+4. **File Organization**: Organize files in `/project/workspace/` directory
+5. **Template Usage**: Use appropriate templates for your project type
+6. **API Key Security**: Never commit API keys to version control
+7. **Snapshot Management**: Leverage CodeSandbox's snapshot/resume capabilities
+
+## Support
+
+- [CodeSandbox Documentation](https://codesandbox.io/docs/sdk)
+- [ComputeSDK Issues](https://github.com/computesdk/computesdk/issues)
+- [CodeSandbox Support](https://codesandbox.io/support)
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,22 @@
+import * as computesdk from 'computesdk';
+import { Runtime } from 'computesdk';
+
+/**
+ * Codesandbox-specific configuration options
+ */
+interface CodesandboxConfig {
+    /** CodeSandbox API key - if not provided, will fallback to CSB_API_KEY environment variable */
+    apiKey?: string;
+    /** Template to use for new sandboxes */
+    templateId?: string;
+    /** Default runtime environment */
+    runtime?: Runtime;
+    /** Execution timeout in milliseconds */
+    timeout?: number;
+}
+/**
+ * Create a Codesandbox provider instance using the factory pattern
+ */
+declare const codesandbox: (config: CodesandboxConfig) => computesdk.Provider;
+
+export { type CodesandboxConfig, codesandbox };

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+import * as computesdk from 'computesdk';
+import { Runtime } from 'computesdk';
+
+/**
+ * Codesandbox-specific configuration options
+ */
+interface CodesandboxConfig {
+    /** CodeSandbox API key - if not provided, will fallback to CSB_API_KEY environment variable */
+    apiKey?: string;
+    /** Template to use for new sandboxes */
+    templateId?: string;
+    /** Default runtime environment */
+    runtime?: Runtime;
+    /** Execution timeout in milliseconds */
+    timeout?: number;
+}
+/**
+ * Create a Codesandbox provider instance using the factory pattern
+ */
+declare const codesandbox: (config: CodesandboxConfig) => computesdk.Provider;
+
+export { type CodesandboxConfig, codesandbox };

package/dist/index.js

@@ -0,0 +1,236 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  codesandbox: () => codesandbox
+});
+module.exports = __toCommonJS(index_exports);
+var import_sdk = require("@codesandbox/sdk");
+var import_computesdk = require("computesdk");
+var codesandbox = (0, import_computesdk.createProvider)({
+  name: "codesandbox",
+  methods: {
+    sandbox: {
+      // Collection operations (compute.sandbox.*)
+      create: async (config, options) => {
+        const apiKey = config.apiKey || typeof process !== "undefined" && process.env?.CSB_API_KEY || "";
+        if (!apiKey) {
+          throw new Error(
+            `Missing CodeSandbox API key. Provide 'apiKey' in config or set CSB_API_KEY environment variable. Get your API key from https://codesandbox.io/t/api`
+          );
+        }
+        const sdk = new import_sdk.CodeSandbox(apiKey);
+        try {
+          let sandbox;
+          let sandboxId;
+          if (options?.sandboxId) {
+            sandbox = await sdk.sandboxes.resume(options.sandboxId);
+            sandboxId = options.sandboxId;
+          } else {
+            const createOptions = {};
+            if (config.templateId) {
+              createOptions.id = config.templateId;
+            }
+            sandbox = await sdk.sandboxes.create(createOptions);
+            sandboxId = sandbox.id;
+          }
+          return {
+            sandbox,
+            sandboxId
+          };
+        } catch (error) {
+          if (error instanceof Error) {
+            if (error.message.includes("unauthorized") || error.message.includes("API key")) {
+              throw new Error(
+                `CodeSandbox authentication failed. Please check your CSB_API_KEY environment variable. Get your API key from https://codesandbox.io/t/api`
+              );
+            }
+            if (error.message.includes("quota") || error.message.includes("limit")) {
+              throw new Error(
+                `CodeSandbox quota exceeded. Please check your usage at https://codesandbox.io/dashboard`
+              );
+            }
+          }
+          throw new Error(
+            `Failed to create CodeSandbox sandbox: ${error instanceof Error ? error.message : String(error)}`
+          );
+        }
+      },
+      getById: async (config, sandboxId) => {
+        const apiKey = config.apiKey || typeof process !== "undefined" && process.env?.CSB_API_KEY || "";
+        if (!apiKey) {
+          throw new Error(
+            `Missing CodeSandbox API key. Provide 'apiKey' in config or set CSB_API_KEY environment variable.`
+          );
+        }
+        const sdk = new import_sdk.CodeSandbox(apiKey);
+        try {
+          const sandbox = await sdk.sandboxes.resume(sandboxId);
+          return {
+            sandbox,
+            sandboxId
+          };
+        } catch (error) {
+          return null;
+        }
+      },
+      list: async (_config) => {
+        throw new Error(
+          `CodeSandbox provider does not support listing sandboxes. CodeSandbox SDK does not provide a native list API. Consider using the CodeSandbox dashboard or implement your own tracking system.`
+        );
+      },
+      destroy: async (config, sandboxId) => {
+        const apiKey = config.apiKey || typeof process !== "undefined" && process.env?.CSB_API_KEY || "";
+        if (!apiKey) {
+          throw new Error(
+            `Missing CodeSandbox API key. Provide 'apiKey' in config or set CSB_API_KEY environment variable.`
+          );
+        }
+        const sdk = new import_sdk.CodeSandbox(apiKey);
+        try {
+          await sdk.sandboxes.shutdown(sandboxId);
+        } catch (error) {
+        }
+      },
+      // Instance operations (sandbox.*)
+      runCode: async (sandbox, code, runtime) => {
+        const startTime = Date.now();
+        try {
+          const client = await sandbox.connect();
+          const effectiveRuntime = runtime || // Strong Python indicators
+          (code.includes("print(") || code.includes("import ") || code.includes("def ") || code.includes("sys.") || code.includes("json.") || code.includes("__") || code.includes('f"') || code.includes("f'") ? "python" : "node");
+          const encoded = Buffer.from(code).toString("base64");
+          let command;
+          if (effectiveRuntime === "python") {
+            command = `echo "${encoded}" | base64 -d | python3`;
+          } else {
+            command = `echo "${encoded}" | base64 -d | node`;
+          }
+          const output = await client.commands.run(command);
+          if (output.includes("SyntaxError") || output.includes("invalid syntax") || output.includes("Unexpected token") || output.includes("Unexpected identifier")) {
+            throw new Error(`Syntax error: ${output.trim()}`);
+          }
+          return {
+            stdout: output,
+            stderr: "",
+            exitCode: 0,
+            executionTime: Date.now() - startTime,
+            sandboxId: sandbox.id,
+            provider: "codesandbox"
+          };
+        } catch (error) {
+          if (error instanceof Error && error.message.includes("Syntax error")) {
+            throw error;
+          }
+          throw new Error(
+            `CodeSandbox execution failed: ${error instanceof Error ? error.message : String(error)}`
+          );
+        }
+      },
+      runCommand: async (sandbox, command, args = []) => {
+        const startTime = Date.now();
+        try {
+          const client = await sandbox.connect();
+          const fullCommand = args.length > 0 ? `${command} ${args.join(" ")}` : command;
+          const output = await client.commands.run(fullCommand);
+          return {
+            stdout: output,
+            stderr: "",
+            exitCode: 0,
+            executionTime: Date.now() - startTime,
+            sandboxId: sandbox.id,
+            provider: "codesandbox"
+          };
+        } catch (error) {
+          return {
+            stdout: "",
+            stderr: error instanceof Error ? error.message : String(error),
+            exitCode: 127,
+            // Command not found exit code
+            executionTime: Date.now() - startTime,
+            sandboxId: sandbox.id,
+            provider: "codesandbox"
+          };
+        }
+      },
+      getInfo: async (sandbox) => {
+        return {
+          id: sandbox.id,
+          provider: "codesandbox",
+          runtime: "node",
+          // CodeSandbox default
+          status: "running",
+          createdAt: /* @__PURE__ */ new Date(),
+          timeout: 3e5,
+          metadata: {
+            cluster: sandbox.cluster,
+            bootupType: sandbox.bootupType,
+            isUpToDate: sandbox.isUpToDate
+          }
+        };
+      },
+      // Filesystem operations using CodeSandbox client.fs API
+      filesystem: {
+        readFile: async (sandbox, path) => {
+          const client = await sandbox.connect();
+          return await client.fs.readTextFile(path);
+        },
+        writeFile: async (sandbox, path, content) => {
+          const client = await sandbox.connect();
+          await client.fs.writeTextFile(path, content);
+        },
+        mkdir: async (sandbox, path) => {
+          const client = await sandbox.connect();
+          await client.commands.run(`mkdir -p "${path}"`);
+        },
+        readdir: async (sandbox, path) => {
+          const client = await sandbox.connect();
+          const entries = await client.fs.readdir(path);
+          return entries.map((entry) => ({
+            name: entry.name,
+            path: `${path}/${entry.name}`.replace(/\/+/g, "/"),
+            isDirectory: entry.isDirectory || false,
+            size: entry.size || 0,
+            lastModified: entry.lastModified ? new Date(entry.lastModified) : /* @__PURE__ */ new Date()
+          }));
+        },
+        exists: async (sandbox, path) => {
+          const client = await sandbox.connect();
+          try {
+            await client.commands.run(`ls "${path}"`);
+            return true;
+          } catch {
+            return false;
+          }
+        },
+        remove: async (sandbox, path) => {
+          const client = await sandbox.connect();
+          await client.fs.remove(path);
+        }
+      }
+    }
+  }
+});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  codesandbox
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * Codesandbox Provider - Factory-based Implementation\n * \n * Full-featured provider with filesystem support using the factory pattern.\n */\n\nimport { CodeSandbox } from '@codesandbox/sdk';\nimport type { Sandbox as CodesandboxSandbox } from '@codesandbox/sdk';\nimport { createProvider } from 'computesdk';\nimport type { Runtime, ExecutionResult, SandboxInfo, CreateSandboxOptions, FileEntry } from 'computesdk';\n\n/**\n * Codesandbox-specific configuration options\n */\nexport interface CodesandboxConfig {\n  /** CodeSandbox API key - if not provided, will fallback to CSB_API_KEY environment variable */\n  apiKey?: string;\n  /** Template to use for new sandboxes */\n  templateId?: string;\n  /** Default runtime environment */\n  runtime?: Runtime;\n  /** Execution timeout in milliseconds */\n  timeout?: number;\n}\n\n/**\n * Create a Codesandbox provider instance using the factory pattern\n */\nexport const codesandbox = createProvider<CodesandboxSandbox, CodesandboxConfig>({\n  name: 'codesandbox',\n  methods: {\n    sandbox: {\n      // Collection operations (compute.sandbox.*)\n      create: async (config: CodesandboxConfig, options?: CreateSandboxOptions) => {\n        // Validate API key\n        const apiKey = config.apiKey || (typeof process !== 'undefined' && process.env?.CSB_API_KEY) || '';\n\n        if (!apiKey) {\n          throw new Error(\n            `Missing CodeSandbox API key. Provide 'apiKey' in config or set CSB_API_KEY environment variable. Get your API key from https://codesandbox.io/t/api`\n          );\n        }\n\n        const sdk = new CodeSandbox(apiKey);\n\n        try {\n          let sandbox: CodesandboxSandbox;\n          let sandboxId: string;\n\n          if (options?.sandboxId) {\n            // Resume existing CodeSandbox using sdk.sandboxes.resume()\n            sandbox = await sdk.sandboxes.resume(options.sandboxId);\n            sandboxId = options.sandboxId;\n          } else {\n            // Create new CodeSandbox using sdk.sandboxes.create()\n            const createOptions: any = {};\n            \n            if (config.templateId) {\n              createOptions.id = config.templateId;\n            }\n\n            sandbox = await sdk.sandboxes.create(createOptions);\n            sandboxId = sandbox.id;\n          }\n\n          return {\n            sandbox,\n            sandboxId\n          };\n        } catch (error) {\n          if (error instanceof Error) {\n            if (error.message.includes('unauthorized') || error.message.includes('API key')) {\n              throw new Error(\n                `CodeSandbox authentication failed. Please check your CSB_API_KEY environment variable. Get your API key from https://codesandbox.io/t/api`\n              );\n            }\n            if (error.message.includes('quota') || error.message.includes('limit')) {\n              throw new Error(\n                `CodeSandbox quota exceeded. Please check your usage at https://codesandbox.io/dashboard`\n              );\n            }\n          }\n          throw new Error(\n            `Failed to create CodeSandbox sandbox: ${error instanceof Error ? error.message : String(error)}`\n          );\n        }\n      },\n\n      getById: async (config: CodesandboxConfig, sandboxId: string) => {\n        const apiKey = config.apiKey || (typeof process !== 'undefined' && process.env?.CSB_API_KEY) || '';\n\n        if (!apiKey) {\n          throw new Error(\n            `Missing CodeSandbox API key. Provide 'apiKey' in config or set CSB_API_KEY environment variable.`\n          );\n        }\n\n        const sdk = new CodeSandbox(apiKey);\n\n        try {\n          // Resume existing sandbox using sdk.sandboxes.resume()\n          const sandbox = await sdk.sandboxes.resume(sandboxId);\n\n          return {\n            sandbox,\n            sandboxId\n          };\n        } catch (error) {\n          // Sandbox doesn't exist or can't be accessed\n          return null;\n        }\n      },\n\n      list: async (_config: CodesandboxConfig) => {\n        throw new Error(\n          `CodeSandbox provider does not support listing sandboxes. CodeSandbox SDK does not provide a native list API. Consider using the CodeSandbox dashboard or implement your own tracking system.`\n        );\n      },\n\n      destroy: async (config: CodesandboxConfig, sandboxId: string) => {\n        const apiKey = config.apiKey || (typeof process !== 'undefined' && process.env?.CSB_API_KEY) || '';\n\n        if (!apiKey) {\n          throw new Error(\n            `Missing CodeSandbox API key. Provide 'apiKey' in config or set CSB_API_KEY environment variable.`\n          );\n        }\n\n        const sdk = new CodeSandbox(apiKey);\n\n        try {\n          // Shutdown the sandbox using sdk.sandboxes.shutdown() to clean it up\n          await sdk.sandboxes.shutdown(sandboxId);\n        } catch (error) {\n          // Sandbox might already be shutdown or doesn't exist\n          // This is acceptable for destroy operations\n        }\n      },\n\n      // Instance operations (sandbox.*)\n      runCode: async (sandbox: CodesandboxSandbox, code: string, runtime?: Runtime): Promise<ExecutionResult> => {\n        const startTime = Date.now();\n\n        try {\n          // Connect to the sandbox client using sandbox.connect()\n          const client = await sandbox.connect();\n\n          // Auto-detect runtime if not specified\n          const effectiveRuntime = runtime || (\n            // Strong Python indicators\n            code.includes('print(') || \n            code.includes('import ') ||\n            code.includes('def ') ||\n            code.includes('sys.') ||\n            code.includes('json.') ||\n            code.includes('__') ||\n            code.includes('f\"') ||\n            code.includes(\"f'\")\n              ? 'python'\n              // Default to Node.js for all other cases (including ambiguous)\n              : 'node'\n          );\n\n          // Use base64 encoding for reliability and consistency\n          const encoded = Buffer.from(code).toString('base64');\n          let command: string;\n\n          if (effectiveRuntime === 'python') {\n            // Execute Python code using client.commands.run()\n            command = `echo \"${encoded}\" | base64 -d | python3`;\n          } else {\n            // Execute Node.js code using client.commands.run()\n            command = `echo \"${encoded}\" | base64 -d | node`;\n          }\n\n          // Execute the command using CodeSandbox client.commands.run()\n          // This returns the full output as a string\n          const output = await client.commands.run(command);\n\n          // Check for syntax errors in the output and throw them (similar to other providers)\n          if (output.includes('SyntaxError') || \n              output.includes('invalid syntax') ||\n              output.includes('Unexpected token') ||\n              output.includes('Unexpected identifier')) {\n            throw new Error(`Syntax error: ${output.trim()}`);\n          }\n\n          return {\n            stdout: output,\n            stderr: '',\n            exitCode: 0,\n            executionTime: Date.now() - startTime,\n            sandboxId: sandbox.id,\n            provider: 'codesandbox'\n          };\n        } catch (error) {\n          // Re-throw syntax errors\n          if (error instanceof Error && error.message.includes('Syntax error')) {\n            throw error;\n          }\n          throw new Error(\n            `CodeSandbox execution failed: ${error instanceof Error ? error.message : String(error)}`\n          );\n        }\n      },\n\n      runCommand: async (sandbox: CodesandboxSandbox, command: string, args: string[] = []): Promise<ExecutionResult> => {\n        const startTime = Date.now();\n\n        try {\n          // Connect to the sandbox client using sandbox.connect()\n          const client = await sandbox.connect();\n\n          // Construct full command with arguments\n          const fullCommand = args.length > 0 ? `${command} ${args.join(' ')}` : command;\n\n          // Execute command using CodeSandbox client.commands.run()\n          // This returns the full output as a string\n          const output = await client.commands.run(fullCommand);\n\n          return {\n            stdout: output,\n            stderr: '',\n            exitCode: 0,\n            executionTime: Date.now() - startTime,\n            sandboxId: sandbox.id,\n            provider: 'codesandbox'\n          };\n        } catch (error) {\n          // For command failures, return error info instead of throwing\n          return {\n            stdout: '',\n            stderr: error instanceof Error ? error.message : String(error),\n            exitCode: 127, // Command not found exit code\n            executionTime: Date.now() - startTime,\n            sandboxId: sandbox.id,\n            provider: 'codesandbox'\n          };\n        }\n      },\n\n      getInfo: async (sandbox: CodesandboxSandbox): Promise<SandboxInfo> => {\n        return {\n          id: sandbox.id,\n          provider: 'codesandbox',\n          runtime: 'node', // CodeSandbox default\n          status: 'running',\n          createdAt: new Date(),\n          timeout: 300000,\n          metadata: {\n            cluster: sandbox.cluster,\n            bootupType: sandbox.bootupType,\n            isUpToDate: sandbox.isUpToDate\n          }\n        };\n      },\n\n      // Filesystem operations using CodeSandbox client.fs API\n      filesystem: {\n        readFile: async (sandbox: CodesandboxSandbox, path: string): Promise<string> => {\n          // Connect to the sandbox client and use client.fs.readTextFile()\n          const client = await sandbox.connect();\n          return await client.fs.readTextFile(path);\n        },\n\n        writeFile: async (sandbox: CodesandboxSandbox, path: string, content: string): Promise<void> => {\n          // Connect to the sandbox client and use client.fs.writeTextFile()\n          const client = await sandbox.connect();\n          await client.fs.writeTextFile(path, content);\n        },\n\n        mkdir: async (sandbox: CodesandboxSandbox, path: string): Promise<void> => {\n          // CodeSandbox doesn't have a direct mkdir API, use commands to create directory\n          const client = await sandbox.connect();\n          await client.commands.run(`mkdir -p \"${path}\"`);\n        },\n\n        readdir: async (sandbox: CodesandboxSandbox, path: string): Promise<FileEntry[]> => {\n          // Connect to the sandbox client and use client.fs.readdir()\n          const client = await sandbox.connect();\n          const entries = await client.fs.readdir(path);\n\n          return entries.map((entry: any) => ({\n            name: entry.name,\n            path: `${path}/${entry.name}`.replace(/\\/+/g, '/'),\n            isDirectory: entry.isDirectory || false,\n            size: entry.size || 0,\n            lastModified: entry.lastModified ? new Date(entry.lastModified) : new Date()\n          }));\n        },\n\n        exists: async (sandbox: CodesandboxSandbox, path: string): Promise<boolean> => {\n          // CodeSandbox doesn't have a direct exists API, use ls command to check\n          const client = await sandbox.connect();\n          try {\n            await client.commands.run(`ls \"${path}\"`);\n            return true;\n          } catch {\n            return false;\n          }\n        },\n\n        remove: async (sandbox: CodesandboxSandbox, path: string): Promise<void> => {\n          // Connect to the sandbox client and use client.fs.remove()\n          const client = await sandbox.connect();\n          await client.fs.remove(path);\n        }\n      }\n    }\n  }\n});\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -0,0 +1,211 @@
+// src/index.ts
+import { CodeSandbox } from "@codesandbox/sdk";
+import { createProvider } from "computesdk";
+var codesandbox = createProvider({
+  name: "codesandbox",
+  methods: {
+    sandbox: {
+      // Collection operations (compute.sandbox.*)
+      create: async (config, options) => {
+        const apiKey = config.apiKey || typeof process !== "undefined" && process.env?.CSB_API_KEY || "";
+        if (!apiKey) {
+          throw new Error(
+            `Missing CodeSandbox API key. Provide 'apiKey' in config or set CSB_API_KEY environment variable. Get your API key from https://codesandbox.io/t/api`
+          );
+        }
+        const sdk = new CodeSandbox(apiKey);
+        try {
+          let sandbox;
+          let sandboxId;
+          if (options?.sandboxId) {
+            sandbox = await sdk.sandboxes.resume(options.sandboxId);
+            sandboxId = options.sandboxId;
+          } else {
+            const createOptions = {};
+            if (config.templateId) {
+              createOptions.id = config.templateId;
+            }
+            sandbox = await sdk.sandboxes.create(createOptions);
+            sandboxId = sandbox.id;
+          }
+          return {
+            sandbox,
+            sandboxId
+          };
+        } catch (error) {
+          if (error instanceof Error) {
+            if (error.message.includes("unauthorized") || error.message.includes("API key")) {
+              throw new Error(
+                `CodeSandbox authentication failed. Please check your CSB_API_KEY environment variable. Get your API key from https://codesandbox.io/t/api`
+              );
+            }
+            if (error.message.includes("quota") || error.message.includes("limit")) {
+              throw new Error(
+                `CodeSandbox quota exceeded. Please check your usage at https://codesandbox.io/dashboard`
+              );
+            }
+          }
+          throw new Error(
+            `Failed to create CodeSandbox sandbox: ${error instanceof Error ? error.message : String(error)}`
+          );
+        }
+      },
+      getById: async (config, sandboxId) => {
+        const apiKey = config.apiKey || typeof process !== "undefined" && process.env?.CSB_API_KEY || "";
+        if (!apiKey) {
+          throw new Error(
+            `Missing CodeSandbox API key. Provide 'apiKey' in config or set CSB_API_KEY environment variable.`
+          );
+        }
+        const sdk = new CodeSandbox(apiKey);
+        try {
+          const sandbox = await sdk.sandboxes.resume(sandboxId);
+          return {
+            sandbox,
+            sandboxId
+          };
+        } catch (error) {
+          return null;
+        }
+      },
+      list: async (_config) => {
+        throw new Error(
+          `CodeSandbox provider does not support listing sandboxes. CodeSandbox SDK does not provide a native list API. Consider using the CodeSandbox dashboard or implement your own tracking system.`
+        );
+      },
+      destroy: async (config, sandboxId) => {
+        const apiKey = config.apiKey || typeof process !== "undefined" && process.env?.CSB_API_KEY || "";
+        if (!apiKey) {
+          throw new Error(
+            `Missing CodeSandbox API key. Provide 'apiKey' in config or set CSB_API_KEY environment variable.`
+          );
+        }
+        const sdk = new CodeSandbox(apiKey);
+        try {
+          await sdk.sandboxes.shutdown(sandboxId);
+        } catch (error) {
+        }
+      },
+      // Instance operations (sandbox.*)
+      runCode: async (sandbox, code, runtime) => {
+        const startTime = Date.now();
+        try {
+          const client = await sandbox.connect();
+          const effectiveRuntime = runtime || // Strong Python indicators
+          (code.includes("print(") || code.includes("import ") || code.includes("def ") || code.includes("sys.") || code.includes("json.") || code.includes("__") || code.includes('f"') || code.includes("f'") ? "python" : "node");
+          const encoded = Buffer.from(code).toString("base64");
+          let command;
+          if (effectiveRuntime === "python") {
+            command = `echo "${encoded}" | base64 -d | python3`;
+          } else {
+            command = `echo "${encoded}" | base64 -d | node`;
+          }
+          const output = await client.commands.run(command);
+          if (output.includes("SyntaxError") || output.includes("invalid syntax") || output.includes("Unexpected token") || output.includes("Unexpected identifier")) {
+            throw new Error(`Syntax error: ${output.trim()}`);
+          }
+          return {
+            stdout: output,
+            stderr: "",
+            exitCode: 0,
+            executionTime: Date.now() - startTime,
+            sandboxId: sandbox.id,
+            provider: "codesandbox"
+          };
+        } catch (error) {
+          if (error instanceof Error && error.message.includes("Syntax error")) {
+            throw error;
+          }
+          throw new Error(
+            `CodeSandbox execution failed: ${error instanceof Error ? error.message : String(error)}`
+          );
+        }
+      },
+      runCommand: async (sandbox, command, args = []) => {
+        const startTime = Date.now();
+        try {
+          const client = await sandbox.connect();
+          const fullCommand = args.length > 0 ? `${command} ${args.join(" ")}` : command;
+          const output = await client.commands.run(fullCommand);
+          return {
+            stdout: output,
+            stderr: "",
+            exitCode: 0,
+            executionTime: Date.now() - startTime,
+            sandboxId: sandbox.id,
+            provider: "codesandbox"
+          };
+        } catch (error) {
+          return {
+            stdout: "",
+            stderr: error instanceof Error ? error.message : String(error),
+            exitCode: 127,
+            // Command not found exit code
+            executionTime: Date.now() - startTime,
+            sandboxId: sandbox.id,
+            provider: "codesandbox"
+          };
+        }
+      },
+      getInfo: async (sandbox) => {
+        return {
+          id: sandbox.id,
+          provider: "codesandbox",
+          runtime: "node",
+          // CodeSandbox default
+          status: "running",
+          createdAt: /* @__PURE__ */ new Date(),
+          timeout: 3e5,
+          metadata: {
+            cluster: sandbox.cluster,
+            bootupType: sandbox.bootupType,
+            isUpToDate: sandbox.isUpToDate
+          }
+        };
+      },
+      // Filesystem operations using CodeSandbox client.fs API
+      filesystem: {
+        readFile: async (sandbox, path) => {
+          const client = await sandbox.connect();
+          return await client.fs.readTextFile(path);
+        },
+        writeFile: async (sandbox, path, content) => {
+          const client = await sandbox.connect();
+          await client.fs.writeTextFile(path, content);
+        },
+        mkdir: async (sandbox, path) => {
+          const client = await sandbox.connect();
+          await client.commands.run(`mkdir -p "${path}"`);
+        },
+        readdir: async (sandbox, path) => {
+          const client = await sandbox.connect();
+          const entries = await client.fs.readdir(path);
+          return entries.map((entry) => ({
+            name: entry.name,
+            path: `${path}/${entry.name}`.replace(/\/+/g, "/"),
+            isDirectory: entry.isDirectory || false,
+            size: entry.size || 0,
+            lastModified: entry.lastModified ? new Date(entry.lastModified) : /* @__PURE__ */ new Date()
+          }));
+        },
+        exists: async (sandbox, path) => {
+          const client = await sandbox.connect();
+          try {
+            await client.commands.run(`ls "${path}"`);
+            return true;
+          } catch {
+            return false;
+          }
+        },
+        remove: async (sandbox, path) => {
+          const client = await sandbox.connect();
+          await client.fs.remove(path);
+        }
+      }
+    }
+  }
+});
+export {
+  codesandbox
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * Codesandbox Provider - Factory-based Implementation\n * \n * Full-featured provider with filesystem support using the factory pattern.\n */\n\nimport { CodeSandbox } from '@codesandbox/sdk';\nimport type { Sandbox as CodesandboxSandbox } from '@codesandbox/sdk';\nimport { createProvider } from 'computesdk';\nimport type { Runtime, ExecutionResult, SandboxInfo, CreateSandboxOptions, FileEntry } from 'computesdk';\n\n/**\n * Codesandbox-specific configuration options\n */\nexport interface CodesandboxConfig {\n  /** CodeSandbox API key - if not provided, will fallback to CSB_API_KEY environment variable */\n  apiKey?: string;\n  /** Template to use for new sandboxes */\n  templateId?: string;\n  /** Default runtime environment */\n  runtime?: Runtime;\n  /** Execution timeout in milliseconds */\n  timeout?: number;\n}\n\n/**\n * Create a Codesandbox provider instance using the factory pattern\n */\nexport const codesandbox = createProvider<CodesandboxSandbox, CodesandboxConfig>({\n  name: 'codesandbox',\n  methods: {\n    sandbox: {\n      // Collection operations (compute.sandbox.*)\n      create: async (config: CodesandboxConfig, options?: CreateSandboxOptions) => {\n        // Validate API key\n        const apiKey = config.apiKey || (typeof process !== 'undefined' && process.env?.CSB_API_KEY) || '';\n\n        if (!apiKey) {\n          throw new Error(\n            `Missing CodeSandbox API key. Provide 'apiKey' in config or set CSB_API_KEY environment variable. Get your API key from https://codesandbox.io/t/api`\n          );\n        }\n\n        const sdk = new CodeSandbox(apiKey);\n\n        try {\n          let sandbox: CodesandboxSandbox;\n          let sandboxId: string;\n\n          if (options?.sandboxId) {\n            // Resume existing CodeSandbox using sdk.sandboxes.resume()\n            sandbox = await sdk.sandboxes.resume(options.sandboxId);\n            sandboxId = options.sandboxId;\n          } else {\n            // Create new CodeSandbox using sdk.sandboxes.create()\n            const createOptions: any = {};\n            \n            if (config.templateId) {\n              createOptions.id = config.templateId;\n            }\n\n            sandbox = await sdk.sandboxes.create(createOptions);\n            sandboxId = sandbox.id;\n          }\n\n          return {\n            sandbox,\n            sandboxId\n          };\n        } catch (error) {\n          if (error instanceof Error) {\n            if (error.message.includes('unauthorized') || error.message.includes('API key')) {\n              throw new Error(\n                `CodeSandbox authentication failed. Please check your CSB_API_KEY environment variable. Get your API key from https://codesandbox.io/t/api`\n              );\n            }\n            if (error.message.includes('quota') || error.message.includes('limit')) {\n              throw new Error(\n                `CodeSandbox quota exceeded. Please check your usage at https://codesandbox.io/dashboard`\n              );\n            }\n          }\n          throw new Error(\n            `Failed to create CodeSandbox sandbox: ${error instanceof Error ? error.message : String(error)}`\n          );\n        }\n      },\n\n      getById: async (config: CodesandboxConfig, sandboxId: string) => {\n        const apiKey = config.apiKey || (typeof process !== 'undefined' && process.env?.CSB_API_KEY) || '';\n\n        if (!apiKey) {\n          throw new Error(\n            `Missing CodeSandbox API key. Provide 'apiKey' in config or set CSB_API_KEY environment variable.`\n          );\n        }\n\n        const sdk = new CodeSandbox(apiKey);\n\n        try {\n          // Resume existing sandbox using sdk.sandboxes.resume()\n          const sandbox = await sdk.sandboxes.resume(sandboxId);\n\n          return {\n            sandbox,\n            sandboxId\n          };\n        } catch (error) {\n          // Sandbox doesn't exist or can't be accessed\n          return null;\n        }\n      },\n\n      list: async (_config: CodesandboxConfig) => {\n        throw new Error(\n          `CodeSandbox provider does not support listing sandboxes. CodeSandbox SDK does not provide a native list API. Consider using the CodeSandbox dashboard or implement your own tracking system.`\n        );\n      },\n\n      destroy: async (config: CodesandboxConfig, sandboxId: string) => {\n        const apiKey = config.apiKey || (typeof process !== 'undefined' && process.env?.CSB_API_KEY) || '';\n\n        if (!apiKey) {\n          throw new Error(\n            `Missing CodeSandbox API key. Provide 'apiKey' in config or set CSB_API_KEY environment variable.`\n          );\n        }\n\n        const sdk = new CodeSandbox(apiKey);\n\n        try {\n          // Shutdown the sandbox using sdk.sandboxes.shutdown() to clean it up\n          await sdk.sandboxes.shutdown(sandboxId);\n        } catch (error) {\n          // Sandbox might already be shutdown or doesn't exist\n          // This is acceptable for destroy operations\n        }\n      },\n\n      // Instance operations (sandbox.*)\n      runCode: async (sandbox: CodesandboxSandbox, code: string, runtime?: Runtime): Promise<ExecutionResult> => {\n        const startTime = Date.now();\n\n        try {\n          // Connect to the sandbox client using sandbox.connect()\n          const client = await sandbox.connect();\n\n          // Auto-detect runtime if not specified\n          const effectiveRuntime = runtime || (\n            // Strong Python indicators\n            code.includes('print(') || \n            code.includes('import ') ||\n            code.includes('def ') ||\n            code.includes('sys.') ||\n            code.includes('json.') ||\n            code.includes('__') ||\n            code.includes('f\"') ||\n            code.includes(\"f'\")\n              ? 'python'\n              // Default to Node.js for all other cases (including ambiguous)\n              : 'node'\n          );\n\n          // Use base64 encoding for reliability and consistency\n          const encoded = Buffer.from(code).toString('base64');\n          let command: string;\n\n          if (effectiveRuntime === 'python') {\n            // Execute Python code using client.commands.run()\n            command = `echo \"${encoded}\" | base64 -d | python3`;\n          } else {\n            // Execute Node.js code using client.commands.run()\n            command = `echo \"${encoded}\" | base64 -d | node`;\n          }\n\n          // Execute the command using CodeSandbox client.commands.run()\n          // This returns the full output as a string\n          const output = await client.commands.run(command);\n\n          // Check for syntax errors in the output and throw them (similar to other providers)\n          if (output.includes('SyntaxError') || \n              output.includes('invalid syntax') ||\n              output.includes('Unexpected token') ||\n              output.includes('Unexpected identifier')) {\n            throw new Error(`Syntax error: ${output.trim()}`);\n          }\n\n          return {\n            stdout: output,\n            stderr: '',\n            exitCode: 0,\n            executionTime: Date.now() - startTime,\n            sandboxId: sandbox.id,\n            provider: 'codesandbox'\n          };\n        } catch (error) {\n          // Re-throw syntax errors\n          if (error instanceof Error && error.message.includes('Syntax error')) {\n            throw error;\n          }\n          throw new Error(\n            `CodeSandbox execution failed: ${error instanceof Error ? error.message : String(error)}`\n          );\n        }\n      },\n\n      runCommand: async (sandbox: CodesandboxSandbox, command: string, args: string[] = []): Promise<ExecutionResult> => {\n        const startTime = Date.now();\n\n        try {\n          // Connect to the sandbox client using sandbox.connect()\n          const client = await sandbox.connect();\n\n          // Construct full command with arguments\n          const fullCommand = args.length > 0 ? `${command} ${args.join(' ')}` : command;\n\n          // Execute command using CodeSandbox client.commands.run()\n          // This returns the full output as a string\n          const output = await client.commands.run(fullCommand);\n\n          return {\n            stdout: output,\n            stderr: '',\n            exitCode: 0,\n            executionTime: Date.now() - startTime,\n            sandboxId: sandbox.id,\n            provider: 'codesandbox'\n          };\n        } catch (error) {\n          // For command failures, return error info instead of throwing\n          return {\n            stdout: '',\n            stderr: error instanceof Error ? error.message : String(error),\n            exitCode: 127, // Command not found exit code\n            executionTime: Date.now() - startTime,\n            sandboxId: sandbox.id,\n            provider: 'codesandbox'\n          };\n        }\n      },\n\n      getInfo: async (sandbox: CodesandboxSandbox): Promise<SandboxInfo> => {\n        return {\n          id: sandbox.id,\n          provider: 'codesandbox',\n          runtime: 'node', // CodeSandbox default\n          status: 'running',\n          createdAt: new Date(),\n          timeout: 300000,\n          metadata: {\n            cluster: sandbox.cluster,\n            bootupType: sandbox.bootupType,\n            isUpToDate: sandbox.isUpToDate\n          }\n        };\n      },\n\n      // Filesystem operations using CodeSandbox client.fs API\n      filesystem: {\n        readFile: async (sandbox: CodesandboxSandbox, path: string): Promise<string> => {\n          // Connect to the sandbox client and use client.fs.readTextFile()\n          const client = await sandbox.connect();\n          return await client.fs.readTextFile(path);\n        },\n\n        writeFile: async (sandbox: CodesandboxSandbox, path: string, content: string): Promise<void> => {\n          // Connect to the sandbox client and use client.fs.writeTextFile()\n          const client = await sandbox.connect();\n          await client.fs.writeTextFile(path, content);\n        },\n\n        mkdir: async (sandbox: CodesandboxSandbox, path: string): Promise<void> => {\n          // CodeSandbox doesn't have a direct mkdir API, use commands to create directory\n          const client = await sandbox.connect();\n          await client.commands.run(`mkdir -p \"${path}\"`);\n        },\n\n        readdir: async (sandbox: CodesandboxSandbox, path: string): Promise<FileEntry[]> => {\n          // Connect to the sandbox client and use client.fs.readdir()\n          const client = await sandbox.connect();\n          const entries = await client.fs.readdir(path);\n\n          return entries.map((entry: any) => ({\n            name: entry.name,\n            path: `${path}/${entry.name}`.replace(/\\/+/g, '/'),\n            isDirectory: entry.isDirectory || false,\n            size: entry.size || 0,\n            lastModified: entry.lastModified ? new Date(entry.lastModified) : new Date()\n          }));\n        },\n\n        exists: async (sandbox: CodesandboxSandbox, path: string): Promise<boolean> => {\n          // CodeSandbox doesn't have a direct exists API, use ls command to check\n          const client = await sandbox.connect();\n          try {\n            await client.commands.run(`ls \"${path}\"`);\n            return true;\n          } catch {\n            return false;\n          }\n        },\n\n        remove: async (sandbox: CodesandboxSandbox, path: string): Promise<void> => {\n          // Connect to the sandbox client and use client.fs.remove()\n          const client = await sandbox.connect();\n          await client.fs.remove(path);\n        }\n      }\n    }\n  }\n});\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@computesdk/codesandbox",
+  "version": "1.0.1",
+  "description": "CodeSandbox provider for ComputeSDK",
+  "author": "Garrison",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@codesandbox/sdk": "^2.0.7",
+    "computesdk": "1.1.1"
+  },
+  "keywords": [
+    "codesandbox",
+    "sandbox",
+    "code-execution",
+    "javascript",
+    "python",
+    "cloud",
+    "compute"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/computesdk/computesdk.git",
+    "directory": "packages/codesandbox"
+  },
+  "homepage": "https://github.com/computesdk/computesdk/tree/main/packages/codesandbox",
+  "bugs": {
+    "url": "https://github.com/computesdk/computesdk/issues"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@vitest/coverage-v8": "^1.0.0",
+    "eslint": "^8.37.0",
+    "rimraf": "^5.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0",
+    "@computesdk/test-utils": "1.1.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "rimraf dist",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint"
+  }
+}