@brimble/sandbox 0.1.0

package/README.md

@@ -0,0 +1,147 @@
+# @brimble/sandbox
+
+TypeScript SDK for the Brimble Sandbox API.
+
+## Install
+
+```bash
+npm install @brimble/sandbox
+```
+
+## Testing
+
+```bash
+# Unit tests (mocked transport, no API key required)
+npm run test
+
+# Live integration test (creates a sandbox, runs a command, then destroys it)
+BRIMBLE_SANDBOX_KEY=your_key_here npm run test:integration
+
+# Run both
+BRIMBLE_SANDBOX_KEY=your_key_here npm run test:all
+```
+
+## Quickstart
+
+```ts
+import { CodeLanguage, SandboxClient } from '@brimble/sandbox';
+
+const client = new SandboxClient();
+
+const sandbox = await client.sandboxes.createReady({
+  template: 'node-22',
+  persistent: true,
+  persistentDiskGB: 20,
+});
+
+await sandbox.exec({ cmd: 'node -v' });
+
+await sandbox.putFile('tmp/notes.txt', Buffer.from('hello sandbox'));
+const stream = await sandbox.getFile('tmp/notes.txt');
+
+await sandbox.runCode({
+  language: CodeLanguage.Node,
+  code: 'console.log(1 + 1)',
+});
+
+// Handle-first lifecycle on existing sandboxes.
+const existingSandbox = await client.sandboxes.get(sandbox.id);
+await existingSandbox.destroy();
+```
+
+Set `BRIMBLE_SANDBOX_KEY` in your environment.  
+If needed, pass `apiKey` explicitly in the constructor; explicit value wins over env.
+
+## Ergonomic helpers
+
+```ts
+// 1) Create + wait in one call
+const created = await client.sandboxes.createReady({ template: 'node-22' });
+
+// 2) Get + wait in one call
+const loaded = await client.sandboxes.getReady(created.id);
+
+// 3) Create a volume + attach in one call
+const withVolume = await client.sandboxes.withVolume({
+  sandbox: { template: 'node-22' },
+  volume: { name: 'workspace-disk', sizeGB: 20 },
+});
+
+// 4) Auto-wait at runtime call sites
+await withVolume.exec({ cmd: 'npm -v' }, { waitUntilReady: true });
+
+// Streaming SSE output (stream: true returns ReadableStream<Uint8Array>)
+const sse = await withVolume.exec({ cmd: 'for i in 1 2 3; do echo $i; done', stream: true });
+
+// 5) List templates/regions
+const templates = await client.sandboxes.listTemplates();
+const nodeTemplate = await client.sandboxes.getTemplate('node-22');
+const { regions } = await client.sandboxes.listRegions();
+
+// 6) Async iterators for pagination
+for await (const sandbox of client.sandboxes.iterate({ teamId: '<team>' })) {
+  console.log(sandbox.id, sandbox.status);
+}
+```
+
+## Handle composition
+
+```ts
+const sandbox = await client.sandboxes.get('<sandbox-id>');
+
+await sandbox.snapshots.create({ name: 'before-migration' });
+```
+
+Volume attachment is create-time only.  
+Use `client.sandboxes.create({ ..., volumeId })` or `client.sandboxes.withVolume(...)`.
+
+## Retry, timeouts, and idempotency
+
+```ts
+const client = new SandboxClient({
+  timeoutMs: 30_000,
+  retry: {
+    maxAttempts: 3,
+    baseDelayMs: 250,
+    maxDelayMs: 2_000,
+  },
+});
+
+await client.sandboxes.create(
+  { template: 'node-22' },
+  { idempotencyKey: 'create-sandbox-123' },
+);
+```
+
+If `region` is omitted, the SDK resolves the first available sandbox region automatically.
+
+## Resources
+
+- `client.sandboxes`
+  - `create`, `createReady`, `withVolume`, `list`, `iterate`, `get`, `getReady`, `listRegions`, `listTemplates`, `getTemplate`, `destroy`, `pause`, `resume`, `quickstartNode`, `quickstartPython`, `use`
+- `sandbox` handle (returned from `create/get/list`)
+  - `waitUntilReady`, `refresh`, `destroy`, `pause`, `resume`, `exec`, `runCode`, `putFile`, `getFile`, `stats`, `createSnapshot`, `listSnapshots`, `snapshots.create`, `snapshots.list`
+- `client.sandboxes.use(id)`
+  - `exec`, `runCode`, `putFile`, `getFile`, `stats`, `createSnapshot`, `listSnapshots`
+- `client.snapshots`
+  - `listAll`, `iterateAll`, `delete`
+- `client.volumes`
+  - `list`, `iterate`, `create`, `get`, `delete`
+
+## Errors
+
+HTTP errors throw typed errors:
+
+- `AuthError`
+- `ValidationError`
+- `NotFoundError`
+- `RateLimitError`
+- `SandboxApiError`
+
+All include:
+
+- `status`
+- `message`
+- `endpoint`
+- `responseBody`
+- `requestId`

