@brimble/sandbox 0.1.0 → 0.1.2

package/src/resources/scoped-sandbox.ts

@@ -1,65 +0,0 @@
-import { ExecResource } from './exec';
-import { FilesResource } from './files';
-import { SnapshotScopeResource } from './snapshots';
-import { StatsResource } from './stats';
-import { HttpTransport } from '../transport/http';
-import type { CodeInput, CreateSnapshotInput, ExecInput, ExecResult, FileUploadBody, Paginated, Pagination, Snapshot, Stats, StatsQuery } from '../types';
-import type { RequestOptions } from '../transport/http';
-
-export class ScopedSandboxResource {
-  /** Lower-level exec/code runner resource. */
-  public readonly execResource: ExecResource;
-  /** File upload/download resource. */
-  public readonly files: FilesResource;
-  /** Snapshot resource scoped to this sandbox. */
-  public readonly snapshots: SnapshotScopeResource;
-  /** Stats resource scoped to this sandbox. */
-  public readonly statsResource: StatsResource;
-
-  /** @internal Create a sandbox-scoped resource wrapper. */
-  public constructor(transport: HttpTransport, sandboxId: string) {
-    this.execResource = new ExecResource(transport, sandboxId);
-    this.files = new FilesResource(transport, sandboxId);
-    this.snapshots = new SnapshotScopeResource(transport, sandboxId);
-    this.statsResource = new StatsResource(transport, sandboxId);
-  }
-
-  /** Run a shell command in this sandbox. */
-  public exec(input: ExecInput & { stream: true }, options?: RequestOptions): Promise<ReadableStream<Uint8Array>>;
-  public exec(input: ExecInput, options?: RequestOptions): Promise<ExecResult>;
-  public exec(input: ExecInput, options?: RequestOptions): Promise<ExecResult | ReadableStream<Uint8Array>> {
-    return this.execResource.exec(input, options);
-  }
-
-  /** Run a code snippet in this sandbox. */
-  public runCode(input: CodeInput & { stream: true }, options?: RequestOptions): Promise<ReadableStream<Uint8Array>>;
-  public runCode(input: CodeInput, options?: RequestOptions): Promise<ExecResult>;
-  public runCode(input: CodeInput, options?: RequestOptions): Promise<ExecResult | ReadableStream<Uint8Array>> {
-    return this.execResource.runCode(input, options);
-  }
-
-  /** Upload bytes to a file path inside this sandbox. */
-  public putFile(path: string, body: FileUploadBody, options?: RequestOptions): Promise<void> {
-    return this.files.put(path, body, options);
-  }
-
-  /** Download file bytes from this sandbox as a stream. */
-  public getFile(path: string, options?: RequestOptions): Promise<ReadableStream<Uint8Array>> {
-    return this.files.get(path, options);
-  }
-
-  /** Fetch CPU, memory, and network stats for this sandbox. */
-  public stats(query: StatsQuery = {}, options?: RequestOptions): Promise<Stats> {
-    return this.statsResource.stats(query, options);
-  }
-
-  /** Create a snapshot for this sandbox. */
-  public createSnapshot(input: CreateSnapshotInput, options?: RequestOptions): Promise<Snapshot> {
-    return this.snapshots.create(input, options);
-  }
-
-  /** List snapshots for this sandbox. */
-  public listSnapshots(query: Pagination = {}, options?: RequestOptions): Promise<Paginated<Snapshot>> {
-    return this.snapshots.list(query, options);
-  }
-}

package/src/resources/snapshots.ts

