feat: allow passing template as option in Sandbox.create()

.changeset/sandbox-template-option.md

@@ -0,0 +1,5 @@
+---
+'e2b': patch
+---
+
+allow passing template as an option in Sandbox.create()

packages/js-sdk/src/sandbox/index.ts

@@ -273,9 +273,11 @@ export class Sandbox extends SandboxApi {
             sandboxOpts: opts,
           }
         : {
-            template: templateOrOpts?.mcp
-              ? this.defaultMcpTemplate
-              : this.defaultTemplate,
+            template:
+              templateOrOpts?.template ??
+              (templateOrOpts?.mcp
+                ? this.defaultMcpTemplate
+                : this.defaultTemplate),
             sandboxOpts: templateOrOpts,
           }
 
@@ -368,9 +370,11 @@ export class Sandbox extends SandboxApi {
             sandboxOpts: opts,
           }
         : {
-            template: templateOrOpts?.mcp
-              ? this.defaultMcpTemplate
-              : this.defaultTemplate,
+            template:
+              templateOrOpts?.template ??
+              (templateOrOpts?.mcp
+                ? this.defaultMcpTemplate
+                : this.defaultTemplate),
             sandboxOpts: templateOrOpts,
           }
 

packages/js-sdk/src/sandbox/sandboxApi.ts

@@ -107,6 +107,13 @@ export interface SandboxApiOpts
  * Options for creating a new Sandbox.
  */
 export interface SandboxOpts extends ConnectionOpts {
+  /**
+   * Sandbox template name or ID.
+   *
+   * @default 'base' (or 'mcp-gateway' when `mcp` option is set)
+   */
+  template?: string
+
   /**
    * Custom metadata for the sandbox.
    *