package/dist/package.json

@@ -0,0 +1,23 @@
+{
+    "name": "@brimble/sandbox",
+    "version": "0.1.0",
+    "description": "TypeScript SDK for the Brimble Sandbox API",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "scripts": {
+        "build": "rm -rf dist && tsc -p .",
+        "test": "vitest run --config vitest.config.ts",
+        "test:watch": "vitest --config vitest.config.ts",
+        "test:integration": "vitest run --config vitest.integration.config.ts",
+        "test:all": "npm run test && npm run test:integration"
+    },
+    "engines": {
+        "node": ">=20"
+    },
+    "license": "MIT",
+    "devDependencies": {
+        "@types/node": "^20.19.0",
+        "typescript": "^5.9.3",
+        "vitest": "^3.2.4"
+    }
+}

package/dist/src/client.d.ts

@@ -0,0 +1,23 @@
+import { SandboxesResource, SnapshotsResource, VolumesResource } from './resources';
+import type { RetryOptions } from './transport/http';
+export type SandboxClientOptions = {
+    apiKey?: string;
+    baseUrl?: string;
+    timeoutMs?: number;
+    retry?: RetryOptions;
+    fetchImpl?: typeof fetch;
+};
+export declare class SandboxClient {
+    /** Access sandbox lifecycle and per-sandbox scoped operations. */
+    readonly sandboxes: SandboxesResource;
+    /** Access account-level snapshot operations. */
+    readonly snapshots: SnapshotsResource;
+    /** Access volume lifecycle operations. */
+    readonly volumes: VolumesResource;
+    private readonly transport;
+    /**
+     * Creates a client instance for the Brimble Sandbox API.
+     * Pass `apiKey` directly or set `BRIMBLE_SANDBOX_KEY` in your environment.
+     */
+    constructor(options?: SandboxClientOptions);
+}

package/dist/src/client.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SandboxClient = void 0;
+const constants_1 = require("./constants");
+const resources_1 = require("./resources");
+const http_1 = require("./transport/http");
+/**
+ * Resolves the API key from the constructor options first,
+ * then falls back to BRIMBLE_SANDBOX_KEY.
+ */
+function resolveApiKey(options) {
+    if (options.apiKey) {
+        return options.apiKey;
+    }
+    const apiKeyFromEnv = process.env[constants_1.SANDBOX_API_KEY_ENV_NAME];
+    if (apiKeyFromEnv) {
+        return apiKeyFromEnv;
+    }
+    throw new Error(`Sandbox API key is required. Pass "apiKey" explicitly or set ${constants_1.SANDBOX_API_KEY_ENV_NAME} in your environment.`);
+}
+class SandboxClient {
+    /** Access sandbox lifecycle and per-sandbox scoped operations. */
+    sandboxes;
+    /** Access account-level snapshot operations. */
+    snapshots;
+    /** Access volume lifecycle operations. */
+    volumes;
+    transport;
+    /**
+     * Creates a client instance for the Brimble Sandbox API.
+     * Pass `apiKey` directly or set `BRIMBLE_SANDBOX_KEY` in your environment.
+     */
+    constructor(options = {}) {
+        this.transport = new http_1.HttpTransport({
+            apiKey: resolveApiKey(options),
+            baseUrl: options.baseUrl ?? constants_1.DEFAULT_BASE_URL,
+            timeoutMs: options.timeoutMs ?? constants_1.DEFAULT_TIMEOUT_MS,
+            retry: options.retry,
+            fetchImpl: options.fetchImpl,
+        });
+        this.sandboxes = new resources_1.SandboxesResource(this.transport);
+        this.snapshots = new resources_1.SnapshotsResource(this.transport);
+        this.volumes = new resources_1.VolumesResource(this.transport);
+    }
+}
+exports.SandboxClient = SandboxClient;