@@ -1,104 +0,0 @@
-import type { RequestOptions } from '../transport/http';
-import { HttpTransport } from '../transport/http';
-import { toPaginationQuery } from '../transport/pagination';
-import type { CreateSnapshotInput, Paginated, Pagination, Snapshot } from '../types';
-import { DEFAULT_PAGE, DEFAULT_PAGE_LIMIT } from '../constants';
-
-export class SnapshotScopeResource {
-  private readonly transport: HttpTransport;
-  private readonly sandboxId: string;
-
-  /** @internal Create a sandbox-scoped snapshots wrapper. */
-  public constructor(transport: HttpTransport, sandboxId: string) {
-    this.transport = transport;
-    this.sandboxId = sandboxId;
-  }
-
-  /** Create a snapshot for this specific sandbox. */
-  public create(input: CreateSnapshotInput, options?: RequestOptions): Promise<Snapshot> {
-    return this.transport.requestJson<Snapshot>({
-      endpoint: `/sandboxes/${this.sandboxId}/snapshots`,
-      method: 'POST',
-      body: input,
-      ...options,
-    }) as Promise<Snapshot>;
-  }
-
-  /** List snapshots for this specific sandbox. */
-  public list(query: Pagination = {}, options?: RequestOptions): Promise<Paginated<Snapshot>> {
-    return this.transport.requestJson<Paginated<Snapshot>>({
-      endpoint: `/sandboxes/${this.sandboxId}/snapshots`,
-      method: 'GET',
-      query: toPaginationQuery(query),
-      ...options,
-    }) as Promise<Paginated<Snapshot>>;
-  }
-
-  /** Iterate over all snapshots for this sandbox across pages. */
-  public async *iterate(query: Pagination = {}, options?: RequestOptions): AsyncGenerator<Snapshot> {
-    const limit = query.limit ?? DEFAULT_PAGE_LIMIT;
-    let page = query.page ?? DEFAULT_PAGE;
-
-    while (true) {
-      const paginated = await this.list({ ...query, page, limit }, options);
-
-      for (const snapshot of paginated.data) {
-        yield snapshot;
-      }
-
-      if (page >= paginated.totalPages || paginated.data.length === 0) {
-        return;
-      }
-
-      page += 1;
-    }
-  }
-}
-
-export class SnapshotsResource {
-  private readonly transport: HttpTransport;
-
-  /** @internal Create the global snapshots resource wrapper. */
-  public constructor(transport: HttpTransport) {
-    this.transport = transport;
-  }
-
-  /** List all snapshots owned by the current caller. */
-  public listAll(query: Pagination = {}, options?: RequestOptions): Promise<Paginated<Snapshot>> {
-    return this.transport.requestJson<Paginated<Snapshot>>({
-      endpoint: '/sandboxes/snapshots',
-      method: 'GET',
-      query: toPaginationQuery(query),
-      ...options,
-    }) as Promise<Paginated<Snapshot>>;
-  }
-
-  /** Iterate over all snapshots owned by the caller across pages. */
-  public async *iterateAll(query: Pagination = {}, options?: RequestOptions): AsyncGenerator<Snapshot> {
-    const limit = query.limit ?? DEFAULT_PAGE_LIMIT;
-    let page = query.page ?? DEFAULT_PAGE;
-
-    while (true) {
-      const paginated = await this.listAll({ ...query, page, limit }, options);
-
-      for (const snapshot of paginated.data) {
-        yield snapshot;
-      }
-
-      if (page >= paginated.totalPages || paginated.data.length === 0) {
-        return;
-      }
-
-      page += 1;
-    }
-  }
-
-  /** Delete a snapshot by id. */
-  public async delete(snapshotId: string, options?: RequestOptions): Promise<void> {
-    await this.transport.requestJson({
-      endpoint: `/sandboxes/snapshots/${snapshotId}`,
-      method: 'DELETE',
-      ...options,
-    });
-  }
-}

package/src/resources/stats.ts

@@ -1,30 +0,0 @@
-import type { Stats, StatsQuery } from '../types';
-import type { RequestOptions } from '../transport/http';
-import { HttpTransport } from '../transport/http';
-
-export class StatsResource {
-  private readonly transport: HttpTransport;
-  private readonly sandboxId: string;
-
-  /** @internal Create the stats wrapper for one sandbox. */
-  public constructor(transport: HttpTransport, sandboxId: string) {
-    this.transport = transport;
-    this.sandboxId = sandboxId;
-  }
-
-  /** Fetch sandbox usage stats for a lookback window. */
-  public stats(query: StatsQuery = {}, options?: RequestOptions): Promise<Stats> {
-    const params = new URLSearchParams();
-
-    if (query.hoursAgo !== undefined) {
-      params.set('hoursAgo', String(query.hoursAgo));
-    }
-
-    return this.transport.requestJson<Stats>({
-      endpoint: `/sandboxes/${this.sandboxId}/stats`,
-      method: 'GET',
-      query: params,
-      ...options,
-    }) as Promise<Stats>;
-  }
-}