package/dist/src/constants.d.ts

@@ -0,0 +1,14 @@
+export declare const DEFAULT_BASE_URL = "https://sandbox.brimble.io";
+export declare const DEFAULT_TIMEOUT_MS = 30000;
+export declare const SANDBOX_API_KEY_ENV_NAME = "BRIMBLE_SANDBOX_KEY";
+export declare const SDK_PACKAGE_VERSION: string;
+export declare const DEFAULT_PAGE = 1;
+export declare const DEFAULT_PAGE_LIMIT = 15;
+export declare const MAX_PAGE_LIMIT = 100;
+export declare const MIN_VOLUME_SIZE_GB = 10;
+export declare const DEFAULT_SANDBOX_READY_TIMEOUT_MS = 60000;
+export declare const DEFAULT_SANDBOX_READY_POLL_INTERVAL_MS = 2000;
+export declare const DEFAULT_RETRY_MAX_ATTEMPTS = 1;
+export declare const DEFAULT_RETRY_BASE_DELAY_MS = 300;
+export declare const DEFAULT_RETRY_MAX_DELAY_MS = 3000;
+export declare const DEFAULT_RETRY_STATUSES: readonly [408, 429, 500, 502, 503, 504];

package/dist/src/constants.js

@@ -0,0 +1,21 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_RETRY_STATUSES = exports.DEFAULT_RETRY_MAX_DELAY_MS = exports.DEFAULT_RETRY_BASE_DELAY_MS = exports.DEFAULT_RETRY_MAX_ATTEMPTS = exports.DEFAULT_SANDBOX_READY_POLL_INTERVAL_MS = exports.DEFAULT_SANDBOX_READY_TIMEOUT_MS = exports.MIN_VOLUME_SIZE_GB = exports.MAX_PAGE_LIMIT = exports.DEFAULT_PAGE_LIMIT = exports.DEFAULT_PAGE = exports.SDK_PACKAGE_VERSION = exports.SANDBOX_API_KEY_ENV_NAME = exports.DEFAULT_TIMEOUT_MS = exports.DEFAULT_BASE_URL = void 0;
+const package_json_1 = __importDefault(require("../package.json"));
+exports.DEFAULT_BASE_URL = 'https://sandbox.brimble.io';
+exports.DEFAULT_TIMEOUT_MS = 30_000;
+exports.SANDBOX_API_KEY_ENV_NAME = 'BRIMBLE_SANDBOX_KEY';
+exports.SDK_PACKAGE_VERSION = package_json_1.default.version;
+exports.DEFAULT_PAGE = 1;
+exports.DEFAULT_PAGE_LIMIT = 15;
+exports.MAX_PAGE_LIMIT = 100;
+exports.MIN_VOLUME_SIZE_GB = 10;
+exports.DEFAULT_SANDBOX_READY_TIMEOUT_MS = 60_000;
+exports.DEFAULT_SANDBOX_READY_POLL_INTERVAL_MS = 2_000;
+exports.DEFAULT_RETRY_MAX_ATTEMPTS = 1;
+exports.DEFAULT_RETRY_BASE_DELAY_MS = 300;
+exports.DEFAULT_RETRY_MAX_DELAY_MS = 3_000;
+exports.DEFAULT_RETRY_STATUSES = [408, 429, 500, 502, 503, 504];

package/dist/src/enums/code-language.d.ts

@@ -0,0 +1,4 @@
+export declare enum CodeLanguage {
+    Python = "python",
+    Node = "node"
+}

package/dist/src/enums/code-language.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CodeLanguage = void 0;
+var CodeLanguage;
+(function (CodeLanguage) {
+    CodeLanguage["Python"] = "python";
+    CodeLanguage["Node"] = "node";
+})(CodeLanguage || (exports.CodeLanguage = CodeLanguage = {}));

package/dist/src/enums/destroy-reason.d.ts

@@ -0,0 +1,8 @@
+export declare enum DestroyReason {
+    User = "user",
+    IdleTtl = "idle_ttl",
+    MaxLifetime = "max_lifetime",
+    OneShotStopped = "one_shot_stopped",
+    Failed = "failed",
+    PausedTooLong = "paused_too_long"
+}

package/dist/src/enums/destroy-reason.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DestroyReason = void 0;
+var DestroyReason;
+(function (DestroyReason) {
+    DestroyReason["User"] = "user";
+    DestroyReason["IdleTtl"] = "idle_ttl";
+    DestroyReason["MaxLifetime"] = "max_lifetime";
+    DestroyReason["OneShotStopped"] = "one_shot_stopped";
+    DestroyReason["Failed"] = "failed";
+    DestroyReason["PausedTooLong"] = "paused_too_long";
+})(DestroyReason || (exports.DestroyReason = DestroyReason = {}));

package/dist/src/enums/destroy-timeout.d.ts

@@ -0,0 +1,8 @@
+export declare enum DestroyTimeout {
+    ThirtyMinutes = "30m",
+    OneHour = "1h",
+    ThreeHours = "3h",
+    SixHours = "6h",
+    TwelveHours = "12h",
+    EighteenHours = "18h"
+}

package/dist/src/enums/destroy-timeout.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DestroyTimeout = void 0;
+var DestroyTimeout;
+(function (DestroyTimeout) {
+    DestroyTimeout["ThirtyMinutes"] = "30m";
+    DestroyTimeout["OneHour"] = "1h";
+    DestroyTimeout["ThreeHours"] = "3h";
+    DestroyTimeout["SixHours"] = "6h";
+    DestroyTimeout["TwelveHours"] = "12h";
+    DestroyTimeout["EighteenHours"] = "18h";
+})(DestroyTimeout || (exports.DestroyTimeout = DestroyTimeout = {}));

package/dist/src/enums/index.d.ts

@@ -0,0 +1,7 @@
+export { CodeLanguage } from './code-language';
+export { DestroyReason } from './destroy-reason';
+export { DestroyTimeout } from './destroy-timeout';
+export { SandboxStatus } from './sandbox-status';
+export { SnapshotMode } from './snapshot-mode';
+export { SnapshotStatus } from './snapshot-status';
+export { VolumeType } from './volume-type';

package/dist/src/enums/index.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VolumeType = exports.SnapshotStatus = exports.SnapshotMode = exports.SandboxStatus = exports.DestroyTimeout = exports.DestroyReason = exports.CodeLanguage = void 0;
+var code_language_1 = require("./code-language");
+Object.defineProperty(exports, "CodeLanguage", { enumerable: true, get: function () { return code_language_1.CodeLanguage; } });
+var destroy_reason_1 = require("./destroy-reason");
+Object.defineProperty(exports, "DestroyReason", { enumerable: true, get: function () { return destroy_reason_1.DestroyReason; } });
+var destroy_timeout_1 = require("./destroy-timeout");
+Object.defineProperty(exports, "DestroyTimeout", { enumerable: true, get: function () { return destroy_timeout_1.DestroyTimeout; } });
+var sandbox_status_1 = require("./sandbox-status");
+Object.defineProperty(exports, "SandboxStatus", { enumerable: true, get: function () { return sandbox_status_1.SandboxStatus; } });
+var snapshot_mode_1 = require("./snapshot-mode");
+Object.defineProperty(exports, "SnapshotMode", { enumerable: true, get: function () { return snapshot_mode_1.SnapshotMode; } });
+var snapshot_status_1 = require("./snapshot-status");
+Object.defineProperty(exports, "SnapshotStatus", { enumerable: true, get: function () { return snapshot_status_1.SnapshotStatus; } });
+var volume_type_1 = require("./volume-type");
+Object.defineProperty(exports, "VolumeType", { enumerable: true, get: function () { return volume_type_1.VolumeType; } });