package/src/resources/volumes.ts

@@ -1,95 +0,0 @@
-import type { RequestOptions } from '../transport/http';
-import { HttpTransport } from '../transport/http';
-import { toPaginationQuery } from '../transport/pagination';
-import { VolumeType } from '../enums';
-import { DEFAULT_PAGE, DEFAULT_PAGE_LIMIT, MIN_VOLUME_SIZE_GB } from '../constants';
-import type { CreateVolumeInput, Paginated, TeamScopedPagination, Volume } from '../types';
-
-export class VolumesResource {
-  private readonly transport: HttpTransport;
-
-  /** @internal Create the volumes resource wrapper. */
-  public constructor(transport: HttpTransport) {
-    this.transport = transport;
-  }
-
-  /** List your volumes with pagination. */
-  public list(query: TeamScopedPagination = {}, options?: RequestOptions): Promise<Paginated<Volume>> {
-    const params = toPaginationQuery(query);
-
-    if (query.teamId) {
-      params.set('teamId', query.teamId);
-    }
-
-    return this.transport.requestJson<Paginated<Volume>>({
-      endpoint: '/volumes',
-      method: 'GET',
-      query: params,
-      ...options,
-    }) as Promise<Paginated<Volume>>;
-  }
-
-  /** Iterate over all volumes across paginated results. */
-  public async *iterate(query: TeamScopedPagination = {}, options?: RequestOptions): AsyncGenerator<Volume> {
-    const limit = query.limit ?? DEFAULT_PAGE_LIMIT;
-    let page = query.page ?? DEFAULT_PAGE;
-
-    while (true) {
-      const paginated = await this.list({ ...query, page, limit }, options);
-
-      for (const volume of paginated.data) {
-        yield volume;
-      }
-
-      if (page >= paginated.totalPages || paginated.data.length === 0) {
-        return;
-      }
-
-      page += 1;
-    }
-  }
-
-  /**
-   * Create a new volume.
-   * This SDK accepts only `type: "sandbox"` and defaults to it when omitted.
-   */
-  public create(input: CreateVolumeInput, options?: RequestOptions): Promise<Volume> {
-    if (input.type && input.type !== VolumeType.Sandbox) {
-      throw new Error('Only volume type "sandbox" is supported by this package.');
-    }
-
-    if (input.sizeGB < MIN_VOLUME_SIZE_GB) {
-      throw new Error(`Volume size must be at least ${MIN_VOLUME_SIZE_GB}GB.`);
-    }
-
-    const body: CreateVolumeInput = {
-      ...input,
-      type: VolumeType.Sandbox,
-    };
-
-    return this.transport.requestJson<Volume>({
-      endpoint: '/volumes',
-      method: 'POST',
-      body,
-      ...options,
-    }) as Promise<Volume>;
-  }
-
-  /** Fetch one volume by id. */
-  public get(volumeId: string, options?: RequestOptions): Promise<Volume> {
-    return this.transport.requestJson<Volume>({
-      endpoint: `/volumes/${volumeId}`,
-      method: 'GET',
-      ...options,
-    }) as Promise<Volume>;
-  }
-
-  /** Delete a volume by id. */
-  public async delete(volumeId: string, options?: RequestOptions): Promise<void> {
-    await this.transport.requestJson({
-      endpoint: `/volumes/${volumeId}`,
-      method: 'DELETE',
-      ...options,
-    });
-  }
-}

package/src/transport/auth.ts

@@ -1,4 +0,0 @@
-/** Build the header value used by `x-brimble-key`. */
-export function buildApiKeyHeader(apiKey: string): string {
-  return apiKey;
-}