package/dist/src/enums/sandbox-status.d.ts

@@ -0,0 +1,9 @@
+export declare enum SandboxStatus {
+    Starting = "starting",
+    Ready = "ready",
+    Pausing = "pausing",
+    Paused = "paused",
+    Resuming = "resuming",
+    Failed = "failed",
+    Destroyed = "destroyed"
+}

package/dist/src/enums/sandbox-status.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SandboxStatus = void 0;
+var SandboxStatus;
+(function (SandboxStatus) {
+    SandboxStatus["Starting"] = "starting";
+    SandboxStatus["Ready"] = "ready";
+    SandboxStatus["Pausing"] = "pausing";
+    SandboxStatus["Paused"] = "paused";
+    SandboxStatus["Resuming"] = "resuming";
+    SandboxStatus["Failed"] = "failed";
+    SandboxStatus["Destroyed"] = "destroyed";
+})(SandboxStatus || (exports.SandboxStatus = SandboxStatus = {}));

package/dist/src/enums/snapshot-mode.d.ts

@@ -0,0 +1,4 @@
+export declare enum SnapshotMode {
+    Manual = "manual",
+    Automatic = "automatic"
+}

package/dist/src/enums/snapshot-mode.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SnapshotMode = void 0;
+var SnapshotMode;
+(function (SnapshotMode) {
+    SnapshotMode["Manual"] = "manual";
+    SnapshotMode["Automatic"] = "automatic";
+})(SnapshotMode || (exports.SnapshotMode = SnapshotMode = {}));

package/dist/src/enums/snapshot-status.d.ts

@@ -0,0 +1,5 @@
+export declare enum SnapshotStatus {
+    Creating = "creating",
+    Ready = "ready",
+    Failed = "failed"
+}

package/dist/src/enums/snapshot-status.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SnapshotStatus = void 0;
+var SnapshotStatus;
+(function (SnapshotStatus) {
+    SnapshotStatus["Creating"] = "creating";
+    SnapshotStatus["Ready"] = "ready";
+    SnapshotStatus["Failed"] = "failed";
+})(SnapshotStatus || (exports.SnapshotStatus = SnapshotStatus = {}));

package/dist/src/enums/volume-type.d.ts

@@ -0,0 +1,3 @@
+export declare enum VolumeType {
+    Sandbox = "sandbox"
+}

package/dist/src/enums/volume-type.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VolumeType = void 0;
+var VolumeType;
+(function (VolumeType) {
+    VolumeType["Sandbox"] = "sandbox";
+})(VolumeType || (exports.VolumeType = VolumeType = {}));

package/dist/src/errors/index.d.ts

@@ -0,0 +1,2 @@
+export { AuthError, NotFoundError, RateLimitError, SandboxApiError, ValidationError } from './sandbox-api-error';
+export type { SandboxApiErrorArgs } from './sandbox-api-error';

package/dist/src/errors/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidationError = exports.SandboxApiError = exports.RateLimitError = exports.NotFoundError = exports.AuthError = void 0;
+var sandbox_api_error_1 = require("./sandbox-api-error");
+Object.defineProperty(exports, "AuthError", { enumerable: true, get: function () { return sandbox_api_error_1.AuthError; } });
+Object.defineProperty(exports, "NotFoundError", { enumerable: true, get: function () { return sandbox_api_error_1.NotFoundError; } });
+Object.defineProperty(exports, "RateLimitError", { enumerable: true, get: function () { return sandbox_api_error_1.RateLimitError; } });
+Object.defineProperty(exports, "SandboxApiError", { enumerable: true, get: function () { return sandbox_api_error_1.SandboxApiError; } });
+Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return sandbox_api_error_1.ValidationError; } });

package/dist/src/errors/sandbox-api-error.d.ts

@@ -0,0 +1,29 @@
+export type SandboxApiErrorArgs = {
+    status: number;
+    message: string;
+    endpoint: string;
+    responseBody: unknown;
+    requestId?: string | null;
+};
+export declare class SandboxApiError extends Error {
+    readonly status: number;
+    readonly endpoint: string;
+    readonly responseBody: unknown;
+    readonly requestId: string | null;
+    constructor(args: SandboxApiErrorArgs);
+}
+export declare class AuthError extends SandboxApiError {
+    constructor(args: SandboxApiErrorArgs);
+}
+export declare class ValidationError extends SandboxApiError {
+    constructor(args: SandboxApiErrorArgs);
+}
+export declare class NotFoundError extends SandboxApiError {
+    constructor(args: SandboxApiErrorArgs);
+}
+export declare class RateLimitError extends SandboxApiError {
+    readonly retryAfterSeconds: number | null;
+    constructor(args: SandboxApiErrorArgs & {
+        retryAfterSeconds?: number | null;
+    });
+}

package/dist/src/errors/sandbox-api-error.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RateLimitError = exports.NotFoundError = exports.ValidationError = exports.AuthError = exports.SandboxApiError = void 0;
+class SandboxApiError extends Error {
+    status;
+    endpoint;
+    responseBody;
+    requestId;
+    constructor(args) {
+        super(args.message);
+        this.name = 'SandboxApiError';
+        this.status = args.status;
+        this.endpoint = args.endpoint;
+        this.responseBody = args.responseBody;
+        this.requestId = args.requestId ?? null;
+    }
+}
+exports.SandboxApiError = SandboxApiError;
+class AuthError extends SandboxApiError {
+    constructor(args) {
+        super(args);
+        this.name = 'AuthError';
+    }
+}
+exports.AuthError = AuthError;
+class ValidationError extends SandboxApiError {
+    constructor(args) {
+        super(args);
+        this.name = 'ValidationError';
+    }
+}
+exports.ValidationError = ValidationError;
+class NotFoundError extends SandboxApiError {
+    constructor(args) {
+        super(args);
+        this.name = 'NotFoundError';
+    }
+}
+exports.NotFoundError = NotFoundError;
+class RateLimitError extends SandboxApiError {
+    retryAfterSeconds;
+    constructor(args) {
+        super(args);
+        this.name = 'RateLimitError';
+        this.retryAfterSeconds = args.retryAfterSeconds ?? null;
+    }
+}
+exports.RateLimitError = RateLimitError;

package/dist/src/index.d.ts

@@ -0,0 +1,10 @@
+export { DEFAULT_BASE_URL, DEFAULT_PAGE, DEFAULT_PAGE_LIMIT, DEFAULT_RETRY_BASE_DELAY_MS, DEFAULT_RETRY_MAX_ATTEMPTS, DEFAULT_RETRY_MAX_DELAY_MS, DEFAULT_RETRY_STATUSES, DEFAULT_TIMEOUT_MS, MAX_PAGE_LIMIT, SANDBOX_API_KEY_ENV_NAME, } from './constants';
+export { SandboxClient } from './client';
+export type { SandboxClientOptions } from './client';
+export { AuthError, NotFoundError, RateLimitError, SandboxApiError, ValidationError } from './errors';
+export type { SandboxApiErrorArgs } from './errors';
+export { CodeLanguage, DestroyReason, DestroyTimeout, SandboxStatus, SnapshotMode, SnapshotStatus, VolumeType, } from './enums';
+export { ExecResource, FilesResource, SandboxHandle, SandboxesResource, ScopedSandboxResource, SnapshotScopeResource, SnapshotsResource, StatsResource, VolumesResource, } from './resources';
+export type { AckMessage, CodeInput, CreateSandboxInput, CreateSandboxResult, CreateSnapshotInput, CreateVolumeInput, ExecInput, ExecResult, ExecStreamFrame, FileUploadBody, Paginated, Pagination, RegionSummary, SandboxRegion, SandboxRegionsResult, Sandbox, SandboxSpecs, Snapshot, Stats, StatsAverageNetwork, StatsAverageNumeric, StatsQuery, StatsTimelinePoint, TeamScopedPagination, WaitUntilReadyOptions, Volume, } from './types';
+export type { RequestOptions } from './transport/http';
+export type { RetryOptions } from './transport/http';

package/dist/src/index.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VolumesResource = exports.StatsResource = exports.SnapshotsResource = exports.SnapshotScopeResource = exports.ScopedSandboxResource = exports.SandboxesResource = exports.SandboxHandle = exports.FilesResource = exports.ExecResource = exports.VolumeType = exports.SnapshotStatus = exports.SnapshotMode = exports.SandboxStatus = exports.DestroyTimeout = exports.DestroyReason = exports.CodeLanguage = exports.ValidationError = exports.SandboxApiError = exports.RateLimitError = exports.NotFoundError = exports.AuthError = exports.SandboxClient = exports.SANDBOX_API_KEY_ENV_NAME = exports.MAX_PAGE_LIMIT = exports.DEFAULT_TIMEOUT_MS = exports.DEFAULT_RETRY_STATUSES = exports.DEFAULT_RETRY_MAX_DELAY_MS = exports.DEFAULT_RETRY_MAX_ATTEMPTS = exports.DEFAULT_RETRY_BASE_DELAY_MS = exports.DEFAULT_PAGE_LIMIT = exports.DEFAULT_PAGE = exports.DEFAULT_BASE_URL = void 0;
+var constants_1 = require("./constants");
+Object.defineProperty(exports, "DEFAULT_BASE_URL", { enumerable: true, get: function () { return constants_1.DEFAULT_BASE_URL; } });
+Object.defineProperty(exports, "DEFAULT_PAGE", { enumerable: true, get: function () { return constants_1.DEFAULT_PAGE; } });
+Object.defineProperty(exports, "DEFAULT_PAGE_LIMIT", { enumerable: true, get: function () { return constants_1.DEFAULT_PAGE_LIMIT; } });
+Object.defineProperty(exports, "DEFAULT_RETRY_BASE_DELAY_MS", { enumerable: true, get: function () { return constants_1.DEFAULT_RETRY_BASE_DELAY_MS; } });
+Object.defineProperty(exports, "DEFAULT_RETRY_MAX_ATTEMPTS", { enumerable: true, get: function () { return constants_1.DEFAULT_RETRY_MAX_ATTEMPTS; } });
+Object.defineProperty(exports, "DEFAULT_RETRY_MAX_DELAY_MS", { enumerable: true, get: function () { return constants_1.DEFAULT_RETRY_MAX_DELAY_MS; } });
+Object.defineProperty(exports, "DEFAULT_RETRY_STATUSES", { enumerable: true, get: function () { return constants_1.DEFAULT_RETRY_STATUSES; } });
+Object.defineProperty(exports, "DEFAULT_TIMEOUT_MS", { enumerable: true, get: function () { return constants_1.DEFAULT_TIMEOUT_MS; } });
+Object.defineProperty(exports, "MAX_PAGE_LIMIT", { enumerable: true, get: function () { return constants_1.MAX_PAGE_LIMIT; } });
+Object.defineProperty(exports, "SANDBOX_API_KEY_ENV_NAME", { enumerable: true, get: function () { return constants_1.SANDBOX_API_KEY_ENV_NAME; } });
+var client_1 = require("./client");
+Object.defineProperty(exports, "SandboxClient", { enumerable: true, get: function () { return client_1.SandboxClient; } });
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "AuthError", { enumerable: true, get: function () { return errors_1.AuthError; } });
+Object.defineProperty(exports, "NotFoundError", { enumerable: true, get: function () { return errors_1.NotFoundError; } });
+Object.defineProperty(exports, "RateLimitError", { enumerable: true, get: function () { return errors_1.RateLimitError; } });
+Object.defineProperty(exports, "SandboxApiError", { enumerable: true, get: function () { return errors_1.SandboxApiError; } });
+Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return errors_1.ValidationError; } });
+var enums_1 = require("./enums");
+Object.defineProperty(exports, "CodeLanguage", { enumerable: true, get: function () { return enums_1.CodeLanguage; } });
+Object.defineProperty(exports, "DestroyReason", { enumerable: true, get: function () { return enums_1.DestroyReason; } });
+Object.defineProperty(exports, "DestroyTimeout", { enumerable: true, get: function () { return enums_1.DestroyTimeout; } });
+Object.defineProperty(exports, "SandboxStatus", { enumerable: true, get: function () { return enums_1.SandboxStatus; } });
+Object.defineProperty(exports, "SnapshotMode", { enumerable: true, get: function () { return enums_1.SnapshotMode; } });
+Object.defineProperty(exports, "SnapshotStatus", { enumerable: true, get: function () { return enums_1.SnapshotStatus; } });
+Object.defineProperty(exports, "VolumeType", { enumerable: true, get: function () { return enums_1.VolumeType; } });
+var resources_1 = require("./resources");
+Object.defineProperty(exports, "ExecResource", { enumerable: true, get: function () { return resources_1.ExecResource; } });
+Object.defineProperty(exports, "FilesResource", { enumerable: true, get: function () { return resources_1.FilesResource; } });
+Object.defineProperty(exports, "SandboxHandle", { enumerable: true, get: function () { return resources_1.SandboxHandle; } });
+Object.defineProperty(exports, "SandboxesResource", { enumerable: true, get: function () { return resources_1.SandboxesResource; } });
+Object.defineProperty(exports, "ScopedSandboxResource", { enumerable: true, get: function () { return resources_1.ScopedSandboxResource; } });
+Object.defineProperty(exports, "SnapshotScopeResource", { enumerable: true, get: function () { return resources_1.SnapshotScopeResource; } });
+Object.defineProperty(exports, "SnapshotsResource", { enumerable: true, get: function () { return resources_1.SnapshotsResource; } });
+Object.defineProperty(exports, "StatsResource", { enumerable: true, get: function () { return resources_1.StatsResource; } });
+Object.defineProperty(exports, "VolumesResource", { enumerable: true, get: function () { return resources_1.VolumesResource; } });

package/dist/src/resources/exec.d.ts

@@ -0,0 +1,19 @@
+import type { CodeInput, ExecInput, ExecResult } from '../types';
+import type { RequestOptions } from '../transport/http';
+import { HttpTransport } from '../transport/http';
+export declare class ExecResource {
+    private readonly transport;
+    private readonly sandboxId;
+    /** @internal Create the exec/code runner wrapper for one sandbox. */
+    constructor(transport: HttpTransport, sandboxId: string);
+    /** Run a shell command in the sandbox. */
+    exec(input: ExecInput & {
+        stream: true;
+    }, options?: RequestOptions): Promise<ReadableStream<Uint8Array>>;
+    exec(input: ExecInput, options?: RequestOptions): Promise<ExecResult>;
+    /** Run a code snippet in the sandbox. */
+    runCode(input: CodeInput & {
+        stream: true;
+    }, options?: RequestOptions): Promise<ReadableStream<Uint8Array>>;
+    runCode(input: CodeInput, options?: RequestOptions): Promise<ExecResult>;
+}